diff --git a/.venv/bin/pip b/.venv/bin/pip index 2e62fbe..952304f 100755 --- a/.venv/bin/pip +++ b/.venv/bin/pip @@ -1,8 +1,6 @@ #!/home/zlata/PycharmProjects/Funktional/.venv/bin/python -# -*- coding: utf-8 -*- -import re import sys +from pip._internal.cli.main import cli if __name__ == '__main__': - from pip._internal.cli.main import main - sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) - sys.exit(main()) + sys.argv[0] = sys.argv[0].removesuffix('.exe') + sys.exit(cli()) diff --git a/.venv/bin/pip-3.14 b/.venv/bin/pip-3.14 deleted file mode 100755 index 2e62fbe..0000000 --- a/.venv/bin/pip-3.14 +++ /dev/null @@ -1,8 +0,0 @@ -#!/home/zlata/PycharmProjects/Funktional/.venv/bin/python -# -*- coding: utf-8 -*- -import re -import sys -if __name__ == '__main__': - from pip._internal.cli.main import main - sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) - sys.exit(main()) diff --git a/.venv/bin/pip3 b/.venv/bin/pip3 index 2e62fbe..952304f 100755 --- a/.venv/bin/pip3 +++ b/.venv/bin/pip3 @@ -1,8 +1,6 @@ #!/home/zlata/PycharmProjects/Funktional/.venv/bin/python -# -*- coding: utf-8 -*- -import re import sys +from pip._internal.cli.main import cli if __name__ == '__main__': - from pip._internal.cli.main import main - sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) - sys.exit(main()) + sys.argv[0] = sys.argv[0].removesuffix('.exe') + sys.exit(cli()) diff --git a/.venv/bin/pip3.14 b/.venv/bin/pip3.14 index 2e62fbe..952304f 100755 --- a/.venv/bin/pip3.14 +++ b/.venv/bin/pip3.14 @@ -1,8 +1,6 @@ #!/home/zlata/PycharmProjects/Funktional/.venv/bin/python -# -*- coding: utf-8 -*- -import re import sys +from pip._internal.cli.main import cli if __name__ == '__main__': - from pip._internal.cli.main import main - sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0]) - sys.exit(main()) + sys.argv[0] = sys.argv[0].removesuffix('.exe') + sys.exit(cli()) diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/INSTALLER b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/INSTALLER deleted file mode 100644 index a1b589e..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/INSTALLER +++ /dev/null @@ -1 +0,0 @@ -pip diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/METADATA b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/METADATA deleted file mode 100644 index e56d5d1..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/METADATA +++ /dev/null @@ -1,111 +0,0 @@ -Metadata-Version: 2.4 -Name: pip -Version: 26.0.1 -Summary: The PyPA recommended tool for installing Python packages. -Author-email: The pip developers -Requires-Python: >=3.9 -Description-Content-Type: text/x-rst -License-Expression: MIT -Classifier: Development Status :: 5 - Production/Stable -Classifier: Intended Audience :: Developers -Classifier: Topic :: Software Development :: Build Tools -Classifier: Programming Language :: Python -Classifier: Programming Language :: Python :: 3 -Classifier: Programming Language :: Python :: 3 :: Only -Classifier: Programming Language :: Python :: 3.9 -Classifier: Programming Language :: Python :: 3.10 -Classifier: Programming Language :: Python :: 3.11 -Classifier: Programming Language :: Python :: 3.12 -Classifier: Programming Language :: Python :: 3.13 -Classifier: Programming Language :: Python :: 3.14 -Classifier: Programming Language :: Python :: Implementation :: CPython -Classifier: Programming Language :: Python :: Implementation :: PyPy -License-File: AUTHORS.txt -License-File: LICENSE.txt -License-File: src/pip/_vendor/cachecontrol/LICENSE.txt -License-File: src/pip/_vendor/certifi/LICENSE -License-File: src/pip/_vendor/dependency_groups/LICENSE.txt -License-File: src/pip/_vendor/distlib/LICENSE.txt -License-File: src/pip/_vendor/distro/LICENSE -License-File: src/pip/_vendor/idna/LICENSE.md -License-File: src/pip/_vendor/msgpack/COPYING -License-File: src/pip/_vendor/packaging/LICENSE -License-File: src/pip/_vendor/packaging/LICENSE.APACHE -License-File: src/pip/_vendor/packaging/LICENSE.BSD -License-File: src/pip/_vendor/pkg_resources/LICENSE -License-File: src/pip/_vendor/platformdirs/LICENSE -License-File: src/pip/_vendor/pygments/LICENSE -License-File: src/pip/_vendor/pyproject_hooks/LICENSE -License-File: src/pip/_vendor/requests/LICENSE -License-File: src/pip/_vendor/resolvelib/LICENSE -License-File: src/pip/_vendor/rich/LICENSE -License-File: src/pip/_vendor/tomli/LICENSE -License-File: src/pip/_vendor/tomli_w/LICENSE -License-File: src/pip/_vendor/truststore/LICENSE -License-File: src/pip/_vendor/urllib3/LICENSE.txt -Project-URL: Changelog, https://pip.pypa.io/en/stable/news/ -Project-URL: Documentation, https://pip.pypa.io -Project-URL: Homepage, https://pip.pypa.io/ -Project-URL: Source, https://github.com/pypa/pip - -pip - The Python Package Installer -================================== - -.. |pypi-version| image:: https://img.shields.io/pypi/v/pip.svg - :target: https://pypi.org/project/pip/ - :alt: PyPI - -.. |python-versions| image:: https://img.shields.io/pypi/pyversions/pip - :target: https://pypi.org/project/pip - :alt: PyPI - Python Version - -.. |docs-badge| image:: https://readthedocs.org/projects/pip/badge/?version=latest - :target: https://pip.pypa.io/en/latest - :alt: Documentation - -|pypi-version| |python-versions| |docs-badge| - -pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes. - -Please take a look at our documentation for how to install and use pip: - -* `Installation`_ -* `Usage`_ - -We release updates regularly, with a new version every 3 months. Find more details in our documentation: - -* `Release notes`_ -* `Release process`_ - -If you find bugs, need help, or want to talk to the developers, please use our mailing lists or chat rooms: - -* `Issue tracking`_ -* `Discourse channel`_ -* `User IRC`_ - -If you want to get involved, head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms: - -* `GitHub page`_ -* `Development documentation`_ -* `Development IRC`_ - -Code of Conduct ---------------- - -Everyone interacting in the pip project's codebases, issue trackers, chat -rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. - -.. _package installer: https://packaging.python.org/guides/tool-recommendations/ -.. _Python Package Index: https://pypi.org -.. _Installation: https://pip.pypa.io/en/stable/installation/ -.. _Usage: https://pip.pypa.io/en/stable/ -.. _Release notes: https://pip.pypa.io/en/stable/news.html -.. _Release process: https://pip.pypa.io/en/latest/development/release-process/ -.. _GitHub page: https://github.com/pypa/pip -.. _Development documentation: https://pip.pypa.io/en/latest/development -.. _Issue tracking: https://github.com/pypa/pip/issues -.. _Discourse channel: https://discuss.python.org/c/packaging -.. _User IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa -.. _Development IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa-dev -.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md - diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/RECORD b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/RECORD deleted file mode 100644 index 1ca644b..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/RECORD +++ /dev/null @@ -1,956 +0,0 @@ -pip/__init__.py,sha256=3EhKF2588Ab15tmBszgD3Bp0N26sJx7VhS2Akn_qY38,355 -pip/__main__.py,sha256=WzbhHXTbSE6gBY19mNN9m4s5o_365LOvTYSgqgbdBhE,854 -pip/__pip-runner__.py,sha256=JOoEZTwrtv7jRaXBkgSQKAE04yNyfFmGHxqpHiGHvL0,1450 -pip/py.typed,sha256=EBVvvPRTn_eIpz5e5QztSCdrMX7Qwd7VP93RSoIlZ2I,286 -pip/_internal/__init__.py,sha256=S7i9Dn9aSZS0MG-2Wrve3dV9TImPzvQn5jjhp9t_uf0,511 -pip/_internal/build_env.py,sha256=XpgOIlTQLgz3PvDT2n7j2NzX_rVFZLCIG7t7b2ddhcM,21911 -pip/_internal/cache.py,sha256=nMh48Yv3yu1HS1yCdscouu6B6B5zYBWdV6bhqs7gL-E,10345 -pip/_internal/configuration.py,sha256=WxwwSwY_Bm6QzDgf32BsujEyO8dgRedegCpgbUfDvM8,14568 -pip/_internal/exceptions.py,sha256=JdPCrQ9iTLvE-GBebzBEeGP3hoTffWEKqbYEsa6cEZc,32165 -pip/_internal/main.py,sha256=1cHqjsfFCrMFf3B5twzocxTJUdHMLoXUpy5lJoFqUi8,338 -pip/_internal/pyproject.py,sha256=J-sTWqC-XfsKQgz9m1bypMWZPHItsSHzIN_NWeIRmhM,4555 -pip/_internal/self_outdated_check.py,sha256=zDKsyLMufFHuEZY16WRu129FBbBp-ADuxyWMIN4ihPE,8284 -pip/_internal/wheel_builder.py,sha256=yvEULStZtty9Kplp89tDis3hGdyKQ-2BUbFLmJ_5ink,9010 -pip/_internal/cli/__init__.py,sha256=Iqg_tKA771XuMO1P4t_sDHnSKPzkUb9D0DqunAmw_ko,131 -pip/_internal/cli/autocompletion.py,sha256=ZG2cM03nlcNrs-WG_SFTW46isx9s2Go5lUD_8-iv70o,7193 -pip/_internal/cli/base_command.py,sha256=6OW75PSGzkH8Fz761WZ3OSz1TsuO3-suc6iap-sQjTM,9168 -pip/_internal/cli/cmdoptions.py,sha256=hfA9B29Nnq2vYMWhFVg7EcWjdlfdPBPU4WwWT2Lkq4A,36164 -pip/_internal/cli/command_context.py,sha256=kmu3EWZbfBega1oDamnGJTA_UaejhIQNuMj2CVmMXu0,817 -pip/_internal/cli/index_command.py,sha256=s3x75lpDXWJtCkBacTQ3qAAprldHMJCniEQ5qkQ0FiI,6484 -pip/_internal/cli/main.py,sha256=ljDQBkvBtC8xTjOdb6rDJzJUNi1s-PnVR_W5C-Mq0Dk,3137 -pip/_internal/cli/main_parser.py,sha256=YjzJAjqf78ARNsLlnJT9l6fNbpyDPJA-arOIXYsK5Ik,4403 -pip/_internal/cli/parser.py,sha256=EIFExrWX_1nrl1Ib--GOor70WYqLtduHByenb1u9xH4,13827 -pip/_internal/cli/progress_bars.py,sha256=IW1PH5n2FPqUBTP7ULQ5Yu-wyNNO9XGY3g1PT4RMu44,4706 -pip/_internal/cli/req_command.py,sha256=QjDXId0hFdopwE8hNx2eustumxUNbnOCvG_ORmUC7vM,16482 -pip/_internal/cli/spinners.py,sha256=EJzZIZNyUtJljp3-WjcsyIrqxW-HUsfWzhuW84n_Tqw,7362 -pip/_internal/cli/status_codes.py,sha256=sEFHUaUJbqv8iArL3HAtcztWZmGOFX01hTesSytDEh0,116 -pip/_internal/commands/__init__.py,sha256=aNeCbQurGWihfhQq7BqaLXHqWDQ0i3I04OS7kxK6plQ,4026 -pip/_internal/commands/cache.py,sha256=XjT7kjY8GSISMksFHsLvjS9Ogfi5extNlUUv-dUoWCM,9142 -pip/_internal/commands/check.py,sha256=hVFBQezQ3zj4EydoWbFQj_afPUppMt7r9JPAlY22U6Y,2244 -pip/_internal/commands/completion.py,sha256=LjvRIZ6QUiDXJL3IOMFeD-_J97HfjMGgEk0j2tWGu1U,4565 -pip/_internal/commands/configuration.py,sha256=6gNOGrVWnOLU15zUnAiNuOMhf76RRIZvCdVD0degPRk,10105 -pip/_internal/commands/debug.py,sha256=_8IqM8Fx1_lY2STu_qspr63tufF7zyFJCyYAXtxz0N4,6805 -pip/_internal/commands/download.py,sha256=LUNVobuvCdagjLBuPBaxHeBiHEiIe03fTO2m6ahC8qw,5178 -pip/_internal/commands/freeze.py,sha256=fxoW8AAc-bAqB_fXdNq2VnZ3JfWkFMg-bR6LcdDVO7A,3099 -pip/_internal/commands/hash.py,sha256=GO9pRN3wXC2kQaovK57TaLYBMc3IltOH92O6QEw6YE0,1679 -pip/_internal/commands/help.py,sha256=Bz3LcjNQXkz4Cu__pL4CZ86o4-HNLZj1NZWdlJhjuu0,1108 -pip/_internal/commands/index.py,sha256=kDpx2MO6ZxTt5PpeY4jqcssVbYhzxpkpreDe_6PPhks,5520 -pip/_internal/commands/inspect.py,sha256=ogm4UT7LRo8bIQcWUS1IiA25QdD4VHLa7JaPAodDttM,3177 -pip/_internal/commands/install.py,sha256=L6X1qi49ROVTGABhwwxDgBBTijlOpVn6XSDVZ7QW1Kc,30588 -pip/_internal/commands/list.py,sha256=L5nWuwawqSrBNsuxfyHLAagfz7XJP86tC9nK3L9YiI8,13497 -pip/_internal/commands/lock.py,sha256=145ihjUK_-7gP8O65XPDi_xMhlh5hne1ptkHdfnbAnQ,6027 -pip/_internal/commands/search.py,sha256=zbMsX_YASj6kXA6XIBgTDv0bGK51xG-CV3IynZJcE-c,5782 -pip/_internal/commands/show.py,sha256=oLVJIfKWmDKm0SsQGEi3pozNiqrXjTras_fbBSYKpBA,8066 -pip/_internal/commands/uninstall.py,sha256=CsOihqvb6ZA6O67L70oXeoLHeOfNzMM88H9g-9aocgw,3868 -pip/_internal/commands/wheel.py,sha256=L9vEzJ_E42scF_Hgh5X4Hk39nqJDKxGg4u7glDYbNWc,5880 -pip/_internal/distributions/__init__.py,sha256=Hq6kt6gXBgjNit5hTTWLAzeCNOKoB-N0pGYSqehrli8,858 -pip/_internal/distributions/base.py,sha256=l-OTCAIs25lsapejA6IYpPZxSM5-BET4sdZDkql8jiY,1830 -pip/_internal/distributions/installed.py,sha256=kgIEE_1NzjZxLBSC-v5s64uOFZlVEt3aPrjTtL6x2XY,929 -pip/_internal/distributions/sdist.py,sha256=RYwQIbuxpKy6OjlBZCAefxpMDaoocUQ4dFtheGsiTOQ,6627 -pip/_internal/distributions/wheel.py,sha256=_HbG0OehF8dwj4UX-xV__tXLwgPus9OjMEf2NTRqBbE,1364 -pip/_internal/index/__init__.py,sha256=tzwMH_fhQeubwMqHdSivasg1cRgTSbNg2CiMVnzMmyU,29 -pip/_internal/index/collector.py,sha256=R7Gcx_4GEoSEI-iazfAZVEPG3Lp6mbZT4lbAD6NjAc0,16144 -pip/_internal/index/package_finder.py,sha256=a3_L4FDNsuDf3y8Af9J7sfsHR1ahs8o13Ths-WYwFh0,41776 -pip/_internal/index/sources.py,sha256=nXJkOjhLy-O2FsrKU9RIqCOqgY2PsoKWybtZjjRgqU0,8639 -pip/_internal/locations/__init__.py,sha256=Sd67ap1LIemvXArUDFqm8U-HuZvj9i3ApEuiIwUc9UE,14157 -pip/_internal/locations/_distutils.py,sha256=jpFj4V00rD9IR3vA9TqrGkwcdNVFc58LsChZavge9JY,5975 -pip/_internal/locations/_sysconfig.py,sha256=8CpTjtxaCzHSCrKpaxWnHE7aKcJrRJRmntR1ZLVysLk,7779 -pip/_internal/locations/base.py,sha256=AImjYJWxOtDkc0KKc6Y4Gz677cg91caMA4L94B9FZEg,2550 -pip/_internal/metadata/__init__.py,sha256=vp-JAxiWg_-l5F8AT0Jcey72uUnh8CDwwol9-KktHZ8,5824 -pip/_internal/metadata/_json.py,sha256=hNvnMHOXLAyNlzirWhPL9Nx2CvCqa1iRma6Osq1YfV8,2711 -pip/_internal/metadata/base.py,sha256=BGuMenlcQT8i7j9iclrfdC3vSwgvhr8gjn955cCy16s,25420 -pip/_internal/metadata/pkg_resources.py,sha256=NO76ZrfR2-LKJTyaXrmQoGhmJMArALvacrlZHViSDT8,10544 -pip/_internal/metadata/importlib/__init__.py,sha256=jUUidoxnHcfITHHaAWG1G2i5fdBYklv_uJcjo2x7VYE,135 -pip/_internal/metadata/importlib/_compat.py,sha256=sneVh4_6WxQZK4ljdl3ylVuP-q0ttSqbgl9mWt0HnOg,2804 -pip/_internal/metadata/importlib/_dists.py,sha256=znZD7MN4RC73-87KXAn6tKZv9lAQRI0AxxK2bubDvPw,8420 -pip/_internal/metadata/importlib/_envs.py,sha256=H3qVLXVh4LWvrPvu_ekXf3dfbtwnlhNJQP2pxXpccfU,5333 -pip/_internal/models/__init__.py,sha256=AjmCEBxX_MH9f_jVjIGNCFJKYCYeSEe18yyvNx4uRKQ,62 -pip/_internal/models/candidate.py,sha256=zzgFRuw_kWPjKpGw7LC0ZUMD2CQ2EberUIYs8izjdCA,753 -pip/_internal/models/direct_url.py,sha256=4NMWacu_QzPPWREC1te7v6Wfv-2HkI4tvSJF-CBgLh4,6555 -pip/_internal/models/format_control.py,sha256=PwemYG1L27BM0f1KP61rm24wShENFyxqlD1TWu34alc,2471 -pip/_internal/models/index.py,sha256=tYnL8oxGi4aSNWur0mG8DAP7rC6yuha_MwJO8xw0crI,1030 -pip/_internal/models/installation_report.py,sha256=cqfWJ93ThCxjcacqSWryOCD2XtIn1CZrgzZxAv5FQZ0,2839 -pip/_internal/models/link.py,sha256=zti5UCx1hT03etYqm6MCqFd714clmTgX8rTZT9CKZDQ,21992 -pip/_internal/models/release_control.py,sha256=XD14Hy_XLh9xWR1p7JHqPZPEv3Nnb1BZGMpClk76sLs,3403 -pip/_internal/models/scheme.py,sha256=PakmHJM3e8OOWSZFtfz1Az7f1meONJnkGuQxFlt3wBE,575 -pip/_internal/models/search_scope.py,sha256=1hxU2IVsAaLZVjp0CbzJbYaYzCxv72_Qbg3JL0qhXo0,4507 -pip/_internal/models/selection_prefs.py,sha256=IDOA3euRtyqWUyIK7lX2bzIZasYiEvunKA6H3Mngk-M,2221 -pip/_internal/models/target_python.py,sha256=I0eFS-eia3kwhrOvgsphFZtNAB2IwXZ9Sr9fp6IjBP4,4243 -pip/_internal/models/wheel.py,sha256=1SdfDvN7ALTsbyZ9EOsNy1GPirP1n6EjHyzPrZyLSh8,2920 -pip/_internal/network/__init__.py,sha256=FMy06P__y6jMjUc8z3ZcQdKF-pmZ2zM14_vBeHPGhUI,49 -pip/_internal/network/auth.py,sha256=azFp14I9cyWAAzkxF2VM0Q_xtHnbNz3_NQXszy87KQo,20806 -pip/_internal/network/cache.py,sha256=kmRXKQrG9E26xQRj211LHeEGpDg_SlYU9Dn1fJ-AMeI,4862 -pip/_internal/network/download.py,sha256=8sVwIc9MWwpGlMPYCkO1S9U-FD8TA2utw42tj00skjM,12667 -pip/_internal/network/lazy_wheel.py,sha256=y9gVksdJCSjnLfYzs_m3DYUAtl3hc_k-xFPDBd9DgOs,7646 -pip/_internal/network/session.py,sha256=7zK7EeQCSRFipu4ZzcWl1V3AMKkiXdtGqFr7GvU2LrY,19555 -pip/_internal/network/utils.py,sha256=ACsXd1msqNCidHVXsu7LHUSr8NgaypcOKQ4KG-Z_wJM,4091 -pip/_internal/network/xmlrpc.py,sha256=_-Rnk3vOff8uF9hAGmT6SLALflY1gMBcbGwS12fb_Y4,1830 -pip/_internal/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_internal/operations/check.py,sha256=yC2XWth6iehGGE_fj7XRJLjVKBsTIG3ZoWRkFi3rOwc,5894 -pip/_internal/operations/freeze.py,sha256=PDdY-y_ZtZZJLAKcaWPIGRKAGW7DXR48f0aMRU0j7BA,9854 -pip/_internal/operations/prepare.py,sha256=ptVsmQf0Mo6jirk1Q5Djdse_wJw5Zdh1Fla2iL9HAJM,28830 -pip/_internal/operations/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_internal/operations/build/build_tracker.py,sha256=W3b5cmkMWPaE6QIwfzsTayJo7-OlxFHWDxfPuax1KcE,4771 -pip/_internal/operations/build/metadata.py,sha256=INHaeiRfOiLYCXApfDNRo9Cw2xI4VwTc0KItvfdfOjk,1421 -pip/_internal/operations/build/metadata_editable.py,sha256=oWudMsnjy4loO_Jy7g4N9nxsnaEX_iDlVRgCy7pu1rs,1509 -pip/_internal/operations/build/wheel.py,sha256=3bP-nNiJ4S8JvMaBnyessXQUBhxTqt1GBx6DQ1iPJDY,1136 -pip/_internal/operations/build/wheel_editable.py,sha256=q3kfElclM6FutVbFwE87JOTpVWt5ixDf3_UkHAIVfz4,1478 -pip/_internal/operations/install/__init__.py,sha256=ak-UETcQPKlFZaWoYKWu5QVXbpFBvg0sXc3i0O4vSYY,50 -pip/_internal/operations/install/wheel.py,sha256=FQIl2AnNadHV5YGGOVEmOHtUUNO8lpzj3Icoo4S2xis,27923 -pip/_internal/req/__init__.py,sha256=WcY9z7D3rlIKX1QY8_tRnAsS_poebiGGdtQ7EJ5JQQo,3041 -pip/_internal/req/constructors.py,sha256=R-6n8irjnaa2DMMXlR4YMouXzykFBlzUFjhOZ1NcUUg,18688 -pip/_internal/req/pep723.py,sha256=olZL3tLmHWJhyLNfbD6U9UuikuzTcLDB06qd9WavTjs,1225 -pip/_internal/req/req_dependency_group.py,sha256=0yEQCUaO5Bza66Y3D5o9JRf0qII5QgCRugn1x5aRivA,2618 -pip/_internal/req/req_file.py,sha256=e32ZQ3kJaL_Sdtf32twGKqIau_AqR43MeSycl0iS2Mw,20685 -pip/_internal/req/req_install.py,sha256=vv5cbs3P5gf43e_1v72gwSQ2N_D_qpsfuXOyerMhDuI,31273 -pip/_internal/req/req_set.py,sha256=awkqIXnYA4Prmsj0Qb3zhqdbYUmXd-1o0P-KZ3mvRQs,2828 -pip/_internal/req/req_uninstall.py,sha256=dCmOHt-9RaJBq921L4tMH3PmIBDetGplnbjRKXmGt00,24099 -pip/_internal/resolution/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_internal/resolution/base.py,sha256=RIsqSP79olPdOgtPKW-oOQ364ICVopehA6RfGkRfe2s,577 -pip/_internal/resolution/legacy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_internal/resolution/legacy/resolver.py,sha256=bwUqE66etz2bcPabqxed18-iyqqb-kx3Er2aT6GeUJY,24060 -pip/_internal/resolution/resolvelib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_internal/resolution/resolvelib/base.py,sha256=_AoP0ZWlaSct8CRDn2ol3CbNn4zDtnh_0zQGjXASDKI,5047 -pip/_internal/resolution/resolvelib/candidates.py,sha256=50AN7BfB-pCfEmbKNlFZSXtdC0C8ms1waJrF2arknQE,20454 -pip/_internal/resolution/resolvelib/factory.py,sha256=82mLwnPlig37mMrDwcgKHJTE9mPczVuJIxeaUb7CQ0Y,34028 -pip/_internal/resolution/resolvelib/found_candidates.py,sha256=8bZYDCZLXSdLHy_s1o5f4r15HmKvqFUhzBUQOF21Lr4,6018 -pip/_internal/resolution/resolvelib/provider.py,sha256=tbVPfFv4Vg780yZ2_XGoGFP5LVo0U2bFnZov3jpSAIk,11441 -pip/_internal/resolution/resolvelib/reporter.py,sha256=faSgjqme0k_uzv1fvM5T0ZatPQ2eEktNvKBqfvXeGjc,3909 -pip/_internal/resolution/resolvelib/requirements.py,sha256=Izl9n8nc188lA1BSPS8QxfudfDQPHgngw-ij6hXt0nQ,8239 -pip/_internal/resolution/resolvelib/resolver.py,sha256=wQ94Hkep-7kWEHAc-NbMJhmzeEzgEAtxeBxyKVzZoeo,13437 -pip/_internal/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_internal/utils/_jaraco_text.py,sha256=M15uUPIh5NpP1tdUGBxRau6q1ZAEtI8-XyLEETscFfE,3350 -pip/_internal/utils/_log.py,sha256=-jHLOE_THaZz5BFcCnoSL9EYAtJ0nXem49s9of4jvKw,1015 -pip/_internal/utils/appdirs.py,sha256=LrzDPZMKVh0rubtCx9vu3XlZbLCSug6VSj4Qsvt66BA,1681 -pip/_internal/utils/compat.py,sha256=C9LHXJAKkwAH8Hn3nPkz9EYK3rqPBeO_IXkOG2zzsdQ,2514 -pip/_internal/utils/compatibility_tags.py,sha256=DiNSLqpuruXUamGQwOJ2WZByDGLTGaXi9O-Xf8fOi34,6630 -pip/_internal/utils/datetime.py,sha256=kuJOf1mW8G5tRFN6jWardddS-9qSaR53lK1jmx3NTZY,868 -pip/_internal/utils/deprecation.py,sha256=HVhvyO5qiRFcG88PhZlp_87qdKQNwPTUIIHWtsTR2yI,3696 -pip/_internal/utils/direct_url_helpers.py,sha256=ttKv4GMUqlRwPPog9_CUopy6SDgoxVILzeBJzgfn2tg,3200 -pip/_internal/utils/egg_link.py,sha256=YWfsrbmfcrfWgqQYy6OuIjsyb9IfL1q_2v4zsms1WjI,2459 -pip/_internal/utils/entrypoints.py,sha256=uPjAyShKObdotjQjJUzprQ6r3xQvDIZwUYfHHqZ7Dok,3324 -pip/_internal/utils/filesystem.py,sha256=mJ_PP8z1V1x4HMhydWIWDyEmWikLX0f-NXPCXEcjiLo,6892 -pip/_internal/utils/filetypes.py,sha256=sEMa38qaqjvx1Zid3OCAUja31BOBU-USuSMPBvU3yjo,689 -pip/_internal/utils/glibc.py,sha256=sEh8RJJLYSdRvTqAO4THVPPA-YSDVLD4SI9So-bxX1U,3726 -pip/_internal/utils/hashes.py,sha256=d32UI1en8nyqZzdZQvxUVdfeBoe4ADWx7HtrIM4-XQ4,4998 -pip/_internal/utils/logging.py,sha256=6lJWMC6c7_aD_i4sdgaaeb-Tm3kWpYg0hba_V1-OLnE,13414 -pip/_internal/utils/misc.py,sha256=phFIbHm2kmliHDXJ0eNPxgGP423ZpvZoMKKtJ1_Zvjs,23722 -pip/_internal/utils/packaging.py,sha256=s5tpUmFumwV0H9JSTzryrIY4JwQM8paGt7Sm7eNwt2Y,1601 -pip/_internal/utils/pylock.py,sha256=nKQknZgyswWgzi--hRQX_DLUYQ3g5wGTCwVNQNdoJ54,3817 -pip/_internal/utils/retry.py,sha256=83wReEB2rcntMZ5VLd7ascaYSjn_kLdlQCqxILxWkPM,1461 -pip/_internal/utils/subprocess.py,sha256=r4-Ba_Yc3uZXQpi0K4pZFsCT_QqdSvtF3XJ-204QWaA,8983 -pip/_internal/utils/temp_dir.py,sha256=D9c8D7WOProOO8GGDqpBeVSj10NGFmunG0o2TodjjIU,9307 -pip/_internal/utils/unpacking.py,sha256=4hNg6dqHOn_KzGCzSC76nChG97d_UjtF9AnLSof672o,12972 -pip/_internal/utils/urls.py,sha256=aF_eg9ul5d8bMCxfSSSxQcfs-OpJdbStYqZHoy2K1RE,1601 -pip/_internal/utils/virtualenv.py,sha256=mX-UPyw1MPxhwUxKhbqWWX70J6PHXAJjVVrRnG0h9mc,3455 -pip/_internal/utils/wheel.py,sha256=YdRuj6MicG-Q9Mg03FbUv1WTLam6Lc7AgijY4voVyis,4468 -pip/_internal/vcs/__init__.py,sha256=UAqvzpbi0VbZo3Ub6skEeZAw-ooIZR-zX_WpCbxyCoU,596 -pip/_internal/vcs/bazaar.py,sha256=3W1eHjkYx2vc6boeb2NBh4I_rlGAXM-vrzfNhLm1Rxg,3734 -pip/_internal/vcs/git.py,sha256=TTeqDuzS-_BFSNuUStVWmE2nGDpKuvUhBBJk_CCQXV0,19144 -pip/_internal/vcs/mercurial.py,sha256=w1ZJWLKqNP1onEjkfjlwBVnMqPZNSIER8ayjQcnTq4w,5575 -pip/_internal/vcs/subversion.py,sha256=uUgdPvxmvEB8Qwtjr0Hc0XgFjbiNi5cbvI4vARLOJXo,11787 -pip/_internal/vcs/versioncontrol.py,sha256=Ma_HMZBVveSkeYvxacvqeujnkSIaF1XjxTsS3BwcJ8E,22599 -pip/_vendor/README.rst,sha256=pKKBwCWhu3M3qQ9dDnsmxb3KdsRr-nWmMq2srbH_Bi0,9394 -pip/_vendor/__init__.py,sha256=WzusPTGWIMeQQWSVJ0h2rafGkVTa9WKJ2HT-2-EoZrU,4907 -pip/_vendor/vendor.txt,sha256=f2msFLZ-chXWIZSKW31NLGyMWmt_-Vfy7sY5dHYgmnw,342 -pip/_vendor/cachecontrol/LICENSE.txt,sha256=hu7uh74qQ_P_H1ZJb0UfaSQ5JvAl_tuwM2ZsMExMFhs,558 -pip/_vendor/cachecontrol/__init__.py,sha256=GxwRkm_TQBtPZpfpVK9r6S9dAy2DVnVgDVHJKTiPZ1k,820 -pip/_vendor/cachecontrol/_cmd.py,sha256=iist2EpzJvDVIhMAxXq8iFnTBsiZAd6iplxfmNboNyk,1737 -pip/_vendor/cachecontrol/adapter.py,sha256=W-HW-l01gyCsnxkOyCbqx7sxrWYoBbKrDsKkVVQN6NE,6586 -pip/_vendor/cachecontrol/cache.py,sha256=OXwv7Fn2AwnKNiahJHnjtvaKLndvVLv_-zO-ltlV9qI,1953 -pip/_vendor/cachecontrol/controller.py,sha256=xBauC-vUSu5GsJsxD4-W-JaKqqbBz0MN6Zv8PA2N8hI,19102 -pip/_vendor/cachecontrol/filewrapper.py,sha256=DhxC_rSk-beKdbsYhfvBUDovQHX9r3gHH_jP9-q_mKk,4354 -pip/_vendor/cachecontrol/heuristics.py,sha256=gqMXU8w0gQuEQiSdu3Yg-0vd9kW7nrWKbLca75rheGE,4881 -pip/_vendor/cachecontrol/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/cachecontrol/serialize.py,sha256=HQd2IllQ05HzPkVLMXTF2uX5mjEQjDBkxCqUJUODpZk,5163 -pip/_vendor/cachecontrol/wrapper.py,sha256=hsGc7g8QGQTT-4f8tgz3AM5qwScg6FO0BSdLSRdEvpU,1417 -pip/_vendor/cachecontrol/caches/__init__.py,sha256=dtrrroK5BnADR1GWjCZ19aZ0tFsMfvFBtLQQU1sp_ag,303 -pip/_vendor/cachecontrol/caches/file_cache.py,sha256=d8upFmy_zwaCmlbWEVBlLXFddt8Zw8c5SFpxeOZsdfw,4117 -pip/_vendor/cachecontrol/caches/redis_cache.py,sha256=9rmqwtYu_ljVkW6_oLqbC7EaX_a8YT_yLuna-eS0dgo,1386 -pip/_vendor/certifi/LICENSE,sha256=6TcW2mucDVpKHfYP5pWzcPBpVgPSH2-D8FPkLPwQyvc,989 -pip/_vendor/certifi/__init__.py,sha256=969deMMS7Uchipr0oO4dbRBUvRi0uNYCn07VmG1aTrg,94 -pip/_vendor/certifi/__main__.py,sha256=1k3Cr95vCxxGRGDljrW3wMdpZdL3Nhf0u1n-k2qdsCY,255 -pip/_vendor/certifi/cacert.pem,sha256=Tzl1_zCrvzVEO0hgZK6Ly0Hf9wf_31dsdtKS-0WKoKk,270954 -pip/_vendor/certifi/core.py,sha256=gu_ECVI1m3Rq0ytpsNE61hgQGcKaOAt9Rs9G8KsTCOI,3442 -pip/_vendor/certifi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/dependency_groups/LICENSE.txt,sha256=GrNuPipLqGMWJThPh-ngkdsfrtA0xbIzJbMjmr8sxSU,1099 -pip/_vendor/dependency_groups/__init__.py,sha256=C3OFu0NGwDzQ4LOmmSOFPsRSvkbBn-mdd4j_5YqJw-s,250 -pip/_vendor/dependency_groups/__main__.py,sha256=UNTM7P5mfVtT7wDi9kOTXWgV3fu3e8bTrt1Qp1jvjKo,1709 -pip/_vendor/dependency_groups/_implementation.py,sha256=Gqb2DlQELRakeHlKf6QtQSW0M-bcEomxHw4JsvID1ls,8041 -pip/_vendor/dependency_groups/_lint_dependency_groups.py,sha256=yp-DDqKXtbkDTNa0ifa-FmOA8ra24lPZEXftW-R5AuI,1710 -pip/_vendor/dependency_groups/_pip_wrapper.py,sha256=nuVW_w_ntVxpE26ELEvngMY0N04sFLsijXRyZZROFG8,1865 -pip/_vendor/dependency_groups/_toml_compat.py,sha256=BHnXnFacm3DeolsA35GjI6qkDApvua-1F20kv3BfZWE,285 -pip/_vendor/dependency_groups/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/distlib/LICENSE.txt,sha256=gI4QyKarjesUn_mz-xn0R6gICUYG1xKpylf-rTVSWZ0,14531 -pip/_vendor/distlib/__init__.py,sha256=Deo3uo98aUyIfdKJNqofeSEFWwDzrV2QeGLXLsgq0Ag,625 -pip/_vendor/distlib/compat.py,sha256=2jRSjRI4o-vlXeTK2BCGIUhkc6e9ZGhSsacRM5oseTw,41467 -pip/_vendor/distlib/resources.py,sha256=LwbPksc0A1JMbi6XnuPdMBUn83X7BPuFNWqPGEKI698,10820 -pip/_vendor/distlib/scripts.py,sha256=Qvp76E9Jc3IgyYubnpqI9fS7eseGOe4FjpeVKqKt9Iw,18612 -pip/_vendor/distlib/t32.exe,sha256=a0GV5kCoWsMutvliiCKmIgV98eRZ33wXoS-XrqvJQVs,97792 -pip/_vendor/distlib/t64-arm.exe,sha256=68TAa32V504xVBnufojh0PcenpR3U4wAqTqf-MZqbPw,182784 -pip/_vendor/distlib/t64.exe,sha256=gaYY8hy4fbkHYTTnA4i26ct8IQZzkBG2pRdy0iyuBrc,108032 -pip/_vendor/distlib/util.py,sha256=vMPGvsS4j9hF6Y9k3Tyom1aaHLb0rFmZAEyzeAdel9w,66682 -pip/_vendor/distlib/w32.exe,sha256=R4csx3-OGM9kL4aPIzQKRo5TfmRSHZo6QWyLhDhNBks,91648 -pip/_vendor/distlib/w64-arm.exe,sha256=xdyYhKj0WDcVUOCb05blQYvzdYIKMbmJn2SZvzkcey4,168448 -pip/_vendor/distlib/w64.exe,sha256=ejGf-rojoBfXseGLpya6bFTFPWRG21X5KvU8J5iU-K0,101888 -pip/_vendor/distro/LICENSE,sha256=y16Ofl9KOYjhBjwULGDcLfdWBfTEZRXnduOspt-XbhQ,11325 -pip/_vendor/distro/__init__.py,sha256=2fHjF-SfgPvjyNZ1iHh_wjqWdR_Yo5ODHwZC0jLBPhc,981 -pip/_vendor/distro/__main__.py,sha256=bu9d3TifoKciZFcqRBuygV3GSuThnVD_m2IK4cz96Vs,64 -pip/_vendor/distro/distro.py,sha256=XqbefacAhDT4zr_trnbA15eY8vdK4GTghgmvUGrEM_4,49430 -pip/_vendor/distro/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/idna/LICENSE.md,sha256=t6M2q_OwThgOwGXN0W5wXQeeHMehT5EKpukYfza5zYc,1541 -pip/_vendor/idna/__init__.py,sha256=MPqNDLZbXqGaNdXxAFhiqFPKEQXju2jNQhCey6-5eJM,868 -pip/_vendor/idna/codec.py,sha256=M2SGWN7cs_6B32QmKTyTN6xQGZeYQgQ2wiX3_DR6loE,3438 -pip/_vendor/idna/compat.py,sha256=RzLy6QQCdl9784aFhb2EX9EKGCJjg0P3PilGdeXXcx8,316 -pip/_vendor/idna/core.py,sha256=P26_XVycuMTZ1R2mNK1ZREVzM5mvTzdabBXfyZVU1Lc,13246 -pip/_vendor/idna/idnadata.py,sha256=SG8jhaGE53iiD6B49pt2pwTv_UvClciWE-N54oR2p4U,79623 -pip/_vendor/idna/intranges.py,sha256=amUtkdhYcQG8Zr-CoMM_kVRacxkivC1WgxN1b63KKdU,1898 -pip/_vendor/idna/package_data.py,sha256=_CUavOxobnbyNG2FLyHoN8QHP3QM9W1tKuw7eq9QwBk,21 -pip/_vendor/idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/idna/uts46data.py,sha256=H9J35VkD0F9L9mKOqjeNGd2A-Va6FlPoz6Jz4K7h-ps,243725 -pip/_vendor/msgpack/COPYING,sha256=SS3tuoXaWHL3jmCRvNH-pHTWYNNay03ulkuKqz8AdCc,614 -pip/_vendor/msgpack/__init__.py,sha256=RA8gcqK17YpkxBnNwXJVa1oa2LygWDgfF1nA1NPw3mo,1109 -pip/_vendor/msgpack/exceptions.py,sha256=dCTWei8dpkrMsQDcjQk74ATl9HsIBH0ybt8zOPNqMYc,1081 -pip/_vendor/msgpack/ext.py,sha256=kteJv03n9tYzd5oo3xYopVTo4vRaAxonBQQJhXohZZo,5726 -pip/_vendor/msgpack/fallback.py,sha256=0g1Pzp0vtmBEmJ5w9F3s_-JMVURP8RS4G1cc5TRaAsI,32390 -pip/_vendor/packaging/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 -pip/_vendor/packaging/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 -pip/_vendor/packaging/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 -pip/_vendor/packaging/__init__.py,sha256=y4lVbpeBzCGk-IPDw5BGBZ_b0P3ukEEJZAbGYc6Ey8c,494 -pip/_vendor/packaging/_elffile.py,sha256=-sKkptYqzYw2-x3QByJa5mB4rfPWu1pxkZHRx1WAFCY,3211 -pip/_vendor/packaging/_manylinux.py,sha256=Hf6nB0cOrayEs96-p3oIXAgGnFquv20DO5l-o2_Xnv0,9559 -pip/_vendor/packaging/_musllinux.py,sha256=Z6swjH3MA7XS3qXnmMN7QPhqP3fnoYI0eQ18e9-HgAE,2707 -pip/_vendor/packaging/_parser.py,sha256=U_DajsEx2VoC_F46fSVV3hDKNCWoQYkPkasO3dld0ig,10518 -pip/_vendor/packaging/_structures.py,sha256=Hn49Ta8zV9Wo8GiCL8Nl2ARZY983Un3pruZGVNldPwE,1514 -pip/_vendor/packaging/_tokenizer.py,sha256=M8EwNIdXeL9NMFuFrQtiOKwjka_xFx8KjRQnfE8O_z8,5421 -pip/_vendor/packaging/markers.py,sha256=ZX-cLvW1S3cZcEc0fHI4z7zSx5U2T19yMpDP_mE-CYw,12771 -pip/_vendor/packaging/metadata.py,sha256=CWVZpN_HfoYMSSDuCP7igOvGgqA9AOmpW8f3qTisfnc,39360 -pip/_vendor/packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/packaging/pylock.py,sha256=-R1uNfJ4PaLto7Mg62YsGOHgvskuiIEqPwxOywl42Jk,22537 -pip/_vendor/packaging/requirements.py,sha256=PMCAWD8aNMnVD-6uZMedhBuAVX2573eZ4yPBLXmz04I,2870 -pip/_vendor/packaging/specifiers.py,sha256=tF2nC-jwW94FYe6So9dNGenQx1Hdif7ErmWlVp1QiXE,40821 -pip/_vendor/packaging/tags.py,sha256=cXLV1pJD3UtJlDg7Wz3zrfdQhRZqr8jumSAKKAAd2xE,22856 -pip/_vendor/packaging/utils.py,sha256=N4c6oZzFJy6klTZ3AnkNz7sSkJesuFWPp68LA3B5dAo,5040 -pip/_vendor/packaging/version.py,sha256=RVRKq8_GD5Bcak6E1kGG8K7siNZYW9n_XK8M2ZLl0H8,23284 -pip/_vendor/packaging/licenses/__init__.py,sha256=TwXLHZCXwSgdFwRLPxW602T6mSieunSFHM6fp8pgW78,5819 -pip/_vendor/packaging/licenses/_spdx.py,sha256=WW7DXiyg68up_YND_wpRYlr1SHhiV4FfJLQffghhMxQ,51122 -pip/_vendor/pkg_resources/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 -pip/_vendor/pkg_resources/__init__.py,sha256=vbTJ0_ruUgGxQjlEqsruFmiNPVyh2t9q-zyTDT053xI,124451 -pip/_vendor/platformdirs/LICENSE,sha256=KeD9YukphQ6G6yjD_czwzv30-pSHkBHP-z0NS-1tTbY,1089 -pip/_vendor/platformdirs/__init__.py,sha256=UfeSHWl8AeTtbOBOoHAxK4dODOWkZtfy-m_i7cWdJ8c,22344 -pip/_vendor/platformdirs/__main__.py,sha256=jBJ8zb7Mpx5ebcqF83xrpO94MaeCpNGHVf9cvDN2JLg,1505 -pip/_vendor/platformdirs/android.py,sha256=r0DshVBf-RO1jXJGX8C4Til7F1XWt-bkdWMgmvEiaYg,9013 -pip/_vendor/platformdirs/api.py,sha256=wPHOlwOsfz2oqQZ6A2FcCu5kEAj-JondzoNOHYFQ0h8,9281 -pip/_vendor/platformdirs/macos.py,sha256=0XoOgin1NK7Qki7iskD-oS8xKxw6bXgoKEgdqpCRAFQ,6322 -pip/_vendor/platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/platformdirs/unix.py,sha256=WZmkUA--L3JNRGmz32s35YfoD3ica6xKIPdCV_HhLcs,10458 -pip/_vendor/platformdirs/version.py,sha256=BI_dKLSMwlkl57vlxZnT8oVjPiUC2W_sdx_8_h99HeQ,704 -pip/_vendor/platformdirs/windows.py,sha256=XvCfklGUMVxJbXit51jpYMN-lNeScPB82qS1CAeplL0,10362 -pip/_vendor/pygments/LICENSE,sha256=qdZvHVJt8C4p3Oc0NtNOVuhjL0bCdbvf_HBWnogvnxc,1331 -pip/_vendor/pygments/__init__.py,sha256=8uNqJCCwXqbEx5aSsBr0FykUQOBDKBihO5mPqiw1aqo,2983 -pip/_vendor/pygments/__main__.py,sha256=WrndpSe6i1ckX_SQ1KaxD9CTKGzD0EuCOFxcbwFpoLU,353 -pip/_vendor/pygments/console.py,sha256=AagDWqwea2yBWf10KC9ptBgMpMjxKp8yABAmh-NQOVk,1718 -pip/_vendor/pygments/filter.py,sha256=YLtpTnZiu07nY3oK9nfR6E9Y1FBHhP5PX8gvkJWcfag,1910 -pip/_vendor/pygments/formatter.py,sha256=KZQMmyo_xkOIkQG8g66LYEkBh1bx7a0HyGCBcvhI9Ew,4390 -pip/_vendor/pygments/lexer.py,sha256=_kBrOJ_NT5Tl0IVM0rA9c8eysP6_yrlGzEQI0eVYB-A,35349 -pip/_vendor/pygments/modeline.py,sha256=K5eSkR8GS1r5OkXXTHOcV0aM_6xpk9eWNEIAW-OOJ2g,1005 -pip/_vendor/pygments/plugin.py,sha256=tPx0rJCTIZ9ioRgLNYG4pifCbAwTRUZddvLw-NfAk2w,1891 -pip/_vendor/pygments/regexopt.py,sha256=wXaP9Gjp_hKAdnICqoDkRxAOQJSc4v3X6mcxx3z-TNs,3072 -pip/_vendor/pygments/scanner.py,sha256=nNcETRR1tRuiTaHmHSTTECVYFPcLf6mDZu1e4u91A9E,3092 -pip/_vendor/pygments/sphinxext.py,sha256=5x7Zh9YlU6ISJ31dMwduiaanb5dWZnKg3MyEQsseNnQ,7981 -pip/_vendor/pygments/style.py,sha256=PlOZqlsnTVd58RGy50vkA2cXQ_lP5bF5EGMEBTno6DA,6420 -pip/_vendor/pygments/token.py,sha256=WbdWGhYm_Vosb0DDxW9lHNPgITXfWTsQmHt6cy9RbcM,6226 -pip/_vendor/pygments/unistring.py,sha256=al-_rBemRuGvinsrM6atNsHTmJ6DUbw24q2O2Ru1cBc,63208 -pip/_vendor/pygments/util.py,sha256=oRtSpiAo5jM9ulntkvVbgXUdiAW57jnuYGB7t9fYuhc,10031 -pip/_vendor/pygments/filters/__init__.py,sha256=4U4jtA0X3iP83uQnB9-TI-HDSw8E8y8zMYHa0UjbbaI,40392 -pip/_vendor/pygments/formatters/__init__.py,sha256=KTwBmnXlaopJhQDOemVHYHskiDghuq-08YtP6xPNJPg,5385 -pip/_vendor/pygments/formatters/_mapping.py,sha256=1Cw37FuQlNacnxRKmtlPX4nyLoX9_ttko5ZwscNUZZ4,4176 -pip/_vendor/pygments/lexers/__init__.py,sha256=wbIME35GH7bI1B9rNPJFqWT-ij_RApZDYPUlZycaLzA,12115 -pip/_vendor/pygments/lexers/_mapping.py,sha256=l4tCXM8e9aPC2BD6sjIr0deT-J-z5tHgCwL-p1fS0PE,77602 -pip/_vendor/pygments/lexers/python.py,sha256=vxjn1cOHclIKJKxoyiBsQTY65GHbkZtZRuKQ2AVCKaw,53853 -pip/_vendor/pygments/styles/__init__.py,sha256=x9ebctfyvCAFpMTlMJ5YxwcNYBzjgq6zJaKkNm78r4M,2042 -pip/_vendor/pygments/styles/_mapping.py,sha256=6lovFUE29tz6EsV3XYY4hgozJ7q1JL7cfO3UOlgnS8w,3312 -pip/_vendor/pyproject_hooks/LICENSE,sha256=GyKwSbUmfW38I6Z79KhNjsBLn9-xpR02DkK0NCyLQVQ,1081 -pip/_vendor/pyproject_hooks/__init__.py,sha256=cPB_a9LXz5xvsRbX1o2qyAdjLatZJdQ_Lc5McNX-X7Y,691 -pip/_vendor/pyproject_hooks/_impl.py,sha256=jY-raxnmyRyB57ruAitrJRUzEexuAhGTpgMygqx67Z4,14936 -pip/_vendor/pyproject_hooks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/pyproject_hooks/_in_process/__init__.py,sha256=MJNPpfIxcO-FghxpBbxkG1rFiQf6HOUbV4U5mq0HFns,557 -pip/_vendor/pyproject_hooks/_in_process/_in_process.py,sha256=qcXMhmx__MIJq10gGHW3mA4Tl8dy8YzHMccwnNoKlw0,12216 -pip/_vendor/requests/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142 -pip/_vendor/requests/__init__.py,sha256=HlB_HzhrzGtfD_aaYUwUh1zWXLZ75_YCLyit75d0Vz8,5057 -pip/_vendor/requests/__version__.py,sha256=QKDceK8K_ujqwDDc3oYrR0odOBYgKVOQQ5vFap_G_cg,435 -pip/_vendor/requests/_internal_utils.py,sha256=nMQymr4hs32TqVo5AbCrmcJEhvPUh7xXlluyqwslLiQ,1495 -pip/_vendor/requests/adapters.py,sha256=2MLFOK9GpYNhiTd6zLDUrAgSkIB-76i6pmSuUJjHC2w,26429 -pip/_vendor/requests/api.py,sha256=_Zb9Oa7tzVIizTKwFrPjDEY9ejtm_OnSRERnADxGsQs,6449 -pip/_vendor/requests/auth.py,sha256=kF75tqnLctZ9Mf_hm9TZIj4cQWnN5uxRz8oWsx5wmR0,10186 -pip/_vendor/requests/certs.py,sha256=kHDlkK_beuHXeMPc5jta2wgl8gdKeUWt5f2nTDVrvt8,441 -pip/_vendor/requests/compat.py,sha256=QfbmdTFiZzjSHMXiMrd4joCRU6RabtQ9zIcPoVaHIus,1822 -pip/_vendor/requests/cookies.py,sha256=bNi-iqEj4NPZ00-ob-rHvzkvObzN3lEpgw3g6paS3Xw,18590 -pip/_vendor/requests/exceptions.py,sha256=D1wqzYWne1mS2rU43tP9CeN1G7QAy7eqL9o1god6Ejw,4272 -pip/_vendor/requests/help.py,sha256=hRKaf9u0G7fdwrqMHtF3oG16RKktRf6KiwtSq2Fo1_0,3813 -pip/_vendor/requests/hooks.py,sha256=CiuysiHA39V5UfcCBXFIx83IrDpuwfN9RcTUgv28ftQ,733 -pip/_vendor/requests/models.py,sha256=taljlg6vJ4b-xMu2TaMNFFkaiwMex_VsEQ6qUTN3wzY,35575 -pip/_vendor/requests/packages.py,sha256=_ZQDCJTJ8SP3kVWunSqBsRZNPzj2c1WFVqbdr08pz3U,1057 -pip/_vendor/requests/sessions.py,sha256=Cl1dpEnOfwrzzPbku-emepNeN4Rt_0_58Iy2x-JGTm8,30503 -pip/_vendor/requests/status_codes.py,sha256=iJUAeA25baTdw-6PfD0eF4qhpINDJRJI-yaMqxs4LEI,4322 -pip/_vendor/requests/structures.py,sha256=-IbmhVz06S-5aPSZuUthZ6-6D9XOjRuTXHOabY041XM,2912 -pip/_vendor/requests/utils.py,sha256=WS3wHSQaaEfceu1syiFo5jf4e_CWKUTep_IabOVI_J0,33225 -pip/_vendor/resolvelib/LICENSE,sha256=84j9OMrRMRLB3A9mm76A5_hFQe26-3LzAw0sp2QsPJ0,751 -pip/_vendor/resolvelib/__init__.py,sha256=yoX-d4STvwGGCiQRE5cJC9Cter69SgVgqClxOCvSP7M,541 -pip/_vendor/resolvelib/providers.py,sha256=pIWJbIdJJ9GFtNbtwTH0Ia43Vj6hYCEJj2DOLue15FM,8914 -pip/_vendor/resolvelib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/resolvelib/reporters.py,sha256=pNJf4nFxLpAeKxlBUi2GEj0a2Ij1nikY0UabTKXesT4,2037 -pip/_vendor/resolvelib/structs.py,sha256=pu-EJiR2IBITr2SQeNPRa0rXhjlStfmO_GEgAhr3004,6420 -pip/_vendor/resolvelib/resolvers/__init__.py,sha256=728M3EvmnPbVXS7ExXlv2kMu6b7wEsoPutEfl-uVk_I,640 -pip/_vendor/resolvelib/resolvers/abstract.py,sha256=CNeQPnpAudY77nmzOkONSmAgRlzIf06X-X9mvRYODms,1543 -pip/_vendor/resolvelib/resolvers/criterion.py,sha256=lcmZGv5sKHOnFD_RzZwvlGSj19MeA-5rCMpdf2Sgw7Y,1768 -pip/_vendor/resolvelib/resolvers/exceptions.py,sha256=ln_jaQtgLlRUSFY627yiHG2gD7AgaXzRKaElFVh7fDQ,1768 -pip/_vendor/resolvelib/resolvers/resolution.py,sha256=3J_zkW-sD3EY-BlNXjyln__njpyH5n0UZJT6uV7CheA,24212 -pip/_vendor/rich/LICENSE,sha256=3u18F6QxgVgZCj6iOcyHmlpQJxzruYrnAl9I--WNyhU,1056 -pip/_vendor/rich/__init__.py,sha256=dRxjIL-SbFVY0q3IjSMrfgBTHrm1LZDgLOygVBwiYZc,6090 -pip/_vendor/rich/__main__.py,sha256=e_aVC-tDzarWQW9SuZMuCgBr6ODV_iDNV2Wh2xkxOlw,7896 -pip/_vendor/rich/_cell_widths.py,sha256=fbmeyetEdHjzE_Vx2l1uK7tnPOhMs2X1lJfO3vsKDpA,10209 -pip/_vendor/rich/_emoji_codes.py,sha256=hu1VL9nbVdppJrVoijVshRlcRRe_v3dju3Mmd2sKZdY,140235 -pip/_vendor/rich/_emoji_replace.py,sha256=n-kcetsEUx2ZUmhQrfeMNc-teeGhpuSQ5F8VPBsyvDo,1064 -pip/_vendor/rich/_export_format.py,sha256=RI08pSrm5tBSzPMvnbTqbD9WIalaOoN5d4M1RTmLq1Y,2128 -pip/_vendor/rich/_extension.py,sha256=Xt47QacCKwYruzjDi-gOBq724JReDj9Cm9xUi5fr-34,265 -pip/_vendor/rich/_fileno.py,sha256=HWZxP5C2ajMbHryvAQZseflVfQoGzsKOHzKGsLD8ynQ,799 -pip/_vendor/rich/_inspect.py,sha256=ROT0PLC2GMWialWZkqJIjmYq7INRijQQkoSokWTaAiI,9656 -pip/_vendor/rich/_log_render.py,sha256=1ByI0PA1ZpxZY3CGJOK54hjlq4X-Bz_boIjIqCd8Kns,3225 -pip/_vendor/rich/_loop.py,sha256=hV_6CLdoPm0va22Wpw4zKqM0RYsz3TZxXj0PoS-9eDQ,1236 -pip/_vendor/rich/_null_file.py,sha256=ADGKp1yt-k70FMKV6tnqCqecB-rSJzp-WQsD7LPL-kg,1394 -pip/_vendor/rich/_palettes.py,sha256=cdev1JQKZ0JvlguV9ipHgznTdnvlIzUFDBb0It2PzjI,7063 -pip/_vendor/rich/_pick.py,sha256=evDt8QN4lF5CiwrUIXlOJCntitBCOsI3ZLPEIAVRLJU,423 -pip/_vendor/rich/_ratio.py,sha256=IOtl78sQCYZsmHyxhe45krkb68u9xVz7zFsXVJD-b2Y,5325 -pip/_vendor/rich/_spinners.py,sha256=U2r1_g_1zSjsjiUdAESc2iAMc3i4ri_S8PYP6kQ5z1I,19919 -pip/_vendor/rich/_stack.py,sha256=-C8OK7rxn3sIUdVwxZBBpeHhIzX0eI-VM3MemYfaXm0,351 -pip/_vendor/rich/_timer.py,sha256=zelxbT6oPFZnNrwWPpc1ktUeAT-Vc4fuFcRZLQGLtMI,417 -pip/_vendor/rich/_win32_console.py,sha256=BSaDRIMwBLITn_m0mTRLPqME5q-quGdSMuYMpYeYJwc,22755 -pip/_vendor/rich/_windows.py,sha256=aBwaD_S56SbgopIvayVmpk0Y28uwY2C5Bab1wl3Bp-I,1925 -pip/_vendor/rich/_windows_renderer.py,sha256=t74ZL3xuDCP3nmTp9pH1L5LiI2cakJuQRQleHCJerlk,2783 -pip/_vendor/rich/_wrap.py,sha256=FlSsom5EX0LVkA3KWy34yHnCfLtqX-ZIepXKh-70rpc,3404 -pip/_vendor/rich/abc.py,sha256=ON-E-ZqSSheZ88VrKX2M3PXpFbGEUUZPMa_Af0l-4f0,890 -pip/_vendor/rich/align.py,sha256=dg-7uY0ukMLLlUEsBDRLva22_sQgIJD4BK0dmZHFHug,10324 -pip/_vendor/rich/ansi.py,sha256=Avs1LHbSdcyOvDOdpELZUoULcBiYewY76eNBp6uFBhs,6921 -pip/_vendor/rich/bar.py,sha256=ldbVHOzKJOnflVNuv1xS7g6dLX2E3wMnXkdPbpzJTcs,3263 -pip/_vendor/rich/box.py,sha256=kmavBc_dn73L_g_8vxWSwYJD2uzBXOUFTtJOfpbczcM,10686 -pip/_vendor/rich/cells.py,sha256=KrQkj5-LghCCpJLSNQIyAZjndc4bnEqOEmi5YuZ9UCY,5130 -pip/_vendor/rich/color.py,sha256=3HSULVDj7qQkXUdFWv78JOiSZzfy5y1nkcYhna296V0,18211 -pip/_vendor/rich/color_triplet.py,sha256=3lhQkdJbvWPoLDO-AnYImAWmJvV5dlgYNCVZ97ORaN4,1054 -pip/_vendor/rich/columns.py,sha256=HUX0KcMm9dsKNi11fTbiM_h2iDtl8ySCaVcxlalEzq8,7131 -pip/_vendor/rich/console.py,sha256=t9azZpmRMVU5cphVBZSShNsmBxd2-IAWcTTlhor-E1s,100849 -pip/_vendor/rich/constrain.py,sha256=1VIPuC8AgtKWrcncQrjBdYqA3JVWysu6jZo1rrh7c7Q,1288 -pip/_vendor/rich/containers.py,sha256=c_56TxcedGYqDepHBMTuZdUIijitAQgnox-Qde0Z1qo,5502 -pip/_vendor/rich/control.py,sha256=EUTSUFLQbxY6Zmo_sdM-5Ls323vIHTBfN8TPulqeHUY,6487 -pip/_vendor/rich/default_styles.py,sha256=khQFqqaoDs3bprMqWpHw8nO5UpG2DN6QtuTd6LzZwYc,8257 -pip/_vendor/rich/diagnose.py,sha256=fJl1TItRn19gGwouqTg-8zPUW3YqQBqGltrfPQs1H9w,1025 -pip/_vendor/rich/emoji.py,sha256=Wd4bQubZdSy6-PyrRQNuMHtn2VkljK9uPZPVlu2cmx0,2367 -pip/_vendor/rich/errors.py,sha256=5pP3Kc5d4QJ_c0KFsxrfyhjiPVe7J1zOqSFbFAzcV-Y,642 -pip/_vendor/rich/file_proxy.py,sha256=Tl9THMDZ-Pk5Wm8sI1gGg_U5DhusmxD-FZ0fUbcU0W0,1683 -pip/_vendor/rich/filesize.py,sha256=_iz9lIpRgvW7MNSeCZnLg-HwzbP4GETg543WqD8SFs0,2484 -pip/_vendor/rich/highlighter.py,sha256=G_sn-8DKjM1sEjLG_oc4ovkWmiUpWvj8bXi0yed2LnY,9586 -pip/_vendor/rich/json.py,sha256=vVEoKdawoJRjAFayPwXkMBPLy7RSTs-f44wSQDR2nJ0,5031 -pip/_vendor/rich/jupyter.py,sha256=QyoKoE_8IdCbrtiSHp9TsTSNyTHY0FO5whE7jOTd9UE,3252 -pip/_vendor/rich/layout.py,sha256=ajkSFAtEVv9EFTcFs-w4uZfft7nEXhNzL7ZVdgrT5rI,14004 -pip/_vendor/rich/live.py,sha256=tF3ukAAJZ_N2ZbGclqZ-iwLoIoZ8f0HHUz79jAyJqj8,15180 -pip/_vendor/rich/live_render.py,sha256=It_39YdzrBm8o3LL0kaGorPFg-BfZWAcrBjLjFokbx4,3521 -pip/_vendor/rich/logging.py,sha256=5KaPPSMP9FxcXPBcKM4cGd_zW78PMgf-YbMVnvfSw0o,12468 -pip/_vendor/rich/markup.py,sha256=3euGKP5s41NCQwaSjTnJxus5iZMHjxpIM0W6fCxra38,8451 -pip/_vendor/rich/measure.py,sha256=HmrIJX8sWRTHbgh8MxEay_83VkqNW_70s8aKP5ZcYI8,5305 -pip/_vendor/rich/padding.py,sha256=KVEI3tOwo9sgK1YNSuH__M1_jUWmLZwRVV_KmOtVzyM,4908 -pip/_vendor/rich/pager.py,sha256=SO_ETBFKbg3n_AgOzXm41Sv36YxXAyI3_R-KOY2_uSc,828 -pip/_vendor/rich/palette.py,sha256=lInvR1ODDT2f3UZMfL1grq7dY_pDdKHw4bdUgOGaM4Y,3396 -pip/_vendor/rich/panel.py,sha256=9sQl00hPIqH5G2gALQo4NepFwpP0k9wT-s_gOms5pIc,11157 -pip/_vendor/rich/pretty.py,sha256=gy3S72u4FRg2ytoo7N1ZDWDIvB4unbzd5iUGdgm-8fc,36391 -pip/_vendor/rich/progress.py,sha256=CUc2lkU-X59mVdGfjMCBkZeiGPL3uxdONjhNJF2T7wY,60408 -pip/_vendor/rich/progress_bar.py,sha256=mZTPpJUwcfcdgQCTTz3kyY-fc79ddLwtx6Ghhxfo064,8162 -pip/_vendor/rich/prompt.py,sha256=l0RhQU-0UVTV9e08xW1BbIj0Jq2IXyChX4lC0lFNzt4,12447 -pip/_vendor/rich/protocol.py,sha256=5hHHDDNHckdk8iWH5zEbi-zuIVSF5hbU2jIo47R7lTE,1391 -pip/_vendor/rich/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/rich/region.py,sha256=rNT9xZrVZTYIXZC0NYn41CJQwYNbR-KecPOxTgQvB8Y,166 -pip/_vendor/rich/repr.py,sha256=5MZJZmONgC6kud-QW-_m1okXwL2aR6u6y-pUcUCJz28,4431 -pip/_vendor/rich/rule.py,sha256=0fNaS_aERa3UMRc3T5WMpN_sumtDxfaor2y3of1ftBk,4602 -pip/_vendor/rich/scope.py,sha256=TMUU8qo17thyqQCPqjDLYpg_UU1k5qVd-WwiJvnJVas,2843 -pip/_vendor/rich/screen.py,sha256=YoeReESUhx74grqb0mSSb9lghhysWmFHYhsbMVQjXO8,1591 -pip/_vendor/rich/segment.py,sha256=otnKeKGEV-WRlQVosfJVeFDcDxAKHpvJ_hLzSu5lumM,24743 -pip/_vendor/rich/spinner.py,sha256=onIhpKlljRHppTZasxO8kXgtYyCHUkpSgKglRJ3o51g,4214 -pip/_vendor/rich/status.py,sha256=kkPph3YeAZBo-X-4wPp8gTqZyU466NLwZBA4PZTTewo,4424 -pip/_vendor/rich/style.py,sha256=W9Ccy8Py8lNICtlfcp-ryzMTuQaGxAU3av7-g5fHu0s,26990 -pip/_vendor/rich/styled.py,sha256=eZNnzGrI4ki_54pgY3Oj0T-x3lxdXTYh4_ryDB24wBU,1258 -pip/_vendor/rich/syntax.py,sha256=eDKIRwl--eZ0Lwo2da2RRtfutXGavrJO61Cl5OkS59U,36371 -pip/_vendor/rich/table.py,sha256=ZmT7V7MMCOYKw7TGY9SZLyYDf6JdM-WVf07FdVuVhTI,40049 -pip/_vendor/rich/terminal_theme.py,sha256=1j5-ufJfnvlAo5Qsi_ACZiXDmwMXzqgmFByObT9-yJY,3370 -pip/_vendor/rich/text.py,sha256=AO7JPCz6-gaN1thVLXMBntEmDPVYFgFNG1oM61_sanU,47552 -pip/_vendor/rich/theme.py,sha256=oNyhXhGagtDlbDye3tVu3esWOWk0vNkuxFw-_unlaK0,3771 -pip/_vendor/rich/themes.py,sha256=0xgTLozfabebYtcJtDdC5QkX5IVUEaviqDUJJh4YVFk,102 -pip/_vendor/rich/traceback.py,sha256=c0WmB_L04_UfZbLaoH982_U_s7eosxKMUiAVmDPdRYU,35861 -pip/_vendor/rich/tree.py,sha256=yWnQ6rAvRGJ3qZGqBrxS2SW2TKBTNrP0SdY8QxOFPuw,9451 -pip/_vendor/tomli/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072 -pip/_vendor/tomli/__init__.py,sha256=qzEGl8QHhqgQPCuLzfKyPIuH3KKPspf-UVPbZ0ppBD4,314 -pip/_vendor/tomli/_parser.py,sha256=bO8tUYmnyA2K6m4TnbQbfUqmIFcDv7mG1KuC9gqRVmA,25778 -pip/_vendor/tomli/_re.py,sha256=n8-Io8ZK1U-F6jzlg7Pabc40hLFJsawE2uNLKH9w7iU,3235 -pip/_vendor/tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254 -pip/_vendor/tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26 -pip/_vendor/tomli_w/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072 -pip/_vendor/tomli_w/__init__.py,sha256=0F8yDtXx3Uunhm874KrAcP76srsM98y7WyHQwCulZbo,169 -pip/_vendor/tomli_w/_writer.py,sha256=dsifFS2xYf1i76mmRyfz9y125xC7Z_HQ845ZKhJsYXs,6961 -pip/_vendor/tomli_w/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26 -pip/_vendor/truststore/LICENSE,sha256=M757fo-k_Rmxdg4ajtimaL2rhSyRtpLdQUJLy3Jan8o,1086 -pip/_vendor/truststore/__init__.py,sha256=Bu7kqkmpunhLsj5xCu8gT_25ktoPXcSnwe8VHk1GmJo,1320 -pip/_vendor/truststore/_api.py,sha256=CYJCV5BTfttZYfqY3movdMBE-8az7uhET_LYbKT2Nn4,11413 -pip/_vendor/truststore/_macos.py,sha256=nZlLkOmszUE0g6ryRwBVGY5COzPyudcsiJtDWarM5LQ,20503 -pip/_vendor/truststore/_openssl.py,sha256=zB-SQvJydks7tQ0yIwrP6GD3fQNSSaPiq7zw4yF5T40,2412 -pip/_vendor/truststore/_ssl_constants.py,sha256=NUD4fVKdSD02ri7-db0tnO0VqLP9aHuzmStcW7tAl08,1130 -pip/_vendor/truststore/_windows.py,sha256=rAHyKYD8M7t-bXfG8VgOVa3TpfhVhbt4rZQlO45YuP8,17993 -pip/_vendor/truststore/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/urllib3/LICENSE.txt,sha256=w3vxhuJ8-dvpYZ5V7f486nswCRzrPaY8fay-Dm13kHs,1115 -pip/_vendor/urllib3/__init__.py,sha256=iXLcYiJySn0GNbWOOZDDApgBL1JgP44EZ8i1760S8Mc,3333 -pip/_vendor/urllib3/_collections.py,sha256=pyASJJhW7wdOpqJj9QJA8FyGRfr8E8uUUhqUvhF0728,11372 -pip/_vendor/urllib3/_version.py,sha256=t9wGB6ooOTXXgiY66K1m6BZS1CJyXHAU8EoWDTe6Shk,64 -pip/_vendor/urllib3/connection.py,sha256=ttIA909BrbTUzwkqEe_TzZVh4JOOj7g61Ysei2mrwGg,20314 -pip/_vendor/urllib3/connectionpool.py,sha256=e2eiAwNbFNCKxj4bwDKNK-w7HIdSz3OmMxU_TIt-evQ,40408 -pip/_vendor/urllib3/exceptions.py,sha256=0Mnno3KHTNfXRfY7638NufOPkUb6mXOm-Lqj-4x2w8A,8217 -pip/_vendor/urllib3/fields.py,sha256=kvLDCg_JmH1lLjUUEY_FLS8UhY7hBvDPuVETbY8mdrM,8579 -pip/_vendor/urllib3/filepost.py,sha256=5b_qqgRHVlL7uLtdAYBzBh-GHmU5AfJVt_2N0XS3PeY,2440 -pip/_vendor/urllib3/poolmanager.py,sha256=aWyhXRtNO4JUnCSVVqKTKQd8EXTvUm1VN9pgs2bcONo,19990 -pip/_vendor/urllib3/request.py,sha256=YTWFNr7QIwh7E1W9dde9LM77v2VWTJ5V78XuTTw7D1A,6691 -pip/_vendor/urllib3/response.py,sha256=fmDJAFkG71uFTn-sVSTh2Iw0WmcXQYqkbRjihvwBjU8,30641 -pip/_vendor/urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/urllib3/contrib/_appengine_environ.py,sha256=bDbyOEhW2CKLJcQqAKAyrEHN-aklsyHFKq6vF8ZFsmk,957 -pip/_vendor/urllib3/contrib/appengine.py,sha256=VR68eAVE137lxTgjBDwCna5UiBZTOKa01Aj_-5BaCz4,11036 -pip/_vendor/urllib3/contrib/ntlmpool.py,sha256=NlfkW7WMdW8ziqudopjHoW299og1BTWi0IeIibquFwk,4528 -pip/_vendor/urllib3/contrib/pyopenssl.py,sha256=hDJh4MhyY_p-oKlFcYcQaVQRDv6GMmBGuW9yjxyeejM,17081 -pip/_vendor/urllib3/contrib/securetransport.py,sha256=Fef1IIUUFHqpevzXiDPbIGkDKchY2FVKeVeLGR1Qq3g,34446 -pip/_vendor/urllib3/contrib/socks.py,sha256=aRi9eWXo9ZEb95XUxef4Z21CFlnnjbEiAo9HOseoMt4,7097 -pip/_vendor/urllib3/contrib/_securetransport/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/urllib3/contrib/_securetransport/bindings.py,sha256=4Xk64qIkPBt09A5q-RIFUuDhNc9mXilVapm7WnYnzRw,17632 -pip/_vendor/urllib3/contrib/_securetransport/low_level.py,sha256=B2JBB2_NRP02xK6DCa1Pa9IuxrPwxzDzZbixQkb7U9M,13922 -pip/_vendor/urllib3/packages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/urllib3/packages/six.py,sha256=b9LM0wBXv7E7SrbCjAm4wwN-hrH-iNxv18LgWNMMKPo,34665 -pip/_vendor/urllib3/packages/backports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pip/_vendor/urllib3/packages/backports/makefile.py,sha256=nbzt3i0agPVP07jqqgjhaYjMmuAi_W5E0EywZivVO8E,1417 -pip/_vendor/urllib3/packages/backports/weakref_finalize.py,sha256=tRCal5OAhNSRyb0DhHp-38AtIlCsRP8BxF3NX-6rqIA,5343 -pip/_vendor/urllib3/util/__init__.py,sha256=JEmSmmqqLyaw8P51gUImZh8Gwg9i1zSe-DoqAitn2nc,1155 -pip/_vendor/urllib3/util/connection.py,sha256=5Lx2B1PW29KxBn2T0xkN1CBgRBa3gGVJBKoQoRogEVk,4901 -pip/_vendor/urllib3/util/proxy.py,sha256=zUvPPCJrp6dOF0N4GAVbOcl6o-4uXKSrGiTkkr5vUS4,1605 -pip/_vendor/urllib3/util/queue.py,sha256=nRgX8_eX-_VkvxoX096QWoz8Ps0QHUAExILCY_7PncM,498 -pip/_vendor/urllib3/util/request.py,sha256=C0OUt2tcU6LRiQJ7YYNP9GvPrSvl7ziIBekQ-5nlBZk,3997 -pip/_vendor/urllib3/util/response.py,sha256=GJpg3Egi9qaJXRwBh5wv-MNuRWan5BIu40oReoxWP28,3510 -pip/_vendor/urllib3/util/retry.py,sha256=6ENvOZ8PBDzh8kgixpql9lIrb2dxH-k7ZmBanJF2Ng4,22050 -pip/_vendor/urllib3/util/ssl_.py,sha256=QDuuTxPSCj1rYtZ4xpD7Ux-r20TD50aHyqKyhQ7Bq4A,17460 -pip/_vendor/urllib3/util/ssl_match_hostname.py,sha256=Ir4cZVEjmAk8gUAIHWSi7wtOO83UCYABY2xFD1Ql_WA,5758 -pip/_vendor/urllib3/util/ssltransport.py,sha256=NA-u5rMTrDFDFC8QzRKUEKMG0561hOD4qBTr3Z4pv6E,6895 -pip/_vendor/urllib3/util/timeout.py,sha256=cwq4dMk87mJHSBktK1miYJ-85G-3T3RmT20v7SFCpno,10168 -pip/_vendor/urllib3/util/url.py,sha256=lCAE7M5myA8EDdW0sJuyyZhVB9K_j38ljWhHAnFaWoE,14296 -pip/_vendor/urllib3/util/wait.py,sha256=fOX0_faozG2P7iVojQoE1mbydweNyTcm-hXEfFrTtLI,5403 -pip-26.0.1.dist-info/entry_points.txt,sha256=Vhf8s0IYgX37mtd4vGL73BPcxdKnqeCFPzB5-d30x8o,84 -pip-26.0.1.dist-info/licenses/AUTHORS.txt,sha256=grSl9YDNOpOFFJTX8ZYKSdgfouXi_DzlRyYGE2-u5aI,11731 -pip-26.0.1.dist-info/licenses/LICENSE.txt,sha256=Y0MApmnUmurmWxLGxIySTFGkzfPR_whtw0VtyLyqIQQ,1093 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/cachecontrol/LICENSE.txt,sha256=hu7uh74qQ_P_H1ZJb0UfaSQ5JvAl_tuwM2ZsMExMFhs,558 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/certifi/LICENSE,sha256=6TcW2mucDVpKHfYP5pWzcPBpVgPSH2-D8FPkLPwQyvc,989 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/dependency_groups/LICENSE.txt,sha256=GrNuPipLqGMWJThPh-ngkdsfrtA0xbIzJbMjmr8sxSU,1099 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/distlib/LICENSE.txt,sha256=gI4QyKarjesUn_mz-xn0R6gICUYG1xKpylf-rTVSWZ0,14531 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/distro/LICENSE,sha256=y16Ofl9KOYjhBjwULGDcLfdWBfTEZRXnduOspt-XbhQ,11325 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/idna/LICENSE.md,sha256=t6M2q_OwThgOwGXN0W5wXQeeHMehT5EKpukYfza5zYc,1541 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/msgpack/COPYING,sha256=SS3tuoXaWHL3jmCRvNH-pHTWYNNay03ulkuKqz8AdCc,614 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/pkg_resources/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/platformdirs/LICENSE,sha256=KeD9YukphQ6G6yjD_czwzv30-pSHkBHP-z0NS-1tTbY,1089 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/pygments/LICENSE,sha256=qdZvHVJt8C4p3Oc0NtNOVuhjL0bCdbvf_HBWnogvnxc,1331 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/pyproject_hooks/LICENSE,sha256=GyKwSbUmfW38I6Z79KhNjsBLn9-xpR02DkK0NCyLQVQ,1081 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/requests/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/resolvelib/LICENSE,sha256=84j9OMrRMRLB3A9mm76A5_hFQe26-3LzAw0sp2QsPJ0,751 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/rich/LICENSE,sha256=3u18F6QxgVgZCj6iOcyHmlpQJxzruYrnAl9I--WNyhU,1056 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli_w/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/truststore/LICENSE,sha256=M757fo-k_Rmxdg4ajtimaL2rhSyRtpLdQUJLy3Jan8o,1086 -pip-26.0.1.dist-info/licenses/src/pip/_vendor/urllib3/LICENSE.txt,sha256=w3vxhuJ8-dvpYZ5V7f486nswCRzrPaY8fay-Dm13kHs,1115 -pip-26.0.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82 -pip-26.0.1.dist-info/METADATA,sha256=ZqIZuNGsG6l2gHiKlQjVQghFQhgSWfhEDHuCVPW3aN8,4675 -pip-26.0.1.dist-info/RECORD,, -pip/_vendor/requests/auth.cpython-314.pyc,, -pip/_vendor/rich/themes.cpython-314.pyc,, -pip/_vendor/urllib3/util/request.cpython-314.pyc,, -pip/_vendor/rich/_loop.cpython-314.pyc,, -pip/_vendor/rich/file_proxy.cpython-314.pyc,, -pip/_vendor/distro/__init__.cpython-314.pyc,, -pip/_internal/vcs/__init__.cpython-314.pyc,, -pip/_internal/network/__init__.cpython-314.pyc,, -pip/_vendor/resolvelib/resolvers/resolution.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/__pycache__,, -pip/_vendor/packaging/_musllinux.cpython-314.pyc,, -pip-26.0.1.virtualenv,, -pip/_vendor/rich/_export_format.cpython-314.pyc,, -pip/_internal/models/installation_report.cpython-314.pyc,, -pip/_internal/utils/compat.cpython-314.pyc,, -pip/_vendor/rich/prompt.cpython-314.pyc,, -pip/_internal/operations/build/wheel.cpython-314.pyc,, -pip/_internal/req/pep723.cpython-314.pyc,, -pip/_internal/operations/build/metadata.cpython-314.pyc,, -pip/_vendor/rich/tree.cpython-314.pyc,, -pip/_internal/__pycache__,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli/__pycache__,, -pip/_vendor/idna/__pycache__,, -pip/__pip-runner__.cpython-314.pyc,, -pip/_internal/index/collector.cpython-314.pyc,, -pip/_vendor/rich/_null_file.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/platformdirs/__pycache__,, -pip-26.0.1.dist-info/licenses/__pycache__,, -pip/_vendor/urllib3/__pycache__,, -pip/_internal/network/xmlrpc.cpython-314.pyc,, -pip/_vendor/requests/cookies.cpython-314.pyc,, -pip/_vendor/rich/rule.cpython-314.pyc,, -pip/_vendor/pygments/regexopt.cpython-314.pyc,, -pip/_vendor/urllib3/packages/backports/__pycache__,, -pip/_internal/build_env.cpython-314.pyc,, -pip/_internal/models/target_python.cpython-314.pyc,, -pip/_internal/vcs/__pycache__,, -pip/_vendor/urllib3/fields.cpython-314.pyc,, -pip/_internal/distributions/__init__.cpython-314.pyc,, -pip/_internal/cli/status_codes.cpython-314.pyc,, -pip/_internal/commands/debug.cpython-314.pyc,, -pip/_vendor/rich/errors.cpython-314.pyc,, -pip/__init__.cpython-314.pyc,, -pip/_vendor/urllib3/util/ssltransport.cpython-314.pyc,, -pip/_vendor/rich/_log_render.cpython-314.pyc,, -pip/_vendor/packaging/__init__.cpython-314.pyc,, -pip/_vendor/packaging/_structures.cpython-314.pyc,, -pip/_internal/cli/req_command.cpython-314.pyc,, -pip/_vendor/pygments/formatters/__init__.cpython-314.pyc,, -pip/_vendor/rich/panel.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/distro/__pycache__,, -pip/_internal/cli/base_command.cpython-314.pyc,, -pip/_vendor/idna/package_data.cpython-314.pyc,, -pip/_vendor/packaging/markers.cpython-314.pyc,, -pip/_internal/models/format_control.cpython-314.pyc,, -pip/_internal/utils/retry.cpython-314.pyc,, -pip/_vendor/tomli/__pycache__,, -pip/_vendor/rich/_emoji_replace.cpython-314.pyc,, -pip/_internal/models/scheme.cpython-314.pyc,, -pip/_vendor/pygments/__main__.cpython-314.pyc,, -pip/_vendor/rich/logging.cpython-314.pyc,, -pip/_vendor/__pycache__,, -pip/_vendor/pygments/filters/__init__.cpython-314.pyc,, -pip/_vendor/rich/box.cpython-314.pyc,, -pip/_internal/commands/install.cpython-314.pyc,, -pip/_internal/utils/logging.cpython-314.pyc,, -pip/_internal/cli/__init__.cpython-314.pyc,, -pip/_internal/req/__pycache__,, -pip/_internal/resolution/resolvelib/requirements.cpython-314.pyc,, -pip/_internal/distributions/wheel.cpython-314.pyc,, -pip/_vendor/rich/layout.cpython-314.pyc,, -pip/_vendor/distlib/compat.cpython-314.pyc,, -pip/_vendor/cachecontrol/filewrapper.cpython-314.pyc,, -pip/_vendor/rich/jupyter.cpython-314.pyc,, -pip/_internal/models/__init__.cpython-314.pyc,, -pip/_internal/cli/index_command.cpython-314.pyc,, -pip/_internal/utils/__init__.cpython-314.pyc,, -pip/_internal/distributions/installed.cpython-314.pyc,, -pip/_vendor/urllib3/util/wait.cpython-314.pyc,, -pip/_internal/vcs/git.cpython-314.pyc,, -pip/_vendor/rich/region.cpython-314.pyc,, -pip/_vendor/rich/filesize.cpython-314.pyc,, -pip/_internal/utils/egg_link.cpython-314.pyc,, -pip/_vendor/cachecontrol/cache.cpython-314.pyc,, -pip/_vendor/pygments/formatters/__pycache__,, -pip/_internal/utils/wheel.cpython-314.pyc,, -pip/_internal/commands/freeze.cpython-314.pyc,, -pip/_vendor/packaging/_manylinux.cpython-314.pyc,, -pip/_internal/operations/build/build_tracker.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/__pycache__,, -pip/_internal/utils/virtualenv.cpython-314.pyc,, -pip/_vendor/urllib3/poolmanager.cpython-314.pyc,, -pip/_vendor/pygments/token.cpython-314.pyc,, -pip/_vendor/pygments/modeline.cpython-314.pyc,, -pip/_vendor/dependency_groups/_lint_dependency_groups.cpython-314.pyc,, -pip/_internal/models/candidate.cpython-314.pyc,, -pip/_internal/index/__init__.cpython-314.pyc,, -pip/_vendor/distro/distro.cpython-314.pyc,, -pip/_vendor/rich/_spinners.cpython-314.pyc,, -pip/_internal/cache.cpython-314.pyc,, -pip/_vendor/resolvelib/resolvers/__init__.cpython-314.pyc,, -pip/_vendor/requests/models.cpython-314.pyc,, -pip/_internal/network/__pycache__,, -pip/_vendor/packaging/_tokenizer.cpython-314.pyc,, -pip/_vendor/resolvelib/reporters.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/ntlmpool.cpython-314.pyc,, -pip/_vendor/pygments/__pycache__,, -pip/_internal/utils/entrypoints.cpython-314.pyc,, -pip/_internal/utils/urls.cpython-314.pyc,, -pip/_vendor/packaging/__pycache__,, -pip/_internal/resolution/resolvelib/factory.cpython-314.pyc,, -pip/_internal/network/cache.cpython-314.pyc,, -pip/_vendor/platformdirs/api.cpython-314.pyc,, -pip/_internal/metadata/importlib/__pycache__,, -pip/_vendor/rich/_palettes.cpython-314.pyc,, -pip/_internal/utils/appdirs.cpython-314.pyc,, -pip/_vendor/distlib/resources.cpython-314.pyc,, -pip/_vendor/truststore/__pycache__,, -pip/_vendor/pygments/styles/__init__.cpython-314.pyc,, -pip/_internal/vcs/versioncontrol.cpython-314.pyc,, -pip/_internal/vcs/subversion.cpython-314.pyc,, -pip/_vendor/rich/measure.cpython-314.pyc,, -pip/_vendor/urllib3/__init__.cpython-314.pyc,, -pip/_internal/cli/main_parser.cpython-314.pyc,, -pip/_vendor/rich/__main__.cpython-314.pyc,, -pip/_vendor/rich/emoji.cpython-314.pyc,, -pip/_vendor/pkg_resources/__init__.cpython-314.pyc,, -pip/_vendor/msgpack/__init__.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/pkg_resources/__pycache__,, -pip/_vendor/platformdirs/unix.cpython-314.pyc,, -pip/_vendor/rich/align.cpython-314.pyc,, -pip/_internal/commands/inspect.cpython-314.pyc,, -pip/_vendor/rich/table.cpython-314.pyc,, -pip/_internal/resolution/resolvelib/__pycache__,, -pip/_vendor/platformdirs/__main__.cpython-314.pyc,, -pip/_vendor/cachecontrol/adapter.cpython-314.pyc,, -pip/_internal/models/selection_prefs.cpython-314.pyc,, -pip/_vendor/cachecontrol/caches/__init__.cpython-314.pyc,, -pip/_internal/locations/_sysconfig.cpython-314.pyc,, -pip/_vendor/cachecontrol/caches/file_cache.cpython-314.pyc,, -pip/_vendor/rich/_emoji_codes.cpython-314.pyc,, -pip/_internal/cli/spinners.cpython-314.pyc,, -pip/_internal/cli/cmdoptions.cpython-314.pyc,, -pip/_internal/resolution/resolvelib/resolver.cpython-314.pyc,, -pip/_vendor/idna/compat.cpython-314.pyc,, -pip/_internal/utils/packaging.cpython-314.pyc,, -pip/_vendor/urllib3/_version.cpython-314.pyc,, -pip/_vendor/idna/__init__.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/msgpack/__pycache__,, -pip/_vendor/pygments/__init__.cpython-314.pyc,, -pip/_vendor/distlib/__pycache__,, -pip/_vendor/cachecontrol/__init__.cpython-314.pyc,, -pip/_internal/resolution/legacy/resolver.cpython-314.pyc,, -pip/_vendor/rich/_cell_widths.cpython-314.pyc,, -pip/_vendor/cachecontrol/heuristics.cpython-314.pyc,, -pip/_vendor/truststore/_ssl_constants.cpython-314.pyc,, -pip/_internal/distributions/base.cpython-314.pyc,, -pip/_vendor/rich/_windows_renderer.cpython-314.pyc,, -pip/_internal/wheel_builder.cpython-314.pyc,, -pip/_vendor/pygments/filters/__pycache__,, -pip/_internal/req/req_file.cpython-314.pyc,, -pip/_vendor/tomli/_parser.cpython-314.pyc,, -pip/_internal/network/auth.cpython-314.pyc,, -pip/_internal/commands/completion.cpython-314.pyc,, -pip/_vendor/packaging/_elffile.cpython-314.pyc,, -pip/_internal/metadata/importlib/__init__.cpython-314.pyc,, -pip/_vendor/pygments/style.cpython-314.pyc,, -pip/__main__.cpython-314.pyc,, -pip/_internal/resolution/legacy/__pycache__,, -pip/_vendor/pygments/util.cpython-314.pyc,, -pip/_vendor/urllib3/util/timeout.cpython-314.pyc,, -pip/_vendor/rich/_wrap.cpython-314.pyc,, -pip/_internal/utils/filesystem.cpython-314.pyc,, -pip/_vendor/packaging/licenses/_spdx.cpython-314.pyc,, -pip/_vendor/pyproject_hooks/__init__.cpython-314.pyc,, -pip/_vendor/rich/terminal_theme.cpython-314.pyc,, -pip/_vendor/pygments/styles/__pycache__,, -pip/_vendor/pyproject_hooks/_in_process/__init__.cpython-314.pyc,, -pip/_vendor/idna/uts46data.cpython-314.pyc,, -pip/_vendor/resolvelib/resolvers/abstract.cpython-314.pyc,, -pip/_vendor/requests/adapters.cpython-314.pyc,, -pip/_internal/locations/_distutils.cpython-314.pyc,, -pip/_vendor/rich/columns.cpython-314.pyc,, -pip/_internal/network/session.cpython-314.pyc,, -pip/_vendor/tomli_w/_writer.cpython-314.pyc,, -pip/_internal/commands/list.cpython-314.pyc,, -pip/_vendor/rich/default_styles.cpython-314.pyc,, -pip/_vendor/requests/compat.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/cachecontrol/__pycache__,, -pip/_vendor/idna/idnadata.cpython-314.pyc,, -pip/_vendor/distlib/util.cpython-314.pyc,, -pip/_vendor/resolvelib/providers.cpython-314.pyc,, -pip/_vendor/tomli_w/__init__.cpython-314.pyc,, -../../../bin/pip,, -pip/_vendor/urllib3/packages/__pycache__,, -pip/_vendor/certifi/__main__.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/rich/__pycache__,, -pip/_vendor/urllib3/util/queue.cpython-314.pyc,, -pip/_vendor/requests/certs.cpython-314.pyc,, -pip/_internal/req/req_install.cpython-314.pyc,, -pip/_internal/index/__pycache__,, -pip/_internal/commands/hash.cpython-314.pyc,, -pip/_vendor/dependency_groups/_implementation.cpython-314.pyc,, -pip/_vendor/rich/_timer.cpython-314.pyc,, -pip/_vendor/urllib3/util/ssl_.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/_securetransport/bindings.cpython-314.pyc,, -pip/_vendor/dependency_groups/_pip_wrapper.cpython-314.pyc,, -pip/_internal/metadata/importlib/_dists.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli_w/__pycache__,, -pip/_internal/network/download.cpython-314.pyc,, -pip/_vendor/rich/syntax.cpython-314.pyc,, -pip/_vendor/packaging/metadata.cpython-314.pyc,, -pip/_vendor/packaging/licenses/__pycache__,, -pip/_internal/models/search_scope.cpython-314.pyc,, -pip/_vendor/rich/progress_bar.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/__pycache__,, -pip/_vendor/msgpack/ext.cpython-314.pyc,, -pip/_internal/req/req_uninstall.cpython-314.pyc,, -pip/_vendor/resolvelib/resolvers/criterion.cpython-314.pyc,, -pip/_vendor/pygments/scanner.cpython-314.pyc,, -pip/_vendor/rich/styled.cpython-314.pyc,, -pip/_internal/operations/freeze.cpython-314.pyc,, -pip/_vendor/platformdirs/__init__.cpython-314.pyc,, -pip/_internal/utils/deprecation.cpython-314.pyc,, -pip/_internal/resolution/legacy/__init__.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/distlib/__pycache__,, -pip/_vendor/rich/repr.cpython-314.pyc,, -pip/_vendor/rich/pager.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/appengine.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/urllib3/__pycache__,, -pip/_vendor/rich/_win32_console.cpython-314.pyc,, -pip/_vendor/pygments/sphinxext.cpython-314.pyc,, -pip/_internal/locations/__pycache__,, -pip/_vendor/pyproject_hooks/_in_process/_in_process.cpython-314.pyc,, -pip/_internal/utils/direct_url_helpers.cpython-314.pyc,, -pip/_vendor/urllib3/_collections.cpython-314.pyc,, -pip/_vendor/rich/theme.cpython-314.pyc,, -pip/_internal/cli/main.cpython-314.pyc,, -pip/_vendor/rich/abc.cpython-314.pyc,, -pip/_internal/utils/datetime.cpython-314.pyc,, -pip/_vendor/rich/_ratio.cpython-314.pyc,, -pip/_internal/cli/parser.cpython-314.pyc,, -pip/_internal/main.cpython-314.pyc,, -pip/_vendor/urllib3/util/__init__.cpython-314.pyc,, -pip/_vendor/pygments/plugin.cpython-314.pyc,, -pip/_vendor/rich/padding.cpython-314.pyc,, -pip/_vendor/certifi/__pycache__,, -pip/_vendor/rich/_stack.cpython-314.pyc,, -pip/_vendor/packaging/requirements.cpython-314.pyc,, -pip/_internal/operations/build/__pycache__,, -pip/_internal/req/constructors.cpython-314.pyc,, -pip/_vendor/urllib3/connection.cpython-314.pyc,, -pip/_internal/resolution/base.cpython-314.pyc,, -pip/_vendor/requests/hooks.cpython-314.pyc,, -pip/_vendor/truststore/_openssl.cpython-314.pyc,, -pip/_vendor/urllib3/packages/__init__.cpython-314.pyc,, -pip/_vendor/cachecontrol/_cmd.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/resolvelib/__pycache__,, -pip/_vendor/pygments/formatter.cpython-314.pyc,, -pip/_internal/resolution/resolvelib/found_candidates.cpython-314.pyc,, -pip/_vendor/urllib3/connectionpool.cpython-314.pyc,, -pip/_vendor/requests/__version__.cpython-314.pyc,, -pip/_internal/index/package_finder.cpython-314.pyc,, -pip/_vendor/urllib3/util/url.cpython-314.pyc,, -pip/_vendor/distro/__pycache__,, -pip/_internal/cli/command_context.cpython-314.pyc,, -pip/_vendor/truststore/_windows.cpython-314.pyc,, -pip/_vendor/rich/palette.cpython-314.pyc,, -pip/_internal/utils/unpacking.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/_securetransport/__init__.cpython-314.pyc,, -pip/_vendor/tomli/_re.cpython-314.pyc,, -pip/_vendor/rich/scope.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/pygments/__pycache__,, -pip/_vendor/urllib3/util/__pycache__,, -pip/_vendor/requests/status_codes.cpython-314.pyc,, -pip/_vendor/pygments/lexers/_mapping.cpython-314.pyc,, -pip/_internal/models/link.cpython-314.pyc,, -pip/_internal/resolution/resolvelib/provider.cpython-314.pyc,, -pip/_vendor/pkg_resources/__pycache__,, -pip/_vendor/rich/containers.cpython-314.pyc,, -pip/_internal/self_outdated_check.cpython-314.pyc,, -pip/_vendor/platformdirs/android.cpython-314.pyc,, -pip/_vendor/urllib3/packages/backports/makefile.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/__pycache__,, -pip/_vendor/rich/screen.cpython-314.pyc,, -pip/_vendor/cachecontrol/controller.cpython-314.pyc,, -pip/_vendor/idna/intranges.cpython-314.pyc,, -pip-26.0.1.dist-info/INSTALLER,, -pip/_internal/utils/glibc.cpython-314.pyc,, -pip/_internal/exceptions.cpython-314.pyc,, -pip/_vendor/truststore/_macos.cpython-314.pyc,, -pip/_internal/resolution/resolvelib/reporter.cpython-314.pyc,, -pip/_vendor/pyproject_hooks/_impl.cpython-314.pyc,, -pip/_internal/operations/__init__.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/dependency_groups/__pycache__,, -pip/_internal/resolution/resolvelib/candidates.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/pyopenssl.cpython-314.pyc,, -pip/_vendor/pygments/lexer.cpython-314.pyc,, -pip/_internal/commands/configuration.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/truststore/__pycache__,, -pip/_vendor/rich/segment.cpython-314.pyc,, -pip/_vendor/rich/constrain.cpython-314.pyc,, -pip/_vendor/packaging/version.cpython-314.pyc,, -pip/_vendor/rich/control.cpython-314.pyc,, -pip/_vendor/rich/_extension.cpython-314.pyc,, -pip/_internal/resolution/__pycache__,, -pip/_vendor/tomli_w/__pycache__,, -pip/_vendor/urllib3/contrib/_securetransport/low_level.cpython-314.pyc,, -pip/_internal/cli/__pycache__,, -pip/_internal/resolution/resolvelib/__init__.cpython-314.pyc,, -pip/_vendor/resolvelib/__pycache__,, -pip/_vendor/dependency_groups/__pycache__,, -pip/_internal/cli/autocompletion.cpython-314.pyc,, -pip/_vendor/rich/json.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/securetransport.cpython-314.pyc,, -pip/_vendor/requests/__pycache__,, -pip/_vendor/urllib3/packages/backports/weakref_finalize.cpython-314.pyc,, -pip/_vendor/pygments/filter.cpython-314.pyc,, -pip/_internal/network/utils.cpython-314.pyc,, -pip/_internal/distributions/sdist.cpython-314.pyc,, -pip/_vendor/cachecontrol/serialize.cpython-314.pyc,, -pip/_vendor/dependency_groups/_toml_compat.cpython-314.pyc,, -pip/_vendor/packaging/licenses/__init__.cpython-314.pyc,, -pip/_internal/cli/progress_bars.cpython-314.pyc,, -pip/_internal/commands/lock.cpython-314.pyc,, -pip/_internal/utils/__pycache__,, -pip/_internal/commands/download.cpython-314.pyc,, -pip/_vendor/certifi/core.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/requests/__pycache__,, -pip/_vendor/urllib3/request.cpython-314.pyc,, -pip/_vendor/rich/progress.cpython-314.pyc,, -pip/_vendor/rich/_pick.cpython-314.pyc,, -pip/_internal/operations/install/__init__.cpython-314.pyc,, -pip/_vendor/requests/sessions.cpython-314.pyc,, -pip/_vendor/requests/api.cpython-314.pyc,, -pip/_vendor/resolvelib/resolvers/__pycache__,, -pip/_vendor/rich/diagnose.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/pyproject_hooks/__pycache__,, -pip/_internal/commands/show.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/socks.cpython-314.pyc,, -pip/_internal/utils/subprocess.cpython-314.pyc,, -pip/_internal/commands/uninstall.cpython-314.pyc,, -pip/_internal/__init__.cpython-314.pyc,, -pip/_vendor/dependency_groups/__init__.cpython-314.pyc,, -pip/_internal/operations/install/wheel.cpython-314.pyc,, -../../../bin/pip3,, -pip/_vendor/urllib3/util/ssl_match_hostname.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/_appengine_environ.cpython-314.pyc,, -pip/_vendor/rich/live_render.cpython-314.pyc,, -pip/_vendor/urllib3/util/connection.cpython-314.pyc,, -pip/_internal/utils/misc.cpython-314.pyc,, -pip/_internal/operations/__pycache__,, -pip/_vendor/truststore/_api.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/certifi/__pycache__,, -pip/_internal/operations/build/metadata_editable.cpython-314.pyc,, -pip/_internal/metadata/base.cpython-314.pyc,, -pip/_vendor/cachecontrol/wrapper.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/__init__.cpython-314.pyc,, -pip/_vendor/requests/help.cpython-314.pyc,, -pip/_vendor/rich/color_triplet.cpython-314.pyc,, -pip/_vendor/packaging/tags.cpython-314.pyc,, -pip/_vendor/packaging/pylock.cpython-314.pyc,, -pip/_vendor/rich/pretty.cpython-314.pyc,, -pip/_internal/commands/__init__.cpython-314.pyc,, -pip/_vendor/urllib3/util/response.cpython-314.pyc,, -pip/_vendor/pygments/styles/_mapping.cpython-314.pyc,, -pip/_internal/req/req_dependency_group.cpython-314.pyc,, -pip/_vendor/pygments/console.cpython-314.pyc,, -pip/_vendor/msgpack/exceptions.cpython-314.pyc,, -pip/_vendor/pyproject_hooks/_in_process/__pycache__,, -pip/_vendor/msgpack/__pycache__,, -pip/_vendor/pygments/formatters/_mapping.cpython-314.pyc,, -pip/_vendor/idna/core.cpython-314.pyc,, -pip/_vendor/rich/color.cpython-314.pyc,, -pip/_vendor/urllib3/contrib/_securetransport/__pycache__,, -pip/_vendor/distlib/__init__.cpython-314.pyc,, -pip/_vendor/truststore/__init__.cpython-314.pyc,, -pip/_internal/utils/_jaraco_text.cpython-314.pyc,, -pip/_vendor/rich/__init__.cpython-314.pyc,, -pip/_internal/metadata/__pycache__,, -pip/_vendor/pygments/lexers/__pycache__,, -pip/_internal/index/sources.cpython-314.pyc,, -pip/_vendor/rich/_inspect.cpython-314.pyc,, -pip/_vendor/rich/style.cpython-314.pyc,, -pip/_vendor/tomli/__init__.cpython-314.pyc,, -pip/_vendor/pygments/lexers/python.cpython-314.pyc,, -pip/_internal/configuration.cpython-314.pyc,, -pip/_vendor/platformdirs/macos.cpython-314.pyc,, -pip/_vendor/rich/text.cpython-314.pyc,, -pip/_internal/commands/check.cpython-314.pyc,, -pip/_internal/metadata/pkg_resources.cpython-314.pyc,, -pip/_internal/operations/prepare.cpython-314.pyc,, -pip/_vendor/packaging/utils.cpython-314.pyc,, -pip/_vendor/platformdirs/__pycache__,, -pip/_internal/locations/__init__.cpython-314.pyc,, -pip/_internal/utils/filetypes.cpython-314.pyc,, -pip/_vendor/cachecontrol/__pycache__,, -pip/_internal/vcs/mercurial.cpython-314.pyc,, -pip/_vendor/distlib/scripts.cpython-314.pyc,, -pip/_vendor/requests/packages.cpython-314.pyc,, -../../../bin/pip3.14,, -pip/_internal/operations/build/wheel_editable.cpython-314.pyc,, -pip/_internal/models/__pycache__,, -pip/_internal/pyproject.cpython-314.pyc,, -pip/_internal/utils/_log.cpython-314.pyc,, -pip/_vendor/resolvelib/__init__.cpython-314.pyc,, -pip/_vendor/__init__.cpython-314.pyc,, -pip/_vendor/rich/status.cpython-314.pyc,, -pip/_internal/models/direct_url.cpython-314.pyc,, -pip/_internal/metadata/__init__.cpython-314.pyc,, -pip/_vendor/resolvelib/resolvers/exceptions.cpython-314.pyc,, -pip/_vendor/platformdirs/windows.cpython-314.pyc,, -pip/_vendor/rich/protocol.cpython-314.pyc,, -pip/_vendor/rich/highlighter.cpython-314.pyc,, -pip/_internal/metadata/_json.cpython-314.pyc,, -pip/_internal/utils/hashes.cpython-314.pyc,, -pip/_vendor/msgpack/fallback.cpython-314.pyc,, -pip/_vendor/rich/cells.cpython-314.pyc,, -pip/_internal/operations/check.cpython-314.pyc,, -pip/_vendor/pygments/unistring.cpython-314.pyc,, -pip/_internal/commands/index.cpython-314.pyc,, -pip/_vendor/pyproject_hooks/__pycache__,, -pip/_vendor/certifi/__init__.cpython-314.pyc,, -pip/_internal/models/wheel.cpython-314.pyc,, -pip/_vendor/dependency_groups/__main__.cpython-314.pyc,, -pip/_internal/utils/compatibility_tags.cpython-314.pyc,, -pip/_vendor/rich/_windows.cpython-314.pyc,, -pip/_vendor/urllib3/packages/six.cpython-314.pyc,, -pip/_vendor/rich/bar.cpython-314.pyc,, -pip/_vendor/requests/exceptions.cpython-314.pyc,, -pip/_vendor/resolvelib/structs.cpython-314.pyc,, -pip/_vendor/rich/ansi.cpython-314.pyc,, -pip/_vendor/rich/__pycache__,, -pip-26.0.1.dist-info/__pycache__,, -pip/_internal/commands/wheel.cpython-314.pyc,, -pip/_internal/operations/install/__pycache__,, -pip/_vendor/idna/codec.cpython-314.pyc,, -pip/__pycache__,, -pip/_internal/commands/cache.cpython-314.pyc,, -pip/_vendor/tomli/_types.cpython-314.pyc,, -pip/_vendor/urllib3/response.cpython-314.pyc,, -../../../bin/pip-3.14,, -pip/_vendor/rich/_fileno.cpython-314.pyc,, -pip/_vendor/cachecontrol/caches/__pycache__,, -pip/_vendor/rich/markup.cpython-314.pyc,, -pip/_vendor/packaging/_parser.cpython-314.pyc,, -pip/_vendor/distro/__main__.cpython-314.pyc,, -pip/_vendor/requests/utils.cpython-314.pyc,, -pip/_vendor/urllib3/packages/backports/__init__.cpython-314.pyc,, -pip/_internal/network/lazy_wheel.cpython-314.pyc,, -pip/_vendor/urllib3/util/proxy.cpython-314.pyc,, -pip/_vendor/requests/__init__.cpython-314.pyc,, -pip/_vendor/cachecontrol/caches/redis_cache.cpython-314.pyc,, -pip/_internal/commands/__pycache__,, -pip/_internal/locations/base.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/idna/__pycache__,, -pip/_vendor/requests/_internal_utils.cpython-314.pyc,, -pip/_internal/resolution/__init__.cpython-314.pyc,, -pip/_internal/commands/search.cpython-314.pyc,, -pip/_vendor/urllib3/exceptions.cpython-314.pyc,, -pip/_internal/models/index.cpython-314.pyc,, -pip/_internal/resolution/resolvelib/base.cpython-314.pyc,, -pip/_internal/utils/temp_dir.cpython-314.pyc,, -pip/_vendor/rich/live.cpython-314.pyc,, -pip/_vendor/packaging/specifiers.cpython-314.pyc,, -pip/_vendor/rich/console.cpython-314.pyc,, -pip/_vendor/platformdirs/version.cpython-314.pyc,, -pip/_internal/metadata/importlib/_envs.cpython-314.pyc,, -pip/_internal/req/__init__.cpython-314.pyc,, -pip/_internal/vcs/bazaar.cpython-314.pyc,, -pip/_vendor/urllib3/util/retry.cpython-314.pyc,, -pip/_internal/metadata/importlib/_compat.cpython-314.pyc,, -pip/_vendor/pygments/lexers/__init__.cpython-314.pyc,, -pip/_internal/req/req_set.cpython-314.pyc,, -pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/__pycache__,, -pip/_internal/commands/help.cpython-314.pyc,, -pip/_vendor/urllib3/filepost.cpython-314.pyc,, -pip/_vendor/requests/structures.cpython-314.pyc,, -pip/_vendor/rich/spinner.cpython-314.pyc,, -pip/_internal/models/release_control.cpython-314.pyc,, -pip/_internal/distributions/__pycache__,, -pip/_vendor/rich/traceback.cpython-314.pyc,, -pip/_internal/operations/build/__init__.cpython-314.pyc,, -pip/_internal/utils/pylock.cpython-314.pyc,, \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/WHEEL b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/WHEEL deleted file mode 100644 index d8b9936..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/WHEEL +++ /dev/null @@ -1,4 +0,0 @@ -Wheel-Version: 1.0 -Generator: flit 3.12.0 -Root-Is-Purelib: true -Tag: py3-none-any diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/entry_points.txt b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/entry_points.txt deleted file mode 100644 index c6436d2..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/entry_points.txt +++ /dev/null @@ -1,4 +0,0 @@ -[console_scripts] -pip=pip._internal.cli.main:main -pip3=pip._internal.cli.main:main - diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/AUTHORS.txt b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/AUTHORS.txt deleted file mode 100644 index 73b4dc8..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/AUTHORS.txt +++ /dev/null @@ -1,860 +0,0 @@ -@Switch01 -A_Rog -Aakanksha Agrawal -Aarni Koskela -Abhinav Sagar -ABHYUDAY PRATAP SINGH -abs51295 -AceGentile -Adam Chainz -Adam Tse -Adam Turner -Adam Wentz -admin -Adolfo Ochagavía -Adrien Morison -Agus -ahayrapetyan -Ahilya -AinsworthK -Akash Srivastava -Alan Yee -Albert Tugushev -Albert-Guan -albertg -Alberto Sottile -Aleks Bunin -Ales Erjavec -Alessandro Molina -Alethea Flowers -Alex Gaynor -Alex Grönholm -Alex Hedges -Alex Loosley -Alex Morega -Alex Stachowiak -Alexander Regueiro -Alexander Shtyrov -Alexandre Conrad -Alexey Popravka -Aleš Erjavec -Alli -Aman -Ami Fischman -Ananya Maiti -Anatoly Techtonik -Anders Kaseorg -Andre Aguiar -Andreas Lutro -Andrei Geacar -Andrew Gaul -Andrew Shymanel -Andrey Bienkowski -Andrey Bulgakov -Andrés Delfino -Andy Freeland -Andy Kluger -Ani Hayrapetyan -Aniruddha Basak -Anish Tambe -Anrs Hu -Anthony Sottile -Antoine Lambert -Antoine Musso -Anton Ovchinnikov -Anton Patrushev -Anton Zelenov -Antonio Alvarado Hernandez -Antony Lee -Antti Kaihola -Anubhav Patel -Anudit Nagar -Anuj Godase -AQNOUCH Mohammed -AraHaan -arena -arenasys -Arindam Choudhury -Armin Ronacher -Arnon Yaari -Artem -Arun Babu Neelicattu -Ashley Manton -Ashwin Ramaswami -atse -Atsushi Odagiri -Avinash Karhana -Avner Cohen -Awit (Ah-Wit) Ghirmai -Baptiste Mispelon -Barney Gale -barneygale -Bartek Ogryczak -Bastian Venthur -Ben Bodenmiller -Ben Darnell -Ben Hoyt -Ben Mares -Ben Rosser -Bence Nagy -Benjamin Peterson -Benjamin VanEvery -Benoit Pierre -Berker Peksag -Bernard -Bernard Tyers -Bernardo B. Marques -Bernhard M. Wiedemann -Bertil Hatt -Bhavam Vidyarthi -Blazej Michalik -Bogdan Opanchuk -BorisZZZ -Brad Erickson -Bradley Ayers -Bradley Reynolds -Branch Vincent -Brandon L. Reiss -Brandt Bucher -Brannon Dorsey -Brett Randall -Brett Rosen -Brian Cristante -Brian Rosner -briantracy -BrownTruck -Bruno Oliveira -Bruno Renié -Bruno S -Bstrdsmkr -Buck Golemon -burrows -Bussonnier Matthias -bwoodsend -c22 -Caleb Brown -Caleb Martinez -Calvin Smith -Carl Meyer -Carlos Liam -Carol Willing -Carter Thayer -Cass -Chandrasekhar Atina -Charlie Marsh -charwick -Chih-Hsuan Yen -Chris Brinker -Chris Hunt -Chris Jerdonek -Chris Kuehl -Chris Markiewicz -Chris McDonough -Chris Pawley -Chris Pryer -Chris Wolfe -Christian Clauss -Christian Heimes -Christian Oudard -Christoph Reiter -Christopher Hunt -Christopher Snyder -chrysle -cjc7373 -Clark Boylan -Claudio Jolowicz -Clay McClure -Cody -Cody Soyland -Colin Watson -Collin Anderson -Connor Osborn -Cooper Lees -Cooper Ry Lees -Cory Benfield -Cory Wright -Craig Kerstiens -Cristian Sorinel -Cristina -Cristina Muñoz -ctg123 -Curtis Doty -cytolentino -Daan De Meyer -Dale -Damian -Damian Quiroga -Damian Shaw -Dan Black -Dan Savilonis -Dan Sully -Dane Hillard -daniel -Daniel Collins -Daniel Hahler -Daniel Hollas -Daniel Holth -Daniel Jost -Daniel Katz -Daniel Shaulov -Daniele Esposti -Daniele Nicolodi -Daniele Procida -Daniil Konovalenko -Danny Hermes -Danny McClanahan -Darren Kavanagh -Dav Clark -Dave Abrahams -Dave Jones -David Aguilar -David Black -David Bordeynik -David Caro -David D Lowe -David Evans -David Hewitt -David Linke -David Poggi -David Poznik -David Pursehouse -David Runge -David Tucker -David Wales -Davidovich -ddelange -Deepak Sharma -Deepyaman Datta -Denis Roussel (ACSONE) -Denise Yu -dependabot[bot] -derwolfe -Desetude -developer -Devesh Kumar -Devesh Kumar Singh -devsagul -Diego Caraballo -Diego Ramirez -DiegoCaraballo -Dimitri Merejkowsky -Dimitri Papadopoulos -Dimitri Papadopoulos Orfanos -Dirk Stolle -dkjsone -Dmitry Gladkov -Dmitry Volodin -Domen Kožar -Dominic Davis-Foster -Donald Stufft -Dongweiming -doron zarhi -Dos Moonen -Douglas Thor -DrFeathers -Dustin Ingram -Dustin Rodrigues -Dwayne Bailey -Ed Morley -Edgar Ramírez -Edgar Ramírez Mondragón -Ee Durbin -Efflam Lemaillet -efflamlemaillet -Eitan Adler -ekristina -elainechan -Eli Schwartz -Elisha Hollander -Ellen Marie Dash -Emil Burzo -Emil Styrke -Emmanuel Arias -Endoh Takanao -enoch -Erdinc Mutlu -Eric Cousineau -Eric Gillingham -Eric Hanchrow -Eric Hopper -Erik M. Bray -Erik Rose -Erwin Janssen -Eugene Vereshchagin -everdimension -Federico -Felipe Peter -Felix Yan -fiber-space -Filip Kokosiński -Filipe Laíns -Finn Womack -finnagin -Flavio Amurrio -Florian Briand -Florian Rathgeber -Francesco -Francesco Montesano -Fredrik Orderud -Fredrik Roubert -Frost Ming -Gabriel Curio -Gabriel de Perthuis -Garry Polley -gavin -gdanielson -Gene Wood -Geoffrey Sneddon -George Margaritis -George Song -Georgi Valkov -Georgy Pchelkin -ghost -Giftlin Rajaiah -gizmoguy1 -gkdoc -Godefroid Chapelle -Gopinath M -GOTO Hayato -gousaiyang -gpiks -Greg Roodt -Greg Ward -Guido Diepen -Guilherme Espada -Guillaume Seguin -gutsytechster -Guy Rozendorn -Guy Tuval -gzpan123 -Hanjun Kim -Hari Charan -Harsh Vardhan -Harsha Sai -harupy -Harutaka Kawamura -Hasan-8326 -hauntsaninja -Henrich Hartzer -Henry Schreiner -Herbert Pfennig -Holly Stotelmyer -Honnix -Hsiaoming Yang -Hugo Lopes Tavares -Hugo van Kemenade -Hugues Bruant -Hynek Schlawack -iamsrp-deshaw -Ian Bicking -Ian Cordasco -Ian Lee -Ian Stapleton Cordasco -Ian Wienand -Igor Kuzmitshov -Igor Sobreira -Ikko Ashimine -Ilan Schnell -Illia Volochii -Ilya Abdolmanafi -Ilya Baryshev -Inada Naoki -Ionel Cristian Mărieș -Ionel Maries Cristian -Itamar Turner-Trauring -iTrooz -Ivan Pozdeev -J. Nick Koston -Jacob Kim -Jacob Walls -Jaime Sanz -Jake Lishman -jakirkham -Jakub Kuczys -Jakub Stasiak -Jakub Vysoky -Jakub Wilk -James -James Cleveland -James Curtin -James Firth -James Gerity -James Polley -Jan Pokorný -Jannis Leidel -Jarek Potiuk -jarondl -Jason Curtis -Jason R. Coombs -JasonMo -JasonMo1 -Jay Graves -Jean Abou Samra -Jean-Christophe Fillion-Robin -Jeff Barber -Jeff Dairiki -Jeff Widman -Jelmer Vernooij -jenix21 -Jeremy Fleischman -Jeremy Stanley -Jeremy Zafran -Jesse Rittner -Jiashuo Li -Jim Fisher -Jim Garrison -Jinzhe Zeng -Jiun Bae -Jivan Amara -Joa -Joe Bylund -Joe Michelini -Johannes Altmanninger -John Paton -John Sirois -John T. Wodder II -John-Scott Atlakson -johnthagen -Jon Banafato -Jon Dufresne -Jon Parise -Jonas Nockert -Jonathan Herbert -Joonatan Partanen -Joost Molenaar -Jorge Niedbalski -Joseph Bylund -Joseph Long -Josh Bronson -Josh Cannon -Josh Hansen -Josh Schneier -Joshua -JoshuaPerdue -Jost Migenda -Juan Luis Cano Rodríguez -Juanjo Bazán -Judah Rand -Julian Berman -Julian Gethmann -Julien Demoor -Julien Stephan -July Tikhonov -Jussi Kukkonen -Justin van Heek -jwg4 -Jyrki Pulliainen -Kai Chen -Kai Mueller -Kamal Bin Mustafa -Karolina Surma -kasium -kaustav haldar -Kaz Nishimura -keanemind -Keith Maxwell -Kelsey Hightower -Kenneth Belitzky -Kenneth Reitz -Kevin Burke -Kevin Carter -Kevin Frommelt -Kevin R Patterson -Kexuan Sun -Kit Randel -Klaas van Schelven -KOLANICH -konstin -kpinc -Krishan Bhasin -Krishna Oza -Kumar McMillan -Kuntal Majumder -Kurt McKee -Kyle Persohn -lakshmanaram -Laszlo Kiss-Kollar -Laurent Bristiel -Laurent LAPORTE -Laurie O -Laurie Opperman -layday -Leon Sasson -Lev Givon -Lincoln de Sousa -Lipis -lorddavidiii -Loren Carvalho -Lucas Cimon -Ludovic Gasc -Luis Medel -Lukas Geiger -Lukas Juhrich -Luke Macken -Luo Jiebin -luojiebin -luz.paz -László Kiss Kollár -M00nL1ght -MajorTanya -Malcolm Smith -Marc Abramowitz -Marc Tamlyn -Marcus Smith -Mariatta -Mark Kohler -Mark McLoughlin -Mark Williams -Markus Hametner -Martey Dodoo -Martin Fischer -Martin Häcker -Martin Pavlasek -Masaki -Masklinn -Matej Stuchlik -Mateusz Sokół -Mathew Jennings -Mathieu Bridon -Mathieu Kniewallner -Matt Bacchi -Matt Good -Matt Maker -Matt Robenolt -Matt Wozniski -matthew -Matthew Einhorn -Matthew Feickert -Matthew Gilliard -Matthew Hughes -Matthew Iversen -Matthew Treinish -Matthew Trumbell -Matthew Willson -Matthias Bussonnier -mattip -Maurits van Rees -Max W Chase -Maxim Kurnikov -Maxime Rouyrre -mayeut -mbaluna -Md Sujauddin Sekh -mdebi -Meet Vasita -memoselyk -meowmeowcat -Michael -Michael Aquilina -Michael E. Karpeles -Michael Klich -Michael Mintz -Michael Williamson -michaelpacer -Michał Górny -Mickaël Schoentgen -Miguel Araujo Perez -Mihir Singh -Mike -Mike Hendricks -Min RK -MinRK -Miro Hrončok -Monica Baluna -montefra -Monty Taylor -morotti -mrKazzila -Muha Ajjan -MUTHUSRIHEMADHARSHINI S A -Nadav Wexler -Nahuel Ambrosini -Nate Coraor -Nate Prewitt -Nathan Houghton -Nathaniel J. Smith -Nehal J Wani -Neil Botelho -Nguyễn Gia Phong -Nicholas Serra -Nick Coghlan -Nick Stenning -Nick Timkovich -Nicolas Bock -Nicole Harris -Nikhil Benesch -Nikhil Ladha -Nikita Chepanov -Nikolay Korolev -Nipunn Koorapati -Nitesh Sharma -Niyas Sait -Noah -Noah Gorny -Nothing-991 -Nowell Strite -NtaleGrey -nucccc -nvdv -OBITORASU -Ofek Lev -ofrinevo -Oleg Burnaev -Oliver Freund -Oliver Jeeves -Oliver Mannion -Oliver Tonnhofer -Olivier Girardot -Olivier Grisel -Ollie Rutherfurd -OMOTO Kenji -Omry Yadan -onlinejudge95 -Oren Held -Oscar Benjamin -oxygen dioxide -Oz N Tiram -Pachwenko -Paresh Joshi -Patrick Dubroy -Patrick Jenkins -Patrick Lawson -patricktokeeffe -Patrik Kopkan -Paul Ganssle -Paul Kehrer -Paul Moore -Paul Nasrat -Paul Oswald -Paul van der Linden -Paulus Schoutsen -Pavel Safronov -Pavithra Eswaramoorthy -Pawel Jasinski -Paweł Szramowski -Pekka Klärck -Peter Gessler -Peter Lisák -Peter Shen -Peter Waller -Petr Viktorin -petr-tik -Phaneendra Chiruvella -Phil Elson -Phil Freo -Phil Pennock -Phil Whelan -Philip Jägenstedt -Philip Molloy -Philippe Ombredanne -Pi Delport -Pierre-Yves Rofes -Pieter Degroote -pip -Prabakaran Kumaresshan -Prabhjyotsing Surjit Singh Sodhi -Prabhu Marappan -Pradyun Gedam -Prashant Sharma -Pratik Mallya -pre-commit-ci[bot] -Preet Thakkar -Preston Holmes -Przemek Wrzos -Pulkit Goyal -q0w -Qiangning Hong -Qiming Xu -qraqras -Quentin Lee -Quentin Pradet -R. David Murray -Rafael Caricio -Ralf Schmitt -Ran Benita -Randy Döring -Razzi Abuissa -rdb -Reece Dunham -Remi Rampin -Rene Dudfield -Riccardo Magliocchetti -Riccardo Schirone -Richard Jones -Richard Si -Ricky Ng-Adam -Rishi -rmorotti -RobberPhex -Robert Collins -Robert McGibbon -Robert Pollak -Robert T. McGibbon -robin elisha robinson -Rodney, Tiara -Roey Berman -Rohan Jain -Roman Bogorodskiy -Roman Donchenko -Romuald Brunet -ronaudinho -Ronny Pfannschmidt -Rory McCann -Ross Brattain -Roy Wellington Ⅳ -Ruairidh MacLeod -Russell Keith-Magee -Ryan Shepherd -Ryan Wooden -ryneeverett -Ryuma Asai -S. Guliaev -Sachi King -Salvatore Rinchiera -sandeepkiran-js -Sander Van Balen -Savio Jomton -schlamar -Scott Kitterman -Sean -seanj -Sebastian Jordan -Sebastian Schaetz -Segev Finer -SeongSoo Cho -Sepehr Rasouli -sepehrrasooli -Sergey Vasilyev -Seth Michael Larson -Seth Woodworth -Shahar Epstein -Shantanu -shenxianpeng -shireenrao -Shivansh-007 -Shixian Sheng -Shlomi Fish -Shovan Maity -Shubham Nagure -Simeon Visser -Simon Cross -Simon Pichugin -sinoroc -sinscary -snook92 -socketubs -Sorin Sbarnea -Srinivas Nyayapati -Srishti Hegde -Stavros Korokithakis -Stefan Scherfke -Stefano Rivera -Stephan Erb -Stephane Chazelas -Stephen Payne -Stephen Rosen -stepshal -Steve (Gadget) Barnes -Steve Barnes -Steve Dower -Steve Kowalik -Steven Myint -Steven Silvester -stonebig -studioj -Stéphane Bidoul -Stéphane Bidoul (ACSONE) -Stéphane Klein -Sumana Harihareswara -Surbhi Sharma -Sviatoslav Sydorenko -Sviatoslav Sydorenko (Святослав Сидоренко) -Swat009 -Sylvain -Takayuki SHIMIZUKAWA -Taneli Hukkinen -tbeswick -Terrance -Thiago -Thijs Triemstra -Thomas Fenzl -Thomas Grainger -Thomas Guettler -Thomas Johansson -Thomas Kluyver -Thomas Smith -Thomas VINCENT -Tim D. Smith -Tim Gates -Tim Harder -Tim Heap -tim smith -tinruufu -Tobias Hermann -Tom Forbes -Tom Freudenheim -Tom V -Tomas Hrnciar -Tomas Orsava -Tomer Chachamu -Tommi Enenkel | AnB -Tomáš Hrnčiar -Tony Beswick -Tony Narlock -Tony Zhaocheng Tan -TonyBeswick -toonarmycaptain -Toshio Kuratomi -toxinu -Travis Swicegood -Tushar Sadhwani -Tzu-ping Chung -Valentin Haenel -Victor Stinner -victorvpaulo -Vikram - Google -Viktor Szépe -Ville Skyttä -Vinay Sajip -Vincent Philippon -Vinicyus Macedo -Vipul Kumar -Vitaly Babiy -Vladimir Fokow -Vladimir Rutsky -W. Trevor King -Weida Hong -Wil Tan -Wilfred Hughes -William Edwards -William ML Leslie -William T Olson -William Woodruff -Wilson Mo -wim glenn -Winson Luk -Wolfgang Maier -Wu Zhenyu -XAMES3 -Xavier Fernandez -Xianpeng Shen -xoviat -xtreak -YAMAMOTO Takashi -Yash -Yashraj -Yen Chi Hsuan -Yeray Diaz Diaz -Yoval P -Yu Jian -Yuan Jing Vincent Yan -Yuki Kobayashi -Yusuke Hayashi -zackzack38 -Zearin -Zhiping Deng -ziebam -Zvezdan Petkovic -Łukasz Langa -Роман Донченко -Семён Марьясин diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/LICENSE.txt b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/LICENSE.txt deleted file mode 100644 index 8e7b65e..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/LICENSE.txt +++ /dev/null @@ -1,20 +0,0 @@ -Copyright (c) 2008-present The pip developers (see AUTHORS.txt file) - -Permission is hereby granted, free of charge, to any person obtaining -a copy of this software and associated documentation files (the -"Software"), to deal in the Software without restriction, including -without limitation the rights to use, copy, modify, merge, publish, -distribute, sublicense, and/or sell copies of the Software, and to -permit persons to whom the Software is furnished to do so, subject to -the following conditions: - -The above copyright notice and this permission notice shall be -included in all copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND -NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE -LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION -OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION -WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/cachecontrol/LICENSE.txt b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/cachecontrol/LICENSE.txt deleted file mode 100644 index d8b3b56..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/cachecontrol/LICENSE.txt +++ /dev/null @@ -1,13 +0,0 @@ -Copyright 2012-2021 Eric Larson - -Licensed under the Apache License, Version 2.0 (the "License"); -you may not use this file except in compliance with the License. -You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, software -distributed under the License is distributed on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -See the License for the specific language governing permissions and -limitations under the License. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/certifi/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/certifi/LICENSE deleted file mode 100644 index 62b076c..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/certifi/LICENSE +++ /dev/null @@ -1,20 +0,0 @@ -This package contains a modified version of ca-bundle.crt: - -ca-bundle.crt -- Bundle of CA Root Certificates - -This is a bundle of X.509 certificates of public Certificate Authorities -(CA). These were automatically extracted from Mozilla's root certificates -file (certdata.txt). This file can be found in the mozilla source tree: -https://hg.mozilla.org/mozilla-central/file/tip/security/nss/lib/ckfw/builtins/certdata.txt -It contains the certificates in PEM format and therefore -can be directly used with curl / libcurl / php_curl, or with -an Apache+mod_ssl webserver for SSL client authentication. -Just configure this file as the SSLCACertificateFile.# - -***** BEGIN LICENSE BLOCK ***** -This Source Code Form is subject to the terms of the Mozilla Public License, -v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain -one at http://mozilla.org/MPL/2.0/. - -***** END LICENSE BLOCK ***** -@(#) $RCSfile: certdata.txt,v $ $Revision: 1.80 $ $Date: 2011/11/03 15:11:58 $ diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/dependency_groups/LICENSE.txt b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/dependency_groups/LICENSE.txt deleted file mode 100644 index b9723b8..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/dependency_groups/LICENSE.txt +++ /dev/null @@ -1,9 +0,0 @@ -MIT License - -Copyright (c) 2024-present Stephen Rosen - -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/distlib/LICENSE.txt b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/distlib/LICENSE.txt deleted file mode 100644 index c31ac56..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/distlib/LICENSE.txt +++ /dev/null @@ -1,284 +0,0 @@ -A. HISTORY OF THE SOFTWARE -========================== - -Python was created in the early 1990s by Guido van Rossum at Stichting -Mathematisch Centrum (CWI, see http://www.cwi.nl) in the Netherlands -as a successor of a language called ABC. Guido remains Python's -principal author, although it includes many contributions from others. - -In 1995, Guido continued his work on Python at the Corporation for -National Research Initiatives (CNRI, see http://www.cnri.reston.va.us) -in Reston, Virginia where he released several versions of the -software. - -In May 2000, Guido and the Python core development team moved to -BeOpen.com to form the BeOpen PythonLabs team. In October of the same -year, the PythonLabs team moved to Digital Creations (now Zope -Corporation, see http://www.zope.com). In 2001, the Python Software -Foundation (PSF, see http://www.python.org/psf/) was formed, a -non-profit organization created specifically to own Python-related -Intellectual Property. Zope Corporation is a sponsoring member of -the PSF. - -All Python releases are Open Source (see http://www.opensource.org for -the Open Source Definition). Historically, most, but not all, Python -releases have also been GPL-compatible; the table below summarizes -the various releases. - - Release Derived Year Owner GPL- - from compatible? (1) - - 0.9.0 thru 1.2 1991-1995 CWI yes - 1.3 thru 1.5.2 1.2 1995-1999 CNRI yes - 1.6 1.5.2 2000 CNRI no - 2.0 1.6 2000 BeOpen.com no - 1.6.1 1.6 2001 CNRI yes (2) - 2.1 2.0+1.6.1 2001 PSF no - 2.0.1 2.0+1.6.1 2001 PSF yes - 2.1.1 2.1+2.0.1 2001 PSF yes - 2.2 2.1.1 2001 PSF yes - 2.1.2 2.1.1 2002 PSF yes - 2.1.3 2.1.2 2002 PSF yes - 2.2.1 2.2 2002 PSF yes - 2.2.2 2.2.1 2002 PSF yes - 2.2.3 2.2.2 2003 PSF yes - 2.3 2.2.2 2002-2003 PSF yes - 2.3.1 2.3 2002-2003 PSF yes - 2.3.2 2.3.1 2002-2003 PSF yes - 2.3.3 2.3.2 2002-2003 PSF yes - 2.3.4 2.3.3 2004 PSF yes - 2.3.5 2.3.4 2005 PSF yes - 2.4 2.3 2004 PSF yes - 2.4.1 2.4 2005 PSF yes - 2.4.2 2.4.1 2005 PSF yes - 2.4.3 2.4.2 2006 PSF yes - 2.4.4 2.4.3 2006 PSF yes - 2.5 2.4 2006 PSF yes - 2.5.1 2.5 2007 PSF yes - 2.5.2 2.5.1 2008 PSF yes - 2.5.3 2.5.2 2008 PSF yes - 2.6 2.5 2008 PSF yes - 2.6.1 2.6 2008 PSF yes - 2.6.2 2.6.1 2009 PSF yes - 2.6.3 2.6.2 2009 PSF yes - 2.6.4 2.6.3 2009 PSF yes - 2.6.5 2.6.4 2010 PSF yes - 3.0 2.6 2008 PSF yes - 3.0.1 3.0 2009 PSF yes - 3.1 3.0.1 2009 PSF yes - 3.1.1 3.1 2009 PSF yes - 3.1.2 3.1 2010 PSF yes - 3.2 3.1 2010 PSF yes - -Footnotes: - -(1) GPL-compatible doesn't mean that we're distributing Python under - the GPL. All Python licenses, unlike the GPL, let you distribute - a modified version without making your changes open source. The - GPL-compatible licenses make it possible to combine Python with - other software that is released under the GPL; the others don't. - -(2) According to Richard Stallman, 1.6.1 is not GPL-compatible, - because its license has a choice of law clause. According to - CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1 - is "not incompatible" with the GPL. - -Thanks to the many outside volunteers who have worked under Guido's -direction to make these releases possible. - - -B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON -=============================================================== - -PYTHON SOFTWARE 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 -Python Software Foundation; All Rights Reserved" are retained in Python alone or -in any derivative version prepared by Licensee. - -3. In the event Licensee prepares a derivative work that is based on -or incorporates Python or any part thereof, and wants to make -the derivative work available to others as provided herein, then -Licensee hereby agrees to include in any such work a brief summary of -the changes made to Python. - -4. PSF is making Python available to Licensee on an "AS IS" -basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR -IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND -DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS -FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT -INFRINGE ANY THIRD PARTY RIGHTS. - -5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON -FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS -A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, -OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. - -6. This License Agreement will automatically terminate upon a material -breach of its terms and conditions. - -7. Nothing in this License Agreement shall be deemed to create any -relationship of agency, partnership, or joint venture between PSF and -Licensee. This License Agreement does not grant permission to use PSF -trademarks or trade name in a trademark sense to endorse or promote -products or services of Licensee, or any third party. - -8. By copying, installing or otherwise using Python, Licensee -agrees to be bound by the terms and conditions of this License -Agreement. - - -BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 -------------------------------------------- - -BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 - -1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an -office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the -Individual or Organization ("Licensee") accessing and otherwise using -this software in source or binary form and its associated -documentation ("the Software"). - -2. Subject to the terms and conditions of this BeOpen Python License -Agreement, BeOpen hereby grants Licensee a non-exclusive, -royalty-free, world-wide license to reproduce, analyze, test, perform -and/or display publicly, prepare derivative works, distribute, and -otherwise use the Software alone or in any derivative version, -provided, however, that the BeOpen Python License is retained in the -Software, alone or in any derivative version prepared by Licensee. - -3. BeOpen is making the Software available to Licensee on an "AS IS" -basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR -IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND -DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS -FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT -INFRINGE ANY THIRD PARTY RIGHTS. - -4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE -SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS -AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY -DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. - -5. This License Agreement will automatically terminate upon a material -breach of its terms and conditions. - -6. This License Agreement shall be governed by and interpreted in all -respects by the law of the State of California, excluding conflict of -law provisions. Nothing in this License Agreement shall be deemed to -create any relationship of agency, partnership, or joint venture -between BeOpen and Licensee. This License Agreement does not grant -permission to use BeOpen trademarks or trade names in a trademark -sense to endorse or promote products or services of Licensee, or any -third party. As an exception, the "BeOpen Python" logos available at -http://www.pythonlabs.com/logos.html may be used according to the -permissions granted on that web page. - -7. By copying, installing or otherwise using the software, Licensee -agrees to be bound by the terms and conditions of this License -Agreement. - - -CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 ---------------------------------------- - -1. This LICENSE AGREEMENT is between the Corporation for National -Research Initiatives, having an office at 1895 Preston White Drive, -Reston, VA 20191 ("CNRI"), and the Individual or Organization -("Licensee") accessing and otherwise using Python 1.6.1 software in -source or binary form and its associated documentation. - -2. Subject to the terms and conditions of this License Agreement, CNRI -hereby grants Licensee a nonexclusive, royalty-free, world-wide -license to reproduce, analyze, test, perform and/or display publicly, -prepare derivative works, distribute, and otherwise use Python 1.6.1 -alone or in any derivative version, provided, however, that CNRI's -License Agreement and CNRI's notice of copyright, i.e., "Copyright (c) -1995-2001 Corporation for National Research Initiatives; All Rights -Reserved" are retained in Python 1.6.1 alone or in any derivative -version prepared by Licensee. Alternately, in lieu of CNRI's License -Agreement, Licensee may substitute the following text (omitting the -quotes): "Python 1.6.1 is made available subject to the terms and -conditions in CNRI's License Agreement. This Agreement together with -Python 1.6.1 may be located on the Internet using the following -unique, persistent identifier (known as a handle): 1895.22/1013. This -Agreement may also be obtained from a proxy server on the Internet -using the following URL: http://hdl.handle.net/1895.22/1013". - -3. In the event Licensee prepares a derivative work that is based on -or incorporates Python 1.6.1 or any part thereof, and wants to make -the derivative work available to others as provided herein, then -Licensee hereby agrees to include in any such work a brief summary of -the changes made to Python 1.6.1. - -4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" -basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR -IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND -DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS -FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT -INFRINGE ANY THIRD PARTY RIGHTS. - -5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON -1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS -A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, -OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. - -6. This License Agreement will automatically terminate upon a material -breach of its terms and conditions. - -7. This License Agreement shall be governed by the federal -intellectual property law of the United States, including without -limitation the federal copyright law, and, to the extent such -U.S. federal law does not apply, by the law of the Commonwealth of -Virginia, excluding Virginia's conflict of law provisions. -Notwithstanding the foregoing, with regard to derivative works based -on Python 1.6.1 that incorporate non-separable material that was -previously distributed under the GNU General Public License (GPL), the -law of the Commonwealth of Virginia shall govern this License -Agreement only as to issues arising under or with respect to -Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this -License Agreement shall be deemed to create any relationship of -agency, partnership, or joint venture between CNRI and Licensee. This -License Agreement does not grant permission to use CNRI trademarks or -trade name in a trademark sense to endorse or promote products or -services of Licensee, or any third party. - -8. By clicking on the "ACCEPT" button where indicated, or by copying, -installing or otherwise using Python 1.6.1, Licensee agrees to be -bound by the terms and conditions of this License Agreement. - - ACCEPT - - -CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 --------------------------------------------------- - -Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, -The Netherlands. All rights reserved. - -Permission to use, copy, modify, and distribute this software and its -documentation for any purpose and without fee is hereby granted, -provided that the above copyright notice appear in all copies and that -both that copyright notice and this permission notice appear in -supporting documentation, and that the name of Stichting Mathematisch -Centrum or CWI not be used in advertising or publicity pertaining to -distribution of the software without specific, written prior -permission. - -STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO -THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND -FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE -FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT -OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/distro/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/distro/LICENSE deleted file mode 100644 index e06d208..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/distro/LICENSE +++ /dev/null @@ -1,202 +0,0 @@ -Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. - - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "{}" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. - - Copyright {yyyy} {name of copyright owner} - - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. - diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/idna/LICENSE.md b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/idna/LICENSE.md deleted file mode 100644 index 256ba90..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/idna/LICENSE.md +++ /dev/null @@ -1,31 +0,0 @@ -BSD 3-Clause License - -Copyright (c) 2013-2025, Kim Davies and contributors. -All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are -met: - -1. Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - -2. Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - -3. Neither the name of the copyright holder nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED -TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR -PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF -LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING -NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS -SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/msgpack/COPYING b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/msgpack/COPYING deleted file mode 100644 index f067af3..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/msgpack/COPYING +++ /dev/null @@ -1,14 +0,0 @@ -Copyright (C) 2008-2011 INADA Naoki - - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. - diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE deleted file mode 100644 index 6f62d44..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE +++ /dev/null @@ -1,3 +0,0 @@ -This software is made available under the terms of *either* of the licenses -found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made -under the terms of *both* these licenses. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.APACHE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.APACHE deleted file mode 100644 index f433b1a..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.APACHE +++ /dev/null @@ -1,177 +0,0 @@ - - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.BSD b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.BSD deleted file mode 100644 index 42ce7b7..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/packaging/LICENSE.BSD +++ /dev/null @@ -1,23 +0,0 @@ -Copyright (c) Donald Stufft and individual 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. - -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pkg_resources/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pkg_resources/LICENSE deleted file mode 100644 index 1bb5a44..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pkg_resources/LICENSE +++ /dev/null @@ -1,17 +0,0 @@ -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/platformdirs/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/platformdirs/LICENSE deleted file mode 100644 index f35fed9..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/platformdirs/LICENSE +++ /dev/null @@ -1,21 +0,0 @@ -MIT License - -Copyright (c) 2010-202x The platformdirs developers - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pygments/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pygments/LICENSE deleted file mode 100644 index 446a1a8..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pygments/LICENSE +++ /dev/null @@ -1,25 +0,0 @@ -Copyright (c) 2006-2022 by the respective authors (see AUTHORS file). -All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are -met: - -* Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - -* Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pyproject_hooks/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pyproject_hooks/LICENSE deleted file mode 100644 index b0ae9db..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/pyproject_hooks/LICENSE +++ /dev/null @@ -1,21 +0,0 @@ -The MIT License (MIT) - -Copyright (c) 2017 Thomas Kluyver - -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/requests/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/requests/LICENSE deleted file mode 100644 index 67db858..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/requests/LICENSE +++ /dev/null @@ -1,175 +0,0 @@ - - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/resolvelib/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/resolvelib/LICENSE deleted file mode 100644 index b907776..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/resolvelib/LICENSE +++ /dev/null @@ -1,13 +0,0 @@ -Copyright (c) 2018, Tzu-ping Chung - -Permission to use, copy, modify, and distribute this software for any -purpose with or without fee is hereby granted, provided that the above -copyright notice and this permission notice appear in all copies. - -THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES -WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF -MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR -ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF -OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. diff --git a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/rich/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/rich/LICENSE deleted file mode 100644 index 4415505..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/rich/LICENSE +++ /dev/null @@ -1,19 +0,0 @@ -Copyright (c) 2020 Will McGugan - -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli/LICENSE deleted file mode 100644 index e859590..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli/LICENSE +++ /dev/null @@ -1,21 +0,0 @@ -MIT License - -Copyright (c) 2021 Taneli Hukkinen - -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli_w/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli_w/LICENSE deleted file mode 100644 index e859590..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/tomli_w/LICENSE +++ /dev/null @@ -1,21 +0,0 @@ -MIT License - -Copyright (c) 2021 Taneli Hukkinen - -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/truststore/LICENSE b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/truststore/LICENSE deleted file mode 100644 index 7ec568c..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/truststore/LICENSE +++ /dev/null @@ -1,21 +0,0 @@ -The MIT License (MIT) - -Copyright (c) 2022 Seth Michael Larson - -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/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/urllib3/LICENSE.txt b/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/urllib3/LICENSE.txt deleted file mode 100644 index 429a176..0000000 --- a/.venv/lib/python3.14/site-packages/pip-26.0.1.dist-info/licenses/src/pip/_vendor/urllib3/LICENSE.txt +++ /dev/null @@ -1,21 +0,0 @@ -MIT License - -Copyright (c) 2008-2020 Andrey Petrov and contributors (see CONTRIBUTORS.txt) - -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/python3.14/site-packages/pip-26.0.1.virtualenv b/.venv/lib/python3.14/site-packages/pip-26.0.1.virtualenv deleted file mode 100644 index e69de29..0000000 diff --git a/.venv/lib/python3.14/site-packages/pip/__init__.py b/.venv/lib/python3.14/site-packages/pip/__init__.py index 978b412..2f3d1a2 100644 --- a/.venv/lib/python3.14/site-packages/pip/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/__init__.py @@ -1,6 +1,10 @@ from __future__ import annotations -__version__ = "26.0.1" +__version__ = "26.3" + +# External tools should import dependencies themselves. If technically unable, +# add names here, not to pip's internal list. +_EAGER_IMPORTS: set[str] = set() def main(args: list[str] | None = None) -> int: diff --git a/.venv/lib/python3.14/site-packages/pip/__main__.py b/.venv/lib/python3.14/site-packages/pip/__main__.py index 5991326..e671b68 100644 --- a/.venv/lib/python3.14/site-packages/pip/__main__.py +++ b/.venv/lib/python3.14/site-packages/pip/__main__.py @@ -10,7 +10,7 @@ if sys.path[0] in ("", os.getcwd()): # If we are running from a wheel, add the wheel to sys.path # This allows the usage python pip-*.whl/pip install pip-*.whl -if __package__ == "": +if not __spec__ or __spec__.parent == "": # __file__ is pip-*.whl/pip/__main__.py # first dirname call strips of '/__main__.py', second strips off '/pip' # Resulting path is the name of the wheel itself @@ -19,6 +19,6 @@ if __package__ == "": sys.path.insert(0, path) if __name__ == "__main__": - from pip._internal.cli.main import main as _main + from pip._internal.cli.main import cli as _main sys.exit(_main()) diff --git a/.venv/lib/python3.14/site-packages/pip/__pip-runner__.py b/.venv/lib/python3.14/site-packages/pip/__pip-runner__.py index d6be157..a1aee81 100644 --- a/.venv/lib/python3.14/site-packages/pip/__pip-runner__.py +++ b/.venv/lib/python3.14/site-packages/pip/__pip-runner__.py @@ -9,7 +9,7 @@ an import statement. import sys # Copied from pyproject.toml -PYTHON_REQUIRES = (3, 9) +PYTHON_REQUIRES = (3, 10) def version_str(version): # type: ignore diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/__init__.py b/.venv/lib/python3.14/site-packages/pip/_internal/__init__.py old mode 100644 new mode 100755 diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/build_env.py b/.venv/lib/python3.14/site-packages/pip/_internal/build_env.py deleted file mode 100644 index 1a42a9d..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_internal/build_env.py +++ /dev/null @@ -1,606 +0,0 @@ -"""Build Environment used for isolation during sdist building""" - -from __future__ import annotations - -import logging -import os -import pathlib -import site -import sys -import textwrap -from collections import OrderedDict -from collections.abc import Iterable, Sequence -from contextlib import AbstractContextManager as ContextManager -from contextlib import nullcontext -from io import StringIO -from types import TracebackType -from typing import TYPE_CHECKING, Protocol, TypedDict - -from pip._vendor.packaging.version import Version - -from pip import __file__ as pip_location -from pip._internal.cli.spinners import open_rich_spinner, open_spinner -from pip._internal.exceptions import ( - BuildDependencyInstallError, - DiagnosticPipError, - InstallWheelBuildError, - PipError, -) -from pip._internal.locations import get_platlib, get_purelib, get_scheme -from pip._internal.metadata import get_default_environment, get_environment -from pip._internal.utils.deprecation import deprecated -from pip._internal.utils.logging import VERBOSE, capture_logging -from pip._internal.utils.packaging import get_requirement -from pip._internal.utils.subprocess import call_subprocess -from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds - -if TYPE_CHECKING: - from pip._internal.cache import WheelCache - from pip._internal.index.package_finder import PackageFinder - from pip._internal.operations.build.build_tracker import BuildTracker - from pip._internal.req.req_install import InstallRequirement - from pip._internal.resolution.base import BaseResolver - - class ExtraEnviron(TypedDict, total=False): - extra_environ: dict[str, str] - - -logger = logging.getLogger(__name__) - - -def _dedup(a: str, b: str) -> tuple[str] | tuple[str, str]: - return (a, b) if a != b else (a,) - - -class _Prefix: - def __init__(self, path: str) -> None: - self.path = path - self.setup = False - scheme = get_scheme("", prefix=path) - self.bin_dir = scheme.scripts - self.lib_dirs = _dedup(scheme.purelib, scheme.platlib) - - -def get_runnable_pip() -> str: - """Get a file to pass to a Python executable, to run the currently-running pip. - - This is used to run a pip subprocess, for installing requirements into the build - environment. - """ - source = pathlib.Path(pip_location).resolve().parent - - if not source.is_dir(): - # This would happen if someone is using pip from inside a zip file. In that - # case, we can use that directly. - return str(source) - - return os.fsdecode(source / "__pip-runner__.py") - - -def _get_system_sitepackages() -> set[str]: - """Get system site packages - - Usually from site.getsitepackages, - but fallback on `get_purelib()/get_platlib()` if unavailable - (e.g. in a virtualenv created by virtualenv<20) - - Returns normalized set of strings. - """ - if hasattr(site, "getsitepackages"): - system_sites = site.getsitepackages() - else: - # virtualenv < 20 overwrites site.py without getsitepackages - # fallback on get_purelib/get_platlib. - # this is known to miss things, but shouldn't in the cases - # where getsitepackages() has been removed (inside a virtualenv) - system_sites = [get_purelib(), get_platlib()] - return {os.path.normcase(path) for path in system_sites} - - -class BuildEnvironmentInstaller(Protocol): - """ - Interface for installing build dependencies into an isolated build - environment. - """ - - def install( - self, - requirements: Iterable[str], - prefix: _Prefix, - *, - kind: str, - for_req: InstallRequirement | None, - ) -> None: ... - - -class SubprocessBuildEnvironmentInstaller: - """ - Install build dependencies by calling pip in a subprocess. - """ - - def __init__( - self, - finder: PackageFinder, - build_constraints: list[str] | None = None, - build_constraint_feature_enabled: bool = False, - ) -> None: - self.finder = finder - self._build_constraints = build_constraints or [] - self._build_constraint_feature_enabled = build_constraint_feature_enabled - - def _deprecation_constraint_check(self) -> None: - """ - Check for deprecation warning: PIP_CONSTRAINT affecting build environments. - - This warns when build-constraint feature is NOT enabled and PIP_CONSTRAINT - is not empty. - """ - if self._build_constraint_feature_enabled or self._build_constraints: - return - - pip_constraint = os.environ.get("PIP_CONSTRAINT") - if not pip_constraint or not pip_constraint.strip(): - return - - deprecated( - reason=( - "Setting PIP_CONSTRAINT will not affect " - "build constraints in the future," - ), - replacement=( - "to specify build constraints using --build-constraint or " - "PIP_BUILD_CONSTRAINT. To disable this warning without " - "any build constraints set --use-feature=build-constraint or " - 'PIP_USE_FEATURE="build-constraint"' - ), - gone_in="26.2", - issue=None, - ) - - def install( - self, - requirements: Iterable[str], - prefix: _Prefix, - *, - kind: str, - for_req: InstallRequirement | None, - ) -> None: - self._deprecation_constraint_check() - - finder = self.finder - args: list[str] = [ - sys.executable, - get_runnable_pip(), - "install", - "--ignore-installed", - "--no-user", - "--prefix", - prefix.path, - "--no-warn-script-location", - "--disable-pip-version-check", - # As the build environment is ephemeral, it's wasteful to - # pre-compile everything, especially as not every Python - # module will be used/compiled in most cases. - "--no-compile", - # The prefix specified two lines above, thus - # target from config file or env var should be ignored - "--target", - "", - ] - if logger.getEffectiveLevel() <= logging.DEBUG: - args.append("-vv") - elif logger.getEffectiveLevel() <= VERBOSE: - args.append("-v") - for format_control in ("no_binary", "only_binary"): - formats = getattr(finder.format_control, format_control) - args.extend( - ( - "--" + format_control.replace("_", "-"), - ",".join(sorted(formats or {":none:"})), - ) - ) - - if finder.release_control is not None: - # Use ordered args to preserve the user's original command-line order - # This is important because later flags can override earlier ones - for attr_name, value in finder.release_control.get_ordered_args(): - args.extend(("--" + attr_name.replace("_", "-"), value)) - - index_urls = finder.index_urls - if index_urls: - args.extend(["-i", index_urls[0]]) - for extra_index in index_urls[1:]: - args.extend(["--extra-index-url", extra_index]) - else: - args.append("--no-index") - for link in finder.find_links: - args.extend(["--find-links", link]) - - if finder.proxy: - args.extend(["--proxy", finder.proxy]) - for host in finder.trusted_hosts: - args.extend(["--trusted-host", host]) - if finder.custom_cert: - args.extend(["--cert", finder.custom_cert]) - if finder.client_cert: - args.extend(["--client-cert", finder.client_cert]) - if finder.prefer_binary: - args.append("--prefer-binary") - - # Handle build constraints - if self._build_constraint_feature_enabled: - args.extend(["--use-feature", "build-constraint"]) - - if self._build_constraints: - # Build constraints must be passed as both constraints - # and build constraints, so that nested builds receive - # build constraints - for constraint_file in self._build_constraints: - args.extend(["--constraint", constraint_file]) - args.extend(["--build-constraint", constraint_file]) - - extra_environ: ExtraEnviron = {} - if self._build_constraint_feature_enabled and not self._build_constraints: - # If there are no build constraints but the build constraints - # feature is enabled then we must ignore regular constraints - # in the isolated build environment - extra_environ = {"extra_environ": {"_PIP_IN_BUILD_IGNORE_CONSTRAINTS": "1"}} - - if finder.uploaded_prior_to: - args.extend(["--uploaded-prior-to", finder.uploaded_prior_to.isoformat()]) - args.append("--") - args.extend(requirements) - - identify_requirement = ( - f" for {for_req.name}" if for_req and for_req.name else "" - ) - with open_spinner(f"Installing {kind}") as spinner: - call_subprocess( - args, - command_desc=f"installing {kind}{identify_requirement}", - spinner=spinner, - **extra_environ, - ) - - -class InprocessBuildEnvironmentInstaller: - """ - Build dependency installer that runs in the same pip process. - - This contains a stripped down version of the install command with - only the logic necessary for installing build dependencies. The - finder, session, build tracker, and wheel cache are reused, but new - instances of everything else are created as needed. - - Options are inherited from the parent install command unless - they don't make sense for build dependencies (in which case, they - are hard-coded, see comments below). - """ - - def __init__( - self, - *, - finder: PackageFinder, - build_tracker: BuildTracker, - wheel_cache: WheelCache, - build_constraints: Sequence[InstallRequirement] = (), - verbosity: int = 0, - ) -> None: - from pip._internal.operations.prepare import RequirementPreparer - - self._finder = finder - self._build_constraints = build_constraints - self._wheel_cache = wheel_cache - self._level = 0 - - build_dir = TempDirectory(kind="build-env-install", globally_managed=True) - self._preparer = RequirementPreparer( - build_isolation_installer=self, - # Inherited options or state. - finder=finder, - session=finder._link_collector.session, - build_dir=build_dir.path, - build_tracker=build_tracker, - verbosity=verbosity, - # This is irrelevant as it only applies to editable requirements. - src_dir="", - # Hard-coded options (that should NOT be inherited). - download_dir=None, - build_isolation=True, - check_build_deps=False, - progress_bar="off", - # TODO: hash-checking should be extended to build deps, but that is - # deferred for later as it'd be a breaking change. - require_hashes=False, - use_user_site=False, - lazy_wheel=False, - legacy_resolver=False, - ) - - def install( - self, - requirements: Iterable[str], - prefix: _Prefix, - *, - kind: str, - for_req: InstallRequirement | None, - ) -> None: - """Install entrypoint. Manages output capturing and error handling.""" - capture_logs = not logger.isEnabledFor(VERBOSE) and self._level == 0 - if capture_logs: - # Hide the logs from the installation of build dependencies. - # They will be shown only if an error occurs. - capture_ctx: ContextManager[StringIO] = capture_logging() - spinner: ContextManager[None] = open_rich_spinner(f"Installing {kind}") - else: - # Otherwise, pass-through all logs (with a header). - capture_ctx, spinner = nullcontext(StringIO()), nullcontext() - logger.info("Installing %s ...", kind) - - try: - self._level += 1 - with spinner, capture_ctx as stream: - self._install_impl(requirements, prefix) - - except DiagnosticPipError as exc: - # Format similar to a nested subprocess error, where the - # causing error is shown first, followed by the build error. - logger.info(textwrap.dedent(stream.getvalue())) - logger.error("%s", exc, extra={"rich": True}) - logger.info("") - raise BuildDependencyInstallError( - for_req, requirements, cause=exc, log_lines=None - ) - - except Exception as exc: - logs: list[str] | None = textwrap.dedent(stream.getvalue()).splitlines() - if not capture_logs: - # If logs aren't being captured, then display the error inline - # with the rest of the logs. - logs = None - if isinstance(exc, PipError): - logger.error("%s", exc) - else: - logger.exception("pip crashed unexpectedly") - raise BuildDependencyInstallError( - for_req, requirements, cause=exc, log_lines=logs - ) - - finally: - self._level -= 1 - - def _install_impl(self, requirements: Iterable[str], prefix: _Prefix) -> None: - """Core build dependency install logic.""" - from pip._internal.commands.install import installed_packages_summary - from pip._internal.req import install_given_reqs - from pip._internal.req.constructors import install_req_from_line - from pip._internal.wheel_builder import build - - ireqs = [install_req_from_line(req, user_supplied=True) for req in requirements] - ireqs.extend(self._build_constraints) - - resolver = self._make_resolver() - resolved_set = resolver.resolve(ireqs, check_supported_wheels=True) - self._preparer.prepare_linked_requirements_more( - resolved_set.requirements.values() - ) - - reqs_to_build = [ - r for r in resolved_set.requirements_to_install if not r.is_wheel - ] - _, build_failures = build(reqs_to_build, self._wheel_cache, verify=True) - if build_failures: - raise InstallWheelBuildError(build_failures) - - installed = install_given_reqs( - resolver.get_installation_order(resolved_set), - prefix=prefix.path, - # Hard-coded options (that should NOT be inherited). - root=None, - home=None, - warn_script_location=False, - use_user_site=False, - # As the build environment is ephemeral, it's wasteful to - # pre-compile everything since not all modules will be used. - pycompile=False, - progress_bar="off", - ) - - env = get_environment(list(prefix.lib_dirs)) - if summary := installed_packages_summary(installed, env): - logger.info(summary) - - def _make_resolver(self) -> BaseResolver: - """Create a new resolver for one time use.""" - # Legacy installer never used the legacy resolver so create a - # resolvelib resolver directly. Yuck. - from pip._internal.req.constructors import install_req_from_req_string - from pip._internal.resolution.resolvelib.resolver import Resolver - - return Resolver( - make_install_req=install_req_from_req_string, - # Inherited state. - preparer=self._preparer, - finder=self._finder, - wheel_cache=self._wheel_cache, - # Hard-coded options (that should NOT be inherited). - ignore_requires_python=False, - use_user_site=False, - ignore_dependencies=False, - ignore_installed=True, - force_reinstall=False, - upgrade_strategy="to-satisfy-only", - py_version_info=None, - ) - - -class BuildEnvironment: - """Creates and manages an isolated environment to install build deps""" - - def __init__(self, installer: BuildEnvironmentInstaller) -> None: - self.installer = installer - temp_dir = TempDirectory(kind=tempdir_kinds.BUILD_ENV, globally_managed=True) - - self._prefixes = OrderedDict( - (name, _Prefix(os.path.join(temp_dir.path, name))) - for name in ("normal", "overlay") - ) - - self._bin_dirs: list[str] = [] - self._lib_dirs: list[str] = [] - for prefix in reversed(list(self._prefixes.values())): - self._bin_dirs.append(prefix.bin_dir) - self._lib_dirs.extend(prefix.lib_dirs) - - # Customize site to: - # - ensure .pth files are honored - # - prevent access to system site packages - system_sites = _get_system_sitepackages() - - self._site_dir = os.path.join(temp_dir.path, "site") - if not os.path.exists(self._site_dir): - os.mkdir(self._site_dir) - with open( - os.path.join(self._site_dir, "sitecustomize.py"), "w", encoding="utf-8" - ) as fp: - fp.write( - textwrap.dedent( - """ - import os, site, sys - - # First, drop system-sites related paths. - original_sys_path = sys.path[:] - known_paths = set() - for path in {system_sites!r}: - site.addsitedir(path, known_paths=known_paths) - system_paths = set( - os.path.normcase(path) - for path in sys.path[len(original_sys_path):] - ) - original_sys_path = [ - path for path in original_sys_path - if os.path.normcase(path) not in system_paths - ] - sys.path = original_sys_path - - # Second, add lib directories. - # ensuring .pth file are processed. - for path in {lib_dirs!r}: - assert not path in sys.path - site.addsitedir(path) - """ - ).format(system_sites=system_sites, lib_dirs=self._lib_dirs) - ) - - def __enter__(self) -> None: - self._save_env = { - name: os.environ.get(name, None) - for name in ("PATH", "PYTHONNOUSERSITE", "PYTHONPATH") - } - - path = self._bin_dirs[:] - old_path = self._save_env["PATH"] - if old_path: - path.extend(old_path.split(os.pathsep)) - - pythonpath = [self._site_dir] - - os.environ.update( - { - "PATH": os.pathsep.join(path), - "PYTHONNOUSERSITE": "1", - "PYTHONPATH": os.pathsep.join(pythonpath), - } - ) - - def __exit__( - self, - exc_type: type[BaseException] | None, - exc_val: BaseException | None, - exc_tb: TracebackType | None, - ) -> None: - for varname, old_value in self._save_env.items(): - if old_value is None: - os.environ.pop(varname, None) - else: - os.environ[varname] = old_value - - def check_requirements( - self, reqs: Iterable[str] - ) -> tuple[set[tuple[str, str]], set[str]]: - """Return 2 sets: - - conflicting requirements: set of (installed, wanted) reqs tuples - - missing requirements: set of reqs - """ - missing = set() - conflicting = set() - if reqs: - env = ( - get_environment(self._lib_dirs) - if hasattr(self, "_lib_dirs") - else get_default_environment() - ) - for req_str in reqs: - req = get_requirement(req_str) - # We're explicitly evaluating with an empty extra value, since build - # environments are not provided any mechanism to select specific extras. - if req.marker is not None and not req.marker.evaluate({"extra": ""}): - continue - dist = env.get_distribution(req.name) - if not dist: - missing.add(req_str) - continue - if isinstance(dist.version, Version): - installed_req_str = f"{req.name}=={dist.version}" - else: - installed_req_str = f"{req.name}==={dist.version}" - if not req.specifier.contains(dist.version, prereleases=True): - conflicting.add((installed_req_str, req_str)) - # FIXME: Consider direct URL? - return conflicting, missing - - def install_requirements( - self, - requirements: Iterable[str], - prefix_as_string: str, - *, - kind: str, - for_req: InstallRequirement | None = None, - ) -> None: - prefix = self._prefixes[prefix_as_string] - assert not prefix.setup - prefix.setup = True - if not requirements: - return - self.installer.install(requirements, prefix, kind=kind, for_req=for_req) - - -class NoOpBuildEnvironment(BuildEnvironment): - """A no-op drop-in replacement for BuildEnvironment""" - - def __init__(self) -> None: - pass - - def __enter__(self) -> None: - pass - - def __exit__( - self, - exc_type: type[BaseException] | None, - exc_val: BaseException | None, - exc_tb: TracebackType | None, - ) -> None: - pass - - def cleanup(self) -> None: - pass - - def install_requirements( - self, - requirements: Iterable[str], - prefix_as_string: str, - *, - kind: str, - for_req: InstallRequirement | None = None, - ) -> None: - raise NotImplementedError() diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cache.py b/.venv/lib/python3.14/site-packages/pip/_internal/cache.py index 0bcb697..bb35ccd 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cache.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cache.py @@ -16,7 +16,7 @@ from pip._internal.exceptions import InvalidWheelFilename from pip._internal.models.direct_url import DirectUrl from pip._internal.models.link import Link from pip._internal.models.wheel import Wheel -from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.temp_dir import TempDirectory, TempDirectoryKind from pip._internal.utils.urls import path_to_url logger = logging.getLogger(__name__) @@ -134,10 +134,13 @@ class SimpleWheelCache(Cache): ) -> Link: candidates = [] + if link.is_existing_dir(): + return link if not package_name: return link canonical_package_name = canonicalize_name(package_name) + supported_tags_set = set(supported_tags) for wheel_name, wheel_dir in self._get_candidates(link, canonical_package_name): try: wheel = Wheel(wheel_name) @@ -152,7 +155,7 @@ class SimpleWheelCache(Cache): package_name, ) continue - if not wheel.supported(supported_tags): + if not wheel.supported(supported_tags_set): # Built for a different python/arch/etc continue candidates.append( @@ -175,7 +178,7 @@ class EphemWheelCache(SimpleWheelCache): def __init__(self) -> None: self._temp_dir = TempDirectory( - kind=tempdir_kinds.EPHEM_WHEEL_CACHE, + kind=TempDirectoryKind.EPHEM_WHEEL_CACHE, globally_managed=True, ) @@ -279,13 +282,16 @@ class WheelCache(Cache): else: # TODO: use DirectUrl.equivalent when # https://github.com/pypa/pip/pull/10564 is merged. - if origin.url != download_info.url: + # origin.url is already stripped because it came from the + # serialized origin.json file. + download_url = download_info.to_dict_compat()["url"] + if origin.url != download_url: logger.warning( "Origin URL %s in cache entry %s does not match download URL " "%s. This is likely a pip bug or a cache corruption issue. " "Will overwrite it with the new value.", origin.url, cache_dir, - download_info.url, + download_url, ) origin_path.write_text(download_info.to_json(), encoding="utf-8") diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/autocompletion.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/autocompletion.py index f22cd11..bf15aca 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/autocompletion.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/autocompletion.py @@ -7,11 +7,9 @@ import os import sys from collections.abc import Iterable from itertools import chain -from typing import Any from pip._internal.cli.main_parser import create_main_parser from pip._internal.commands import commands_dict, create_command -from pip._internal.metadata import get_default_environment def autocomplete() -> None: @@ -51,6 +49,10 @@ def autocomplete() -> None: "uninstall", ] if should_list_installed: + # NOTE: this import is deferred until absolutely necessary as it's slow, + # and it's important that autocompletion is fast. + from pip._internal.metadata import get_default_environment + env = get_default_environment() lc = current.lower() installed = [ @@ -130,26 +132,33 @@ def autocomplete() -> None: def get_path_completion_type( - cwords: list[str], cword: int, opts: Iterable[Any] + cwords: list[str], cword: int, opts: Iterable[optparse.Option] ) -> str | None: """Get the type of path completion (``file``, ``dir``, ``path`` or None) - :param cwords: same as the environmental variable ``COMP_WORDS`` - :param cword: same as the environmental variable ``COMP_CWORD`` + :param cwords: Words from ``COMP_WORDS``, excluding the executable + :param cword: Index from ``COMP_CWORD``, including the executable :param opts: The available options to check :return: path completion type (``file``, ``dir``, ``path`` or None) """ - if cword < 2 or not cwords[cword - 2].startswith("-"): + if cword < 2: return None + + # cwords omits the executable, so the previous word is at cword - 2. + previous_option = cwords[cword - 2].split("=", 1)[0] + if not previous_option.startswith("-"): + return None + for opt in opts: - if opt.help == optparse.SUPPRESS_HELP: + if opt.help == optparse.SUPPRESS_HELP or opt.metavar is None: continue - for o in str(opt).split("/"): - if cwords[cword - 2].split("=")[0] == o: - if not opt.metavar or any( - x in ("path", "file", "dir") for x in opt.metavar.split("/") - ): - return opt.metavar + if previous_option not in opt._long_opts + opt._short_opts: + continue + + # Metavars such as 'path/url' include a local path alternative. + if any(part in ("path", "file", "dir") for part in opt.metavar.split("/")): + return opt.metavar + return None diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/base_command.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/base_command.py index 499a46f..4d44097 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/base_command.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/base_command.py @@ -2,14 +2,15 @@ from __future__ import annotations +import contextlib import logging import logging.config import optparse import os import sys import traceback +from collections.abc import Callable, Iterator from optparse import Values -from typing import Callable from pip._vendor.rich import reconfigure from pip._vendor.rich import traceback as rich_traceback @@ -18,6 +19,7 @@ from pip._internal.cli import cmdoptions from pip._internal.cli.command_context import CommandContextMixIn from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter from pip._internal.cli.status_codes import ( + BROKEN_STDOUT, ERROR, PREVIOUS_BUILD_DIR_ERROR, UNKNOWN_ERROR, @@ -50,6 +52,7 @@ class Command(CommandContextMixIn): def __init__(self, name: str, summary: str, isolated: bool = False) -> None: super().__init__() + self._cli = False self.name = name self.summary = summary self.parser = ConfigOptionParser( @@ -80,7 +83,8 @@ class Command(CommandContextMixIn): def add_options(self) -> None: pass - def handle_pip_version_check(self, options: Values) -> None: + @contextlib.contextmanager + def pip_version_check(self, options: Values, args: list[str]) -> Iterator[None]: """ This is a no-op so that commands by default do not do the pip version check. @@ -88,16 +92,15 @@ class Command(CommandContextMixIn): # Make sure we do the pip version check if the index_group options # are present. assert not hasattr(options, "no_index") + yield def run(self, options: Values, args: list[str]) -> int: raise NotImplementedError def _run_wrapper(self, level_number: int, options: Values, args: list[str]) -> int: def _inner_run() -> int: - try: + with self.pip_version_check(options, args): return self.run(options, args) - finally: - self.handle_pip_version_check(options) if options.debug_mode: rich_traceback.install(show_locals=True) @@ -132,13 +135,28 @@ class Command(CommandContextMixIn): return ERROR except BrokenStdoutLoggingError: - # Bypass our logger and write any remaining messages to - # stderr because stdout no longer works. - print("ERROR: Pipe to stdout was broken", file=sys.stderr) - if level_number <= logging.DEBUG: - traceback.print_exc(file=sys.stderr) + # stdout is broken; write to stderr directly. Use os.write, not + # sys.stderr.write, so a full pipe buffer returns EPIPE instead + # of deadlocking (Windows anonymous pipes are ~4KB). + try: + os.write(2, b"ERROR: Pipe to stdout was broken\n") + if level_number <= logging.DEBUG: + encoding = getattr(sys.stderr, "encoding", None) or "utf-8" + os.write( + 2, traceback.format_exc().encode(encoding, "backslashreplace") + ) + except OSError: + pass - return ERROR + # redirect stdout to os.devnull so that the exit cleanup doesn't + # produce "BrokenPipeError" when exiting. + devnull = os.open(os.devnull, os.O_WRONLY) + try: + os.dup2(devnull, 1) + finally: + os.close(devnull) + + return BROKEN_STDOUT except KeyboardInterrupt: logger.critical("Operation cancelled by user") logger.debug("Exception information:", exc_info=True) @@ -235,17 +253,6 @@ class Command(CommandContextMixIn): ) options.cache_dir = None - if ( - "inprocess-build-deps" in options.features_enabled - and os.environ.get("PIP_CONSTRAINT", "") - and "build-constraint" not in options.features_enabled - ): - logger.warning( - "In-process build dependencies are enabled, " - "PIP_CONSTRAINT will have no effect for build dependencies" - ) - options.features_enabled.append("build-constraint") - return self._run_wrapper(level_number, options, args) def handler_map(self) -> dict[str, Callable[[Values, list[str]], None]]: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/cmdoptions.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/cmdoptions.py index a269f86..fe60387 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/cmdoptions.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/cmdoptions.py @@ -14,11 +14,14 @@ from __future__ import annotations import logging import os import pathlib +import re import textwrap +from collections.abc import Callable +from datetime import datetime, timedelta, timezone from functools import partial from optparse import SUPPRESS_HELP, Option, OptionGroup, OptionParser, Values from textwrap import dedent -from typing import Any, Callable +from typing import Any from pip._vendor.packaging.utils import canonicalize_name @@ -32,6 +35,7 @@ from pip._internal.models.target_python import TargetPython from pip._internal.utils.datetime import parse_iso_datetime from pip._internal.utils.hashes import STRONG_HASHES from pip._internal.utils.misc import strtobool +from pip._internal.utils.urls import strip_extras logger = logging.getLogger(__name__) @@ -62,6 +66,37 @@ def make_option_group(group: dict[str, Any], parser: ConfigOptionParser) -> Opti return option_group +def check_only_deps_option_does_not_conflict(options: Values) -> None: + """Function for determining if --only-deps and other incompatible options are + specified. + + :param options: The OptionParser options. + """ + if not options.only_dependencies: + return + conflicts = [] + if options.ignore_dependencies: + conflicts.append("'--no-deps'") + if "legacy-resolver" in options.deprecated_features_enabled: + conflicts.append("'--use-deprecated legacy-resolver'") + if options.requirements: + conflicts.append("'--requirement'") + if options.requirements_from_scripts: + conflicts.append("'--requirements-from-script'") + if options.dependency_groups: + conflicts.append("'--group'") + if conflicts: + if len(conflicts) > 1: + conflicts[-1] = "or " + conflicts[-1] + conflict_message = ", ".join(conflicts) + raise CommandError( + f"Cannot use '--only-dependencies' in combination with {conflict_message}. " + "If this is unexpected, please refer to the user guide:\n" + "\n" + " https://pip.pypa.io/en/stable/user_guide/#installing-only-dependencies" + ) + + def check_dist_restriction(options: Values, check_target: bool = False) -> None: """Function for determining if custom platform options are allowed. @@ -101,28 +136,21 @@ def check_dist_restriction(options: Values, check_target: bool = False) -> None: "installing via '--target' or using '--dry-run'" ) + if dist_restriction_set: + # Lazy import to keep CLI startup fast + from pip._internal.utils import pylock as pylock_utils -def check_build_constraints(options: Values) -> None: - """Function for validating build constraints options. - - :param options: The OptionParser options. - """ - if hasattr(options, "build_constraints") and options.build_constraints: - if not options.build_isolation: - raise CommandError( - "--build-constraint cannot be used with --no-build-isolation." - ) - - # Import here to avoid circular imports - from pip._internal.network.session import PipSession - from pip._internal.req.req_file import get_file_content - - # Eagerly check build constraints file contents - # is valid so that we don't fail in when trying - # to check constraints in isolated build process - with PipSession() as session: - for constraint_file in options.build_constraints: - get_file_content(constraint_file, session) + filenames = list(options.requirements) + filenames.extend(path for path, _ in options.dependency_groups) + for filename in filenames: + filename_without_extras, _ = strip_extras(filename) + if pylock_utils.is_valid_pylock_filename(filename_without_extras): + raise CommandError( + "Platform and interpreter constraints using " + "--python-version, --platform, --abi, or --implementation, " + f"are not supported when selecting requirements " + f"from {filename_without_extras!r}" + ) def _path_option_check(option: Option, opt: str, value: str) -> str: @@ -299,10 +327,19 @@ proxy: Callable[..., Option] = partial( "--proxy", dest="proxy", type="str", - default="", + default=None, help="Specify a proxy in the form scheme://[user:passwd@]proxy.server:port.", ) +no_proxy_env: Callable[..., Option] = partial( + Option, + "--no-proxy-env", + dest="no_proxy_env", + action="store_true", + default=False, + help="Do not read proxy configuration from environment variables.", +) + retries: Callable[..., Option] = partial( Option, "--retries", @@ -434,8 +471,9 @@ def _handle_uploaded_prior_to( """ This is an optparse.Option callback for the --uploaded-prior-to option. - Parses an ISO 8601 datetime string. If no timezone is specified in the string, - local timezone is used. + Accepts either an ISO 8601 datetime string (e.g., '2023-01-01T00:00:00Z') + or a strict subset of ISO 8601 durations: PnD where n is a number of days + (e.g., 'P7D' for 7 days ago). Note: This option only works with indexes that provide upload-time metadata as specified in the simple repository API: @@ -444,6 +482,18 @@ def _handle_uploaded_prior_to( if value is None: return None + # Try ISO 8601 duration in PnD format. The leading 'P' disambiguates + # from absolute datetimes. Only whole days are supported; the format may + # be extended to more of the ISO 8601 duration syntax in the future if + # a real need is presented. + match = re.match(r"^P(\d+)D$", value, re.ASCII) + if match: + days = int(match.group(1)) + parser.values.uploaded_prior_to = datetime.now(timezone.utc) - timedelta( + days=days + ) + return + try: uploaded_prior_to = parse_iso_datetime(value) # Use local timezone if no offset is given in the ISO string. @@ -453,8 +503,9 @@ def _handle_uploaded_prior_to( except ValueError as exc: msg = ( f"invalid value: {value!r}: {exc}. " - f"Expected an ISO 8601 datetime string, " - f"e.g '2023-01-01' or '2023-01-01T00:00:00Z'" + f"Expected an ISO 8601 datetime string " + f"(e.g., '2023-01-01' or '2023-01-01T00:00:00Z') " + f"or a duration in days (e.g., 'P3D')" ) raise_option_error(parser, option=option, msg=msg) @@ -463,15 +514,18 @@ def uploaded_prior_to() -> Option: return Option( "--uploaded-prior-to", dest="uploaded_prior_to", - metavar="datetime", + metavar="datetime_or_duration", action="callback", callback=_handle_uploaded_prior_to, type="str", help=( - "Only consider packages uploaded prior to the given date time. " - "Accepts ISO 8601 strings (e.g., '2023-01-01T00:00:00Z'). " - "Uses local timezone if none specified. Only effective when " - "installing from indexes that provide upload-time metadata." + "Only consider packages uploaded prior to the given value. " + "Accepts an ISO 8601 datetime (e.g., '2023-01-01T00:00:00Z', " + "uses local timezone if none specified) " + "or duration in integer days with syntax `PD` " + "(e.g., 'P3D' for packages uploaded at least 3 days ago). " + "Only effective when using indexes that provide " + "upload-time metadata." ), ) @@ -524,8 +578,15 @@ def requirements() -> Option: action="append", default=[], metavar="file", - help="Install from the given requirements file. " - "This option can be used multiple times.", + help=( + "Install from the given requirements file. " + "The file or URL can be in pip's requirements.txt format, " + "or pylock.toml format. " + "Extras may be selected from a pylock.toml file by " + "appending [extras] to the file name. " + "pylock.toml support is experimental. " + "This option can be used multiple times." + ), ) @@ -536,7 +597,7 @@ def requirements_from_scripts() -> Option: default=[], dest="requirements_from_scripts", metavar="file", - help="Install dependencies of the given script file" + help="Install dependencies of the given script file " "as defined by PEP 723 inline metadata. ", ) @@ -615,12 +676,13 @@ def no_binary() -> Option: callback=_handle_no_binary, type="str", default=format_control, - help="Do not use binary packages. Can be supplied multiple times, and " - 'each time adds to the existing value. Accepts either ":all:" to ' - 'disable all binary packages, ":none:" to empty the set (notice ' - "the colons), or one or more package names with commas between " - "them (no colons). Note that some packages are tricky to compile " - "and may fail to install when this option is used on them.", + help="Do not download binary packages. Cached binary packages may still " + "be used. Can be supplied multiple times, and each time adds to " + "the existing value. Accepts either ':all:' to disable all binary " + "packages, ':none:' to empty the set (notice the colons), or one " + "or more package names with commas between them (no colons). " + "Note that some packages are tricky to compile and may fail to " + "install when this option is used on them.", ) @@ -790,15 +852,13 @@ python_version: Callable[..., Option] = partial( callback=_handle_python_version, type="str", default=None, - help=dedent( - """\ + help=dedent("""\ The Python interpreter version to use for wheel and "Requires-Python" compatibility checks. Defaults to a version derived from the running interpreter. The version can be specified using up to three dot-separated integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor version can also be given as a string without dots (e.g. "37" for 3.7.0). - """ - ), + """), ) @@ -927,14 +987,67 @@ no_deps: Callable[..., Option] = partial( ) +def _handle_refresh_package( + option: Option, opt_str: str, value: str, parser: OptionParser +) -> None: + if value.startswith("-"): + raise CommandError("--refresh-package option requires 1 argument.") + + existing: set[str] = getattr(parser.values, option.dest) + + new = value.split(",") + while ":all:" in new: + existing.clear() + existing.add(":all:") + del new[: new.index(":all:") + 1] + if ":none:" not in new: + return + + for name in new: + if name == ":none:": + existing.clear() + else: + existing.add(canonicalize_name(name)) + + +def refresh_package() -> Option: + return Option( + "--refresh-package", + dest="refresh_package", + action="callback", + callback=_handle_refresh_package, + type="str", + default=set(), + help="Refresh package index information for the given packages instead " + "of using cached responses. Accepts ':all:' to apply " + "to all packages, or a comma-separated list of package names.", + ) + + +only_deps: Callable[..., Option] = partial( + Option, + "--only-deps", + "--only-dependencies", + dest="only_dependencies", + action="store_true", + default=False, + help=( + "Take only the dependencies of the provided requirements into account, " + "not the requirements themselves. Cannot be used in combination with " + "--no-deps, --group, --requirement, or --requirements-from-script. " + "No user-supplied requirements will be handled, even if they were " + "dependencies of other user-supplied requirements." + ), +) + + def _handle_dependency_group( option: Option, opt: str, value: str, parser: OptionParser ) -> None: """ Process a value provided for the --group option. - Splits on the rightmost ":", and validates that the path (if present) ends - in `pyproject.toml`. Defaults the path to `pyproject.toml` when one is not given. + Splits on the rightmost ":", and validates an explicit source filename. `:` cannot appear in dependency group names, so this is a safe and simple parse. @@ -944,10 +1057,15 @@ def _handle_dependency_group( if not sep: path = "pyproject.toml" else: - # check for 'pyproject.toml' filenames using pathlib + # Local pyproject.toml paths may contain URL-like prefixes. if pathlib.PurePath(path).name != "pyproject.toml": - msg = "group paths use 'pyproject.toml' filenames" - raise_option_error(parser, option=option, msg=msg) + # Keep lock parsing imports confined to commands that request it. + from pip._internal.utils.pylock import is_valid_pylock_filename + + filename, _ = strip_extras(path) + if not is_valid_pylock_filename(filename, allow_urls=False): + msg = "group paths use local 'pyproject.toml' or 'pylock.toml' files" + raise_option_error(parser, option=option, msg=msg) parser.values.dependency_groups.append((path, groupname)) @@ -961,8 +1079,8 @@ dependency_groups: Callable[..., Option] = partial( action="callback", callback=_handle_dependency_group, metavar="[path:]group", - help='Install a named dependency-group from a "pyproject.toml" file. ' - 'If a path is given, the name of the file must be "pyproject.toml". ' + help='Install a named dependency-group from a "pyproject.toml" or ' + '"pylock.toml" file. Named "pylock..toml" files are also supported. ' 'Defaults to using "pyproject.toml" in the current directory.', ) @@ -1134,6 +1252,17 @@ require_hashes: Callable[..., Option] = partial( ) +no_require_hashes: Callable[..., Option] = partial( + Option, + "--no-require-hashes", + dest="no_require_hashes", + action="store_true", + default=False, + help="Do not automatically enable --require-hashes " + "when encountering a requirement with hashes.", +) + + list_path: Callable[..., Option] = partial( PipOption, "--path", @@ -1175,6 +1304,7 @@ no_python_version_warning: Callable[..., Option] = partial( ALWAYS_ENABLED_FEATURES = [ "truststore", # always on since 24.2 "no-binary-enable-wheel-cache", # always on since 23.1 + "build-constraint", # always on since 26.2 ] use_new_feature: Callable[..., Option] = partial( @@ -1186,8 +1316,8 @@ use_new_feature: Callable[..., Option] = partial( default=[], choices=[ "fast-deps", - "build-constraint", "inprocess-build-deps", + "venv-isolation", ] + ALWAYS_ENABLED_FEATURES, help="Enable new functionality, that may be backward incompatible.", @@ -1220,12 +1350,12 @@ general_group: dict[str, Any] = { require_virtualenv, python, verbose, - version, quiet, log, no_input, keyring_provider, proxy, + no_proxy_env, retries, timeout, exists_action, @@ -1249,6 +1379,7 @@ index_group: dict[str, Any] = { index_url, extra_index_url, no_index, + refresh_package, find_links, uploaded_prior_to, ], diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/index_command.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/index_command.py index 0f1ee1a..277389a 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/index_command.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/index_command.py @@ -8,9 +8,10 @@ so commands which don't always hit the network (e.g. list w/o --outdated or from __future__ import annotations +import contextlib import logging import os -import sys +from collections.abc import Iterator from functools import lru_cache from optparse import Values from typing import TYPE_CHECKING @@ -26,16 +27,13 @@ if TYPE_CHECKING: from pip._vendor.packaging.utils import NormalizedName from pip._internal.network.session import PipSession + from pip._internal.self_outdated_check import UpgradePrompt logger = logging.getLogger(__name__) @lru_cache def _create_truststore_ssl_context() -> SSLContext | None: - if sys.version_info < (3, 10): - logger.debug("Disabling truststore because Python version isn't 3.10+") - return None - try: import ssl except ImportError: @@ -102,6 +100,13 @@ class SessionCommandMixin(CommandContextMixIn): else: ssl_context = None + has_custom_ca = bool(options.cert) + if options.proxy is None and not options.no_proxy_env: + # Requests reads CA bundle environment variables only with trust_env. + has_custom_ca = has_custom_ca or bool( + os.environ.get("REQUESTS_CA_BUNDLE") or os.environ.get("CURL_CA_BUNDLE") + ) + session = PipSession( cache=os.path.join(cache_dir, "http-v2") if cache_dir else None, retries=retries if retries is not None else options.retries, @@ -109,6 +114,8 @@ class SessionCommandMixin(CommandContextMixIn): trusted_hosts=options.trusted_hosts, index_urls=self._get_index_urls(options), ssl_context=ssl_context, + use_ssl_context_for_proxy=not has_custom_ca, + refresh_package=getattr(options, "refresh_package", set()), ) # Handle custom ca-bundles from the user @@ -123,14 +130,18 @@ class SessionCommandMixin(CommandContextMixIn): if options.timeout or timeout: session.timeout = timeout if timeout is not None else options.timeout - # Handle configured proxies - if options.proxy: - session.proxies = { - "http": options.proxy, - "https": options.proxy, - } + # An explicit --proxy (including "" to disable proxying) or --no-proxy-env + # makes the session ignore environment proxies; unset --proxy is None. + if options.proxy is not None or options.no_proxy_env: + if options.proxy: + session.proxies = { + "http": options.proxy, + "https": options.proxy, + } session.trust_env = False + # Keep "" so an empty --proxy reaches build subprocesses. session.pip_proxy = options.proxy + session.pip_no_proxy_env = options.no_proxy_env # Determine if we can prompt the user for authentication or not session.auth.prompting = not options.no_input @@ -139,10 +150,18 @@ class SessionCommandMixin(CommandContextMixIn): return session -def _pip_self_version_check(session: PipSession, options: Values) -> None: - from pip._internal.self_outdated_check import pip_self_version_check as check +def _pip_self_version_check_fetch( + session: PipSession, options: Values +) -> UpgradePrompt | None: + from pip._internal.self_outdated_check import pip_self_version_check_fetch - check(session, options) + return pip_self_version_check_fetch(session, options) + + +def _pip_self_version_check_emit(upgrade_prompt: UpgradePrompt | None) -> None: + from pip._internal.self_outdated_check import pip_self_version_check_emit + + pip_self_version_check_emit(upgrade_prompt) class IndexGroupCommand(Command, SessionCommandMixin): @@ -169,7 +188,8 @@ class IndexGroupCommand(Command, SessionCommandMixin): # No specific setting: exclude prereleases by default return True - def handle_pip_version_check(self, options: Values) -> None: + @contextlib.contextmanager + def pip_version_check(self, options: Values, args: list[str]) -> Iterator[None]: """ Do the pip version check if not disabled. @@ -179,17 +199,27 @@ class IndexGroupCommand(Command, SessionCommandMixin): assert hasattr(options, "no_index") if options.disable_pip_version_check or options.no_index: + yield return + upgrade_prompt: UpgradePrompt | None = None try: - # Otherwise, check if we're using the latest version of pip available. session = self._build_session( options, retries=0, timeout=min(5, options.timeout), ) with session: - _pip_self_version_check(session, options) + upgrade_prompt = _pip_self_version_check_fetch(session, options) except Exception: logger.warning("There was an error checking the latest version of pip.") logger.debug("See below for error", exc_info=True) + + try: + yield + finally: + try: + _pip_self_version_check_emit(upgrade_prompt) + except Exception: + logger.warning("There was an error checking the latest version of pip.") + logger.debug("See below for error", exc_info=True) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/main.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/main.py index 78c30c3..0f21920 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/main.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/main.py @@ -38,7 +38,16 @@ logger = logging.getLogger(__name__) # main, this should not be an issue in practice. +def cli(args: list[str] | None = None) -> int: + """Run the CLI with imports blocked until process exit after installation.""" + return _main(args, cli=True) + + def main(args: list[str] | None = None) -> int: + return _main(args, cli=False) + + +def _main(args: list[str] | None, *, cli: bool) -> int: # NOTE: Lazy imports to speed up import of this module, # which is imported from the pip console script. This doesn't # speed up normal pip execution, but might be important in the future @@ -73,13 +82,16 @@ def main(args: list[str] | None = None) -> int: sys.stderr.write(os.linesep) sys.exit(1) - # Needed for locale.getpreferredencoding(False) to work + # Needed for locale encoding detection to work # in pip._internal.utils.encoding.auto_decode + # TODO: Re-evaluate whether this is still needed once pip drops Python 3.10. try: locale.setlocale(locale.LC_ALL, "") except locale.Error as e: # setlocale can apparently crash if locale are uninitialized logger.debug("Ignoring error %s when setting locale", e) + command = create_command(cmd_name, isolated=("--isolated" in cmd_args)) + command._cli = cli return command.main(cmd_args) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/main_parser.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/main_parser.py index 1368524..975f785 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/main_parser.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/main_parser.py @@ -8,12 +8,11 @@ import sys from pip._vendor.rich.markup import escape -from pip._internal.build_env import get_runnable_pip from pip._internal.cli import cmdoptions from pip._internal.cli.parser import ConfigOptionParser, UpdatingDefaultsHelpFormatter from pip._internal.commands import commands_dict, get_similar_commands from pip._internal.exceptions import CommandError -from pip._internal.utils.misc import get_pip_version, get_prog +from pip._internal.utils.misc import get_pip_version, get_prog, get_runnable_pip __all__ = ["create_main_parser", "parse_command"] @@ -31,6 +30,7 @@ def create_main_parser() -> ConfigOptionParser: parser.disable_interspersed_args() parser.version = get_pip_version() + parser.add_option(cmdoptions.version()) # add the general options gen_opts = cmdoptions.make_option_group(cmdoptions.general_group, parser) @@ -97,13 +97,23 @@ def parse_command(args: list[str]) -> tuple[str, list[str]]: # Set a flag so the child doesn't re-invoke itself, causing # an infinite loop. - os.environ["_PIP_RUNNING_IN_SUBPROCESS"] = "1" - returncode = 0 + subprocess_env = os.environ.copy() + subprocess_env["_PIP_RUNNING_IN_SUBPROCESS"] = "1" + try: - proc = subprocess.run(pip_cmd) - returncode = proc.returncode + # Based on CPython's test-runner interrupt cleanup: + # https://github.com/python/cpython/blob/6c695bfad45ddde73d0d674286800fbe295f0627/Lib/test/libregrtest/main.py#L728-L739 + with subprocess.Popen(pip_cmd, env=subprocess_env) as proc: + try: + returncode = proc.wait() + except KeyboardInterrupt: + # Reap before warning or traceback rendering reads replaced files. + proc.kill() + proc.wait() + returncode = 1 except (subprocess.SubprocessError, OSError) as exc: raise CommandError(f"Failed to run pip under {interpreter}: {exc}") + sys.exit(returncode) # --version diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/parser.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/parser.py index a498980..ff2d25f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/parser.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/parser.py @@ -11,16 +11,18 @@ import sys import textwrap from collections.abc import Generator from contextlib import suppress -from typing import Any, NoReturn +from typing import TYPE_CHECKING, Any, NoReturn from pip._vendor.rich.markup import escape from pip._vendor.rich.theme import Theme from pip._internal.cli.status_codes import UNKNOWN_ERROR from pip._internal.configuration import Configuration, ConfigurationError -from pip._internal.utils.logging import PipConsole from pip._internal.utils.misc import redact_auth_from_url, strtobool +if TYPE_CHECKING: + from pip._internal.utils.logging import PipConsole + logger = logging.getLogger(__name__) @@ -212,7 +214,6 @@ class ConfigOptionParser(CustomOptionParser): ) -> None: self.name = name self.config = Configuration(isolated) - assert self.name super().__init__(*args, **kwargs) @@ -220,7 +221,14 @@ class ConfigOptionParser(CustomOptionParser): try: return option.check_value(key, val) except optparse.OptionValueError as exc: - print(f"An error occurred during configuration: {exc}") + logger.error( + "An error occurred during configuration: %s. " + "Check your pip configuration files or " + "environment variables for this value. " + "See https://pip.pypa.io/en/stable/topics/configuration/ " + "for more information.", + exc, + ) sys.exit(3) def _get_ordered_configuration_items( @@ -344,7 +352,7 @@ class ConfigOptionParser(CustomOptionParser): self.print_usage(sys.stderr) self.exit(UNKNOWN_ERROR, f"{msg}\n") - def print_help(self, file: Any = None) -> None: + def _create_console_for_help(self, file: Any = None) -> PipConsole: # This is unfortunate but necessary since arguments may have not been # parsed yet at this point, so detect --no-color manually. no_color = ( @@ -352,7 +360,19 @@ class ConfigOptionParser(CustomOptionParser): or bool(strtobool(os.environ.get("PIP_NO_COLOR", "no") or "no")) or "NO_COLOR" in os.environ ) - console = PipConsole( + # Imported lazily: rich's console stack is only needed when help is + # actually rendered, not when this module is imported for `--version`. + from pip._internal.utils.logging import PipConsole + + return PipConsole( theme=Theme(PrettyHelpFormatter.styles), no_color=no_color, file=file ) + + def print_usage(self, file: Any = None) -> None: + if self.usage: + console = self._create_console_for_help(file) + console.print(self.get_usage(), highlight=False) + + def print_help(self, file: Any = None) -> None: + console = self._create_console_for_help(file) console.print(self.format_help().rstrip(), highlight=False) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/progress_bars.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/progress_bars.py index 4931c85..f276c7e 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/progress_bars.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/progress_bars.py @@ -2,8 +2,8 @@ from __future__ import annotations import functools import sys -from collections.abc import Generator, Iterable, Iterator -from typing import TYPE_CHECKING, Callable, Literal, TypeVar +from collections.abc import Callable, Generator, Iterable, Iterator +from typing import TYPE_CHECKING, Literal, TypeVar from pip._vendor.rich.progress import ( BarColumn, diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/req_command.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/req_command.py index 60b82fb..4ed2332 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/req_command.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/req_command.py @@ -9,12 +9,17 @@ from __future__ import annotations import logging import os +from collections.abc import Callable +from dataclasses import dataclass, field from functools import partial +from itertools import chain from optparse import Values -from typing import Any, Callable, TypeVar +from pathlib import Path +from typing import Any, TypeVar from pip._internal.build_env import ( BuildEnvironmentInstaller, + BuildIsolationMode, InprocessBuildEnvironmentInstaller, SubprocessBuildEnvironmentInstaller, ) @@ -39,37 +44,98 @@ from pip._internal.req.constructors import ( install_req_from_editable, install_req_from_line, install_req_from_parsed_requirement, + install_req_from_pylock_package, install_req_from_req_string, ) from pip._internal.req.pep723 import PEP723Exception, pep723_metadata from pip._internal.req.req_dependency_group import parse_dependency_groups -from pip._internal.req.req_file import parse_requirements +from pip._internal.req.req_file import get_file_content, parse_requirements from pip._internal.req.req_install import InstallRequirement from pip._internal.resolution.base import BaseResolver from pip._internal.utils.packaging import check_requires_python +from pip._internal.utils.pylock import ( + is_valid_pylock_filename, + select_from_pylock_path_or_url, +) from pip._internal.utils.temp_dir import ( TempDirectory, + TempDirectoryKind, TempDirectoryTypeRegistry, - tempdir_kinds, ) +from pip._internal.utils.urls import strip_extras logger = logging.getLogger(__name__) -def should_ignore_regular_constraints(options: Values) -> bool: +@dataclass +class _PylockRequest: + """Accumulate one lock's selectors before evaluating its package markers.""" + + filename: str + extras: set[str] = field(default_factory=set) + dependency_groups: set[str] = field(default_factory=set) + include_default_groups: bool = False + + +def _pylock_source_key(filename: str) -> tuple[str, str, str]: + """Identify a source together with the base used for its relative artifacts.""" + if filename.lower().startswith(("http:", "https:", "file:")): + return "url", filename, "" + # Preserve case and parent components because either can change which file opens. + source = str(Path(filename).absolute()) + artifact_base = str(Path(os.path.dirname(filename)).absolute()) + return "path", source, artifact_base + + +def _collect_requirement_sources( + requirements: list[str], groups: list[tuple[str, str]] +) -> tuple[list[str | _PylockRequest], list[tuple[str, str]]]: + """Combine selectors for each lock while retaining separate project inputs.""" + pylocks: dict[tuple[str, str, str], _PylockRequest] = {} + requirement_files: list[str | _PylockRequest] = [] + project_groups: list[tuple[str, str]] = [] + + sources = chain(((filename, None) for filename in requirements), groups) + for source, group in sources: + filename, extras = strip_extras(source) + if not is_valid_pylock_filename(filename): + if group is None: + requirement_files.append(source) + else: + project_groups.append((source, group)) + continue + + key = _pylock_source_key(filename) + if key not in pylocks: + pylocks[key] = _PylockRequest(filename) + requirement_files.append(pylocks[key]) + request = pylocks[key] + request.extras.update(extras) + if group is None: + request.include_default_groups = True + else: + request.dependency_groups.add(group) + + return requirement_files, project_groups + + +def should_ignore_regular_constraints() -> bool: """ - Check if regular constraints should be ignored because - we are in a isolated build process and build constraints - feature is enabled but no build constraints were passed. + Whether this process should ignore the regular constraints it inherits. + + The parent pip sets ``_PIP_IN_BUILD_IGNORE_CONSTRAINTS`` whenever it starts + an isolated build in a subprocess, so that regular constraints the build + inherits (such as via ``PIP_CONSTRAINT`` or config files) do not affect it. + Only build constraints apply there. """ return os.environ.get("_PIP_IN_BUILD_IGNORE_CONSTRAINTS") == "1" KEEPABLE_TEMPDIR_TYPES = [ - tempdir_kinds.BUILD_ENV, - tempdir_kinds.EPHEM_WHEEL_CACHE, - tempdir_kinds.REQ_BUILD, + TempDirectoryKind.BUILD_ENV, + TempDirectoryKind.EPHEM_WHEEL_CACHE, + TempDirectoryKind.REQ_BUILD, ] @@ -136,6 +202,20 @@ class RequirementCommand(IndexGroupCommand): self.cmd_opts.add_option(cmdoptions.dependency_groups()) self.cmd_opts.add_option(cmdoptions.no_clean()) + def check_build_constraints(self, options: Values) -> None: + """Check build constraints with the command's network session.""" + if not options.build_constraints: + return + + if not options.build_isolation: + raise CommandError( + "--build-constraint cannot be used with --no-build-isolation." + ) + + session = self.get_default_session(options) + for constraint_file in options.build_constraints: + get_file_content(constraint_file, session) + @staticmethod def determine_resolver_variant(options: Values) -> str: """Determines which resolver should be used, based on the given options.""" @@ -152,6 +232,8 @@ class RequirementCommand(IndexGroupCommand): build_tracker: BuildTracker, session: PipSession, finder: PackageFinder, + *, + allow_editables: bool, use_user_site: bool, download_dir: str | None = None, verbosity: int = 0, @@ -184,9 +266,6 @@ class RequirementCommand(IndexGroupCommand): # Handle build constraints build_constraints = getattr(options, "build_constraints", []) - build_constraint_feature_enabled = ( - "build-constraint" in options.features_enabled - ) env_installer: BuildEnvironmentInstaller if "inprocess-build-deps" in options.features_enabled: @@ -204,14 +283,26 @@ class RequirementCommand(IndexGroupCommand): env_installer = SubprocessBuildEnvironmentInstaller( finder, build_constraints=build_constraints, - build_constraint_feature_enabled=build_constraint_feature_enabled, ) + if not options.build_isolation: + build_isolation: BuildIsolationMode = "off" + elif "venv-isolation" in options.features_enabled: + build_isolation = "venv" + if "inprocess-build-deps" in options.features_enabled: + logger.warning( + "Using --use-feature 'inprocess-build-deps' and 'venv-isolation'" + " together is currently partially supported. If you encounter" + " broken behaviour, use only one feature." + ) + else: + build_isolation = "virtual" + return RequirementPreparer( build_dir=temp_build_dir_path, src_dir=options.src_dir, download_dir=download_dir, - build_isolation=options.build_isolation, + build_isolation=build_isolation, build_isolation_installer=env_installer, check_build_deps=options.check_build_deps, build_tracker=build_tracker, @@ -223,6 +314,7 @@ class RequirementCommand(IndexGroupCommand): lazy_wheel=lazy_wheel, verbosity=verbosity, legacy_resolver=legacy_resolver, + allow_editables=allow_editables, ) @classmethod @@ -260,6 +352,7 @@ class RequirementCommand(IndexGroupCommand): make_install_req=make_install_req, use_user_site=use_user_site, ignore_dependencies=options.ignore_dependencies, + only_dependencies=options.only_dependencies, ignore_installed=ignore_installed, ignore_requires_python=ignore_requires_python, force_reinstall=force_reinstall, @@ -275,6 +368,7 @@ class RequirementCommand(IndexGroupCommand): make_install_req=make_install_req, use_user_site=use_user_site, ignore_dependencies=options.ignore_dependencies, + only_dependencies=options.only_dependencies, ignore_installed=ignore_installed, ignore_requires_python=ignore_requires_python, force_reinstall=force_reinstall, @@ -293,12 +387,19 @@ class RequirementCommand(IndexGroupCommand): Parse command-line arguments into the corresponding requirements. """ requirements: list[InstallRequirement] = [] + requirement_sources, project_groups = _collect_requirement_sources( + options.requirements, options.dependency_groups + ) - if not should_ignore_regular_constraints(options): - constraints = parse_constraint_files( - options.constraints, finder, options, session - ) - requirements.extend(constraints) + if should_ignore_regular_constraints(): + # Inside an isolated build subprocess: apply the build constraints + # (forwarded via --build-constraint) instead of the inherited ones. + constraint_files = getattr(options, "build_constraints", []) + else: + constraint_files = options.constraints + + constraints = parse_constraint_files(constraint_files, finder, options, session) + requirements.extend(constraints) for req in args: if not req.strip(): @@ -312,8 +413,8 @@ class RequirementCommand(IndexGroupCommand): ) requirements.append(req_to_add) - if options.dependency_groups: - for req in parse_dependency_groups(options.dependency_groups): + if project_groups: + for req in parse_dependency_groups(project_groups): req_to_add = install_req_from_req_string( req, isolated=options.isolated_mode, @@ -331,9 +432,34 @@ class RequirementCommand(IndexGroupCommand): requirements.append(req_to_add) # NOTE: options.require_hashes may be set if --require-hashes is True - for filename in options.requirements: + for source in requirement_sources: + if isinstance(source, _PylockRequest): + logger.warning( + "Using pylock.toml as a requirements source " + "is an experimental feature. " + "It may be removed/changed in a future release " + "without prior warning." + ) + for package, package_dist in select_from_pylock_path_or_url( + source.filename, + session=session, + format_control=options.format_control, + extras=source.extras, + dependency_groups=source.dependency_groups, + include_default_groups=source.include_default_groups, + ): + req_to_add, locked_link = install_req_from_pylock_package( + package, + package_dist, + source.filename, + user_supplied=True, + ) + requirements.append(req_to_add) + if locked_link: + finder.add_locked_link(package.name, locked_link) + continue for parsed_req in parse_requirements( - filename, finder=finder, options=options, session=session + source, finder=finder, options=options, session=session ): req_to_add = install_req_from_parsed_requirement( parsed_req, @@ -379,8 +505,17 @@ class RequirementCommand(IndexGroupCommand): ) requirements.append(req_to_add) - # If any requirement has hash options, enable hash checking. - if any(req.has_hash_options for req in requirements): + if options.require_hashes and options.no_require_hashes: + raise CommandError( + "--require-hashes and --no-require-hashes are mutually exclusive" + ) + + # If any requirement has hash options, enable hash checking for all + # requirements, unless this mechanism has been explicitly disabled + # with --no-require-hashes. + if not options.no_require_hashes and any( + req.has_hash_options for req in requirements + ): options.require_hashes = True if not ( @@ -422,7 +557,7 @@ class RequirementCommand(IndexGroupCommand): options: Values, session: PipSession, target_python: TargetPython | None = None, - ignore_requires_python: bool | None = None, + ignore_requires_python: bool = False, ) -> PackageFinder: """ Create a package finder appropriate to this requirement command. diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/cli/status_codes.py b/.venv/lib/python3.14/site-packages/pip/_internal/cli/status_codes.py index 5e29502..2b2ecab 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/cli/status_codes.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/cli/status_codes.py @@ -4,3 +4,4 @@ UNKNOWN_ERROR = 2 VIRTUALENV_NOT_FOUND = 3 PREVIOUS_BUILD_DIR_ERROR = 4 NO_MATCHES_FOUND = 23 +BROKEN_STDOUT = 120 diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/__init__.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/__init__.py index bedeca9..aded697 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/__init__.py @@ -5,12 +5,17 @@ Package containing all pip commands from __future__ import annotations import importlib -from collections import namedtuple -from typing import Any +from typing import TYPE_CHECKING, Any, NamedTuple -from pip._internal.cli.base_command import Command +if TYPE_CHECKING: + from pip._internal.cli.base_command import Command + + +class CommandInfo(NamedTuple): + module_path: str + class_name: str + summary: str -CommandInfo = namedtuple("CommandInfo", "module_path, class_name, summary") # This dictionary does a bunch of heavy lifting for help output: # - Enables avoiding additional (costly) imports for presenting `--help`. @@ -119,7 +124,9 @@ def create_command(name: str, **kwargs: Any) -> Command: """ module_path, class_name, summary = commands_dict[name] module = importlib.import_module(module_path) - command_class = getattr(module, class_name) + + # Registry entries identify Command subclasses by module and class name. + command_class: type[Command] = getattr(module, class_name) command = command_class(name=name, summary=summary, **kwargs) return command diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/cache.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/cache.py index 862740f..232ace8 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/cache.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/cache.py @@ -1,7 +1,7 @@ import os import textwrap +from collections.abc import Callable from optparse import Values -from typing import Callable from pip._internal.cli.base_command import Command from pip._internal.cli.status_codes import ERROR, SUCCESS @@ -107,8 +107,7 @@ class CacheCommand(Command): wheels_cache_size = filesystem.format_directory_size(wheels_cache_location) message = ( - textwrap.dedent( - """ + textwrap.dedent(""" Package index page cache location (pip v23.3+): {http_cache_location} Package index page cache location (older pips): {old_http_cache_location} Package index page cache size: {http_cache_size} @@ -116,8 +115,7 @@ class CacheCommand(Command): Locally built wheels location: {wheels_cache_location} Locally built wheels size: {wheels_cache_size} Number of locally built wheels: {package_count} - """ # noqa: E501 - ) + """) # noqa: E501 .format( http_cache_location=http_cache_location, old_http_cache_location=old_http_cache_location, @@ -191,10 +189,13 @@ class CacheCommand(Command): logger.verbose("Removed %s", filename) http_dirs = filesystem.subdirs_without_files(self._cache_dir(options, "http")) + http_v2_dirs = filesystem.subdirs_without_files( + self._cache_dir(options, "http-v2") + ) wheel_dirs = filesystem.subdirs_without_wheels( self._cache_dir(options, "wheels") ) - dirs = [*http_dirs, *wheel_dirs] + dirs = [*http_dirs, *http_v2_dirs, *wheel_dirs] for subdir in dirs: try: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/configuration.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/configuration.py index 7bcea04..36689ec 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/configuration.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/configuration.py @@ -1,10 +1,11 @@ from __future__ import annotations +import inspect import logging import os import subprocess +from collections.abc import Callable from optparse import Values -from typing import Any, Callable from pip._internal.cli.base_command import Command from pip._internal.cli.status_codes import ERROR, SUCCESS @@ -12,7 +13,6 @@ from pip._internal.configuration import ( Configuration, Kind, get_configuration_files, - kinds, ) from pip._internal.exceptions import PipError from pip._internal.utils.logging import indent_log @@ -21,6 +21,30 @@ from pip._internal.utils.misc import get_prog, write_output logger = logging.getLogger(__name__) +def _config_handler( + name: str, handler: Callable[..., None] +) -> Callable[[Values, list[str]], None]: + """Adapt a configuration action's positional parameters to CLI arguments.""" + signature = inspect.signature(handler) + + def invoke(options: Values, args: list[str]) -> None: + try: + signature.bind(options, *args) + except TypeError: + # Skip options; these action handlers are bound methods. + arguments = list(signature.parameters)[1:] + example = " ".join([name, *(f"[{argument}]" for argument in arguments)]) + raise PipError( + f"Got unexpected number of arguments, expected {len(arguments)}. " + f'(example: "{get_prog()} config {example}")' + ) from None + + # TypeErrors raised by the action itself are programming errors. + handler(options, *args) + + return invoke + + class ConfigurationCommand(Command): """ Manage local and global configuration. @@ -96,7 +120,7 @@ class ConfigurationCommand(Command): self.parser.insert_option_group(0, self.cmd_opts) def handler_map(self) -> dict[str, Callable[[Values, list[str]], None]]: - return { + handlers: dict[str, Callable[..., None]] = { "list": self.list_values, "edit": self.open_in_editor, "get": self.get_name, @@ -105,6 +129,10 @@ class ConfigurationCommand(Command): "debug": self.list_config_values, } + return { + name: _config_handler(name, handler) for name, handler in handlers.items() + } + def run(self, options: Values, args: list[str]) -> int: handler_map = self.handler_map() @@ -147,9 +175,9 @@ class ConfigurationCommand(Command): file_options = [ key for key, value in ( - (kinds.USER, options.user_file), - (kinds.GLOBAL, options.global_file), - (kinds.SITE, options.site_file), + (Kind.USER, options.user_file), + (Kind.GLOBAL, options.global_file), + (Kind.SITE, options.site_file), ) if value ] @@ -160,11 +188,11 @@ class ConfigurationCommand(Command): # Default to user, unless there's a site file. elif any( os.path.exists(site_config_file) - for site_config_file in get_configuration_files()[kinds.SITE] + for site_config_file in get_configuration_files()[Kind.SITE] ): - return kinds.SITE + return Kind.SITE else: - return kinds.USER + return Kind.USER elif len(file_options) == 1: return file_options[0] @@ -173,34 +201,28 @@ class ConfigurationCommand(Command): "(--user, --site, --global) to perform." ) - def list_values(self, options: Values, args: list[str]) -> None: - self._get_n_args(args, "list", n=0) - + def list_values(self, options: Values) -> None: for key, value in sorted(self.configuration.items()): for key, value in sorted(value.items()): write_output("%s=%r", key, value) - def get_name(self, options: Values, args: list[str]) -> None: - key = self._get_n_args(args, "get [name]", n=1) - value = self.configuration.get_value(key) + def get_name(self, options: Values, name: str) -> None: + value = self.configuration.get_value(name) write_output("%s", value) - def set_name_value(self, options: Values, args: list[str]) -> None: - key, value = self._get_n_args(args, "set [name] [value]", n=2) - self.configuration.set_value(key, value) + def set_name_value(self, options: Values, name: str, value: str) -> None: + self.configuration.set_value(name, value) self._save_configuration() - def unset_name(self, options: Values, args: list[str]) -> None: - key = self._get_n_args(args, "unset [name]", n=1) - self.configuration.unset_value(key) + def unset_name(self, options: Values, name: str) -> None: + self.configuration.unset_value(name) self._save_configuration() - def list_config_values(self, options: Values, args: list[str]) -> None: + def list_config_values(self, options: Values) -> None: """List config key-value pairs across different config files""" - self._get_n_args(args, "debug", n=0) self.print_env_var_values() # Iterate over config files and print if they exist, and the @@ -230,7 +252,7 @@ class ConfigurationCommand(Command): env_var = f"PIP_{key.upper()}" write_output("%s=%r", env_var, value) - def open_in_editor(self, options: Values, args: list[str]) -> None: + def open_in_editor(self, options: Values) -> None: editor = self._determine_editor(options) fname = self.configuration.get_file_to_edit() @@ -252,20 +274,6 @@ class ConfigurationCommand(Command): except subprocess.CalledProcessError as e: raise PipError(f"Editor Subprocess exited with exit code {e.returncode}") - def _get_n_args(self, args: list[str], example: str, n: int) -> Any: - """Helper to make sure the command got the right number of arguments""" - if len(args) != n: - msg = ( - f"Got unexpected number of arguments, expected {n}. " - f'(example: "{get_prog()} config {example}")' - ) - raise PipError(msg) - - if n == 1: - return args[0] - else: - return args - def _save_configuration(self) -> None: # We successfully ran a modifying command. Need to save the # configuration. diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/debug.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/debug.py index 0e187e7..129843a 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/debug.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/debug.py @@ -1,6 +1,6 @@ from __future__ import annotations -import locale +import importlib import logging import os import sys @@ -18,7 +18,7 @@ from pip._internal.cli.cmdoptions import make_target_python from pip._internal.cli.status_codes import SUCCESS from pip._internal.configuration import Configuration from pip._internal.metadata import get_environment -from pip._internal.utils.compat import open_text_resource +from pip._internal.utils.compat import get_locale_encoding, open_text_resource from pip._internal.utils.logging import indent_log from pip._internal.utils.misc import get_pip_version @@ -48,29 +48,21 @@ def create_vendor_txt_map() -> dict[str, str]: return dict(line.split("==", 1) for line in lines) -def get_module_from_module_name(module_name: str) -> ModuleType | None: +def get_module_from_module_name(module_name: str) -> ModuleType: # Module name can be uppercase in vendor.txt for some reason... module_name = module_name.lower().replace("-", "_") # PATCH: setuptools is actually only pkg_resources. if module_name == "setuptools": module_name = "pkg_resources" - try: - __import__(f"pip._vendor.{module_name}", globals(), locals(), level=0) - return getattr(pip._vendor, module_name) - except ImportError: - # We allow 'truststore' to fail to import due - # to being unavailable on Python 3.9 and earlier. - if module_name == "truststore" and sys.version_info < (3, 10): - return None - raise + return importlib.import_module(f"pip._vendor.{module_name}") def get_vendor_version_from_module(module_name: str) -> str | None: module = get_module_from_module_name(module_name) version = getattr(module, "__version__", None) - if module and not version: + if not version: # Try to find version in debundled module info. assert module.__file__ is not None env = get_environment([os.path.dirname(module.__file__)]) @@ -141,7 +133,7 @@ def show_tags(options: Values) -> None: def ca_bundle_info(config: Configuration) -> str: - levels = {key.split(".", 1)[0] for key, _ in config.items()} + levels = {key.split(".", 1)[0] for _, options in config.items() for key in options} if not levels: return "Not specified" @@ -184,8 +176,8 @@ class DebugCommand(Command): show_value("sys.getdefaultencoding", sys.getdefaultencoding()) show_value("sys.getfilesystemencoding", sys.getfilesystemencoding()) show_value( - "locale.getpreferredencoding", - locale.getpreferredencoding(), + "locale.getencoding", + get_locale_encoding(), ) show_value("sys.platform", sys.platform) show_sys_implementation() diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/download.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/download.py index 5c0a3a5..8d5f2f8 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/download.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/download.py @@ -39,8 +39,10 @@ class DownloadCommand(RequirementCommand): self.cmd_opts.add_option(cmdoptions.requirements()) self.cmd_opts.add_option(cmdoptions.requirements_from_scripts()) self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.only_deps()) self.cmd_opts.add_option(cmdoptions.src()) self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.no_require_hashes()) self.cmd_opts.add_option(cmdoptions.progress_bar()) self.cmd_opts.add_option(cmdoptions.no_build_isolation()) self.cmd_opts.add_option(cmdoptions.use_pep517()) @@ -82,8 +84,9 @@ class DownloadCommand(RequirementCommand): options.editables = [] cmdoptions.check_dist_restriction(options) - cmdoptions.check_build_constraints(options) + self.check_build_constraints(options) cmdoptions.check_release_control_exclusive(options) + cmdoptions.check_only_deps_option_does_not_conflict(options) options.download_dir = normalize_path(options.download_dir) ensure_dir(options.download_dir) @@ -117,6 +120,7 @@ class DownloadCommand(RequirementCommand): download_dir=options.download_dir, use_user_site=False, verbosity=self.verbosity, + allow_editables=False, ) resolver = self.make_resolver( diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/freeze.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/freeze.py index 7794857..ab501db 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/freeze.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/freeze.py @@ -4,8 +4,8 @@ from optparse import Values from pip._internal.cli import cmdoptions from pip._internal.cli.base_command import Command from pip._internal.cli.status_codes import SUCCESS +from pip._internal.metadata.base import stdlib_pkgs from pip._internal.operations.freeze import freeze -from pip._internal.utils.compat import stdlib_pkgs def _should_suppress_build_backends() -> bool: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/index.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/index.py index 40b8f58..e444b9a 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/index.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/index.py @@ -2,9 +2,9 @@ from __future__ import annotations import json import logging -from collections.abc import Iterable +from collections.abc import Callable, Iterable from optparse import Values -from typing import Any, Callable +from typing import Any from pip._vendor.packaging.utils import canonicalize_name from pip._vendor.packaging.version import Version @@ -16,7 +16,12 @@ from pip._internal.commands.search import ( get_installed_distribution, print_dist_installation_info, ) -from pip._internal.exceptions import CommandError, DistributionNotFound, PipError +from pip._internal.exceptions import ( + CommandError, + DiagnosticPipError, + DistributionNotFound, + PipError, +) from pip._internal.index.collector import LinkCollector from pip._internal.index.package_finder import PackageFinder from pip._internal.models.selection_prefs import SelectionPreferences @@ -80,6 +85,8 @@ class IndexCommand(IndexGroupCommand): # Error handling happens here, not in the action-handlers. try: handler_map[action](options, args[1:]) + except DiagnosticPipError: + raise except PipError as e: logger.error(e.args[0]) return ERROR @@ -91,7 +98,7 @@ class IndexCommand(IndexGroupCommand): options: Values, session: PipSession, target_python: TargetPython | None = None, - ignore_requires_python: bool | None = None, + ignore_requires_python: bool = False, ) -> PackageFinder: """ Create a package finder appropriate to the index command. diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/inspect.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/inspect.py index e262012..53b4f00 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/inspect.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/inspect.py @@ -10,7 +10,7 @@ from pip._internal.cli import cmdoptions from pip._internal.cli.base_command import Command from pip._internal.cli.status_codes import SUCCESS from pip._internal.metadata import BaseDistribution, get_environment -from pip._internal.utils.compat import stdlib_pkgs +from pip._internal.metadata.base import stdlib_pkgs from pip._internal.utils.urls import path_to_url logger = logging.getLogger(__name__) @@ -71,7 +71,7 @@ class InspectCommand(Command): # report) since it is not recorded in installed metadata. direct_url = dist.direct_url if direct_url is not None: - res["direct_url"] = direct_url.to_dict() + res["direct_url"] = direct_url.to_dict_compat() else: # Emulate direct_url for legacy editable installs. editable_project_location = dist.editable_project_location diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/install.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/install.py index 8c3d866..8a56b55 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/install.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/install.py @@ -1,17 +1,29 @@ from __future__ import annotations +import contextlib import errno +import functools +import inspect import json import operator import os import shutil import site +import sys +import traceback +import types +from collections.abc import Iterable, Iterator, Sequence from optparse import SUPPRESS_HELP, Values from pathlib import Path +from typing import Any +from pip._vendor import pygments, rich +from pip._vendor.packaging.requirements import InvalidRequirement, Requirement from pip._vendor.packaging.utils import canonicalize_name from pip._vendor.requests.exceptions import InvalidProxyURL -from pip._vendor.rich import print_json +from pip._vendor.rich.text import Text + +import pip # Eagerly import self_outdated_check to avoid crashes. Otherwise, # this module would be imported *after* pip was replaced, resulting @@ -19,7 +31,7 @@ from pip._vendor.rich import print_json # with the rest of pip that's already imported, or allowing a # wheel to execute arbitrary code on install by replacing # self_outdated_check. -import pip._internal.self_outdated_check # noqa: F401 +import pip._internal.self_outdated_check from pip._internal.cache import WheelCache from pip._internal.cli import cmdoptions from pip._internal.cli.cmdoptions import make_target_python @@ -29,6 +41,7 @@ from pip._internal.cli.req_command import ( ) from pip._internal.cli.status_codes import ERROR, SUCCESS from pip._internal.exceptions import ( + BlockedImportError, CommandError, InstallationError, InstallWheelBuildError, @@ -63,6 +76,242 @@ from pip._internal.wheel_builder import build logger = getLogger(__name__) +_IMPORT_AUDIT_HOOK_INSTALLED = False +_ACTIVE_INSTALLATIONS: set[object] = set() +_WARNED_IMPORTS: set[str] = set() +_IMPORT_ERRORS: dict[str, ImportError] = {} + +# Import dependencies directly where possible; otherwise list them here. +_INTERNAL_EAGER_IMPORTS: tuple[str, ...] = ( + "pip._internal.operations.install.wheel", + # Rich loads the Python lexer when rendering debug tracebacks. + f"{pygments.__name__}.lexers.python", + # Preload Python 3.13+ traceback helpers to preserve the original error. + "traceback", + "_colorize", + "_suggestions", + "ast", + "difflib", + "unicodedata", + # Preserve cmd's fallback when readline is unavailable. + "readline", + # weakref.finalize imports gc when running shutdown callbacks. + "gc", + # Requests imports netrc lazily when looking up credentials. + "netrc", + # Use Rich's actual namespace when pip has been de-vendored. + # The renderer is used for output to a legacy Windows console. + f"{rich.__name__}._windows_renderer", + # zipfile may import these backends when reading compressed wheel contents. + "_bz2", + "_lzma", + "_zstd", +) + + +def _warn_unsafe_import(module: str) -> None: + """Warn once per module without letting logging block the import.""" + if module in _WARNED_IMPORTS: + return + + # Mark before logging: a handler may itself import this module. + _WARNED_IMPORTS.add(module) + try: + logger.warning( + "Unsafe import of %r after pip install completed: packages may have " + "changed. Callers should import all required modules before running " + "pip install, or run pip in a subprocess. " + "See https://pip.pypa.io/en/stable/user_guide/" + "#using-pip-from-your-program", + module, + ) + except Exception: + # The caller's logging handlers must not turn warnings into import errors. + pass + + +def _prevent_import_hook(name: str, args: tuple[Any, ...]) -> None: + if name == "import": + _check_import(args[0]) + + +def _check_import(module: str) -> None: + """Apply the installation import policy to audit events and module lookups.""" + if not _ACTIVE_INSTALLATIONS: + _warn_unsafe_import(module) + return + + if module in _IMPORT_ERRORS: + raise _IMPORT_ERRORS[module].with_traceback(None) + + raise BlockedImportError( + f"Blocked import of {module!r} after pip install started. Hook authors" + " must import required modules before installation starts." + ) + + +class _ImportBlocker: + """Cover module lookups, including reloads, without import audit events.""" + + def find_spec( + self, + fullname: str, + path: Sequence[str] | None = None, + target: types.ModuleType | None = None, + ) -> None: + _check_import(fullname) + + +_IMPORT_BLOCKER = _ImportBlocker() + + +def _eagerly_import_modules(module_names: Iterable[str]) -> None: + """Import selected dependencies before installation starts.""" + # Load Rich's lazy emoji and width data before installation starts. + _ = Text.from_markup(":package:").cell_len + + _IMPORT_ERRORS.clear() + for module in dict.fromkeys(module_names): + try: + __import__(module) + except ImportError as error: + _IMPORT_ERRORS[module] = error.with_traceback(None) + + +def _referenced_modules(module: types.ModuleType) -> Iterator[types.ModuleType]: + """Find dependencies referenced by modules and callables.""" + for value in tuple(vars(module).values()): + if isinstance(value, types.ModuleType): + yield value + continue + + # Standard callable adapters keep dependency globals on their function. + while True: + if type(value) is functools.partial: + value = value.func + elif type(value) is types.MethodType: + value = value.__func__ + else: + break + + names: tuple[object, ...] + if type(value) is types.FunctionType: + # Decorators can preserve the original module while changing globals. + names = (value.__globals__.get("__name__"), value.__module__) + elif callable(value): + # Read callable metadata without invoking descriptors. + names = (inspect.getattr_static(value, "__module__", None),) + else: + continue + + for name in names: + dependency = sys.modules.get(name) if isinstance(name, str) else None + if isinstance(dependency, types.ModuleType): + yield dependency + + +def _cache_lazy_import_error(error: ImportError) -> None: + """Preserve failures for both a missing dependency and its failed importers.""" + # Import machinery removes failed modules before propagating their error. + for frame, _ in traceback.walk_tb(error.__traceback__): + module_name = frame.f_globals.get("__name__") + if isinstance(module_name, str) and module_name not in sys.modules: + _IMPORT_ERRORS[module_name] = error + + if error.name is not None: + _IMPORT_ERRORS[error.name] = error + + # Avoid retaining the import traceback in the cache. + error.with_traceback(None) + + +def _reify_lazy_imports(module_names: Iterable[str]) -> None: + """Resolve lazy bindings in installation dependencies before imports are blocked.""" + if sys.version_info < (3, 15): + return + + modules = { + name: module + for name in module_names + if isinstance(module := sys.modules.get(name), types.ModuleType) + } + attempted: set[object] = set() + + while True: + # A from-import can already hold an object from a lazy dependency. + dependencies = { + dependency.__name__: dependency + for module in modules.values() + for dependency in _referenced_modules(module) + if dependency.__name__ not in modules + } + modules.update(dependencies) + + # Resolving a binding can add lazy imports to modules already scanned. + pending = [ + (module, name, value) + for module in modules.values() + for name, value in tuple(vars(module).items()) + if type(value) is types.LazyImportType and value not in attempted + ] + if not pending and not dependencies: + break + + for module, name, value in pending: + attempted.add(value) + before = set(sys.modules) + + try: + resolved = getattr(module, name) + + # The binding may resolve to an already-loaded module. + if isinstance(resolved, types.ModuleType): + modules[resolved.__name__] = resolved + except ImportError as error: + _cache_lazy_import_error(error) + except Exception: + # Optional lazy imports need not succeed for installation to proceed. + pass + + # Include dependencies loaded indirectly, even by a failed import. + for dependency in sys.modules.keys() - before: + imported = sys.modules[dependency] + if isinstance(imported, types.ModuleType): + modules[dependency] = imported + + +@contextlib.contextmanager +def _prevent_further_imports(*, until_process_exit: bool = False) -> Iterator[None]: + """Block late imports until process exit or control returns to a caller.""" + global _IMPORT_AUDIT_HOOK_INSTALLED + if not _IMPORT_AUDIT_HOOK_INSTALLED: + sys.addaudithook(_prevent_import_hook) + _IMPORT_AUDIT_HOOK_INSTALLED = True + + # Callers may add finders between installations; reloads bypass audit events. + sys.meta_path[:] = [ + _IMPORT_BLOCKER, + *(finder for finder in sys.meta_path if finder is not _IMPORT_BLOCKER), + ] + + token = object() + _ACTIVE_INSTALLATIONS.add(token) + try: + yield + finally: + # CLI exception hooks and exit callbacks run after command cleanup. + if not until_process_exit: + _ACTIVE_INSTALLATIONS.discard(token) + + +def _arg_refers_to_pip(arg: str) -> bool: + try: + req = Requirement(arg) + except InvalidRequirement: + return False + return canonicalize_name(req.name) == "pip" + + class InstallCommand(RequirementCommand): """ Install packages from: @@ -83,12 +332,18 @@ class InstallCommand(RequirementCommand): %prog [options] [-e] ... %prog [options] ...""" + def main(self, args: list[str]) -> int: + # Keep imports blocked through command cleanup and logging shutdown. + with contextlib.ExitStack() as self._import_guard: + return super().main(args) + def add_options(self) -> None: self.cmd_opts.add_option(cmdoptions.requirements()) self.cmd_opts.add_option(cmdoptions.constraints()) self.cmd_opts.add_option(cmdoptions.build_constraints()) self.cmd_opts.add_option(cmdoptions.requirements_from_scripts()) self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.only_deps()) self.cmd_opts.add_option(cmdoptions.editable()) self.cmd_opts.add_option( @@ -245,6 +500,7 @@ class InstallCommand(RequirementCommand): help="Do not warn about broken dependencies", ) self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.no_require_hashes()) self.cmd_opts.add_option(cmdoptions.progress_bar()) self.cmd_opts.add_option(cmdoptions.root_user_action()) @@ -278,6 +534,17 @@ class InstallCommand(RequirementCommand): ), ) + @contextlib.contextmanager + def pip_version_check(self, options: Values, args: list[str]) -> Iterator[None]: + # Skip the self-version check when pip itself is a requirement. The + # running pip may be replaced mid-command, and the upgrade prompt + # is redundant. + if any(_arg_refers_to_pip(arg) for arg in args): + yield + return + with super().pip_version_check(options, args): + yield + @with_cleanup def run(self, options: Values, args: list[str]) -> int: if options.use_user_site and options.target_dir is not None: @@ -304,7 +571,8 @@ class InstallCommand(RequirementCommand): if options.upgrade: upgrade_strategy = options.upgrade_strategy - cmdoptions.check_build_constraints(options) + cmdoptions.check_only_deps_option_does_not_conflict(options) + self.check_build_constraints(options) cmdoptions.check_dist_restriction(options, check_target=True) cmdoptions.check_release_control_exclusive(options) @@ -359,12 +627,6 @@ class InstallCommand(RequirementCommand): wheel_cache = WheelCache(options.cache_dir) - # Only when installing is it permitted to use PEP 660. - # In other circumstances (pip wheel, pip download) we generate - # regular (i.e. non editable) metadata and wheels. - for req in reqs: - req.permit_editable_wheels = True - preparer = self.make_requirement_preparer( temp_build_dir=directory, options=options, @@ -373,6 +635,7 @@ class InstallCommand(RequirementCommand): finder=finder, use_user_site=options.use_user_site, verbosity=self.verbosity, + allow_editables=True, ) resolver = self.make_resolver( preparer=preparer, @@ -396,7 +659,7 @@ class InstallCommand(RequirementCommand): if options.json_report_file: report = InstallationReport(requirement_set.requirements_to_install) if options.json_report_file == "-": - print_json(data=report.to_dict()) + rich.print_json(data=report.to_dict()) else: with open(options.json_report_file, "w", encoding="utf-8") as f: json.dump(report.to_dict(), f, indent=2, ensure_ascii=False) @@ -438,6 +701,7 @@ class InstallCommand(RequirementCommand): reqs_to_build, wheel_cache=wheel_cache, verify=True, + allow_editables=True, ) if build_failures: @@ -459,6 +723,15 @@ class InstallCommand(RequirementCommand): if options.target_dir or options.prefix_path: warn_script_location = False + # Block late imports so we don't silently pick up a module + # from a distribution pip is about to install. + module_names = (*_INTERNAL_EAGER_IMPORTS, *pip._EAGER_IMPORTS) + _eagerly_import_modules(module_names) + _reify_lazy_imports(module_names) + self._import_guard.enter_context( + _prevent_further_imports(until_process_exit=self._cli) + ) + installed = install_given_reqs( to_install, root=options.root_path, @@ -503,8 +776,10 @@ class InstallCommand(RequirementCommand): self._handle_target_dir( options.target_dir, target_temp_dir, options.upgrade ) + if options.root_user_action == "warn": warn_if_run_as_root() + return SUCCESS def _handle_target_dir( @@ -512,8 +787,6 @@ class InstallCommand(RequirementCommand): ) -> None: ensure_dir(target_dir) - # Checking both purelib and platlib directories for installed - # packages to be moved to target directory lib_dir_list = [] # Checking both purelib and platlib directories for installed @@ -532,12 +805,16 @@ class InstallCommand(RequirementCommand): for lib_dir in lib_dir_list: for item in os.listdir(lib_dir): + # Do not move library directories a second time as data. if lib_dir == data_dir: ddir = os.path.join(data_dir, item) if any(s.startswith(ddir) for s in lib_dir_list[:-1]): continue + target_item_dir = os.path.join(target_dir, item) - if os.path.exists(target_item_dir): + + # Keep dangling links subject to the same replacement policy. + if os.path.lexists(target_item_dir): if not upgrade: logger.warning( "Target directory %s already exists. Specify " @@ -545,6 +822,7 @@ class InstallCommand(RequirementCommand): target_item_dir, ) continue + if os.path.islink(target_item_dir): logger.warning( "Target directory %s already exists and is " @@ -554,6 +832,7 @@ class InstallCommand(RequirementCommand): target_item_dir, ) continue + if os.path.isdir(target_item_dir): shutil.rmtree(target_item_dir) else: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/list.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/list.py index f9bad7e..3d82d07 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/list.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/list.py @@ -1,8 +1,9 @@ from __future__ import annotations +import contextlib import json import logging -from collections.abc import Generator, Sequence +from collections.abc import Generator, Iterator, Sequence from email.parser import Parser from optparse import Values from typing import TYPE_CHECKING, cast @@ -15,8 +16,8 @@ from pip._internal.cli.index_command import IndexGroupCommand from pip._internal.cli.status_codes import SUCCESS from pip._internal.exceptions import CommandError from pip._internal.metadata import BaseDistribution, get_environment +from pip._internal.metadata.base import stdlib_pkgs from pip._internal.models.selection_prefs import SelectionPreferences -from pip._internal.utils.compat import stdlib_pkgs from pip._internal.utils.misc import tabulate, write_output if TYPE_CHECKING: @@ -135,9 +136,13 @@ class ListCommand(IndexGroupCommand): self.parser.insert_option_group(0, selection_opts) self.parser.insert_option_group(0, self.cmd_opts) - def handle_pip_version_check(self, options: Values) -> None: - if options.outdated or options.uptodate: - super().handle_pip_version_check(options) + @contextlib.contextmanager + def pip_version_check(self, options: Values, args: list[str]) -> Iterator[None]: + if not (options.outdated or options.uptodate): + yield + return + with super().pip_version_check(options, args): + yield def _build_package_finder( self, options: Values, session: PipSession @@ -155,11 +160,14 @@ class ListCommand(IndexGroupCommand): selection_prefs = SelectionPreferences( allow_yanked=False, release_control=options.release_control, + format_control=options.format_control, + prefer_binary=options.prefer_binary, ) return PackageFinder.create( link_collector=link_collector, selection_prefs=selection_prefs, + uploaded_prior_to=options.uploaded_prior_to, ) def run(self, options: Values, args: list[str]) -> int: @@ -175,10 +183,6 @@ class ListCommand(IndexGroupCommand): cmdoptions.check_list_path_option(options) - skip = set(stdlib_pkgs) - if options.excludes: - skip.update(canonicalize_name(n) for n in options.excludes) - packages: _ProcessedDists = [ cast("_DistWithLatestInfo", d) for d in get_environment(options.path).iter_installed_distributions( @@ -186,7 +190,7 @@ class ListCommand(IndexGroupCommand): user_only=options.user, editables_only=options.editable, include_editables=options.include_editable, - skip=skip, + skip=set(stdlib_pkgs), ) ] @@ -197,6 +201,12 @@ class ListCommand(IndexGroupCommand): if options.not_required: packages = self.get_not_required(packages, options) + if options.excludes: + excluded_names = {canonicalize_name(n) for n in options.excludes} + packages = [ + dist for dist in packages if dist.canonical_name not in excluded_names + ] + if options.outdated: packages = self.get_outdated(packages, options) elif options.uptodate: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/lock.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/lock.py index 9a55349..b541eeb 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/lock.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/lock.py @@ -62,6 +62,7 @@ class LockCommand(RequirementCommand): self.cmd_opts.add_option(cmdoptions.constraints()) self.cmd_opts.add_option(cmdoptions.build_constraints()) self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.only_deps()) self.cmd_opts.add_option(cmdoptions.editable()) @@ -75,6 +76,7 @@ class LockCommand(RequirementCommand): self.cmd_opts.add_option(cmdoptions.config_settings()) self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.no_require_hashes()) self.cmd_opts.add_option(cmdoptions.progress_bar()) index_opts = cmdoptions.make_option_group( @@ -101,8 +103,9 @@ class LockCommand(RequirementCommand): "without prior warning." ) - cmdoptions.check_build_constraints(options) + self.check_build_constraints(options) cmdoptions.check_release_control_exclusive(options) + cmdoptions.check_only_deps_option_does_not_conflict(options) session = self.get_default_session(options) @@ -123,12 +126,6 @@ class LockCommand(RequirementCommand): wheel_cache = WheelCache(options.cache_dir) - # Only when installing is it permitted to use PEP 660. - # In other circumstances (pip wheel, pip download) we generate - # regular (i.e. non editable) metadata and wheels. - for req in reqs: - req.permit_editable_wheels = True - preparer = self.make_requirement_preparer( temp_build_dir=directory, options=options, @@ -137,6 +134,7 @@ class LockCommand(RequirementCommand): finder=finder, use_user_site=False, verbosity=self.verbosity, + allow_editables=True, ) resolver = self.make_resolver( preparer=preparer, diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/search.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/search.py index b8dbc27..cefa6cc 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/search.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/search.py @@ -116,18 +116,14 @@ def transform_hits(hits: list[dict[str, str]]) -> list[TransformedHit]: def print_dist_installation_info(latest: str, dist: BaseDistribution | None) -> None: if dist is not None: with indent_log(): - if dist.version == latest: - write_output("INSTALLED: %s (latest)", dist.version) + write_output("INSTALLED: %s", dist.version) + if parse_version(latest).pre: + write_output( + "LATEST: %s (pre-release; install with `pip install --pre`)", + latest, + ) else: - write_output("INSTALLED: %s", dist.version) - if parse_version(latest).pre: - write_output( - "LATEST: %s (pre-release; install" - " with `pip install --pre`)", - latest, - ) - else: - write_output("LATEST: %s", latest) + write_output("LATEST: %s", latest) def get_installed_distribution(name: str) -> BaseDistribution | None: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/show.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/show.py index f9fcfa6..40601a2 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/show.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/show.py @@ -53,7 +53,7 @@ class ShowCommand(Command): return ERROR query = args - results = search_packages_info(query) + results = search_packages_info(query, include_files=options.files) if not print_results( results, list_files=options.files, verbose=options.verbose ): @@ -82,7 +82,10 @@ class _PackageInfo(NamedTuple): files: list[str] | None -def search_packages_info(query: list[str]) -> Generator[_PackageInfo, None, None]: +def search_packages_info( + query: list[str], + include_files: bool, +) -> Generator[_PackageInfo, None, None]: """ Gather details from installed distributions. Print distribution name, version, location, and installed files. Installed files requires a @@ -133,11 +136,11 @@ def search_packages_info(query: list[str]) -> Generator[_PackageInfo, None, None except FileNotFoundError: entry_points = [] - files_iter = dist.iter_declared_entries() - if files_iter is None: - files: list[str] | None = None - else: - files = sorted(files_iter) + files: list[str] | None = None + if include_files: + files_iter = dist.iter_declared_entries() + if files_iter is not None: + files = sorted(files_iter) metadata = dist.metadata @@ -189,7 +192,10 @@ def print_results( if i > 0: write_output("---") - metadata_version_tuple = tuple(map(int, dist.metadata_version.split("."))) + metadata_version = dist.metadata_version + metadata_version_tuple = ( + tuple(map(int, metadata_version.split("."))) if metadata_version else () + ) write_output("Name: %s", dist.name) write_output("Version: %s", dist.version) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/commands/wheel.py b/.venv/lib/python3.14/site-packages/pip/_internal/commands/wheel.py index a857433..ed4e531 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/commands/wheel.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/commands/wheel.py @@ -62,6 +62,7 @@ class WheelCommand(RequirementCommand): self.cmd_opts.add_option(cmdoptions.src()) self.cmd_opts.add_option(cmdoptions.ignore_requires_python()) self.cmd_opts.add_option(cmdoptions.no_deps()) + self.cmd_opts.add_option(cmdoptions.only_deps()) self.cmd_opts.add_option(cmdoptions.progress_bar()) self.cmd_opts.add_option( @@ -75,6 +76,7 @@ class WheelCommand(RequirementCommand): self.cmd_opts.add_option(cmdoptions.config_settings()) self.cmd_opts.add_option(cmdoptions.require_hashes()) + self.cmd_opts.add_option(cmdoptions.no_require_hashes()) index_opts = cmdoptions.make_option_group( cmdoptions.index_group, @@ -92,8 +94,9 @@ class WheelCommand(RequirementCommand): @with_cleanup def run(self, options: Values, args: list[str]) -> int: - cmdoptions.check_build_constraints(options) + self.check_build_constraints(options) cmdoptions.check_release_control_exclusive(options) + cmdoptions.check_only_deps_option_does_not_conflict(options) session = self.get_default_session(options) @@ -123,6 +126,7 @@ class WheelCommand(RequirementCommand): download_dir=options.wheel_dir, use_user_site=False, verbosity=self.verbosity, + allow_editables=False, ) resolver = self.make_resolver( @@ -151,6 +155,7 @@ class WheelCommand(RequirementCommand): reqs_to_build, wheel_cache=wheel_cache, verify=(not options.no_verify), + allow_editables=False, ) for req in build_successes: assert req.link and req.link.is_wheel @@ -160,8 +165,9 @@ class WheelCommand(RequirementCommand): shutil.copy(req.local_file_path, options.wheel_dir) except OSError as e: logger.warning( - "Building wheel for %s failed: %s", + "Failed to copy built wheel %s to %s: %s", req.name, + options.wheel_dir, e, ) build_failures.append(req) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/configuration.py b/.venv/lib/python3.14/site-packages/pip/_internal/configuration.py index e164653..72548d7 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/configuration.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/configuration.py @@ -14,37 +14,44 @@ Some terminology: from __future__ import annotations import configparser -import locale import os import sys from collections.abc import Iterable -from typing import Any, NewType +from enum import Enum +from typing import Any from pip._internal.exceptions import ( ConfigurationError, ConfigurationFileCouldNotBeLoaded, ) from pip._internal.utils import appdirs -from pip._internal.utils.compat import WINDOWS -from pip._internal.utils.logging import getLogger -from pip._internal.utils.misc import ensure_dir, enum +from pip._internal.utils._log import getLogger +from pip._internal.utils.compat import WINDOWS, get_locale_encoding +from pip._internal.utils.misc import ensure_dir RawConfigParser = configparser.RawConfigParser # Shorthand -Kind = NewType("Kind", str) CONFIG_BASENAME = "pip.ini" if WINDOWS else "pip.conf" ENV_NAMES_IGNORED = "version", "help" + # The kinds of configurations there are. -kinds = enum( - USER="user", # User Specific - GLOBAL="global", # System Wide - SITE="site", # [Virtual] Environment Specific - ENV="env", # from PIP_CONFIG_FILE - ENV_VAR="env-var", # from Environment Variables -) -OVERRIDE_ORDER = kinds.GLOBAL, kinds.USER, kinds.SITE, kinds.ENV, kinds.ENV_VAR -VALID_LOAD_ONLY = kinds.USER, kinds.GLOBAL, kinds.SITE +# TODO: Use StrEnum when Python 3.10 support is dropped. +class Kind(str, Enum): + """Configuration sources, including files and environment variables.""" + + USER = "user" # User Specific + GLOBAL = "global" # System Wide + SITE = "site" # [Virtual] Environment Specific + ENV = "env" # from PIP_CONFIG_FILE + ENV_VAR = "env-var" # from Environment Variables + + __str__ = str.__str__ + __repr__ = str.__repr__ + + +OVERRIDE_ORDER = Kind.GLOBAL, Kind.USER, Kind.SITE, Kind.ENV, Kind.ENV_VAR +VALID_LOAD_ONLY = Kind.USER, Kind.GLOBAL, Kind.SITE logger = getLogger(__name__) @@ -80,12 +87,19 @@ def get_configuration_files() -> dict[Kind, list[str]]: ) new_config_file = os.path.join(appdirs.user_config_dir("pip"), CONFIG_BASENAME) return { - kinds.GLOBAL: global_config_files, - kinds.SITE: [site_config_file], - kinds.USER: [legacy_config_file, new_config_file], + Kind.GLOBAL: global_config_files, + Kind.SITE: [site_config_file], + Kind.USER: [legacy_config_file, new_config_file], } +class _RawConfigParser(configparser.RawConfigParser): + """RawConfigParser with normalized key names.""" + + def optionxform(self, optionstr: str) -> str: + return _normalize_name(optionstr) + + class Configuration: """Handles management of configuration. @@ -120,6 +134,7 @@ class Configuration: variant: {} for variant in OVERRIDE_ORDER } self._modified_parsers: list[tuple[str, RawConfigParser]] = [] + self._use_env = False def load(self) -> None: """Loads configuration from configuration files and environment""" @@ -133,7 +148,7 @@ class Configuration: try: return self._get_parser_to_modify()[0] - except IndexError: + except ConfigurationError: return None def items(self) -> Iterable[tuple[str, Any]]: @@ -184,12 +199,10 @@ class Configuration: self._ensure_have_load_only() assert self.load_only - fname, parser = self._get_parser_to_modify() - - if ( - key not in self._config[self.load_only][fname] - and key not in self._config[self.load_only] - ): + fname, parser = self._get_parser_to_modify(key) + load_config = Kind.ENV if self._use_env else self.load_only + file_config = self._config[load_config].get(fname, {}) + if key not in file_config: raise ConfigurationError(f"No such key - {orig_key}") if parser is not None: @@ -207,9 +220,9 @@ class Configuration: parser.remove_section(section) self._mark_as_modified(fname, parser) try: - del self._config[self.load_only][fname][key] + del self._config[load_config][fname][key] except KeyError: - del self._config[self.load_only][key] + del self._config[load_config][key] def save(self) -> None: """Save the current in-memory state.""" @@ -255,20 +268,27 @@ class Configuration: def _load_config_files(self) -> None: """Loads configuration from configuration files""" config_files = dict(self.iter_config_files()) - if config_files[kinds.ENV][0:1] == [os.devnull]: + if config_files[Kind.ENV][0:1] == [os.devnull]: logger.debug( "Skipping loading configuration files due to " "environment's PIP_CONFIG_FILE being os.devnull" ) return + env_config_file = os.environ.get("PIP_CONFIG_FILE") for variant, files in config_files.items(): for fname in files: # If there's specific variant set in `load_only`, load only # that variant, not the others. if self.load_only is not None and variant != self.load_only: - logger.debug("Skipping file '%s' (variant: %s)", fname, variant) - continue + is_env_redirect = ( + variant == Kind.ENV + and fname == env_config_file + and self.load_only == Kind.USER + ) + if not is_env_redirect: + logger.debug("Skipping file '%s' (variant: %s)", fname, variant) + continue parser = self._load_file(variant, fname) @@ -279,27 +299,27 @@ class Configuration: logger.verbose("For variant '%s', will try loading '%s'", variant, fname) parser = self._construct_parser(fname) + self._config[variant].setdefault(fname, {}) for section in parser.sections(): items = parser.items(section) - self._config[variant].setdefault(fname, {}) self._config[variant][fname].update(self._normalized_keys(section, items)) return parser def _construct_parser(self, fname: str) -> RawConfigParser: - parser = configparser.RawConfigParser() + parser = _RawConfigParser() # If there is no such file, don't bother reading it but create the # parser anyway, to hold the data. # Doing this is useful when modifying and saving files, where we don't # need to construct a parser. if os.path.exists(fname): - locale_encoding = locale.getpreferredencoding(False) + encoding = "utf-8" if sys.flags.utf8_mode else get_locale_encoding() try: - parser.read(fname, encoding=locale_encoding) + parser.read(fname, encoding=encoding) except UnicodeDecodeError: # See https://github.com/pypa/pip/issues/4963 raise ConfigurationFileCouldNotBeLoaded( - reason=f"contains invalid {locale_encoding} characters", + reason=f"contains invalid {encoding} characters", fname=fname, ) except configparser.Error as error: @@ -309,8 +329,8 @@ class Configuration: def _load_environment_vars(self) -> None: """Loads configuration from environment variables""" - self._config[kinds.ENV_VAR].setdefault(":env:", {}) - self._config[kinds.ENV_VAR][":env:"].update( + self._config[Kind.ENV_VAR].setdefault(":env:", {}) + self._config[Kind.ENV_VAR][":env:"].update( self._normalized_keys(":env:", self.get_environ_vars()) ) @@ -351,7 +371,7 @@ class Configuration: env_config_file = os.environ.get("PIP_CONFIG_FILE", None) config_files = get_configuration_files() - yield kinds.GLOBAL, config_files[kinds.GLOBAL] + yield Kind.GLOBAL, config_files[Kind.GLOBAL] # per-user config is not loaded when env_config_file exists should_load_user_config = not self.isolated and not ( @@ -359,30 +379,58 @@ class Configuration: ) if should_load_user_config: # The legacy config file is overridden by the new config file - yield kinds.USER, config_files[kinds.USER] + yield Kind.USER, config_files[Kind.USER] # virtualenv config - yield kinds.SITE, config_files[kinds.SITE] + yield Kind.SITE, config_files[Kind.SITE] if env_config_file is not None: - yield kinds.ENV, [env_config_file] + yield Kind.ENV, [env_config_file] else: - yield kinds.ENV, [] + yield Kind.ENV, [] def get_values_in_config(self, variant: Kind) -> dict[str, Any]: """Get values present in a config file""" return self._config[variant] - def _get_parser_to_modify(self) -> tuple[str, RawConfigParser]: + def _get_parser_to_modify( + self, key: str | None = None + ) -> tuple[str, RawConfigParser]: # Determine which parser to modify assert self.load_only parsers = self._parsers[self.load_only] if not parsers: - # This should not happen if everything works correctly. + env_config_file = os.environ.get("PIP_CONFIG_FILE") + if env_config_file == os.devnull: + raise ConfigurationError( + "Cannot write to PIP_CONFIG_VALUE when it is set to " + f"{env_config_file}" + ) + if env_config_file and self.load_only in (Kind.USER, Kind.GLOBAL): + parser = self._construct_parser(env_config_file) + self._parsers[self.load_only].append((env_config_file, parser)) + self._use_env = True + logger.warning( + "Because PIP_CONFIG_FILE is set, changes will be applied to " + "'%s', not to '%s'. To restore normal behavior, " + "unset PIP_CONFIG_FILE.", + env_config_file, + self.load_only, + ) + return env_config_file, parser + raise ConfigurationError( "Fatal Internal error [id=2]. Please report as a bug." ) + if key is None: + return parsers[-1] + + section, name = _disassemble_key(key) + for fname, parser in reversed(parsers): + if parser.has_section(section) and parser.has_option(section, name): + return fname, parser + # Use the highest priority parser. return parsers[-1] diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/base.py b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/base.py index ea61f35..66cc542 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/base.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/base.py @@ -7,7 +7,7 @@ from pip._internal.metadata.base import BaseDistribution from pip._internal.req import InstallRequirement if TYPE_CHECKING: - from pip._internal.build_env import BuildEnvironmentInstaller + from pip._internal.build_env import BuildEnvironmentInstaller, BuildIsolationMode class AbstractDistribution(metaclass=abc.ABCMeta): @@ -33,7 +33,8 @@ class AbstractDistribution(metaclass=abc.ABCMeta): super().__init__() self.req = req - @abc.abstractproperty + @property + @abc.abstractmethod def build_tracker_id(self) -> str | None: """A string that uniquely identifies this requirement to the build tracker. @@ -49,7 +50,8 @@ class AbstractDistribution(metaclass=abc.ABCMeta): def prepare_distribution_metadata( self, build_env_installer: BuildEnvironmentInstaller, - build_isolation: bool, + build_isolation: BuildIsolationMode, check_build_deps: bool, + allow_editables: bool, ) -> None: raise NotImplementedError() diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/installed.py b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/installed.py index b6a67df..06cff25 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/installed.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/installed.py @@ -6,7 +6,7 @@ from pip._internal.distributions.base import AbstractDistribution from pip._internal.metadata import BaseDistribution if TYPE_CHECKING: - from pip._internal.build_env import BuildEnvironmentInstaller + from pip._internal.build_env import BuildEnvironmentInstaller, BuildIsolationMode class InstalledDistribution(AbstractDistribution): @@ -27,7 +27,8 @@ class InstalledDistribution(AbstractDistribution): def prepare_distribution_metadata( self, build_env_installer: BuildEnvironmentInstaller, - build_isolation: bool, + build_isolation: BuildIsolationMode, check_build_deps: bool, + allow_editables: bool, ) -> None: pass diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/sdist.py b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/sdist.py index f7bd783..fad25db 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/sdist.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/sdist.py @@ -2,9 +2,15 @@ from __future__ import annotations import logging from collections.abc import Iterable +from contextlib import nullcontext from typing import TYPE_CHECKING -from pip._internal.build_env import BuildEnvironment +from pip._internal.build_env import ( + BuildIsolationMode, + NoOpBuildEnvironment, + VenvBuildEnvironment, + VirtualBuildEnvironment, +) from pip._internal.distributions.base import AbstractDistribution from pip._internal.exceptions import InstallationError from pip._internal.metadata import BaseDistribution @@ -35,24 +41,28 @@ class SourceDistribution(AbstractDistribution): def prepare_distribution_metadata( self, build_env_installer: BuildEnvironmentInstaller, - build_isolation: bool, + build_isolation: BuildIsolationMode, check_build_deps: bool, + allow_editables: bool, ) -> None: - # Load pyproject.toml + # Load pyproject.toml and set up backend environment self.req.load_pyproject_toml() + self._prepare_build_env(build_isolation, build_env_installer) # Set up the build isolation, if this requirement should be isolated - if build_isolation: + if build_isolation != "off": # Setup an isolated environment and install the build backend static # requirements in it. - self._prepare_build_backend(build_env_installer) + self._prepare_build_backend(build_isolation) # Check that the build backend supports PEP 660. This cannot be done # earlier because we need to setup the build backend to verify it # supports build_editable, nor can it be done later, because we want # to avoid installing build requirements needlessly. self.req.editable_sanity_check() # Install the dynamic build requirements. - self._install_build_reqs(build_env_installer) + self._install_build_reqs( + build_env_installer, build_isolation, allow_editables=allow_editables + ) else: # When not using build isolation, we still need to check that # the build backend supports PEP 660. @@ -68,20 +78,34 @@ class SourceDistribution(AbstractDistribution): self._raise_conflicts("the backend dependencies", conflicting) if missing: self._raise_missing_reqs(missing) - self.req.prepare_metadata() + self.req.prepare_metadata(allow_editables) - def _prepare_build_backend( - self, build_env_installer: BuildEnvironmentInstaller + def _prepare_build_env( + self, + build_isolation: BuildIsolationMode, + build_env_installer: BuildEnvironmentInstaller, ) -> None: - # Isolate in a BuildEnvironment and install the build-time - # requirements. + if build_isolation == "virtual": + self.req.build_env = VirtualBuildEnvironment(build_env_installer) + elif build_isolation == "venv": + self.req.build_env = VenvBuildEnvironment(build_env_installer) + + self.req.configure_backend(self.req.build_env.python_executable) + + def _prepare_build_backend(self, build_isolation: BuildIsolationMode) -> None: + # Install the pyproject.toml declared build-time requirements. pyproject_requires = self.req.pyproject_requires assert pyproject_requires is not None + assert not isinstance(self.req.build_env, NoOpBuildEnvironment) - self.req.build_env = BuildEnvironment(build_env_installer) - self.req.build_env.install_requirements( - pyproject_requires, "overlay", kind="build dependencies", for_req=self.req - ) + context = self.req.build_env if build_isolation == "venv" else nullcontext() + with context: + self.req.build_env.install_requirements( + pyproject_requires, + "overlay", + kind="build dependencies", + for_req=self.req, + ) conflicting, missing = self.req.build_env.check_requirements( self.req.requirements_to_check ) @@ -117,14 +141,17 @@ class SourceDistribution(AbstractDistribution): return backend.get_requires_for_build_editable() def _install_build_reqs( - self, build_env_installer: BuildEnvironmentInstaller + self, + build_env_installer: BuildEnvironmentInstaller, + build_isolation: BuildIsolationMode, + allow_editables: bool, ) -> None: # Install any extra build dependencies that the backend requests. # This must be done in a second pass, as the pyproject.toml # dependencies must be installed before we can call the backend. if ( self.req.editable - and self.req.permit_editable_wheels + and allow_editables and self.req.supports_pyproject_editable ): build_reqs = self._get_build_requires_editable() @@ -133,9 +160,11 @@ class SourceDistribution(AbstractDistribution): conflicting, missing = self.req.build_env.check_requirements(build_reqs) if conflicting: self._raise_conflicts("the backend dependencies", conflicting) - self.req.build_env.install_requirements( - missing, "normal", kind="backend dependencies", for_req=self.req - ) + context = self.req.build_env if build_isolation == "venv" else nullcontext() + with context: + self.req.build_env.install_requirements( + missing, "normal", kind="backend dependencies", for_req=self.req + ) def _raise_conflicts( self, conflicting_with: str, conflicting_reqs: set[tuple[str, str]] diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/wheel.py b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/wheel.py index ee12bfa..8f2a217 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/distributions/wheel.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/distributions/wheel.py @@ -12,7 +12,7 @@ from pip._internal.metadata import ( ) if TYPE_CHECKING: - from pip._internal.build_env import BuildEnvironmentInstaller + from pip._internal.build_env import BuildEnvironmentInstaller, BuildIsolationMode class WheelDistribution(AbstractDistribution): @@ -38,7 +38,8 @@ class WheelDistribution(AbstractDistribution): def prepare_distribution_metadata( self, build_env_installer: BuildEnvironmentInstaller, - build_isolation: bool, + build_isolation: BuildIsolationMode, check_build_deps: bool, + allow_editables: bool, ) -> None: pass diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/exceptions.py b/.venv/lib/python3.14/site-packages/pip/_internal/exceptions.py deleted file mode 100644 index 9ddda0e..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_internal/exceptions.py +++ /dev/null @@ -1,971 +0,0 @@ -"""Exceptions used throughout package. - -This module MUST NOT try to import from anything within `pip._internal` to -operate. This is expected to be importable from any/all files within the -subpackage and, thus, should not depend on them. -""" - -from __future__ import annotations - -import configparser -import contextlib -import locale -import logging -import pathlib -import re -import sys -import traceback -from collections.abc import Iterable, Iterator -from itertools import chain, groupby, repeat -from typing import TYPE_CHECKING, Literal - -from pip._vendor.packaging.requirements import InvalidRequirement -from pip._vendor.packaging.version import InvalidVersion -from pip._vendor.rich.console import Console, ConsoleOptions, RenderResult -from pip._vendor.rich.markup import escape -from pip._vendor.rich.text import Text - -if TYPE_CHECKING: - from hashlib import _Hash - - from pip._vendor.requests.models import PreparedRequest, Request, Response - - from pip._internal.metadata import BaseDistribution - from pip._internal.models.link import Link - from pip._internal.network.download import _FileDownload - from pip._internal.req.req_install import InstallRequirement - -logger = logging.getLogger(__name__) - - -# -# Scaffolding -# -def _is_kebab_case(s: str) -> bool: - return re.match(r"^[a-z]+(-[a-z]+)*$", s) is not None - - -def _prefix_with_indent( - s: Text | str, - console: Console, - *, - prefix: str, - indent: str, -) -> Text: - if isinstance(s, Text): - text = s - else: - text = console.render_str(s) - - return console.render_str(prefix, overflow="ignore") + console.render_str( - f"\n{indent}", overflow="ignore" - ).join(text.split(allow_blank=True)) - - -class PipError(Exception): - """The base pip error.""" - - -class DiagnosticPipError(PipError): - """An error, that presents diagnostic information to the user. - - This contains a bunch of logic, to enable pretty presentation of our error - messages. Each error gets a unique reference. Each error can also include - additional context, a hint and/or a note -- which are presented with the - main error message in a consistent style. - - This is adapted from the error output styling in `sphinx-theme-builder`. - """ - - reference: str - - def __init__( - self, - *, - kind: Literal["error", "warning"] = "error", - reference: str | None = None, - message: str | Text, - context: str | Text | None, - hint_stmt: str | Text | None, - note_stmt: str | Text | None = None, - link: str | None = None, - ) -> None: - # Ensure a proper reference is provided. - if reference is None: - assert hasattr(self, "reference"), "error reference not provided!" - reference = self.reference - assert _is_kebab_case(reference), "error reference must be kebab-case!" - - self.kind = kind - self.reference = reference - - self.message = message - self.context = context - - self.note_stmt = note_stmt - self.hint_stmt = hint_stmt - - self.link = link - - super().__init__(f"<{self.__class__.__name__}: {self.reference}>") - - def __repr__(self) -> str: - return ( - f"<{self.__class__.__name__}(" - f"reference={self.reference!r}, " - f"message={self.message!r}, " - f"context={self.context!r}, " - f"note_stmt={self.note_stmt!r}, " - f"hint_stmt={self.hint_stmt!r}" - ")>" - ) - - def __rich_console__( - self, - console: Console, - options: ConsoleOptions, - ) -> RenderResult: - colour = "red" if self.kind == "error" else "yellow" - - yield f"[{colour} bold]{self.kind}[/]: [bold]{self.reference}[/]" - yield "" - - if not options.ascii_only: - # Present the main message, with relevant context indented. - if self.context is not None: - yield _prefix_with_indent( - self.message, - console, - prefix=f"[{colour}]×[/] ", - indent=f"[{colour}]│[/] ", - ) - yield _prefix_with_indent( - self.context, - console, - prefix=f"[{colour}]╰─>[/] ", - indent=f"[{colour}] [/] ", - ) - else: - yield _prefix_with_indent( - self.message, - console, - prefix="[red]×[/] ", - indent=" ", - ) - else: - yield self.message - if self.context is not None: - yield "" - yield self.context - - if self.note_stmt is not None or self.hint_stmt is not None: - yield "" - - if self.note_stmt is not None: - yield _prefix_with_indent( - self.note_stmt, - console, - prefix="[magenta bold]note[/]: ", - indent=" ", - ) - if self.hint_stmt is not None: - yield _prefix_with_indent( - self.hint_stmt, - console, - prefix="[cyan bold]hint[/]: ", - indent=" ", - ) - - if self.link is not None: - yield "" - yield f"Link: {self.link}" - - -# -# Actual Errors -# -class ConfigurationError(PipError): - """General exception in configuration""" - - -class InstallationError(PipError): - """General exception during installation""" - - -class FailedToPrepareCandidate(InstallationError): - """Raised when we fail to prepare a candidate (i.e. fetch and generate metadata). - - This is intentionally not a diagnostic error, since the output will be presented - above this error, when this occurs. This should instead present information to the - user. - """ - - def __init__( - self, *, package_name: str, requirement_chain: str, failed_step: str - ) -> None: - super().__init__(f"Failed to build '{package_name}' when {failed_step.lower()}") - self.package_name = package_name - self.requirement_chain = requirement_chain - self.failed_step = failed_step - - -class MissingPyProjectBuildRequires(DiagnosticPipError): - """Raised when pyproject.toml has `build-system`, but no `build-system.requires`.""" - - reference = "missing-pyproject-build-system-requires" - - def __init__(self, *, package: str) -> None: - super().__init__( - message=f"Can not process {escape(package)}", - context=Text( - "This package has an invalid pyproject.toml file.\n" - "The [build-system] table is missing the mandatory `requires` key." - ), - note_stmt="This is an issue with the package mentioned above, not pip.", - hint_stmt=Text("See PEP 518 for the detailed specification."), - ) - - -class InvalidPyProjectBuildRequires(DiagnosticPipError): - """Raised when pyproject.toml an invalid `build-system.requires`.""" - - reference = "invalid-pyproject-build-system-requires" - - def __init__(self, *, package: str, reason: str) -> None: - super().__init__( - message=f"Can not process {escape(package)}", - context=Text( - "This package has an invalid `build-system.requires` key in " - f"pyproject.toml.\n{reason}" - ), - note_stmt="This is an issue with the package mentioned above, not pip.", - hint_stmt=Text("See PEP 518 for the detailed specification."), - ) - - -class NoneMetadataError(PipError): - """Raised when accessing a Distribution's "METADATA" or "PKG-INFO". - - This signifies an inconsistency, when the Distribution claims to have - the metadata file (if not, raise ``FileNotFoundError`` instead), but is - not actually able to produce its content. This may be due to permission - errors. - """ - - def __init__( - self, - dist: BaseDistribution, - metadata_name: str, - ) -> None: - """ - :param dist: A Distribution object. - :param metadata_name: The name of the metadata being accessed - (can be "METADATA" or "PKG-INFO"). - """ - self.dist = dist - self.metadata_name = metadata_name - - def __str__(self) -> str: - # Use `dist` in the error message because its stringification - # includes more information, like the version and location. - return f"None {self.metadata_name} metadata found for distribution: {self.dist}" - - -class UserInstallationInvalid(InstallationError): - """A --user install is requested on an environment without user site.""" - - def __str__(self) -> str: - return "User base directory is not specified" - - -class InvalidSchemeCombination(InstallationError): - def __str__(self) -> str: - before = ", ".join(str(a) for a in self.args[:-1]) - return f"Cannot set {before} and {self.args[-1]} together" - - -class DistributionNotFound(InstallationError): - """Raised when a distribution cannot be found to satisfy a requirement""" - - -class RequirementsFileParseError(InstallationError): - """Raised when a general error occurs parsing a requirements file line.""" - - -class BestVersionAlreadyInstalled(PipError): - """Raised when the most up-to-date version of a package is already - installed.""" - - -class BadCommand(PipError): - """Raised when virtualenv or a command is not found""" - - -class CommandError(PipError): - """Raised when there is an error in command-line arguments""" - - -class PreviousBuildDirError(PipError): - """Raised when there's a previous conflicting build directory""" - - -class NetworkConnectionError(PipError): - """HTTP connection error""" - - def __init__( - self, - error_msg: str, - response: Response | None = None, - request: Request | PreparedRequest | None = None, - ) -> None: - """ - Initialize NetworkConnectionError with `request` and `response` - objects. - """ - self.response = response - self.request = request - self.error_msg = error_msg - if ( - self.response is not None - and not self.request - and hasattr(response, "request") - ): - self.request = self.response.request - super().__init__(error_msg, response, request) - - def __str__(self) -> str: - return str(self.error_msg) - - -class InvalidWheelFilename(InstallationError): - """Invalid wheel filename.""" - - -class UnsupportedWheel(InstallationError): - """Unsupported wheel.""" - - -class InvalidWheel(InstallationError): - """Invalid (e.g. corrupt) wheel.""" - - def __init__(self, location: str, name: str): - self.location = location - self.name = name - - def __str__(self) -> str: - return f"Wheel '{self.name}' located at {self.location} is invalid." - - -class MetadataInconsistent(InstallationError): - """Built metadata contains inconsistent information. - - This is raised when the metadata contains values (e.g. name and version) - that do not match the information previously obtained from sdist filename, - user-supplied ``#egg=`` value, or an install requirement name. - """ - - def __init__( - self, ireq: InstallRequirement, field: str, f_val: str, m_val: str - ) -> None: - self.ireq = ireq - self.field = field - self.f_val = f_val - self.m_val = m_val - - def __str__(self) -> str: - return ( - f"Requested {self.ireq} has inconsistent {self.field}: " - f"expected {self.f_val!r}, but metadata has {self.m_val!r}" - ) - - -class MetadataInvalid(InstallationError): - """Metadata is invalid.""" - - def __init__(self, ireq: InstallRequirement, error: str) -> None: - self.ireq = ireq - self.error = error - - def __str__(self) -> str: - return f"Requested {self.ireq} has invalid metadata: {self.error}" - - -class InstallationSubprocessError(DiagnosticPipError, InstallationError): - """A subprocess call failed.""" - - reference = "subprocess-exited-with-error" - - def __init__( - self, - *, - command_description: str, - exit_code: int, - output_lines: list[str] | None, - ) -> None: - if output_lines is None: - output_prompt = Text("No available output.") - else: - output_prompt = ( - Text.from_markup(f"[red][{len(output_lines)} lines of output][/]\n") - + Text("".join(output_lines)) - + Text.from_markup(R"[red]\[end of output][/]") - ) - - super().__init__( - message=( - f"[green]{escape(command_description)}[/] did not run successfully.\n" - f"exit code: {exit_code}" - ), - context=output_prompt, - hint_stmt=None, - note_stmt=( - "This error originates from a subprocess, and is likely not a " - "problem with pip." - ), - ) - - self.command_description = command_description - self.exit_code = exit_code - - def __str__(self) -> str: - return f"{self.command_description} exited with {self.exit_code}" - - -class MetadataGenerationFailed(DiagnosticPipError, InstallationError): - reference = "metadata-generation-failed" - - def __init__( - self, - *, - package_details: str, - ) -> None: - super().__init__( - message="Encountered error while generating package metadata.", - context=escape(package_details), - hint_stmt="See above for details.", - note_stmt="This is an issue with the package mentioned above, not pip.", - ) - - def __str__(self) -> str: - return "metadata generation failed" - - -class HashErrors(InstallationError): - """Multiple HashError instances rolled into one for reporting""" - - def __init__(self) -> None: - self.errors: list[HashError] = [] - - def append(self, error: HashError) -> None: - self.errors.append(error) - - def __str__(self) -> str: - lines = [] - self.errors.sort(key=lambda e: e.order) - for cls, errors_of_cls in groupby(self.errors, lambda e: e.__class__): - lines.append(cls.head) - lines.extend(e.body() for e in errors_of_cls) - if lines: - return "\n".join(lines) - return "" - - def __bool__(self) -> bool: - return bool(self.errors) - - -class HashError(InstallationError): - """ - A failure to verify a package against known-good hashes - - :cvar order: An int sorting hash exception classes by difficulty of - recovery (lower being harder), so the user doesn't bother fretting - about unpinned packages when he has deeper issues, like VCS - dependencies, to deal with. Also keeps error reports in a - deterministic order. - :cvar head: A section heading for display above potentially many - exceptions of this kind - :ivar req: The InstallRequirement that triggered this error. This is - pasted on after the exception is instantiated, because it's not - typically available earlier. - - """ - - req: InstallRequirement | None = None - head = "" - order: int = -1 - - def body(self) -> str: - """Return a summary of me for display under the heading. - - This default implementation simply prints a description of the - triggering requirement. - - :param req: The InstallRequirement that provoked this error, with - its link already populated by the resolver's _populate_link(). - - """ - return f" {self._requirement_name()}" - - def __str__(self) -> str: - return f"{self.head}\n{self.body()}" - - def _requirement_name(self) -> str: - """Return a description of the requirement that triggered me. - - This default implementation returns long description of the req, with - line numbers - - """ - return str(self.req) if self.req else "unknown package" - - -class VcsHashUnsupported(HashError): - """A hash was provided for a version-control-system-based requirement, but - we don't have a method for hashing those.""" - - order = 0 - head = ( - "Can't verify hashes for these requirements because we don't " - "have a way to hash version control repositories:" - ) - - -class DirectoryUrlHashUnsupported(HashError): - """A hash was provided for a version-control-system-based requirement, but - we don't have a method for hashing those.""" - - order = 1 - head = ( - "Can't verify hashes for these file:// requirements because they " - "point to directories:" - ) - - -class HashMissing(HashError): - """A hash was needed for a requirement but is absent.""" - - order = 2 - head = ( - "Hashes are required in --require-hashes mode, but they are " - "missing from some requirements. Here is a list of those " - "requirements along with the hashes their downloaded archives " - "actually had. Add lines like these to your requirements files to " - "prevent tampering. (If you did not enable --require-hashes " - "manually, note that it turns on automatically when any package " - "has a hash.)" - ) - - def __init__(self, gotten_hash: str) -> None: - """ - :param gotten_hash: The hash of the (possibly malicious) archive we - just downloaded - """ - self.gotten_hash = gotten_hash - - def body(self) -> str: - # Dodge circular import. - from pip._internal.utils.hashes import FAVORITE_HASH - - package = None - if self.req: - # In the case of URL-based requirements, display the original URL - # seen in the requirements file rather than the package name, - # so the output can be directly copied into the requirements file. - package = ( - self.req.original_link - if self.req.is_direct - # In case someone feeds something downright stupid - # to InstallRequirement's constructor. - else getattr(self.req, "req", None) - ) - return " {} --hash={}:{}".format( - package or "unknown package", FAVORITE_HASH, self.gotten_hash - ) - - -class HashUnpinned(HashError): - """A requirement had a hash specified but was not pinned to a specific - version.""" - - order = 3 - head = ( - "In --require-hashes mode, all requirements must have their " - "versions pinned with ==. These do not:" - ) - - -class HashMismatch(HashError): - """ - Distribution file hash values don't match. - - :ivar package_name: The name of the package that triggered the hash - mismatch. Feel free to write to this after the exception is raise to - improve its error message. - - """ - - order = 4 - head = ( - "THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS " - "FILE. If you have updated the package versions, please update " - "the hashes. Otherwise, examine the package contents carefully; " - "someone may have tampered with them." - ) - - def __init__(self, allowed: dict[str, list[str]], gots: dict[str, _Hash]) -> None: - """ - :param allowed: A dict of algorithm names pointing to lists of allowed - hex digests - :param gots: A dict of algorithm names pointing to hashes we - actually got from the files under suspicion - """ - self.allowed = allowed - self.gots = gots - - def body(self) -> str: - return f" {self._requirement_name()}:\n{self._hash_comparison()}" - - def _hash_comparison(self) -> str: - """ - Return a comparison of actual and expected hash values. - - Example:: - - Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde - or 123451234512345123451234512345123451234512345 - Got bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef - - """ - - def hash_then_or(hash_name: str) -> chain[str]: - # For now, all the decent hashes have 6-char names, so we can get - # away with hard-coding space literals. - return chain([hash_name], repeat(" or")) - - lines: list[str] = [] - for hash_name, expecteds in self.allowed.items(): - prefix = hash_then_or(hash_name) - lines.extend((f" Expected {next(prefix)} {e}") for e in expecteds) - lines.append( - f" Got {self.gots[hash_name].hexdigest()}\n" - ) - return "\n".join(lines) - - -class UnsupportedPythonVersion(InstallationError): - """Unsupported python version according to Requires-Python package - metadata.""" - - -class ConfigurationFileCouldNotBeLoaded(ConfigurationError): - """When there are errors while loading a configuration file""" - - def __init__( - self, - reason: str = "could not be loaded", - fname: str | None = None, - error: configparser.Error | None = None, - ) -> None: - super().__init__(error) - self.reason = reason - self.fname = fname - self.error = error - - def __str__(self) -> str: - if self.fname is not None: - message_part = f" in {self.fname}." - else: - assert self.error is not None - message_part = f".\n{self.error}\n" - return f"Configuration file {self.reason}{message_part}" - - -_DEFAULT_EXTERNALLY_MANAGED_ERROR = f"""\ -The Python environment under {sys.prefix} is managed externally, and may not be -manipulated by the user. Please use specific tooling from the distributor of -the Python installation to interact with this environment instead. -""" - - -class ExternallyManagedEnvironment(DiagnosticPipError): - """The current environment is externally managed. - - This is raised when the current environment is externally managed, as - defined by `PEP 668`_. The ``EXTERNALLY-MANAGED`` configuration is checked - and displayed when the error is bubbled up to the user. - - :param error: The error message read from ``EXTERNALLY-MANAGED``. - """ - - reference = "externally-managed-environment" - - def __init__(self, error: str | None) -> None: - if error is None: - context = Text(_DEFAULT_EXTERNALLY_MANAGED_ERROR) - else: - context = Text(error) - super().__init__( - message="This environment is externally managed", - context=context, - note_stmt=( - "If you believe this is a mistake, please contact your " - "Python installation or OS distribution provider. " - "You can override this, at the risk of breaking your Python " - "installation or OS, by passing --break-system-packages." - ), - hint_stmt=Text("See PEP 668 for the detailed specification."), - ) - - @staticmethod - def _iter_externally_managed_error_keys() -> Iterator[str]: - # LC_MESSAGES is in POSIX, but not the C standard. The most common - # platform that does not implement this category is Windows, where - # using other categories for console message localization is equally - # unreliable, so we fall back to the locale-less vendor message. This - # can always be re-evaluated when a vendor proposes a new alternative. - try: - category = locale.LC_MESSAGES - except AttributeError: - lang: str | None = None - else: - lang, _ = locale.getlocale(category) - if lang is not None: - yield f"Error-{lang}" - for sep in ("-", "_"): - before, found, _ = lang.partition(sep) - if not found: - continue - yield f"Error-{before}" - yield "Error" - - @classmethod - def from_config( - cls, - config: pathlib.Path | str, - ) -> ExternallyManagedEnvironment: - parser = configparser.ConfigParser(interpolation=None) - try: - parser.read(config, encoding="utf-8") - section = parser["externally-managed"] - for key in cls._iter_externally_managed_error_keys(): - with contextlib.suppress(KeyError): - return cls(section[key]) - except KeyError: - pass - except (OSError, UnicodeDecodeError, configparser.ParsingError): - from pip._internal.utils._log import VERBOSE - - exc_info = logger.isEnabledFor(VERBOSE) - logger.warning("Failed to read %s", config, exc_info=exc_info) - return cls(None) - - -class UninstallMissingRecord(DiagnosticPipError): - reference = "uninstall-no-record-file" - - def __init__(self, *, distribution: BaseDistribution) -> None: - installer = distribution.installer - if not installer or installer == "pip": - dep = f"{distribution.raw_name}=={distribution.version}" - hint = Text.assemble( - "You might be able to recover from this via: ", - (f"pip install --force-reinstall --no-deps {dep}", "green"), - ) - else: - hint = Text( - f"The package was installed by {installer}. " - "You should check if it can uninstall the package." - ) - - super().__init__( - message=Text(f"Cannot uninstall {distribution}"), - context=( - "The package's contents are unknown: " - f"no RECORD file was found for {distribution.raw_name}." - ), - hint_stmt=hint, - ) - - -class LegacyDistutilsInstall(DiagnosticPipError): - reference = "uninstall-distutils-installed-package" - - def __init__(self, *, distribution: BaseDistribution) -> None: - super().__init__( - message=Text(f"Cannot uninstall {distribution}"), - context=( - "It is a distutils installed project and thus we cannot accurately " - "determine which files belong to it which would lead to only a partial " - "uninstall." - ), - hint_stmt=None, - ) - - -class InvalidInstalledPackage(DiagnosticPipError): - reference = "invalid-installed-package" - - def __init__( - self, - *, - dist: BaseDistribution, - invalid_exc: InvalidRequirement | InvalidVersion, - ) -> None: - installed_location = dist.installed_location - - if isinstance(invalid_exc, InvalidRequirement): - invalid_type = "requirement" - else: - invalid_type = "version" - - super().__init__( - message=Text( - f"Cannot process installed package {dist} " - + (f"in {installed_location!r} " if installed_location else "") - + f"because it has an invalid {invalid_type}:\n{invalid_exc.args[0]}" - ), - context=( - "Starting with pip 24.1, packages with invalid " - f"{invalid_type}s can not be processed." - ), - hint_stmt="To proceed this package must be uninstalled.", - ) - - -class IncompleteDownloadError(DiagnosticPipError): - """Raised when the downloader receives fewer bytes than advertised - in the Content-Length header.""" - - reference = "incomplete-download" - - def __init__(self, download: _FileDownload) -> None: - # Dodge circular import. - from pip._internal.utils.misc import format_size - - assert download.size is not None - download_status = ( - f"{format_size(download.bytes_received)}/{format_size(download.size)}" - ) - if download.reattempts: - retry_status = f"after {download.reattempts + 1} attempts " - hint = "Use --resume-retries to configure resume attempt limit." - else: - # Download retrying is not enabled. - retry_status = "" - hint = "Consider using --resume-retries to enable download resumption." - message = Text( - f"Download failed {retry_status}because not enough bytes " - f"were received ({download_status})" - ) - - super().__init__( - message=message, - context=f"URL: {download.link.redacted_url}", - hint_stmt=hint, - note_stmt="This is an issue with network connectivity, not pip.", - ) - - -class ResolutionTooDeepError(DiagnosticPipError): - """Raised when the dependency resolver exceeds the maximum recursion depth.""" - - reference = "resolution-too-deep" - - def __init__(self) -> None: - super().__init__( - message="Dependency resolution exceeded maximum depth", - context=( - "Pip cannot resolve the current dependencies as the dependency graph " - "is too complex for pip to solve efficiently." - ), - hint_stmt=( - "Try adding lower bounds to constrain your dependencies, " - "for example: 'package>=2.0.0' instead of just 'package'. " - ), - link="https://pip.pypa.io/en/stable/topics/dependency-resolution/#handling-resolution-too-deep-errors", - ) - - -class InstallWheelBuildError(DiagnosticPipError): - reference = "failed-wheel-build-for-install" - - def __init__(self, failed: list[InstallRequirement]) -> None: - super().__init__( - message=( - "Failed to build installable wheels for some " - "pyproject.toml based projects" - ), - context=", ".join(r.name for r in failed), # type: ignore - hint_stmt=None, - ) - - -class InvalidEggFragment(DiagnosticPipError): - reference = "invalid-egg-fragment" - - def __init__(self, link: Link, fragment: str) -> None: - hint = "" - if ">" in fragment or "=" in fragment or "<" in fragment: - hint = ( - "Version specifiers are silently ignored for URL references. " - "Remove them. " - ) - if "[" in fragment and "]" in fragment: - hint += "Try using the Direct URL requirement syntax: 'name[extra] @ URL'" - - if not hint: - hint = "Egg fragments can only be a valid project name." - - super().__init__( - message=f"The '{escape(fragment)}' egg fragment is invalid", - context=f"from '{escape(str(link))}'", - hint_stmt=escape(hint), - ) - - -class BuildDependencyInstallError(DiagnosticPipError): - """Raised when build dependencies cannot be installed.""" - - reference = "failed-build-dependency-install" - - def __init__( - self, - req: InstallRequirement | None, - build_reqs: Iterable[str], - *, - cause: Exception, - log_lines: list[str] | None, - ) -> None: - if isinstance(cause, PipError): - note = "This is likely not a problem with pip." - else: - note = ( - "pip crashed unexpectedly. Please file an issue on pip's issue " - "tracker: https://github.com/pypa/pip/issues/new" - ) - - if log_lines is None: - # No logs are available, they must have been printed earlier. - context = Text("See above for more details.") - else: - if isinstance(cause, PipError): - log_lines.append(f"ERROR: {cause}") - else: - # Split rendered error into real lines without trailing newlines. - log_lines.extend( - "".join(traceback.format_exception(cause)).splitlines() - ) - - context = Text.assemble( - f"Installing {' '.join(build_reqs)}\n", - (f"[{len(log_lines)} lines of output]\n", "red"), - "\n".join(log_lines), - ("\n[end of output]", "red"), - ) - - message = Text("Cannot install build dependencies", "green") - if req: - message += Text(f" for {req}") - super().__init__( - message=message, context=context, hint_stmt=None, note_stmt=note - ) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/index/collector.py b/.venv/lib/python3.14/site-packages/pip/_internal/index/collector.py index a9a8dde..a77c398 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/index/collector.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/index/collector.py @@ -12,21 +12,27 @@ import json import logging import os import urllib.parse -from collections.abc import Iterable, MutableMapping, Sequence +from collections.abc import Callable, Iterable, MutableMapping, Sequence from dataclasses import dataclass from html.parser import HTMLParser from optparse import Values from typing import ( - Callable, NamedTuple, Protocol, ) -from pip._vendor import requests +from pip._vendor.packaging.utils import canonicalize_name from pip._vendor.requests import Response -from pip._vendor.requests.exceptions import RetryError, SSLError +from pip._vendor.requests.exceptions import RetryError -from pip._internal.exceptions import NetworkConnectionError +from pip._internal.exceptions import ( + ConnectionFailedError, + ConnectionTimeoutError, + NetworkConnectionError, + ProxyConnectionError, + SSLMissingError, + SSLVerificationError, +) from pip._internal.models.link import Link from pip._internal.models.search_scope import SearchScope from pip._internal.network.session import PipSession @@ -80,7 +86,7 @@ def _ensure_api_header(response: Response) -> None: ): return - raise _NotAPIContent(content_type, response.request.method) + raise _NotAPIContent(content_type, response.request.method) # type: ignore[arg-type] class _NotHTTP(Exception): @@ -105,7 +111,11 @@ def _ensure_api_response(url: str, session: PipSession) -> None: _ensure_api_header(resp) -def _get_simple_response(url: str, session: PipSession) -> Response: +def _get_simple_response( + url: str, + session: PipSession, + force_revalidate: bool = False, +) -> Response: """Access an Simple API response with GET, and return the response. This consists of three parts: @@ -123,32 +133,24 @@ def _get_simple_response(url: str, session: PipSession) -> Response: logger.debug("Getting page %s", redact_auth_from_url(url)) - resp = session.get( - url, - headers={ - "Accept": ", ".join( - [ - "application/vnd.pypi.simple.v1+json", - "application/vnd.pypi.simple.v1+html; q=0.1", - "text/html; q=0.01", - ] - ), - # We don't want to blindly returned cached data for - # /simple/, because authors generally expecting that - # twine upload && pip install will function, but if - # they've done a pip install in the last ~10 minutes - # it won't. Thus by setting this to zero we will not - # blindly use any cached data, however the benefit of - # using max-age=0 instead of no-cache, is that we will - # still support conditional requests, so we will still - # minimize traffic sent in cases where the page hasn't - # changed at all, we will just always incur the round - # trip for the conditional GET now instead of only - # once per 10 minutes. - # For more information, please see pypa/pip#5670. - "Cache-Control": "max-age=0", - }, - ) + headers = { + "Accept": ", ".join( + [ + "application/vnd.pypi.simple.v1+json", + "application/vnd.pypi.simple.v1+html; q=0.1", + "text/html; q=0.01", + ] + ), + } + + if force_revalidate: + # Using max-age=0 rather than no-cache still supports conditional + # requests, minimizing traffic when the page hasn't changed. + # See pypa/pip#5670. + logger.debug("Refreshing package index response.") + headers["Cache-Control"] = "max-age=0" + + resp = session.get(url, headers=headers) raise_for_status(resp) # The check for archives above only works if the url ends with @@ -316,7 +318,12 @@ def _make_index_content( ) -def _get_index_content(link: Link, *, session: PipSession) -> IndexContent | None: +def _get_index_content( + link: Link, + *, + session: PipSession, + force_revalidate: bool = False, +) -> IndexContent | None: url = link.url.split("#", 1)[0] # Check for VCS schemes that do not support lookup as web pages. @@ -343,7 +350,9 @@ def _get_index_content(link: Link, *, session: PipSession) -> IndexContent | Non logger.debug(" file: URL is directory, getting %s", url) try: - resp = _get_simple_response(url, session=session) + resp = _get_simple_response( + url, session=session, force_revalidate=force_revalidate + ) except _NotHTTP: logger.warning( "Skipping page %s because it looks like an archive, and cannot " @@ -359,18 +368,17 @@ def _get_index_content(link: Link, *, session: PipSession) -> IndexContent | Non exc.request_desc, exc.content_type, ) - except NetworkConnectionError as exc: + except (RetryError, NetworkConnectionError) as exc: _handle_get_simple_fail(link, exc) - except RetryError as exc: - _handle_get_simple_fail(link, exc) - except SSLError as exc: - reason = "There was a problem confirming the ssl certificate: " - reason += str(exc) + except (SSLVerificationError, SSLMissingError) as exc: + reason = f"There was a problem confirming the ssl certificate: {exc.context}" _handle_get_simple_fail(link, reason, meth=logger.info) - except requests.ConnectionError as exc: - _handle_get_simple_fail(link, f"connection error: {exc}") - except requests.Timeout: - _handle_get_simple_fail(link, "timed out") + except ConnectionFailedError as exc: + _handle_get_simple_fail(link, f"connection error: {exc.context}") + except ProxyConnectionError as exc: + _handle_get_simple_fail(link, f"proxy connection error: {exc.context}") + except ConnectionTimeoutError as exc: + _handle_get_simple_fail(link, str(exc.context)) else: return _make_index_content(resp, cache_link_parsing=link.cache_link_parsing) return None @@ -435,11 +443,25 @@ class LinkCollector: def find_links(self) -> list[str]: return self.search_scope.find_links - def fetch_response(self, location: Link) -> IndexContent | None: + def fetch_response( + self, location: Link, package_name: str | None = None + ) -> IndexContent | None: """ Fetch an HTML page containing package links. """ - return _get_index_content(location, session=self.session) + # By default we may return cached /simple/ responses. Users can force + # revalidation to ensure newly uploaded distributions become visible + # immediately after publication. See pypa/pip#5670. + force_revalidate = self.session.refresh_package + should_force_revalidate = ":all:" in force_revalidate or ( + package_name is not None + and canonicalize_name(package_name) in force_revalidate + ) + return _get_index_content( + location, + session=self.session, + force_revalidate=should_force_revalidate, + ) def collect_sources( self, diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/index/package_finder.py b/.venv/lib/python3.14/site-packages/pip/_internal/index/package_finder.py index aa7c2eb..09cf0ac 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/index/package_finder.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/index/package_finder.py @@ -12,14 +12,12 @@ from collections.abc import Iterable from dataclasses import dataclass from typing import ( TYPE_CHECKING, - Optional, - Union, ) from pip._vendor.packaging import specifiers from pip._vendor.packaging.tags import Tag from pip._vendor.packaging.utils import NormalizedName, canonicalize_name -from pip._vendor.packaging.version import InvalidVersion, Version, _BaseVersion +from pip._vendor.packaging.version import InvalidVersion, _BaseVersion from pip._vendor.packaging.version import parse as parse_version from pip._internal.exceptions import ( @@ -49,15 +47,15 @@ from pip._internal.utils.packaging import check_requires_python from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS if TYPE_CHECKING: - from typing_extensions import TypeGuard + from typing import TypeGuard __all__ = ["FormatControl", "BestCandidateResult", "PackageFinder"] logger = getLogger(__name__) -BuildTag = Union[tuple[()], tuple[int, str]] -CandidateSortingKey = tuple[int, int, int, _BaseVersion, Optional[int], BuildTag] +BuildTag = tuple[()] | tuple[int, str] +CandidateSortingKey = tuple[int, int, int, _BaseVersion, int | None, BuildTag] def _check_link_requires_python( @@ -137,7 +135,7 @@ class LinkEvaluator: formats: frozenset[str], target_python: TargetPython, allow_yanked: bool, - ignore_requires_python: bool | None = None, + ignore_requires_python: bool = False, uploaded_prior_to: datetime.datetime | None = None, ) -> None: """ @@ -159,8 +157,6 @@ class LinkEvaluator: :param uploaded_prior_to: If set, only allow links uploaded prior to the given datetime. """ - if ignore_requires_python is None: - ignore_requires_python = False self._allow_yanked = allow_yanked self._canonical_name = canonical_name @@ -493,7 +489,6 @@ class CandidateEvaluator: else: allow_prereleases = None specifier = self._specifier - # When using the pkg_resources backend we turn the version object into # a str here because otherwise when we're debundled but setuptools isn't, # Python will see packaging.version.Version and @@ -501,22 +496,17 @@ class CandidateEvaluator: # types. This way we'll use a str as a common data interchange # format. If we stop using the pkg_resources provided specifier # and start using our own, we can drop the cast to str(). - if select_backend().NAME == "pkg_resources": - candidates_and_versions: list[ - tuple[InstallationCandidate, str | Version] - ] = [(c, str(c.version)) for c in candidates] - else: - candidates_and_versions = [(c, c.version) for c in candidates] - versions = set( - specifier.filter( - (v for _, v in candidates_and_versions), - prereleases=allow_prereleases, - ) + applicable_candidates = specifier.filter( + candidates, + prereleases=allow_prereleases, + key=lambda c: ( + str(c.version) + if select_backend().NAME == "pkg_resources" + else c.version + ), ) - - applicable_candidates = [c for c, v in candidates_and_versions if v in versions] filtered_applicable_candidates = filter_unallowed_hashes( - candidates=applicable_candidates, + candidates=list(applicable_candidates), hashes=self._hashes, project_name=self._project_name, ) @@ -633,7 +623,7 @@ class PackageFinder: allow_yanked: bool, format_control: FormatControl | None = None, candidate_prefs: CandidatePreferences | None = None, - ignore_requires_python: bool | None = None, + ignore_requires_python: bool = False, uploaded_prior_to: datetime.datetime | None = None, ) -> None: """ @@ -660,8 +650,10 @@ class PackageFinder: self.format_control = format_control - # These are boring links that have already been logged somehow. - self._logged_links: set[tuple[Link, LinkType, str]] = set() + # Collects the detail strings for links skipped due to Requires-Python + # incompatibility. Used by requires_python_skipped_reasons() to build + # the error message when resolution fails. + self._requires_python_skipped: set[str] = set() # Cache of the result of finding candidates self._all_candidates: dict[str, list[InstallationCandidate]] = {} @@ -670,6 +662,9 @@ class PackageFinder: BestCandidateResult, ] = {} + # projects for which a link is locked from a pylock + self._locked_links: dict[NormalizedName, Link] = {} + # Don't include an allow_yanked default value to make sure each call # site considers whether yanked releases are allowed. This also causes # that decision to be made explicit in the calling code, which helps @@ -730,10 +725,18 @@ class PackageFinder: def index_urls(self) -> list[str]: return self.search_scope.index_urls + @property + def refresh_package(self) -> set[str]: + return self._link_collector.session.refresh_package + @property def proxy(self) -> str | None: return self._link_collector.session.pip_proxy + @property + def no_proxy_env(self) -> bool: + return self._link_collector.session.pip_no_proxy_env + @property def trusted_hosts(self) -> Iterable[str]: for host_port in self._link_collector.session.pip_trusted_origins: @@ -772,12 +775,7 @@ class PackageFinder: return self._uploaded_prior_to def requires_python_skipped_reasons(self) -> list[str]: - reasons = { - detail - for _, result, detail in self._logged_links - if result == LinkType.requires_python_mismatch - } - return sorted(reasons) + return sorted(self._requires_python_skipped) def make_link_evaluator(self, project_name: str) -> LinkEvaluator: canonical_name = canonicalize_name(project_name) @@ -810,12 +808,11 @@ class PackageFinder: return no_eggs + eggs def _log_skipped_link(self, link: Link, result: LinkType, detail: str) -> None: - entry = (link, result, detail) - if entry not in self._logged_links: - # Put the link at the end so the reason is more visible and because - # the link string is usually very long. - logger.debug("Skipping link: %s: %s", detail, link) - self._logged_links.add(entry) + # Put the link at the end so the reason is more visible and because + # the link string is usually very long. + logger.debug("Skipping link: %s: %s", detail, link) + if result == LinkType.requires_python_mismatch: + self._requires_python_skipped.add(detail) def get_install_candidate( self, link_evaluator: LinkEvaluator, link: Link @@ -863,7 +860,9 @@ class PackageFinder: "Fetching project page and analyzing links: %s", project_url, ) - index_response = self._link_collector.fetch_response(project_url) + index_response = self._link_collector.fetch_response( + project_url, package_name=link_evaluator.project_name + ) if index_response is None: return [] @@ -880,7 +879,8 @@ class PackageFinder: def find_all_candidates(self, project_name: str) -> list[InstallationCandidate]: """Find all available InstallationCandidate for project_name - This checks index_urls and find_links. + This checks index_urls and find_links, unless a locked link is known + for that project. All versions found are returned as an InstallationCandidate list. See LinkEvaluator.evaluate_link() for details on which files @@ -891,6 +891,23 @@ class PackageFinder: link_evaluator = self.make_link_evaluator(project_name) + if locked_link := self._locked_links.get(canonicalize_name(project_name)): + # If a locked link is known for that project, do not check + # index_urls nor find_links. We don't use get_install_candidate here, + # because if a locked link is unsupported (due to format control, + # release control or otherwise), we want to error out immediately + # instead of ignoring it. + result, detail = link_evaluator.evaluate_link(locked_link) + if result != LinkType.candidate: + raise InstallationError( + f"Could not install locked package {project_name!r} " + f"from {locked_link.comes_from!r}: {detail}" + ) + self._all_candidates[project_name] = [ + InstallationCandidate(project_name, detail, locked_link, locked=True) + ] + return self._all_candidates[project_name] + collected_sources = self._link_collector.collect_sources( project_name=project_name, candidates_from_page=functools.partial( @@ -1028,16 +1045,16 @@ class PackageFinder: ) if allows_pre is False: version_type = "final version" - + req_disp = req.format_without_marker() logger.critical( "Could not find a %s that satisfies the requirement %s " "(from versions: %s)", version_type, - req, + req_disp, _format_versions(best_candidate_result.all_candidates), ) - raise DistributionNotFound(f"No matching distribution found for {req}") + raise DistributionNotFound(f"No matching distribution found for {req_disp}") def _should_install_candidate( candidate: InstallationCandidate | None, @@ -1080,6 +1097,16 @@ class PackageFinder: ) raise BestVersionAlreadyInstalled + def add_locked_link(self, project_name: NormalizedName, locked_link: Link) -> None: + assert not self._all_candidates + if project_name in self._locked_links: + raise InstallationError( + f"Multiple locked links provided for {project_name}: " + f"{self._locked_links[project_name]} and {locked_link}" + ) + + self._locked_links[project_name] = locked_link + def _find_name_version_sep(fragment: str, canonical_name: str) -> int: """Find the separator's index based on the package's canonical name. diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/index/sources.py b/.venv/lib/python3.14/site-packages/pip/_internal/index/sources.py index c67c4d7..6e7c007 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/index/sources.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/index/sources.py @@ -4,8 +4,7 @@ import logging import mimetypes import os from collections import defaultdict -from collections.abc import Iterable -from typing import Callable +from collections.abc import Callable, Iterable from pip._vendor.packaging.utils import ( InvalidSdistFilename, diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/locations/__init__.py b/.venv/lib/python3.14/site-packages/pip/_internal/locations/__init__.py index c0b6320..ec15d1d 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/locations/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/locations/__init__.py @@ -41,13 +41,11 @@ logger = logging.getLogger(__name__) _PLATLIBDIR: str = getattr(sys, "platlibdir", "lib") -_USE_SYSCONFIG_DEFAULT = sys.version_info >= (3, 10) - def _should_use_sysconfig() -> bool: """This function determines the value of _USE_SYSCONFIG. - By default, pip uses sysconfig on Python 3.10+. + By default, pip uses sysconfig. But Python distributors can override this decision by setting: sysconfig._PIP_USE_SYSCONFIG = True / False Rationale in https://github.com/pypa/pip/issues/10647 @@ -55,7 +53,7 @@ def _should_use_sysconfig() -> bool: This is a function for testability, but should be constant during any one run. """ - return bool(getattr(sysconfig, "_PIP_USE_SYSCONFIG", _USE_SYSCONFIG_DEFAULT)) + return bool(getattr(sysconfig, "_PIP_USE_SYSCONFIG", True)) _USE_SYSCONFIG = _should_use_sysconfig() @@ -68,10 +66,10 @@ if not _USE_SYSCONFIG: # Be noisy about incompatibilities if this platforms "should" be using # sysconfig, but is explicitly opting out and using distutils instead. -if _USE_SYSCONFIG_DEFAULT and not _USE_SYSCONFIG: - _MISMATCH_LEVEL = logging.WARNING -else: +if _USE_SYSCONFIG: _MISMATCH_LEVEL = logging.DEBUG +else: + _MISMATCH_LEVEL = logging.WARNING def _looks_like_bpo_44860() -> bool: @@ -281,7 +279,7 @@ def get_scheme( if k == "platlib" and _looks_like_red_hat_lib(): continue - # On Python 3.9+, sysconfig's posix_user scheme sets platlib against + # sysconfig's posix_user scheme sets platlib against # sys.platlibdir, but distutils's unix_user incorrectly continues # using the same $usersite for both platlib and purelib. This creates a # mismatch when sys.platlibdir is not "lib". diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/locations/_distutils.py b/.venv/lib/python3.14/site-packages/pip/_internal/locations/_distutils.py index 28c066b..cf4e4c0 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/locations/_distutils.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/locations/_distutils.py @@ -20,11 +20,10 @@ import logging import os import sys from distutils.cmd import Command as DistutilsCommand -from distutils.command.install import SCHEME_KEYS from distutils.command.install import install as distutils_install_command from distutils.sysconfig import get_python_lib -from pip._internal.models.scheme import Scheme +from pip._internal.models.scheme import SCHEME_KEYS, Scheme from pip._internal.utils.compat import WINDOWS from pip._internal.utils.virtualenv import running_under_virtualenv diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/locations/_sysconfig.py b/.venv/lib/python3.14/site-packages/pip/_internal/locations/_sysconfig.py index 0d0233b..ceea4b1 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/locations/_sysconfig.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/locations/_sysconfig.py @@ -4,7 +4,7 @@ import logging import os import sys import sysconfig -from typing import Callable +from collections.abc import Callable from pip._internal.exceptions import InvalidSchemeCombination, UserInstallationInvalid from pip._internal.models.scheme import SCHEME_KEYS, Scheme @@ -158,6 +158,14 @@ def get_scheme( else: scheme_name = _infer_prefix() + # Special case: When installing into a custom prefix, use posix_prefix + # instead of posix_local because it should *only* be used to redirecting + # to /usr/local for system packager installs. Notably, posix_local is used + # on Debian and its derivatives. + # See also: https://discuss.python.org/t/18240 + if prefix is not None and scheme_name == "posix_local": + scheme_name = "posix_prefix" + # Special case: When installing into a custom prefix, use posix_prefix # instead of osx_framework_library. See _should_use_osx_framework_prefix() # docstring for details. diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/locations/base.py b/.venv/lib/python3.14/site-packages/pip/_internal/locations/base.py index 17cd0e8..f8d13cd 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/locations/base.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/locations/base.py @@ -41,7 +41,7 @@ def change_root(new_root: str, pathname: str) -> str: return os.path.join(new_root, pathname[1:]) elif os.name == "nt": - (drive, path) = os.path.splitdrive(pathname) + drive, path = os.path.splitdrive(pathname) if path[0] == "\\": path = path[1:] return os.path.join(new_root, path) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/__init__.py b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/__init__.py index 1c24efc..94be340 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/__init__.py @@ -80,7 +80,7 @@ def _emit_pkg_resources_deprecation_if_needed() -> None: "to use the default importlib.metadata backend, " "by unsetting the _PIP_USE_IMPORTLIB_METADATA environment variable" ), - gone_in="26.3", + gone_in="27.0", issue=13317, ) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/base.py b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/base.py index 230e114..50947c2 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/base.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/base.py @@ -14,7 +14,6 @@ from typing import ( Any, NamedTuple, Protocol, - Union, ) from pip._vendor.packaging.requirements import Requirement @@ -29,14 +28,21 @@ from pip._internal.models.direct_url import ( DirectUrl, DirectUrlValidationError, ) -from pip._internal.utils.compat import stdlib_pkgs # TODO: Move definition here. from pip._internal.utils.egg_link import egg_link_path_from_sys_path from pip._internal.utils.misc import is_local, normalize_path from pip._internal.utils.urls import url_to_path from ._json import msg_to_json -InfoPath = Union[str, pathlib.PurePath] +# packages in the stdlib that may have installation metadata, but should not be +# considered 'installed'. this theoretically could be determined based on +# dist.location (py27:`sysconfig.get_paths()['stdlib']`, +# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may +# make this ineffective, so hard-coding +stdlib_pkgs = {"python", "wsgiref", "argparse"} + + +InfoPath = str | pathlib.PurePath logger = logging.getLogger(__name__) @@ -152,14 +158,13 @@ class BaseDistribution(Protocol): """ raise NotImplementedError() - @property + @functools.cached_property def editable_project_location(self) -> str | None: """The project location for editable distributions. This is the directory where pyproject.toml or setup.py is located. None if the distribution is not installed in editable mode. """ - # TODO: this property is relatively costly to compute, memoize it ? direct_url = self.direct_url if direct_url: if direct_url.is_local_editable(): @@ -617,11 +622,29 @@ class BaseEnvironment: flags=re.IGNORECASE, ) if not project_name_valid: - logger.warning( - "Ignoring invalid distribution %s (%s)", - dist.canonical_name, - dist.location, + # Check the directory name rather than the distribution name, + # since the pkg_resources (default below 3.11) backend normalizes + # the leading tilde to a dash. + # TODO: use dist.canonical_name for this check once + # pkg_resources support is dropped (#13317). + info_location = dist.info_location + leftover_name = ( + pathlib.Path(info_location).name if info_location else "" ) + if leftover_name.startswith("~"): + logger.warning( + "Ignoring incompletely removed distribution %s (%s); " + "'~'-prefixed leftover directories are the result of a " + "previous incomplete installation, and can be deleted", + leftover_name, + dist.location, + ) + else: + logger.warning( + "Ignoring invalid distribution %s (%s)", + dist.canonical_name, + dist.location, + ) continue yield dist diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_dists.py b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_dists.py index 89364b8..2fb3e04 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_dists.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_dists.py @@ -15,7 +15,7 @@ from pip._vendor.packaging.utils import NormalizedName, canonicalize_name from pip._vendor.packaging.version import Version from pip._vendor.packaging.version import parse as parse_version -from pip._internal.exceptions import InvalidWheel, UnsupportedWheel +from pip._internal.exceptions import InstallationError, InvalidWheel, UnsupportedWheel from pip._internal.metadata.base import ( BaseDistribution, BaseEntryPoint, @@ -177,7 +177,7 @@ class Distribution(BaseDistribution): @property def raw_version(self) -> str: - return self._dist.version + return self.metadata["Version"] def is_file(self, path: InfoPath) -> bool: return self._dist.read_text(str(path)) is not None @@ -199,7 +199,13 @@ class Distribution(BaseDistribution): def iter_entry_points(self) -> Iterable[BaseEntryPoint]: # importlib.metadata's EntryPoint structure satisfies BaseEntryPoint. - return self._dist.entry_points + try: + return self._dist.entry_points + except ValueError as e: + # Python 3.15+ validates entry points while parsing. + raise InstallationError( + f"Error parsing entry points for {self.raw_name}: {e}" + ) from e def _metadata_impl(self) -> email.message.Message: # From Python 3.10+, importlib.metadata declares PackageMetadata as the @@ -207,7 +213,13 @@ class Distribution(BaseDistribution): # a ton of fields that we need, including get() and get_payload(). We # rely on the implementation that the object is actually a Message now, # until upstream can improve the protocol. (python/cpython#94952) - return cast(email.message.Message, self._dist.metadata) + metadata = self._dist.metadata + # From Python 3.15+, importlib.metadata may return None when no + # metadata file (METADATA or PKG-INFO) exists in the distribution + # directory. (python/cpython#132947) + if metadata is None: + return email.message.Message() + return cast(email.message.Message, metadata) def iter_provided_extras(self) -> Iterable[NormalizedName]: return [ diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_envs.py b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_envs.py index 71a73b7..be732a9 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_envs.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/importlib/_envs.py @@ -7,7 +7,6 @@ import pathlib import sys import zipfile from collections.abc import Iterator, Sequence -from typing import Optional from pip._vendor.packaging.utils import ( InvalidWheelFilename, @@ -24,6 +23,10 @@ from ._dists import Distribution logger = logging.getLogger(__name__) +# Used to avoid emitting duplicate invalid distribution metadata warnings for +# the same dist-info directory. +_warned_bad_metadata: set[BasePath | None] = set() + def _looks_like_wheel(location: str) -> bool: if not location.endswith(WHEEL_EXTENSION): @@ -50,7 +53,7 @@ class _DistributionFinder: installations as well. It's useful feature, after all. """ - FoundResult = tuple[importlib.metadata.Distribution, Optional[BasePath]] + FoundResult = tuple[importlib.metadata.Distribution, BasePath | None] def __init__(self) -> None: self._found_names: set[NormalizedName] = set() @@ -69,7 +72,9 @@ class _DistributionFinder: try: name = get_dist_canonical_name(dist) except BadMetadata as e: - logger.warning("Skipping %s due to %s", info_location, e.reason) + if info_location not in _warned_bad_metadata: + logger.warning("Skipping %s due to %s", info_location, e.reason) + _warned_bad_metadata.add(info_location) continue if name in self._found_names: continue diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/pkg_resources.py b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/pkg_resources.py index 89fce8b..6e77744 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/metadata/pkg_resources.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/metadata/pkg_resources.py @@ -16,7 +16,12 @@ from pip._vendor.packaging.utils import NormalizedName, canonicalize_name from pip._vendor.packaging.version import Version from pip._vendor.packaging.version import parse as parse_version -from pip._internal.exceptions import InvalidWheel, NoneMetadataError, UnsupportedWheel +from pip._internal.exceptions import ( + InstallationError, + InvalidWheel, + NoneMetadataError, + UnsupportedWheel, +) from pip._internal.utils.egg_link import egg_link_path_from_location from pip._internal.utils.misc import display_path, normalize_path from pip._internal.utils.wheel import parse_wheel, read_wheel_metadata_file @@ -208,7 +213,13 @@ class Distribution(BaseDistribution): return content def iter_entry_points(self) -> Iterable[BaseEntryPoint]: - for group, entries in self._dist.get_entry_map().items(): + try: + entry_map = self._dist.get_entry_map() + except ValueError as e: + raise InstallationError( + f"Error parsing entry points for {self.raw_name}: {e}" + ) from e + for group, entries in entry_map.items(): for name, entry_point in entries.items(): name, _, value = str(entry_point).partition("=") yield EntryPoint(name=name.strip(), value=value.strip(), group=group) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/candidate.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/candidate.py index f27f283..0639466 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/candidate.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/candidate.py @@ -6,20 +6,22 @@ from pip._vendor.packaging.version import parse as parse_version from pip._internal.models.link import Link -@dataclass(frozen=True) +@dataclass(frozen=True, slots=True) class InstallationCandidate: """Represents a potential "candidate" for installation.""" - __slots__ = ["name", "version", "link"] - name: str version: Version link: Link + locked: bool - def __init__(self, name: str, version: str, link: Link) -> None: + def __init__( + self, name: str, version: str, link: Link, locked: bool = False + ) -> None: object.__setattr__(self, "name", name) object.__setattr__(self, "version", parse_version(version)) object.__setattr__(self, "link", link) + object.__setattr__(self, "locked", locked) def __str__(self) -> str: return f"{self.name!r} candidate (version {self.version} at {self.link})" diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/direct_url.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/direct_url.py index aefc670..a2dfb34 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/direct_url.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/direct_url.py @@ -3,225 +3,40 @@ from __future__ import annotations import json -import re -import urllib.parse -from collections.abc import Iterable -from dataclasses import dataclass -from typing import Any, ClassVar, TypeVar, Union +from typing import Any + +from pip._vendor.packaging.direct_url import ( + ArchiveInfo, + DirectUrlValidationError, + DirInfo, + VcsInfo, +) +from pip._vendor.packaging.direct_url import ( + DirectUrl as PackagingDirectUrl, +) __all__ = [ + "ArchiveInfo", + "DirInfo", "DirectUrl", "DirectUrlValidationError", - "DirInfo", - "ArchiveInfo", + "DIRECT_URL_METADATA_NAME", "VcsInfo", ] -T = TypeVar("T") - DIRECT_URL_METADATA_NAME = "direct_url.json" -ENV_VAR_RE = re.compile(r"^\$\{[A-Za-z0-9-_]+\}(:\$\{[A-Za-z0-9-_]+\})?$") -class DirectUrlValidationError(Exception): - pass - - -def _get( - d: dict[str, Any], expected_type: type[T], key: str, default: T | None = None -) -> T | None: - """Get value from dictionary and verify expected type.""" - if key not in d: - return default - value = d[key] - if not isinstance(value, expected_type): - raise DirectUrlValidationError( - f"{value!r} has unexpected type for {key} (expected {expected_type})" - ) - return value - - -def _get_required( - d: dict[str, Any], expected_type: type[T], key: str, default: T | None = None -) -> T: - value = _get(d, expected_type, key, default) - if value is None: - raise DirectUrlValidationError(f"{key} must have a value") - return value - - -def _exactly_one_of(infos: Iterable[InfoType | None]) -> InfoType: - infos = [info for info in infos if info is not None] - if not infos: - raise DirectUrlValidationError( - "missing one of archive_info, dir_info, vcs_info" - ) - if len(infos) > 1: - raise DirectUrlValidationError( - "more than one of archive_info, dir_info, vcs_info" - ) - assert infos[0] is not None - return infos[0] - - -def _filter_none(**kwargs: Any) -> dict[str, Any]: - """Make dict excluding None values.""" - return {k: v for k, v in kwargs.items() if v is not None} - - -@dataclass -class VcsInfo: - name: ClassVar = "vcs_info" - - vcs: str - commit_id: str - requested_revision: str | None = None - - @classmethod - def _from_dict(cls, d: dict[str, Any] | None) -> VcsInfo | None: - if d is None: - return None - return cls( - vcs=_get_required(d, str, "vcs"), - commit_id=_get_required(d, str, "commit_id"), - requested_revision=_get(d, str, "requested_revision"), - ) - - def _to_dict(self) -> dict[str, Any]: - return _filter_none( - vcs=self.vcs, - requested_revision=self.requested_revision, - commit_id=self.commit_id, - ) - - -class ArchiveInfo: - name = "archive_info" - - def __init__( - self, - hash: str | None = None, - hashes: dict[str, str] | None = None, - ) -> None: - # set hashes before hash, since the hash setter will further populate hashes - self.hashes = hashes - self.hash = hash - - @property - def hash(self) -> str | None: - return self._hash - - @hash.setter - def hash(self, value: str | None) -> None: - if value is not None: - # Auto-populate the hashes key to upgrade to the new format automatically. - # We don't back-populate the legacy hash key from hashes. - try: - hash_name, hash_value = value.split("=", 1) - except ValueError: - raise DirectUrlValidationError( - f"invalid archive_info.hash format: {value!r}" - ) - if self.hashes is None: - self.hashes = {hash_name: hash_value} - elif hash_name not in self.hashes: - self.hashes = self.hashes.copy() - self.hashes[hash_name] = hash_value - self._hash = value - - @classmethod - def _from_dict(cls, d: dict[str, Any] | None) -> ArchiveInfo | None: - if d is None: - return None - return cls(hash=_get(d, str, "hash"), hashes=_get(d, dict, "hashes")) - - def _to_dict(self) -> dict[str, Any]: - return _filter_none(hash=self.hash, hashes=self.hashes) - - -@dataclass -class DirInfo: - name: ClassVar = "dir_info" - - editable: bool = False - - @classmethod - def _from_dict(cls, d: dict[str, Any] | None) -> DirInfo | None: - if d is None: - return None - return cls(editable=_get_required(d, bool, "editable", default=False)) - - def _to_dict(self) -> dict[str, Any]: - return _filter_none(editable=self.editable or None) - - -InfoType = Union[ArchiveInfo, DirInfo, VcsInfo] - - -@dataclass -class DirectUrl: - url: str - info: InfoType - subdirectory: str | None = None - - def _remove_auth_from_netloc(self, netloc: str) -> str: - if "@" not in netloc: - return netloc - user_pass, netloc_no_user_pass = netloc.split("@", 1) - if ( - isinstance(self.info, VcsInfo) - and self.info.vcs == "git" - and user_pass == "git" - ): - return netloc - if ENV_VAR_RE.match(user_pass): - return netloc - return netloc_no_user_pass - - @property - def redacted_url(self) -> str: - """url with user:password part removed unless it is formed with - environment variables as specified in PEP 610, or it is ``git`` - in the case of a git URL. - """ - purl = urllib.parse.urlsplit(self.url) - netloc = self._remove_auth_from_netloc(purl.netloc) - surl = urllib.parse.urlunsplit( - (purl.scheme, netloc, purl.path, purl.query, purl.fragment) - ) - return surl - - def validate(self) -> None: - self.from_dict(self.to_dict()) - - @classmethod - def from_dict(cls, d: dict[str, Any]) -> DirectUrl: - return DirectUrl( - url=_get_required(d, str, "url"), - subdirectory=_get(d, str, "subdirectory"), - info=_exactly_one_of( - [ - ArchiveInfo._from_dict(_get(d, dict, "archive_info")), - DirInfo._from_dict(_get(d, dict, "dir_info")), - VcsInfo._from_dict(_get(d, dict, "vcs_info")), - ] - ), - ) - - def to_dict(self) -> dict[str, Any]: - res = _filter_none( - url=self.redacted_url, - subdirectory=self.subdirectory, - ) - res[self.info.name] = self.info._to_dict() - return res +class DirectUrl(PackagingDirectUrl): + def to_dict_compat(self) -> dict[str, Any]: + return dict(super().to_dict(generate_legacy_hash=True)) @classmethod def from_json(cls, s: str) -> DirectUrl: return cls.from_dict(json.loads(s)) def to_json(self) -> str: - return json.dumps(self.to_dict(), sort_keys=True) + return json.dumps(self.to_dict_compat(), sort_keys=True) def is_local_editable(self) -> bool: - return isinstance(self.info, DirInfo) and self.info.editable + return bool(self.dir_info and self.dir_info.editable) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/installation_report.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/installation_report.py index 3e8e968..145e2cf 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/installation_report.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/installation_report.py @@ -19,7 +19,7 @@ class InstallationReport: # be absent when the requirement was installed from the wheel cache # and the cache entry was populated by an older pip version that did not # record origin.json. - "download_info": ireq.download_info.to_dict(), + "download_info": ireq.download_info.to_dict_compat(), # is_direct is true if the requirement was a direct URL reference (which # includes editable requirements), and false if the requirement was # downloaded from a PEP 503 index or --find-links. diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/link.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/link.py index 200ec34..cbbe945 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/link.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/link.py @@ -8,12 +8,12 @@ import os import posixpath import re import urllib.parse -import urllib.request from collections.abc import Mapping from dataclasses import dataclass from typing import ( Any, NamedTuple, + NewType, ) from pip._internal.exceptions import InvalidEggFragment @@ -31,6 +31,49 @@ from pip._internal.utils.urls import path_to_url, url_to_path logger = logging.getLogger(__name__) +# A single path component: percent-decoded once and reduced to a basename, so it +# contains no path separator and is not a ``.`` or ``..`` reference. The empty +# string means "no component". +PathComponent = NewType("PathComponent", str) + + +def _to_path_component(name: str) -> PathComponent: + """Reduce ``name`` to a single path component, or ``""`` if it has none. + + ``os.path.basename`` drops any directory part, drive letter, or separator; + a ``.``, ``..``, or empty result is not a component and becomes ``""``. + """ + name = os.path.basename(name) + if name in ("", os.curdir, os.pardir): + return PathComponent("") + + return PathComponent(name) + + +def as_path_component(name: str) -> PathComponent: + """Like ``_to_path_component`` but reject the empty result. + + Use where a file is about to be written, so a missing name is an error + rather than a silent fallback to the directory itself. + """ + component = _to_path_component(name) + if not component: + raise ValueError(f"Unexpected file name derived from URL: {name!r}") + + return component + + +def join_within_directory(directory: str, component: PathComponent) -> str: + """Join a single path ``component`` onto ``directory``. + + ``component`` is a :data:`PathComponent`, so by type it has no separator and + is not a ``.`` or ``..`` reference; the result can never escape ``directory``. + Requiring ``PathComponent`` rather than ``str`` lets the type checker enforce + at the call site that the name was reduced to a safe component beforehand. + """ + return os.path.join(directory, component) + + # Order matters, earlier hashes have a precedence over later hashes for what # we will pick to use. _SUPPORTED_HASHES = ("sha512", "sha384", "sha256", "sha224", "sha1", "md5") @@ -125,6 +168,8 @@ def _clean_file_url_path(part: str) -> str: Clean the first part of a URL path that corresponds to a local filesystem path (i.e. the first part after splitting on "@" characters). """ + import urllib.request + # We unquote prior to quoting to make sure nothing is double quoted. # Also, on Windows the path part might contain a drive letter which # should not be quoted. On Linux where drive letters do not @@ -423,18 +468,13 @@ class Link: return redact_auth_from_url(self.url) @property - def filename(self) -> str: - path = self.path.rstrip("/") - name = posixpath.basename(path) - if not name: - # Make sure we don't leak auth information if the netloc - # includes a username and password. - netloc, user_pass = split_auth_from_netloc(self.netloc) - return netloc + def filename(self) -> PathComponent: + name = _to_path_component(posixpath.basename(self.path.rstrip("/"))) + if name: + return name - name = urllib.parse.unquote(name) - assert name, f"URL {self._url!r} produced no filename" - return name + # No component in the path; fall back to the netloc, dropping any auth. + return _to_path_component(split_auth_from_netloc(self.netloc)[0]) @property def file_path(self) -> str: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/release_control.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/release_control.py index f1de068..d432fa3 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/release_control.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/release_control.py @@ -7,8 +7,7 @@ from pip._vendor.packaging.utils import NormalizedName, canonicalize_name from pip._internal.exceptions import CommandError -# TODO: add slots=True when Python 3.9 is dropped -@dataclass +@dataclass(slots=True) class ReleaseControl: """Helper for managing which release types can be installed.""" diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/scheme.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/scheme.py index 06a9a55..5ed7057 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/scheme.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/scheme.py @@ -10,14 +10,12 @@ from dataclasses import dataclass SCHEME_KEYS = ["platlib", "purelib", "headers", "scripts", "data"] -@dataclass(frozen=True) +@dataclass(frozen=True, slots=True) class Scheme: """A Scheme holds paths which are used as the base directories for artifacts associated with a Python package. """ - __slots__ = SCHEME_KEYS - platlib: str purelib: str headers: str diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/search_scope.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/search_scope.py index 136163c..b3aaa18 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/search_scope.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/search_scope.py @@ -14,14 +14,12 @@ from pip._internal.utils.misc import normalize_path, redact_auth_from_url logger = logging.getLogger(__name__) -@dataclass(frozen=True) +@dataclass(frozen=True, slots=True) class SearchScope: """ Encapsulates the locations that pip is configured to search. """ - __slots__ = ["find_links", "index_urls", "no_index"] - find_links: list[str] index_urls: list[str] no_index: bool diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/models/selection_prefs.py b/.venv/lib/python3.14/site-packages/pip/_internal/models/selection_prefs.py index 04ef63a..3473031 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/models/selection_prefs.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/models/selection_prefs.py @@ -1,56 +1,36 @@ from __future__ import annotations +from dataclasses import dataclass + from pip._internal.models.format_control import FormatControl from pip._internal.models.release_control import ReleaseControl -# TODO: This needs Python 3.10's improved slots support for dataclasses -# to be converted into a dataclass. +@dataclass(slots=True) class SelectionPreferences: """ Encapsulates the candidate selection preferences for downloading and installing files. - """ - __slots__ = [ - "allow_yanked", - "release_control", - "format_control", - "prefer_binary", - "ignore_requires_python", - ] + :param allow_yanked: Whether files marked as yanked (in the sense + of PEP 592) are permitted to be candidates for install. + :param release_control: A ReleaseControl object or None. Used to control + whether pre-releases are allowed for specific packages. + :param format_control: A FormatControl object or None. Used to control + the selection of source packages / binary packages when consulting + the index and links. + :param prefer_binary: Whether to prefer an old, but valid, binary + dist over a new source dist. + :param ignore_requires_python: Whether to ignore incompatible + "Requires-Python" values in links. Defaults to False. + """ # Don't include an allow_yanked default value to make sure each call # site considers whether yanked releases are allowed. This also causes # that decision to be made explicit in the calling code, which helps # people when reading the code. - def __init__( - self, - allow_yanked: bool, - release_control: ReleaseControl | None = None, - format_control: FormatControl | None = None, - prefer_binary: bool = False, - ignore_requires_python: bool | None = None, - ) -> None: - """Create a SelectionPreferences object. - - :param allow_yanked: Whether files marked as yanked (in the sense - of PEP 592) are permitted to be candidates for install. - :param release_control: A ReleaseControl object or None. Used to control - whether pre-releases are allowed for specific packages. - :param format_control: A FormatControl object or None. Used to control - the selection of source packages / binary packages when consulting - the index and links. - :param prefer_binary: Whether to prefer an old, but valid, binary - dist over a new source dist. - :param ignore_requires_python: Whether to ignore incompatible - "Requires-Python" values in links. Defaults to False. - """ - if ignore_requires_python is None: - ignore_requires_python = False - - self.allow_yanked = allow_yanked - self.release_control = release_control - self.format_control = format_control - self.prefer_binary = prefer_binary - self.ignore_requires_python = ignore_requires_python + allow_yanked: bool + release_control: ReleaseControl | None = None + format_control: FormatControl | None = None + prefer_binary: bool = False + ignore_requires_python: bool = False diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/network/auth.py b/.venv/lib/python3.14/site-packages/pip/_internal/network/auth.py index 4504f61..99b929a 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/network/auth.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/network/auth.py @@ -6,6 +6,7 @@ providing credentials in the context of network requests. from __future__ import annotations +import json import logging import os import shutil @@ -15,7 +16,7 @@ import typing import urllib.parse from abc import ABC, abstractmethod from functools import cache -from os.path import commonprefix +from os.path import commonpath from pathlib import Path from typing import Any, NamedTuple @@ -118,34 +119,48 @@ class KeyRingCliProvider(KeyRingBaseProvider): self.keyring = cmd def get_auth_info(self, url: str, username: str | None) -> AuthInfo | None: - # This is the default implementation of keyring.get_credential - # https://github.com/jaraco/keyring/blob/97689324abcf01bd1793d49063e7ca01e03d7d07/keyring/backend.py#L134-L139 - if username is not None: - password = self._get_password(url, username) - if password is not None: - return username, password - return None + return self._get_creds(url, username) def save_auth_info(self, url: str, username: str, password: str) -> None: return self._set_password(url, username, password) - def _get_password(self, service_name: str, username: str) -> str | None: - """Mirror the implementation of keyring.get_password using cli""" + def _get_creds(self, service_name: str, username: str | None) -> AuthInfo | None: + """Mirror the implementation of keyring.get_credential using cli""" if self.keyring is None: return None - cmd = [self.keyring, "get", service_name, username] + cmd = [self.keyring, "--mode=creds", "--output=json", "get", service_name] + if username is not None: + cmd.append(username) + env = os.environ.copy() env["PYTHONIOENCODING"] = "utf-8" - res = subprocess.run( + res = subprocess.run( # noqa: UP022 cmd, stdin=subprocess.DEVNULL, stdout=subprocess.PIPE, + stderr=subprocess.PIPE, env=env, ) + + # Detect if the user is running an outdated version of keyring without support + # for querying credentials without username + errs = res.stderr.decode("utf-8") + if ( + res.returncode == 2 + and "unrecognized arguments" in errs + and "--mode=creds" in errs + ): + raise RuntimeError( + "Keyring util is outdated; must be at least version 25.2.1, " + "please upgrade it" + ) + if res.returncode: return None - return res.stdout.decode("utf-8").strip(os.linesep) + + data = json.loads(res.stdout.decode("utf-8")) + return (data["username"], data["password"]) def _set_password(self, service_name: str, username: str, password: str) -> None: """Mirror the implementation of keyring.set_password using cli""" @@ -325,12 +340,14 @@ class MultiDomainBasicAuth(AuthBase): candidates.sort( reverse=True, - key=lambda candidate: commonprefix( - [ - parsed_url.path, - candidate.path, - ] - ).rfind("/"), + key=lambda candidate: len( + commonpath( + [ + parsed_url.path, + candidate.path, + ] + ) + ), ) return urllib.parse.urlunsplit(candidates[0]) @@ -485,15 +502,17 @@ class MultiDomainBasicAuth(AuthBase): if resp.status_code != 401: return resp - username, password = None, None - - # Query the keyring for credentials: - if self.use_keyring: - username, password = self._get_new_credentials( - resp.url, - allow_netrc=False, - allow_keyring=True, - ) + # Look for credentials for the (possibly redirected) URL. Credentials + # embedded in the URL -- e.g. carried in the ``Location`` of a + # cross-origin redirect, whose ``Authorization`` header requests strips + # -- are always honoured, since recovering them needs no user + # interaction. Keyring is only consulted when it is enabled, because it + # may require interaction and is therefore disabled under --no-input. + username, password = self._get_new_credentials( + resp.url, + allow_netrc=False, + allow_keyring=self.use_keyring, + ) # We are not able to prompt the user so simply return the response if not self.prompting and not username and not password: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/network/cache.py b/.venv/lib/python3.14/site-packages/pip/_internal/network/cache.py index 2a372f2..bff9707 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/network/cache.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/network/cache.py @@ -4,10 +4,10 @@ from __future__ import annotations import os import shutil -from collections.abc import Generator +from collections.abc import Callable, Generator from contextlib import contextmanager from datetime import datetime -from typing import Any, BinaryIO, Callable +from typing import Any, BinaryIO from pip._vendor.cachecontrol.cache import SeparateBodyBaseCache from pip._vendor.cachecontrol.caches import SeparateBodyFileCache diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/network/download.py b/.venv/lib/python3.14/site-packages/pip/_internal/network/download.py index 2696642..2c59925 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/network/download.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/network/download.py @@ -2,6 +2,7 @@ from __future__ import annotations +import contextlib import email.message import logging import mimetypes @@ -15,12 +16,23 @@ from pip._vendor.requests import PreparedRequest from pip._vendor.requests.models import Response from pip._vendor.urllib3 import HTTPResponse as URLlib3Response from pip._vendor.urllib3._collections import HTTPHeaderDict -from pip._vendor.urllib3.exceptions import ReadTimeoutError +from pip._vendor.urllib3.exceptions import ProtocolError, ReadTimeoutError from pip._internal.cli.progress_bars import BarType, get_download_progress_renderer -from pip._internal.exceptions import IncompleteDownloadError, NetworkConnectionError -from pip._internal.models.index import PyPI -from pip._internal.models.link import Link +from pip._internal.exceptions import ( + ConnectionFailedError, + ConnectionTimeoutError, + IncompleteDownloadError, + NetworkConnectionError, + ProxyConnectionError, + SSLVerificationError, +) +from pip._internal.models.link import ( + Link, + PathComponent, + as_path_component, + join_within_directory, +) from pip._internal.network.cache import SafeFileCache, is_from_cache from pip._internal.network.session import CacheControlAdapter, PipSession from pip._internal.network.utils import HEADERS, raise_for_status, response_chunks @@ -31,9 +43,14 @@ logger = logging.getLogger(__name__) def _get_http_response_size(resp: Response) -> int | None: try: - return int(resp.headers["content-length"]) + size = int(resp.headers["content-length"]) except (ValueError, KeyError, TypeError): return None + # A negative length would make _FileDownload.is_incomplete() report a + # truncated download as complete, so treat it as unknown instead. + if size < 0: + return None + return size def _get_http_response_etag_or_last_modified(resp: Response) -> str | None: @@ -51,10 +68,10 @@ def _log_download( total_length: int | None, range_start: int | None = 0, ) -> Iterable[bytes]: - if link.netloc == PyPI.file_storage_domain: - url = link.show_url - else: + if logger.getEffectiveLevel() > logging.INFO: url = link.url_without_fragment + else: + url = link.show_url logged_url = redact_auth_from_url(url) @@ -117,11 +134,14 @@ def parse_content_disposition(content_disposition: str, default_filename: str) - return filename or default_filename -def _get_http_response_filename(resp: Response, link: Link) -> str: +def _get_http_response_filename(resp: Response, link: Link) -> PathComponent: """Get an ideal filename from the given HTTP response, falling back to the link filename if not provided. + + The result is validated as a single path component, so it can be joined onto + a download directory without escaping it. """ - filename = link.filename # fallback + filename: str = link.filename # fallback # Have a look at the Content-Disposition header for a better guess content_disposition = resp.headers.get("content-disposition") if content_disposition: @@ -135,7 +155,7 @@ def _get_http_response_filename(resp: Response, link: Link) -> str: ext = os.path.splitext(resp.url)[1] if ext: filename += ext - return filename + return as_path_component(filename) @dataclass @@ -188,12 +208,19 @@ class Downloader: resp = self._http_get(link) download_size = _get_http_response_size(resp) - filepath = os.path.join(location, _get_http_response_filename(resp, link)) - with open(filepath, "wb") as content_file: - download = _FileDownload(link, content_file, download_size) - self._process_response(download, resp) - if download.is_incomplete(): - self._attempt_resumes_or_redownloads(download, resp) + filepath = join_within_directory( + location, _get_http_response_filename(resp, link) + ) + try: + with open(filepath, "wb") as content_file: + download = _FileDownload(link, content_file, download_size) + self._process_response(download, resp) + if download.is_incomplete(): + self._attempt_resumes_or_redownloads(download, resp) + except IncompleteDownloadError: + with contextlib.suppress(OSError): + os.remove(filepath) + raise content_type = resp.headers.get("Content-Type", "") return filepath, content_type @@ -210,12 +237,12 @@ class Downloader: try: for chunk in chunks: download.write_chunk(chunk) - except ReadTimeoutError as e: + except (ReadTimeoutError, ProtocolError) as e: # If the download size is not known, then give up downloading the file. if download.size is None: raise e - logger.warning("Connection timed out while downloading.") + logger.warning("Connection interrupted while downloading.") def _attempt_resumes_or_redownloads( self, download: _FileDownload, first_resp: Response @@ -242,14 +269,38 @@ class Downloader: download.reset_file() download.size = _get_http_response_size(resume_resp) first_resp = resume_resp + else: + # If the resume request starts at the wrong location, fail + # outright since the server is misbehaving. + content_range = resume_resp.headers.get("Content-Range", "") + resumed_at = content_range.lower().partition("bytes ")[2] + resumed_at = resumed_at.partition("-")[0] + if resumed_at and resumed_at != str(download.bytes_received): + raise IncompleteDownloadError(download) self._process_response(download, resume_resp) - except (ConnectionError, ReadTimeoutError, OSError): + except ( + ConnectionFailedError, + ConnectionTimeoutError, + ProxyConnectionError, + SSLVerificationError, + ReadTimeoutError, + ProtocolError, + OSError, + ): + # The error handling here is tricky, a few notes: + # + # - The diagnostic connection errors are raised by our custom + # requests.request() connection exception handler. + # - ProtocolError is raised by urllib3 when the returned data length + # doesn't match the response Content-Length. + # - ReadTimeoutError / ProtocolError come straight from urllib3 (via + # process_response) and aren't caught by our connection exception + # handler since they occur while *streaming* a response. continue # No more resume attempts. Raise an error if the download is still incomplete. if download.is_incomplete(): - os.remove(download.output_file.name) raise IncompleteDownloadError(download) # If we successfully completed the download via resume, manually cache it diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/network/session.py b/.venv/lib/python3.14/site-packages/pip/_internal/network/session.py index 34083e0..7db8379 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/network/session.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/network/session.py @@ -22,8 +22,6 @@ from collections.abc import Generator, Mapping, Sequence from typing import ( TYPE_CHECKING, Any, - Optional, - Union, ) from pip._vendor import requests, urllib3 @@ -36,27 +34,33 @@ from pip._vendor.urllib3.connectionpool import ConnectionPool from pip._vendor.urllib3.exceptions import InsecureRequestWarning from pip import __version__ +from pip._internal.exceptions import SSLMissingError from pip._internal.metadata import get_default_environment from pip._internal.models.link import Link from pip._internal.network.auth import MultiDomainBasicAuth from pip._internal.network.cache import SafeFileCache +from pip._internal.network.utils import raise_connection_error # Import ssl from compat so the initial import occurs in only one place. from pip._internal.utils.compat import has_tls from pip._internal.utils.glibc import libc_ver -from pip._internal.utils.misc import build_url_from_netloc, parse_netloc +from pip._internal.utils.misc import ( + build_url_from_netloc, + looks_like_ci, + parse_netloc, + redact_auth_from_url, +) from pip._internal.utils.urls import url_to_path if TYPE_CHECKING: from ssl import SSLContext from pip._vendor.urllib3 import ProxyManager - from pip._vendor.urllib3.poolmanager import PoolManager logger = logging.getLogger(__name__) -SecureOrigin = tuple[str, str, Optional[Union[int, str]]] +SecureOrigin = tuple[str, str, int | str | None] # Ignore warning raised when using --trusted-host. @@ -76,35 +80,6 @@ SECURE_ORIGINS: list[SecureOrigin] = [ ] -# These are environment variables present when running under various -# CI systems. For each variable, some CI systems that use the variable -# are indicated. The collection was chosen so that for each of a number -# of popular systems, at least one of the environment variables is used. -# This list is used to provide some indication of and lower bound for -# CI traffic to PyPI. Thus, it is okay if the list is not comprehensive. -# For more background, see: https://github.com/pypa/pip/issues/5499 -CI_ENVIRONMENT_VARIABLES = ( - # Azure Pipelines - "BUILD_BUILDID", - # Jenkins - "BUILD_ID", - # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI - "CI", - # Explicit environment variable. - "PIP_IS_CI", -) - - -def looks_like_ci() -> bool: - """ - Return whether it looks like pip is running under CI. - """ - # We don't use the method of checking for a tty (e.g. using isatty()) - # because some CI systems mimic a tty (e.g. Travis CI). Thus that - # method doesn't provide definitive information in either direction. - return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES) - - @functools.lru_cache(maxsize=1) def user_agent() -> str: """ @@ -212,7 +187,7 @@ class LocalFSAdapter(BaseAdapter): self, request: PreparedRequest, stream: bool = False, - timeout: float | tuple[float, float] | tuple[float, None] | None = None, + timeout: float | tuple[float | None, float | None] | None = None, verify: bool | str = True, cert: bytes | str | tuple[bytes | str, bytes | str] | None = None, proxies: Mapping[str, str] | None = None, @@ -264,9 +239,11 @@ class _SSLContextAdapterMixin: self, *, ssl_context: SSLContext | None = None, + use_ssl_context_for_proxy: bool = True, **kwargs: Any, ) -> None: self._ssl_context = ssl_context + self._use_ssl_context_for_proxy = use_ssl_context_for_proxy super().__init__(**kwargs) def init_poolmanager( @@ -275,10 +252,10 @@ class _SSLContextAdapterMixin: maxsize: int, block: bool = DEFAULT_POOLBLOCK, **pool_kwargs: Any, - ) -> PoolManager: + ) -> None: if self._ssl_context is not None: pool_kwargs.setdefault("ssl_context", self._ssl_context) - return super().init_poolmanager( # type: ignore[misc, no-any-return] + super().init_poolmanager( # type: ignore[misc] connections=connections, maxsize=maxsize, block=block, @@ -290,7 +267,10 @@ class _SSLContextAdapterMixin: # context here too. https://github.com/pypa/pip/issues/13288 if self._ssl_context is not None: proxy_kwargs.setdefault("ssl_context", self._ssl_context) - return super().proxy_manager_for(proxy, **proxy_kwargs) # type: ignore[misc, no-any-return] + if self._use_ssl_context_for_proxy: + # Leave this unset when urllib3 must apply a custom proxy CA bundle. + proxy_kwargs.setdefault("proxy_ssl_context", self._ssl_context) + return super().proxy_manager_for(proxy, **proxy_kwargs) # type: ignore[misc] class HTTPAdapter(_SSLContextAdapterMixin, _BaseHTTPAdapter): @@ -335,6 +315,8 @@ class PipSession(requests.Session): trusted_hosts: Sequence[str] = (), index_urls: list[str] | None = None, ssl_context: SSLContext | None = None, + use_ssl_context_for_proxy: bool = True, + refresh_package: set[str] | None = None, **kwargs: Any, ) -> None: """ @@ -346,11 +328,19 @@ class PipSession(requests.Session): # Namespace the attribute with "pip_" just in case to prevent # possible conflicts with the base class. self.pip_trusted_origins: list[tuple[str, int | None]] = [] - self.pip_proxy = None + # "" disables proxying; None means no --proxy was given. + self.pip_proxy: str | None = None + self.pip_no_proxy_env = False + self.refresh_package: set[str] = refresh_package or set() # Attach our User Agent to the request self.headers["User-Agent"] = user_agent() + # Pin Accept-Encoding so it doesn't vary with zstd availability (Python + # 3.14+ or backports.zstd); a varying value misses the cache for "Vary: + # Accept-Encoding" responses shared across interpreters (pypa/pip#13979). + self.headers["Accept-Encoding"] = "gzip, deflate" + # Attach our Authentication handler to the session self.auth: MultiDomainBasicAuth = MultiDomainBasicAuth(index_urls=index_urls) @@ -392,13 +382,18 @@ class PipSession(requests.Session): cache=SafeFileCache(cache), max_retries=retries, ssl_context=ssl_context, + use_ssl_context_for_proxy=use_ssl_context_for_proxy, ) self._trusted_host_adapter = InsecureCacheControlAdapter( cache=SafeFileCache(cache), max_retries=retries, ) else: - secure_adapter = HTTPAdapter(max_retries=retries, ssl_context=ssl_context) + secure_adapter = HTTPAdapter( + max_retries=retries, + ssl_context=ssl_context, + use_ssl_context_for_proxy=use_ssl_context_for_proxy, + ) self._trusted_host_adapter = insecure_adapter self.mount("https://", secure_adapter) @@ -522,6 +517,23 @@ class PipSession(requests.Session): return False + def get_redirect_target(self, resp: Response) -> str | None: + target = super().get_redirect_target(resp) + if target is None: + return None + # Redirecting to a file:// URL doesn't make much sense and + # shouldn't be allowed. + scheme = urllib.parse.urlparse(target).scheme + if scheme and scheme.lower() not in ("http", "https"): + logger.warning( + "Not following redirect from %s to %s: a redirect to a non-http(s)" + " location is not allowed.", + redact_auth_from_url(resp.url), + redact_auth_from_url(target), + ) + return None + return target + def request(self, method: str, url: str, *args: Any, **kwargs: Any) -> Response: # type: ignore[override] # Allow setting a default timeout on a session kwargs.setdefault("timeout", self.timeout) @@ -529,4 +541,15 @@ class PipSession(requests.Session): kwargs.setdefault("proxies", self.proxies) # Dispatch the actual request - return super().request(method, url, *args, **kwargs) + try: + return super().request(method, url, *args, **kwargs) + except (requests.ConnectionError, requests.Timeout) as e: + request = getattr(e, "request", None) + failed_url = getattr(request, "url", None) or url + raise_connection_error(e, url=failed_url, timeout=kwargs["timeout"]) + except ImportError as e: + if "ssl" in str(e).lower(): + # Unfortunately, if this TLS error was the result of a redirect from + # a HTTP to a HTTPS url, we don't know what the final url was. + raise SSLMissingError(redact_auth_from_url(url)) + raise diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/network/utils.py b/.venv/lib/python3.14/site-packages/pip/_internal/network/utils.py index 74d3111..0f50607 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/network/utils.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/network/utils.py @@ -1,8 +1,23 @@ from collections.abc import Generator +from typing import Literal, NoReturn, TypeAlias, cast +from urllib.parse import urlsplit +from pip._vendor import requests, urllib3 from pip._vendor.requests.models import Response +from pip._vendor.urllib3.exceptions import TimeoutStateError -from pip._internal.exceptions import NetworkConnectionError +from pip._internal.exceptions import ( + ConnectionFailedError, + ConnectionTimeoutError, + NetworkConnectionError, + ProxyConnectionError, + SSLVerificationError, +) +from pip._internal.utils.misc import redact_auth_from_url + +TimeoutValue: TypeAlias = ( + float | tuple[float | None, float | None] | urllib3.util.Timeout | None +) # The following comments and HTTP headers were originally added by # Donald Stufft in git commit 22c562429a61bb77172039e480873fb239dd8c03. @@ -96,3 +111,96 @@ def response_chunks( if not chunk: break yield chunk + + +def _parse_timeout(timeout: TimeoutValue, kind: Literal["connect", "read"]) -> float: + connect_timeout: float | None + read_timeout: float | None + if isinstance(timeout, tuple): + connect_timeout, read_timeout = timeout + elif isinstance(timeout, urllib3.util.Timeout): + connect_timeout = cast(float | None, timeout.connect_timeout) + try: + read_timeout = timeout.read_timeout + except TimeoutStateError: + read_timeout = None + else: + connect_timeout = read_timeout = timeout + + if kind == "connect": + assert connect_timeout is not None + return connect_timeout + else: + assert read_timeout is not None + return read_timeout + + +def _raise_timeout_error( + reason: urllib3.exceptions.TimeoutError, + url: str, + host: str, + timeout: TimeoutValue, +) -> NoReturn: + if isinstance(reason, urllib3.exceptions.ConnectTimeoutError): + raise ConnectionTimeoutError( + url, host, kind="connect", timeout=_parse_timeout(timeout, "connect") + ) + else: + raise ConnectionTimeoutError( + url, host, kind="read", timeout=_parse_timeout(timeout, "read") + ) + + +def raise_connection_error( + error: requests.ConnectionError | requests.Timeout, + *, + url: str, + timeout: TimeoutValue, +) -> NoReturn: + """Raise a specific error for a given connection error, if possible. + + Note: requests.ConnectionError is the parent class of + requests.ProxyError, requests.SSLError, and requests.ConnectTimeout + so these errors are also handled here. + """ + url = redact_auth_from_url(url) + raw_hostname = urlsplit(url).hostname or urlsplit(url).netloc + reason = error.args[0] if error.args else error + + # NewConnectionError is a subclass of TimeoutError for some reason... + if isinstance(reason, urllib3.exceptions.TimeoutError) and not isinstance( + reason, urllib3.exceptions.NewConnectionError + ): + # A bare timeout error can occur during non-streamed responses. Don't + # ask me how. + _raise_timeout_error(reason, url, raw_hostname, timeout) + if isinstance(reason, urllib3.exceptions.SSLError): + # A bare SSL error can occur during non-streamed responses, after the + # initial connection and TLS handshake have completed. + raise SSLVerificationError(url, raw_hostname, reason) + + # At this point, all errors should be wrapped in MaxRetryError. + if not isinstance(reason, urllib3.exceptions.MaxRetryError): + raise ConnectionFailedError(url, raw_hostname, reason) + + max_retry_error = reason + assert isinstance(max_retry_error.pool, urllib3.connectionpool.HTTPConnectionPool) + host = max_retry_error.pool.host + proxy = max_retry_error.pool.proxy + # Narrow the reason further to the specific error from the last retry. + reason = max_retry_error.reason + + if isinstance(reason, urllib3.exceptions.SSLError): + raise SSLVerificationError(url, host, reason) + if isinstance(reason, urllib3.exceptions.TimeoutError) and not isinstance( + reason, urllib3.exceptions.NewConnectionError + ): + _raise_timeout_error(reason, url, host, timeout) + if isinstance(reason, urllib3.exceptions.ProxyError): + assert proxy is not None + raise ProxyConnectionError(url, redact_auth_from_url(str(proxy)), reason) + + # Unknown error, give up and raise a generic error. + raise ConnectionFailedError( + url, host, reason if isinstance(reason, Exception) else max_retry_error + ) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/operations/check.py b/.venv/lib/python3.14/site-packages/pip/_internal/operations/check.py index 2d71fa5..00cb6c5 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/operations/check.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/operations/check.py @@ -3,12 +3,11 @@ from __future__ import annotations import logging -from collections.abc import Generator, Iterable +from collections.abc import Callable, Generator, Iterable from contextlib import suppress from email.parser import Parser from functools import reduce from typing import ( - Callable, NamedTuple, ) @@ -168,7 +167,7 @@ def _create_whitelist( continue for req in package_set[package_name].dependencies: - if canonicalize_name(req.name) in packages_affected: + if canonicalize_name(req.name) in would_be_installed: packages_affected.add(package_name) break diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/operations/install/wheel.py b/.venv/lib/python3.14/site-packages/pip/_internal/operations/install/wheel.py index 40097d6..9346ad7 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/operations/install/wheel.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/operations/install/wheel.py @@ -15,26 +15,25 @@ import sys import textwrap import warnings from base64 import urlsafe_b64encode -from collections.abc import Generator, Iterable, Iterator, Sequence +from collections.abc import Callable, Generator, Iterable, Iterator, Sequence from email.message import Message from itertools import chain, filterfalse, starmap +from pathlib import Path from typing import ( IO, Any, BinaryIO, - Callable, NewType, Protocol, - Union, cast, ) from zipfile import ZipFile, ZipInfo from pip._vendor.distlib.scripts import ScriptMaker -from pip._vendor.distlib.util import get_export_entry +from pip._vendor.distlib.util import FileOperator, get_export_entry from pip._vendor.packaging.utils import canonicalize_name -from pip._internal.exceptions import InstallationError +from pip._internal.exceptions import BlockedImportError, InstallationError from pip._internal.locations import get_major_minor_version from pip._internal.metadata import ( BaseDistribution, @@ -59,6 +58,10 @@ class File(Protocol): dest_path: str changed: bool + @property + def written(self) -> bool: + pass + def save(self) -> None: pass @@ -66,7 +69,7 @@ class File(Protocol): logger = logging.getLogger(__name__) RecordPath = NewType("RecordPath", str) -InstalledCSVRow = tuple[RecordPath, str, Union[int, str]] +InstalledCSVRow = tuple[RecordPath, str, int | str] def rehash(path: str, blocksize: int = 1 << 20) -> tuple[str, str]: @@ -127,27 +130,33 @@ def message_about_scripts_not_on_PATH(scripts: Sequence[str]) -> str | None: return None # Group scripts by the path they were installed in - grouped_by_dir: dict[str, set[str]] = collections.defaultdict(set) + grouped_by_dir: dict[Path, set[str]] = collections.defaultdict(set) for destfile in scripts: - parent_dir = os.path.dirname(destfile) - script_name = os.path.basename(destfile) + dest_path = Path(destfile) + parent_dir = dest_path.parent.resolve() + script_name = dest_path.name grouped_by_dir[parent_dir].add(script_name) - # We don't want to warn for directories that are on PATH. - not_warn_dirs = [ - os.path.normcase(os.path.normpath(i)).rstrip(os.sep) - for i in os.environ.get("PATH", "").split(os.pathsep) - ] # If an executable sits with sys.executable, we don't warn for it. # This covers the case of venv invocations without activating the venv. - not_warn_dirs.append( - os.path.normcase(os.path.normpath(os.path.dirname(sys.executable))) - ) - warn_for: dict[str, set[str]] = { + executable_dir = Path(sys.executable).parent.resolve() + path_entries = os.environ.get("PATH", "").split(os.pathsep) + + # We don't want to warn for directories that are on PATH. + warn_for: dict[Path, set[str]] = { parent_dir: scripts for parent_dir, scripts in grouped_by_dir.items() - if os.path.normcase(os.path.normpath(parent_dir)) not in not_warn_dirs + if parent_dir != executable_dir and str(parent_dir) not in path_entries } + + # Resolving PATH entries can be slow, so only do it for what's left. + if warn_for: + not_warn_dirs = {Path(i).resolve() for i in path_entries} + warn_for = { + parent_dir: scripts + for parent_dir, scripts in warn_for.items() + if parent_dir not in not_warn_dirs + } if not warn_for: return None @@ -176,9 +185,7 @@ def message_about_scripts_not_on_PATH(scripts: Sequence[str]) -> str | None: msg_lines.append(last_line_fmt.format("these directories")) # Add a note if any directory starts with ~ - warn_for_tilde = any( - i[0] == "~" for i in os.environ.get("PATH", "").split(os.pathsep) if i - ) + warn_for_tilde = any(i[0] == "~" for i in path_entries if i) if warn_for_tilde: tilde_warning_msg = ( "NOTE: The current PATH contains path(s) starting with `~`, " @@ -345,6 +352,7 @@ class ZipBackedFile: self.dest_path = dest_path self._zip_file = zip_file self.changed = False + self.written = False def _getinfo(self) -> ZipInfo: return self._zip_file.getinfo(self.src_record_path) @@ -366,6 +374,7 @@ class ZipBackedFile: # optimization: the file is created by open(), # skip the decompression when there is 0 bytes to decompress. with open(self.dest_path, "wb") as dest: + self.written = True if zipinfo.file_size > 0: with self._zip_file.open(zipinfo) as f: blocksize = min(zipinfo.file_size, 1024 * 1024) @@ -382,6 +391,10 @@ class ScriptFile: self.dest_path = self._file.dest_path self.changed = False + @property + def written(self) -> bool: + return self._file.written + def save(self) -> None: self._file.save() self.changed = fix_script(self.dest_path) @@ -397,32 +410,171 @@ class MissingCallableSuffix(InstallationError): ) -def _raise_for_invalid_entrypoint(specification: str) -> None: +def _raise_for_invalid_entrypoint(specification: str, scripts_dir: str) -> None: entry = get_export_entry(specification) - if entry is not None and entry.suffix is None: + if entry is None: + return + + if entry.suffix is None: raise MissingCallableSuffix(str(entry)) + # distlib joins the entry point name onto the scripts directory, so a name + # with path separators or ``..`` components can resolve elsewhere. The script + # must resolve to a path strictly inside the scripts directory. + dest = os.path.join(scripts_dir, entry.name) + resolves_to_scripts_dir = os.path.abspath(dest) == os.path.abspath(scripts_dir) + if resolves_to_scripts_dir or not is_within_directory(scripts_dir, dest): + raise InstallationError( + f"Invalid script entry point name {entry.name!r}: the script " + f"would be installed outside the scripts directory ({scripts_dir})." + ) + class PipScriptMaker(ScriptMaker): # Override distlib's default script template with one that # doesn't import `re` module, allowing scripts to load faster. - script_template = textwrap.dedent( - """\ + script_template = textwrap.dedent("""\ import sys from %(module)s import %(import_name)s if __name__ == '__main__': sys.argv[0] = sys.argv[0].removesuffix('.exe') sys.exit(%(func)s()) -""" - ) +""") def make( self, specification: str, options: dict[str, Any] | None = None ) -> list[str]: - _raise_for_invalid_entrypoint(specification) + _raise_for_invalid_entrypoint(specification, self.target_dir) return super().make(specification, options) +class _WheelInstallRecord: + """Track files and metadata needed to recover an interrupted installation.""" + + def __init__(self, info_dir: str, lib_dir: str) -> None: + self.info_dir = info_dir + self.lib_dir = lib_dir + self.installed: dict[RecordPath, RecordPath] = {} + self.generated: list[str] = [] + self.script_fileop = FileOperator() + self.script_fileop.record = True + self.started = False + + def written_paths(self) -> set[str]: + """Return the files written so far, including partial copies and scripts.""" + paths = {os.path.join(self.lib_dir, path) for path in self.installed.values()} + paths.update(self.generated) + paths.update(self.script_fileop.files_written) + return paths + + +@contextlib.contextmanager +def _generate_file( + path: str, file_mode: int, **kwargs: Any +) -> Generator[BinaryIO, None, None]: + """Write metadata atomically with the requested permissions.""" + temporary_path = None + try: + with adjacent_tmp_file(path, **kwargs) as f: + temporary_path = f.name + yield f + + os.chmod(f.name, file_mode) + replace(f.name, path) + except BaseException: + if temporary_path is not None: + with contextlib.suppress(FileNotFoundError): + os.unlink(temporary_path) + raise + + +def _write_recovery_record(wheel_zip: ZipFile, record: _WheelInstallRecord) -> None: + """Write readable metadata and an uninstall record for files already written.""" + info_dir, lib_dir = record.info_dir, record.lib_dir + file_mode = 0o666 & ~current_umask() + + recovery_paths = { + _fs_to_record_path(path, lib_dir) for path in record.written_paths() + } + + dest_info_dir = os.path.join(lib_dir, info_dir) + ensure_dir(dest_info_dir) + metadata_path = os.path.join(dest_info_dir, "METADATA") + with _generate_file(metadata_path, file_mode) as metadata_file: + metadata_file.write(wheel_zip.read(f"{info_dir}/METADATA")) + recovery_paths.add(_fs_to_record_path(metadata_path, lib_dir)) + + # Uninstall must not infer wrappers that were never generated. + with contextlib.suppress(FileNotFoundError): + os.unlink(os.path.join(dest_info_dir, "entry_points.txt")) + + record_path = os.path.join(dest_info_dir, "RECORD") + recovery_paths.add(_fs_to_record_path(record_path, lib_dir)) + with _generate_file(record_path, file_mode, **csv_io_kwargs("w")) as record_file: + writer = csv.writer(cast("IO[str]", record_file)) + writer.writerows((path, "", "") for path in sorted(recovery_paths)) + + +@contextlib.contextmanager +def _record_wheel_installation( + wheel_zip: ZipFile, name: str, scheme: Scheme, *, rollback_on_error: bool = False +) -> Generator[_WheelInstallRecord, None, None]: + """Provide the file journal and recover writes interrupted by blocked imports.""" + info_dir, metadata = parse_wheel(wheel_zip, name) + lib_dir = scheme.purelib if wheel_root_is_purelib(metadata) else scheme.platlib + record = _WheelInstallRecord(info_dir, lib_dir) + + try: + yield record + except BlockedImportError as error: + # A blocked preparation step must leave an existing install alone. + if not record.started: + raise + + if rollback_on_error: + # Remove replacement files before the previous installation is restored. + try: + for path in record.written_paths(): + with contextlib.suppress(FileNotFoundError): + os.unlink(path) + + # Empty dist-info directories still look like installed distributions. + for directory, _, _ in os.walk( + os.path.join(lib_dir, info_dir), topdown=False + ): + with contextlib.suppress(OSError): + os.rmdir(directory) + except (OSError, BlockedImportError) as cleanup_error: + raise BlockedImportError( + f"Could not remove incomplete installation of {name!r}: " + f"{cleanup_error}\n{error}" + ) from cleanup_error + + raise + + try: + _write_recovery_record(wheel_zip, record) + except (OSError, BlockedImportError) as recovery_error: + raise BlockedImportError( + f"Could not write recovery metadata for {name!r} at " + f"{os.path.join(lib_dir, info_dir)!r}: {recovery_error}\n{error}" + ) from recovery_error + + raise BlockedImportError( + f"Installation of {name!r} was interrupted and the package may be " + f"corrupt. Run 'pip uninstall {name}' to remove it. {error}" + ) from error + + +def _compile_wheel_file(path: str) -> bool: + """Skip optional compilation when it requires a blocked or unavailable import.""" + try: + return compileall.compile_file(path, force=True, quiet=True) + except (BlockedImportError, ImportError) as error: + logger.debug("Skipping bytecode compilation for %s: %s", path, error) + return False + + def _install_wheel( # noqa: C901, PLR0915 function is too long name: str, wheel_zip: ZipFile, @@ -432,36 +584,33 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long warn_script_location: bool = True, direct_url: DirectUrl | None = None, requested: bool = False, + script_executable: str | None = None, + *, + record: _WheelInstallRecord, ) -> None: """Install a wheel. :param name: Name of the project to install :param wheel_zip: open ZipFile for wheel being installed :param scheme: Distutils scheme dictating the install directories - :param req_description: String used in place of the requirement, for - logging :param pycompile: Whether to byte-compile installed Python files :param warn_script_location: Whether to check that scripts are installed into a directory on PATH + :param script_executable: Python executable to use for console scripts :raises UnsupportedWheel: * when the directory holds an unpacked wheel with incompatible Wheel-Version * when the .dist-info dir does not match the wheel """ - info_dir, metadata = parse_wheel(wheel_zip, name) - - if wheel_root_is_purelib(metadata): - lib_dir = scheme.purelib - else: - lib_dir = scheme.platlib + info_dir, lib_dir = record.info_dir, record.lib_dir # Record details of the files moved # installed = files copied from the wheel to the destination # changed = files changed while installing (scripts #! line typically) - # generated = files newly generated during the install (script wrappers) - installed: dict[RecordPath, RecordPath] = {} + # generated = scripts and installation metadata generated during the install + installed = record.installed changed: set[RecordPath] = set() - generated: list[str] = [] + generated = record.generated def record_installed( srcfile: RecordPath, destfile: str, modified: bool = False @@ -582,6 +731,8 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long script_scheme_files = map(ScriptFile, script_scheme_files) files = chain(files, script_scheme_files) + # File saves may unlink old files before creating replacements. + record.started = True existing_parents = set() for file in files: # directory creation is lazy and after file filtering @@ -591,7 +742,14 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long if parent_dir not in existing_parents: ensure_dir(parent_dir) existing_parents.add(parent_dir) - file.save() + + try: + file.save() + except BlockedImportError: + if file.written: + record_installed(file.src_record_path, file.dest_path, True) + raise + record_installed(file.src_record_path, file.dest_path, file.changed) def pyc_source_file_paths() -> Generator[str, None, None]: @@ -619,7 +777,7 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long with warnings.catch_warnings(): warnings.filterwarnings("ignore") for path in pyc_source_file_paths(): - success = compileall.compile_file(path, force=True, quiet=True) + success = _compile_wheel_file(path) if success: pyc_path = pyc_output_path(path) assert os.path.exists(pyc_path) @@ -629,7 +787,14 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long record_installed(pyc_record_path, pyc_path) logger.debug(stdout.getvalue()) - maker = PipScriptMaker(None, scheme.scripts) + # Track scripts even if generation fails before returning their paths. + maker = PipScriptMaker(None, scheme.scripts, fileop=record.script_fileop) + + # Embed the target environment's interpreter in console-script launchers + # rather than the one running pip, so an in-process install into another + # environment (e.g. a venv build environment) produces working launchers. + if script_executable is not None: + maker.executable = script_executable # type: ignore # it's untyped in distlib # Ensure old scripts are overwritten. # See https://github.com/pypa/pip/issues/1800 @@ -661,26 +826,18 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long logger.warning(msg) generated_file_mode = 0o666 & ~current_umask() - - @contextlib.contextmanager - def _generate_file(path: str, **kwargs: Any) -> Generator[BinaryIO, None, None]: - with adjacent_tmp_file(path, **kwargs) as f: - yield f - os.chmod(f.name, generated_file_mode) - replace(f.name, path) - dest_info_dir = os.path.join(lib_dir, info_dir) # Record pip as the installer installer_path = os.path.join(dest_info_dir, "INSTALLER") - with _generate_file(installer_path) as installer_file: + with _generate_file(installer_path, generated_file_mode) as installer_file: installer_file.write(b"pip\n") generated.append(installer_path) # Record the PEP 610 direct URL reference if direct_url is not None: direct_url_path = os.path.join(dest_info_dir, DIRECT_URL_METADATA_NAME) - with _generate_file(direct_url_path) as direct_url_file: + with _generate_file(direct_url_path, generated_file_mode) as direct_url_file: direct_url_file.write(direct_url.to_json().encode("utf-8")) generated.append(direct_url_path) @@ -694,9 +851,10 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long record_text = distribution.read_text("RECORD") record_rows = list(csv.reader(record_text.splitlines())) + # RECORD generation consumes its input; recovery still needs the journal. rows = get_csv_rows_for_installed( record_rows, - installed=installed, + installed=installed.copy(), changed=changed, generated=generated, lib_dir=lib_dir, @@ -705,7 +863,9 @@ def _install_wheel( # noqa: C901, PLR0915 function is too long # Record details of all files installed record_path = os.path.join(dest_info_dir, "RECORD") - with _generate_file(record_path, **csv_io_kwargs("w")) as record_file: + with _generate_file( + record_path, generated_file_mode, **csv_io_kwargs("w") + ) as record_file: # Explicitly cast to typing.IO[str] as a workaround for the mypy error: # "writer" has incompatible type "BinaryIO"; expected "_Writer" writer = csv.writer(cast("IO[str]", record_file)) @@ -730,9 +890,17 @@ def install_wheel( warn_script_location: bool = True, direct_url: DirectUrl | None = None, requested: bool = False, + script_executable: str | None = None, + *, + rollback_on_error: bool = False, ) -> None: with ZipFile(wheel_path, allowZip64=True) as z: - with req_error_context(req_description): + with ( + req_error_context(req_description), + _record_wheel_installation( + z, name, scheme, rollback_on_error=rollback_on_error + ) as record, + ): _install_wheel( name=name, wheel_zip=z, @@ -742,4 +910,6 @@ def install_wheel( warn_script_location=warn_script_location, direct_url=direct_url, requested=requested, + script_executable=script_executable, + record=record, ) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/operations/prepare.py b/.venv/lib/python3.14/site-packages/pip/_internal/operations/prepare.py index 67f9ee9..374adbc 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/operations/prepare.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/operations/prepare.py @@ -12,9 +12,10 @@ from dataclasses import dataclass from pathlib import Path from typing import TYPE_CHECKING +from pip._vendor.packaging.requirements import InvalidRequirement, Requirement from pip._vendor.packaging.utils import canonicalize_name -from pip._internal.build_env import BuildEnvironmentInstaller +from pip._internal.build_env import BuildEnvironmentInstaller, BuildIsolationMode from pip._internal.distributions import make_distribution_for_install_requirement from pip._internal.distributions.installed import InstalledDistribution from pip._internal.exceptions import ( @@ -23,13 +24,16 @@ from pip._internal.exceptions import ( HashUnpinned, InstallationError, MetadataInconsistent, + MetadataInvalid, NetworkConnectionError, + SidecarMetadataInconsistent, VcsHashUnsupported, ) from pip._internal.index.package_finder import PackageFinder from pip._internal.metadata import BaseDistribution, get_metadata_distribution -from pip._internal.models.direct_url import ArchiveInfo -from pip._internal.models.link import Link +from pip._internal.metadata.direct_references import check_pypi_direct_references +from pip._internal.models.direct_url import ArchiveInfo, DirectUrl +from pip._internal.models.link import Link, join_within_directory from pip._internal.models.wheel import Wheel from pip._internal.network.download import Downloader from pip._internal.network.lazy_wheel import ( @@ -52,6 +56,7 @@ from pip._internal.utils.misc import ( hide_url, redact_auth_from_requirement, ) +from pip._internal.utils.packaging import get_requirement from pip._internal.utils.temp_dir import TempDirectory from pip._internal.utils.unpacking import unpack_file from pip._internal.vcs import vcs @@ -66,8 +71,9 @@ def _get_prepared_distribution( req: InstallRequirement, build_tracker: BuildTracker, build_env_installer: BuildEnvironmentInstaller, - build_isolation: bool, + build_isolation: BuildIsolationMode, check_build_deps: bool, + allow_editables: bool, ) -> BaseDistribution: """Prepare a distribution for installation.""" abstract_dist = make_distribution_for_install_requirement(req) @@ -75,11 +81,22 @@ def _get_prepared_distribution( if tracker_id is not None: with build_tracker.track(req, tracker_id): abstract_dist.prepare_distribution_metadata( - build_env_installer, build_isolation, check_build_deps + build_env_installer, build_isolation, check_build_deps, allow_editables ) return abstract_dist.get_metadata_distribution() +def _check_linked_requirement_metadata( + req: InstallRequirement, + distribution: BaseDistribution, +) -> None: + """Apply source-dependent checks to prepared metadata.""" + source_link = req.source_link + if source_link is None: + raise InstallationError(f"Cannot prepare {req}: the source link is missing.") + check_pypi_direct_references(distribution, source_link) + + def unpack_vcs_link(link: Link, location: str, verbosity: int) -> None: vcs_backend = vcs.get_backend_for_scheme(link.scheme) assert vcs_backend is not None @@ -201,7 +218,7 @@ def _check_download_dir( """Check download_dir for previously downloaded file with correct hash If a correct file is found return its path else None """ - download_path = os.path.join(download_dir, link.filename) + download_path = join_within_directory(download_dir, link.filename) if not os.path.exists(download_path): return None @@ -222,6 +239,91 @@ def _check_download_dir( return download_path +def _canonical_requires( + req: InstallRequirement, dist: BaseDistribution, source: str +) -> frozenset[Requirement]: + """Return the canonicalized ``Requires-Dist`` entries of ``dist``. + + ``source`` describes which metadata file ``dist`` was parsed from, for + use in error messages. + """ + canonical = set() + for raw in dist.iter_raw_dependencies(): + try: + # strip() because a folded metadata header may be returned + # with a leading newline; iter_dependencies() strips for the + # same reason. + canonical.add(get_requirement(raw.strip())) + except InvalidRequirement as e: + raise MetadataInvalid(req, f"Requires-Dist in {source}: {e}") + return frozenset(canonical) + + +def _check_sidecar_matches_wheel( + req: InstallRequirement, + sidecar_dist: BaseDistribution, + wheel_dist: BaseDistribution, +) -> None: + """Check that a .metadata-based distribution matches the wheel's METADATA. + + Compare ``Name``, ``Version``, ``Requires-Dist``, ``Requires-Python`` + and ``Provides-Extra`` between the two and abort the install on any + mismatch as PEP 658 requires the metadata files "MUST be identical". + + While the PEP doesn't mandate that consumers enforce the identical + requirement, it's good nonetheless to check to prevent confusing + behaviour when an index misbehaves. + + Also note for name and version, pip usually rejects wheels if they're + inconsistent already. Checking them again here is purely defensive. + """ + + sidecar_name = canonicalize_name(sidecar_dist.raw_name) + wheel_name = canonicalize_name(wheel_dist.raw_name) + if sidecar_name != wheel_name: + raise SidecarMetadataInconsistent(req, "Name", sidecar_name, wheel_name) + + if sidecar_dist.version != wheel_dist.version: + raise SidecarMetadataInconsistent( + req, + "Version", + str(sidecar_dist.version), + str(wheel_dist.version), + ) + + # For multi-use fields, only report the symmetric difference to avoid + # unnecessarily flagging matching values. + sidecar_requires = _canonical_requires( + req, sidecar_dist, "the PEP 658 .metadata file" + ) + wheel_requires = _canonical_requires(req, wheel_dist, "the wheel's METADATA") + if sidecar_requires != wheel_requires: + raise SidecarMetadataInconsistent( + req, + "Requires-Dist", + ", ".join(sorted(map(str, sidecar_requires - wheel_requires))), + ", ".join(sorted(map(str, wheel_requires - sidecar_requires))), + ) + + if sidecar_dist.requires_python != wheel_dist.requires_python: + raise SidecarMetadataInconsistent( + req, + "Requires-Python", + str(sidecar_dist.requires_python), + str(wheel_dist.requires_python), + ) + + sidecar_extras = frozenset(sidecar_dist.iter_provided_extras()) + wheel_extras = frozenset(wheel_dist.iter_provided_extras()) + if sidecar_extras != wheel_extras: + raise SidecarMetadataInconsistent( + req, + "Provides-Extra", + ", ".join(sorted(sidecar_extras - wheel_extras)), + ", ".join(sorted(wheel_extras - sidecar_extras)), + ) + + class RequirementPreparer: """Prepares a Requirement""" @@ -231,7 +333,7 @@ class RequirementPreparer: build_dir: str, download_dir: str | None, src_dir: str, - build_isolation: bool, + build_isolation: BuildIsolationMode, build_isolation_installer: BuildEnvironmentInstaller, check_build_deps: bool, build_tracker: BuildTracker, @@ -243,6 +345,7 @@ class RequirementPreparer: lazy_wheel: bool, verbosity: int, legacy_resolver: bool, + allow_editables: bool, ) -> None: super().__init__() @@ -285,6 +388,10 @@ class RequirementPreparer: # Previous "header" printed for a link-based InstallRequirement self._previous_requirement_header = ("", "") + # Do we allow preparing editable wheels? + # When using pip wheel, editables must still produce regular wheels + self.allow_editables = allow_editables + def _log_preparing_link(self, req: InstallRequirement) -> None: """Provide context for the requirement being prepared.""" if req.link.is_file and not req.is_wheel_from_cache: @@ -342,7 +449,8 @@ class RequirementPreparer: # (For example, we can raise VcsHashUnsupported for a VCS URL # rather than HashMissing.) if not self.require_hashes: - return req.hashes(trust_internet=True) + # An index-provided hash must not override one supplied by the user. + return req.hashes(trust_internet=not req.has_hash_options) # We could check these first 2 conditions inside unpack_url # and save repetition of conditions, but then we would @@ -529,6 +637,7 @@ class RequirementPreparer: # The file is not available, attempt to fetch only metadata metadata_dist = self._fetch_metadata_only(req) if metadata_dist is not None: + _check_linked_requirement_metadata(req, metadata_dist) req.needs_more_preparation = True req.set_dist(metadata_dist) # Ensure download_info is available even in dry-run mode @@ -586,9 +695,9 @@ class RequirementPreparer: # We need to verify hashes, and we have found the requirement in the cache # of locally built wheels. if ( - isinstance(req.download_info.info, ArchiveInfo) - and req.download_info.info.hashes - and hashes.has_one_of(req.download_info.info.hashes) + req.download_info.archive_info + and req.download_info.archive_info.hashes + and hashes.has_one_of(req.download_info.archive_info.hashes) ): # At this point we know the requirement was built from a hashable source # artifact, and we verified that the cache entry's hash of the original @@ -640,14 +749,18 @@ class RequirementPreparer: # compute it from the downloaded file. # FIXME: https://github.com/pypa/pip/issues/11943 if ( - isinstance(req.download_info.info, ArchiveInfo) - and not req.download_info.info.hashes + req.download_info.archive_info + and not req.download_info.archive_info.hashes and local_file ): hash = hash_file(local_file.path)[0].hexdigest() - # We populate info.hash for backward compatibility. - # This will automatically populate info.hashes. - req.download_info.info.hash = f"sha256={hash}" + # We populate archive_info.hashes. For backward compatibility, + # the legacy hash field will be generated when converting to JSON. + req.download_info = DirectUrl( + url=req.download_info.url, + archive_info=ArchiveInfo(hashes={"sha256": hash}), + subdirectory=req.download_info.subdirectory, + ) # For use in later processing, # preserve the file path on the requirement. @@ -660,7 +773,30 @@ class RequirementPreparer: self.build_env_installer, self.build_isolation, self.check_build_deps, + self.allow_editables, ) + _check_linked_requirement_metadata(req, dist) + + # If a PEP 658 .metadata file was used, check that fields relevant for + # dependency resolution match with the wheel's METADATA file. + # + # NOTE: PEP 658 also permits .metadata files for source distributions, + # but PyPI doesn't serve such files. In addition, an sdist's metadata + # is generated at build time and may legitimately differ from what the + # index declared, so it's been decided to skip this check for sdists. + # This can change later if needed. + # + # TODO: this is a hack for checking whether a distribution is metadata- + # only or not. If/when we refactor distributions to delineate between + # metadata-only and concrete distributions, clean this up. + if ( + link.is_wheel + and req._distribution is not None + and req._distribution is not dist + and link.metadata_link() is not None + ): + _check_sidecar_matches_wheel(req, req._distribution, dist) + return dist def save_linked_requirement(self, req: InstallRequirement) -> None: @@ -683,7 +819,7 @@ class RequirementPreparer: # No distribution was downloaded for this requirement. return - download_location = os.path.join(self.download_dir, link.filename) + download_location = join_within_directory(self.download_dir, link.filename) if not os.path.exists(download_location): shutil.copy(req.local_file_path, download_location) download_path = display_path(download_location) @@ -716,6 +852,7 @@ class RequirementPreparer: self.build_env_installer, self.build_isolation, self.check_build_deps, + self.allow_editables, ) req.check_if_exists(self.use_user_site) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/req/__init__.py b/.venv/lib/python3.14/site-packages/pip/_internal/req/__init__.py index 5fc8752..2059fcc 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/req/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/req/__init__.py @@ -44,6 +44,7 @@ def install_given_reqs( use_user_site: bool, pycompile: bool, progress_bar: BarType, + script_executable: str | None = None, ) -> list[InstallationResult]: """ Install everything in the given list. @@ -73,6 +74,7 @@ def install_given_reqs( for requirement in items: req_name = requirement.name assert req_name is not None + if requirement.should_reinstall: logger.info("Attempting uninstall: %s", req_name) with indent_log(): @@ -88,6 +90,10 @@ def install_given_reqs( warn_script_location=warn_script_location, use_user_site=use_user_site, pycompile=pycompile, + script_executable=script_executable, + rollback_on_error=bool( + uninstalled_pathset and uninstalled_pathset.can_rollback + ), ) except Exception: # if install did not succeed, rollback previous uninstall diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/req/constructors.py b/.venv/lib/python3.14/site-packages/pip/_internal/req/constructors.py index 7fef6b7..99dbc8c 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/req/constructors.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/req/constructors.py @@ -14,15 +14,15 @@ import copy import logging import os import re -from collections.abc import Collection +from collections.abc import Collection, Mapping from dataclasses import dataclass -from pip._vendor.packaging.markers import Marker +from pip._vendor.packaging import pylock +from pip._vendor.packaging.markers import InvalidMarker, Marker from pip._vendor.packaging.requirements import InvalidRequirement, Requirement -from pip._vendor.packaging.specifiers import Specifier +from pip._vendor.packaging.utils import parse_sdist_filename, parse_wheel_filename from pip._internal.exceptions import InstallationError -from pip._internal.models.index import PyPI, TestPyPI from pip._internal.models.link import Link from pip._internal.models.wheel import Wheel from pip._internal.req.req_file import ParsedRequirement @@ -30,7 +30,14 @@ from pip._internal.req.req_install import InstallRequirement from pip._internal.utils.filetypes import is_archive_file from pip._internal.utils.misc import is_installable_dir from pip._internal.utils.packaging import get_requirement -from pip._internal.utils.urls import path_to_url +from pip._internal.utils.pylock import ( + package_archive_requirement_url, + package_directory_requirement_url, + package_sdist_requirement_url, + package_vcs_requirement_url, + package_wheel_requirement_url, +) +from pip._internal.utils.urls import path_to_url, strip_extras from pip._internal.vcs import is_url, vcs __all__ = [ @@ -40,25 +47,10 @@ __all__ = [ ] logger = logging.getLogger(__name__) -operators = Specifier._operators.keys() - -def _strip_extras(path: str) -> tuple[str, str | None]: - m = re.match(r"^(.+)(\[[^\]]+\])$", path) - extras = None - if m: - path_no_extras = m.group(1).rstrip() - extras = m.group(2) - else: - path_no_extras = path - - return path_no_extras, extras - - -def convert_extras(extras: str | None) -> set[str]: - if not extras: - return set() - return get_requirement("placeholder" + extras.lower()).extras +# All standard version specifier operators +# https://packaging.python.org/en/latest/specifications/version-specifiers/#id5 +operators = ("~=", "==", "!=", "<=", ">=", "<", ">", "===") def _set_requirement_extras(req: Requirement, new_extras: set[str]) -> Requirement: @@ -108,7 +100,7 @@ def _parse_pip_syntax_editable(editable_req: str) -> tuple[str | None, str, set[ url = editable_req # If a file path is specified with extras, strip off the extras. - url_no_extras, extras = _strip_extras(url) + url_no_extras, extras = strip_extras(url) if os.path.isdir(url_no_extras): # Treating it as code that has already been checked out @@ -116,14 +108,7 @@ def _parse_pip_syntax_editable(editable_req: str) -> tuple[str | None, str, set[ if url_no_extras.lower().startswith("file:"): package_name = Link(url_no_extras).egg_fragment - if extras: - return ( - package_name, - url_no_extras, - get_requirement("placeholder" + extras.lower()).extras, - ) - else: - return package_name, url_no_extras, set() + return (package_name, url_no_extras, extras) for version_control in vcs: if url.lower().startswith(f"{version_control}:"): @@ -255,7 +240,6 @@ def install_req_from_editable( hash_options: dict[str, list[str]] | None = None, constraint: bool = False, user_supplied: bool = False, - permit_editable_wheels: bool = False, config_settings: dict[str, str | list[str]] | None = None, ) -> InstallRequirement: if constraint: @@ -267,7 +251,6 @@ def install_req_from_editable( comes_from=comes_from, user_supplied=user_supplied, editable=True, - permit_editable_wheels=permit_editable_wheels, link=parts.link, constraint=constraint, isolated=isolated, @@ -341,19 +324,22 @@ def parse_req_from_line(name: str, line_source: str | None) -> RequirementParts: if not markers_as_string: markers = None else: - markers = Marker(markers_as_string) + try: + markers = Marker(markers_as_string) + except InvalidMarker as exc: + raise InstallationError(f"Invalid requirement: {name.strip()!r}: {exc}") else: markers = None name = name.strip() req_as_string = None path = os.path.normpath(os.path.abspath(name)) link = None - extras_as_string = None if is_url(name): link = Link(name) + extras: set[str] = set() else: - p, extras_as_string = _strip_extras(path) + p, extras = strip_extras(path) url = _get_url_from_path(p, name) if url is not None: link = Link(url) @@ -376,8 +362,6 @@ def parse_req_from_line(name: str, line_source: str | None) -> RequirementParts: else: req_as_string = name - extras = convert_extras(extras_as_string) - def with_source(text: str) -> str: if not line_source: return text @@ -453,23 +437,6 @@ def install_req_from_req_string( except InvalidRequirement as exc: raise InstallationError(f"Invalid requirement: {req_string!r}: {exc}") - domains_not_allowed = [ - PyPI.file_storage_domain, - TestPyPI.file_storage_domain, - ] - if ( - req.url - and comes_from - and comes_from.link - and comes_from.link.netloc in domains_not_allowed - ): - # Explicitly disallow pypi packages that depend on external urls - raise InstallationError( - "Packages installed from PyPI cannot depend on packages " - "which are not also hosted on PyPI.\n" - f"{comes_from.name} depends on {req} " - ) - return InstallRequirement( req, comes_from, @@ -546,7 +513,7 @@ def install_req_drop_extras(ireq: InstallRequirement) -> InstallRequirement: extras=[], config_settings=ireq.config_settings, user_supplied=ireq.user_supplied, - permit_editable_wheels=ireq.permit_editable_wheels, + source_link=ireq.source_link, ) @@ -566,3 +533,95 @@ def install_req_extend_extras( else None ) return result + + +def _pylock_hashes_to_hash_options(hashes: Mapping[str, str]) -> dict[str, list[str]]: + return {k: [v] for k, v in hashes.items()} + + +def install_req_from_pylock_package( + package: pylock.Package, + package_dist: ( + pylock.PackageVcs + | pylock.PackageArchive + | pylock.PackageDirectory + | pylock.PackageSdist + | pylock.PackageWheel + ), + pylock_path_or_url: str, + user_supplied: bool, +) -> tuple[InstallRequirement, Link | None]: + """Construct an InstallRequirement from a pylock package and artifact. + + If the artifact is a Sdist or Wheel, also return a locked Link which + is meant to override candidates from indexes or --find-links. + """ + # TODO: validate file size + if isinstance(package_dist, pylock.PackageVcs): + req_url = package_vcs_requirement_url(pylock_path_or_url, package_dist) + return ( + InstallRequirement( + req=Requirement(f"{package.name} @ {req_url}"), + comes_from=pylock_path_or_url, + user_supplied=user_supplied, + ), + None, + ) + elif isinstance(package_dist, pylock.PackageArchive): + req_url = package_archive_requirement_url(pylock_path_or_url, package_dist) + return ( + InstallRequirement( + req=Requirement(f"{package.name} @ {req_url}"), + comes_from=pylock_path_or_url, + hash_options=_pylock_hashes_to_hash_options(package_dist.hashes), + user_supplied=user_supplied, + ), + None, + ) + elif isinstance(package_dist, pylock.PackageDirectory): + req_url = package_directory_requirement_url(pylock_path_or_url, package_dist) + if package_dist.editable: + return ( + install_req_from_editable( + req_url, + comes_from=pylock_path_or_url, + user_supplied=user_supplied, + ), + None, + ) + else: + return ( + install_req_from_line( + req_url, + comes_from=pylock_path_or_url, + user_supplied=user_supplied, + ), + None, + ) + else: + # wheel or sdist + version = package.version + if isinstance(package_dist, pylock.PackageWheel): + if not version: + _, version, _, _ = parse_wheel_filename(package_dist.filename) + requirement_url = package_wheel_requirement_url( + pylock_path_or_url, package_dist + ) + elif isinstance(package_dist, pylock.PackageSdist): + if not version: + _, version = parse_sdist_filename(package_dist.filename) + requirement_url = package_sdist_requirement_url( + pylock_path_or_url, package_dist + ) + ireq = InstallRequirement( + req=Requirement(f"{package.name}=={version}"), + comes_from=pylock_path_or_url, + hash_options=_pylock_hashes_to_hash_options(package_dist.hashes), + user_supplied=user_supplied, + ) + locked_link = Link( + requirement_url, + comes_from=pylock_path_or_url, + upload_time=package_dist.upload_time, + ) + return ireq, locked_link diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/req/pep723.py b/.venv/lib/python3.14/site-packages/pip/_internal/req/pep723.py index 805abed..2e0c1b9 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/req/pep723.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/req/pep723.py @@ -14,7 +14,7 @@ class PEP723Exception(ValueError): def pep723_metadata(scriptfile: str) -> dict[str, Any]: - with open(scriptfile) as f: + with open(scriptfile, encoding="utf8") as f: script = f.read() name = "script" diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_dependency_group.py b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_dependency_group.py index 396ac1b..eb9d802 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_dependency_group.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_dependency_group.py @@ -1,7 +1,8 @@ from collections.abc import Iterable, Iterator from typing import Any -from pip._vendor.dependency_groups import DependencyGroupResolver +from pip._vendor.packaging.dependency_groups import DependencyGroupResolver +from pip._vendor.packaging.errors import ExceptionGroup from pip._internal.exceptions import InstallationError from pip._internal.utils.compat import tomllib @@ -28,11 +29,13 @@ def _resolve_all_groups( resolver = resolvers[path] try: yield from (str(req) for req in resolver.resolve(groupname)) - except (ValueError, TypeError, LookupError) as e: + except ExceptionGroup as eg: + # Convert ExceptionGroup to a single InstallationError with all messages + messages = [str(e) for e in eg.exceptions] raise InstallationError( f"[dependency-groups] resolution failed for '{groupname}' " - f"from '{path}': {e}" - ) from e + f"from '{path}': {'; '.join(messages)}" + ) from eg def _build_resolvers(paths: Iterable[str]) -> dict[str, Any]: @@ -54,7 +57,15 @@ def _build_resolvers(paths: Iterable[str]) -> dict[str, Any]: "Cannot resolve '--group' option." ) - resolvers[path] = DependencyGroupResolver(raw_dependency_groups) + try: + resolvers[path] = DependencyGroupResolver(raw_dependency_groups) + except ExceptionGroup as eg: + # Handle ExceptionGroup from resolver initialization + messages = [str(e) for e in eg.exceptions] + raise InstallationError( + f"[dependency-groups] data was invalid in {path}: {'; '.join(messages)}" + ) from eg + return resolvers diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_file.py b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_file.py index 9eb58ce..400bb86 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_file.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_file.py @@ -5,7 +5,6 @@ Requirements file parsing from __future__ import annotations import codecs -import locale import logging import optparse import os @@ -13,13 +12,12 @@ import re import shlex import sys import urllib.parse -from collections.abc import Generator, Iterable +from collections.abc import Callable, Generator, Iterable from dataclasses import dataclass from optparse import Values from typing import ( TYPE_CHECKING, Any, - Callable, NoReturn, ) @@ -27,6 +25,7 @@ from pip._internal.cli import cmdoptions from pip._internal.exceptions import InstallationError, RequirementsFileParseError from pip._internal.models.release_control import ReleaseControl from pip._internal.models.search_scope import SearchScope +from pip._internal.utils.compat import get_locale_encoding if TYPE_CHECKING: from pip._internal.index.package_finder import PackageFinder @@ -59,6 +58,7 @@ SUPPORTED_OPTIONS: list[Callable[..., optparse.Option]] = [ cmdoptions.only_binary, cmdoptions.prefer_binary, cmdoptions.require_hashes, + cmdoptions.no_require_hashes, cmdoptions.pre, cmdoptions.all_releases, cmdoptions.only_final, @@ -101,18 +101,8 @@ DEFAULT_ENCODING = "utf-8" logger = logging.getLogger(__name__) -@dataclass(frozen=True) +@dataclass(frozen=True, slots=True) class ParsedRequirement: - # TODO: replace this with slots=True when dropping Python 3.9 support. - __slots__ = ( - "requirement", - "is_editable", - "comes_from", - "constraint", - "options", - "line_source", - ) - requirement: str is_editable: bool comes_from: str @@ -121,10 +111,8 @@ class ParsedRequirement: line_source: str | None -@dataclass(frozen=True) +@dataclass(frozen=True, slots=True) class ParsedLine: - __slots__ = ("filename", "lineno", "args", "opts", "constraint") - filename: str lineno: int args: str @@ -237,6 +225,8 @@ def handle_option_line( # percolate options upward if opts.require_hashes: options.require_hashes = opts.require_hashes + if opts.no_require_hashes: + options.no_require_hashes = opts.no_require_hashes if opts.features_enabled: options.features_enabled.extend( f for f in opts.features_enabled if f not in options.features_enabled @@ -412,7 +402,7 @@ class RequirementsFileParser: def _parse_file( self, filename: str, constraint: bool ) -> Generator[ParsedLine, None, None]: - _, content = get_file_content(filename, self._session) + _, content = get_file_content(filename, self._session, constraint=constraint) lines_enum = preprocess(content) @@ -531,8 +521,6 @@ def join_lines(lines_enum: ReqFileLines) -> ReqFileLines: assert primary_line_number is not None yield primary_line_number, "".join(new_line) - # TODO: handle space after '\'. - def ignore_comments(lines_enum: ReqFileLines) -> ReqFileLines: """ @@ -572,7 +560,9 @@ def expand_env_variables(lines_enum: ReqFileLines) -> ReqFileLines: yield line_number, line -def get_file_content(url: str, session: PipSession) -> tuple[str, str]: +def get_file_content( + url: str, session: PipSession, *, constraint: bool = False +) -> tuple[str, str]: """Gets the content of a file; it may be a filename, file: URL, or http: URL. Returns (location, content). Content is unicode. Respects # -*- coding: declarations on the retrieved files. @@ -595,7 +585,8 @@ def get_file_content(url: str, session: PipSession) -> tuple[str, str]: with open(url, "rb") as f: raw_content = f.read() except OSError as exc: - raise InstallationError(f"Could not open requirements file: {exc}") + kind = "constraint" if constraint else "requirements" + raise InstallationError(f"Could not open {kind} file: {exc}") content = _decode_req_file(raw_content, url) @@ -617,7 +608,7 @@ def _decode_req_file(data: bytes, url: str) -> str: try: return data.decode(DEFAULT_ENCODING) except UnicodeDecodeError: - locale_encoding = locale.getpreferredencoding(False) or sys.getdefaultencoding() + locale_encoding = get_locale_encoding() or sys.getdefaultencoding() logging.warning( "unable to decode data from %s with default encoding %s, " "falling back to encoding from locale: %s. " diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_install.py b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_install.py index bd4fb07..93ea8be 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_install.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_install.py @@ -34,7 +34,6 @@ from pip._internal.models.direct_url import DirectUrl from pip._internal.models.link import Link from pip._internal.operations.build.metadata import generate_metadata from pip._internal.operations.build.metadata_editable import generate_editable_metadata -from pip._internal.operations.install.wheel import install_wheel from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path from pip._internal.req.req_uninstall import UninstallPathSet from pip._internal.utils.deprecation import deprecated @@ -49,9 +48,9 @@ from pip._internal.utils.misc import ( redact_auth_from_requirement, redact_auth_from_url, ) -from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.packaging import get_requirement, requirement_without_marker from pip._internal.utils.subprocess import runner_with_spinner_message -from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds +from pip._internal.utils.temp_dir import TempDirectory, TempDirectoryKind from pip._internal.utils.unpacking import unpack_file from pip._internal.utils.virtualenv import running_under_virtualenv from pip._internal.vcs import vcs @@ -75,19 +74,18 @@ class InstallRequirement: markers: Marker | None = None, isolated: bool = False, *, + source_link: Link | None = None, hash_options: dict[str, list[str]] | None = None, config_settings: dict[str, str | list[str]] | None = None, constraint: bool = False, extras: Collection[str] = (), user_supplied: bool = False, - permit_editable_wheels: bool = False, ) -> None: assert req is None or isinstance(req, Requirement), req self.req = req self.comes_from = comes_from self.constraint = constraint self.editable = editable - self.permit_editable_wheels = permit_editable_wheels # source_dir is the local directory where the linked requirement is # located, or unpacked. In case unpacking is needed, creating and @@ -107,6 +105,10 @@ class InstallRequirement: link = Link(req.url) self.link = self.original_link = link + # The link selected before wheel-cache substitution. Unlike ``link``, this + # does not change when pip substitutes a locally built cached wheel. + self._source_link = source_link if source_link is not None else link + # When this InstallRequirement is a wheel obtained from the cache of locally # built wheels, this is the source link corresponding to the cache entry, which # was used to download and build the cached wheel. @@ -170,6 +172,8 @@ class InstallRequirement: self.requirements_to_check: list[str] = [] # The PEP 517 backend we should use to build the project + self._pep517_backend_spec: str + self._pep517_backend_path: str | None self.pep517_backend: BuildBackendHookCaller | None = None # This requirement needs more preparation before it can be built @@ -179,8 +183,20 @@ class InstallRequirement: self._archive_source: Path | None = None def __str__(self) -> str: + return self._format() + + def format_without_marker(self) -> str: + """Like ``str(self)``, but without the requirement's environment marker. + + For error messages, where markers such as ``extra == "foo"`` are noise. + ``self.req`` and ``self.markers`` are not modified. + """ + return self._format(include_marker=False) + + def _format(self, include_marker: bool = True) -> str: if self.req: - s = redact_auth_from_requirement(self.req) + req = self.req if include_marker else requirement_without_marker(self.req) + s = redact_auth_from_requirement(req) if self.link: s += f" from {redact_auth_from_url(self.link.url)}" elif self.link: @@ -229,12 +245,13 @@ class InstallRequirement: @functools.cached_property def supports_pyproject_editable(self) -> bool: assert self.pep517_backend + assert isinstance(self.pep517_backend, ConfiguredBuildBackendHookCaller) with self.build_env: runner = runner_with_spinner_message( "Checking if build backend supports build_editable" ) with self.pep517_backend.subprocess_runner(runner): - return "build_editable" in self.pep517_backend._supported_features() + return self.pep517_backend.supports_feature("build_editable") @property def specifier(self) -> SpecifierSet: @@ -246,6 +263,19 @@ class InstallRequirement: """Whether this requirement was specified as a direct URL.""" return self.original_link is not None + @property + def source_link(self) -> Link | None: + """The link selected before wheel-cache substitution.""" + return self._source_link + + def set_source_link(self, link: Link) -> None: + """Record the selected source link, rejecting later changes.""" + if self._source_link is None: + self._source_link = link + return + if self._source_link != link: + raise InstallationError(f"Cannot change the source link for {self}.") + @property def is_pinned(self) -> bool: """Return whether I am pinned to an exact version. @@ -332,7 +362,7 @@ class InstallRequirement: # builds (such as numpy). Thus, we ensure that the real path # is returned. self._temp_build_dir = TempDirectory( - kind=tempdir_kinds.REQ_BUILD, globally_managed=True + kind=TempDirectoryKind.REQ_BUILD, globally_managed=True ) return self._temp_build_dir.path @@ -359,7 +389,7 @@ class InstallRequirement: return TempDirectory( path=actual_build_dir, delete=delete_arg, - kind=tempdir_kinds.REQ_BUILD, + kind=TempDirectoryKind.REQ_BUILD, globally_managed=True, ).path @@ -486,11 +516,26 @@ class InstallRequirement: requires, backend, check, backend_path = pyproject_toml_data self.requirements_to_check = check self.pyproject_requires = requires + self._pep517_backend_spec = backend + self._pep517_backend_path = backend_path + + def configure_backend(self, python_executable: str) -> None: + """Set up the build backend hook caller. + + This is done separately after pyproject.toml loading as the backend + need to be called with the build environment's Python executable, + which can vary.""" self.pep517_backend = ConfiguredBuildBackendHookCaller( self, self.unpacked_source_directory, - backend, - backend_path=backend_path, + self._pep517_backend_spec, + backend_path=self._pep517_backend_path, + python_executable=python_executable, + backend_warning_level=( + logging.WARNING + if self.link and self.link.is_existing_dir() + else logging.DEBUG + ), ) def editable_sanity_check(self) -> None: @@ -506,7 +551,7 @@ class InstallRequirement: f"Consider using a build backend that supports PEP 660." ) - def prepare_metadata(self) -> None: + def prepare_metadata(self, allow_editables: bool) -> None: """Ensure that project metadata is available. Under PEP 517 and PEP 660, call the backend hook to prepare the metadata. @@ -516,11 +561,7 @@ class InstallRequirement: details = self.name or f"from {self.link}" assert self.pep517_backend is not None - if ( - self.editable - and self.permit_editable_wheels - and self.supports_pyproject_editable - ): + if self.editable and allow_editables and self.supports_pyproject_editable: self.metadata_directory = generate_editable_metadata( build_env=self.build_env, backend=self.pep517_backend, @@ -764,7 +805,17 @@ class InstallRequirement: warn_script_location: bool = True, use_user_site: bool = False, pycompile: bool = True, + script_executable: str | None = None, + *, + rollback_on_error: bool = False, ) -> None: + # Lazy import to avoid transitively importing `_vendor.distlib.compat` + # which in turn imports `urllib.request` which is slow. + # During an actual installation, `urllib.request` will end up imported anyway, + # but `req.req_install` (this module) is also imported from commands that + # don't actually install anything (e.g. `pip freeze` or `pip show`). + from pip._internal.operations.install.wheel import install_wheel + assert self.req is not None scheme = get_scheme( self.req.name, @@ -787,6 +838,8 @@ class InstallRequirement: warn_script_location=warn_script_location, direct_url=self.download_info if self.is_direct else None, requested=self.user_supplied, + script_executable=script_executable, + rollback_on_error=rollback_on_error, ) self.install_succeeded = True diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_uninstall.py b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_uninstall.py index 3f3dde2..6db641f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/req/req_uninstall.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/req/req_uninstall.py @@ -2,19 +2,24 @@ from __future__ import annotations import functools import os +import shutil import sys import sysconfig -from collections.abc import Generator, Iterable +from collections.abc import Callable, Generator, Iterable from importlib.util import cache_from_source -from typing import Any, Callable +from typing import Any -from pip._internal.exceptions import LegacyDistutilsInstall, UninstallMissingRecord +from pip._internal.exceptions import ( + BlockedImportError, + LegacyDistutilsInstall, + UninstallMissingRecord, +) from pip._internal.locations import get_bin_prefix, get_bin_user from pip._internal.metadata import BaseDistribution from pip._internal.utils.compat import WINDOWS from pip._internal.utils.egg_link import egg_link_path_from_location from pip._internal.utils.logging import getLogger, indent_log -from pip._internal.utils.misc import ask, normalize_path, renames, rmtree +from pip._internal.utils.misc import ask, normalize_path, rmtree from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory from pip._internal.utils.virtualenv import running_under_virtualenv @@ -96,14 +101,19 @@ def compact(paths: Iterable[str]) -> set[str]: sep = os.path.sep short_paths: set[str] = set() + prefixes: set[str] = set() + for path in sorted(paths, key=len): - should_skip = any( - path.startswith(shortpath.rstrip("*")) - and path[len(shortpath.rstrip("*").rstrip(sep))] == sep - for shortpath in short_paths - ) - if not should_skip: + current = path[:-1] if path.endswith(sep + "*") else path + parent = current.rstrip(sep) + while parent: + if parent in prefixes: + break + next_parent = os.path.dirname(parent).rstrip(sep) + parent = "" if next_parent == parent else next_parent + else: short_paths.add(path) + prefixes.add(current.rstrip(sep)) return short_paths @@ -201,6 +211,8 @@ class StashedUninstallPathSet: # (old path, new path) tuples for each move that may need # to be undone. self._moves: list[tuple[str, str]] = [] + # Interrupted transfers must not be retried automatically. + self._manual_recovery: list[tuple[str, str]] = [] def _get_directory_stash(self, path: str) -> str: """Stashes a directory. @@ -244,52 +256,103 @@ class StashedUninstallPathSet: return save_dir.path def stash(self, path: str) -> str: - """Stashes the directory or file and returns its new location. - Handle symlinks as files to avoid modifying the symlink targets. - """ + """Move a path into temporary storage and return its new location.""" path_is_dir = os.path.isdir(path) and not os.path.islink(path) if path_is_dir: new_path = self._get_directory_stash(path) else: new_path = self._get_file_stash(path) - self._moves.append((path, new_path)) if path_is_dir and os.path.isdir(new_path): - # If we're moving a directory, we need to - # remove the destination first or else it will be - # moved to inside the existing directory. - # We just created new_path ourselves, so it will - # be removable. + # Remove the empty placeholder so the directory moves to this exact path. os.rmdir(new_path) - renames(path, new_path) + + parent = os.path.dirname(new_path) + if not os.path.exists(parent): + os.makedirs(parent) + + try: + shutil.move(path, new_path) + except BaseException: + if os.path.lexists(new_path): + # A failed move may leave either path with only part of the data. + self._manual_recovery.append((path, new_path)) + raise + self._moves.append((path, new_path)) + + old_parent, name = os.path.split(path) + if old_parent and name: + try: + os.removedirs(old_parent) + except OSError: + pass + return new_path def commit(self) -> None: - """Commits the uninstall by removing stashed files.""" + """Remove backups unless an interrupted transfer needs manual recovery.""" + if self._manual_recovery: + return + for save_dir in self._save_dirs.values(): save_dir.cleanup() self._moves = [] self._save_dirs = {} + def _restore(self, original: str, stashed: str) -> None: + """Restore a completed stash and record failures for manual recovery.""" + try: + # Check the backup before removing a replacement. + os.lstat(stashed) + + if os.path.isfile(original) or os.path.islink(original): + os.unlink(original) + elif os.path.isdir(original): + rmtree(original) + + parent, name = os.path.split(original) + if parent and name and not os.path.exists(parent): + os.makedirs(parent) + + shutil.move(stashed, original) + except BaseException: + self._manual_recovery.append((original, stashed)) + raise + def rollback(self) -> None: - """Undoes the uninstall by moving stashed files back.""" + """Restore stashed files, keeping backups when restoration fails.""" for p in self._moves: logger.info("Moving to %s\n from %s", *p) - for new_path, path in self._moves: - try: - logger.debug("Replacing %s from %s", new_path, path) - if os.path.isfile(new_path) or os.path.islink(new_path): - os.unlink(new_path) - elif os.path.isdir(new_path): - rmtree(new_path) - renames(path, new_path) - except OSError as ex: - logger.error("Failed to restore %s", new_path) - logger.debug("Exception: %s", ex) + attempted: set[tuple[str, str]] = set() + try: + for original, stashed in self._moves: + try: + logger.debug("Replacing %s from %s", original, stashed) + attempted.add((original, stashed)) + self._restore(original, stashed) + except OSError as ex: + logger.debug("Exception: %s", ex) + finally: + # Retrying an interrupted move could overwrite the complete copy. + self._moves = [move for move in self._moves if move not in attempted] self.commit() + def report_failed_recovery(self) -> None: + """Report retained backups that still need manual restoration.""" + for original, backup in self.recovery_paths: + logger.error( + "Could not restore %r from %r. Check both paths before retrying.", + original, + backup, + ) + + @property + def recovery_paths(self) -> tuple[tuple[str, str], ...]: + """Return original paths and their pending backup locations.""" + return tuple(self._moves + self._manual_recovery) + @property def can_rollback(self) -> bool: return bool(self._moves) @@ -369,14 +432,22 @@ class UninstallPathSet: for_rename = compress_for_rename(self._paths) - for path in sorted(compact(for_rename)): - moved.stash(path) - logger.verbose("Removing file or directory %s", path) + try: + for path in sorted(compact(for_rename)): + moved.stash(path) + logger.verbose("Removing file or directory %s", path) - for pth in self._pth.values(): - pth.remove() + for pth in self._pth.values(): + pth.remove() - logger.info("Successfully uninstalled %s", dist_name_version) + logger.info("Successfully uninstalled %s", dist_name_version) + except (OSError, BlockedImportError): + if moved.can_rollback: + self.rollback() + else: + moved.commit() + moved.report_failed_recovery() + raise def _allowed_to_proceed(self, verbose: bool) -> bool: """Display which files would be deleted and prompt for confirmation""" @@ -406,16 +477,24 @@ class UninstallPathSet: return ask("Proceed (Y/n)? ", ("y", "n", "")) != "n" + @property + def can_rollback(self) -> bool: + return self._moved_paths.can_rollback + def rollback(self) -> None: """Rollback the changes previously made by remove().""" - if not self._moved_paths.can_rollback: + # Manual file recovery can still leave saved .pth entries to restore. + if not self.can_rollback and not self._moved_paths.recovery_paths: logger.error( "Can't roll back %s; was not uninstalled", self._dist.raw_name, ) return logger.info("Rolling back uninstall of %s", self._dist.raw_name) - self._moved_paths.rollback() + try: + self._moved_paths.rollback() + finally: + self._moved_paths.report_failed_recovery() for pth in self._pth.values(): pth.rollback() @@ -609,23 +688,26 @@ class UninstallPthEntries: if not os.path.isfile(self.file): logger.warning("Cannot remove entries from nonexistent file %s", self.file) return + with open(self.file, "rb") as fh: - # windows uses '\r\n' with py3k, but uses '\n' with py2.x lines = fh.readlines() - self._saved_lines = lines + self._saved_lines = lines.copy() + if any(b"\r\n" in line for line in lines): endline = "\r\n" else: endline = "\n" - # handle missing trailing newline + # Match entries even when the last line has no newline. if lines and not lines[-1].endswith(endline.encode("utf-8")): lines[-1] = lines[-1] + endline.encode("utf-8") + for entry in self.entries: try: logger.verbose("Removing entry: %s", entry) lines.remove((entry + endline).encode("utf-8")) except ValueError: pass + with open(self.file, "wb") as fh: fh.writelines(lines) @@ -633,7 +715,15 @@ class UninstallPthEntries: if self._saved_lines is None: logger.error("Cannot roll back changes to %s, none were made", self.file) return False + logger.debug("Rolling %s back to previous state", self.file) - with open(self.file, "wb") as fh: - fh.writelines(self._saved_lines) + try: + with open(self.file, "wb") as fh: + fh.writelines(self._saved_lines) + except (OSError, BlockedImportError): + logger.error( + "Could not restore %r. Check this file before retrying.", self.file + ) + raise + return True diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/base.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/base.py index 5ec4d96..3e35de7 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/base.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/base.py @@ -1,10 +1,10 @@ -from typing import Callable, Optional +from collections.abc import Callable from pip._internal.req.req_install import InstallRequirement from pip._internal.req.req_set import RequirementSet InstallRequirementProvider = Callable[ - [str, Optional[InstallRequirement]], InstallRequirement + [str, InstallRequirement | None], InstallRequirement ] diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/legacy/resolver.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/legacy/resolver.py index 33a4fdc..4a9004c 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/legacy/resolver.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/legacy/resolver.py @@ -17,7 +17,6 @@ import sys from collections import defaultdict from collections.abc import Iterable from itertools import chain -from typing import Optional from pip._vendor.packaging import specifiers from pip._vendor.packaging.requirements import Requirement @@ -52,7 +51,7 @@ from pip._internal.utils.packaging import check_requires_python logger = logging.getLogger(__name__) -DiscoveredDependencies = defaultdict[Optional[str], list[InstallRequirement]] +DiscoveredDependencies = defaultdict[str | None, list[InstallRequirement]] def _check_dist_requires_python( @@ -124,6 +123,7 @@ class Resolver(BaseResolver): make_install_req: InstallRequirementProvider, use_user_site: bool, ignore_dependencies: bool, + only_dependencies: bool, # unused, for compatibility with new resolver ignore_installed: bool, ignore_requires_python: bool, force_reinstall: bool, @@ -410,11 +410,13 @@ class Resolver(BaseResolver): If preparer.require_hashes is True, don't use the wheel cache, because cached wheels, always built locally, have different hashes than the files downloaded from the index server and thus throw false hash - mismatches. Furthermore, cached wheels at present have undeterministic + mismatches. Furthermore, cached wheels at present have nondeterministic contents due to file modification times. """ if req.link is None: req.link = self._find_requirement_link(req) + if req.link is not None: + req.set_source_link(req.link) if self.wheel_cache is None or self.preparer.require_hashes: return diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/base.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/base.py index 03877b6..9d75183 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/base.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/base.py @@ -12,7 +12,7 @@ from pip._internal.models.link import Link, links_equivalent from pip._internal.req.req_install import InstallRequirement from pip._internal.utils.hashes import Hashes -CandidateLookup = tuple[Optional["Candidate"], Optional[InstallRequirement]] +CandidateLookup = tuple[Optional["Candidate"], InstallRequirement | None] def format_name(project: NormalizedName, extras: frozenset[NormalizedName]) -> str: @@ -26,16 +26,23 @@ def format_name(project: NormalizedName, extras: frozenset[NormalizedName]) -> s class Constraint: specifier: SpecifierSet hashes: Hashes + hash_options: dict[str, list[str]] links: frozenset[Link] @classmethod def empty(cls) -> Constraint: - return Constraint(SpecifierSet(), Hashes(), frozenset()) + return Constraint(SpecifierSet(), Hashes(), {}, frozenset()) @classmethod def from_ireq(cls, ireq: InstallRequirement) -> Constraint: links = frozenset([ireq.link]) if ireq.link else frozenset() - return Constraint(ireq.specifier, ireq.hashes(trust_internet=False), links) + hash_options = {alg: list(v) for alg, v in ireq.hash_options.items()} + return Constraint( + ireq.specifier, + ireq.hashes(trust_internet=False), + hash_options, + links, + ) def __bool__(self) -> bool: return bool(self.specifier) or bool(self.hashes) or bool(self.links) @@ -45,10 +52,19 @@ class Constraint: return NotImplemented specifier = self.specifier & other.specifier hashes = self.hashes & other.hashes(trust_internet=False) + if not self.hash_options: + hash_options = {alg: list(v) for alg, v in other.hash_options.items()} + elif not other.hash_options: + hash_options = {alg: list(v) for alg, v in self.hash_options.items()} + else: + hash_options = { + alg: [v for v in other.hash_options[alg] if v in self.hash_options[alg]] + for alg in self.hash_options.keys() & other.hash_options.keys() + } links = self.links if other.link: links = links.union([other.link]) - return Constraint(specifier, hashes, links) + return Constraint(specifier, hashes, hash_options, links) def is_satisfied_by(self, candidate: Candidate) -> bool: # Reject if there are any mismatched URL constraints on this package. @@ -59,6 +75,12 @@ class Constraint: # prerelease candidates if the user does not expect them. return self.specifier.contains(candidate.version, prereleases=True) + def format_for_error(self) -> str: + s = str(self.specifier) + if self.links: + s += f" (from {', '.join(str(link) for link in self.links)})" + return s + class Requirement: @property diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/candidates.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/candidates.py index aa126d4..05e469e 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/candidates.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/candidates.py @@ -58,10 +58,19 @@ def as_base_candidate(candidate: Candidate) -> BaseCandidate | None: def make_install_req_from_link( - link: Link, template: InstallRequirement + link: Link, + template: InstallRequirement, + version: Version | None = None, + *, + source_link: Link, ) -> InstallRequirement: assert not template.editable, "template is editable" - if template.req: + if version is not None and template.req and template.hash_options: + # When hashes are provided via constraints for an unpinned requirement, + # the resulting install requirement must appear pinned so that the + # hash-checking logic does not reject it as HashUnpinned. + line = f"{template.req.name}=={version}" + elif template.req: line = str(template.req) else: line = link.url @@ -76,6 +85,7 @@ def make_install_req_from_link( ) ireq.original_link = template.original_link ireq.link = link + ireq.set_source_link(source_link) ireq.extras = template.extras return ireq @@ -94,7 +104,6 @@ def make_install_req_from_editable( comes_from=template.comes_from, isolated=template.isolated, constraint=template.constraint, - permit_editable_wheels=template.permit_editable_wheels, hash_options=template.hash_options, config_settings=template.config_settings, ) @@ -134,10 +143,6 @@ class _InstallRequirementBackedCandidate(Candidate): :param link: The link passed to the ``InstallRequirement``. The backing ``InstallRequirement`` will use this link to fetch the distribution. - :param source_link: The link this candidate "originates" from. This is - different from ``link`` when the link is found in the wheel cache. - ``link`` would point to the wheel cache, while this points to the - found remote link (e.g. from pypi.org). """ dist: BaseDistribution @@ -146,14 +151,12 @@ class _InstallRequirementBackedCandidate(Candidate): def __init__( self, link: Link, - source_link: Link, ireq: InstallRequirement, factory: Factory, name: NormalizedName | None = None, version: Version | None = None, ) -> None: self._link = link - self._source_link = source_link self._factory = factory self._ireq = ireq self._name = name @@ -181,7 +184,7 @@ class _InstallRequirementBackedCandidate(Candidate): @property def source_link(self) -> Link | None: - return self._source_link + return self._ireq.source_link @property def project_name(self) -> NormalizedName: @@ -203,7 +206,8 @@ class _InstallRequirementBackedCandidate(Candidate): def format_for_error(self) -> str: return ( f"{self.name} {self.version} " - f"(from {self._link.file_path if self._link.is_file else self._link})" + f"(from {'editable ' if self.is_editable else ''}" + f"{self._link.file_path if self._link.is_file else self._link})" ) def _prepare_distribution(self) -> BaseDistribution: @@ -288,7 +292,12 @@ class LinkCandidate(_InstallRequirementBackedCandidate): if cache_entry is not None: logger.debug("Using cached wheel link: %s", cache_entry.link) link = cache_entry.link - ireq = make_install_req_from_link(link, template) + ireq = make_install_req_from_link( + link, + template, + version=version, + source_link=source_link, + ) assert ireq.link == link if ireq.link.is_wheel and not ireq.link.is_file: wheel = Wheel(ireq.link.filename) @@ -317,7 +326,6 @@ class LinkCandidate(_InstallRequirementBackedCandidate): super().__init__( link=link, - source_link=source_link, ireq=ireq, factory=factory, name=name, @@ -342,7 +350,6 @@ class EditableCandidate(_InstallRequirementBackedCandidate): ) -> None: super().__init__( link=link, - source_link=link, ireq=make_install_req_from_editable(link, template), factory=factory, name=name, @@ -366,7 +373,7 @@ class AlreadyInstalledCandidate(Candidate): self.dist = dist self._ireq = _make_install_req_from_dist(dist, template) self._factory = factory - self._version = None + self._version: Version | None = None # This is just logging some messages, so we can do it eagerly. # The returned dist would be exactly the same as self.dist because we diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/factory.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/factory.py index ede3e6b..9c0cc42 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/factory.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/factory.py @@ -1,12 +1,12 @@ from __future__ import annotations import contextlib +import copy import functools import logging -from collections.abc import Iterable, Iterator, Mapping, Sequence +from collections.abc import Callable, Iterable, Iterator, Mapping, Sequence from typing import ( TYPE_CHECKING, - Callable, NamedTuple, Protocol, TypeVar, @@ -18,6 +18,7 @@ from pip._vendor.packaging.specifiers import SpecifierSet from pip._vendor.packaging.utils import NormalizedName, canonicalize_name from pip._vendor.packaging.version import InvalidVersion, Version from pip._vendor.resolvelib import ResolutionImpossible +from pip._vendor.rich.markup import escape from pip._internal.cache import CacheEntry, WheelCache from pip._internal.exceptions import ( @@ -45,7 +46,7 @@ from pip._internal.req.req_install import ( from pip._internal.resolution.base import InstallRequirementProvider from pip._internal.utils.compatibility_tags import get_supported from pip._internal.utils.hashes import Hashes -from pip._internal.utils.packaging import get_requirement +from pip._internal.utils.packaging import get_requirement, requirement_without_marker from pip._internal.utils.virtualenv import running_under_virtualenv from .base import Candidate, Constraint, Requirement @@ -212,8 +213,8 @@ class Factory: except (MetadataInconsistent, MetadataInvalid) as e: logger.info( "Discarding [blue underline]%s[/]: [yellow]%s[reset]", - link, - e, + escape(str(link)), + escape(str(e)), extra={"markup": True}, ) self._build_failures[link] = e @@ -233,8 +234,8 @@ class Factory: except MetadataInconsistent as e: logger.info( "Discarding [blue underline]%s[/]: [yellow]%s[reset]", - link, - e, + escape(str(link)), + escape(str(e)), extra={"markup": True}, ) self._build_failures[link] = e @@ -248,6 +249,7 @@ class Factory: hashes: Hashes, prefers_installed: bool, incompatible_ids: set[int], + constraint_hash_options: dict[str, list[str]] | None = None, ) -> Iterable[Candidate]: if not ireqs: return () @@ -258,6 +260,16 @@ class Factory: # Hopefully the Project model can correct this mismatch in the future. template = ireqs[0] assert template.req, "Candidates found on index must be PEP 508" + if ( + constraint_hash_options + and not template.hash_options + and any(constraint_hash_options.values()) + ): + template = copy.copy(template) + template.hash_options = { + k: list(v) for k, v in constraint_hash_options.items() + } + assert template.req # to prevent mypy from being confused by the copy name = canonicalize_name(template.req.name) extras: frozenset[str] = frozenset() @@ -376,16 +388,28 @@ class Factory: This creates "fake" InstallRequirement objects that are basically clones of what "should" be the template, but with original_link set to link. """ + extras: frozenset[str] = frozenset() + base_identifier = identifier + with contextlib.suppress(InvalidRequirement): + parsed_requirement = get_requirement(identifier) + if parsed_requirement.name != identifier: + base_identifier = canonicalize_name(parsed_requirement.name) + extras = frozenset(parsed_requirement.extras) + for link in constraint.links: self._fail_if_link_is_unsupported_wheel(link) - candidate = self._make_base_candidate_from_link( + base_candidate = self._make_base_candidate_from_link( link, template=install_req_from_link_and_ireq(link, template), - name=canonicalize_name(identifier), + name=canonicalize_name(base_identifier), version=None, ) - if candidate: - yield candidate + if base_candidate is None: + continue + if extras: + yield self._make_extras_candidate(base_candidate, extras) + else: + yield base_candidate def find_candidates( self, @@ -453,6 +477,7 @@ class Factory: constraint.hashes, prefers_installed, incompat_ids, + constraint.hash_options, ) return ( @@ -662,11 +687,12 @@ class Factory: def _report_single_requirement_conflict( self, req: Requirement, parent: Candidate | None ) -> DistributionNotFound: - if parent is None: - req_disp = str(req) + _, ireq = req.get_candidate_lookup() + if ireq is not None and ireq.req is not None: + req_str = str(requirement_without_marker(ireq.req)) else: - req_disp = f"{req} (from {parent.name})" - + req_str = str(req) + req_disp = req_str if parent is None else f"{req_str} (from {parent.name})" cands = self._finder.find_all_candidates(req.project_name) skipped_by_requires_python = self._finder.requires_python_skipped_reasons() @@ -698,6 +724,7 @@ class Factory: # Check if only final releases are allowed for this package version_type = "version" + allows_pre = None if self._finder.release_control is not None: allows_pre = self._finder.release_control.allows_prereleases( canonicalize_name(req.project_name) @@ -705,13 +732,32 @@ class Factory: if allows_pre is False: version_type = "final version" - logger.critical( - "Could not find a %s that satisfies the requirement %s " - "(from versions: %s)", - version_type, - req_disp, - ", ".join(versions) or "none", - ) + if len(cands) == 1 and cands[0].locked: + # The package finder ensures that requirements from pylock files + # have exactly one candidate. So we can provide a specific error + # message in this case. + if cands[0].version.is_prerelease and allows_pre is False: + logger.critical( + "A pre-release version %s is specified in a provided lock file " + "for %s but only final versions are allowed", + cands[0].version, + cands[0].name, + ) + else: + logger.critical( + "The requirement %s is not compatible with " + "version %s specified in a provided lock file", + req_disp, + ", ".join(versions), + ) + else: + logger.critical( + "Could not find a %s that satisfies the requirement %s " + "(from versions: %s)", + version_type, + req_disp, + ", ".join(versions) or "none", + ) if str(req) == "requirements.txt": logger.info( "HINT: You are attempting to install a package literally " @@ -719,8 +765,7 @@ class Factory: "using the '-r' flag to install the packages listed in " "requirements.txt" ) - - return DistributionNotFound(f"No matching distribution found for {req}") + return DistributionNotFound(f"No matching distribution found for {req_disp}") def _has_any_candidates(self, project_name: str) -> bool: """ @@ -819,8 +864,8 @@ class Factory: msg = msg + "The user requested " msg = msg + req.format_for_error() for key in relevant_constraints: - spec = constraints[key].specifier - msg += f"\n The user requested (constraint) {key}{spec}" + constraint_text = f"{key}{constraints[key].format_for_error()}" + msg += f"\n The user requested (constraint) {constraint_text}" # Check for causes that had no candidates causes = set() diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py index f60653d..6701673 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py @@ -11,8 +11,8 @@ something. from __future__ import annotations import logging -from collections.abc import Iterator, Sequence -from typing import Any, Callable, Optional +from collections.abc import Callable, Iterator, Sequence +from typing import Any from pip._vendor.packaging.version import _BaseVersion @@ -22,7 +22,7 @@ from .base import Candidate logger = logging.getLogger(__name__) -IndexCandidateInfo = tuple[_BaseVersion, Callable[[], Optional[Candidate]]] +IndexCandidateInfo = tuple[_BaseVersion, Callable[[], Candidate | None]] def _iter_built(infos: Iterator[IndexCandidateInfo]) -> Iterator[Candidate]: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/provider.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/provider.py index 994748d..766fa84 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/provider.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/provider.py @@ -1,6 +1,7 @@ from __future__ import annotations import math +from collections import defaultdict from collections.abc import Iterable, Iterator, Mapping, Sequence from functools import cache from typing import ( @@ -27,6 +28,8 @@ if TYPE_CHECKING: else: _ProviderBase = AbstractProvider +_CONFLICT_PRIORITY_THRESHOLD = 5 + # Notes on the relationship between the provider, the factory, and the # candidate and requirement classes. # @@ -81,6 +84,7 @@ class PipProvider(_ProviderBase): :params constraints: A mapping of constraints specified by the user. Keys are canonicalized project names. :params ignore_dependencies: Whether the user specified ``--no-deps``. + :params only_dependencies: Whether the user specified ``--only-deps``. :params upgrade_strategy: The user-specified upgrade strategy. :params user_requested: A set of canonicalized package names that the user supplied for pip to install/upgrade. @@ -91,14 +95,18 @@ class PipProvider(_ProviderBase): factory: Factory, constraints: dict[str, Constraint], ignore_dependencies: bool, + only_dependencies: bool, upgrade_strategy: str, user_requested: dict[str, int], ) -> None: self._factory = factory self._constraints = constraints self._ignore_dependencies = ignore_dependencies + self._only_dependencies = only_dependencies self._upgrade_strategy = upgrade_strategy self._user_requested = user_requested + self._conflict_counts: defaultdict[str, int] = defaultdict(int) + self._conflict_promoted: set[str] = set() @property def constraints(self) -> dict[str, Constraint]: @@ -130,29 +138,42 @@ class PipProvider(_ProviderBase): Further, the current backtrack causes likely need to be resolved before other requirements as a resolution can't be found while there is a conflict. + * Identifiers that repeatedly appear as not-yet-pinned in conflicts + get promoted so they are resolved earlier. This lets their + constraints take effect before other packages pick a version. """ backtrack_identifiers = set() for info in backtrack_causes: - backtrack_identifiers.add(info.requirement.name) + names = [info.requirement.name] if info.parent is not None: - backtrack_identifiers.add(info.parent.name) + names.append(info.parent.name) + for name in names: + backtrack_identifiers.add(name) + if name not in resolutions: + self._conflict_counts[name] += 1 + if self._conflict_counts[name] >= _CONFLICT_PRIORITY_THRESHOLD: + self._conflict_promoted.add(name) current_backtrack_causes = [] + promoted = [] for identifier in identifiers: - # Requires-Python has only one candidate and the check is basically - # free, so we always do it first to avoid needless work if it fails. - # This skips calling get_preference() for all other identifiers. if identifier == REQUIRES_PYTHON_IDENTIFIER: return [identifier] - # Check if this identifier is a backtrack cause if identifier in backtrack_identifiers: current_backtrack_causes.append(identifier) continue + if identifier in self._conflict_promoted: + promoted.append(identifier) + continue + if current_backtrack_causes: return current_backtrack_causes + if promoted: + return promoted + return identifiers def get_preference( @@ -223,7 +244,10 @@ class PipProvider(_ProviderBase): unfree = bool(operators) requested_order = self._user_requested.get(identifier, math.inf) + conflict_promoted = identifier in self._conflict_promoted + return ( + not conflict_promoted, not direct, not pinned, not upper_bounded, diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/reporter.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/reporter.py index 6ba9bbd..581c980 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/reporter.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/reporter.py @@ -17,8 +17,9 @@ class PipReporter(BaseReporter[Requirement, Candidate, str]): self.reject_count_by_package: defaultdict[str, int] = defaultdict(int) self._constraints = constraints or {} + # Only true after a second candidate of this package is rejected. self._messages_at_reject_count = { - 1: ( + 2: ( "pip is looking at multiple versions of {package_name} to " "determine which version is compatible with other " "requirements. This could take a while." @@ -64,7 +65,7 @@ class PipReporter(BaseReporter[Requirement, Candidate, str]): name = candidate.name constraint = self._constraints.get(name) if constraint and constraint.specifier: - constraint_text = f"{name}{constraint.specifier}" + constraint_text = f"{name}{constraint.format_for_error()}" msg += f"\n The user requested (constraint) {constraint_text}" logger.debug(msg) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/resolver.py b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/resolver.py index 7e44c17..6e49c9e 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/resolver.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/resolution/resolvelib/resolver.py @@ -49,6 +49,7 @@ class Resolver(BaseResolver): make_install_req: InstallRequirementProvider, use_user_site: bool, ignore_dependencies: bool, + only_dependencies: bool, ignore_installed: bool, ignore_requires_python: bool, force_reinstall: bool, @@ -57,6 +58,7 @@ class Resolver(BaseResolver): ): super().__init__() assert upgrade_strategy in self._allowed_strategies + assert not (ignore_dependencies and only_dependencies) self.factory = Factory( finder=finder, @@ -70,6 +72,7 @@ class Resolver(BaseResolver): py_version_info=py_version_info, ) self.ignore_dependencies = ignore_dependencies + self.only_dependencies = only_dependencies self.upgrade_strategy = upgrade_strategy self._result: Result | None = None @@ -81,6 +84,7 @@ class Resolver(BaseResolver): factory=self.factory, constraints=collected.constraints, ignore_dependencies=self.ignore_dependencies, + only_dependencies=self.only_dependencies, upgrade_strategy=self.upgrade_strategy, user_requested=collected.user_requested, ) @@ -181,6 +185,11 @@ class Resolver(BaseResolver): req_set.add_named_requirement(ireq) + if self.only_dependencies: + for requested in collected.user_requested: + project_name = requested.partition("[")[0] + req_set.requirements.pop(project_name, None) + return req_set def get_installation_order( diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/self_outdated_check.py b/.venv/lib/python3.14/site-packages/pip/_internal/self_outdated_check.py index e131ec8..8c3eb00 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/self_outdated_check.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/self_outdated_check.py @@ -1,7 +1,6 @@ from __future__ import annotations import datetime -import functools import hashlib import json import logging @@ -9,7 +8,6 @@ import optparse import os.path import sys from dataclasses import dataclass -from typing import Callable from pip._vendor.packaging.version import Version from pip._vendor.packaging.version import parse as parse_version @@ -17,6 +15,7 @@ from pip._vendor.rich.console import Group from pip._vendor.rich.markup import escape from pip._vendor.rich.text import Text +from pip import __version__ from pip._internal.index.collector import LinkCollector from pip._internal.index.package_finder import PackageFinder from pip._internal.metadata import get_default_environment @@ -39,6 +38,7 @@ from pip._internal.utils.misc import ( ExternallyManagedEnvironment, check_externally_managed, ensure_dir, + running_under_zipapp, ) _WEEK = datetime.timedelta(days=7) @@ -135,35 +135,30 @@ class SelfCheckState: class UpgradePrompt: old: str new: str + show_upgrade_hint: bool = True def __rich__(self) -> Group: - if WINDOWS: - pip_cmd = f"{get_best_invocation_for_this_python()} -m pip" - else: - pip_cmd = get_best_invocation_for_this_pip() - notice = "[bold][[reset][blue]notice[reset][bold]][reset]" - return Group( + lines = [ Text(), Text.from_markup( f"{notice} A new release of pip is available: " f"[red]{self.old}[reset] -> [green]{self.new}[reset]" ), - Text.from_markup( - f"{notice} To update, run: " - f"[green]{escape(pip_cmd)} install --upgrade pip" - ), - ) + ] + if self.show_upgrade_hint: + if WINDOWS: + pip_cmd = f"{get_best_invocation_for_this_python()} -m pip" + else: + pip_cmd = get_best_invocation_for_this_pip() - -def was_installed_by_pip(pkg: str) -> bool: - """Checks whether pkg was installed by pip - - This is used not to display the upgrade message when pip is in fact - installed by system package manager, such as dnf on Fedora. - """ - dist = get_default_environment().get_distribution(pkg) - return dist is not None and "pip" == dist.installer + lines.append( + Text.from_markup( + f"{notice} To update, run: " + f"[green]{escape(pip_cmd)} install --upgrade pip" + ) + ) + return Group(*lines) def _get_current_remote_pip_version( @@ -194,28 +189,18 @@ def _get_current_remote_pip_version( return str(best_candidate.version) -def _self_version_check_logic( - *, - state: SelfCheckState, - current_time: datetime.datetime, +def _compute_upgrade_prompt( local_version: Version, - get_remote_version: Callable[[], str | None], + remote_version_str: str, + installed_by_pip: bool, + show_upgrade_hint: bool = True, ) -> UpgradePrompt | None: - remote_version_str = state.get(current_time) - if remote_version_str is None: - remote_version_str = get_remote_version() - if remote_version_str is None: - logger.debug("No remote pip version found") - return None - state.set(remote_version_str, current_time) - remote_version = parse_version(remote_version_str) logger.debug("Remote version of pip: %s", remote_version) logger.debug("Local version of pip: %s", local_version) + logger.debug("Was pip installed by pip? %s", installed_by_pip) - pip_installed_by_pip = was_installed_by_pip("pip") - logger.debug("Was pip installed by pip? %s", pip_installed_by_pip) - if not pip_installed_by_pip: + if not installed_by_pip: return None # Only suggest upgrade if pip is installed by pip. local_version_is_older = ( @@ -223,33 +208,63 @@ def _self_version_check_logic( and local_version.base_version != remote_version.base_version ) if local_version_is_older: - return UpgradePrompt(old=str(local_version), new=remote_version_str) + return UpgradePrompt( + old=str(local_version), + new=remote_version_str, + show_upgrade_hint=show_upgrade_hint, + ) return None -def pip_self_version_check(session: PipSession, options: optparse.Values) -> None: - """Check for an update for pip. +def pip_self_version_check_fetch( + session: PipSession, options: optparse.Values +) -> UpgradePrompt | None: + """Compute the pip upgrade prompt, if any, before the command runs. Limit the frequency of checks to once per week. State is stored either in the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix of the pip script path. - """ - installed_dist = get_default_environment().get_distribution("pip") - if not installed_dist: - return - try: - check_externally_managed() - except ExternallyManagedEnvironment: - return - upgrade_prompt = _self_version_check_logic( - state=SelfCheckState(cache_dir=options.cache_dir), - current_time=datetime.datetime.now(datetime.timezone.utc), - local_version=installed_dist.version, - get_remote_version=functools.partial( - _get_current_remote_pip_version, session, options - ), + Pair with :func:`pip_self_version_check_emit`, which displays the prompt + after the command body runs. + """ + if running_under_zipapp(): + # Use the running pip's version; environment scans target the installed + # pip, not the zipapp. Skip checks that don't apply to zipapps. + local_version = parse_version(__version__) + installed_by_pip = True + else: + installed_dist = get_default_environment().get_distribution("pip") + if not installed_dist: + return None + try: + check_externally_managed() + except ExternallyManagedEnvironment: + return None + + local_version = installed_dist.version + installed_by_pip = installed_dist.installer == "pip" + + state = SelfCheckState(cache_dir=options.cache_dir) + current_time = datetime.datetime.now(datetime.timezone.utc) + remote_version_str = state.get(current_time) + if remote_version_str is None: + remote_version_str = _get_current_remote_pip_version(session, options) + if remote_version_str is None: + logger.debug("No remote pip version found") + return None + state.set(remote_version_str, current_time) + + return _compute_upgrade_prompt( + local_version=local_version, + remote_version_str=remote_version_str, + installed_by_pip=installed_by_pip, + show_upgrade_hint=not running_under_zipapp(), ) + + +def pip_self_version_check_emit(upgrade_prompt: UpgradePrompt | None) -> None: + """Emit the upgrade prompt captured by :func:`pip_self_version_check_fetch`.""" if upgrade_prompt is not None: logger.warning("%s", upgrade_prompt, extra={"rich": True}) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/compat.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/compat.py index 324789f..b3f70cf 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/compat.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/compat.py @@ -2,12 +2,13 @@ distributions.""" import importlib.resources +import locale import logging import os import sys from typing import IO -__all__ = ["get_path_uid", "stdlib_pkgs", "tomllib", "WINDOWS"] +__all__ = ["get_locale_encoding", "get_path_uid", "tomllib", "WINDOWS"] logger = logging.getLogger(__name__) @@ -26,6 +27,19 @@ def has_tls() -> bool: return IS_PYOPENSSL +def get_locale_encoding() -> str: + """Return the locale encoding. + + Uses ``locale.getencoding()`` when available (Python 3.11+) to avoid the + ``EncodingWarning`` that ``locale.getpreferredencoding(False)`` raises + under UTF-8 Mode. + """ + # TODO: Remove the 3.10 fallback once pip drops Python 3.10 support. + if sys.version_info >= (3, 11): + return locale.getencoding() + return locale.getpreferredencoding(False) + + def get_path_uid(path: str) -> int: """ Return path's uid. @@ -73,13 +87,5 @@ else: from pip._vendor import tomli as tomllib -# packages in the stdlib that may have installation metadata, but should not be -# considered 'installed'. this theoretically could be determined based on -# dist.location (py27:`sysconfig.get_paths()['stdlib']`, -# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may -# make this ineffective, so hard-coding -stdlib_pkgs = {"python", "wsgiref", "argparse"} - - # windows detection, covers cpython and ironpython WINDOWS = sys.platform.startswith("win") or (sys.platform == "cli" and os.name == "nt") diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/deprecation.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/deprecation.py index 96e7783..a476631 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/deprecation.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/deprecation.py @@ -5,10 +5,16 @@ A module that implements tooling to enable easy warnings about deprecations. from __future__ import annotations import logging +import os import warnings +from collections.abc import Generator +from contextlib import contextmanager +from contextvars import ContextVar from typing import Any, TextIO from pip._vendor.packaging.version import parse +from pip._vendor.pyproject_hooks import BuildBackendWarning +from pip._vendor.rich.text import Text from pip import __version__ as current_version # NOTE: tests patch this name. @@ -16,10 +22,23 @@ DEPRECATION_MSG_PREFIX = "DEPRECATION: " class PipDeprecationWarning(Warning): - pass + include_source: bool = False _original_showwarning: Any = None +_build_backend_warning_level = ContextVar( + "build_backend_warning_level", default=logging.DEBUG +) + + +@contextmanager +def build_backend_warnings(level: int) -> Generator[None, None, None]: + """Set the logging level for warnings from this build backend call.""" + token = _build_backend_warning_level.set(level) + try: + yield + finally: + _build_backend_warning_level.reset(token) # Warnings <-> Logging Integration @@ -38,14 +57,30 @@ def _showwarning( # We use a specially named logger which will handle all of the # deprecation messages for pip. logger = logging.getLogger("pip._internal.deprecations") - logger.warning(message) + if isinstance(message, PipDeprecationWarning) and message.include_source: + logger.warning("%s (%s:%s)", message, filename, lineno) + else: + logger.warning(message) + elif issubclass(category, BuildBackendWarning): + logger = logging.getLogger("pip._internal.build_backend") + formatted = warnings.formatwarning(message, category, filename, lineno, line) + logger.log( + _build_backend_warning_level.get(), + "%s", + Text(formatted.rstrip()), + extra={"rich": True}, + ) else: _original_showwarning(message, category, filename, lineno, file, line) def install_warning_logger() -> None: # Enable our Deprecation Warnings - warnings.simplefilter("default", PipDeprecationWarning, append=True) + # If we're running pip test suite, promote the PipDeprecationWarning into errors. + if os.environ.get("_PIP_TEST_ENV", None): + warnings.simplefilter("error", PipDeprecationWarning) + else: + warnings.simplefilter("default", PipDeprecationWarning, append=True) global _original_showwarning @@ -61,6 +96,8 @@ def deprecated( gone_in: str | None, feature_flag: str | None = None, issue: int | None = None, + stacklevel: int = 2, + include_source: bool = False, ) -> None: """Helper to deprecate existing functionality. @@ -80,6 +117,12 @@ def deprecated( issue: Issue number on the tracker that would serve as a useful place for users to find related discussion and provide feedback. + stacklevel: + How many frames up the call stack to attribute the warning to. + Defaults to 2 (the caller of deprecated()). + include_source: + If True, include the source filename and line number in the warning + output. Useful when the warning originates from external code. """ # Determine whether or not the feature is already gone in this version. @@ -123,4 +166,6 @@ def deprecated( if is_gone: raise PipDeprecationWarning(message) - warnings.warn(message, category=PipDeprecationWarning, stacklevel=2) + warning = PipDeprecationWarning(message) + warning.include_source = include_source + warnings.warn(warning, stacklevel=stacklevel) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/direct_url_helpers.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/direct_url_helpers.py index 3cbc1e7..f2d6e90 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/direct_url_helpers.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/direct_url_helpers.py @@ -11,16 +11,20 @@ def direct_url_as_pep440_direct_reference(direct_url: DirectUrl, name: str) -> s direct_url.validate() # if invalid, this is a pip bug requirement = name + " @ " fragments = [] - if isinstance(direct_url.info, VcsInfo): + if direct_url.vcs_info: requirement += ( - f"{direct_url.info.vcs}+{direct_url.url}@{direct_url.info.commit_id}" + f"{direct_url.vcs_info.vcs}+{direct_url.url}" + f"@{direct_url.vcs_info.commit_id}" ) - elif isinstance(direct_url.info, ArchiveInfo): + elif direct_url.archive_info: requirement += direct_url.url - if direct_url.info.hash: - fragments.append(direct_url.info.hash) + if direct_url.archive_info.hashes: + hash_algorithm, hash_value = next( + iter(direct_url.archive_info.hashes.items()) + ) + fragments.append(f"{hash_algorithm}={hash_value}") else: - assert isinstance(direct_url.info, DirInfo) + assert direct_url.dir_info requirement += direct_url.url if direct_url.subdirectory: fragments.append("subdirectory=" + direct_url.subdirectory) @@ -32,7 +36,7 @@ def direct_url_as_pep440_direct_reference(direct_url: DirectUrl, name: str) -> s def direct_url_for_editable(source_dir: str) -> DirectUrl: return DirectUrl( url=path_to_url(source_dir), - info=DirInfo(editable=True), + dir_info=DirInfo(editable=True), ) @@ -62,7 +66,7 @@ def direct_url_from_link( commit_id = vcs_backend.get_revision(source_dir) return DirectUrl( url=url, - info=VcsInfo( + vcs_info=VcsInfo( vcs=vcs_backend.name, commit_id=commit_id, requested_revision=requested_revision, @@ -72,16 +76,17 @@ def direct_url_from_link( elif link.is_existing_dir(): return DirectUrl( url=link.url_without_fragment, - info=DirInfo(), + dir_info=DirInfo(), subdirectory=link.subdirectory_fragment, ) else: - hash = None - hash_name = link.hash_name - if hash_name: - hash = f"{hash_name}={link.hash}" + if link.hash_name: + assert link.hash + hashes = {link.hash_name: link.hash} + else: + hashes = None return DirectUrl( url=link.url_without_fragment, - info=ArchiveInfo(hash=hash), + archive_info=ArchiveInfo(hashes=hashes), subdirectory=link.subdirectory_fragment, ) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/filesystem.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/filesystem.py index 52eb78f..806aae0 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/filesystem.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/filesystem.py @@ -5,11 +5,11 @@ import os import os.path import random import sys -from collections.abc import Generator +from collections.abc import Callable, Generator from contextlib import contextmanager from pathlib import Path from tempfile import NamedTemporaryFile -from typing import Any, BinaryIO, Callable, cast +from typing import Any, BinaryIO, cast from pip._internal.utils.compat import get_path_uid from pip._internal.utils.misc import format_size @@ -172,7 +172,7 @@ def _subdirs_without_generic( predicate under it.""" directories = [] - excluded = set() + excluded: set[Path] = set() for root_str, _, filenames in os.walk(Path(path).resolve()): root = Path(root_str) @@ -180,9 +180,7 @@ def _subdirs_without_generic( # This directory should be excluded, so exclude it and all of its # parent directories. # The last item in root.parents is ".", so we ignore it. - # - # Wrapping this in `list()` is only needed for Python 3.9. - excluded.update(list(root.parents)[:-1]) + excluded.update(root.parents[:-1]) excluded.add(root) directories.append(root) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/hashes.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/hashes.py index 3d8c125..43f14cf 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/hashes.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/hashes.py @@ -8,9 +8,9 @@ from pip._internal.exceptions import HashMismatch, HashMissing, InstallationErro from pip._internal.utils.misc import read_chunks if TYPE_CHECKING: + from collections.abc import Mapping from hashlib import _Hash - # The recommended hash algo of the moment. Change this whenever the state of # the art changes; it won't hurt backward compatibility. FAVORITE_HASH = "sha256" @@ -104,7 +104,7 @@ class Hashes: with open(path, "rb") as file: return self.check_against_file(file) - def has_one_of(self, hashes: dict[str, str]) -> bool: + def has_one_of(self, hashes: Mapping[str, str]) -> bool: """Return whether any of the given hashes are allowed.""" for hash_name, hex_digest in hashes.items(): if self.is_hash_allowed(hash_name, hex_digest): diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/logging.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/logging.py index e067703..233ce4e 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/logging.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/logging.py @@ -29,7 +29,7 @@ from pip._vendor.rich.style import Style from pip._internal.utils._log import VERBOSE, getLogger from pip._internal.utils.compat import WINDOWS from pip._internal.utils.deprecation import DEPRECATION_MSG_PREFIX -from pip._internal.utils.misc import StreamWrapper, ensure_dir +from pip._internal.utils.misc import StreamWrapper, ensure_dir, looks_like_ci _log_state = threading.local() _stdout_console = None @@ -320,8 +320,16 @@ def setup_logging(verbosity: int, no_color: bool, user_log_file: str | None) -> ["user_log"] if include_user_log else [] ) global _stdout_console, stderr_console - _stdout_console = PipConsole(file=sys.stdout, no_color=no_color, soft_wrap=True) - _stderr_console = PipConsole(file=sys.stderr, no_color=no_color, soft_wrap=True) + console_options: dict[str, Any] = {"no_color": no_color, "soft_wrap": True} + if looks_like_ci(): + # Don't animate progress bars and status spinners when running + # in CI. A lot of CI workflows use FORCE_COLOR and similar envvars + # so their CI output remains colorized, but this causes rich to + # assume a fully interactive terminal, resulting in any animated + # output to span many lines which is distracting (and unhelpful). + console_options["force_interactive"] = False + _stdout_console = PipConsole(file=sys.stdout, **console_options) + _stderr_console = PipConsole(file=sys.stderr, **console_options) logging.config.dictConfig( { diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/misc.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/misc.py index 66e521b..b7b559f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/misc.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/misc.py @@ -5,15 +5,16 @@ import getpass import hashlib import logging import os +import pathlib import posixpath import shutil import stat import sys import sysconfig import urllib.parse -from collections.abc import Generator, Iterable, Iterator, Mapping, Sequence +from collections.abc import Callable, Generator, Iterable, Iterator, Mapping, Sequence from dataclasses import dataclass -from functools import partial +from functools import cache, partial, wraps from io import StringIO from itertools import filterfalse, tee, zip_longest from pathlib import Path @@ -21,20 +22,25 @@ from types import FunctionType, TracebackType from typing import ( Any, BinaryIO, - Callable, - Optional, + NoReturn, TextIO, TypeVar, cast, ) from pip._vendor.packaging.requirements import Requirement -from pip._vendor.pyproject_hooks import BuildBackendHookCaller +from pip._vendor.pyproject_hooks import BackendUnavailable, BuildBackendHookCaller +from pip import __file__ as pip_location from pip import __version__ -from pip._internal.exceptions import CommandError, ExternallyManagedEnvironment +from pip._internal.exceptions import ( + BackendUnavailableError, + CommandError, + ExternallyManagedEnvironment, +) from pip._internal.locations import get_major_minor_version from pip._internal.utils.compat import WINDOWS +from pip._internal.utils.deprecation import build_backend_warnings from pip._internal.utils.retry import retry from pip._internal.utils.virtualenv import running_under_virtualenv @@ -52,19 +58,38 @@ __all__ = [ "ensure_dir", "remove_auth_from_url", "check_externally_managed", + "looks_like_ci", "ConfiguredBuildBackendHookCaller", ] logger = logging.getLogger(__name__) T = TypeVar("T") +F = TypeVar("F", bound=Callable[..., Any]) ExcInfo = tuple[type[BaseException], BaseException, TracebackType] VersionInfo = tuple[int, int, int] -NetlocTuple = tuple[str, tuple[Optional[str], Optional[str]]] +NetlocTuple = tuple[str, tuple[str | None, str | None]] OnExc = Callable[[FunctionType, Path, BaseException], Any] OnErr = Callable[[FunctionType, Path, ExcInfo], Any] FILE_CHUNK_SIZE = 1024 * 1024 +# These are environment variables present when running under various +# CI systems. For each variable, some CI systems that use the variable +# are indicated. The collection was chosen so that for each of a number +# of popular systems, at least one of the environment variables is used. +# This list is used to provide some indication of and lower bound for +# CI traffic to PyPI. Thus, it is okay if the list is not comprehensive. +# For more background, see: https://github.com/pypa/pip/issues/5499 +CI_ENVIRONMENT_VARIABLES = ( + # Azure Pipelines + "BUILD_BUILDID", + # Jenkins + "BUILD_ID", + # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI + "CI", + # Explicit environment variable. + "PIP_IS_CI", +) def get_pip_version() -> str: @@ -74,6 +99,27 @@ def get_pip_version() -> str: return f"pip {__version__} from {pip_pkg_dir} (python {get_major_minor_version()})" +@cache +def running_under_zipapp() -> bool: + return not pathlib.Path(pip_location).resolve().parent.is_dir() + + +def get_runnable_pip() -> str: + """Get a file to pass to a Python executable, to run the currently-running pip. + + This is used to run a pip subprocess, for installing requirements into the build + environment. + """ + source = pathlib.Path(pip_location).resolve().parent + + if running_under_zipapp(): + # This would happen if someone is using pip from inside a zip file. In that + # case, we can use that directly. + return str(source) + + return os.fsdecode(source / "__pip-runner__.py") + + def normalize_version_info(py_version_info: tuple[int, ...]) -> tuple[int, int, int]: """ Convert a tuple of ints representing a Python version to one of length @@ -385,14 +431,6 @@ class StreamWrapper(StringIO): return self.orig_stream.encoding -# Simulates an enum -def enum(*sequential: Any, **named: Any) -> type[Any]: - enums = dict(zip(sequential, range(len(sequential))), **named) - reverse = {value: key for key, value in enums.items()} - enums["reverse_mapping"] = reverse - return type("Enum", (), enums) - - def build_netloc(host: str, port: int | None) -> str: """ Build a netloc from a host-port pair @@ -548,7 +586,7 @@ class HiddenText: if type(self) is type(other): # The string being used for redaction doesn't also have to match, # just the raw, original string. - return self.secret == cast(HiddenText, other).secret + return self.secret == other.secret return NotImplemented # Disable hashing, since we have a custom __eq__ and don't need hash-ability @@ -648,6 +686,24 @@ def partition( return filterfalse(pred, t1), filter(pred, t2) +def _build_backend_hook(func: F) -> F: + """Apply warning policy and translate failures for a public backend hook.""" + + @wraps(func) + def wrapper( + self: ConfiguredBuildBackendHookCaller, + *args: Any, + **kwargs: Any, + ) -> Any: + with build_backend_warnings(self.backend_warning_level): + try: + return func(self, *args, **kwargs) + except BackendUnavailable as error: + self._raise_backend_unavailable(func.__name__, error) + + return cast(F, wrapper) + + class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): def __init__( self, @@ -657,12 +713,34 @@ class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): backend_path: str | None = None, runner: Callable[..., None] | None = None, python_executable: str | None = None, + *, + backend_warning_level: int = logging.DEBUG, ): super().__init__( source_dir, build_backend, backend_path, runner, python_executable ) self.config_holder = config_holder + self.backend_warning_level = backend_warning_level + def _raise_backend_unavailable( + self, hook_name: str, error: BackendUnavailable + ) -> NoReturn: + backend_error = ( + error.traceback.strip().splitlines()[-1] if error.traceback else str(error) + ) + exception = BackendUnavailableError( + hook_name=hook_name, + backend_name=self.build_backend, + backend_error=backend_error, + ) + logger.error("%s", exception, extra={"rich": True}) + raise exception from error + + @_build_backend_hook + def supports_feature(self, feature: str) -> bool: + return feature in self._supported_features() + + @_build_backend_hook def build_wheel( self, wheel_directory: str, @@ -674,6 +752,7 @@ class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): wheel_directory, config_settings=cs, metadata_directory=metadata_directory ) + @_build_backend_hook def build_sdist( self, sdist_directory: str, @@ -682,6 +761,7 @@ class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): cs = self.config_holder.config_settings return super().build_sdist(sdist_directory, config_settings=cs) + @_build_backend_hook def build_editable( self, wheel_directory: str, @@ -693,24 +773,28 @@ class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): wheel_directory, config_settings=cs, metadata_directory=metadata_directory ) + @_build_backend_hook def get_requires_for_build_wheel( self, config_settings: Mapping[str, Any] | None = None ) -> Sequence[str]: cs = self.config_holder.config_settings return super().get_requires_for_build_wheel(config_settings=cs) + @_build_backend_hook def get_requires_for_build_sdist( self, config_settings: Mapping[str, Any] | None = None ) -> Sequence[str]: cs = self.config_holder.config_settings return super().get_requires_for_build_sdist(config_settings=cs) + @_build_backend_hook def get_requires_for_build_editable( self, config_settings: Mapping[str, Any] | None = None ) -> Sequence[str]: cs = self.config_holder.config_settings return super().get_requires_for_build_editable(config_settings=cs) + @_build_backend_hook def prepare_metadata_for_build_wheel( self, metadata_directory: str, @@ -724,12 +808,13 @@ class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller): _allow_fallback=_allow_fallback, ) + @_build_backend_hook def prepare_metadata_for_build_editable( self, metadata_directory: str, config_settings: Mapping[str, Any] | None = None, _allow_fallback: bool = True, - ) -> str | None: + ) -> str: cs = self.config_holder.config_settings return super().prepare_metadata_for_build_editable( metadata_directory=metadata_directory, @@ -769,3 +854,13 @@ def warn_if_run_as_root() -> None: "Use the --root-user-action option if you know what you are doing and " "want to suppress this warning." ) + + +def looks_like_ci() -> bool: + """ + Return whether it looks like pip is running under CI. + """ + # We don't use the method of checking for a tty (e.g. using isatty()) + # because some CI systems mimic a tty (e.g. Travis CI). Thus that + # method doesn't provide definitive information in either direction. + return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/packaging.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/packaging.py index 3cbc049..0db1505 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/packaging.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/packaging.py @@ -1,5 +1,6 @@ from __future__ import annotations +import copy import functools import logging @@ -42,3 +43,14 @@ def get_requirement(req_string: str) -> Requirement: # minimize repeated parsing of the same string to construct equivalent # Requirement objects. return Requirement(req_string) + + +def requirement_without_marker(req: Requirement) -> Requirement: + """Return a copy of ``req`` with its environment marker removed. + + Intended for error messages. The original is left unchanged, which + matters because ``get_requirement`` caches and shares instances. + """ + stripped = copy.copy(req) + stripped.marker = None + return stripped diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/pylock.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/pylock.py index 0f77835..d30c4be 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/pylock.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/pylock.py @@ -1,5 +1,10 @@ -from collections.abc import Iterable +from __future__ import annotations + +import os +from collections.abc import Collection, Iterable, Iterator from pathlib import Path +from typing import TYPE_CHECKING +from urllib.parse import urljoin, urlsplit from pip._vendor.packaging.pylock import ( Package, @@ -9,13 +14,20 @@ from pip._vendor.packaging.pylock import ( PackageVcs, PackageWheel, Pylock, + is_valid_pylock_path, ) +from pip._vendor.packaging.utils import NormalizedName, canonicalize_name from pip._vendor.packaging.version import Version -from pip._internal.models.direct_url import ArchiveInfo, DirInfo, VcsInfo +from pip._internal.exceptions import DiagnosticPipError, InstallationError from pip._internal.models.link import Link -from pip._internal.req.req_install import InstallRequirement -from pip._internal.utils.urls import url_to_path +from pip._internal.utils.compat import tomllib +from pip._internal.utils.urls import path_to_url, url_to_path + +if TYPE_CHECKING: + from pip._internal.index.package_finder import FormatControl + from pip._internal.network.session import PipSession + from pip._internal.req.req_install import InstallRequirement def _pylock_package_from_install_requirement( @@ -32,16 +44,16 @@ def _pylock_package_from_install_requirement( package_sdist = None package_wheels = None if ireq.is_direct: - if isinstance(download_info.info, VcsInfo): + if download_info.vcs_info: package_vcs = PackageVcs( - type=download_info.info.vcs, + type=download_info.vcs_info.vcs, url=download_info.url, path=None, - requested_revision=download_info.info.requested_revision, - commit_id=download_info.info.commit_id, + requested_revision=download_info.vcs_info.requested_revision, + commit_id=download_info.vcs_info.commit_id, subdirectory=download_info.subdirectory, ) - elif isinstance(download_info.info, DirInfo): + elif download_info.dir_info: package_directory = PackageDirectory( path=( Path(url_to_path(download_info.url)) @@ -50,17 +62,19 @@ def _pylock_package_from_install_requirement( .as_posix() ), editable=( - download_info.info.editable if download_info.info.editable else None + download_info.dir_info.editable + if download_info.dir_info.editable + else None ), subdirectory=download_info.subdirectory, ) - elif isinstance(download_info.info, ArchiveInfo): - if not download_info.info.hashes: + elif download_info.archive_info: + if not download_info.archive_info.hashes: raise NotImplementedError() package_archive = PackageArchive( url=download_info.url, path=None, - hashes=download_info.info.hashes, + hashes=download_info.archive_info.hashes, subdirectory=download_info.subdirectory, ) else: @@ -68,8 +82,8 @@ def _pylock_package_from_install_requirement( raise NotImplementedError() else: package_version = dist.version - if isinstance(download_info.info, ArchiveInfo): - if not download_info.info.hashes: + if download_info.archive_info: + if not download_info.archive_info.hashes: raise NotImplementedError() link = Link(download_info.url) if link.is_wheel: @@ -77,14 +91,14 @@ def _pylock_package_from_install_requirement( PackageWheel( name=link.filename, url=download_info.url, - hashes=download_info.info.hashes, + hashes=download_info.archive_info.hashes, ) ] else: package_sdist = PackageSdist( name=link.filename, url=download_info.url, - hashes=download_info.info.hashes, + hashes=download_info.archive_info.hashes, ) else: # should never happen @@ -114,3 +128,197 @@ def pylock_from_install_requirements( key=lambda p: p.name, ), ) + + +def _is_url(s: str) -> bool: + return s.lower().startswith(("http:", "https:", "file:")) + + +def is_valid_pylock_filename(filename: str, *, allow_urls: bool = True) -> bool: + """Check a lock source's filename, optionally restricting it to local paths.""" + if _is_url(filename): + if not allow_urls: + return False + try: + path = Path(urlsplit(filename).path.rpartition("/")[-1]) + except ValueError: + return False + else: + path = Path(filename) + return is_valid_pylock_path(path) + + +def _package_dist_url( + pylock_path_or_url: str, path: str | None, url: str | None +) -> str: + """Compute an url from a Pylock package path and url. + + Give priority to path over url. If path is relative, + compute an url using the pylock file location as base. + """ + if path is not None: + if not os.path.isabs(path): + # relative path, join to pylock location + if _is_url(pylock_path_or_url): + base = urlsplit(pylock_path_or_url) + dist_url = urljoin(base.geturl(), path) + # os.path.isabs does not treat a scheme-carrying value like + # "file:..." as absolute, so it reaches here and urljoin honors + # its scheme, discarding the pylock base. Only keep the result + # if its scheme and host still match the lock's own. + target = urlsplit(dist_url) + if (target.scheme, target.netloc) != (base.scheme, base.netloc): + raise InstallationError( + f"Path {path!r} in pylock file obtained from a URL " + f"resolves outside its location: {pylock_path_or_url!r}" + ) + return dist_url + else: + return path_to_url( + os.path.join(os.path.dirname(pylock_path_or_url), path) + ) + else: + # absolute path, reject if pylock comes from a URL + if _is_url(pylock_path_or_url): + raise InstallationError( + f"Absolute paths are not supported in pylock files obtained " + f"from a URL: {path!r} in {pylock_path_or_url!r}" + ) + return path_to_url(path) + else: + assert url is not None # guaranteed by packaging.pylock validation + return url + + +def package_vcs_requirement_url( + pylock_path_or_url: str, package_vcs: PackageVcs +) -> str: + dist_url = _package_dist_url(pylock_path_or_url, package_vcs.path, package_vcs.url) + url = f"{package_vcs.type}+{dist_url}@{package_vcs.commit_id}" + if package_vcs.subdirectory: + if "#" in url: + raise InstallationError( + f"Package URL {url!r} cannot contain fragments in combination " + f"with subdirectory field (in {pylock_path_or_url!r})" + ) + url += "#subdirectory=" + package_vcs.subdirectory + return url + + +def package_archive_requirement_url( + pylock_path_or_url: str, package_archive: PackageArchive +) -> str: + url = _package_dist_url( + pylock_path_or_url, package_archive.path, package_archive.url + ) + if package_archive.subdirectory: + if "#" in url: + raise InstallationError( + f"Package URL {url!r} cannot contain fragments in combination " + f"with subdirectory field (in {pylock_path_or_url!r})" + ) + url += "#subdirectory=" + package_archive.subdirectory + return url + + +def package_directory_requirement_url( + pylock_path_or_url: str, package_directory: PackageDirectory +) -> str: + if _is_url(pylock_path_or_url) and not pylock_path_or_url.lower().startswith( + "file:" + ): + raise InstallationError( + f"Directory entries are not supported in remote pylock.toml " + f"{pylock_path_or_url!r}" + ) + url = _package_dist_url(pylock_path_or_url, package_directory.path, None) + assert url.startswith("file://") + if not url.endswith("/"): + url += "/" + if package_directory.subdirectory: + url += package_directory.subdirectory + if not url.endswith("/"): + url += "/" + return url + + +def package_sdist_requirement_url( + pylock_path_or_url: str, package_sdist: PackageSdist +) -> str: + return _package_dist_url(pylock_path_or_url, package_sdist.path, package_sdist.url) + + +def package_wheel_requirement_url( + pylock_path_or_url: str, package_wheel: PackageWheel +) -> str: + return _package_dist_url(pylock_path_or_url, package_wheel.path, package_wheel.url) + + +def _get_pylock_path_or_url_content(path_or_url: str, session: PipSession) -> str: + # TODO: refactor - this is similar to req_file.get_file_content + # Pip has special support for file:// URLs (LocalFSAdapter). + if _is_url(path_or_url): + # Delay importing heavy network modules until absolutely necessary. + from pip._internal.network.utils import raise_for_status + + resp = session.get(path_or_url) + raise_for_status(resp) + return resp.text + + # Assume this is a bare path. + return Path(path_or_url).read_text(encoding="utf-8") + + +def select_from_pylock_path_or_url( + pylock_path_or_url: str, + session: PipSession, + format_control: FormatControl | None, + *, + extras: Collection[str] | None = None, + dependency_groups: Iterable[str] = (), + include_default_groups: bool = True, +) -> Iterator[ + tuple[ + Package, + PackageVcs | PackageDirectory | PackageArchive | PackageWheel | PackageSdist, + ] +]: + try: + pylock_content = _get_pylock_path_or_url_content(pylock_path_or_url, session) + except DiagnosticPipError: + raise + except Exception as exc: + raise InstallationError( + f"Error reading pylock file {pylock_path_or_url!r}: {exc}" + ) from exc + + try: + lock = Pylock.from_dict(tomllib.loads(pylock_content)) + except Exception as exc: + raise InstallationError( + f"Invalid pylock file {pylock_path_or_url!r}: {exc}" + ) from exc + + selected_groups: set[str] = {canonicalize_name(name) for name in dependency_groups} + if include_default_groups: + selected_groups.update(lock.default_groups or ()) + + def prefer_sdist_predicate(name: NormalizedName) -> bool: + if format_control is None: + return False + allowed_formats = format_control.get_allowed_formats(name) + if "source" in allowed_formats and "binary" not in allowed_formats: + return True + return False + + try: + # packaging 26.4 will reject undeclared extras and dependency groups. + yield from lock.select( + extras=extras, + dependency_groups=selected_groups, + prefer_sdist_predicate=prefer_sdist_predicate, + ) + except Exception as exc: + raise InstallationError( + f"Cannot select requirements from pylock file {pylock_path_or_url!r}: {exc}" + ) from exc diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/retry.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/retry.py index 27d3b6e..1392c8f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/retry.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/retry.py @@ -1,8 +1,9 @@ from __future__ import annotations import functools +from collections.abc import Callable from time import perf_counter, sleep -from typing import TYPE_CHECKING, Callable, TypeVar +from typing import TYPE_CHECKING, TypeVar if TYPE_CHECKING: from typing_extensions import ParamSpec diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/subprocess.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/subprocess.py index 3e7b83f..06f4564 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/subprocess.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/subprocess.py @@ -4,8 +4,8 @@ import logging import os import shlex import subprocess -from collections.abc import Iterable, Mapping -from typing import Any, Callable, Literal, Union +from collections.abc import Callable, Iterable, Mapping +from typing import Any, Literal from pip._vendor.rich.markup import escape @@ -14,7 +14,7 @@ from pip._internal.exceptions import InstallationSubprocessError from pip._internal.utils.logging import VERBOSE, subprocess_logger from pip._internal.utils.misc import HiddenText -CommandArgs = list[Union[str, HiddenText]] +CommandArgs = list[str | HiddenText] def make_command(*args: str | HiddenText | CommandArgs) -> CommandArgs: @@ -134,6 +134,7 @@ def call_subprocess( stderr=subprocess.STDOUT if not stdout_only else subprocess.PIPE, cwd=cwd, env=env, + encoding="locale", errors="backslashreplace", ) except Exception as exc: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/temp_dir.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/temp_dir.py index a9afa76..c5d4aac 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/temp_dir.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/temp_dir.py @@ -6,16 +6,16 @@ import logging import os.path import tempfile import traceback -from collections.abc import Generator +from collections.abc import Callable, Generator from contextlib import ExitStack, contextmanager +from enum import Enum from pathlib import Path from typing import ( Any, - Callable, TypeVar, ) -from pip._internal.utils.misc import enum, rmtree +from pip._internal.utils.misc import rmtree logger = logging.getLogger(__name__) @@ -24,11 +24,13 @@ _T = TypeVar("_T", bound="TempDirectory") # Kinds of temporary directories. Only needed for ones that are # globally-managed. -tempdir_kinds = enum( - BUILD_ENV="build-env", - EPHEM_WHEEL_CACHE="ephem-wheel-cache", - REQ_BUILD="req-build", -) +# TODO: Use StrEnum when Python 3.10 support is dropped. +class TempDirectoryKind(str, Enum): + BUILD_ENV = "build-env" + EPHEM_WHEEL_CACHE = "ephem-wheel-cache" + REQ_BUILD = "req-build" + + __str__ = str.__str__ _tempdir_manager: ExitStack | None = None diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/unpacking.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/unpacking.py index b3f52e8..934f7c3 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/unpacking.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/unpacking.py @@ -76,15 +76,26 @@ def has_leading_dir(paths: Iterable[str]) -> bool: return True -def is_within_directory(directory: str, target: str) -> bool: +def is_within_directory( + directory: str, target: str, *, resolve_symlinks: bool = False +) -> bool: """ Return true if the absolute path of target is within the directory - """ - abs_directory = os.path.abspath(directory) - abs_target = os.path.abspath(target) + (including when target is equal to the directory). - prefix = os.path.commonpath([abs_directory, abs_target]) - return prefix == abs_directory + When ``resolve_symlinks`` is true, resolve symlinks before comparing so + traversal through a symlink (e.g. "link/../file") is also caught. + """ + if resolve_symlinks: + abs_directory = os.path.realpath(directory) + abs_target = os.path.realpath(target) + else: + abs_directory = os.path.abspath(directory) + abs_target = os.path.abspath(target) + + return abs_target == abs_directory or abs_target.startswith( + os.path.join(abs_directory, "") + ) def _get_default_mode_plus_executable() -> int: @@ -277,7 +288,13 @@ def _untar_without_filter( if leading: fn = split_leading_dir(fn)[1] path = os.path.join(location, fn) - if not is_within_directory(location, path): + + # The plain check rejects textual ".." escapes; resolving symlinks also + # catches a later member redirected outside by an earlier member's + # symlink (e.g. "link/../file"). + if not is_within_directory(location, path) or not is_within_directory( + location, path, resolve_symlinks=True + ): message = ( "The tar file ({}) has a file ({}) trying to install " "outside target directory ({})" @@ -286,6 +303,17 @@ def _untar_without_filter( if member.isdir(): ensure_dir(path) elif member.issym(): + # Reject symlinks resolving outside the destination, so a later + # member cannot be written through them. + target = os.path.join(os.path.dirname(path), member.linkname) + if not is_within_directory(location, target, resolve_symlinks=True): + message = ( + "The tar file ({}) has a file ({}) trying to install " + "outside target directory ({})" + ) + raise InstallationError( + message.format(filename, member.name, member.linkname) + ) if not is_symlink_target_in_tar(tar, member): message = ( "The tar file ({}) has a file ({}) trying to install " @@ -336,27 +364,46 @@ def unpack_file( location: str, content_type: str | None = None, ) -> None: + """Unpack ``filename`` into ``location``. + + Archive format is chosen in order of decreasing reliability: + ``content_type``, then filename extension, then magic signature + (unambiguous matches only). + """ filename = os.path.realpath(filename) - if ( - content_type == "application/zip" - or filename.lower().endswith(ZIP_EXTENSIONS) - or zipfile.is_zipfile(filename) - ): - unzip_file(filename, location, flatten=not filename.endswith(".whl")) - elif ( - content_type == "application/x-gzip" - or tarfile.is_tarfile(filename) - or filename.lower().endswith(TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS) - ): + zip_flatten = not filename.endswith(".whl") + + def _unzip() -> None: + unzip_file(filename, location, flatten=zip_flatten) + + def _untar() -> None: untar_file(filename, location) - else: - # FIXME: handle? - # FIXME: magic signatures? - logger.critical( - "Cannot unpack file %s (downloaded from %s, content-type: %s); " - "cannot detect archive format", - filename, - location, - content_type, - ) - raise InstallationError(f"Cannot determine archive format of {location}") + + if content_type == "application/zip": + return _unzip() + if content_type == "application/x-gzip": + return _untar() + + if filename.lower().endswith(ZIP_EXTENSIONS): + return _unzip() + if filename.lower().endswith(TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS): + return _untar() + + # avoid ambiguous case where both signature checks return True + is_zipfile = zipfile.is_zipfile(filename) + is_tarfile = tarfile.is_tarfile(filename) + if is_zipfile and not is_tarfile: + return _unzip() + if is_tarfile and not is_zipfile: + return _untar() + if is_zipfile and is_tarfile: + logger.error("Ambiguous file signature in %s.", filename) + + logger.critical( + "Cannot unpack file %s (downloaded from %s, content-type: %s); " + "cannot detect archive format", + filename, + location, + content_type, + ) + raise InstallationError(f"Cannot determine archive format of {location}") diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/urls.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/urls.py index e951a5e..af0db9f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/urls.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/urls.py @@ -1,9 +1,10 @@ import os +import re import string -import urllib.parse -import urllib.request +import urllib.parse # noqa: F401 from .compat import WINDOWS +from .packaging import get_requirement def path_to_url(path: str) -> str: @@ -11,6 +12,8 @@ def path_to_url(path: str) -> str: Convert a path to a file: URL. The path will be made absolute and have quoted path parts. """ + import urllib.request + path = os.path.normpath(os.path.abspath(path)) url = urllib.parse.urljoin("file://", urllib.request.pathname2url(path)) return url @@ -20,6 +23,8 @@ def url_to_path(url: str) -> str: """ Convert a file: URL to a path. """ + import urllib.request + assert url.startswith( "file:" ), f"You can only turn file: urls into filenames (not {url!r})" @@ -53,3 +58,21 @@ def url_to_path(url: str) -> str: path = path[1:] return path + + +def _convert_extras(extras: str | None) -> set[str]: + if not extras: + return set() + return get_requirement("placeholder" + extras.lower()).extras + + +def strip_extras(path: str) -> tuple[str, set[str]]: + m = re.match(r"^(.+)(\[[^\]]+\])$", path) + extras = None + if m: + path_no_extras = m.group(1).rstrip() + extras = m.group(2) + else: + path_no_extras = path + + return path_no_extras, _convert_extras(extras) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/utils/virtualenv.py b/.venv/lib/python3.14/site-packages/pip/_internal/utils/virtualenv.py index b1742a3..fa94813 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/utils/virtualenv.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/utils/virtualenv.py @@ -3,7 +3,6 @@ from __future__ import annotations import logging import os import re -import site import sys logger = logging.getLogger(__name__) @@ -12,7 +11,7 @@ _INCLUDE_SYSTEM_SITE_PACKAGES_REGEX = re.compile( ) -def _running_under_venv() -> bool: +def running_under_virtualenv() -> bool: """Checks if sys.base_prefix and sys.prefix match. This handles PEP 405 compliant virtual environments. @@ -20,20 +19,6 @@ def _running_under_venv() -> bool: return sys.prefix != getattr(sys, "base_prefix", sys.prefix) -def _running_under_legacy_virtualenv() -> bool: - """Checks if sys.real_prefix is set. - - This handles virtual environments created with pypa's virtualenv. - """ - # pypa/virtualenv case - return hasattr(sys, "real_prefix") - - -def running_under_virtualenv() -> bool: - """True if we're running inside a virtual environment, False otherwise.""" - return _running_under_venv() or _running_under_legacy_virtualenv() - - def _get_pyvenv_cfg_lines() -> list[str] | None: """Reads {sys.prefix}/pyvenv.cfg and returns its contents as list of lines @@ -78,28 +63,9 @@ def _no_global_under_venv() -> bool: return False -def _no_global_under_legacy_virtualenv() -> bool: - """Check if "no-global-site-packages.txt" exists beside site.py - - This mirrors logic in pypa/virtualenv for determining whether system - site-packages are visible in the virtual environment. - """ - site_mod_dir = os.path.dirname(os.path.abspath(site.__file__)) - no_global_site_packages_file = os.path.join( - site_mod_dir, - "no-global-site-packages.txt", - ) - return os.path.exists(no_global_site_packages_file) - - def virtualenv_no_global() -> bool: """Returns a boolean, whether running in venv with no system site-packages.""" - # PEP 405 compliance needs to be checked first since virtualenv >=20 would - # return True for both checks, but is only able to use the PEP 405 config. - if _running_under_venv(): + if running_under_virtualenv(): return _no_global_under_venv() - if _running_under_legacy_virtualenv(): - return _no_global_under_legacy_virtualenv() - return False diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/vcs/git.py b/.venv/lib/python3.14/site-packages/pip/_internal/vcs/git.py index 1769da7..5cc393f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/vcs/git.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/vcs/git.py @@ -5,12 +5,11 @@ import os.path import pathlib import re import urllib.parse -import urllib.request from dataclasses import replace from typing import Any from pip._internal.exceptions import BadCommand, InstallationError -from pip._internal.utils.misc import HiddenText, display_path, hide_url +from pip._internal.utils.misc import HiddenText, display_path, hide_url, strtobool from pip._internal.utils.subprocess import make_command from pip._internal.vcs.versioncontrol import ( AuthInfo, @@ -281,7 +280,9 @@ class Git(VersionControl): flags = () else: flags = ("--verbose", "--progress") - if self.get_git_version() >= (2, 17): + if self.get_git_version() >= (2, 17) and not strtobool( + os.environ.get("PIP_NO_PARTIAL_CLONE_FOR_BROKEN_GIT_SERVER", "no") + ): # Git added support for partial clone in 2.17 # https://git-scm.com/docs/partial-clone # Speeds up cloning by functioning without a complete copy of repository @@ -438,7 +439,7 @@ class Git(VersionControl): if os.path.exists(url): # A local bare remote (git clone --mirror). # Needs a file:// prefix. - return pathlib.PurePath(url).as_uri() + return pathlib.Path(url).as_uri() scp_match = SCP_REGEX.match(url) if scp_match: # Add an ssh:// prefix and replace the ':' with a '/'. @@ -453,7 +454,7 @@ class Git(VersionControl): """ try: cls.run_command( - ["rev-parse", "-q", "--verify", "sha^" + rev], + ["rev-parse", "-q", "--verify", rev + "^{commit}"], cwd=location, log_failed_cmd=False, ) @@ -500,6 +501,8 @@ class Git(VersionControl): work with a ssh:// scheme (e.g. GitHub). But we need a scheme for parsing. Hence we remove it again afterwards and return it as a stub. """ + import urllib.request + # Works around an apparent Git bug # (see https://article.gmane.org/gmane.comp.version-control.git/146500) scheme, netloc, path, query, fragment = urlsplit(url) diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/vcs/versioncontrol.py b/.venv/lib/python3.14/site-packages/pip/_internal/vcs/versioncontrol.py index 95cefb4..33c6b7f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/vcs/versioncontrol.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/vcs/versioncontrol.py @@ -12,7 +12,6 @@ from dataclasses import dataclass, field from typing import ( Any, Literal, - Optional, ) from pip._internal.cli.spinners import SpinnerInterface @@ -39,7 +38,7 @@ __all__ = ["vcs"] logger = logging.getLogger(__name__) -AuthInfo = tuple[Optional[str], Optional[str]] +AuthInfo = tuple[str | None, str | None] def is_url(name: str) -> bool: diff --git a/.venv/lib/python3.14/site-packages/pip/_internal/wheel_builder.py b/.venv/lib/python3.14/site-packages/pip/_internal/wheel_builder.py index 4dbf767..8a55261 100644 --- a/.venv/lib/python3.14/site-packages/pip/_internal/wheel_builder.py +++ b/.venv/lib/python3.14/site-packages/pip/_internal/wheel_builder.py @@ -49,6 +49,9 @@ def _should_cache( if req.editable or not req.source_dir: # never cache editable requirements return False + if req.link and req.link.is_existing_dir(): + # never cache local directory requirements + return False if req.link and req.link.is_vcs: # VCS checkout. Do not cache @@ -205,6 +208,7 @@ def build( requirements: Iterable[InstallRequirement], wheel_cache: WheelCache, verify: bool, + allow_editables: bool, ) -> BuildResult: """Build wheels. @@ -229,7 +233,7 @@ def build( req, cache_dir, verify, - req.editable and req.permit_editable_wheels, + req.editable and allow_editables, ) if wheel_file: # Record the download origin in the cache diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/README.rst b/.venv/lib/python3.14/site-packages/pip/_vendor/README.rst index a925e8c..cf9feef 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/README.rst +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/README.rst @@ -104,6 +104,7 @@ Modifications * ``requests`` has been modified to import its other dependencies from ``pip._vendor`` and to *not* load ``simplejson`` (all platforms) and ``pyopenssl`` (Windows). +* ``rich`` has been modified to load Unicode tables from its vendored namespace. * ``platformdirs`` has been modified to import its submodules from ``pip._vendor.platformdirs``. Automatic Vendoring @@ -118,12 +119,10 @@ Tool configuration is done via ``pyproject.toml``. To update the vendored library versions, we have a session defined in ``nox``. The command to upgrade everything is:: - nox -s vendoring -- --upgrade-all --skip urllib3 --skip setuptools + nox -s vendoring -- --upgrade-all --skip setuptools -At the time of writing (April 2025) we do not upgrade ``urllib3`` because the -next version is a major upgrade and will be handled as an independent PR. We also -do not upgrade ``setuptools``, because we only rely on ``pkg_resources``, and -tracking every ``setuptools`` change is unnecessary for our needs. +We do not upgrade ``setuptools``, because we only rely on ``pkg_resources``, +and tracking every ``setuptools`` change is unnecessary for our needs. Managing Local Patches diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/__init__.py index 34ccb99..d221476 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/__init__.py @@ -69,6 +69,7 @@ if DEBUNDLED: vendored("pkg_resources") vendored("platformdirs") vendored("progress") + vendored("pygments") vendored("pyproject_hooks") vendored("requests") vendored("requests.exceptions") diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/__init__.py index 090fd58..1a9a755 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/__init__.py @@ -1,4 +1,4 @@ from .core import contents, where __all__ = ["contents", "where"] -__version__ = "2026.01.04" +__version__ = "2026.10.23" diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/cacert.pem b/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/cacert.pem index 132db0d..7b1cc2d 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/cacert.pem +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/certifi/cacert.pem @@ -1,316 +1,4 @@ -# Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited -# Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited -# Label: "QuoVadis Root CA 2" -# Serial: 1289 -# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b -# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7 -# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86 ------BEGIN CERTIFICATE----- -MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x -GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv -b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV -BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W -YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa -GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg -Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J -WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB -rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp -+ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1 -ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i -Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz -PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og -/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH -oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI -yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud -EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2 -A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL -MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT -ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f -BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn -g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl -fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K -WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha -B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc -hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR -TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD -mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z -ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y -4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza -8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u ------END CERTIFICATE----- - -# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited -# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited -# Label: "QuoVadis Root CA 3" -# Serial: 1478 -# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf -# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85 -# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35 ------BEGIN CERTIFICATE----- -MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x -GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv -b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV -BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W -YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM -V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB -4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr -H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd -8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv -vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT -mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe -btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc -T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt -WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ -c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A -4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD -VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG -CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0 -aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0 -aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu -dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw -czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G -A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC -TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg -Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0 -7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem -d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd -+LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B -4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN -t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x -DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57 -k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s -zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j -Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT -mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK -4SVhM7JZG+Ju1zdXtg2pEto= ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Assured ID Root CA" -# Serial: 17154717934120587862167794914071425081 -# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72 -# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43 -# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c ------BEGIN CERTIFICATE----- -MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv -b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG -EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl -cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi -MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c -JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP -mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+ -wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4 -VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/ -AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB -AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW -BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun -pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC -dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf -fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm -NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx -H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe -+o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g== ------END CERTIFICATE----- - -# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert Global Root CA" -# Serial: 10944719598952040374951832963794454346 -# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e -# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36 -# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61 ------BEGIN CERTIFICATE----- -MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD -QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT -MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j -b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG -9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB -CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97 -nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt -43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P -T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4 -gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO -BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR -TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw -DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr -hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg -06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF -PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls -YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk -CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4= ------END CERTIFICATE----- - -# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com -# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com -# Label: "DigiCert High Assurance EV Root CA" -# Serial: 3553400076410547919724730734378100087 -# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a -# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25 -# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf ------BEGIN CERTIFICATE----- -MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs -MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 -d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j -ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL -MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3 -LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug -RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm -+9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW -PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM -xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB -Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3 -hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg -EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF -MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA -FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec -nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z -eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF -hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2 -Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe -vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep -+OkuE6N36B9K ------END CERTIFICATE----- - -# Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG -# Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG -# Label: "SwissSign Gold CA - G2" -# Serial: 13492815561806991280 -# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93 -# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61 -# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95 ------BEGIN CERTIFICATE----- -MIIFujCCA6KgAwIBAgIJALtAHEP1Xk+wMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV -BAYTAkNIMRUwEwYDVQQKEwxTd2lzc1NpZ24gQUcxHzAdBgNVBAMTFlN3aXNzU2ln -biBHb2xkIENBIC0gRzIwHhcNMDYxMDI1MDgzMDM1WhcNMzYxMDI1MDgzMDM1WjBF -MQswCQYDVQQGEwJDSDEVMBMGA1UEChMMU3dpc3NTaWduIEFHMR8wHQYDVQQDExZT -d2lzc1NpZ24gR29sZCBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC -CgKCAgEAr+TufoskDhJuqVAtFkQ7kpJcyrhdhJJCEyq8ZVeCQD5XJM1QiyUqt2/8 -76LQwB8CJEoTlo8jE+YoWACjR8cGp4QjK7u9lit/VcyLwVcfDmJlD909Vopz2q5+ -bbqBHH5CjCA12UNNhPqE21Is8w4ndwtrvxEvcnifLtg+5hg3Wipy+dpikJKVyh+c -6bM8K8vzARO/Ws/BtQpgvd21mWRTuKCWs2/iJneRjOBiEAKfNA+k1ZIzUd6+jbqE -emA8atufK+ze3gE/bk3lUIbLtK/tREDFylqM2tIrfKjuvqblCqoOpd8FUrdVxyJd -MmqXl2MT28nbeTZ7hTpKxVKJ+STnnXepgv9VHKVxaSvRAiTysybUa9oEVeXBCsdt -MDeQKuSeFDNeFhdVxVu1yzSJkvGdJo+hB9TGsnhQ2wwMC3wLjEHXuendjIj3o02y -MszYF9rNt85mndT9Xv+9lz4pded+p2JYryU0pUHHPbwNUMoDAw8IWh+Vc3hiv69y -FGkOpeUDDniOJihC8AcLYiAQZzlG+qkDzAQ4embvIIO1jEpWjpEA/I5cgt6IoMPi -aG59je883WX0XaxR7ySArqpWl2/5rX3aYT+YdzylkbYcjCbaZaIJbcHiVOO5ykxM -gI93e2CaHt+28kgeDrpOVG2Y4OGiGqJ3UM/EY5LsRxmd6+ZrzsECAwEAAaOBrDCB -qTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUWyV7 -lqRlUX64OfPAeGZe6Drn8O4wHwYDVR0jBBgwFoAUWyV7lqRlUX64OfPAeGZe6Drn -8O4wRgYDVR0gBD8wPTA7BglghXQBWQECAQEwLjAsBggrBgEFBQcCARYgaHR0cDov -L3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIBACe6 -45R88a7A3hfm5djV9VSwg/S7zV4Fe0+fdWavPOhWfvxyeDgD2StiGwC5+OlgzczO -UYrHUDFu4Up+GC9pWbY9ZIEr44OE5iKHjn3g7gKZYbge9LgriBIWhMIxkziWMaa5 -O1M/wySTVltpkuzFwbs4AOPsF6m43Md8AYOfMke6UiI0HTJ6CVanfCU2qT1L2sCC -bwq7EsiHSycR+R4tx5M/nttfJmtS2S6K8RTGRI0Vqbe/vd6mGu6uLftIdxf+u+yv -GPUqUfA5hJeVbG4bwyvEdGB5JbAKJ9/fXtI5z0V9QkvfsywexcZdylU6oJxpmo/a -77KwPJ+HbBIrZXAVUjEaJM9vMSNQH4xPjyPDdEFjHFWoFN0+4FFQz/EbMFYOkrCC -hdiDyyJkvC24JdVUorgG6q2SpCSgwYa1ShNqR88uC1aVVMvOmttqtKay20EIhid3 -92qgQmwLOM7XdVAyksLfKzAiSNDVQTglXaTpXZ/GlHXQRf0wl0OPkKsKx4ZzYEpp -Ld6leNcG2mqeSz53OiATIgHQv2ieY2BrNU0LbbqhPcCT4H8js1WtciVORvnSFu+w -ZMEBnunKoGqYDs/YYPIvSbjkQuE4NRb0yG5P94FW6LqjviOvrv1vA+ACOzB2+htt -Qc8Bsem4yWb02ybzOqR08kkkW8mw0FfB+j564ZfJ ------END CERTIFICATE----- - -# Issuer: CN=SecureTrust CA O=SecureTrust Corporation -# Subject: CN=SecureTrust CA O=SecureTrust Corporation -# Label: "SecureTrust CA" -# Serial: 17199774589125277788362757014266862032 -# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1 -# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11 -# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73 ------BEGIN CERTIFICATE----- -MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI -MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x -FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz -MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv -cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN -AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz -Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO -0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao -wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj -7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS -8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT -BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB -/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg -JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC -NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3 -6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/ -3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm -D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS -CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR -3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE= ------END CERTIFICATE----- - -# Issuer: CN=Secure Global CA O=SecureTrust Corporation -# Subject: CN=Secure Global CA O=SecureTrust Corporation -# Label: "Secure Global CA" -# Serial: 9751836167731051554232119481456978597 -# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de -# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b -# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69 ------BEGIN CERTIFICATE----- -MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK -MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x -GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx -MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg -Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG -SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ -iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa -/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ -jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI -HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7 -sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w -gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF -MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw -KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG -AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L -URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO -H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm -I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY -iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc -f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW ------END CERTIFICATE----- - -# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited -# Subject: CN=COMODO Certification Authority O=COMODO CA Limited -# Label: "COMODO Certification Authority" -# Serial: 104350513648249232941998508985834464573 -# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75 -# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b -# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66 ------BEGIN CERTIFICATE----- -MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB -gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G -A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV -BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw -MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl -YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P -RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0 -aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3 -UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI -2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8 -Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp -+2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+ -DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O -nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW -/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g -PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u -QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY -SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv -IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/ -RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4 -zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd -BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB -ZQ== ------END CERTIFICATE----- - # Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited # Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited # Label: "COMODO ECC Certification Authority" @@ -335,105 +23,6 @@ fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY= -----END CERTIFICATE----- -# Issuer: CN=Certigna O=Dhimyotis -# Subject: CN=Certigna O=Dhimyotis -# Label: "Certigna" -# Serial: 18364802974209362175 -# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff -# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97 -# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d ------BEGIN CERTIFICATE----- -MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV -BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X -DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ -BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3 -DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4 -QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny -gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw -zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q -130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2 -JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw -DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw -ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT -AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj -AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG -9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h -bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc -fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu -HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w -t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw -WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg== ------END CERTIFICATE----- - -# Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority -# Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority -# Label: "ePKI Root Certification Authority" -# Serial: 28956088682735189655030529057352760477 -# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3 -# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0 -# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5 ------BEGIN CERTIFICATE----- -MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe -MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0 -ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe -Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw -IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL -SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF -AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH -SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh -ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X -DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1 -TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ -fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA -sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU -WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS -nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH -dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip -NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC -AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF -MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH -ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB -uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl -PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP -JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/ -gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2 -j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6 -5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB -o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS -/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z -Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE -W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D -hNQ+IIX3Sj0rnP0qCglN6oH4EZw= ------END CERTIFICATE----- - -# Issuer: O=certSIGN OU=certSIGN ROOT CA -# Subject: O=certSIGN OU=certSIGN ROOT CA -# Label: "certSIGN ROOT CA" -# Serial: 35210227249154 -# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17 -# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b -# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb ------BEGIN CERTIFICATE----- -MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT -AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD -QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP -MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC -ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do -0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ -UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d -RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ -OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv -JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C -AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O -BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ -LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY -MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ -44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I -Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw -i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN -9u6wWk5JRFRYX0KD ------END CERTIFICATE----- - # Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) # Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services) # Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny" @@ -1097,44 +686,6 @@ aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy KwbQBM0= -----END CERTIFICATE----- -# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera -# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera -# Label: "TeliaSonera Root CA v1" -# Serial: 199041966741090107964904287217786801558 -# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c -# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37 -# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89 ------BEGIN CERTIFICATE----- -MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw -NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv -b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD -VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2 -MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F -VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1 -7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X -Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+ -/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs -81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm -dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe -Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu -sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4 -pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs -slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ -arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD -VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG -9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl -dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx -0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj -TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed -Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7 -Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI -OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7 -vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW -t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn -HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx -SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY= ------END CERTIFICATE----- - # Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center # Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center # Label: "T-TeleSec GlobalRoot Class 2" @@ -1166,35 +717,6 @@ g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN BSeOE6Fuwg== -----END CERTIFICATE----- -# Issuer: CN=Atos TrustedRoot 2011 O=Atos -# Subject: CN=Atos TrustedRoot 2011 O=Atos -# Label: "Atos TrustedRoot 2011" -# Serial: 6643877497813316402 -# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56 -# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21 -# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74 ------BEGIN CERTIFICATE----- -MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE -AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG -EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM -FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC -REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp -Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM -VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+ -SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ -4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L -cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi -eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV -HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG -A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3 -DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j -vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP -DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc -maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D -lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv -KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed ------END CERTIFICATE----- - # Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited # Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited # Label: "QuoVadis Root CA 1 G3" @@ -2483,80 +2005,6 @@ RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx iN66zB+Afko= -----END CERTIFICATE----- -# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI -# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI -# Label: "emSign ECC Root CA - G3" -# Serial: 287880440101571086945156 -# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40 -# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1 -# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b ------BEGIN CERTIFICATE----- -MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG -EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo -bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g -RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ -TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s -b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw -djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0 -WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS -fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB -zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq -hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB -CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD -+JbNR6iC8hZVdyR+EhCVBCyj ------END CERTIFICATE----- - -# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI -# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI -# Label: "emSign Root CA - C1" -# Serial: 825510296613316004955058 -# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68 -# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01 -# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f ------BEGIN CERTIFICATE----- -MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG -A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg -SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw -MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln -biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v -dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ -BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ -HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH -3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH -GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c -xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1 -aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq -TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL -BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87 -/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4 -kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG -YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT -+xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo -WXzhriKi4gp6D/piq1JM4fHfyr6DDUI= ------END CERTIFICATE----- - -# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI -# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI -# Label: "emSign ECC Root CA - C3" -# Serial: 582948710642506000014504 -# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5 -# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66 -# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3 ------BEGIN CERTIFICATE----- -MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG -EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx -IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw -MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln -biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND -IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci -MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti -sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O -BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB -Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c -3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J -0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ== ------END CERTIFICATE----- - # Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post # Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post # Label: "Hongkong Post Root CA 3" @@ -2725,96 +2173,6 @@ PuXaTH4MNMn5X7azKFGnpyuqSfqNZSlO42sTp5SjLVFteAxEy9/eCG/Oo2Sr05WE QRBdJ3NghVdJIgc= -----END CERTIFICATE----- -# Issuer: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc. -# Subject: CN=Trustwave Global Certification Authority O=Trustwave Holdings, Inc. -# Label: "Trustwave Global Certification Authority" -# Serial: 1846098327275375458322922162 -# MD5 Fingerprint: f8:1c:18:2d:2f:ba:5f:6d:a1:6c:bc:c7:ab:91:c7:0e -# SHA1 Fingerprint: 2f:8f:36:4f:e1:58:97:44:21:59:87:a5:2a:9a:d0:69:95:26:7f:b5 -# SHA256 Fingerprint: 97:55:20:15:f5:dd:fc:3c:87:88:c0:06:94:45:55:40:88:94:45:00:84:f1:00:86:70:86:bc:1a:2b:b5:8d:c8 ------BEGIN CERTIFICATE----- -MIIF2jCCA8KgAwIBAgIMBfcOhtpJ80Y1LrqyMA0GCSqGSIb3DQEBCwUAMIGIMQsw -CQYDVQQGEwJVUzERMA8GA1UECAwISWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28x -ITAfBgNVBAoMGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1 -c3R3YXZlIEdsb2JhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0xNzA4MjMx -OTM0MTJaFw00MjA4MjMxOTM0MTJaMIGIMQswCQYDVQQGEwJVUzERMA8GA1UECAwI -SWxsaW5vaXMxEDAOBgNVBAcMB0NoaWNhZ28xITAfBgNVBAoMGFRydXN0d2F2ZSBI -b2xkaW5ncywgSW5jLjExMC8GA1UEAwwoVHJ1c3R3YXZlIEdsb2JhbCBDZXJ0aWZp -Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB -ALldUShLPDeS0YLOvR29zd24q88KPuFd5dyqCblXAj7mY2Hf8g+CY66j96xz0Xzn -swuvCAAJWX/NKSqIk4cXGIDtiLK0thAfLdZfVaITXdHG6wZWiYj+rDKd/VzDBcdu -7oaJuogDnXIhhpCujwOl3J+IKMujkkkP7NAP4m1ET4BqstTnoApTAbqOl5F2brz8 -1Ws25kCI1nsvXwXoLG0R8+eyvpJETNKXpP7ScoFDB5zpET71ixpZfR9oWN0EACyW -80OzfpgZdNmcc9kYvkHHNHnZ9GLCQ7mzJ7Aiy/k9UscwR7PJPrhq4ufogXBeQotP -JqX+OsIgbrv4Fo7NDKm0G2x2EOFYeUY+VM6AqFcJNykbmROPDMjWLBz7BegIlT1l -RtzuzWniTY+HKE40Cz7PFNm73bZQmq131BnW2hqIyE4bJ3XYsgjxroMwuREOzYfw -hI0Vcnyh78zyiGG69Gm7DIwLdVcEuE4qFC49DxweMqZiNu5m4iK4BUBjECLzMx10 -coos9TkpoNPnG4CELcU9402x/RpvumUHO1jsQkUm+9jaJXLE9gCxInm943xZYkqc -BW89zubWR2OZxiRvchLIrH+QtAuRcOi35hYQcRfO3gZPSEF9NUqjifLJS3tBEW1n -twiYTOURGa5CgNz7kAXU+FDKvuStx8KU1xad5hePrzb7AgMBAAGjQjBAMA8GA1Ud -EwEB/wQFMAMBAf8wHQYDVR0OBBYEFJngGWcNYtt2s9o9uFvo/ULSMQ6HMA4GA1Ud -DwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAmHNw4rDT7TnsTGDZqRKGFx6W -0OhUKDtkLSGm+J1WE2pIPU/HPinbbViDVD2HfSMF1OQc3Og4ZYbFdada2zUFvXfe -uyk3QAUHw5RSn8pk3fEbK9xGChACMf1KaA0HZJDmHvUqoai7PF35owgLEQzxPy0Q -lG/+4jSHg9bP5Rs1bdID4bANqKCqRieCNqcVtgimQlRXtpla4gt5kNdXElE1GYhB -aCXUNxeEFfsBctyV3lImIJgm4nb1J2/6ADtKYdkNy1GTKv0WBpanI5ojSP5RvbbE -sLFUzt5sQa0WZ37b/TjNuThOssFgy50X31ieemKyJo90lZvkWx3SD92YHJtZuSPT -MaCm/zjdzyBP6VhWOmfD0faZmZ26NraAL4hHT4a/RDqA5Dccprrql5gR0IRiR2Qe -qu5AvzSxnI9O4fKSTx+O856X3vOmeWqJcU9LJxdI/uz0UA9PSX3MReO9ekDFQdxh -VicGaeVyQYHTtgGJoC86cnn+OjC/QezHYj6RS8fZMXZC+fc8Y+wmjHMMfRod6qh8 -h6jCJ3zhM0EPz8/8AKAigJ5Kp28AsEFFtyLKaEjFQqKu3R3y4G5OBVixwJAWKqQ9 -EEC+j2Jjg6mcgn0tAumDMHzLJ8n9HmYAsC7TIS+OMxZsmO0QqAfWzJPP29FpHOTK -yeC2nOnOcXHebD8WpHk= ------END CERTIFICATE----- - -# Issuer: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc. -# Subject: CN=Trustwave Global ECC P256 Certification Authority O=Trustwave Holdings, Inc. -# Label: "Trustwave Global ECC P256 Certification Authority" -# Serial: 4151900041497450638097112925 -# MD5 Fingerprint: 5b:44:e3:8d:5d:36:86:26:e8:0d:05:d2:59:a7:83:54 -# SHA1 Fingerprint: b4:90:82:dd:45:0c:be:8b:5b:b1:66:d3:e2:a4:08:26:cd:ed:42:cf -# SHA256 Fingerprint: 94:5b:bc:82:5e:a5:54:f4:89:d1:fd:51:a7:3d:df:2e:a6:24:ac:70:19:a0:52:05:22:5c:22:a7:8c:cf:a8:b4 ------BEGIN CERTIFICATE----- -MIICYDCCAgegAwIBAgIMDWpfCD8oXD5Rld9dMAoGCCqGSM49BAMCMIGRMQswCQYD -VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf -BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3 -YXZlIEdsb2JhbCBFQ0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x -NzA4MjMxOTM1MTBaFw00MjA4MjMxOTM1MTBaMIGRMQswCQYDVQQGEwJVUzERMA8G -A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0 -d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF -Q0MgUDI1NiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTBZMBMGByqGSM49AgEGCCqG -SM49AwEHA0IABH77bOYj43MyCMpg5lOcunSNGLB4kFKA3TjASh3RqMyTpJcGOMoN -FWLGjgEqZZ2q3zSRLoHB5DOSMcT9CTqmP62jQzBBMA8GA1UdEwEB/wQFMAMBAf8w -DwYDVR0PAQH/BAUDAwcGADAdBgNVHQ4EFgQUo0EGrJBt0UrrdaVKEJmzsaGLSvcw -CgYIKoZIzj0EAwIDRwAwRAIgB+ZU2g6gWrKuEZ+Hxbb/ad4lvvigtwjzRM4q3wgh -DDcCIC0mA6AFvWvR9lz4ZcyGbbOcNEhjhAnFjXca4syc4XR7 ------END CERTIFICATE----- - -# Issuer: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc. -# Subject: CN=Trustwave Global ECC P384 Certification Authority O=Trustwave Holdings, Inc. -# Label: "Trustwave Global ECC P384 Certification Authority" -# Serial: 2704997926503831671788816187 -# MD5 Fingerprint: ea:cf:60:c4:3b:b9:15:29:40:a1:97:ed:78:27:93:d6 -# SHA1 Fingerprint: e7:f3:a3:c8:cf:6f:c3:04:2e:6d:0e:67:32:c5:9e:68:95:0d:5e:d2 -# SHA256 Fingerprint: 55:90:38:59:c8:c0:c3:eb:b8:75:9e:ce:4e:25:57:22:5f:f5:75:8b:bd:38:eb:d4:82:76:60:1e:1b:d5:80:97 ------BEGIN CERTIFICATE----- -MIICnTCCAiSgAwIBAgIMCL2Fl2yZJ6SAaEc7MAoGCCqGSM49BAMDMIGRMQswCQYD -VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAf -BgNVBAoTGFRydXN0d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3 -YXZlIEdsb2JhbCBFQ0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0x -NzA4MjMxOTM2NDNaFw00MjA4MjMxOTM2NDNaMIGRMQswCQYDVQQGEwJVUzERMA8G -A1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xITAfBgNVBAoTGFRydXN0 -d2F2ZSBIb2xkaW5ncywgSW5jLjE6MDgGA1UEAxMxVHJ1c3R3YXZlIEdsb2JhbCBF -Q0MgUDM4NCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTB2MBAGByqGSM49AgEGBSuB -BAAiA2IABGvaDXU1CDFHBa5FmVXxERMuSvgQMSOjfoPTfygIOiYaOs+Xgh+AtycJ -j9GOMMQKmw6sWASr9zZ9lCOkmwqKi6vr/TklZvFe/oyujUF5nQlgziip04pt89ZF -1PKYhDhloKNDMEEwDwYDVR0TAQH/BAUwAwEB/zAPBgNVHQ8BAf8EBQMDBwYAMB0G -A1UdDgQWBBRVqYSJ0sEyvRjLbKYHTsjnnb6CkDAKBggqhkjOPQQDAwNnADBkAjA3 -AZKXRRJ+oPM+rRk6ct30UJMDEr5E0k9BpIycnR+j9sKS50gU/k6bpZFXrsY3crsC -MGclCrEMXu6pY5Jv5ZAL/mYiykf9ijH3g/56vxC+GCsej/YpHpRZ744hN8tRmKVu -Sw== ------END CERTIFICATE----- - # Issuer: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp. # Subject: CN=NAVER Global Root Certification Authority O=NAVER BUSINESS PLATFORM Corp. # Label: "NAVER Global Root Certification Authority" @@ -3375,45 +2733,6 @@ Z6tGn6D/Qqc6f1zLXbBwHSs09dR2CQzreExZBfMzQsNhFRAbd03OIozUhfJFfbdT bP6MvPJwNQzcmRk13NfIRmPVNnGuV/u3gm3c -----END CERTIFICATE----- -# Issuer: CN=GTS Root R2 O=Google Trust Services LLC -# Subject: CN=GTS Root R2 O=Google Trust Services LLC -# Label: "GTS Root R2" -# Serial: 159662449406622349769042896298 -# MD5 Fingerprint: 1e:39:c0:53:e6:1e:29:82:0b:ca:52:55:36:5d:57:dc -# SHA1 Fingerprint: 9a:44:49:76:32:db:de:fa:d0:bc:fb:5a:7b:17:bd:9e:56:09:24:94 -# SHA256 Fingerprint: 8d:25:cd:97:22:9d:bf:70:35:6b:da:4e:b3:cc:73:40:31:e2:4c:f0:0f:af:cf:d3:2d:c7:6e:b5:84:1c:7e:a8 ------BEGIN CERTIFICATE----- -MIIFVzCCAz+gAwIBAgINAgPlrsWNBCUaqxElqjANBgkqhkiG9w0BAQwFADBHMQsw -CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU -MBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw -MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp -Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEBAQUA -A4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3LvCvpt -nfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3KgGjSY -6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9BuXvAu -MC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOdre7k -RXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXuPuWg -f9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1mKPV -+3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K8Yzo -dDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqjx5RW -Ir9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsRnTKa -G73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0kzCq -gc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9OktwID -AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E -FgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBAB/Kzt3H -vqGf2SdMC9wXmBFqiN495nFWcrKeGk6c1SuYJF2ba3uwM4IJvd8lRuqYnrYb/oM8 -0mJhwQTtzuDFycgTE1XnqGOtjHsB/ncw4c5omwX4Eu55MaBBRTUoCnGkJE+M3DyC -B19m3H0Q/gxhswWV7uGugQ+o+MePTagjAiZrHYNSVc61LwDKgEDg4XSsYPWHgJ2u -NmSRXbBoGOqKYcl3qJfEycel/FVL8/B/uWU9J2jQzGv6U53hkRrJXRqWbTKH7QMg -yALOWr7Z6v2yTcQvG99fevX4i8buMTolUVVnjWQye+mew4K6Ki3pHrTgSAai/Gev -HyICc/sgCq+dVEuhzf9gR7A/Xe8bVr2XIZYtCtFenTgCR2y59PYjJbigapordwj6 -xLEokCZYCDzifqrXPW+6MYgKBesntaFJ7qBFVHvmJ2WZICGoo7z7GJa7Um8M7YNR -TOlZ4iBgxcJlkoKM8xAfDoqXvneCbT+PHV28SSe9zE8P4c52hgQjxcCMElv924Sg -JPFI/2R80L5cFtHvma3AH/vLrrw4IgYmZNralw4/KBVEqE8AyvCazM90arQ+POuV -7LXTWtiBmelDGDfrs7vRWGJB82bSj6p4lVQgw1oudCvV0b4YacCs1aTPObpRhANl -6WLAYv7YTVWW4tAR+kg0Eeye7QUd5MjWHYbL ------END CERTIFICATE----- - # Issuer: CN=GTS Root R3 O=Google Trust Services LLC # Subject: CN=GTS Root R3 O=Google Trust Services LLC # Label: "GTS Root R3" @@ -4066,30 +3385,6 @@ ntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0o82bNSQ3+pCTE4FCxpgm dTdmQRCsu/WU48IxK63nI1bMNSWSs1A= -----END CERTIFICATE----- -# Issuer: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA -# Subject: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA -# Label: "FIRMAPROFESIONAL CA ROOT-A WEB" -# Serial: 65916896770016886708751106294915943533 -# MD5 Fingerprint: 82:b2:ad:45:00:82:b0:66:63:f8:5f:c3:67:4e:ce:a3 -# SHA1 Fingerprint: a8:31:11:74:a6:14:15:0d:ca:77:dd:0e:e4:0c:5d:58:fc:a0:72:a5 -# SHA256 Fingerprint: be:f2:56:da:f2:6e:9c:69:bd:ec:16:02:35:97:98:f3:ca:f7:18:21:a0:3e:01:82:57:c5:3c:65:61:7f:3d:4a ------BEGIN CERTIFICATE----- -MIICejCCAgCgAwIBAgIQMZch7a+JQn81QYehZ1ZMbTAKBggqhkjOPQQDAzBuMQsw -CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE -YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB -IFJPT1QtQSBXRUIwHhcNMjIwNDA2MDkwMTM2WhcNNDcwMzMxMDkwMTM2WjBuMQsw -CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE -YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB -IFJPT1QtQSBXRUIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARHU+osEaR3xyrq89Zf -e9MEkVz6iMYiuYMQYneEMy3pA4jU4DP37XcsSmDq5G+tbbT4TIqk5B/K6k84Si6C -cyvHZpsKjECcfIr28jlgst7L7Ljkb+qbXbdTkBgyVcUgt5SjYzBhMA8GA1UdEwEB -/wQFMAMBAf8wHwYDVR0jBBgwFoAUk+FDY1w8ndYn81LsF7Kpryz3dvgwHQYDVR0O -BBYEFJPhQ2NcPJ3WJ/NS7Beyqa8s93b4MA4GA1UdDwEB/wQEAwIBBjAKBggqhkjO -PQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgLcFBTApFw -hVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dG -XSaQpYXFuXqUPoeovQA= ------END CERTIFICATE----- - # Issuer: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA # Subject: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA # Label: "TWCA CYBER Root CA" @@ -4130,35 +3425,6 @@ xeSDwWrruoBa3lwtcHb4yOWHh8qgnaHlIhInD0Q9HWzq1MKLL295q39QpsQZp6F6 t5b5wR9iWqJDB0BeJsas7a5wFsWqynKKTbDPAYsDP27X -----END CERTIFICATE----- -# Issuer: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd. -# Subject: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd. -# Label: "SecureSign Root CA12" -# Serial: 587887345431707215246142177076162061960426065942 -# MD5 Fingerprint: c6:89:ca:64:42:9b:62:08:49:0b:1e:7f:e9:07:3d:e8 -# SHA1 Fingerprint: 7a:22:1e:3d:de:1b:06:ac:9e:c8:47:70:16:8e:3c:e5:f7:6b:06:f4 -# SHA256 Fingerprint: 3f:03:4b:b5:70:4d:44:b2:d0:85:45:a0:20:57:de:93:eb:f3:90:5f:ce:72:1a:cb:c7:30:c0:6d:da:ee:90:4e ------BEGIN CERTIFICATE----- -MIIDcjCCAlqgAwIBAgIUZvnHwa/swlG07VOX5uaCwysckBYwDQYJKoZIhvcNAQEL -BQAwUTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28u -LCBMdGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExMjAeFw0yMDA0MDgw -NTM2NDZaFw00MDA0MDgwNTM2NDZaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpD -eWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBS -b290IENBMTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6OcE3emhF -KxS06+QT61d1I02PJC0W6K6OyX2kVzsqdiUzg2zqMoqUm048luT9Ub+ZyZN+v/mt -p7JIKwccJ/VMvHASd6SFVLX9kHrko+RRWAPNEHl57muTH2SOa2SroxPjcf59q5zd -J1M3s6oYwlkm7Fsf0uZlfO+TvdhYXAvA42VvPMfKWeP+bl+sg779XSVOKik71gur -FzJ4pOE+lEa+Ym6b3kaosRbnhW70CEBFEaCeVESE99g2zvVQR9wsMJvuwPWW0v4J -hscGWa5Pro4RmHvzC1KqYiaqId+OJTN5lxZJjfU+1UefNzFJM3IFTQy2VYzxV4+K -h9GtxRESOaCtAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD -AgEGMB0GA1UdDgQWBBRXNPN0zwRL1SXm8UC2LEzZLemgrTANBgkqhkiG9w0BAQsF -AAOCAQEAPrvbFxbS8hQBICw4g0utvsqFepq2m2um4fylOqyttCg6r9cBg0krY6Ld -mmQOmFxv3Y67ilQiLUoT865AQ9tPkbeGGuwAtEGBpE/6aouIs3YIcipJQMPTw4WJ -mBClnW8Zt7vPemVV2zfrPIpyMpcemik+rY3moxtt9XUa5rBouVui7mlHJzWhhpmA -8zNL4WukJsPvdFlseqJkth5Ew1DgDzk9qTPxpfPSvWKErI4cqc1avTc7bgoitPQV -55FYxTpE05Uo2cBl6XLK0A+9H7MV2anjpEcJnuDLN/v9vZfVvhgaaaI5gdka9at/ -yOPiZwud9AzqVN/Ssq+xIvEg37xEHA== ------END CERTIFICATE----- - # Issuer: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd. # Subject: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd. # Label: "SecureSign Root CA14" @@ -4429,7 +3695,7 @@ YmH5LVerVrkR3SW+ak5KGoJr3M/TvEqzPNcum9v4KGm8ay3sMaE641c= # Issuer: CN=OISTE Server Root RSA G1 O=OISTE Foundation # Subject: CN=OISTE Server Root RSA G1 O=OISTE Foundation -# Label: " OISTE Server Root RSA G1" +# Label: "OISTE Server Root RSA G1" # Serial: 113845518112613905024960613408179309848 # MD5 Fingerprint: 23:a7:9e:d4:70:b8:b9:14:57:41:8a:7e:44:59:e2:68 # SHA1 Fingerprint: f7:00:34:25:94:88:68:31:e4:34:87:3f:70:fe:86:b3:86:9f:f0:6e @@ -4466,3 +3732,154 @@ J8tRd/iWkx7P8nd9H0aTolkelUTFLXVksNb54Dxp6gS1HAviRkRNQzuXSXERvSS2 wq1yVAb+axj5d9spLFKebXd7Yv0PTY6YMjAwcRLWJTXjn/hvnLXrahut6hDTlhZy BiElxky8j3C7DOReIoMt0r7+hVu05L0= -----END CERTIFICATE----- + +# Issuer: CN=e-Szigno TLS Root CA 2023 O=Microsec Ltd. +# Subject: CN=e-Szigno TLS Root CA 2023 O=Microsec Ltd. +# Label: "e-Szigno TLS Root CA 2023" +# Serial: 71934828665710877219916191754 +# MD5 Fingerprint: 6a:e9:99:74:a5:da:5e:f1:d9:2e:f2:c8:d1:86:8b:71 +# SHA1 Fingerprint: 6f:9a:d5:d5:df:e8:2c:eb:be:37:07:ee:4f:4f:52:58:29:41:d1:fe +# SHA256 Fingerprint: b4:91:41:50:2d:00:66:3d:74:0f:2e:7e:c3:40:c5:28:00:96:26:66:12:1a:36:d0:9c:f7:dd:2b:90:38:4f:b4 +-----BEGIN CERTIFICATE----- +MIICzzCCAjGgAwIBAgINAOhvGHvWOWuYSkmYCjAKBggqhkjOPQQDBDB1MQswCQYD +VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0 +ZC4xFzAVBgNVBGEMDlZBVEhVLTIzNTg0NDk3MSIwIAYDVQQDDBllLVN6aWdubyBU +TFMgUm9vdCBDQSAyMDIzMB4XDTIzMDcxNzE0MDAwMFoXDTM4MDcxNzE0MDAwMFow +dTELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRYwFAYDVQQKDA1NaWNy +b3NlYyBMdGQuMRcwFQYDVQRhDA5WQVRIVS0yMzU4NDQ5NzEiMCAGA1UEAwwZZS1T +emlnbm8gVExTIFJvb3QgQ0EgMjAyMzCBmzAQBgcqhkjOPQIBBgUrgQQAIwOBhgAE +AGgP36J8PKp0iGEKjcJMpQEiFNT3YHdCnAo4YKGMZz6zY+n6kbCLS+Y53wLCMAFS +AL/fjO1ZrTJlqwlZULUZwmgcAOAFX9pQJhzDrAQixTpN7+lXWDajwRlTEArRzT/v +SzUaQ49CE0y5LBqcvjC2xN7cS53kpDzLLtmt3999Cd8ukv+ho2MwYTAPBgNVHRMB +Af8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUWYQCYlpGePVd3I8K +ECgj3NXW+0UwHwYDVR0jBBgwFoAUWYQCYlpGePVd3I8KECgj3NXW+0UwCgYIKoZI +zj0EAwQDgYsAMIGHAkIBLdqu9S54tma4n7Zwf2Z0z+yOfP7AAXmazlIC58PRDHpt +y7Ve7hekm9sEdu4pKeiv+62sUvTXK9Z3hBC9xdIoaDQCQTV2WnXzkoYI9bIeCvZl +C9p2x1L/Cx6AcCIwwzPbGO2E14vs7dOoY4G1VnxHx1YwlGhza9IuqbnZLBwpvQy6 +uWWL +-----END CERTIFICATE----- + +# Issuer: CN=SECOM TLS RSA Root CA 2024 O=SECOM Trust Systems Co., Ltd. +# Subject: CN=SECOM TLS RSA Root CA 2024 O=SECOM Trust Systems Co., Ltd. +# Label: "SECOM TLS RSA Root CA 2024" +# Serial: 17188327524208271538 +# MD5 Fingerprint: d0:a4:db:32:eb:44:98:d2:62:0b:3e:bc:4d:7c:5c:e9 +# SHA1 Fingerprint: fb:97:96:7c:ef:8d:98:63:06:c0:3b:b6:11:f8:e0:13:97:a2:98:d3 +# SHA256 Fingerprint: 14:35:f2:25:c5:d2:52:d7:a2:19:48:cc:3c:e6:2a:ec:fa:88:00:1e:3d:d7:2d:1c:c3:55:51:00:eb:37:2f:93 +-----BEGIN CERTIFICATE----- +MIIFmjCCA4KgAwIBAgIJAO6JNNDLgOCyMA0GCSqGSIb3DQEBDAUAMFoxCzAJBgNV +BAYTAkpQMSYwJAYDVQQKEx1TRUNPTSBUcnVzdCBTeXN0ZW1zIENvLiwgTHRkLjEj +MCEGA1UEAxMaU0VDT00gVExTIFJTQSBSb290IENBIDIwMjQwHhcNMjQwMTMxMDUx +MTU1WhcNNDkwMTE0MDUxMTU1WjBaMQswCQYDVQQGEwJKUDEmMCQGA1UEChMdU0VD +T00gVHJ1c3QgU3lzdGVtcyBDby4sIEx0ZC4xIzAhBgNVBAMTGlNFQ09NIFRMUyBS +U0EgUm9vdCBDQSAyMDI0MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA +4TjizUwzxbInq8Tx11gaFYNk5fO+34y7TyM4neh0UgL5JIZbJNLTz2x//L/B71+5 +m6X6nGIr7d4lFJBGtjO677hXOz93zkcWaUTm3VbOAjBlt4YWxlcccBHXuZ7o3Q+4 +R+ormrBdHeJ1CTUEG8ttQbKIl3G7OZYbnH8/pP8cjPub/0kDVNuMzp7xsVRROOis +Qt53fMoJLlYgoebbuMphOqMCtjkJ7R6efEMfLp8UAVi9ZaLRn76ET/CJkk925ndu +uufC4BatS4mnXFmxN0vUXb0ij9B8O/D8gixQEsVSD4GK8FWRPh3bVd/6bzdkHGJj +y21XI0yejVomZUbRrOfNuz0boPGV1pt18fFC39IHQEth3OFqb5NDO3L+A9bNqTgA +yUgRmIn4ucgDc/Ri/Km3V51ueZjy1/yk0qwJVadAVVrCt56iNeXOyEvzJADGgDQ8 +E1Pdaqct8Cynz/47ReQM62vFYO08wcQkrjmX/tesiko1V1yyaf6EfPzUFzmaGy9x +vkCwdbm15EdTolOjE0H2Vb5/APDOyCFEokiYGmXTLdAUl0wKZ4IyjkHGzy0jhpaX +EXE/GJcEvI6VzEchjaBL03EJ0h9pG4OqeIOycKvAo3A+TbetyfsrgYyHzU0a7/qU +jGat1AAq1nVljMpKqpinPTsf/d9H39FTUeJL7TpzzjUCAwEAAaNjMGEwHQYDVR0O +BBYEFCzrchKOWHdkNRVWNQFXB6l9DTbmMB8GA1UdIwQYMBaAFCzrchKOWHdkNRVW +NQFXB6l9DTbmMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqG +SIb3DQEBDAUAA4ICAQAVwsvluSafaez5tFPR/hRTBzRxEyMMQF3XJXCVi3yegZyK +oec7hmE6jx2ZM8KgM1kn2yJRwFXHX8zUW9nBLEDWc4wuE8LrlZqhGZM9pJQXGmGz +ResDJV6JgRBna+j4sA1M7yIdlvL0sAfFXFCTRaWTD4E1V99RLrFzWfTcC+e180hD +uNMpqOEo46+lMeW/Wvh7ifOQs+kiK0O2gHxQDNxslSavnCs4V7l8HRDJ2La10o70 +Bo7VLzf1W8MBvv0VTnxB+NjT5qTAbhGFh9Gvp4BaJpmdUf0C5CEP6dbQlfgxWfzY +r69yVT6dPQB+GFEaY03IMY+AcBCs+om1fNxrQXt9zoofMBNFbLhvpNH/JsXWdGUz +fNbO12uswTa5wah8LB18FTQN2/zPHYmvBEoLuyUgZ09VNLJo5YA0kXItVYkLjMe2 +SixzK4scUHv81IK99I91DWx7FwMVKw2xgFp+ZLYB2dnpQQrqwlW64glHUcK2N9BD +snjLSxeZ+UPECh9RxH4WAcKiZW+cqaKMmhP2WBfR4IcR7NOL32ml11ds87hhV1CZ +WWFCJAcCidYZz6CZa8exzHojP9SB5RH0/v1KdHAisqhSjtJl/UIAHIQ48elOn8wr +TdFap4Yb5aHglmMeNx+fAIhDluWVfxTO7H4dTPU+SFVRMLAh+wwKZfqb94nMeQ== +-----END CERTIFICATE----- + +# Issuer: CN=SECOM TLS ECC Root CA 2024 O=SECOM Trust Systems Co., Ltd. +# Subject: CN=SECOM TLS ECC Root CA 2024 O=SECOM Trust Systems Co., Ltd. +# Label: "SECOM TLS ECC Root CA 2024" +# Serial: 9329818985461676612 +# MD5 Fingerprint: 99:d3:9d:e4:d2:b1:2d:f0:2a:04:67:85:f3:df:46:d6 +# SHA1 Fingerprint: 7a:1f:22:2d:72:b2:c3:19:87:44:db:61:69:e8:a6:4b:d7:0d:44:0e +# SHA256 Fingerprint: 6a:b2:ab:75:f5:1c:b4:f4:f0:15:62:03:fb:f6:f6:46:23:2f:51:4b:e0:59:f6:28:33:30:8b:82:b4:d7:2d:b1 +-----BEGIN CERTIFICATE----- +MIICTDCCAdGgAwIBAgIJAIF6LO+PI3pEMAoGCCqGSM49BAMDMFoxCzAJBgNVBAYT +AkpQMSYwJAYDVQQKEx1TRUNPTSBUcnVzdCBTeXN0ZW1zIENvLiwgTHRkLjEjMCEG +A1UEAxMaU0VDT00gVExTIEVDQyBSb290IENBIDIwMjQwHhcNMjQwMTMxMDU1MjM0 +WhcNNDkwMTE0MDU1MjM0WjBaMQswCQYDVQQGEwJKUDEmMCQGA1UEChMdU0VDT00g +VHJ1c3QgU3lzdGVtcyBDby4sIEx0ZC4xIzAhBgNVBAMTGlNFQ09NIFRMUyBFQ0Mg +Um9vdCBDQSAyMDI0MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE7NzFMtu9dzQXSNC1 +2fabk0+GlC5finB3R7XaZonRUd20aFiWObtuNBCLUZSfk6QXAE55BjEXsXQ/NG8y +UqicXjsu9ksDK3JZBgCwLOVh6+nwJXTvso/dEj/GUYH5mBdoo2MwYTAdBgNVHQ4E +FgQUO3YReyl04k4GTFaCQNAhL3qzydUwHwYDVR0jBBgwFoAUO3YReyl04k4GTFaC +QNAhL3qzydUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wCgYIKoZI +zj0EAwMDaQAwZgIxAN3ib8fi1pMYtAPjMilB5e5/H+t5CL0xPL+cZ5oTTZuSCjpA +n1v7F/VAr8bFxQXAowIxAKsBVO1ACFp7skwzPvdv1EUY5a897WGLT4lb+bjxFAWy +l8wDcZJdwGZ/pAHxt1AJ1g== +-----END CERTIFICATE----- + +# Issuer: CN=Telia EC TLS Root CA v3 O=Telia Company AB +# Subject: CN=Telia EC TLS Root CA v3 O=Telia Company AB +# Label: "Telia EC TLS Root CA v3" +# Serial: 8028200332079443110287896228123317 +# MD5 Fingerprint: b6:fa:6a:5c:42:fb:c5:67:72:c0:e0:2f:72:fb:5a:44 +# SHA1 Fingerprint: b4:d6:07:c2:a5:95:bc:5b:f4:67:4d:c9:dc:6f:6f:0a:00:7a:a5:35 +# SHA256 Fingerprint: 09:8e:08:a9:1d:bb:f7:74:78:b9:6c:ce:b8:9b:14:13:a5:da:37:b7:c8:62:60:6a:95:5d:eb:07:17:9f:43:26 +-----BEGIN CERTIFICATE----- +MIICMjCCAbegAwIBAgIPAYvSIlRjTQSLbOVHH9K1MAoGCCqGSM49BAMDMEoxCzAJ +BgNVBAYTAlNFMRkwFwYDVQQKDBBUZWxpYSBDb21wYW55IEFCMSAwHgYDVQQDDBdU +ZWxpYSBFQyBUTFMgUm9vdCBDQSB2MzAeFw0yMzExMTUwODU1MjZaFw00ODA1MjMx +MTAwMDBaMEoxCzAJBgNVBAYTAlNFMRkwFwYDVQQKDBBUZWxpYSBDb21wYW55IEFC +MSAwHgYDVQQDDBdUZWxpYSBFQyBUTFMgUm9vdCBDQSB2MzB2MBAGByqGSM49AgEG +BSuBBAAiA2IABMHIlhVDLbmFKUpW0iK4dpryT6emYOeS31JPwWnWPmkWRrAkTbPX +40sQfHI9mpR7Rbktu3ngg6W+BBSXSechtMCnBmWXj/EaVlmV5cY1jD2HoTfhBQ3A +acpCNMLJK4NpZaNjMGEwHwYDVR0jBBgwFoAU1GToQ4g6cy/QGnGCNgtehd7H3kMw +HQYDVR0OBBYEFNRk6EOIOnMv0BpxgjYLXoXex95DMA4GA1UdDwEB/wQEAwIBBjAP +BgNVHRMBAf8EBTADAQH/MAoGCCqGSM49BAMDA2kAMGYCMQCXAUdS/9bbJ8A1JYaG +f/bWt/s7Ta0ot5Ulno8OjSNYRWQIlS4tVWldvTAVA7heOFgCMQCvKr8+Z2Rn+OBr +5UHzlgBObpad1LuwNTRcdNgUJxIWadcki+UBLEi1/AURKV5md2M= +-----END CERTIFICATE----- + +# Issuer: CN=Telia RSA TLS Root CA v3 O=Telia Company AB +# Subject: CN=Telia RSA TLS Root CA v3 O=Telia Company AB +# Label: "Telia RSA TLS Root CA v3" +# Serial: 8028214673410753541795188766939845 +# MD5 Fingerprint: f4:8b:9c:f3:f8:63:cf:dc:25:8f:b4:bb:a2:e9:9d:e2 +# SHA1 Fingerprint: b5:2e:88:4e:40:c1:11:fb:50:c7:e2:4f:ac:18:2b:bd:68:15:d2:34 +# SHA256 Fingerprint: d1:3d:b1:29:4c:45:eb:c6:fc:86:c6:bb:f6:9f:a2:9b:df:e6:92:df:f7:c7:13:c2:43:c7:a9:56:c6:a2:28:4c +-----BEGIN CERTIFICATE----- +MIIFgjCCA2qgAwIBAgIPAYvSUKtCVSxHWr2h3BrFMA0GCSqGSIb3DQEBDAUAMEsx +CzAJBgNVBAYTAlNFMRkwFwYDVQQKDBBUZWxpYSBDb21wYW55IEFCMSEwHwYDVQQD +DBhUZWxpYSBSU0EgVExTIFJvb3QgQ0EgdjMwHhcNMjMxMTE1MDk0NzQyWhcNNDgw +NTIzMTEwMDAwWjBLMQswCQYDVQQGEwJTRTEZMBcGA1UECgwQVGVsaWEgQ29tcGFu +eSBBQjEhMB8GA1UEAwwYVGVsaWEgUlNBIFRMUyBSb290IENBIHYzMIICIjANBgkq +hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAsV89KG19hCf4S1Fvk8D3TyDERhmcvx8F +7Kmb4WATx3ije1id3KHxRE0TKmcNCbAQ57bvHFEYa4hR2l20VjVadExqOW+2ld99 +MbEiO+jRVOz+BbxLxJnmGwCqI+BfuTjjVReDxsxjQvjgBsClaO/sm5i70nlZcWGR +tIkvWDK3NNkT5RtwXc/O8NTFVpbUqT6cRjIj3olAblR+lRf4Ffy5o+Q9fabjYn9Z +9S4itruElcEFf9Ljk7fwdTycT/rvJW9w/B3G2a3r0f/zXNOVruIBcqE6pkSospAC +U2bG42fYKrbM/GWnp7u+p9Frz4jaNwpb4YHuEeS8BratNcP8X62jXIvvKHxlsMDJ +Cnb4U8JzFOLsU6mohVY58BdZrvi0Gk9UOuqmgoG6dskHoksjZTlK61D/InzmEoA1 +yAYJFDVysjRxDUOu9cAwANbqmq77WIFL6BpnZgVqPtMfG6wN8BrTKdapvilVsYR5 +9BFgIsAVBMxrGh+W+QcvmJafUpASvlArKvVG2FI4i6PiLjSBT0+6F6EQLrYqefOQ +F/fBNEXb+njUQ0SUVrAqtH4Y+OjCI/a4/JJQppxeemZcQ0SUShgiI5AM5xHO5iya +UrTjYH4zxUz9j+1FEbDH/xpstr1gXBykspup+hRTaJcbA+UbpJqtWZndAPddJmt6 +YJQ+dU3pDu8CAwEAAaNjMGEwHwYDVR0jBBgwFoAUsMep0t2yKFZzBJSMFFxIbzdS +kqgwHQYDVR0OBBYEFLDHqdLdsihWcwSUjBRcSG83UpKoMA4GA1UdDwEB/wQEAwIB +BjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBDAUAA4ICAQBdYzFsNGDRk7bR +/AgRKq+5637YuOW+w6uhpoS0VnKMUpyHCwku86hEvqivakPtfmlm4bFwt++sb/8O +XsWBqtfbXMaBNDTZl8XRMJuLWOW2JrbKkRzgG0eBUcvsadG1rrhbmZqYvFXaAZO7 +o4TdOZzxhBB5GOAWWXB3IeraNP4J63zyo9n8Gqw3sJBG44em5hoYjBffP+npibys +lnslRi4L6xHsCYj/Pab+OlqbMCB6v+sTCLeEIukRVzoR9aQ45pEK7Z1QBnSsbAKQ +tss0JKD9d/mX143H1xePjPhTXlv5JCkhrcj+SShz0P9+EHoWe6m9lyUEOIVn0rp+ +yVJWNbmyDv3VkwFxHC1ApSQsgSimjGQ4wtr6cSmordYxkV+Ro8lOIIhRksXPyDk2 +7gW6IjUXCkZKpxFjkL3jiBSc8SkxnwCWtXg8xwNwdFVNBGLCCuJnsneYXjJNqzRq +UcoGwzsvF3Qi/ZnHUNvISdevlgIAXL4Wvrxaqvoa01wB+GCfs57RTGE4TvAGhKNK +us8K3hRT1BSpigzMIRzSxtAOrqPN6j//QSmW9f8Jcncri4j2ihSpVrFU0NdNkMhZ +eAKidTFPsxCVFuW4Aniz7jqiw5sWtjbQrlW035izIEU4sYwQoC1Nx0Svy+mMTRai +50LqFQ+A1/Hq6xHHDNx7CI83d23Erw== +-----END CERTIFICATE----- diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/LICENSE.txt b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/LICENSE.txt deleted file mode 100644 index b9723b8..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/LICENSE.txt +++ /dev/null @@ -1,9 +0,0 @@ -MIT License - -Copyright (c) 2024-present Stephen Rosen - -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/python3.14/site-packages/pip/_vendor/dependency_groups/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/__init__.py deleted file mode 100644 index 9fec202..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -from ._implementation import ( - CyclicDependencyError, - DependencyGroupInclude, - DependencyGroupResolver, - resolve, -) - -__all__ = ( - "CyclicDependencyError", - "DependencyGroupInclude", - "DependencyGroupResolver", - "resolve", -) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/__main__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/__main__.py deleted file mode 100644 index 48ebb0d..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/__main__.py +++ /dev/null @@ -1,65 +0,0 @@ -import argparse -import sys - -from ._implementation import resolve -from ._toml_compat import tomllib - - -def main() -> None: - if tomllib is None: - print( - "Usage error: dependency-groups CLI requires tomli or Python 3.11+", - file=sys.stderr, - ) - raise SystemExit(2) - - parser = argparse.ArgumentParser( - description=( - "A dependency-groups CLI. Prints out a resolved group, newline-delimited." - ) - ) - parser.add_argument( - "GROUP_NAME", nargs="*", help="The dependency group(s) to resolve." - ) - parser.add_argument( - "-f", - "--pyproject-file", - default="pyproject.toml", - help="The pyproject.toml file. Defaults to trying in the current directory.", - ) - parser.add_argument( - "-o", - "--output", - help="An output file. Defaults to stdout.", - ) - parser.add_argument( - "-l", - "--list", - action="store_true", - help="List the available dependency groups", - ) - args = parser.parse_args() - - with open(args.pyproject_file, "rb") as fp: - pyproject = tomllib.load(fp) - - dependency_groups_raw = pyproject.get("dependency-groups", {}) - - if args.list: - print(*dependency_groups_raw.keys()) - return - if not args.GROUP_NAME: - print("A GROUP_NAME is required", file=sys.stderr) - raise SystemExit(3) - - content = "\n".join(resolve(dependency_groups_raw, *args.GROUP_NAME)) - - if args.output is None or args.output == "-": - print(content) - else: - with open(args.output, "w", encoding="utf-8") as fp: - print(content, file=fp) - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_implementation.py b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_implementation.py deleted file mode 100644 index 64e314a..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_implementation.py +++ /dev/null @@ -1,209 +0,0 @@ -from __future__ import annotations - -import dataclasses -import re -from collections.abc import Mapping - -from pip._vendor.packaging.requirements import Requirement - - -def _normalize_name(name: str) -> str: - return re.sub(r"[-_.]+", "-", name).lower() - - -def _normalize_group_names( - dependency_groups: Mapping[str, str | Mapping[str, str]], -) -> Mapping[str, str | Mapping[str, str]]: - original_names: dict[str, list[str]] = {} - normalized_groups = {} - - for group_name, value in dependency_groups.items(): - normed_group_name = _normalize_name(group_name) - original_names.setdefault(normed_group_name, []).append(group_name) - normalized_groups[normed_group_name] = value - - errors = [] - for normed_name, names in original_names.items(): - if len(names) > 1: - errors.append(f"{normed_name} ({', '.join(names)})") - if errors: - raise ValueError(f"Duplicate dependency group names: {', '.join(errors)}") - - return normalized_groups - - -@dataclasses.dataclass -class DependencyGroupInclude: - include_group: str - - -class CyclicDependencyError(ValueError): - """ - An error representing the detection of a cycle. - """ - - def __init__(self, requested_group: str, group: str, include_group: str) -> None: - self.requested_group = requested_group - self.group = group - self.include_group = include_group - - if include_group == group: - reason = f"{group} includes itself" - else: - reason = f"{include_group} -> {group}, {group} -> {include_group}" - super().__init__( - "Cyclic dependency group include while resolving " - f"{requested_group}: {reason}" - ) - - -class DependencyGroupResolver: - """ - A resolver for Dependency Group data. - - This class handles caching, name normalization, cycle detection, and other - parsing requirements. There are only two public methods for exploring the data: - ``lookup()`` and ``resolve()``. - - :param dependency_groups: A mapping, as provided via pyproject - ``[dependency-groups]``. - """ - - def __init__( - self, - dependency_groups: Mapping[str, str | Mapping[str, str]], - ) -> None: - if not isinstance(dependency_groups, Mapping): - raise TypeError("Dependency Groups table is not a mapping") - self.dependency_groups = _normalize_group_names(dependency_groups) - # a map of group names to parsed data - self._parsed_groups: dict[ - str, tuple[Requirement | DependencyGroupInclude, ...] - ] = {} - # a map of group names to their ancestors, used for cycle detection - self._include_graph_ancestors: dict[str, tuple[str, ...]] = {} - # a cache of completed resolutions to Requirement lists - self._resolve_cache: dict[str, tuple[Requirement, ...]] = {} - - def lookup(self, group: str) -> tuple[Requirement | DependencyGroupInclude, ...]: - """ - Lookup a group name, returning the parsed dependency data for that group. - This will not resolve includes. - - :param group: the name of the group to lookup - - :raises ValueError: if the data does not appear to be valid dependency group - data - :raises TypeError: if the data is not a string - :raises LookupError: if group name is absent - :raises packaging.requirements.InvalidRequirement: if a specifier is not valid - """ - if not isinstance(group, str): - raise TypeError("Dependency group name is not a str") - group = _normalize_name(group) - return self._parse_group(group) - - def resolve(self, group: str) -> tuple[Requirement, ...]: - """ - Resolve a dependency group to a list of requirements. - - :param group: the name of the group to resolve - - :raises TypeError: if the inputs appear to be the wrong types - :raises ValueError: if the data does not appear to be valid dependency group - data - :raises LookupError: if group name is absent - :raises packaging.requirements.InvalidRequirement: if a specifier is not valid - """ - if not isinstance(group, str): - raise TypeError("Dependency group name is not a str") - group = _normalize_name(group) - return self._resolve(group, group) - - def _parse_group( - self, group: str - ) -> tuple[Requirement | DependencyGroupInclude, ...]: - # short circuit -- never do the work twice - if group in self._parsed_groups: - return self._parsed_groups[group] - - if group not in self.dependency_groups: - raise LookupError(f"Dependency group '{group}' not found") - - raw_group = self.dependency_groups[group] - if not isinstance(raw_group, list): - raise TypeError(f"Dependency group '{group}' is not a list") - - elements: list[Requirement | DependencyGroupInclude] = [] - for item in raw_group: - if isinstance(item, str): - # packaging.requirements.Requirement parsing ensures that this is a - # valid PEP 508 Dependency Specifier - # raises InvalidRequirement on failure - elements.append(Requirement(item)) - elif isinstance(item, dict): - if tuple(item.keys()) != ("include-group",): - raise ValueError(f"Invalid dependency group item: {item}") - - include_group = next(iter(item.values())) - elements.append(DependencyGroupInclude(include_group=include_group)) - else: - raise ValueError(f"Invalid dependency group item: {item}") - - self._parsed_groups[group] = tuple(elements) - return self._parsed_groups[group] - - def _resolve(self, group: str, requested_group: str) -> tuple[Requirement, ...]: - """ - This is a helper for cached resolution to strings. - - :param group: The name of the group to resolve. - :param requested_group: The group which was used in the original, user-facing - request. - """ - if group in self._resolve_cache: - return self._resolve_cache[group] - - parsed = self._parse_group(group) - - resolved_group = [] - for item in parsed: - if isinstance(item, Requirement): - resolved_group.append(item) - elif isinstance(item, DependencyGroupInclude): - include_group = _normalize_name(item.include_group) - if include_group in self._include_graph_ancestors.get(group, ()): - raise CyclicDependencyError( - requested_group, group, item.include_group - ) - self._include_graph_ancestors[include_group] = ( - *self._include_graph_ancestors.get(group, ()), - group, - ) - resolved_group.extend(self._resolve(include_group, requested_group)) - else: # unreachable - raise NotImplementedError( - f"Invalid dependency group item after parse: {item}" - ) - - self._resolve_cache[group] = tuple(resolved_group) - return self._resolve_cache[group] - - -def resolve( - dependency_groups: Mapping[str, str | Mapping[str, str]], /, *groups: str -) -> tuple[str, ...]: - """ - Resolve a dependency group to a tuple of requirements, as strings. - - :param dependency_groups: the parsed contents of the ``[dependency-groups]`` table - from ``pyproject.toml`` - :param groups: the name of the group(s) to resolve - - :raises TypeError: if the inputs appear to be the wrong types - :raises ValueError: if the data does not appear to be valid dependency group data - :raises LookupError: if group name is absent - :raises packaging.requirements.InvalidRequirement: if a specifier is not valid - """ - resolver = DependencyGroupResolver(dependency_groups) - return tuple(str(r) for group in groups for r in resolver.resolve(group)) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_lint_dependency_groups.py b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_lint_dependency_groups.py deleted file mode 100644 index 09454bd..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_lint_dependency_groups.py +++ /dev/null @@ -1,59 +0,0 @@ -from __future__ import annotations - -import argparse -import sys - -from ._implementation import DependencyGroupResolver -from ._toml_compat import tomllib - - -def main(*, argv: list[str] | None = None) -> None: - if tomllib is None: - print( - "Usage error: dependency-groups CLI requires tomli or Python 3.11+", - file=sys.stderr, - ) - raise SystemExit(2) - - parser = argparse.ArgumentParser( - description=( - "Lint Dependency Groups for validity. " - "This will eagerly load and check all of your Dependency Groups." - ) - ) - parser.add_argument( - "-f", - "--pyproject-file", - default="pyproject.toml", - help="The pyproject.toml file. Defaults to trying in the current directory.", - ) - args = parser.parse_args(argv if argv is not None else sys.argv[1:]) - - with open(args.pyproject_file, "rb") as fp: - pyproject = tomllib.load(fp) - dependency_groups_raw = pyproject.get("dependency-groups", {}) - - errors: list[str] = [] - try: - resolver = DependencyGroupResolver(dependency_groups_raw) - except (ValueError, TypeError) as e: - errors.append(f"{type(e).__name__}: {e}") - else: - for groupname in resolver.dependency_groups: - try: - resolver.resolve(groupname) - except (LookupError, ValueError, TypeError) as e: - errors.append(f"{type(e).__name__}: {e}") - - if errors: - print("errors encountered while examining dependency groups:") - for msg in errors: - print(f" {msg}") - sys.exit(1) - else: - print("ok") - sys.exit(0) - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_pip_wrapper.py b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_pip_wrapper.py deleted file mode 100644 index f86d896..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_pip_wrapper.py +++ /dev/null @@ -1,62 +0,0 @@ -from __future__ import annotations - -import argparse -import subprocess -import sys - -from ._implementation import DependencyGroupResolver -from ._toml_compat import tomllib - - -def _invoke_pip(deps: list[str]) -> None: - subprocess.check_call([sys.executable, "-m", "pip", "install", *deps]) - - -def main(*, argv: list[str] | None = None) -> None: - if tomllib is None: - print( - "Usage error: dependency-groups CLI requires tomli or Python 3.11+", - file=sys.stderr, - ) - raise SystemExit(2) - - parser = argparse.ArgumentParser(description="Install Dependency Groups.") - parser.add_argument( - "DEPENDENCY_GROUP", nargs="+", help="The dependency groups to install." - ) - parser.add_argument( - "-f", - "--pyproject-file", - default="pyproject.toml", - help="The pyproject.toml file. Defaults to trying in the current directory.", - ) - args = parser.parse_args(argv if argv is not None else sys.argv[1:]) - - with open(args.pyproject_file, "rb") as fp: - pyproject = tomllib.load(fp) - dependency_groups_raw = pyproject.get("dependency-groups", {}) - - errors: list[str] = [] - resolved: list[str] = [] - try: - resolver = DependencyGroupResolver(dependency_groups_raw) - except (ValueError, TypeError) as e: - errors.append(f"{type(e).__name__}: {e}") - else: - for groupname in args.DEPENDENCY_GROUP: - try: - resolved.extend(str(r) for r in resolver.resolve(groupname)) - except (LookupError, ValueError, TypeError) as e: - errors.append(f"{type(e).__name__}: {e}") - - if errors: - print("errors encountered while examining dependency groups:") - for msg in errors: - print(f" {msg}") - sys.exit(1) - - _invoke_pip(resolved) - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_toml_compat.py b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_toml_compat.py deleted file mode 100644 index 8d6f921..0000000 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/_toml_compat.py +++ /dev/null @@ -1,9 +0,0 @@ -try: - import tomllib -except ImportError: - try: - from pip._vendor import tomli as tomllib # type: ignore[no-redef, unused-ignore] - except ModuleNotFoundError: # pragma: no cover - tomllib = None # type: ignore[assignment, unused-ignore] - -__all__ = ("tomllib",) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/py.typed b/.venv/lib/python3.14/site-packages/pip/_vendor/dependency_groups/py.typed deleted file mode 100644 index e69de29..0000000 diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/__init__.py index 4e82943..20fb539 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/__init__.py @@ -1,12 +1,12 @@ # -*- coding: utf-8 -*- # -# Copyright (C) 2012-2024 Vinay Sajip. +# Copyright (C) 2012-2026 Vinay Sajip. # Licensed to the Python Software Foundation under a contributor agreement. # See LICENSE.txt and CONTRIBUTORS.txt. # import logging -__version__ = '0.4.0' +__version__ = '0.4.4' class DistlibException(Exception): diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/compat.py b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/compat.py index ca561dd..5776838 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/compat.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/compat.py @@ -1,6 +1,6 @@ # -*- coding: utf-8 -*- # -# Copyright (C) 2013-2017 Vinay Sajip. +# Copyright (C) 2013-2026 Vinay Sajip. # Licensed to the Python Software Foundation under a contributor agreement. # See LICENSE.txt and CONTRIBUTORS.txt. # @@ -24,8 +24,8 @@ if sys.version_info[0] < 3: # pragma: no cover import __builtin__ as builtins import ConfigParser as configparser from urlparse import urlparse, urlunparse, urljoin, urlsplit, urlunsplit - from urllib import (urlretrieve, quote as _quote, unquote, url2pathname, - pathname2url, ContentTooShortError, splittype) + from urllib import (urlretrieve, quote as _quote, unquote, url2pathname, pathname2url, ContentTooShortError, + splittype) def quote(s): if isinstance(s, unicode): @@ -33,8 +33,7 @@ if sys.version_info[0] < 3: # pragma: no cover return _quote(s) import urllib2 - from urllib2 import (Request, urlopen, URLError, HTTPError, - HTTPBasicAuthHandler, HTTPPasswordMgr, HTTPHandler, + from urllib2 import (Request, urlopen, URLError, HTTPError, HTTPBasicAuthHandler, HTTPPasswordMgr, HTTPHandler, HTTPRedirectHandler, build_opener) if ssl: from urllib2 import HTTPSHandler @@ -67,12 +66,9 @@ else: # pragma: no cover from io import TextIOWrapper as file_type import builtins import configparser - from urllib.parse import (urlparse, urlunparse, urljoin, quote, unquote, - urlsplit, urlunsplit, splittype) - from urllib.request import (urlopen, urlretrieve, Request, url2pathname, - pathname2url, HTTPBasicAuthHandler, - HTTPPasswordMgr, HTTPHandler, - HTTPRedirectHandler, build_opener) + from urllib.parse import (urlparse, urlunparse, urljoin, quote, unquote, urlsplit, urlunsplit, splittype) + from urllib.request import (urlopen, urlretrieve, Request, url2pathname, pathname2url, HTTPBasicAuthHandler, + HTTPPasswordMgr, HTTPHandler, HTTPRedirectHandler, build_opener) if ssl: from urllib.request import HTTPSHandler from urllib.error import HTTPError, URLError, ContentTooShortError @@ -111,8 +107,7 @@ except ImportError: # pragma: no cover # than one wildcard per fragment. A survey of established # policy among SSL implementations showed it to be a # reasonable choice. - raise CertificateError( - "too many wildcards in certificate DNS name: " + repr(dn)) + raise CertificateError('Too many wildcards in certificate DNS name: %r' % dn) # speed up common case w/o wildcards if not wildcards: @@ -174,12 +169,10 @@ except ImportError: # pragma: no cover dnsnames.append(value) if len(dnsnames) > 1: raise CertificateError("hostname %r " - "doesn't match either of %s" % - (hostname, ', '.join(map(repr, dnsnames)))) + "doesn't match either of %s" % (hostname, ', '.join(map(repr, dnsnames)))) elif len(dnsnames) == 1: raise CertificateError("hostname %r " - "doesn't match %r" % - (hostname, dnsnames[0])) + "doesn't match %r" % (hostname, dnsnames[0])) else: raise CertificateError("no appropriate commonName or " "subjectAltName fields were found") @@ -348,8 +341,7 @@ except AttributeError: # pragma: no cover elif isinstance(filename, text_type): return filename.encode(_fsencoding, _fserrors) else: - raise TypeError("expect bytes or str, not %s" % - type(filename).__name__) + raise TypeError("expect bytes or str, not %s" % type(filename).__name__) def fsdecode(filename): if isinstance(filename, text_type): @@ -357,8 +349,7 @@ except AttributeError: # pragma: no cover elif isinstance(filename, bytes): return filename.decode(_fsencoding, _fserrors) else: - raise TypeError("expect bytes or str, not %s" % - type(filename).__name__) + raise TypeError("expect bytes or str, not %s" % type(filename).__name__) try: @@ -433,18 +424,16 @@ except ImportError: # pragma: no cover if filename is None: msg = "unknown encoding: " + encoding else: - msg = "unknown encoding for {!r}: {}".format( - filename, encoding) + msg = "unknown encoding for {!r}: {}".format(filename, encoding) raise SyntaxError(msg) if bom_found: if codec.name != 'utf-8': # This behaviour mimics the Python interpreter if filename is None: - msg = 'encoding problem: utf-8' + msg = 'Encoding problem: utf-8' else: - msg = 'encoding problem for {!r}: utf-8'.format( - filename) + msg = 'Encoding problem for %r: utf-8' % filename raise SyntaxError(msg) encoding += '-sig' return encoding @@ -482,15 +471,40 @@ if sys.version_info[:2] < (3, 4): else: from html import unescape +_get_ident = None + + +def _thread_get_ident(): + global _get_ident + if _get_ident is None: + try: + # Python 2 + from thread import get_ident as _get_ident + except ImportError: + try: + from dummy_thread import get_ident as _get_ident + except ImportError: + # Python >= 3 + try: + from _thread import get_ident as _get_ident + except ImportError: + from _dummy_thread import get_ident as _get_ident + return _get_ident + + try: + # Python >= 3.3 from collections import ChainMap except ImportError: # pragma: no cover from collections import MutableMapping try: + # Python >= 3.2 from reprlib import recursive_repr as _recursive_repr except ImportError: + _get_ident = _thread_get_ident() + def _recursive_repr(fillvalue='...'): ''' Decorator to make a repr function return fillvalue for a recursive @@ -501,7 +515,7 @@ except ImportError: # pragma: no cover repr_running = set() def wrapper(self): - key = id(self), get_ident() + key = id(self), _get_ident() if key in repr_running: return fillvalue repr_running.add(key) @@ -515,8 +529,7 @@ except ImportError: # pragma: no cover wrapper.__module__ = getattr(user_function, '__module__') wrapper.__doc__ = getattr(user_function, '__doc__') wrapper.__name__ = getattr(user_function, '__name__') - wrapper.__annotations__ = getattr(user_function, - '__annotations__', {}) + wrapper.__annotations__ = getattr(user_function, '__annotations__', {}) return wrapper return decorating_function @@ -547,19 +560,16 @@ except ImportError: # pragma: no cover def __getitem__(self, key): for mapping in self.maps: try: - return mapping[ - key] # can't use 'key in mapping' with defaultdict + return mapping[key] # can't use 'key in mapping' with defaultdict except KeyError: pass - return self.__missing__( - key) # support subclasses that define __missing__ + return self.__missing__(key) # support subclasses that define __missing__ def get(self, key, default=None): return self[key] if key in self else default def __len__(self): - return len(set().union( - *self.maps)) # reuses stored hash values if possible + return len(set().union(*self.maps)) # reuses stored hash values if possible def __iter__(self): return iter(set().union(*self.maps)) @@ -572,8 +582,7 @@ except ImportError: # pragma: no cover @_recursive_repr() def __repr__(self): - return '{0.__class__.__name__}({1})'.format( - self, ', '.join(map(repr, self.maps))) + return '{0.__class__.__name__}({1})'.format(self, ', '.join(map(repr, self.maps))) @classmethod def fromkeys(cls, iterable, *args): @@ -602,8 +611,7 @@ except ImportError: # pragma: no cover try: del self.maps[0][key] except KeyError: - raise KeyError( - 'Key not found in the first mapping: {!r}'.format(key)) + raise KeyError('Key not found in the first mapping: {!r}'.format(key)) def popitem(self): 'Remove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.' @@ -617,8 +625,7 @@ except ImportError: # pragma: no cover try: return self.maps[0].pop(key, *args) except KeyError: - raise KeyError( - 'Key not found in the first mapping: {!r}'.format(key)) + raise KeyError('Key not found in the first mapping: {!r}'.format(key)) def clear(self): 'Clear maps[0], leaving maps[1:] intact.' @@ -629,7 +636,7 @@ try: from importlib.util import cache_from_source # Python >= 3.4 except ImportError: # pragma: no cover - def cache_from_source(path, debug_override=None): + def cache_from_source(path, debug_override=None, optimization=None): assert path.endswith('.py') if debug_override is None: debug_override = __debug__ @@ -641,15 +648,13 @@ except ImportError: # pragma: no cover try: + # Python >= 3.1 from collections import OrderedDict except ImportError: # pragma: no cover # {{{ http://code.activestate.com/recipes/576693/ (r9) # Backport of OrderedDict() class that runs on Python 2.4, 2.5, 2.6, 2.7 and pypy. # Passes Python2.7's test suite and incorporates all the latest updates. - try: - from thread import get_ident as _get_ident - except ImportError: - from dummy_thread import get_ident as _get_ident + _get_ident = _thread_get_ident() try: from _abcoll import KeysView, ValuesView, ItemsView @@ -676,8 +681,7 @@ except ImportError: # pragma: no cover ''' if len(args) > 1: - raise TypeError('expected at most 1 arguments, got %d' % - len(args)) + raise TypeError('expected at most 1 arguments, got %d' % len(args)) try: self.__root except AttributeError: @@ -885,8 +889,7 @@ except ImportError: # pragma: no cover ''' if isinstance(other, OrderedDict): - return len(self) == len( - other) and self.items() == other.items() + return len(self) == len(other) and self.items() == other.items() return dict.__eq__(self, other) def __ne__(self, other): @@ -936,8 +939,7 @@ except ImportError: # pragma: no cover # If the converted value is different, save for next time if value is not result: self[key] = result - if type(result) in (ConvertingDict, ConvertingList, - ConvertingTuple): + if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple): result.parent = self result.key = key return result @@ -948,8 +950,7 @@ except ImportError: # pragma: no cover # If the converted value is different, save for next time if value is not result: self[key] = result - if type(result) in (ConvertingDict, ConvertingList, - ConvertingTuple): + if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple): result.parent = self result.key = key return result @@ -958,8 +959,7 @@ except ImportError: # pragma: no cover value = dict.pop(self, key, default) result = self.configurator.convert(value) if value is not result: - if type(result) in (ConvertingDict, ConvertingList, - ConvertingTuple): + if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple): result.parent = self result.key = key return result @@ -973,8 +973,7 @@ except ImportError: # pragma: no cover # If the converted value is different, save for next time if value is not result: self[key] = result - if type(result) in (ConvertingDict, ConvertingList, - ConvertingTuple): + if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple): result.parent = self result.key = key return result @@ -983,8 +982,7 @@ except ImportError: # pragma: no cover value = list.pop(self, idx) result = self.configurator.convert(value) if value is not result: - if type(result) in (ConvertingDict, ConvertingList, - ConvertingTuple): + if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple): result.parent = self return result @@ -995,8 +993,7 @@ except ImportError: # pragma: no cover value = tuple.__getitem__(self, key) result = self.configurator.convert(value) if value is not result: - if type(result) in (ConvertingDict, ConvertingList, - ConvertingTuple): + if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple): result.parent = self result.key = key return result @@ -1073,9 +1070,7 @@ except ImportError: # pragma: no cover d = d[idx] else: try: - n = int( - idx - ) # try as number first (most likely) + n = int(idx) # try as number first (most likely) d = d[n] except TypeError: d = d[idx] @@ -1093,12 +1088,10 @@ except ImportError: # pragma: no cover replaced by their converting alternatives. Strings are checked to see if they have a conversion format and are converted if they do. """ - if not isinstance(value, ConvertingDict) and isinstance( - value, dict): + if not isinstance(value, ConvertingDict) and isinstance(value, dict): value = ConvertingDict(value) value.configurator = self - elif not isinstance(value, ConvertingList) and isinstance( - value, list): + elif not isinstance(value, ConvertingList) and isinstance(value, list): value = ConvertingList(value) value.configurator = self elif not isinstance(value, ConvertingTuple) and isinstance(value, tuple): diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/resources.py b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/resources.py index fef52aa..e6b0155 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/resources.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/resources.py @@ -1,6 +1,6 @@ # -*- coding: utf-8 -*- # -# Copyright (C) 2013-2017 Vinay Sajip. +# Copyright (C) 2013-2026 Vinay Sajip. # Licensed to the Python Software Foundation under a contributor agreement. # See LICENSE.txt and CONTRIBUTORS.txt. # @@ -20,11 +20,11 @@ from .util import cached_property, get_cache_base, Cache logger = logging.getLogger(__name__) - -cache = None # created when needed +cache = None # created when needed class ResourceCache(Cache): + def __init__(self, base=None): if base is None: # Use native string to avoid issues on 2.x: see Python #20140. @@ -69,6 +69,7 @@ class ResourceCache(Cache): class ResourceBase(object): + def __init__(self, finder, name): self.finder = finder self.name = name @@ -80,7 +81,7 @@ class Resource(ResourceBase): not normally instantiated by user code, but rather by a :class:`ResourceFinder` which manages the resource. """ - is_container = False # Backwards compatibility + is_container = False # Backwards compatibility def as_stream(self): """ @@ -108,7 +109,7 @@ class Resource(ResourceBase): class ResourceContainer(ResourceBase): - is_container = True # Backwards compatibility + is_container = True # Backwards compatibility @cached_property def resources(self): @@ -133,17 +134,33 @@ class ResourceFinder(object): def _adjust_path(self, path): return os.path.realpath(path) + def _is_in_base(self, path): + base = self._adjust_path(self.base) + if path == base: + return True + if not base.endswith(os.sep): + base = base + os.sep + return path.startswith(base) + def _make_path(self, resource_name): # Issue #50: need to preserve type of path on Python 2.x # like os.path._get_sep - if isinstance(resource_name, bytes): # should only happen on 2.x + if isinstance(resource_name, bytes): # should only happen on 2.x sep = b'/' else: sep = '/' parts = resource_name.split(sep) parts.insert(0, self.base) result = os.path.join(*parts) - return self._adjust_path(result) + result = self._adjust_path(result) + # See issue 263: code below commented out as it proved to be + # too aggressively cautious, causing problems in valid use case scenarios. + # Confine the resolved resource to the package base so a resource + # name containing '..' cannot read files outside the package. + # if not self._is_in_base(result): + # raise DistlibException('Resource name escapes package: ' + # '%r' % resource_name) + return result def _find(self, path): return os.path.exists(path) @@ -174,9 +191,10 @@ class ResourceFinder(object): return os.path.getsize(resource.path) def get_resources(self, resource): + def allowed(f): - return (f != '__pycache__' and not - f.endswith(self.skipped_extensions)) + return (f != '__pycache__' and not f.endswith(self.skipped_extensions)) + return set([f for f in os.listdir(resource.path) if allowed(f)]) def is_container(self, resource): @@ -209,6 +227,7 @@ class ZipResourceFinder(ResourceFinder): """ Resource finder for resources in .zip files. """ + def __init__(self, module): super(ZipResourceFinder, self).__init__(module) archive = self.loader.archive @@ -267,7 +286,7 @@ class ZipResourceFinder(ResourceFinder): if not self.index[i].startswith(path): break s = self.index[i][plen:] - result.add(s.split(os.sep, 1)[0]) # only immediate children + result.add(s.split(os.sep, 1)[0]) # only immediate children i += 1 return result @@ -283,10 +302,7 @@ class ZipResourceFinder(ResourceFinder): return result -_finder_registry = { - type(None): ResourceFinder, - zipimport.zipimporter: ZipResourceFinder -} +_finder_registry = {type(None): ResourceFinder, zipimport.zipimporter: ZipResourceFinder} try: # In Python 3.6, _frozen_importlib -> _frozen_importlib_external diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/scripts.py b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/scripts.py index 195dc3f..0338012 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/scripts.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/scripts.py @@ -1,6 +1,6 @@ # -*- coding: utf-8 -*- # -# Copyright (C) 2013-2023 Vinay Sajip. +# Copyright (C) 2013-2026 Vinay Sajip. # Licensed to the Python Software Foundation under a contributor agreement. # See LICENSE.txt and CONTRIBUTORS.txt. # @@ -13,9 +13,11 @@ import sys import time from zipfile import ZipInfo +from . import DistlibException from .compat import sysconfig, detect_encoding, ZipFile from .resources import finder -from .util import (FileOperator, get_export_entry, convert_path, get_executable, get_platform, in_venv) +from .util import (FileOperator, get_export_entry, convert_path, get_executable, get_platform, in_venv, + is_in_directory) logger = logging.getLogger(__name__) @@ -118,19 +120,19 @@ class ScriptMaker(object): executable = os.path.join(dn, fn) return executable - if sys.platform.startswith('java'): # pragma: no cover + def _is_shell(self, executable): + """ + Determine if the specified executable is a script + (contains a #! line) + """ + try: + with open(executable, 'rb') as fp: + return fp.read(2) == b'#!' + except (OSError, IOError): + logger.warning('Failed to open %s', executable) + return False - def _is_shell(self, executable): - """ - Determine if the specified executable is a script - (contains a #! line) - """ - try: - with open(executable) as fp: - return fp.read(2) == '#!' - except (OSError, IOError): - logger.warning('Failed to open %s', executable) - return False + if sys.platform.startswith('java'): # pragma: no cover def _fix_jython_executable(self, executable): if self._is_shell(executable): @@ -170,7 +172,9 @@ class ScriptMaker(object): max_shebang_length = 512 else: max_shebang_length = 127 - simple_shebang = ((b' ' not in executable) and (shebang_length <= max_shebang_length)) + simple_shebang = ((b' ' not in executable) and + (shebang_length <= max_shebang_length) and + not self._is_shell(executable.decode('utf-8'))) if simple_shebang: result = b'#!' + executable + post_interp + b'\n' @@ -277,7 +281,9 @@ class ScriptMaker(object): zip_data = stream.getvalue() script_bytes = launcher + shebang + zip_data for name in names: - outname = os.path.join(self.target_dir, name) + outname = os.path.abspath(os.path.join(self.target_dir, name)) + if not is_in_directory(outname, self.target_dir): + raise DistlibException('Attempt to escape script directory') if use_launcher: # pragma: no cover n, e = os.path.splitext(outname) if e.startswith('.py'): @@ -286,6 +292,10 @@ class ScriptMaker(object): try: self._fileop.write_binary_file(outname, script_bytes) except Exception: + if not os.path.exists(outname): + # Nothing to move aside, so the original error + # (e.g. no write permission) is the real one. + raise # Failed writing an executable - it might be in use. logger.warning('Failed to write executable - trying to ' 'use .deleteme logic') diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/util.py b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/util.py index 0d5bd7a..62dd346 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/util.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/distlib/util.py @@ -1,5 +1,5 @@ # -# Copyright (C) 2012-2023 The Python Software Foundation. +# Copyright (C) 2012-2026 The Python Software Foundation. # See LICENSE.txt and CONTRIBUTORS.txt. # import codecs @@ -589,7 +589,11 @@ class FileOperator(object): self.dirs_created.add(path) def byte_compile(self, path, optimize=False, force=False, prefix=None, hashed_invalidation=False): - dpath = cache_from_source(path, not optimize) + if not optimize: + optimization = '' + else: + optimization = '1' + dpath = cache_from_source(path, optimization=optimization) logger.info('Byte-compiling %s to %s', path, dpath) if not self.dry_run: if force or self.newer(path, dpath): @@ -703,8 +707,8 @@ class ExportEntry(object): if not isinstance(other, ExportEntry): result = False else: - result = (self.name == other.name and self.prefix == other.prefix and self.suffix == other.suffix and - self.flags == other.flags) + result = (self.name == other.name and self.prefix == other.prefix and self.suffix == other.suffix + and self.flags == other.flags) return result __hash__ = object.__hash__ @@ -716,9 +720,35 @@ ENTRY_RE = re.compile( \s*(\[\s*(?P[\w-]+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])? ''', re.VERBOSE) +# ENTRY_RE, but only starting at the first or last character of a whitespace +# run. See _search_export_entry. +_ENTRY_RE_AT_SPACE = re.compile(r'(?:(? Tuple[bytes, int]: + """Stateless IDNA 2008 codec. + + Implements the :class:`codecs.Codec` protocol so that the whole-domain + encoder (:func:`idna.encode`) and decoder (:func:`idna.decode`) are + accessible through the standard codec machinery as ``"idna2008"``. + + Only the ``"strict"`` error handler is supported; any other handler + raises :exc:`~idna.IDNAError`. + """ + + def encode(self, data: str, errors: str = "strict") -> tuple[bytes, int]: # ty: ignore[invalid-method-override] if errors != "strict": - raise IDNAError('Unsupported error handling "{}"'.format(errors)) + raise IDNAError(f'Unsupported error handling "{errors}"', code="unsupported_errors") if not data: return b"", 0 return encode(data), len(data) - def decode(self, data: bytes, errors: str = "strict") -> Tuple[str, int]: + def decode(self, data: bytes, errors: str = "strict") -> tuple[str, int]: # ty: ignore[invalid-method-override] if errors != "strict": - raise IDNAError('Unsupported error handling "{}"'.format(errors)) + raise IDNAError(f'Unsupported error handling "{errors}"', code="unsupported_errors") if not data: return "", 0 @@ -28,49 +37,132 @@ class Codec(codecs.Codec): class IncrementalEncoder(codecs.BufferedIncrementalEncoder): - def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[bytes, int]: + """Incremental IDNA 2008 encoder. + + Buffers a partial trailing label across calls until either the next + label separator is seen or ``final=True``, so that streamed input is + encoded one whole label at a time. Any of the four Unicode label + separators (``U+002E``, ``U+3002``, ``U+FF0E``, ``U+FF61``) ends a + label; the result always uses ``U+002E`` as the separator. + + The 253-octet domain length limit (254 with a trailing dot) that + :func:`idna.encode` enforces is applied to the accumulated output, so + that streaming a name and encoding it in one shot either both succeed + with the same result or both raise :exc:`~idna.IDNAError`. + + Only the ``"strict"`` error handler is supported. + """ + + def __init__(self, errors: str = "strict") -> None: + super().__init__(errors) + self._emitted = 0 # octets returned so far + self._trailing_dot = False # whether the output so far ends with "." + + def reset(self) -> None: + super().reset() + self._emitted = 0 + self._trailing_dot = False + + def getstate(self) -> Any: + if not self.buffer and not self._emitted: + return 0 + return (self.buffer, self._emitted, self._trailing_dot) + + def setstate(self, state: Any) -> None: + if state: + self.buffer, self._emitted, self._trailing_dot = state + else: + self.reset() + + def _buffer_encode(self, data: str, errors: str, final: bool) -> tuple[bytes, int]: # ty: ignore[invalid-method-override] if errors != "strict": - raise IDNAError('Unsupported error handling "{}"'.format(errors)) + raise IDNAError(f'Unsupported error handling "{errors}"', code="unsupported_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 = [] + result_bytes = b"" size = 0 - for label in labels: - result.append(alabel(label)) - if size: - size += 1 - size += len(label) + if data: + 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"." - # Join with U+002E - result_bytes = b".".join(result) + trailing_dot - size += len(trailing_dot) + result = [] + for label in labels: + result.append(alabel(label)) + if size: + size += 1 + size += len(label) + + result_bytes = b".".join(result) + trailing_dot + size += len(trailing_dot) + + # Mirror encode(): the whole name may not exceed 253 octets, or 254 + # when it ends with a dot. Until the input is final a trailing dot + # may still arrive, so only the 254-octet ceiling applies before then. + self._emitted += len(result_bytes) + if result_bytes: + self._trailing_dot = result_bytes.endswith(b".") + may_end_with_dot = self._trailing_dot or not final + if self._emitted > _max_domain_length + may_end_with_dot: + raise IDNAError("Domain too long", code="domain_too_long") return result_bytes, size class IncrementalDecoder(codecs.BufferedIncrementalDecoder): - def _buffer_decode(self, data: Any, errors: str, final: bool) -> Tuple[str, int]: + """Incremental IDNA 2008 decoder. + + Buffers a partial trailing label across calls until either the next + label separator is seen or ``final=True``, so that streamed input is + decoded one whole label at a time. + + The 254-octet input length limit that :func:`idna.decode` enforces is + applied to the accumulated input, so that streaming a name and decoding + it in one shot either both succeed with the same result or both raise + :exc:`~idna.IDNAError`. + + Only the ``"strict"`` error handler is supported. + """ + + def __init__(self, errors: str = "strict") -> None: + super().__init__(errors) + self._consumed = 0 # input octets consumed so far + + def reset(self) -> None: + super().reset() + self._consumed = 0 + + def getstate(self) -> tuple[bytes, int]: + return (self.buffer, self._consumed) + + def setstate(self, state: tuple[bytes, int]) -> None: + self.buffer, self._consumed = state + + def _buffer_decode(self, data: Any, errors: str, final: bool) -> tuple[str, int]: # ty: ignore[invalid-method-override] if errors != "strict": - raise IDNAError('Unsupported error handling "{}"'.format(errors)) + raise IDNAError(f'Unsupported error handling "{errors}"', code="unsupported_errors") if not data: return ("", 0) if not isinstance(data, str): - data = str(data, "ascii") + try: + data = str(data, "ascii") + except UnicodeDecodeError as err: + raise IDNAError("Invalid ASCII in A-label", code="invalid_ascii") from err + + # Mirror decode(), which rejects input longer than 254 characters + # (253 plus a possible trailing dot) before looking at any label. + # ``data`` is the unconsumed buffer plus the new input, so this is + # the total seen so far. + if self._consumed + len(data) > _max_domain_length + 1: + raise IDNAError("Domain too long", code="domain_too_long") labels = _unicode_dots_re.split(data) trailing_dot = "" @@ -94,6 +186,7 @@ class IncrementalDecoder(codecs.BufferedIncrementalDecoder): result_str = ".".join(result) + trailing_dot size += len(trailing_dot) + self._consumed += size return (result_str, size) @@ -105,7 +198,17 @@ class StreamReader(Codec, codecs.StreamReader): pass -def search_function(name: str) -> Optional[codecs.CodecInfo]: +def search_function(name: str) -> codecs.CodecInfo | None: + """Codec search function registered with :mod:`codecs`. + + Returns a :class:`codecs.CodecInfo` for the ``"idna2008"`` codec name + so that ``str.encode("idna2008")`` and ``bytes.decode("idna2008")`` + invoke the IDNA 2008 codec defined in this module. + + :param name: The codec name being looked up. + :returns: A :class:`codecs.CodecInfo` instance if ``name`` is + ``"idna2008"``, otherwise ``None``. + """ if name != "idna2008": return None return codecs.CodecInfo( diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/compat.py b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/compat.py index 1df9f2a..5bedee9 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/compat.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/compat.py @@ -1,15 +1,43 @@ -from typing import Any, Union +from __future__ import annotations + +from typing import Any from .core import decode, encode def ToASCII(label: str) -> bytes: + """Compatibility shim for :rfc:`3490` ``ToASCII``. + + Delegates to :func:`idna.encode` (IDNA 2008). Provided to ease porting + of code written against the legacy :mod:`encodings.idna` API; new code + should call :func:`idna.encode` directly. + + :param label: The label or domain to encode. + :returns: The encoded form as ASCII :class:`bytes`. + """ return encode(label) -def ToUnicode(label: Union[bytes, bytearray]) -> str: +def ToUnicode(label: bytes | bytearray) -> str: + """Compatibility shim for :rfc:`3490` ``ToUnicode``. + + Delegates to :func:`idna.decode` (IDNA 2008). Provided to ease porting + of code written against the legacy :mod:`encodings.idna` API; new code + should call :func:`idna.decode` directly. + + :param label: The label or domain to decode. + :returns: The decoded Unicode form. + """ return decode(label) def nameprep(s: Any) -> None: + """Stub for :rfc:`3491` Nameprep, which is not used by IDNA 2008. + + IDNA 2008 (:rfc:`5891`) replaces Nameprep with the per-codepoint + validity classes from :rfc:`5892`; this function exists only to + return a clear error if legacy code attempts to call it. + + :raises NotImplementedError: Always. + """ raise NotImplementedError("IDNA 2008 does not utilise nameprep protocol") diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/core.py b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/core.py index 8177bf7..d4a6f0e 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/core.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/core.py @@ -1,45 +1,128 @@ +from __future__ import annotations + import bisect import re import unicodedata -from typing import Optional, Union +import warnings +from typing import Literal from . import idnadata from .intranges import intranges_contain _virama_combining_class = 9 _alabel_prefix = b"xn--" +_max_input_length = 1024 +_max_domain_length = 253 # RFC 1035 octets, excluding any trailing dot +_STATUS_VALID, _STATUS_MAPPED, _STATUS_DEVIATION, _STATUS_IGNORED = b"VMDI" _unicode_dots_re = re.compile("[\u002e\u3002\uff0e\uff61]") +_std3_disallowed_re = re.compile("[\x00-\x2c\x2f\x3a-\x40A-Z\x5b-\x60\x7b-\x7f]") +_bidi_rtl_first = frozenset({"R", "AL"}) +_bidi_rtl_categories = frozenset({"R", "AL", "AN"}) +_bidi_rtl_allowed = frozenset({"R", "AL", "AN", "EN", "ES", "CS", "ET", "ON", "BN", "NSM"}) +_bidi_rtl_valid_ending = frozenset({"R", "AL", "EN", "AN"}) +_bidi_rtl_numeric = frozenset({"AN", "EN"}) +_bidi_ltr_allowed = frozenset({"L", "EN", "ES", "CS", "ET", "ON", "BN", "NSM"}) +_bidi_ltr_valid_ending = frozenset({"L", "EN"}) +_bidi_joiner_l_or_d = frozenset({"L", "D"}) +_bidi_joiner_r_or_d = frozenset({"R", "D"}) + + +def _joining_type(cp: int) -> str | None: + for jt, ranges in idnadata.joining_types.items(): + if intranges_contain(cp, ranges): + return jt + return None + + +# Machine-readable identifiers for the rule an :class:`IDNAError` reports. +# These strings are stable and documented; exception message wording is not. +_ErrorCode = Literal[ + "input_too_long", + "label_too_long", + "domain_too_long", + "empty_label", + "empty_domain", + "not_nfc", + "hyphen_3_4", + "hyphen_start_end", + "leading_combiner", + "disallowed_codepoint", + "contextj", + "contexto", + "unknown_codepoint", + "bidi_rule_1", + "bidi_rule_2", + "bidi_rule_3", + "bidi_rule_4", + "bidi_rule_5", + "bidi_rule_6", + "bidi_unknown_direction", + "invalid_alabel", + "non_canonical_alabel", + "invalid_ascii", + "invalid_utf8", + "uts46_disallowed", + "uts46_std3", + "unsupported_errors", +] class IDNAError(UnicodeError): - """Base exception for all IDNA-encoding related problems""" + """Base exception for all IDNA-encoding related problems. - pass + ``str(err)`` is a human-readable description of the failure. The + exception also carries machine-readable attributes so callers do not + need to parse the message: + + * ``code`` -- a short, stable identifier for the rule that failed, such + as ``"disallowed_codepoint"`` or ``"bidi_rule_2"``; the full list is + documented in the README. Message wording, by contrast, may change + between releases. + * ``text`` -- the label (or, for UTS #46 processing, the domain) that + was being validated; + * ``codepoint`` -- the offending codepoint, as an ``int``; + * ``position`` -- the 1-based index of the offending character within + ``text``, matching the position quoted in the message. + + Each is ``None`` when it does not apply. + """ + + code: str | None + text: str | None + codepoint: int | None + position: int | None + + def __init__( + self, + *args: object, + code: _ErrorCode | None = None, + text: str | None = None, + codepoint: int | None = None, + position: int | None = None, + ) -> None: + super().__init__(*args) + self.code = code + self.text = text + self.codepoint = codepoint + self.position = position 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") + if v == 0 and not unicodedata.name(chr(cp)): + raise ValueError("Unknown character in unicodedata") return v @@ -52,174 +135,294 @@ def _punycode(s: str) -> bytes: def _unot(s: int) -> str: - return "U+{:04X}".format(s) + return f"U+{s:04X}" -def valid_label_length(label: Union[bytes, str]) -> bool: - if len(label) > 63: - return False - return True +def valid_label_length(label: bytes | str) -> bool: + """Check that a label does not exceed the maximum permitted length. + + Per :rfc:`1035` (and :rfc:`5891` §4.2.4) a DNS label must not exceed + 63 octets. The argument may be either a :class:`str` (a U-label, where + length is measured in characters) or :class:`bytes` (an A-label, where + length is measured in octets). + + :param label: The label to check. + :returns: ``True`` if the label is within the length limit, otherwise + ``False``. + """ + return len(label) <= 63 -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 valid_string_length(domain: bytes | str, trailing_dot: bool) -> bool: + """Check that a full domain name does not exceed the maximum length. + + Per :rfc:`1035`, a domain name is limited to 253 octets when no trailing + dot is present, or 254 octets when one is included. + + :param domain: The full (possibly multi-label) domain name. + :param trailing_dot: ``True`` if ``domain`` includes a trailing ``.``. + :returns: ``True`` if the domain is within the length limit, otherwise + ``False``. + """ + return len(domain) <= _max_domain_length + trailing_dot def check_bidi(label: str, check_ltr: bool = False) -> bool: + """Validate the Bidi Rule from :rfc:`5893` for a single label. + + The Bidi Rule constrains how bidirectional characters (Hebrew, Arabic, + etc.) may appear within a label. By default the check is only applied + when the label contains at least one right-to-left character (Unicode + bidirectional categories ``R``, ``AL``, or ``AN``); set ``check_ltr`` + to ``True`` to apply it to LTR-only labels as well. + + :param label: The label to validate, as a Unicode string. + :param check_ltr: If ``True``, apply the rules even when the label + contains no RTL characters. + :returns: ``True`` if the label satisfies the Bidi Rule. + :raises IDNABidiError: If any of Bidi Rule conditions 1-6 are violated, + or if the directional category of a codepoint cannot be determined. + """ + if len(label) > _max_input_length: + raise IDNAError("Label too long", code="input_too_long") # 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"]: + raise IDNABidiError( + f"Unknown directionality in label {label!r} at position {idx}", + code="bidi_unknown_direction", + text=label, + codepoint=ord(cp), + position=idx, + ) + if direction in _bidi_rtl_categories: bidi_label = True if not bidi_label and not check_ltr: return True # Bidi rule 1 direction = unicodedata.bidirectional(label[0]) - if direction in ["R", "AL"]: + if direction in _bidi_rtl_first: rtl = True elif direction == "L": rtl = False else: - raise IDNABidiError("First codepoint in label {} must be directionality L, R or AL".format(repr(label))) + raise IDNABidiError( + f"First codepoint in label {label!r} must be directionality L, R or AL", + code="bidi_rule_1", + text=label, + codepoint=ord(label[0]), + position=1, + ) valid_ending = False - number_type: Optional[str] = None + ending_idx = 1 + number_type: str | None = 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)) + if direction not in _bidi_rtl_allowed: + raise IDNABidiError( + f"Invalid direction for codepoint at position {idx} in a right-to-left label", + code="bidi_rule_2", + text=label, + codepoint=ord(cp), + position=idx, + ) # Bidi rule 3 - if direction in ["R", "AL", "EN", "AN"]: + if direction in _bidi_rtl_valid_ending: valid_ending = True + ending_idx = idx elif direction != "NSM": valid_ending = False + ending_idx = idx # Bidi rule 4 - if direction in ["AN", "EN"]: + if direction in _bidi_rtl_numeric: 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") + elif number_type != direction: + raise IDNABidiError( + "Can not mix numeral types in a right-to-left label", + code="bidi_rule_4", + text=label, + codepoint=ord(cp), + position=idx, + ) 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)) + if direction not in _bidi_ltr_allowed: + raise IDNABidiError( + f"Invalid direction for codepoint at position {idx} in a left-to-right label", + code="bidi_rule_5", + text=label, + codepoint=ord(cp), + position=idx, + ) # Bidi rule 6 - if direction in ["L", "EN"]: + if direction in _bidi_ltr_valid_ending: valid_ending = True + ending_idx = idx elif direction != "NSM": valid_ending = False + ending_idx = idx if not valid_ending: - raise IDNABidiError("Label ends with illegal codepoint directionality") + # Rules 3 and 6 concern the last character that is not a + # non-spacing mark, which is what ``ending_idx`` tracks. + raise IDNABidiError( + "Label ends with illegal codepoint directionality", + code="bidi_rule_3" if rtl else "bidi_rule_6", + text=label, + codepoint=ord(label[ending_idx - 1]), + position=ending_idx, + ) 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") + """Reject labels that begin with a combining mark. + + Per :rfc:`5891` §4.2.3.2 a label must not start with a character of + Unicode general category ``M`` (Mark). + + :param label: The label to check. + :returns: ``True`` if the first character is not a combining mark. + :raises IDNAError: If the label begins with a combining character. + """ + if label and unicodedata.category(label[0])[0] == "M": + raise IDNAError( + "Label begins with an illegal combining character", + code="leading_combiner", + text=label, + codepoint=ord(label[0]), + position=1, + ) return True def check_hyphen_ok(label: str) -> bool: + """Validate the hyphen restrictions for a label. + + Per :rfc:`5891` §4.2.3.1 a label must not start or end with a hyphen + (``U+002D``), and must not have hyphens in both the third and fourth + positions (the prefix reserved for A-labels). + + :param label: The label to check. + :returns: ``True`` if the hyphen restrictions are satisfied. + :raises IDNAError: If any of the hyphen restrictions are violated. + """ 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") + raise IDNAError("Label has disallowed hyphens in 3rd and 4th position", code="hyphen_3_4") + if label.startswith("-") or label.endswith("-"): + raise IDNAError("Label must not start or end with a hyphen", code="hyphen_start_end") return True def check_nfc(label: str) -> None: + """Require that a label is in Unicode Normalization Form C. + + :param label: The label to check. + :raises IDNAError: If ``label`` differs from its NFC normalisation. + """ + if len(label) > _max_input_length: + raise IDNAError("Label too long", code="input_too_long") if unicodedata.normalize("NFC", label) != label: - raise IDNAError("Label must be in Normalization Form C") + raise IDNAError("Label must be in Normalization Form C", code="not_nfc") def valid_contextj(label: str, pos: int) -> bool: + """Validate the CONTEXTJ rules from :rfc:`5892` Appendix A. + + These rules govern the contextual use of the joiner codepoints + ``U+200C`` (ZERO WIDTH NON-JOINER, Appendix A.1) and ``U+200D`` + (ZERO WIDTH JOINER, Appendix A.2) within a label. + + :param label: The label containing the codepoint. + :param pos: Index of the joiner codepoint within ``label``. + :returns: ``True`` if the codepoint at ``pos`` satisfies its CONTEXTJ + rule, ``False`` otherwise (including when the codepoint at + ``pos`` is not a recognised joiner). + :raises ValueError: If an adjacent codepoint has no Unicode name when + determining its combining class. + :raises IDNAError: If ``label`` exceeds the defensive input length limit. + """ + if len(label) > _max_input_length: + raise IDNAError("Label too long", code="input_too_long") cp_value = ord(label[pos]) if cp_value == 0x200C: - if pos > 0: - if _combining_class(ord(label[pos - 1])) == _virama_combining_class: - return True + if pos > 0 and _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"): + joining_type = _joining_type(ord(label[i])) + if joining_type == "T": continue - elif joining_type in [ord("L"), ord("D")]: + if joining_type in _bidi_joiner_l_or_d: ok = True break - else: - break + 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"): + joining_type = _joining_type(ord(label[i])) + if joining_type == "T": continue - elif joining_type in [ord("R"), ord("D")]: + if joining_type in _bidi_joiner_r_or_d: ok = True break - else: - break + break return ok if cp_value == 0x200D: - if pos > 0: - if _combining_class(ord(label[pos - 1])) == _virama_combining_class: - return True - return False + return pos > 0 and _combining_class(ord(label[pos - 1])) == _virama_combining_class - else: - return False + return False def valid_contexto(label: str, pos: int, exception: bool = False) -> bool: + """Validate the CONTEXTO rules from :rfc:`5892` Appendix A. + + Covers the contextual rules for codepoints such as MIDDLE DOT + (``U+00B7``), Greek lower numeral sign, Hebrew punctuation, Katakana + middle dot, and the Arabic-Indic / Extended Arabic-Indic digit ranges. + + :param label: The label containing the codepoint. + :param pos: Index of the codepoint within ``label``. + :param exception: Reserved for forward compatibility; currently unused. + :returns: ``True`` if the codepoint at ``pos`` satisfies its CONTEXTO + rule, ``False`` otherwise (including when the codepoint is not a + recognised CONTEXTO codepoint). + :raises IDNAError: If ``label`` exceeds the defensive input length limit. + """ + if len(label) > _max_input_length: + raise IDNAError("Label too long", code="input_too_long") 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 + return 0 < pos < len(label) - 1 and ord(label[pos - 1]) == 0x006C and ord(label[pos + 1]) == 0x006C - elif cp_value == 0x0375: + if 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 cp_value in {0x05F3, 0x05F4}: if pos > 0: return _is_script(label[pos - 1], "Hebrew") return False - elif cp_value == 0x30FB: + if cp_value == 0x30FB: for cp in label: if cp == "\u30fb": continue @@ -227,26 +430,48 @@ def valid_contexto(label: str, pos: int, exception: bool = False) -> bool: return True return False - elif 0x660 <= cp_value <= 0x669: - for cp in label: - if 0x6F0 <= ord(cp) <= 0x06F9: - return False - return True + if 0x660 <= cp_value <= 0x669: + return not any(0x6F0 <= ord(cp) <= 0x06F9 for cp in label) - elif 0x6F0 <= cp_value <= 0x6F9: - for cp in label: - if 0x660 <= ord(cp) <= 0x0669: - return False - return True + if 0x6F0 <= cp_value <= 0x6F9: + return not any(0x660 <= ord(cp) <= 0x0669 for cp in label) return False -def check_label(label: Union[str, bytes, bytearray]) -> None: +def check_label(label: str | bytes | bytearray) -> None: + """Run the full set of IDNA 2008 validity checks on a single label. + + Applies, in order: NFC normalisation (:func:`check_nfc`), hyphen + restrictions (:func:`check_hyphen_ok`), the no-leading-combiner rule + (:func:`check_initial_combiner`), per-codepoint validity (PVALID, + CONTEXTJ, CONTEXTO classes from :rfc:`5892`), and the Bidi Rule + (:func:`check_bidi`). + + :param label: The label to validate. ``bytes`` or ``bytearray`` input + is decoded as UTF-8 first. + :raises IDNAError: If the label is empty or fails a structural rule. + :raises InvalidCodepoint: If the label contains a DISALLOWED or + UNASSIGNED codepoint. + :raises InvalidCodepointContext: If a CONTEXTJ or CONTEXTO codepoint + is not valid in its context. + :raises IDNABidiError: If the Bidi Rule is violated. + """ + if len(label) > _max_input_length: + raise IDNAError("Label too long", code="input_too_long") if isinstance(label, (bytes, bytearray)): - label = label.decode("utf-8") + try: + label = label.decode("utf-8") + except UnicodeDecodeError as err: + raise IDNAError("Invalid UTF-8 in label", code="invalid_utf8") from err if len(label) == 0: - raise IDNAError("Empty Label") + raise IDNAError("Empty Label", code="empty_label") + + # Check against the domain length rather than the label length to + # support some UTS #46 use cases, while still bounding the work done + # by the label contextual rules below. + if not valid_string_length(label, trailing_dot=True): + raise IDNAError("Label too long", code="label_too_long") check_nfc(label) check_hyphen_ok(label) @@ -256,51 +481,96 @@ def check_label(label: Union[str, bytes, bytearray]) -> None: cp_value = ord(cp) if intranges_contain(cp_value, idnadata.codepoint_classes["PVALID"]): continue - elif intranges_contain(cp_value, idnadata.codepoint_classes["CONTEXTJ"]): + if 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: + contextj_ok = valid_contextj(label, pos) + except ValueError as err: raise IDNAError( - "Unknown codepoint adjacent to joiner {} at position {} in {}".format( - _unot(cp_value), pos + 1, repr(label) - ) + f"Unknown codepoint adjacent to joiner {_unot(cp_value)} at position {pos + 1} in {label!r}", + code="unknown_codepoint", + text=label, + codepoint=cp_value, + position=pos + 1, + ) from err + if not contextj_ok: + raise InvalidCodepointContext( + f"Joiner {_unot(cp_value)} not allowed at position {pos + 1} in {label!r}", + code="contextj", + text=label, + codepoint=cp_value, + position=pos + 1, ) 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)) + f"Codepoint {_unot(cp_value)} not allowed at position {pos + 1} in {label!r}", + code="contexto", + text=label, + codepoint=cp_value, + position=pos + 1, ) else: raise InvalidCodepoint( - "Codepoint {} at position {} of {} not allowed".format(_unot(cp_value), pos + 1, repr(label)) + f"Codepoint {_unot(cp_value)} at position {pos + 1} of {label!r} not allowed", + code="disallowed_codepoint", + text=label, + codepoint=cp_value, + position=pos + 1, ) check_bidi(label) def alabel(label: str) -> bytes: + """Convert a single U-label into its A-label form. + + The result is the ASCII-Compatible Encoding (ACE) form per :rfc:`5891` + §4: the label is validated, Punycode-encoded, and prefixed with + ``xn--``. Pure ASCII labels that are already valid IDNA labels are + returned unchanged (as :class:`bytes`). + + :param label: The label to convert, as a Unicode string. + :returns: The A-label as ASCII-encoded :class:`bytes`. + :raises IDNAError: If the label is invalid or the resulting A-label + exceeds 63 octets. + """ + if len(label) > _max_input_length: + raise IDNAError("Label too long", code="input_too_long") 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 + else: + ulabel(label_bytes) + if not valid_label_length(label_bytes): + raise IDNAError("Label too long", code="label_too_long") + return label_bytes check_label(label) label_bytes = _alabel_prefix + _punycode(label) if not valid_label_length(label_bytes): - raise IDNAError("Label too long") + raise IDNAError("Label too long", code="label_too_long") return label_bytes -def ulabel(label: Union[str, bytes, bytearray]) -> str: +def ulabel(label: str | bytes | bytearray) -> str: + """Convert a single A-label into its U-label form. + + Performs the inverse of :func:`alabel`: an ``xn--``-prefixed label is + Punycode-decoded and validated, and is rejected unless it is the + canonical A-label for the decoded U-label (:rfc:`5891` §5.3). Labels + that are already Unicode (or plain ASCII without the ACE prefix) are + validated and returned as a Unicode string. + + :param label: The label to convert. ``bytes`` or ``bytearray`` input + is treated as ASCII. + :returns: The U-label as a Unicode string. + :raises IDNAError: If the label is malformed or fails validation. + """ + if len(label) > _max_input_length: + raise IDNAError("Label too long", code="input_too_long") if not isinstance(label, (bytes, bytearray)): try: label_bytes = label.encode("ascii") @@ -309,82 +579,206 @@ def ulabel(label: Union[str, bytes, bytearray]) -> str: return label else: label_bytes = bytes(label) + if not label_bytes.isascii(): + raise IDNAError("Invalid ASCII in A-label", code="invalid_ascii") 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") + raise IDNAError("Malformed A-label, no Punycode eligible content found", code="invalid_alabel") + if label_bytes.endswith(b"-"): + raise IDNAError("A-label must not end with a hyphen", code="invalid_alabel") else: check_label(label_bytes) return label_bytes.decode("ascii") try: label = label_bytes.decode("punycode") - except UnicodeError: - raise IDNAError("Invalid A-label") + except UnicodeError as err: + raise IDNAError("Invalid A-label", code="invalid_alabel") from err + # RFC 5891 §5.3: the label is rejected unless re-encoding the decoded + # form reproduces the (lowercased) input. This catches "fake A-labels" + # (RFC 5890 §2.3.2.1) such as ``xn---bbk``, a non-canonical Punycode + # spelling of ``xn--bbk`` that would otherwise decode to the same + # U-label and so display identically to a different wire-format name. + if _punycode(label) != label_bytes: + raise IDNAError("A-label is not the canonical Punycode encoding of its U-label", code="non_canonical_alabel") check_label(label) return label +def _check_std3(text: str, domain: str, offset: int) -> None: + """Raise if ``text``, a slice of ``domain`` starting at ``offset`` that + UTS #46 mapping left unchanged, contains an ASCII character disallowed + under ``UseSTD3ASCIIRules``.""" + match = _std3_disallowed_re.search(text) + if match: + codepoint = ord(match.group()) + position = offset + match.start() + 1 + raise InvalidCodepoint( + f"Codepoint {_unot(codepoint)} not allowed at position {position} in {domain!r}", + code="uts46_std3", + text=domain, + codepoint=codepoint, + position=position, + ) + + +def _warn_transitional() -> None: + warnings.warn( + "Transitional processing is deprecated in UTS #46 and has no effect. " + "The transitional argument will be removed in a future version.", + DeprecationWarning, + stacklevel=3, + ) + + 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 + """Apply the UTS #46 character mapping to a domain string. - output = "" + Implements the mapping table from `UTS #46 §4 + `_: each character is kept, + replaced, or rejected based on its status (``V``, ``M``, ``D``, + ``I``, ``X``). The result is returned in Normalisation Form C. + :param domain: The full domain name to remap. + :param std3_rules: If ``True``, apply UTS #46's ``UseSTD3ASCIIRules``: + after mapping, any ASCII character other than a lowercase letter, + digit, hyphen or the label separator ``.`` is rejected, whether it + appeared in the input or was produced by a mapping (e.g. U+FF01 + FULLWIDTH EXCLAMATION MARK maps to ``!``). If ``False``, such + characters are passed through. + :param transitional: Deprecated and ignored. UTS #46 deprecated + transitional processing in Unicode 15.1 and deviation (status + ``D``) codepoints are now always kept, so this has no effect + beyond emitting a :class:`DeprecationWarning`. It will be removed + in a future version. + :returns: The remapped domain, in Normalisation Form C. + :raises InvalidCodepoint: If the domain contains a disallowed + codepoint under the chosen rules. + :raises IDNAError: If ``domain`` exceeds the defensive input length limit. + """ + if transitional: + _warn_transitional() + if len(domain) > _max_input_length: + raise IDNAError("Domain too long", code="input_too_long") + if domain.isascii(): + # The only ASCII mapping in UTS #46 is upper- to lowercase, and + # ASCII is invariant under NFC, so lowercasing is the whole job. + result = domain.lower() + if std3_rules: + _check_std3(result, domain, 0) + return result + + from .uts46data import uts46_replacements, uts46_starts, uts46_statuses + + # ``start`` marks the run of unchanged input not yet copied; a run is + # only sliced out when a character must be replaced or dropped, so the + # common no-change case makes no copy. STD3 is checked per output piece + # to report a violation at its input position. + output: list[str] = [] + start = 0 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: + i = code_point if code_point < 256 else bisect.bisect_right(uts46_starts, code_point) - 1 + status = uts46_statuses[i] + # UTS #46 §4: V valid, D deviation (kept), M mapped, I ignored, + # anything else disallowed. + if status == _STATUS_VALID: + continue + if status == _STATUS_MAPPED: + replacement = uts46_replacements[i] + elif status == _STATUS_DEVIATION: + continue + elif status == _STATUS_IGNORED: + replacement = None + else: raise InvalidCodepoint( - "Codepoint {} not allowed at position {} in {}".format(_unot(code_point), pos + 1, repr(domain)) + f"Codepoint {_unot(code_point)} not allowed at position {pos + 1} in {domain!r}", + code="uts46_disallowed", + text=domain, + codepoint=code_point, + position=pos + 1, ) + if start < pos: + run = domain[start:pos] + if std3_rules: + _check_std3(run, domain, start) + output.append(run) + if replacement: + if std3_rules and _std3_disallowed_re.search(replacement): + raise InvalidCodepoint( + f"Codepoint {_unot(code_point)} not allowed at position {pos + 1} in {domain!r}", + code="uts46_std3", + text=domain, + codepoint=code_point, + position=pos + 1, + ) + output.append(replacement) + start = pos + 1 - return unicodedata.normalize("NFC", output) + if start == 0: + if std3_rules: + _check_std3(domain, domain, 0) + return unicodedata.normalize("NFC", domain) + tail = domain[start:] + if std3_rules: + _check_std3(tail, domain, start) + output.append(tail) + return unicodedata.normalize("NFC", "".join(output)) def encode( - s: Union[str, bytes, bytearray], + s: str | bytes | bytearray, strict: bool = False, uts46: bool = False, std3_rules: bool = False, transitional: bool = False, ) -> bytes: + """Encode a Unicode domain name into its ASCII (A-label) form. + + Splits the input on label separators (only ``U+002E`` if ``strict`` is + set; otherwise also IDEOGRAPHIC FULL STOP ``U+3002``, FULLWIDTH FULL + STOP ``U+FF0E``, and HALFWIDTH IDEOGRAPHIC FULL STOP ``U+FF61``), + encodes each label with :func:`alabel`, and rejoins them with ``.``. + Optionally pre-processes the input through :func:`uts46_remap`. + + :param s: The domain name to encode. + :param strict: If ``True``, only ``U+002E`` is recognised as a label + separator. + :param uts46: If ``True``, apply UTS #46 mapping before encoding. + :param std3_rules: Forwarded to :func:`uts46_remap` when ``uts46`` is + ``True``. + :param transitional: Deprecated and ignored (see :func:`uts46_remap`): + emits a :class:`DeprecationWarning` and will be removed in a + future version. + :returns: The encoded domain as ASCII :class:`bytes`. + :raises IDNAError: If the domain is empty, contains an invalid label, + or exceeds the maximum domain length. + """ + if transitional: + _warn_transitional() 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.") + except (UnicodeDecodeError, TypeError) as err: + raise IDNAError( + "should pass a unicode string to the function rather than a byte string.", code="invalid_ascii" + ) from err + if len(s) > _max_input_length: + raise IDNAError("Domain too long", code="input_too_long") if uts46: - s = uts46_remap(s, std3_rules, transitional) + s = uts46_remap(s, std3_rules) + + if not valid_string_length(s, trailing_dot=True): + raise IDNAError("Domain too long", code="domain_too_long") + trailing_dot = False result = [] - if strict: - labels = s.split(".") - else: - labels = _unicode_dots_re.split(s) + labels = s.split(".") if strict else _unicode_dots_re.split(s) if not labels or labels == [""]: - raise IDNAError("Empty domain") + raise IDNAError("Empty domain", code="empty_domain") if labels[-1] == "": del labels[-1] trailing_dot = True @@ -393,45 +787,77 @@ def encode( if s: result.append(s) else: - raise IDNAError("Empty label") + raise IDNAError("Empty label", code="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") + raise IDNAError("Domain too long", code="domain_too_long") return s def decode( - s: Union[str, bytes, bytearray], + s: str | bytes | bytearray, strict: bool = False, uts46: bool = False, std3_rules: bool = False, + display: bool = False, ) -> str: - try: - if not isinstance(s, str): + """Decode an A-label-encoded domain name back to Unicode. + + Splits the input on label separators (see :func:`encode` for the + rules), decodes each label with :func:`ulabel`, and rejoins them + with ``.``. Optionally pre-processes the input through + :func:`uts46_remap`. + + :param s: The domain name to decode. + :param strict: If ``True``, only ``U+002E`` is recognised as a label + separator. + :param uts46: If ``True``, apply UTS #46 mapping before decoding. + :param std3_rules: Forwarded to :func:`uts46_remap` when ``uts46`` is + ``True``. + :param display: If ``True``, any ``xn--`` label that fails IDNA + validation is passed through unchanged (lowercased) rather than + aborting the whole call. Intended for "decode for display" + consumers (e.g. URL libraries, HTTP clients) that want to show + the user the label as it appears on the wire when it cannot be + rendered as Unicode. Matches the per-label recovery prescribed + by UTS #46 §4 and the WHATWG URL "domain to Unicode" algorithm. + :returns: The decoded domain as a Unicode string. + :raises IDNAError: If the input is not valid ASCII, contains an + invalid label, or is empty. + """ + if not isinstance(s, str): + try: s = str(s, "ascii") - except UnicodeDecodeError: - raise IDNAError("Invalid ASCII in A-label") + except (UnicodeDecodeError, TypeError) as err: + raise IDNAError("Invalid ASCII in A-label", code="invalid_ascii") from err + if len(s) > _max_input_length: + raise IDNAError("Domain too long", code="input_too_long") if uts46: s = uts46_remap(s, std3_rules, False) + if not valid_string_length(s, trailing_dot=True): + raise IDNAError("Domain too long", code="domain_too_long") trailing_dot = False result = [] - if not strict: - labels = _unicode_dots_re.split(s) - else: - labels = s.split(".") + labels = s.split(".") if strict else _unicode_dots_re.split(s) if not labels or labels == [""]: - raise IDNAError("Empty domain") + raise IDNAError("Empty domain", code="empty_domain") if not labels[-1]: del labels[-1] trailing_dot = True for label in labels: - s = ulabel(label) - if s: - result.append(s) + try: + u = ulabel(label) + except IDNAError: + if display and label[:4].lower() == "xn--": + u = label.lower() + else: + raise + if u: + result.append(u) else: - raise IDNAError("Empty label") + raise IDNAError("Empty label", code="empty_label") if trailing_dot: result.append("") return ".".join(result) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/idnadata.py b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/idnadata.py index ded47ca..471c047 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/idnadata.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/idnadata.py @@ -1,6 +1,6 @@ # This file is automatically generated by tools/idna-data -__version__ = "16.0.0" +__version__ = "18.0.0" scripts = { "Greek": ( @@ -40,6 +40,7 @@ scripts = { 0x101400001018F, 0x101A0000101A1, 0x1D2000001D246, + 0x1DFF30001DFF5, ), "Han": ( 0x2E8000002E9A, @@ -54,19 +55,18 @@ scripts = { 0xF9000000FA6E, 0xFA700000FADA, 0x16FE200016FE4, - 0x16FF000016FF2, + 0x16FF000016FF7, 0x200000002A6E0, - 0x2A7000002B73A, - 0x2B7400002B81E, - 0x2B8200002CEA2, + 0x2A7000002B81F, + 0x2B8200002CEAE, 0x2CEB00002EBE1, 0x2EBF00002EE5E, 0x2F8000002FA1E, 0x300000003134B, - 0x31350000323B0, + 0x313500003347A, ), "Hebrew": ( - 0x591000005C8, + 0x591000005CA, 0x5D0000005EB, 0x5EF000005F5, 0xFB1D0000FB37, @@ -80,6 +80,7 @@ scripts = { 0x304100003097, 0x309D000030A0, 0x1B0010001B120, + 0x1B1230001B124, 0x1B1320001B133, 0x1B1500001B153, 0x1F2000001F201, @@ -97,2974 +98,560 @@ scripts = { 0x1AFFD0001AFFF, 0x1B0000001B001, 0x1B1200001B123, + 0x1B1240001B129, 0x1B1550001B156, - 0x1B1640001B168, + 0x1B1640001B169, ), } + + joining_types = { - 0xAD: 84, - 0x300: 84, - 0x301: 84, - 0x302: 84, - 0x303: 84, - 0x304: 84, - 0x305: 84, - 0x306: 84, - 0x307: 84, - 0x308: 84, - 0x309: 84, - 0x30A: 84, - 0x30B: 84, - 0x30C: 84, - 0x30D: 84, - 0x30E: 84, - 0x30F: 84, - 0x310: 84, - 0x311: 84, - 0x312: 84, - 0x313: 84, - 0x314: 84, - 0x315: 84, - 0x316: 84, - 0x317: 84, - 0x318: 84, - 0x319: 84, - 0x31A: 84, - 0x31B: 84, - 0x31C: 84, - 0x31D: 84, - 0x31E: 84, - 0x31F: 84, - 0x320: 84, - 0x321: 84, - 0x322: 84, - 0x323: 84, - 0x324: 84, - 0x325: 84, - 0x326: 84, - 0x327: 84, - 0x328: 84, - 0x329: 84, - 0x32A: 84, - 0x32B: 84, - 0x32C: 84, - 0x32D: 84, - 0x32E: 84, - 0x32F: 84, - 0x330: 84, - 0x331: 84, - 0x332: 84, - 0x333: 84, - 0x334: 84, - 0x335: 84, - 0x336: 84, - 0x337: 84, - 0x338: 84, - 0x339: 84, - 0x33A: 84, - 0x33B: 84, - 0x33C: 84, - 0x33D: 84, - 0x33E: 84, - 0x33F: 84, - 0x340: 84, - 0x341: 84, - 0x342: 84, - 0x343: 84, - 0x344: 84, - 0x345: 84, - 0x346: 84, - 0x347: 84, - 0x348: 84, - 0x349: 84, - 0x34A: 84, - 0x34B: 84, - 0x34C: 84, - 0x34D: 84, - 0x34E: 84, - 0x34F: 84, - 0x350: 84, - 0x351: 84, - 0x352: 84, - 0x353: 84, - 0x354: 84, - 0x355: 84, - 0x356: 84, - 0x357: 84, - 0x358: 84, - 0x359: 84, - 0x35A: 84, - 0x35B: 84, - 0x35C: 84, - 0x35D: 84, - 0x35E: 84, - 0x35F: 84, - 0x360: 84, - 0x361: 84, - 0x362: 84, - 0x363: 84, - 0x364: 84, - 0x365: 84, - 0x366: 84, - 0x367: 84, - 0x368: 84, - 0x369: 84, - 0x36A: 84, - 0x36B: 84, - 0x36C: 84, - 0x36D: 84, - 0x36E: 84, - 0x36F: 84, - 0x483: 84, - 0x484: 84, - 0x485: 84, - 0x486: 84, - 0x487: 84, - 0x488: 84, - 0x489: 84, - 0x591: 84, - 0x592: 84, - 0x593: 84, - 0x594: 84, - 0x595: 84, - 0x596: 84, - 0x597: 84, - 0x598: 84, - 0x599: 84, - 0x59A: 84, - 0x59B: 84, - 0x59C: 84, - 0x59D: 84, - 0x59E: 84, - 0x59F: 84, - 0x5A0: 84, - 0x5A1: 84, - 0x5A2: 84, - 0x5A3: 84, - 0x5A4: 84, - 0x5A5: 84, - 0x5A6: 84, - 0x5A7: 84, - 0x5A8: 84, - 0x5A9: 84, - 0x5AA: 84, - 0x5AB: 84, - 0x5AC: 84, - 0x5AD: 84, - 0x5AE: 84, - 0x5AF: 84, - 0x5B0: 84, - 0x5B1: 84, - 0x5B2: 84, - 0x5B3: 84, - 0x5B4: 84, - 0x5B5: 84, - 0x5B6: 84, - 0x5B7: 84, - 0x5B8: 84, - 0x5B9: 84, - 0x5BA: 84, - 0x5BB: 84, - 0x5BC: 84, - 0x5BD: 84, - 0x5BF: 84, - 0x5C1: 84, - 0x5C2: 84, - 0x5C4: 84, - 0x5C5: 84, - 0x5C7: 84, - 0x610: 84, - 0x611: 84, - 0x612: 84, - 0x613: 84, - 0x614: 84, - 0x615: 84, - 0x616: 84, - 0x617: 84, - 0x618: 84, - 0x619: 84, - 0x61A: 84, - 0x61C: 84, - 0x620: 68, - 0x622: 82, - 0x623: 82, - 0x624: 82, - 0x625: 82, - 0x626: 68, - 0x627: 82, - 0x628: 68, - 0x629: 82, - 0x62A: 68, - 0x62B: 68, - 0x62C: 68, - 0x62D: 68, - 0x62E: 68, - 0x62F: 82, - 0x630: 82, - 0x631: 82, - 0x632: 82, - 0x633: 68, - 0x634: 68, - 0x635: 68, - 0x636: 68, - 0x637: 68, - 0x638: 68, - 0x639: 68, - 0x63A: 68, - 0x63B: 68, - 0x63C: 68, - 0x63D: 68, - 0x63E: 68, - 0x63F: 68, - 0x640: 67, - 0x641: 68, - 0x642: 68, - 0x643: 68, - 0x644: 68, - 0x645: 68, - 0x646: 68, - 0x647: 68, - 0x648: 82, - 0x649: 68, - 0x64A: 68, - 0x64B: 84, - 0x64C: 84, - 0x64D: 84, - 0x64E: 84, - 0x64F: 84, - 0x650: 84, - 0x651: 84, - 0x652: 84, - 0x653: 84, - 0x654: 84, - 0x655: 84, - 0x656: 84, - 0x657: 84, - 0x658: 84, - 0x659: 84, - 0x65A: 84, - 0x65B: 84, - 0x65C: 84, - 0x65D: 84, - 0x65E: 84, - 0x65F: 84, - 0x66E: 68, - 0x66F: 68, - 0x670: 84, - 0x671: 82, - 0x672: 82, - 0x673: 82, - 0x675: 82, - 0x676: 82, - 0x677: 82, - 0x678: 68, - 0x679: 68, - 0x67A: 68, - 0x67B: 68, - 0x67C: 68, - 0x67D: 68, - 0x67E: 68, - 0x67F: 68, - 0x680: 68, - 0x681: 68, - 0x682: 68, - 0x683: 68, - 0x684: 68, - 0x685: 68, - 0x686: 68, - 0x687: 68, - 0x688: 82, - 0x689: 82, - 0x68A: 82, - 0x68B: 82, - 0x68C: 82, - 0x68D: 82, - 0x68E: 82, - 0x68F: 82, - 0x690: 82, - 0x691: 82, - 0x692: 82, - 0x693: 82, - 0x694: 82, - 0x695: 82, - 0x696: 82, - 0x697: 82, - 0x698: 82, - 0x699: 82, - 0x69A: 68, - 0x69B: 68, - 0x69C: 68, - 0x69D: 68, - 0x69E: 68, - 0x69F: 68, - 0x6A0: 68, - 0x6A1: 68, - 0x6A2: 68, - 0x6A3: 68, - 0x6A4: 68, - 0x6A5: 68, - 0x6A6: 68, - 0x6A7: 68, - 0x6A8: 68, - 0x6A9: 68, - 0x6AA: 68, - 0x6AB: 68, - 0x6AC: 68, - 0x6AD: 68, - 0x6AE: 68, - 0x6AF: 68, - 0x6B0: 68, - 0x6B1: 68, - 0x6B2: 68, - 0x6B3: 68, - 0x6B4: 68, - 0x6B5: 68, - 0x6B6: 68, - 0x6B7: 68, - 0x6B8: 68, - 0x6B9: 68, - 0x6BA: 68, - 0x6BB: 68, - 0x6BC: 68, - 0x6BD: 68, - 0x6BE: 68, - 0x6BF: 68, - 0x6C0: 82, - 0x6C1: 68, - 0x6C2: 68, - 0x6C3: 82, - 0x6C4: 82, - 0x6C5: 82, - 0x6C6: 82, - 0x6C7: 82, - 0x6C8: 82, - 0x6C9: 82, - 0x6CA: 82, - 0x6CB: 82, - 0x6CC: 68, - 0x6CD: 82, - 0x6CE: 68, - 0x6CF: 82, - 0x6D0: 68, - 0x6D1: 68, - 0x6D2: 82, - 0x6D3: 82, - 0x6D5: 82, - 0x6D6: 84, - 0x6D7: 84, - 0x6D8: 84, - 0x6D9: 84, - 0x6DA: 84, - 0x6DB: 84, - 0x6DC: 84, - 0x6DF: 84, - 0x6E0: 84, - 0x6E1: 84, - 0x6E2: 84, - 0x6E3: 84, - 0x6E4: 84, - 0x6E7: 84, - 0x6E8: 84, - 0x6EA: 84, - 0x6EB: 84, - 0x6EC: 84, - 0x6ED: 84, - 0x6EE: 82, - 0x6EF: 82, - 0x6FA: 68, - 0x6FB: 68, - 0x6FC: 68, - 0x6FF: 68, - 0x70F: 84, - 0x710: 82, - 0x711: 84, - 0x712: 68, - 0x713: 68, - 0x714: 68, - 0x715: 82, - 0x716: 82, - 0x717: 82, - 0x718: 82, - 0x719: 82, - 0x71A: 68, - 0x71B: 68, - 0x71C: 68, - 0x71D: 68, - 0x71E: 82, - 0x71F: 68, - 0x720: 68, - 0x721: 68, - 0x722: 68, - 0x723: 68, - 0x724: 68, - 0x725: 68, - 0x726: 68, - 0x727: 68, - 0x728: 82, - 0x729: 68, - 0x72A: 82, - 0x72B: 68, - 0x72C: 82, - 0x72D: 68, - 0x72E: 68, - 0x72F: 82, - 0x730: 84, - 0x731: 84, - 0x732: 84, - 0x733: 84, - 0x734: 84, - 0x735: 84, - 0x736: 84, - 0x737: 84, - 0x738: 84, - 0x739: 84, - 0x73A: 84, - 0x73B: 84, - 0x73C: 84, - 0x73D: 84, - 0x73E: 84, - 0x73F: 84, - 0x740: 84, - 0x741: 84, - 0x742: 84, - 0x743: 84, - 0x744: 84, - 0x745: 84, - 0x746: 84, - 0x747: 84, - 0x748: 84, - 0x749: 84, - 0x74A: 84, - 0x74D: 82, - 0x74E: 68, - 0x74F: 68, - 0x750: 68, - 0x751: 68, - 0x752: 68, - 0x753: 68, - 0x754: 68, - 0x755: 68, - 0x756: 68, - 0x757: 68, - 0x758: 68, - 0x759: 82, - 0x75A: 82, - 0x75B: 82, - 0x75C: 68, - 0x75D: 68, - 0x75E: 68, - 0x75F: 68, - 0x760: 68, - 0x761: 68, - 0x762: 68, - 0x763: 68, - 0x764: 68, - 0x765: 68, - 0x766: 68, - 0x767: 68, - 0x768: 68, - 0x769: 68, - 0x76A: 68, - 0x76B: 82, - 0x76C: 82, - 0x76D: 68, - 0x76E: 68, - 0x76F: 68, - 0x770: 68, - 0x771: 82, - 0x772: 68, - 0x773: 82, - 0x774: 82, - 0x775: 68, - 0x776: 68, - 0x777: 68, - 0x778: 82, - 0x779: 82, - 0x77A: 68, - 0x77B: 68, - 0x77C: 68, - 0x77D: 68, - 0x77E: 68, - 0x77F: 68, - 0x7A6: 84, - 0x7A7: 84, - 0x7A8: 84, - 0x7A9: 84, - 0x7AA: 84, - 0x7AB: 84, - 0x7AC: 84, - 0x7AD: 84, - 0x7AE: 84, - 0x7AF: 84, - 0x7B0: 84, - 0x7CA: 68, - 0x7CB: 68, - 0x7CC: 68, - 0x7CD: 68, - 0x7CE: 68, - 0x7CF: 68, - 0x7D0: 68, - 0x7D1: 68, - 0x7D2: 68, - 0x7D3: 68, - 0x7D4: 68, - 0x7D5: 68, - 0x7D6: 68, - 0x7D7: 68, - 0x7D8: 68, - 0x7D9: 68, - 0x7DA: 68, - 0x7DB: 68, - 0x7DC: 68, - 0x7DD: 68, - 0x7DE: 68, - 0x7DF: 68, - 0x7E0: 68, - 0x7E1: 68, - 0x7E2: 68, - 0x7E3: 68, - 0x7E4: 68, - 0x7E5: 68, - 0x7E6: 68, - 0x7E7: 68, - 0x7E8: 68, - 0x7E9: 68, - 0x7EA: 68, - 0x7EB: 84, - 0x7EC: 84, - 0x7ED: 84, - 0x7EE: 84, - 0x7EF: 84, - 0x7F0: 84, - 0x7F1: 84, - 0x7F2: 84, - 0x7F3: 84, - 0x7FA: 67, - 0x7FD: 84, - 0x816: 84, - 0x817: 84, - 0x818: 84, - 0x819: 84, - 0x81B: 84, - 0x81C: 84, - 0x81D: 84, - 0x81E: 84, - 0x81F: 84, - 0x820: 84, - 0x821: 84, - 0x822: 84, - 0x823: 84, - 0x825: 84, - 0x826: 84, - 0x827: 84, - 0x829: 84, - 0x82A: 84, - 0x82B: 84, - 0x82C: 84, - 0x82D: 84, - 0x840: 82, - 0x841: 68, - 0x842: 68, - 0x843: 68, - 0x844: 68, - 0x845: 68, - 0x846: 82, - 0x847: 82, - 0x848: 68, - 0x849: 82, - 0x84A: 68, - 0x84B: 68, - 0x84C: 68, - 0x84D: 68, - 0x84E: 68, - 0x84F: 68, - 0x850: 68, - 0x851: 68, - 0x852: 68, - 0x853: 68, - 0x854: 82, - 0x855: 68, - 0x856: 82, - 0x857: 82, - 0x858: 82, - 0x859: 84, - 0x85A: 84, - 0x85B: 84, - 0x860: 68, - 0x862: 68, - 0x863: 68, - 0x864: 68, - 0x865: 68, - 0x867: 82, - 0x868: 68, - 0x869: 82, - 0x86A: 82, - 0x870: 82, - 0x871: 82, - 0x872: 82, - 0x873: 82, - 0x874: 82, - 0x875: 82, - 0x876: 82, - 0x877: 82, - 0x878: 82, - 0x879: 82, - 0x87A: 82, - 0x87B: 82, - 0x87C: 82, - 0x87D: 82, - 0x87E: 82, - 0x87F: 82, - 0x880: 82, - 0x881: 82, - 0x882: 82, - 0x883: 67, - 0x884: 67, - 0x885: 67, - 0x886: 68, - 0x889: 68, - 0x88A: 68, - 0x88B: 68, - 0x88C: 68, - 0x88D: 68, - 0x88E: 82, - 0x897: 84, - 0x898: 84, - 0x899: 84, - 0x89A: 84, - 0x89B: 84, - 0x89C: 84, - 0x89D: 84, - 0x89E: 84, - 0x89F: 84, - 0x8A0: 68, - 0x8A1: 68, - 0x8A2: 68, - 0x8A3: 68, - 0x8A4: 68, - 0x8A5: 68, - 0x8A6: 68, - 0x8A7: 68, - 0x8A8: 68, - 0x8A9: 68, - 0x8AA: 82, - 0x8AB: 82, - 0x8AC: 82, - 0x8AE: 82, - 0x8AF: 68, - 0x8B0: 68, - 0x8B1: 82, - 0x8B2: 82, - 0x8B3: 68, - 0x8B4: 68, - 0x8B5: 68, - 0x8B6: 68, - 0x8B7: 68, - 0x8B8: 68, - 0x8B9: 82, - 0x8BA: 68, - 0x8BB: 68, - 0x8BC: 68, - 0x8BD: 68, - 0x8BE: 68, - 0x8BF: 68, - 0x8C0: 68, - 0x8C1: 68, - 0x8C2: 68, - 0x8C3: 68, - 0x8C4: 68, - 0x8C5: 68, - 0x8C6: 68, - 0x8C7: 68, - 0x8C8: 68, - 0x8CA: 84, - 0x8CB: 84, - 0x8CC: 84, - 0x8CD: 84, - 0x8CE: 84, - 0x8CF: 84, - 0x8D0: 84, - 0x8D1: 84, - 0x8D2: 84, - 0x8D3: 84, - 0x8D4: 84, - 0x8D5: 84, - 0x8D6: 84, - 0x8D7: 84, - 0x8D8: 84, - 0x8D9: 84, - 0x8DA: 84, - 0x8DB: 84, - 0x8DC: 84, - 0x8DD: 84, - 0x8DE: 84, - 0x8DF: 84, - 0x8E0: 84, - 0x8E1: 84, - 0x8E3: 84, - 0x8E4: 84, - 0x8E5: 84, - 0x8E6: 84, - 0x8E7: 84, - 0x8E8: 84, - 0x8E9: 84, - 0x8EA: 84, - 0x8EB: 84, - 0x8EC: 84, - 0x8ED: 84, - 0x8EE: 84, - 0x8EF: 84, - 0x8F0: 84, - 0x8F1: 84, - 0x8F2: 84, - 0x8F3: 84, - 0x8F4: 84, - 0x8F5: 84, - 0x8F6: 84, - 0x8F7: 84, - 0x8F8: 84, - 0x8F9: 84, - 0x8FA: 84, - 0x8FB: 84, - 0x8FC: 84, - 0x8FD: 84, - 0x8FE: 84, - 0x8FF: 84, - 0x900: 84, - 0x901: 84, - 0x902: 84, - 0x93A: 84, - 0x93C: 84, - 0x941: 84, - 0x942: 84, - 0x943: 84, - 0x944: 84, - 0x945: 84, - 0x946: 84, - 0x947: 84, - 0x948: 84, - 0x94D: 84, - 0x951: 84, - 0x952: 84, - 0x953: 84, - 0x954: 84, - 0x955: 84, - 0x956: 84, - 0x957: 84, - 0x962: 84, - 0x963: 84, - 0x981: 84, - 0x9BC: 84, - 0x9C1: 84, - 0x9C2: 84, - 0x9C3: 84, - 0x9C4: 84, - 0x9CD: 84, - 0x9E2: 84, - 0x9E3: 84, - 0x9FE: 84, - 0xA01: 84, - 0xA02: 84, - 0xA3C: 84, - 0xA41: 84, - 0xA42: 84, - 0xA47: 84, - 0xA48: 84, - 0xA4B: 84, - 0xA4C: 84, - 0xA4D: 84, - 0xA51: 84, - 0xA70: 84, - 0xA71: 84, - 0xA75: 84, - 0xA81: 84, - 0xA82: 84, - 0xABC: 84, - 0xAC1: 84, - 0xAC2: 84, - 0xAC3: 84, - 0xAC4: 84, - 0xAC5: 84, - 0xAC7: 84, - 0xAC8: 84, - 0xACD: 84, - 0xAE2: 84, - 0xAE3: 84, - 0xAFA: 84, - 0xAFB: 84, - 0xAFC: 84, - 0xAFD: 84, - 0xAFE: 84, - 0xAFF: 84, - 0xB01: 84, - 0xB3C: 84, - 0xB3F: 84, - 0xB41: 84, - 0xB42: 84, - 0xB43: 84, - 0xB44: 84, - 0xB4D: 84, - 0xB55: 84, - 0xB56: 84, - 0xB62: 84, - 0xB63: 84, - 0xB82: 84, - 0xBC0: 84, - 0xBCD: 84, - 0xC00: 84, - 0xC04: 84, - 0xC3C: 84, - 0xC3E: 84, - 0xC3F: 84, - 0xC40: 84, - 0xC46: 84, - 0xC47: 84, - 0xC48: 84, - 0xC4A: 84, - 0xC4B: 84, - 0xC4C: 84, - 0xC4D: 84, - 0xC55: 84, - 0xC56: 84, - 0xC62: 84, - 0xC63: 84, - 0xC81: 84, - 0xCBC: 84, - 0xCBF: 84, - 0xCC6: 84, - 0xCCC: 84, - 0xCCD: 84, - 0xCE2: 84, - 0xCE3: 84, - 0xD00: 84, - 0xD01: 84, - 0xD3B: 84, - 0xD3C: 84, - 0xD41: 84, - 0xD42: 84, - 0xD43: 84, - 0xD44: 84, - 0xD4D: 84, - 0xD62: 84, - 0xD63: 84, - 0xD81: 84, - 0xDCA: 84, - 0xDD2: 84, - 0xDD3: 84, - 0xDD4: 84, - 0xDD6: 84, - 0xE31: 84, - 0xE34: 84, - 0xE35: 84, - 0xE36: 84, - 0xE37: 84, - 0xE38: 84, - 0xE39: 84, - 0xE3A: 84, - 0xE47: 84, - 0xE48: 84, - 0xE49: 84, - 0xE4A: 84, - 0xE4B: 84, - 0xE4C: 84, - 0xE4D: 84, - 0xE4E: 84, - 0xEB1: 84, - 0xEB4: 84, - 0xEB5: 84, - 0xEB6: 84, - 0xEB7: 84, - 0xEB8: 84, - 0xEB9: 84, - 0xEBA: 84, - 0xEBB: 84, - 0xEBC: 84, - 0xEC8: 84, - 0xEC9: 84, - 0xECA: 84, - 0xECB: 84, - 0xECC: 84, - 0xECD: 84, - 0xECE: 84, - 0xF18: 84, - 0xF19: 84, - 0xF35: 84, - 0xF37: 84, - 0xF39: 84, - 0xF71: 84, - 0xF72: 84, - 0xF73: 84, - 0xF74: 84, - 0xF75: 84, - 0xF76: 84, - 0xF77: 84, - 0xF78: 84, - 0xF79: 84, - 0xF7A: 84, - 0xF7B: 84, - 0xF7C: 84, - 0xF7D: 84, - 0xF7E: 84, - 0xF80: 84, - 0xF81: 84, - 0xF82: 84, - 0xF83: 84, - 0xF84: 84, - 0xF86: 84, - 0xF87: 84, - 0xF8D: 84, - 0xF8E: 84, - 0xF8F: 84, - 0xF90: 84, - 0xF91: 84, - 0xF92: 84, - 0xF93: 84, - 0xF94: 84, - 0xF95: 84, - 0xF96: 84, - 0xF97: 84, - 0xF99: 84, - 0xF9A: 84, - 0xF9B: 84, - 0xF9C: 84, - 0xF9D: 84, - 0xF9E: 84, - 0xF9F: 84, - 0xFA0: 84, - 0xFA1: 84, - 0xFA2: 84, - 0xFA3: 84, - 0xFA4: 84, - 0xFA5: 84, - 0xFA6: 84, - 0xFA7: 84, - 0xFA8: 84, - 0xFA9: 84, - 0xFAA: 84, - 0xFAB: 84, - 0xFAC: 84, - 0xFAD: 84, - 0xFAE: 84, - 0xFAF: 84, - 0xFB0: 84, - 0xFB1: 84, - 0xFB2: 84, - 0xFB3: 84, - 0xFB4: 84, - 0xFB5: 84, - 0xFB6: 84, - 0xFB7: 84, - 0xFB8: 84, - 0xFB9: 84, - 0xFBA: 84, - 0xFBB: 84, - 0xFBC: 84, - 0xFC6: 84, - 0x102D: 84, - 0x102E: 84, - 0x102F: 84, - 0x1030: 84, - 0x1032: 84, - 0x1033: 84, - 0x1034: 84, - 0x1035: 84, - 0x1036: 84, - 0x1037: 84, - 0x1039: 84, - 0x103A: 84, - 0x103D: 84, - 0x103E: 84, - 0x1058: 84, - 0x1059: 84, - 0x105E: 84, - 0x105F: 84, - 0x1060: 84, - 0x1071: 84, - 0x1072: 84, - 0x1073: 84, - 0x1074: 84, - 0x1082: 84, - 0x1085: 84, - 0x1086: 84, - 0x108D: 84, - 0x109D: 84, - 0x135D: 84, - 0x135E: 84, - 0x135F: 84, - 0x1712: 84, - 0x1713: 84, - 0x1714: 84, - 0x1732: 84, - 0x1733: 84, - 0x1752: 84, - 0x1753: 84, - 0x1772: 84, - 0x1773: 84, - 0x17B4: 84, - 0x17B5: 84, - 0x17B7: 84, - 0x17B8: 84, - 0x17B9: 84, - 0x17BA: 84, - 0x17BB: 84, - 0x17BC: 84, - 0x17BD: 84, - 0x17C6: 84, - 0x17C9: 84, - 0x17CA: 84, - 0x17CB: 84, - 0x17CC: 84, - 0x17CD: 84, - 0x17CE: 84, - 0x17CF: 84, - 0x17D0: 84, - 0x17D1: 84, - 0x17D2: 84, - 0x17D3: 84, - 0x17DD: 84, - 0x1807: 68, - 0x180A: 67, - 0x180B: 84, - 0x180C: 84, - 0x180D: 84, - 0x180F: 84, - 0x1820: 68, - 0x1821: 68, - 0x1822: 68, - 0x1823: 68, - 0x1824: 68, - 0x1825: 68, - 0x1826: 68, - 0x1827: 68, - 0x1828: 68, - 0x1829: 68, - 0x182A: 68, - 0x182B: 68, - 0x182C: 68, - 0x182D: 68, - 0x182E: 68, - 0x182F: 68, - 0x1830: 68, - 0x1831: 68, - 0x1832: 68, - 0x1833: 68, - 0x1834: 68, - 0x1835: 68, - 0x1836: 68, - 0x1837: 68, - 0x1838: 68, - 0x1839: 68, - 0x183A: 68, - 0x183B: 68, - 0x183C: 68, - 0x183D: 68, - 0x183E: 68, - 0x183F: 68, - 0x1840: 68, - 0x1841: 68, - 0x1842: 68, - 0x1843: 68, - 0x1844: 68, - 0x1845: 68, - 0x1846: 68, - 0x1847: 68, - 0x1848: 68, - 0x1849: 68, - 0x184A: 68, - 0x184B: 68, - 0x184C: 68, - 0x184D: 68, - 0x184E: 68, - 0x184F: 68, - 0x1850: 68, - 0x1851: 68, - 0x1852: 68, - 0x1853: 68, - 0x1854: 68, - 0x1855: 68, - 0x1856: 68, - 0x1857: 68, - 0x1858: 68, - 0x1859: 68, - 0x185A: 68, - 0x185B: 68, - 0x185C: 68, - 0x185D: 68, - 0x185E: 68, - 0x185F: 68, - 0x1860: 68, - 0x1861: 68, - 0x1862: 68, - 0x1863: 68, - 0x1864: 68, - 0x1865: 68, - 0x1866: 68, - 0x1867: 68, - 0x1868: 68, - 0x1869: 68, - 0x186A: 68, - 0x186B: 68, - 0x186C: 68, - 0x186D: 68, - 0x186E: 68, - 0x186F: 68, - 0x1870: 68, - 0x1871: 68, - 0x1872: 68, - 0x1873: 68, - 0x1874: 68, - 0x1875: 68, - 0x1876: 68, - 0x1877: 68, - 0x1878: 68, - 0x1885: 84, - 0x1886: 84, - 0x1887: 68, - 0x1888: 68, - 0x1889: 68, - 0x188A: 68, - 0x188B: 68, - 0x188C: 68, - 0x188D: 68, - 0x188E: 68, - 0x188F: 68, - 0x1890: 68, - 0x1891: 68, - 0x1892: 68, - 0x1893: 68, - 0x1894: 68, - 0x1895: 68, - 0x1896: 68, - 0x1897: 68, - 0x1898: 68, - 0x1899: 68, - 0x189A: 68, - 0x189B: 68, - 0x189C: 68, - 0x189D: 68, - 0x189E: 68, - 0x189F: 68, - 0x18A0: 68, - 0x18A1: 68, - 0x18A2: 68, - 0x18A3: 68, - 0x18A4: 68, - 0x18A5: 68, - 0x18A6: 68, - 0x18A7: 68, - 0x18A8: 68, - 0x18A9: 84, - 0x18AA: 68, - 0x1920: 84, - 0x1921: 84, - 0x1922: 84, - 0x1927: 84, - 0x1928: 84, - 0x1932: 84, - 0x1939: 84, - 0x193A: 84, - 0x193B: 84, - 0x1A17: 84, - 0x1A18: 84, - 0x1A1B: 84, - 0x1A56: 84, - 0x1A58: 84, - 0x1A59: 84, - 0x1A5A: 84, - 0x1A5B: 84, - 0x1A5C: 84, - 0x1A5D: 84, - 0x1A5E: 84, - 0x1A60: 84, - 0x1A62: 84, - 0x1A65: 84, - 0x1A66: 84, - 0x1A67: 84, - 0x1A68: 84, - 0x1A69: 84, - 0x1A6A: 84, - 0x1A6B: 84, - 0x1A6C: 84, - 0x1A73: 84, - 0x1A74: 84, - 0x1A75: 84, - 0x1A76: 84, - 0x1A77: 84, - 0x1A78: 84, - 0x1A79: 84, - 0x1A7A: 84, - 0x1A7B: 84, - 0x1A7C: 84, - 0x1A7F: 84, - 0x1AB0: 84, - 0x1AB1: 84, - 0x1AB2: 84, - 0x1AB3: 84, - 0x1AB4: 84, - 0x1AB5: 84, - 0x1AB6: 84, - 0x1AB7: 84, - 0x1AB8: 84, - 0x1AB9: 84, - 0x1ABA: 84, - 0x1ABB: 84, - 0x1ABC: 84, - 0x1ABD: 84, - 0x1ABE: 84, - 0x1ABF: 84, - 0x1AC0: 84, - 0x1AC1: 84, - 0x1AC2: 84, - 0x1AC3: 84, - 0x1AC4: 84, - 0x1AC5: 84, - 0x1AC6: 84, - 0x1AC7: 84, - 0x1AC8: 84, - 0x1AC9: 84, - 0x1ACA: 84, - 0x1ACB: 84, - 0x1ACC: 84, - 0x1ACD: 84, - 0x1ACE: 84, - 0x1B00: 84, - 0x1B01: 84, - 0x1B02: 84, - 0x1B03: 84, - 0x1B34: 84, - 0x1B36: 84, - 0x1B37: 84, - 0x1B38: 84, - 0x1B39: 84, - 0x1B3A: 84, - 0x1B3C: 84, - 0x1B42: 84, - 0x1B6B: 84, - 0x1B6C: 84, - 0x1B6D: 84, - 0x1B6E: 84, - 0x1B6F: 84, - 0x1B70: 84, - 0x1B71: 84, - 0x1B72: 84, - 0x1B73: 84, - 0x1B80: 84, - 0x1B81: 84, - 0x1BA2: 84, - 0x1BA3: 84, - 0x1BA4: 84, - 0x1BA5: 84, - 0x1BA8: 84, - 0x1BA9: 84, - 0x1BAB: 84, - 0x1BAC: 84, - 0x1BAD: 84, - 0x1BE6: 84, - 0x1BE8: 84, - 0x1BE9: 84, - 0x1BED: 84, - 0x1BEF: 84, - 0x1BF0: 84, - 0x1BF1: 84, - 0x1C2C: 84, - 0x1C2D: 84, - 0x1C2E: 84, - 0x1C2F: 84, - 0x1C30: 84, - 0x1C31: 84, - 0x1C32: 84, - 0x1C33: 84, - 0x1C36: 84, - 0x1C37: 84, - 0x1CD0: 84, - 0x1CD1: 84, - 0x1CD2: 84, - 0x1CD4: 84, - 0x1CD5: 84, - 0x1CD6: 84, - 0x1CD7: 84, - 0x1CD8: 84, - 0x1CD9: 84, - 0x1CDA: 84, - 0x1CDB: 84, - 0x1CDC: 84, - 0x1CDD: 84, - 0x1CDE: 84, - 0x1CDF: 84, - 0x1CE0: 84, - 0x1CE2: 84, - 0x1CE3: 84, - 0x1CE4: 84, - 0x1CE5: 84, - 0x1CE6: 84, - 0x1CE7: 84, - 0x1CE8: 84, - 0x1CED: 84, - 0x1CF4: 84, - 0x1CF8: 84, - 0x1CF9: 84, - 0x1DC0: 84, - 0x1DC1: 84, - 0x1DC2: 84, - 0x1DC3: 84, - 0x1DC4: 84, - 0x1DC5: 84, - 0x1DC6: 84, - 0x1DC7: 84, - 0x1DC8: 84, - 0x1DC9: 84, - 0x1DCA: 84, - 0x1DCB: 84, - 0x1DCC: 84, - 0x1DCD: 84, - 0x1DCE: 84, - 0x1DCF: 84, - 0x1DD0: 84, - 0x1DD1: 84, - 0x1DD2: 84, - 0x1DD3: 84, - 0x1DD4: 84, - 0x1DD5: 84, - 0x1DD6: 84, - 0x1DD7: 84, - 0x1DD8: 84, - 0x1DD9: 84, - 0x1DDA: 84, - 0x1DDB: 84, - 0x1DDC: 84, - 0x1DDD: 84, - 0x1DDE: 84, - 0x1DDF: 84, - 0x1DE0: 84, - 0x1DE1: 84, - 0x1DE2: 84, - 0x1DE3: 84, - 0x1DE4: 84, - 0x1DE5: 84, - 0x1DE6: 84, - 0x1DE7: 84, - 0x1DE8: 84, - 0x1DE9: 84, - 0x1DEA: 84, - 0x1DEB: 84, - 0x1DEC: 84, - 0x1DED: 84, - 0x1DEE: 84, - 0x1DEF: 84, - 0x1DF0: 84, - 0x1DF1: 84, - 0x1DF2: 84, - 0x1DF3: 84, - 0x1DF4: 84, - 0x1DF5: 84, - 0x1DF6: 84, - 0x1DF7: 84, - 0x1DF8: 84, - 0x1DF9: 84, - 0x1DFA: 84, - 0x1DFB: 84, - 0x1DFC: 84, - 0x1DFD: 84, - 0x1DFE: 84, - 0x1DFF: 84, - 0x200B: 84, - 0x200D: 67, - 0x200E: 84, - 0x200F: 84, - 0x202A: 84, - 0x202B: 84, - 0x202C: 84, - 0x202D: 84, - 0x202E: 84, - 0x2060: 84, - 0x2061: 84, - 0x2062: 84, - 0x2063: 84, - 0x2064: 84, - 0x206A: 84, - 0x206B: 84, - 0x206C: 84, - 0x206D: 84, - 0x206E: 84, - 0x206F: 84, - 0x20D0: 84, - 0x20D1: 84, - 0x20D2: 84, - 0x20D3: 84, - 0x20D4: 84, - 0x20D5: 84, - 0x20D6: 84, - 0x20D7: 84, - 0x20D8: 84, - 0x20D9: 84, - 0x20DA: 84, - 0x20DB: 84, - 0x20DC: 84, - 0x20DD: 84, - 0x20DE: 84, - 0x20DF: 84, - 0x20E0: 84, - 0x20E1: 84, - 0x20E2: 84, - 0x20E3: 84, - 0x20E4: 84, - 0x20E5: 84, - 0x20E6: 84, - 0x20E7: 84, - 0x20E8: 84, - 0x20E9: 84, - 0x20EA: 84, - 0x20EB: 84, - 0x20EC: 84, - 0x20ED: 84, - 0x20EE: 84, - 0x20EF: 84, - 0x20F0: 84, - 0x2CEF: 84, - 0x2CF0: 84, - 0x2CF1: 84, - 0x2D7F: 84, - 0x2DE0: 84, - 0x2DE1: 84, - 0x2DE2: 84, - 0x2DE3: 84, - 0x2DE4: 84, - 0x2DE5: 84, - 0x2DE6: 84, - 0x2DE7: 84, - 0x2DE8: 84, - 0x2DE9: 84, - 0x2DEA: 84, - 0x2DEB: 84, - 0x2DEC: 84, - 0x2DED: 84, - 0x2DEE: 84, - 0x2DEF: 84, - 0x2DF0: 84, - 0x2DF1: 84, - 0x2DF2: 84, - 0x2DF3: 84, - 0x2DF4: 84, - 0x2DF5: 84, - 0x2DF6: 84, - 0x2DF7: 84, - 0x2DF8: 84, - 0x2DF9: 84, - 0x2DFA: 84, - 0x2DFB: 84, - 0x2DFC: 84, - 0x2DFD: 84, - 0x2DFE: 84, - 0x2DFF: 84, - 0x302A: 84, - 0x302B: 84, - 0x302C: 84, - 0x302D: 84, - 0x3099: 84, - 0x309A: 84, - 0xA66F: 84, - 0xA670: 84, - 0xA671: 84, - 0xA672: 84, - 0xA674: 84, - 0xA675: 84, - 0xA676: 84, - 0xA677: 84, - 0xA678: 84, - 0xA679: 84, - 0xA67A: 84, - 0xA67B: 84, - 0xA67C: 84, - 0xA67D: 84, - 0xA69E: 84, - 0xA69F: 84, - 0xA6F0: 84, - 0xA6F1: 84, - 0xA802: 84, - 0xA806: 84, - 0xA80B: 84, - 0xA825: 84, - 0xA826: 84, - 0xA82C: 84, - 0xA840: 68, - 0xA841: 68, - 0xA842: 68, - 0xA843: 68, - 0xA844: 68, - 0xA845: 68, - 0xA846: 68, - 0xA847: 68, - 0xA848: 68, - 0xA849: 68, - 0xA84A: 68, - 0xA84B: 68, - 0xA84C: 68, - 0xA84D: 68, - 0xA84E: 68, - 0xA84F: 68, - 0xA850: 68, - 0xA851: 68, - 0xA852: 68, - 0xA853: 68, - 0xA854: 68, - 0xA855: 68, - 0xA856: 68, - 0xA857: 68, - 0xA858: 68, - 0xA859: 68, - 0xA85A: 68, - 0xA85B: 68, - 0xA85C: 68, - 0xA85D: 68, - 0xA85E: 68, - 0xA85F: 68, - 0xA860: 68, - 0xA861: 68, - 0xA862: 68, - 0xA863: 68, - 0xA864: 68, - 0xA865: 68, - 0xA866: 68, - 0xA867: 68, - 0xA868: 68, - 0xA869: 68, - 0xA86A: 68, - 0xA86B: 68, - 0xA86C: 68, - 0xA86D: 68, - 0xA86E: 68, - 0xA86F: 68, - 0xA870: 68, - 0xA871: 68, - 0xA872: 76, - 0xA8C4: 84, - 0xA8C5: 84, - 0xA8E0: 84, - 0xA8E1: 84, - 0xA8E2: 84, - 0xA8E3: 84, - 0xA8E4: 84, - 0xA8E5: 84, - 0xA8E6: 84, - 0xA8E7: 84, - 0xA8E8: 84, - 0xA8E9: 84, - 0xA8EA: 84, - 0xA8EB: 84, - 0xA8EC: 84, - 0xA8ED: 84, - 0xA8EE: 84, - 0xA8EF: 84, - 0xA8F0: 84, - 0xA8F1: 84, - 0xA8FF: 84, - 0xA926: 84, - 0xA927: 84, - 0xA928: 84, - 0xA929: 84, - 0xA92A: 84, - 0xA92B: 84, - 0xA92C: 84, - 0xA92D: 84, - 0xA947: 84, - 0xA948: 84, - 0xA949: 84, - 0xA94A: 84, - 0xA94B: 84, - 0xA94C: 84, - 0xA94D: 84, - 0xA94E: 84, - 0xA94F: 84, - 0xA950: 84, - 0xA951: 84, - 0xA980: 84, - 0xA981: 84, - 0xA982: 84, - 0xA9B3: 84, - 0xA9B6: 84, - 0xA9B7: 84, - 0xA9B8: 84, - 0xA9B9: 84, - 0xA9BC: 84, - 0xA9BD: 84, - 0xA9E5: 84, - 0xAA29: 84, - 0xAA2A: 84, - 0xAA2B: 84, - 0xAA2C: 84, - 0xAA2D: 84, - 0xAA2E: 84, - 0xAA31: 84, - 0xAA32: 84, - 0xAA35: 84, - 0xAA36: 84, - 0xAA43: 84, - 0xAA4C: 84, - 0xAA7C: 84, - 0xAAB0: 84, - 0xAAB2: 84, - 0xAAB3: 84, - 0xAAB4: 84, - 0xAAB7: 84, - 0xAAB8: 84, - 0xAABE: 84, - 0xAABF: 84, - 0xAAC1: 84, - 0xAAEC: 84, - 0xAAED: 84, - 0xAAF6: 84, - 0xABE5: 84, - 0xABE8: 84, - 0xABED: 84, - 0xFB1E: 84, - 0xFE00: 84, - 0xFE01: 84, - 0xFE02: 84, - 0xFE03: 84, - 0xFE04: 84, - 0xFE05: 84, - 0xFE06: 84, - 0xFE07: 84, - 0xFE08: 84, - 0xFE09: 84, - 0xFE0A: 84, - 0xFE0B: 84, - 0xFE0C: 84, - 0xFE0D: 84, - 0xFE0E: 84, - 0xFE0F: 84, - 0xFE20: 84, - 0xFE21: 84, - 0xFE22: 84, - 0xFE23: 84, - 0xFE24: 84, - 0xFE25: 84, - 0xFE26: 84, - 0xFE27: 84, - 0xFE28: 84, - 0xFE29: 84, - 0xFE2A: 84, - 0xFE2B: 84, - 0xFE2C: 84, - 0xFE2D: 84, - 0xFE2E: 84, - 0xFE2F: 84, - 0xFEFF: 84, - 0xFFF9: 84, - 0xFFFA: 84, - 0xFFFB: 84, - 0x101FD: 84, - 0x102E0: 84, - 0x10376: 84, - 0x10377: 84, - 0x10378: 84, - 0x10379: 84, - 0x1037A: 84, - 0x10A01: 84, - 0x10A02: 84, - 0x10A03: 84, - 0x10A05: 84, - 0x10A06: 84, - 0x10A0C: 84, - 0x10A0D: 84, - 0x10A0E: 84, - 0x10A0F: 84, - 0x10A38: 84, - 0x10A39: 84, - 0x10A3A: 84, - 0x10A3F: 84, - 0x10AC0: 68, - 0x10AC1: 68, - 0x10AC2: 68, - 0x10AC3: 68, - 0x10AC4: 68, - 0x10AC5: 82, - 0x10AC7: 82, - 0x10AC9: 82, - 0x10ACA: 82, - 0x10ACD: 76, - 0x10ACE: 82, - 0x10ACF: 82, - 0x10AD0: 82, - 0x10AD1: 82, - 0x10AD2: 82, - 0x10AD3: 68, - 0x10AD4: 68, - 0x10AD5: 68, - 0x10AD6: 68, - 0x10AD7: 76, - 0x10AD8: 68, - 0x10AD9: 68, - 0x10ADA: 68, - 0x10ADB: 68, - 0x10ADC: 68, - 0x10ADD: 82, - 0x10ADE: 68, - 0x10ADF: 68, - 0x10AE0: 68, - 0x10AE1: 82, - 0x10AE4: 82, - 0x10AE5: 84, - 0x10AE6: 84, - 0x10AEB: 68, - 0x10AEC: 68, - 0x10AED: 68, - 0x10AEE: 68, - 0x10AEF: 82, - 0x10B80: 68, - 0x10B81: 82, - 0x10B82: 68, - 0x10B83: 82, - 0x10B84: 82, - 0x10B85: 82, - 0x10B86: 68, - 0x10B87: 68, - 0x10B88: 68, - 0x10B89: 82, - 0x10B8A: 68, - 0x10B8B: 68, - 0x10B8C: 82, - 0x10B8D: 68, - 0x10B8E: 82, - 0x10B8F: 82, - 0x10B90: 68, - 0x10B91: 82, - 0x10BA9: 82, - 0x10BAA: 82, - 0x10BAB: 82, - 0x10BAC: 82, - 0x10BAD: 68, - 0x10BAE: 68, - 0x10D00: 76, - 0x10D01: 68, - 0x10D02: 68, - 0x10D03: 68, - 0x10D04: 68, - 0x10D05: 68, - 0x10D06: 68, - 0x10D07: 68, - 0x10D08: 68, - 0x10D09: 68, - 0x10D0A: 68, - 0x10D0B: 68, - 0x10D0C: 68, - 0x10D0D: 68, - 0x10D0E: 68, - 0x10D0F: 68, - 0x10D10: 68, - 0x10D11: 68, - 0x10D12: 68, - 0x10D13: 68, - 0x10D14: 68, - 0x10D15: 68, - 0x10D16: 68, - 0x10D17: 68, - 0x10D18: 68, - 0x10D19: 68, - 0x10D1A: 68, - 0x10D1B: 68, - 0x10D1C: 68, - 0x10D1D: 68, - 0x10D1E: 68, - 0x10D1F: 68, - 0x10D20: 68, - 0x10D21: 68, - 0x10D22: 82, - 0x10D23: 68, - 0x10D24: 84, - 0x10D25: 84, - 0x10D26: 84, - 0x10D27: 84, - 0x10D69: 84, - 0x10D6A: 84, - 0x10D6B: 84, - 0x10D6C: 84, - 0x10D6D: 84, - 0x10EAB: 84, - 0x10EAC: 84, - 0x10EC2: 82, - 0x10EC3: 68, - 0x10EC4: 68, - 0x10EFC: 84, - 0x10EFD: 84, - 0x10EFE: 84, - 0x10EFF: 84, - 0x10F30: 68, - 0x10F31: 68, - 0x10F32: 68, - 0x10F33: 82, - 0x10F34: 68, - 0x10F35: 68, - 0x10F36: 68, - 0x10F37: 68, - 0x10F38: 68, - 0x10F39: 68, - 0x10F3A: 68, - 0x10F3B: 68, - 0x10F3C: 68, - 0x10F3D: 68, - 0x10F3E: 68, - 0x10F3F: 68, - 0x10F40: 68, - 0x10F41: 68, - 0x10F42: 68, - 0x10F43: 68, - 0x10F44: 68, - 0x10F46: 84, - 0x10F47: 84, - 0x10F48: 84, - 0x10F49: 84, - 0x10F4A: 84, - 0x10F4B: 84, - 0x10F4C: 84, - 0x10F4D: 84, - 0x10F4E: 84, - 0x10F4F: 84, - 0x10F50: 84, - 0x10F51: 68, - 0x10F52: 68, - 0x10F53: 68, - 0x10F54: 82, - 0x10F70: 68, - 0x10F71: 68, - 0x10F72: 68, - 0x10F73: 68, - 0x10F74: 82, - 0x10F75: 82, - 0x10F76: 68, - 0x10F77: 68, - 0x10F78: 68, - 0x10F79: 68, - 0x10F7A: 68, - 0x10F7B: 68, - 0x10F7C: 68, - 0x10F7D: 68, - 0x10F7E: 68, - 0x10F7F: 68, - 0x10F80: 68, - 0x10F81: 68, - 0x10F82: 84, - 0x10F83: 84, - 0x10F84: 84, - 0x10F85: 84, - 0x10FB0: 68, - 0x10FB2: 68, - 0x10FB3: 68, - 0x10FB4: 82, - 0x10FB5: 82, - 0x10FB6: 82, - 0x10FB8: 68, - 0x10FB9: 82, - 0x10FBA: 82, - 0x10FBB: 68, - 0x10FBC: 68, - 0x10FBD: 82, - 0x10FBE: 68, - 0x10FBF: 68, - 0x10FC1: 68, - 0x10FC2: 82, - 0x10FC3: 82, - 0x10FC4: 68, - 0x10FC9: 82, - 0x10FCA: 68, - 0x10FCB: 76, - 0x11001: 84, - 0x11038: 84, - 0x11039: 84, - 0x1103A: 84, - 0x1103B: 84, - 0x1103C: 84, - 0x1103D: 84, - 0x1103E: 84, - 0x1103F: 84, - 0x11040: 84, - 0x11041: 84, - 0x11042: 84, - 0x11043: 84, - 0x11044: 84, - 0x11045: 84, - 0x11046: 84, - 0x11070: 84, - 0x11073: 84, - 0x11074: 84, - 0x1107F: 84, - 0x11080: 84, - 0x11081: 84, - 0x110B3: 84, - 0x110B4: 84, - 0x110B5: 84, - 0x110B6: 84, - 0x110B9: 84, - 0x110BA: 84, - 0x110C2: 84, - 0x11100: 84, - 0x11101: 84, - 0x11102: 84, - 0x11127: 84, - 0x11128: 84, - 0x11129: 84, - 0x1112A: 84, - 0x1112B: 84, - 0x1112D: 84, - 0x1112E: 84, - 0x1112F: 84, - 0x11130: 84, - 0x11131: 84, - 0x11132: 84, - 0x11133: 84, - 0x11134: 84, - 0x11173: 84, - 0x11180: 84, - 0x11181: 84, - 0x111B6: 84, - 0x111B7: 84, - 0x111B8: 84, - 0x111B9: 84, - 0x111BA: 84, - 0x111BB: 84, - 0x111BC: 84, - 0x111BD: 84, - 0x111BE: 84, - 0x111C9: 84, - 0x111CA: 84, - 0x111CB: 84, - 0x111CC: 84, - 0x111CF: 84, - 0x1122F: 84, - 0x11230: 84, - 0x11231: 84, - 0x11234: 84, - 0x11236: 84, - 0x11237: 84, - 0x1123E: 84, - 0x11241: 84, - 0x112DF: 84, - 0x112E3: 84, - 0x112E4: 84, - 0x112E5: 84, - 0x112E6: 84, - 0x112E7: 84, - 0x112E8: 84, - 0x112E9: 84, - 0x112EA: 84, - 0x11300: 84, - 0x11301: 84, - 0x1133B: 84, - 0x1133C: 84, - 0x11340: 84, - 0x11366: 84, - 0x11367: 84, - 0x11368: 84, - 0x11369: 84, - 0x1136A: 84, - 0x1136B: 84, - 0x1136C: 84, - 0x11370: 84, - 0x11371: 84, - 0x11372: 84, - 0x11373: 84, - 0x11374: 84, - 0x113BB: 84, - 0x113BC: 84, - 0x113BD: 84, - 0x113BE: 84, - 0x113BF: 84, - 0x113C0: 84, - 0x113CE: 84, - 0x113D0: 84, - 0x113D2: 84, - 0x113E1: 84, - 0x113E2: 84, - 0x11438: 84, - 0x11439: 84, - 0x1143A: 84, - 0x1143B: 84, - 0x1143C: 84, - 0x1143D: 84, - 0x1143E: 84, - 0x1143F: 84, - 0x11442: 84, - 0x11443: 84, - 0x11444: 84, - 0x11446: 84, - 0x1145E: 84, - 0x114B3: 84, - 0x114B4: 84, - 0x114B5: 84, - 0x114B6: 84, - 0x114B7: 84, - 0x114B8: 84, - 0x114BA: 84, - 0x114BF: 84, - 0x114C0: 84, - 0x114C2: 84, - 0x114C3: 84, - 0x115B2: 84, - 0x115B3: 84, - 0x115B4: 84, - 0x115B5: 84, - 0x115BC: 84, - 0x115BD: 84, - 0x115BF: 84, - 0x115C0: 84, - 0x115DC: 84, - 0x115DD: 84, - 0x11633: 84, - 0x11634: 84, - 0x11635: 84, - 0x11636: 84, - 0x11637: 84, - 0x11638: 84, - 0x11639: 84, - 0x1163A: 84, - 0x1163D: 84, - 0x1163F: 84, - 0x11640: 84, - 0x116AB: 84, - 0x116AD: 84, - 0x116B0: 84, - 0x116B1: 84, - 0x116B2: 84, - 0x116B3: 84, - 0x116B4: 84, - 0x116B5: 84, - 0x116B7: 84, - 0x1171D: 84, - 0x1171F: 84, - 0x11722: 84, - 0x11723: 84, - 0x11724: 84, - 0x11725: 84, - 0x11727: 84, - 0x11728: 84, - 0x11729: 84, - 0x1172A: 84, - 0x1172B: 84, - 0x1182F: 84, - 0x11830: 84, - 0x11831: 84, - 0x11832: 84, - 0x11833: 84, - 0x11834: 84, - 0x11835: 84, - 0x11836: 84, - 0x11837: 84, - 0x11839: 84, - 0x1183A: 84, - 0x1193B: 84, - 0x1193C: 84, - 0x1193E: 84, - 0x11943: 84, - 0x119D4: 84, - 0x119D5: 84, - 0x119D6: 84, - 0x119D7: 84, - 0x119DA: 84, - 0x119DB: 84, - 0x119E0: 84, - 0x11A01: 84, - 0x11A02: 84, - 0x11A03: 84, - 0x11A04: 84, - 0x11A05: 84, - 0x11A06: 84, - 0x11A07: 84, - 0x11A08: 84, - 0x11A09: 84, - 0x11A0A: 84, - 0x11A33: 84, - 0x11A34: 84, - 0x11A35: 84, - 0x11A36: 84, - 0x11A37: 84, - 0x11A38: 84, - 0x11A3B: 84, - 0x11A3C: 84, - 0x11A3D: 84, - 0x11A3E: 84, - 0x11A47: 84, - 0x11A51: 84, - 0x11A52: 84, - 0x11A53: 84, - 0x11A54: 84, - 0x11A55: 84, - 0x11A56: 84, - 0x11A59: 84, - 0x11A5A: 84, - 0x11A5B: 84, - 0x11A8A: 84, - 0x11A8B: 84, - 0x11A8C: 84, - 0x11A8D: 84, - 0x11A8E: 84, - 0x11A8F: 84, - 0x11A90: 84, - 0x11A91: 84, - 0x11A92: 84, - 0x11A93: 84, - 0x11A94: 84, - 0x11A95: 84, - 0x11A96: 84, - 0x11A98: 84, - 0x11A99: 84, - 0x11C30: 84, - 0x11C31: 84, - 0x11C32: 84, - 0x11C33: 84, - 0x11C34: 84, - 0x11C35: 84, - 0x11C36: 84, - 0x11C38: 84, - 0x11C39: 84, - 0x11C3A: 84, - 0x11C3B: 84, - 0x11C3C: 84, - 0x11C3D: 84, - 0x11C3F: 84, - 0x11C92: 84, - 0x11C93: 84, - 0x11C94: 84, - 0x11C95: 84, - 0x11C96: 84, - 0x11C97: 84, - 0x11C98: 84, - 0x11C99: 84, - 0x11C9A: 84, - 0x11C9B: 84, - 0x11C9C: 84, - 0x11C9D: 84, - 0x11C9E: 84, - 0x11C9F: 84, - 0x11CA0: 84, - 0x11CA1: 84, - 0x11CA2: 84, - 0x11CA3: 84, - 0x11CA4: 84, - 0x11CA5: 84, - 0x11CA6: 84, - 0x11CA7: 84, - 0x11CAA: 84, - 0x11CAB: 84, - 0x11CAC: 84, - 0x11CAD: 84, - 0x11CAE: 84, - 0x11CAF: 84, - 0x11CB0: 84, - 0x11CB2: 84, - 0x11CB3: 84, - 0x11CB5: 84, - 0x11CB6: 84, - 0x11D31: 84, - 0x11D32: 84, - 0x11D33: 84, - 0x11D34: 84, - 0x11D35: 84, - 0x11D36: 84, - 0x11D3A: 84, - 0x11D3C: 84, - 0x11D3D: 84, - 0x11D3F: 84, - 0x11D40: 84, - 0x11D41: 84, - 0x11D42: 84, - 0x11D43: 84, - 0x11D44: 84, - 0x11D45: 84, - 0x11D47: 84, - 0x11D90: 84, - 0x11D91: 84, - 0x11D95: 84, - 0x11D97: 84, - 0x11EF3: 84, - 0x11EF4: 84, - 0x11F00: 84, - 0x11F01: 84, - 0x11F36: 84, - 0x11F37: 84, - 0x11F38: 84, - 0x11F39: 84, - 0x11F3A: 84, - 0x11F40: 84, - 0x11F42: 84, - 0x11F5A: 84, - 0x13430: 84, - 0x13431: 84, - 0x13432: 84, - 0x13433: 84, - 0x13434: 84, - 0x13435: 84, - 0x13436: 84, - 0x13437: 84, - 0x13438: 84, - 0x13439: 84, - 0x1343A: 84, - 0x1343B: 84, - 0x1343C: 84, - 0x1343D: 84, - 0x1343E: 84, - 0x1343F: 84, - 0x13440: 84, - 0x13447: 84, - 0x13448: 84, - 0x13449: 84, - 0x1344A: 84, - 0x1344B: 84, - 0x1344C: 84, - 0x1344D: 84, - 0x1344E: 84, - 0x1344F: 84, - 0x13450: 84, - 0x13451: 84, - 0x13452: 84, - 0x13453: 84, - 0x13454: 84, - 0x13455: 84, - 0x1611E: 84, - 0x1611F: 84, - 0x16120: 84, - 0x16121: 84, - 0x16122: 84, - 0x16123: 84, - 0x16124: 84, - 0x16125: 84, - 0x16126: 84, - 0x16127: 84, - 0x16128: 84, - 0x16129: 84, - 0x1612D: 84, - 0x1612E: 84, - 0x1612F: 84, - 0x16AF0: 84, - 0x16AF1: 84, - 0x16AF2: 84, - 0x16AF3: 84, - 0x16AF4: 84, - 0x16B30: 84, - 0x16B31: 84, - 0x16B32: 84, - 0x16B33: 84, - 0x16B34: 84, - 0x16B35: 84, - 0x16B36: 84, - 0x16F4F: 84, - 0x16F8F: 84, - 0x16F90: 84, - 0x16F91: 84, - 0x16F92: 84, - 0x16FE4: 84, - 0x1BC9D: 84, - 0x1BC9E: 84, - 0x1BCA0: 84, - 0x1BCA1: 84, - 0x1BCA2: 84, - 0x1BCA3: 84, - 0x1CF00: 84, - 0x1CF01: 84, - 0x1CF02: 84, - 0x1CF03: 84, - 0x1CF04: 84, - 0x1CF05: 84, - 0x1CF06: 84, - 0x1CF07: 84, - 0x1CF08: 84, - 0x1CF09: 84, - 0x1CF0A: 84, - 0x1CF0B: 84, - 0x1CF0C: 84, - 0x1CF0D: 84, - 0x1CF0E: 84, - 0x1CF0F: 84, - 0x1CF10: 84, - 0x1CF11: 84, - 0x1CF12: 84, - 0x1CF13: 84, - 0x1CF14: 84, - 0x1CF15: 84, - 0x1CF16: 84, - 0x1CF17: 84, - 0x1CF18: 84, - 0x1CF19: 84, - 0x1CF1A: 84, - 0x1CF1B: 84, - 0x1CF1C: 84, - 0x1CF1D: 84, - 0x1CF1E: 84, - 0x1CF1F: 84, - 0x1CF20: 84, - 0x1CF21: 84, - 0x1CF22: 84, - 0x1CF23: 84, - 0x1CF24: 84, - 0x1CF25: 84, - 0x1CF26: 84, - 0x1CF27: 84, - 0x1CF28: 84, - 0x1CF29: 84, - 0x1CF2A: 84, - 0x1CF2B: 84, - 0x1CF2C: 84, - 0x1CF2D: 84, - 0x1CF30: 84, - 0x1CF31: 84, - 0x1CF32: 84, - 0x1CF33: 84, - 0x1CF34: 84, - 0x1CF35: 84, - 0x1CF36: 84, - 0x1CF37: 84, - 0x1CF38: 84, - 0x1CF39: 84, - 0x1CF3A: 84, - 0x1CF3B: 84, - 0x1CF3C: 84, - 0x1CF3D: 84, - 0x1CF3E: 84, - 0x1CF3F: 84, - 0x1CF40: 84, - 0x1CF41: 84, - 0x1CF42: 84, - 0x1CF43: 84, - 0x1CF44: 84, - 0x1CF45: 84, - 0x1CF46: 84, - 0x1D167: 84, - 0x1D168: 84, - 0x1D169: 84, - 0x1D173: 84, - 0x1D174: 84, - 0x1D175: 84, - 0x1D176: 84, - 0x1D177: 84, - 0x1D178: 84, - 0x1D179: 84, - 0x1D17A: 84, - 0x1D17B: 84, - 0x1D17C: 84, - 0x1D17D: 84, - 0x1D17E: 84, - 0x1D17F: 84, - 0x1D180: 84, - 0x1D181: 84, - 0x1D182: 84, - 0x1D185: 84, - 0x1D186: 84, - 0x1D187: 84, - 0x1D188: 84, - 0x1D189: 84, - 0x1D18A: 84, - 0x1D18B: 84, - 0x1D1AA: 84, - 0x1D1AB: 84, - 0x1D1AC: 84, - 0x1D1AD: 84, - 0x1D242: 84, - 0x1D243: 84, - 0x1D244: 84, - 0x1DA00: 84, - 0x1DA01: 84, - 0x1DA02: 84, - 0x1DA03: 84, - 0x1DA04: 84, - 0x1DA05: 84, - 0x1DA06: 84, - 0x1DA07: 84, - 0x1DA08: 84, - 0x1DA09: 84, - 0x1DA0A: 84, - 0x1DA0B: 84, - 0x1DA0C: 84, - 0x1DA0D: 84, - 0x1DA0E: 84, - 0x1DA0F: 84, - 0x1DA10: 84, - 0x1DA11: 84, - 0x1DA12: 84, - 0x1DA13: 84, - 0x1DA14: 84, - 0x1DA15: 84, - 0x1DA16: 84, - 0x1DA17: 84, - 0x1DA18: 84, - 0x1DA19: 84, - 0x1DA1A: 84, - 0x1DA1B: 84, - 0x1DA1C: 84, - 0x1DA1D: 84, - 0x1DA1E: 84, - 0x1DA1F: 84, - 0x1DA20: 84, - 0x1DA21: 84, - 0x1DA22: 84, - 0x1DA23: 84, - 0x1DA24: 84, - 0x1DA25: 84, - 0x1DA26: 84, - 0x1DA27: 84, - 0x1DA28: 84, - 0x1DA29: 84, - 0x1DA2A: 84, - 0x1DA2B: 84, - 0x1DA2C: 84, - 0x1DA2D: 84, - 0x1DA2E: 84, - 0x1DA2F: 84, - 0x1DA30: 84, - 0x1DA31: 84, - 0x1DA32: 84, - 0x1DA33: 84, - 0x1DA34: 84, - 0x1DA35: 84, - 0x1DA36: 84, - 0x1DA3B: 84, - 0x1DA3C: 84, - 0x1DA3D: 84, - 0x1DA3E: 84, - 0x1DA3F: 84, - 0x1DA40: 84, - 0x1DA41: 84, - 0x1DA42: 84, - 0x1DA43: 84, - 0x1DA44: 84, - 0x1DA45: 84, - 0x1DA46: 84, - 0x1DA47: 84, - 0x1DA48: 84, - 0x1DA49: 84, - 0x1DA4A: 84, - 0x1DA4B: 84, - 0x1DA4C: 84, - 0x1DA4D: 84, - 0x1DA4E: 84, - 0x1DA4F: 84, - 0x1DA50: 84, - 0x1DA51: 84, - 0x1DA52: 84, - 0x1DA53: 84, - 0x1DA54: 84, - 0x1DA55: 84, - 0x1DA56: 84, - 0x1DA57: 84, - 0x1DA58: 84, - 0x1DA59: 84, - 0x1DA5A: 84, - 0x1DA5B: 84, - 0x1DA5C: 84, - 0x1DA5D: 84, - 0x1DA5E: 84, - 0x1DA5F: 84, - 0x1DA60: 84, - 0x1DA61: 84, - 0x1DA62: 84, - 0x1DA63: 84, - 0x1DA64: 84, - 0x1DA65: 84, - 0x1DA66: 84, - 0x1DA67: 84, - 0x1DA68: 84, - 0x1DA69: 84, - 0x1DA6A: 84, - 0x1DA6B: 84, - 0x1DA6C: 84, - 0x1DA75: 84, - 0x1DA84: 84, - 0x1DA9B: 84, - 0x1DA9C: 84, - 0x1DA9D: 84, - 0x1DA9E: 84, - 0x1DA9F: 84, - 0x1DAA1: 84, - 0x1DAA2: 84, - 0x1DAA3: 84, - 0x1DAA4: 84, - 0x1DAA5: 84, - 0x1DAA6: 84, - 0x1DAA7: 84, - 0x1DAA8: 84, - 0x1DAA9: 84, - 0x1DAAA: 84, - 0x1DAAB: 84, - 0x1DAAC: 84, - 0x1DAAD: 84, - 0x1DAAE: 84, - 0x1DAAF: 84, - 0x1E000: 84, - 0x1E001: 84, - 0x1E002: 84, - 0x1E003: 84, - 0x1E004: 84, - 0x1E005: 84, - 0x1E006: 84, - 0x1E008: 84, - 0x1E009: 84, - 0x1E00A: 84, - 0x1E00B: 84, - 0x1E00C: 84, - 0x1E00D: 84, - 0x1E00E: 84, - 0x1E00F: 84, - 0x1E010: 84, - 0x1E011: 84, - 0x1E012: 84, - 0x1E013: 84, - 0x1E014: 84, - 0x1E015: 84, - 0x1E016: 84, - 0x1E017: 84, - 0x1E018: 84, - 0x1E01B: 84, - 0x1E01C: 84, - 0x1E01D: 84, - 0x1E01E: 84, - 0x1E01F: 84, - 0x1E020: 84, - 0x1E021: 84, - 0x1E023: 84, - 0x1E024: 84, - 0x1E026: 84, - 0x1E027: 84, - 0x1E028: 84, - 0x1E029: 84, - 0x1E02A: 84, - 0x1E08F: 84, - 0x1E130: 84, - 0x1E131: 84, - 0x1E132: 84, - 0x1E133: 84, - 0x1E134: 84, - 0x1E135: 84, - 0x1E136: 84, - 0x1E2AE: 84, - 0x1E2EC: 84, - 0x1E2ED: 84, - 0x1E2EE: 84, - 0x1E2EF: 84, - 0x1E4EC: 84, - 0x1E4ED: 84, - 0x1E4EE: 84, - 0x1E4EF: 84, - 0x1E5EE: 84, - 0x1E5EF: 84, - 0x1E8D0: 84, - 0x1E8D1: 84, - 0x1E8D2: 84, - 0x1E8D3: 84, - 0x1E8D4: 84, - 0x1E8D5: 84, - 0x1E8D6: 84, - 0x1E900: 68, - 0x1E901: 68, - 0x1E902: 68, - 0x1E903: 68, - 0x1E904: 68, - 0x1E905: 68, - 0x1E906: 68, - 0x1E907: 68, - 0x1E908: 68, - 0x1E909: 68, - 0x1E90A: 68, - 0x1E90B: 68, - 0x1E90C: 68, - 0x1E90D: 68, - 0x1E90E: 68, - 0x1E90F: 68, - 0x1E910: 68, - 0x1E911: 68, - 0x1E912: 68, - 0x1E913: 68, - 0x1E914: 68, - 0x1E915: 68, - 0x1E916: 68, - 0x1E917: 68, - 0x1E918: 68, - 0x1E919: 68, - 0x1E91A: 68, - 0x1E91B: 68, - 0x1E91C: 68, - 0x1E91D: 68, - 0x1E91E: 68, - 0x1E91F: 68, - 0x1E920: 68, - 0x1E921: 68, - 0x1E922: 68, - 0x1E923: 68, - 0x1E924: 68, - 0x1E925: 68, - 0x1E926: 68, - 0x1E927: 68, - 0x1E928: 68, - 0x1E929: 68, - 0x1E92A: 68, - 0x1E92B: 68, - 0x1E92C: 68, - 0x1E92D: 68, - 0x1E92E: 68, - 0x1E92F: 68, - 0x1E930: 68, - 0x1E931: 68, - 0x1E932: 68, - 0x1E933: 68, - 0x1E934: 68, - 0x1E935: 68, - 0x1E936: 68, - 0x1E937: 68, - 0x1E938: 68, - 0x1E939: 68, - 0x1E93A: 68, - 0x1E93B: 68, - 0x1E93C: 68, - 0x1E93D: 68, - 0x1E93E: 68, - 0x1E93F: 68, - 0x1E940: 68, - 0x1E941: 68, - 0x1E942: 68, - 0x1E943: 68, - 0x1E944: 84, - 0x1E945: 84, - 0x1E946: 84, - 0x1E947: 84, - 0x1E948: 84, - 0x1E949: 84, - 0x1E94A: 84, - 0x1E94B: 84, - 0xE0001: 84, - 0xE0020: 84, - 0xE0021: 84, - 0xE0022: 84, - 0xE0023: 84, - 0xE0024: 84, - 0xE0025: 84, - 0xE0026: 84, - 0xE0027: 84, - 0xE0028: 84, - 0xE0029: 84, - 0xE002A: 84, - 0xE002B: 84, - 0xE002C: 84, - 0xE002D: 84, - 0xE002E: 84, - 0xE002F: 84, - 0xE0030: 84, - 0xE0031: 84, - 0xE0032: 84, - 0xE0033: 84, - 0xE0034: 84, - 0xE0035: 84, - 0xE0036: 84, - 0xE0037: 84, - 0xE0038: 84, - 0xE0039: 84, - 0xE003A: 84, - 0xE003B: 84, - 0xE003C: 84, - 0xE003D: 84, - 0xE003E: 84, - 0xE003F: 84, - 0xE0040: 84, - 0xE0041: 84, - 0xE0042: 84, - 0xE0043: 84, - 0xE0044: 84, - 0xE0045: 84, - 0xE0046: 84, - 0xE0047: 84, - 0xE0048: 84, - 0xE0049: 84, - 0xE004A: 84, - 0xE004B: 84, - 0xE004C: 84, - 0xE004D: 84, - 0xE004E: 84, - 0xE004F: 84, - 0xE0050: 84, - 0xE0051: 84, - 0xE0052: 84, - 0xE0053: 84, - 0xE0054: 84, - 0xE0055: 84, - 0xE0056: 84, - 0xE0057: 84, - 0xE0058: 84, - 0xE0059: 84, - 0xE005A: 84, - 0xE005B: 84, - 0xE005C: 84, - 0xE005D: 84, - 0xE005E: 84, - 0xE005F: 84, - 0xE0060: 84, - 0xE0061: 84, - 0xE0062: 84, - 0xE0063: 84, - 0xE0064: 84, - 0xE0065: 84, - 0xE0066: 84, - 0xE0067: 84, - 0xE0068: 84, - 0xE0069: 84, - 0xE006A: 84, - 0xE006B: 84, - 0xE006C: 84, - 0xE006D: 84, - 0xE006E: 84, - 0xE006F: 84, - 0xE0070: 84, - 0xE0071: 84, - 0xE0072: 84, - 0xE0073: 84, - 0xE0074: 84, - 0xE0075: 84, - 0xE0076: 84, - 0xE0077: 84, - 0xE0078: 84, - 0xE0079: 84, - 0xE007A: 84, - 0xE007B: 84, - 0xE007C: 84, - 0xE007D: 84, - 0xE007E: 84, - 0xE007F: 84, - 0xE0100: 84, - 0xE0101: 84, - 0xE0102: 84, - 0xE0103: 84, - 0xE0104: 84, - 0xE0105: 84, - 0xE0106: 84, - 0xE0107: 84, - 0xE0108: 84, - 0xE0109: 84, - 0xE010A: 84, - 0xE010B: 84, - 0xE010C: 84, - 0xE010D: 84, - 0xE010E: 84, - 0xE010F: 84, - 0xE0110: 84, - 0xE0111: 84, - 0xE0112: 84, - 0xE0113: 84, - 0xE0114: 84, - 0xE0115: 84, - 0xE0116: 84, - 0xE0117: 84, - 0xE0118: 84, - 0xE0119: 84, - 0xE011A: 84, - 0xE011B: 84, - 0xE011C: 84, - 0xE011D: 84, - 0xE011E: 84, - 0xE011F: 84, - 0xE0120: 84, - 0xE0121: 84, - 0xE0122: 84, - 0xE0123: 84, - 0xE0124: 84, - 0xE0125: 84, - 0xE0126: 84, - 0xE0127: 84, - 0xE0128: 84, - 0xE0129: 84, - 0xE012A: 84, - 0xE012B: 84, - 0xE012C: 84, - 0xE012D: 84, - 0xE012E: 84, - 0xE012F: 84, - 0xE0130: 84, - 0xE0131: 84, - 0xE0132: 84, - 0xE0133: 84, - 0xE0134: 84, - 0xE0135: 84, - 0xE0136: 84, - 0xE0137: 84, - 0xE0138: 84, - 0xE0139: 84, - 0xE013A: 84, - 0xE013B: 84, - 0xE013C: 84, - 0xE013D: 84, - 0xE013E: 84, - 0xE013F: 84, - 0xE0140: 84, - 0xE0141: 84, - 0xE0142: 84, - 0xE0143: 84, - 0xE0144: 84, - 0xE0145: 84, - 0xE0146: 84, - 0xE0147: 84, - 0xE0148: 84, - 0xE0149: 84, - 0xE014A: 84, - 0xE014B: 84, - 0xE014C: 84, - 0xE014D: 84, - 0xE014E: 84, - 0xE014F: 84, - 0xE0150: 84, - 0xE0151: 84, - 0xE0152: 84, - 0xE0153: 84, - 0xE0154: 84, - 0xE0155: 84, - 0xE0156: 84, - 0xE0157: 84, - 0xE0158: 84, - 0xE0159: 84, - 0xE015A: 84, - 0xE015B: 84, - 0xE015C: 84, - 0xE015D: 84, - 0xE015E: 84, - 0xE015F: 84, - 0xE0160: 84, - 0xE0161: 84, - 0xE0162: 84, - 0xE0163: 84, - 0xE0164: 84, - 0xE0165: 84, - 0xE0166: 84, - 0xE0167: 84, - 0xE0168: 84, - 0xE0169: 84, - 0xE016A: 84, - 0xE016B: 84, - 0xE016C: 84, - 0xE016D: 84, - 0xE016E: 84, - 0xE016F: 84, - 0xE0170: 84, - 0xE0171: 84, - 0xE0172: 84, - 0xE0173: 84, - 0xE0174: 84, - 0xE0175: 84, - 0xE0176: 84, - 0xE0177: 84, - 0xE0178: 84, - 0xE0179: 84, - 0xE017A: 84, - 0xE017B: 84, - 0xE017C: 84, - 0xE017D: 84, - 0xE017E: 84, - 0xE017F: 84, - 0xE0180: 84, - 0xE0181: 84, - 0xE0182: 84, - 0xE0183: 84, - 0xE0184: 84, - 0xE0185: 84, - 0xE0186: 84, - 0xE0187: 84, - 0xE0188: 84, - 0xE0189: 84, - 0xE018A: 84, - 0xE018B: 84, - 0xE018C: 84, - 0xE018D: 84, - 0xE018E: 84, - 0xE018F: 84, - 0xE0190: 84, - 0xE0191: 84, - 0xE0192: 84, - 0xE0193: 84, - 0xE0194: 84, - 0xE0195: 84, - 0xE0196: 84, - 0xE0197: 84, - 0xE0198: 84, - 0xE0199: 84, - 0xE019A: 84, - 0xE019B: 84, - 0xE019C: 84, - 0xE019D: 84, - 0xE019E: 84, - 0xE019F: 84, - 0xE01A0: 84, - 0xE01A1: 84, - 0xE01A2: 84, - 0xE01A3: 84, - 0xE01A4: 84, - 0xE01A5: 84, - 0xE01A6: 84, - 0xE01A7: 84, - 0xE01A8: 84, - 0xE01A9: 84, - 0xE01AA: 84, - 0xE01AB: 84, - 0xE01AC: 84, - 0xE01AD: 84, - 0xE01AE: 84, - 0xE01AF: 84, - 0xE01B0: 84, - 0xE01B1: 84, - 0xE01B2: 84, - 0xE01B3: 84, - 0xE01B4: 84, - 0xE01B5: 84, - 0xE01B6: 84, - 0xE01B7: 84, - 0xE01B8: 84, - 0xE01B9: 84, - 0xE01BA: 84, - 0xE01BB: 84, - 0xE01BC: 84, - 0xE01BD: 84, - 0xE01BE: 84, - 0xE01BF: 84, - 0xE01C0: 84, - 0xE01C1: 84, - 0xE01C2: 84, - 0xE01C3: 84, - 0xE01C4: 84, - 0xE01C5: 84, - 0xE01C6: 84, - 0xE01C7: 84, - 0xE01C8: 84, - 0xE01C9: 84, - 0xE01CA: 84, - 0xE01CB: 84, - 0xE01CC: 84, - 0xE01CD: 84, - 0xE01CE: 84, - 0xE01CF: 84, - 0xE01D0: 84, - 0xE01D1: 84, - 0xE01D2: 84, - 0xE01D3: 84, - 0xE01D4: 84, - 0xE01D5: 84, - 0xE01D6: 84, - 0xE01D7: 84, - 0xE01D8: 84, - 0xE01D9: 84, - 0xE01DA: 84, - 0xE01DB: 84, - 0xE01DC: 84, - 0xE01DD: 84, - 0xE01DE: 84, - 0xE01DF: 84, - 0xE01E0: 84, - 0xE01E1: 84, - 0xE01E2: 84, - 0xE01E3: 84, - 0xE01E4: 84, - 0xE01E5: 84, - 0xE01E6: 84, - 0xE01E7: 84, - 0xE01E8: 84, - 0xE01E9: 84, - 0xE01EA: 84, - 0xE01EB: 84, - 0xE01EC: 84, - 0xE01ED: 84, - 0xE01EE: 84, - 0xE01EF: 84, + "C": ( + 0x64000000641, + 0x7FA000007FB, + 0x88300000886, + 0x180A0000180B, + 0x200D0000200E, + ), + "D": ( + 0x62000000621, + 0x62600000627, + 0x62800000629, + 0x62A0000062F, + 0x63300000640, + 0x64100000648, + 0x6490000064B, + 0x66E00000670, + 0x67800000688, + 0x69A000006C0, + 0x6C1000006C3, + 0x6CC000006CD, + 0x6CE000006CF, + 0x6D0000006D2, + 0x6FA000006FD, + 0x6FF00000700, + 0x71200000715, + 0x71A0000071E, + 0x71F00000728, + 0x7290000072A, + 0x72B0000072C, + 0x72D0000072F, + 0x74E00000759, + 0x75C0000076B, + 0x76D00000771, + 0x77200000773, + 0x77500000778, + 0x77A00000780, + 0x7CA000007EB, + 0x84100000846, + 0x84800000849, + 0x84A00000854, + 0x85500000856, + 0x86000000861, + 0x86200000866, + 0x86800000869, + 0x88600000887, + 0x8890000088E, + 0x88F00000890, + 0x8A0000008AA, + 0x8AF000008B1, + 0x8B3000008B9, + 0x8BA000008C9, + 0x180700001808, + 0x182000001879, + 0x1887000018A9, + 0x18AA000018AB, + 0xA8400000A872, + 0x10AC000010AC5, + 0x10AD300010AD7, + 0x10AD800010ADD, + 0x10ADE00010AE1, + 0x10AEB00010AEF, + 0x10B8000010B81, + 0x10B8200010B83, + 0x10B8600010B89, + 0x10B8A00010B8C, + 0x10B8D00010B8E, + 0x10B9000010B91, + 0x10BAD00010BAF, + 0x10D0100010D22, + 0x10D2300010D24, + 0x10EC300010EC5, + 0x10EC600010EC8, + 0x10F3000010F33, + 0x10F3400010F45, + 0x10F5100010F54, + 0x10F7000010F74, + 0x10F7600010F82, + 0x10FB000010FB1, + 0x10FB200010FB4, + 0x10FB800010FB9, + 0x10FBB00010FBD, + 0x10FBE00010FC0, + 0x10FC100010FC2, + 0x10FC400010FC5, + 0x10FCA00010FCB, + 0x1E9000001E944, + ), + "L": ( + 0xA8720000A873, + 0x10ACD00010ACE, + 0x10AD700010AD8, + 0x10D0000010D01, + 0x10ED900010EEF, + 0x10FCB00010FCC, + ), + "R": ( + 0x62200000626, + 0x62700000628, + 0x6290000062A, + 0x62F00000633, + 0x64800000649, + 0x67100000674, + 0x67500000678, + 0x6880000069A, + 0x6C0000006C1, + 0x6C3000006CC, + 0x6CD000006CE, + 0x6CF000006D0, + 0x6D2000006D4, + 0x6D5000006D6, + 0x6EE000006F0, + 0x71000000711, + 0x7150000071A, + 0x71E0000071F, + 0x72800000729, + 0x72A0000072B, + 0x72C0000072D, + 0x72F00000730, + 0x74D0000074E, + 0x7590000075C, + 0x76B0000076D, + 0x77100000772, + 0x77300000775, + 0x7780000077A, + 0x84000000841, + 0x84600000848, + 0x8490000084A, + 0x85400000855, + 0x85600000859, + 0x86700000868, + 0x8690000086B, + 0x87000000883, + 0x88E0000088F, + 0x8AA000008AD, + 0x8AE000008AF, + 0x8B1000008B3, + 0x8B9000008BA, + 0x10AC500010AC6, + 0x10AC700010AC8, + 0x10AC900010ACB, + 0x10ACE00010AD3, + 0x10ADD00010ADE, + 0x10AE100010AE2, + 0x10AE400010AE5, + 0x10AEF00010AF0, + 0x10B8100010B82, + 0x10B8300010B86, + 0x10B8900010B8A, + 0x10B8C00010B8D, + 0x10B8E00010B90, + 0x10B9100010B92, + 0x10BA900010BAD, + 0x10D2200010D23, + 0x10EC200010EC3, + 0x10F3300010F34, + 0x10F5400010F55, + 0x10F7400010F76, + 0x10FB400010FB7, + 0x10FB900010FBB, + 0x10FBD00010FBE, + 0x10FC200010FC4, + 0x10FC900010FCA, + ), + "T": ( + 0xAD000000AE, + 0x30000000370, + 0x4830000048A, + 0x591000005BE, + 0x5BF000005C0, + 0x5C1000005C3, + 0x5C4000005C6, + 0x5C7000005CA, + 0x6100000061B, + 0x61C0000061D, + 0x64B00000660, + 0x67000000671, + 0x6D6000006DD, + 0x6DF000006E5, + 0x6E7000006E9, + 0x6EA000006EE, + 0x70F00000710, + 0x71100000712, + 0x7300000074B, + 0x7A6000007B1, + 0x7EB000007F4, + 0x7FD000007FE, + 0x8160000081A, + 0x81B00000824, + 0x82500000828, + 0x8290000082E, + 0x8590000085C, + 0x897000008A0, + 0x8CA000008E2, + 0x8E300000903, + 0x93A0000093B, + 0x93C0000093D, + 0x94100000949, + 0x94D0000094E, + 0x95100000958, + 0x96200000964, + 0x98100000982, + 0x9BC000009BD, + 0x9C1000009C5, + 0x9CD000009CE, + 0x9E2000009E4, + 0x9FE000009FF, + 0xA0100000A03, + 0xA3C00000A3D, + 0xA4100000A43, + 0xA4700000A49, + 0xA4B00000A4E, + 0xA5100000A52, + 0xA7000000A72, + 0xA7500000A76, + 0xA8100000A83, + 0xABC00000ABD, + 0xAC100000AC6, + 0xAC700000AC9, + 0xACD00000ACE, + 0xAE200000AE4, + 0xAFA00000B00, + 0xB0100000B02, + 0xB3C00000B3D, + 0xB3F00000B40, + 0xB4100000B45, + 0xB4D00000B4E, + 0xB5300000B57, + 0xB6200000B64, + 0xB8200000B83, + 0xBC000000BC1, + 0xBCD00000BCE, + 0xC0000000C01, + 0xC0400000C05, + 0xC3C00000C3D, + 0xC3E00000C41, + 0xC4600000C49, + 0xC4A00000C4E, + 0xC5500000C57, + 0xC6200000C64, + 0xC8100000C82, + 0xCBC00000CBD, + 0xCBF00000CC0, + 0xCC600000CC7, + 0xCCC00000CCE, + 0xCE200000CE4, + 0xD0000000D02, + 0xD3B00000D3D, + 0xD4100000D45, + 0xD4D00000D4E, + 0xD6200000D64, + 0xD8100000D82, + 0xDCA00000DCB, + 0xDD200000DD5, + 0xDD600000DD7, + 0xE3100000E32, + 0xE3400000E3B, + 0xE4700000E4F, + 0xEB100000EB2, + 0xEB400000EBD, + 0xEC800000ECF, + 0xF1800000F1A, + 0xF3500000F36, + 0xF3700000F38, + 0xF3900000F3A, + 0xF7100000F7F, + 0xF8000000F85, + 0xF8600000F88, + 0xF8D00000F98, + 0xF9900000FBD, + 0xFC600000FC7, + 0x102D00001031, + 0x103200001038, + 0x10390000103B, + 0x103D0000103F, + 0x10580000105A, + 0x105E00001061, + 0x107100001075, + 0x108200001083, + 0x108500001087, + 0x108D0000108E, + 0x109D0000109E, + 0x135D00001360, + 0x171200001715, + 0x173200001734, + 0x175200001754, + 0x177200001774, + 0x17B4000017B6, + 0x17B7000017BE, + 0x17C6000017C7, + 0x17C9000017D4, + 0x17DD000017DE, + 0x180B0000180E, + 0x180F00001810, + 0x188500001887, + 0x18A9000018AA, + 0x192000001923, + 0x192700001929, + 0x193200001933, + 0x19390000193C, + 0x1A1700001A19, + 0x1A1B00001A1C, + 0x1A5600001A57, + 0x1A5800001A5F, + 0x1A6000001A61, + 0x1A6200001A63, + 0x1A6500001A6D, + 0x1A7300001A7D, + 0x1A7F00001A80, + 0x1AB000001AF1, + 0x1B0000001B04, + 0x1B3400001B35, + 0x1B3600001B3B, + 0x1B3C00001B3D, + 0x1B4200001B43, + 0x1B6B00001B74, + 0x1B8000001B82, + 0x1BA200001BA6, + 0x1BA800001BAA, + 0x1BAB00001BAE, + 0x1BE600001BE7, + 0x1BE800001BEA, + 0x1BED00001BEE, + 0x1BEF00001BF2, + 0x1C2C00001C34, + 0x1C3600001C38, + 0x1CD000001CD3, + 0x1CD400001CE1, + 0x1CE200001CE9, + 0x1CED00001CEE, + 0x1CF400001CF5, + 0x1CF800001CFA, + 0x1DC000001E00, + 0x200B0000200C, + 0x200E00002010, + 0x202A0000202F, + 0x206000002065, + 0x206A00002070, + 0x20D0000020F1, + 0x2CEF00002CF2, + 0x2D7F00002D80, + 0x2DE000002E00, + 0x302A0000302E, + 0x30990000309B, + 0xA66F0000A673, + 0xA6740000A67E, + 0xA69E0000A6A0, + 0xA6F00000A6F2, + 0xA8020000A803, + 0xA8060000A807, + 0xA80B0000A80C, + 0xA8250000A827, + 0xA82C0000A82D, + 0xA8C40000A8C6, + 0xA8E00000A8F2, + 0xA8FF0000A900, + 0xA9260000A92E, + 0xA9470000A952, + 0xA9800000A983, + 0xA9B30000A9B4, + 0xA9B60000A9BA, + 0xA9BC0000A9BE, + 0xA9E50000A9E6, + 0xAA290000AA2F, + 0xAA310000AA33, + 0xAA350000AA37, + 0xAA430000AA44, + 0xAA4C0000AA4D, + 0xAA7C0000AA7D, + 0xAAB00000AAB1, + 0xAAB20000AAB5, + 0xAAB70000AAB9, + 0xAABE0000AAC0, + 0xAAC10000AAC2, + 0xAAEC0000AAEE, + 0xAAF60000AAF7, + 0xABE50000ABE6, + 0xABE80000ABE9, + 0xABED0000ABEE, + 0xFB1E0000FB1F, + 0xFE000000FE10, + 0xFE200000FE30, + 0xFEFF0000FF00, + 0xFFF90000FFFC, + 0x101FD000101FE, + 0x102E0000102E1, + 0x103760001037B, + 0x10A0100010A04, + 0x10A0500010A07, + 0x10A0C00010A10, + 0x10A3800010A3B, + 0x10A3F00010A40, + 0x10AE500010AE7, + 0x10D2400010D28, + 0x10D6900010D6E, + 0x10EAB00010EAD, + 0x10ECB00010ED0, + 0x10EF000010F00, + 0x10F4600010F51, + 0x10F8200010F86, + 0x1100100011002, + 0x1103800011047, + 0x1107000011071, + 0x1107300011075, + 0x1107F00011082, + 0x110B3000110B7, + 0x110B9000110BB, + 0x110C2000110C3, + 0x1110000011103, + 0x111270001112C, + 0x1112D00011135, + 0x1117300011174, + 0x1118000011182, + 0x111B6000111BF, + 0x111C9000111CD, + 0x111CF000111D0, + 0x1122F00011232, + 0x1123400011235, + 0x1123600011238, + 0x1123E0001123F, + 0x1124100011242, + 0x112DF000112E0, + 0x112E3000112EB, + 0x1130000011302, + 0x1133B0001133D, + 0x1134000011341, + 0x113660001136D, + 0x1137000011375, + 0x113BB000113C1, + 0x113CE000113CF, + 0x113D0000113D1, + 0x113D2000113D3, + 0x113E1000113E3, + 0x1143800011440, + 0x1144200011445, + 0x1144600011447, + 0x1145E0001145F, + 0x114B3000114B9, + 0x114BA000114BB, + 0x114BF000114C1, + 0x114C2000114C4, + 0x115B2000115B6, + 0x115BC000115BE, + 0x115BF000115C1, + 0x115DC000115DE, + 0x116330001163B, + 0x1163D0001163E, + 0x1163F00011641, + 0x116AB000116AC, + 0x116AD000116AE, + 0x116B0000116B6, + 0x116B7000116B8, + 0x1171D0001171E, + 0x1171F00011720, + 0x1172200011726, + 0x117270001172C, + 0x1182F00011838, + 0x118390001183B, + 0x1193B0001193D, + 0x1193E0001193F, + 0x1194300011944, + 0x119D4000119D8, + 0x119DA000119DC, + 0x119E0000119E1, + 0x11A0100011A0B, + 0x11A3300011A39, + 0x11A3B00011A3F, + 0x11A4700011A48, + 0x11A5100011A57, + 0x11A5900011A5C, + 0x11A8A00011A97, + 0x11A9800011A9A, + 0x11B6000011B61, + 0x11B6200011B65, + 0x11B6600011B67, + 0x11C3000011C37, + 0x11C3800011C3E, + 0x11C3F00011C40, + 0x11C9200011CA8, + 0x11CAA00011CB1, + 0x11CB200011CB4, + 0x11CB500011CB7, + 0x11D3100011D37, + 0x11D3A00011D3B, + 0x11D3C00011D3E, + 0x11D3F00011D46, + 0x11D4700011D48, + 0x11D9000011D92, + 0x11D9500011D96, + 0x11D9700011D98, + 0x11DF000011DF1, + 0x11EF300011EF5, + 0x11F0000011F02, + 0x11F3600011F3B, + 0x11F4000011F41, + 0x11F4200011F43, + 0x11F5A00011F5B, + 0x1343000013441, + 0x1344700013456, + 0x1611E0001612A, + 0x1612D00016130, + 0x16AF000016AF5, + 0x16B3000016B37, + 0x16F4F00016F50, + 0x16F8F00016F93, + 0x16FE400016FE5, + 0x1BC9D0001BC9F, + 0x1BCA00001BCA4, + 0x1CF000001CF2E, + 0x1CF300001CF47, + 0x1D1270001D129, + 0x1D1670001D16A, + 0x1D1730001D183, + 0x1D1850001D18C, + 0x1D1AA0001D1AE, + 0x1D2420001D245, + 0x1D25B0001D25D, + 0x1DA000001DA37, + 0x1DA3B0001DA6D, + 0x1DA750001DA76, + 0x1DA840001DA85, + 0x1DA9B0001DAA0, + 0x1DAA10001DAB0, + 0x1E0000001E007, + 0x1E0080001E019, + 0x1E01B0001E022, + 0x1E0230001E025, + 0x1E0260001E02B, + 0x1E08F0001E090, + 0x1E1300001E137, + 0x1E2AE0001E2AF, + 0x1E2EC0001E2F0, + 0x1E4EC0001E4F0, + 0x1E5EE0001E5F0, + 0x1E6E30001E6E4, + 0x1E6E60001E6E7, + 0x1E6EE0001E6F0, + 0x1E6F50001E6F6, + 0x1E8D00001E8D7, + 0x1E9440001E94C, + 0xE0001000E0002, + 0xE0020000E0080, + 0xE0100000E01F0, + ), } + + codepoint_classes = { "PVALID": ( 0x2D0000002E, @@ -3346,7 +933,7 @@ codepoint_classes = { 0x5BF000005C0, 0x5C1000005C3, 0x5C4000005C6, - 0x5C7000005C8, + 0x5C7000005CA, 0x5D0000005EB, 0x5EF000005F3, 0x6100000061B, @@ -3366,7 +953,7 @@ codepoint_classes = { 0x8400000085C, 0x8600000086B, 0x87000000888, - 0x8890000088F, + 0x88900000890, 0x897000008E2, 0x8E300000958, 0x96000000964, @@ -3425,7 +1012,7 @@ codepoint_classes = { 0xB3C00000B45, 0xB4700000B49, 0xB4B00000B4E, - 0xB5500000B58, + 0xB5300000B58, 0xB5F00000B64, 0xB6600000B70, 0xB7100000B72, @@ -3454,7 +1041,7 @@ codepoint_classes = { 0xC4A00000C4E, 0xC5500000C57, 0xC5800000C5B, - 0xC5D00000C5E, + 0xC5C00000C5E, 0xC6000000C64, 0xC6600000C70, 0xC8000000C84, @@ -3467,7 +1054,7 @@ codepoint_classes = { 0xCC600000CC9, 0xCCA00000CCE, 0xCD500000CD7, - 0xCDD00000CDF, + 0xCDC00000CDF, 0xCE000000CE4, 0xCE600000CF0, 0xCF100000CF4, @@ -3594,7 +1181,7 @@ codepoint_classes = { 0x1A9000001A9A, 0x1AA700001AA8, 0x1AB000001ABE, - 0x1ABF00001ACF, + 0x1ABF00001AF1, 0x1B0000001B4D, 0x1B5000001B5A, 0x1B6B00001B74, @@ -3758,6 +1345,7 @@ codepoint_classes = { 0x1FE000001FE3, 0x1FE400001FE8, 0x1FF600001FF7, + 0x208F00002090, 0x214E0000214F, 0x218400002185, 0x2C3000002C60, @@ -3967,6 +1555,7 @@ codepoint_classes = { 0xA7C80000A7C9, 0xA7CA0000A7CB, 0xA7CD0000A7CE, + 0xA7CF0000A7D0, 0xA7D10000A7D2, 0xA7D30000A7D4, 0xA7D50000A7D6, @@ -4059,6 +1648,7 @@ codepoint_classes = { 0x108F4000108F6, 0x1090000010916, 0x109200001093A, + 0x109400001095A, 0x10980000109B8, 0x109BE000109C0, 0x10A0000010A04, @@ -4086,8 +1676,10 @@ codepoint_classes = { 0x10E8000010EAA, 0x10EAB00010EAD, 0x10EB000010EB2, - 0x10EC200010EC5, - 0x10EFC00010F1D, + 0x10EC200010EC8, + 0x10ECB00010ED0, + 0x10ED900010EEF, + 0x10EF000010F1D, 0x10F2700010F28, 0x10F3000010F51, 0x10F7000010F86, @@ -4181,6 +1773,8 @@ codepoint_classes = { 0x11A5000011A9A, 0x11A9D00011A9E, 0x11AB000011AF9, + 0x11B0A00011B0B, + 0x11B6000011B68, 0x11BC000011BE1, 0x11BF000011BFA, 0x11C0000011C09, @@ -4203,6 +1797,9 @@ codepoint_classes = { 0x11D9000011D92, 0x11D9300011D99, 0x11DA000011DAA, + 0x11DB000011DDC, + 0x11DE000011DEA, + 0x11DF000011DF2, 0x11EE000011EF7, 0x11F0000011F11, 0x11F1200011F3B, @@ -4232,40 +1829,64 @@ codepoint_classes = { 0x16D4000016D6D, 0x16D7000016D7A, 0x16E6000016E80, + 0x16EBB00016ED4, 0x16F0000016F4B, 0x16F4F00016F88, 0x16F8F00016FA0, 0x16FE000016FE2, 0x16FE300016FE5, - 0x16FF000016FF2, - 0x17000000187F8, - 0x1880000018CD6, - 0x18CFF00018D09, + 0x16FF000016FF4, + 0x1700000018CDB, + 0x18CFF00018D21, + 0x18D8000018DF3, + 0x18E0000019192, + 0x191A0000191D3, 0x1AFF00001AFF4, 0x1AFF50001AFFC, 0x1AFFD0001AFFF, 0x1B0000001B123, + 0x1B1270001B129, 0x1B1320001B133, 0x1B1500001B153, 0x1B1550001B156, - 0x1B1640001B168, + 0x1B1640001B169, 0x1B1700001B2FC, 0x1BC000001BC6B, 0x1BC700001BC7D, 0x1BC800001BC89, 0x1BC900001BC9A, 0x1BC9D0001BC9F, - 0x1CCF00001CCFA, 0x1CF000001CF2E, 0x1CF300001CF47, + 0x1D2500001D253, + 0x1D25B0001D25D, + 0x1D25F0001D260, + 0x1D2800001D282, 0x1DA000001DA37, 0x1DA3B0001DA6D, 0x1DA750001DA76, 0x1DA840001DA85, 0x1DA9B0001DAA0, 0x1DAA10001DAB0, - 0x1DF000001DF1F, - 0x1DF250001DF2B, + 0x1DF000001DF40, + 0x1DF410001DF48, + 0x1DF490001DF4A, + 0x1DF4B0001DF4D, + 0x1DF4E0001DF51, + 0x1DF520001DF68, + 0x1DF690001DF6A, + 0x1DF6B0001DF6C, + 0x1DF6D0001DF6E, + 0x1DF6F0001DF72, + 0x1DF730001DF74, + 0x1DF750001DF76, + 0x1DF770001DF78, + 0x1DF790001DF7A, + 0x1DF7B0001DF7C, + 0x1DF7D0001DF7E, + 0x1DF7F0001DF82, + 0x1DF900001DF95, + 0x1DF960001DF97, 0x1E0000001E007, 0x1E0080001E019, 0x1E01B0001E022, @@ -4280,6 +1901,9 @@ codepoint_classes = { 0x1E2C00001E2FA, 0x1E4D00001E4FA, 0x1E5D00001E5FB, + 0x1E6C00001E6DF, + 0x1E6E00001E6F6, + 0x1E6FE0001E700, 0x1E7E00001E7E7, 0x1E7E80001E7EC, 0x1E7ED0001E7EF, @@ -4289,13 +1913,13 @@ codepoint_classes = { 0x1E9220001E94C, 0x1E9500001E95A, 0x200000002A6E0, - 0x2A7000002B73A, - 0x2B7400002B81E, - 0x2B8200002CEA2, + 0x2A7000002B81F, + 0x2B8200002CEAE, 0x2CEB00002EBE1, 0x2EBF00002EE5E, 0x300000003134B, - 0x31350000323B0, + 0x313500003347A, + 0x3D0000003FC40, ), "CONTEXTJ": (0x200C0000200E,), "CONTEXTO": ( diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/intranges.py b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/intranges.py index 7bfaa8d..19d7781 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/intranges.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/intranges.py @@ -6,10 +6,9 @@ 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, ...]: +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. @@ -21,9 +20,8 @@ def intranges_from_list(list_: List[int]) -> Tuple[int, ...]: ranges = [] last_write = -1 for i in range(len(sorted_list)): - if i + 1 < len(sorted_list): - if sorted_list[i] == sorted_list[i + 1] - 1: - continue + if i + 1 < len(sorted_list) and 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 @@ -35,11 +33,11 @@ def _encode_range(start: int, end: int) -> int: return (start << 32) | end -def _decode_range(r: int) -> Tuple[int, int]: +def _decode_range(r: int) -> tuple[int, int]: return (r >> 32), (r & ((1 << 32) - 1)) -def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool: +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_) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/package_data.py b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/package_data.py index 7272c8d..2f9ff7e 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/package_data.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/package_data.py @@ -1 +1 @@ -__version__ = "3.11" +__version__ = "3.20" diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/uts46data.py b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/uts46data.py index 4610b71..dbfb60f 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/idna/uts46data.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/idna/uts46data.py @@ -1,8841 +1,17117 @@ # This file is automatically generated by tools/idna-data -# vim: set fileencoding=utf-8 : -from typing import List, Tuple, Union +from __future__ import annotations + +from array import array """IDNA Mapping Table from UTS46.""" -__version__ = "16.0.0" +__version__ = "18.0.0" +uts46_starts: array[int] = array( + "I", + ( + 0x0, + 0x1, + 0x2, + 0x3, + 0x4, + 0x5, + 0x6, + 0x7, + 0x8, + 0x9, + 0xA, + 0xB, + 0xC, + 0xD, + 0xE, + 0xF, + 0x10, + 0x11, + 0x12, + 0x13, + 0x14, + 0x15, + 0x16, + 0x17, + 0x18, + 0x19, + 0x1A, + 0x1B, + 0x1C, + 0x1D, + 0x1E, + 0x1F, + 0x20, + 0x21, + 0x22, + 0x23, + 0x24, + 0x25, + 0x26, + 0x27, + 0x28, + 0x29, + 0x2A, + 0x2B, + 0x2C, + 0x2D, + 0x2E, + 0x2F, + 0x30, + 0x31, + 0x32, + 0x33, + 0x34, + 0x35, + 0x36, + 0x37, + 0x38, + 0x39, + 0x3A, + 0x3B, + 0x3C, + 0x3D, + 0x3E, + 0x3F, + 0x40, + 0x41, + 0x42, + 0x43, + 0x44, + 0x45, + 0x46, + 0x47, + 0x48, + 0x49, + 0x4A, + 0x4B, + 0x4C, + 0x4D, + 0x4E, + 0x4F, + 0x50, + 0x51, + 0x52, + 0x53, + 0x54, + 0x55, + 0x56, + 0x57, + 0x58, + 0x59, + 0x5A, + 0x5B, + 0x5C, + 0x5D, + 0x5E, + 0x5F, + 0x60, + 0x61, + 0x62, + 0x63, + 0x64, + 0x65, + 0x66, + 0x67, + 0x68, + 0x69, + 0x6A, + 0x6B, + 0x6C, + 0x6D, + 0x6E, + 0x6F, + 0x70, + 0x71, + 0x72, + 0x73, + 0x74, + 0x75, + 0x76, + 0x77, + 0x78, + 0x79, + 0x7A, + 0x7B, + 0x7C, + 0x7D, + 0x7E, + 0x7F, + 0x80, + 0x81, + 0x82, + 0x83, + 0x84, + 0x85, + 0x86, + 0x87, + 0x88, + 0x89, + 0x8A, + 0x8B, + 0x8C, + 0x8D, + 0x8E, + 0x8F, + 0x90, + 0x91, + 0x92, + 0x93, + 0x94, + 0x95, + 0x96, + 0x97, + 0x98, + 0x99, + 0x9A, + 0x9B, + 0x9C, + 0x9D, + 0x9E, + 0x9F, + 0xA0, + 0xA1, + 0xA2, + 0xA3, + 0xA4, + 0xA5, + 0xA6, + 0xA7, + 0xA8, + 0xA9, + 0xAA, + 0xAB, + 0xAC, + 0xAD, + 0xAE, + 0xAF, + 0xB0, + 0xB1, + 0xB2, + 0xB3, + 0xB4, + 0xB5, + 0xB6, + 0xB7, + 0xB8, + 0xB9, + 0xBA, + 0xBB, + 0xBC, + 0xBD, + 0xBE, + 0xBF, + 0xC0, + 0xC1, + 0xC2, + 0xC3, + 0xC4, + 0xC5, + 0xC6, + 0xC7, + 0xC8, + 0xC9, + 0xCA, + 0xCB, + 0xCC, + 0xCD, + 0xCE, + 0xCF, + 0xD0, + 0xD1, + 0xD2, + 0xD3, + 0xD4, + 0xD5, + 0xD6, + 0xD7, + 0xD8, + 0xD9, + 0xDA, + 0xDB, + 0xDC, + 0xDD, + 0xDE, + 0xDF, + 0xE0, + 0xE1, + 0xE2, + 0xE3, + 0xE4, + 0xE5, + 0xE6, + 0xE7, + 0xE8, + 0xE9, + 0xEA, + 0xEB, + 0xEC, + 0xED, + 0xEE, + 0xEF, + 0xF0, + 0xF1, + 0xF2, + 0xF3, + 0xF4, + 0xF5, + 0xF6, + 0xF7, + 0xF8, + 0xF9, + 0xFA, + 0xFB, + 0xFC, + 0xFD, + 0xFE, + 0xFF, + 0x100, + 0x101, + 0x102, + 0x103, + 0x104, + 0x105, + 0x106, + 0x107, + 0x108, + 0x109, + 0x10A, + 0x10B, + 0x10C, + 0x10D, + 0x10E, + 0x10F, + 0x110, + 0x111, + 0x112, + 0x113, + 0x114, + 0x115, + 0x116, + 0x117, + 0x118, + 0x119, + 0x11A, + 0x11B, + 0x11C, + 0x11D, + 0x11E, + 0x11F, + 0x120, + 0x121, + 0x122, + 0x123, + 0x124, + 0x125, + 0x126, + 0x127, + 0x128, + 0x129, + 0x12A, + 0x12B, + 0x12C, + 0x12D, + 0x12E, + 0x12F, + 0x130, + 0x131, + 0x132, + 0x134, + 0x135, + 0x136, + 0x137, + 0x139, + 0x13A, + 0x13B, + 0x13C, + 0x13D, + 0x13E, + 0x13F, + 0x141, + 0x142, + 0x143, + 0x144, + 0x145, + 0x146, + 0x147, + 0x148, + 0x149, + 0x14A, + 0x14B, + 0x14C, + 0x14D, + 0x14E, + 0x14F, + 0x150, + 0x151, + 0x152, + 0x153, + 0x154, + 0x155, + 0x156, + 0x157, + 0x158, + 0x159, + 0x15A, + 0x15B, + 0x15C, + 0x15D, + 0x15E, + 0x15F, + 0x160, + 0x161, + 0x162, + 0x163, + 0x164, + 0x165, + 0x166, + 0x167, + 0x168, + 0x169, + 0x16A, + 0x16B, + 0x16C, + 0x16D, + 0x16E, + 0x16F, + 0x170, + 0x171, + 0x172, + 0x173, + 0x174, + 0x175, + 0x176, + 0x177, + 0x178, + 0x179, + 0x17A, + 0x17B, + 0x17C, + 0x17D, + 0x17E, + 0x17F, + 0x180, + 0x181, + 0x182, + 0x183, + 0x184, + 0x185, + 0x186, + 0x187, + 0x188, + 0x189, + 0x18A, + 0x18B, + 0x18C, + 0x18E, + 0x18F, + 0x190, + 0x191, + 0x192, + 0x193, + 0x194, + 0x195, + 0x196, + 0x197, + 0x198, + 0x199, + 0x19C, + 0x19D, + 0x19E, + 0x19F, + 0x1A0, + 0x1A1, + 0x1A2, + 0x1A3, + 0x1A4, + 0x1A5, + 0x1A6, + 0x1A7, + 0x1A8, + 0x1A9, + 0x1AA, + 0x1AC, + 0x1AD, + 0x1AE, + 0x1AF, + 0x1B0, + 0x1B1, + 0x1B2, + 0x1B3, + 0x1B4, + 0x1B5, + 0x1B6, + 0x1B7, + 0x1B8, + 0x1B9, + 0x1BC, + 0x1BD, + 0x1C4, + 0x1C7, + 0x1CA, + 0x1CD, + 0x1CE, + 0x1CF, + 0x1D0, + 0x1D1, + 0x1D2, + 0x1D3, + 0x1D4, + 0x1D5, + 0x1D6, + 0x1D7, + 0x1D8, + 0x1D9, + 0x1DA, + 0x1DB, + 0x1DC, + 0x1DE, + 0x1DF, + 0x1E0, + 0x1E1, + 0x1E2, + 0x1E3, + 0x1E4, + 0x1E5, + 0x1E6, + 0x1E7, + 0x1E8, + 0x1E9, + 0x1EA, + 0x1EB, + 0x1EC, + 0x1ED, + 0x1EE, + 0x1EF, + 0x1F1, + 0x1F4, + 0x1F5, + 0x1F6, + 0x1F7, + 0x1F8, + 0x1F9, + 0x1FA, + 0x1FB, + 0x1FC, + 0x1FD, + 0x1FE, + 0x1FF, + 0x200, + 0x201, + 0x202, + 0x203, + 0x204, + 0x205, + 0x206, + 0x207, + 0x208, + 0x209, + 0x20A, + 0x20B, + 0x20C, + 0x20D, + 0x20E, + 0x20F, + 0x210, + 0x211, + 0x212, + 0x213, + 0x214, + 0x215, + 0x216, + 0x217, + 0x218, + 0x219, + 0x21A, + 0x21B, + 0x21C, + 0x21D, + 0x21E, + 0x21F, + 0x220, + 0x221, + 0x222, + 0x223, + 0x224, + 0x225, + 0x226, + 0x227, + 0x228, + 0x229, + 0x22A, + 0x22B, + 0x22C, + 0x22D, + 0x22E, + 0x22F, + 0x230, + 0x231, + 0x232, + 0x233, + 0x23A, + 0x23B, + 0x23C, + 0x23D, + 0x23E, + 0x23F, + 0x241, + 0x242, + 0x243, + 0x244, + 0x245, + 0x246, + 0x247, + 0x248, + 0x249, + 0x24A, + 0x24B, + 0x24C, + 0x24D, + 0x24E, + 0x24F, + 0x2B0, + 0x2B1, + 0x2B2, + 0x2B3, + 0x2B4, + 0x2B5, + 0x2B6, + 0x2B7, + 0x2B8, + 0x2B9, + 0x2D8, + 0x2D9, + 0x2DA, + 0x2DB, + 0x2DC, + 0x2DD, + 0x2DE, + 0x2E0, + 0x2E1, + 0x2E2, + 0x2E3, + 0x2E4, + 0x2E5, + 0x340, + 0x341, + 0x342, + 0x343, + 0x344, + 0x345, + 0x346, + 0x34F, + 0x350, + 0x370, + 0x371, + 0x372, + 0x373, + 0x374, + 0x375, + 0x376, + 0x377, + 0x378, + 0x37A, + 0x37B, + 0x37E, + 0x37F, + 0x380, + 0x384, + 0x385, + 0x386, + 0x387, + 0x388, + 0x389, + 0x38A, + 0x38B, + 0x38C, + 0x38D, + 0x38E, + 0x38F, + 0x390, + 0x391, + 0x392, + 0x393, + 0x394, + 0x395, + 0x396, + 0x397, + 0x398, + 0x399, + 0x39A, + 0x39B, + 0x39C, + 0x39D, + 0x39E, + 0x39F, + 0x3A0, + 0x3A1, + 0x3A2, + 0x3A3, + 0x3A4, + 0x3A5, + 0x3A6, + 0x3A7, + 0x3A8, + 0x3A9, + 0x3AA, + 0x3AB, + 0x3AC, + 0x3C2, + 0x3C3, + 0x3CF, + 0x3D0, + 0x3D1, + 0x3D2, + 0x3D3, + 0x3D4, + 0x3D5, + 0x3D6, + 0x3D7, + 0x3D8, + 0x3D9, + 0x3DA, + 0x3DB, + 0x3DC, + 0x3DD, + 0x3DE, + 0x3DF, + 0x3E0, + 0x3E1, + 0x3E2, + 0x3E3, + 0x3E4, + 0x3E5, + 0x3E6, + 0x3E7, + 0x3E8, + 0x3E9, + 0x3EA, + 0x3EB, + 0x3EC, + 0x3ED, + 0x3EE, + 0x3EF, + 0x3F0, + 0x3F1, + 0x3F2, + 0x3F3, + 0x3F4, + 0x3F5, + 0x3F6, + 0x3F7, + 0x3F8, + 0x3F9, + 0x3FA, + 0x3FB, + 0x3FD, + 0x3FE, + 0x3FF, + 0x400, + 0x401, + 0x402, + 0x403, + 0x404, + 0x405, + 0x406, + 0x407, + 0x408, + 0x409, + 0x40A, + 0x40B, + 0x40C, + 0x40D, + 0x40E, + 0x40F, + 0x410, + 0x411, + 0x412, + 0x413, + 0x414, + 0x415, + 0x416, + 0x417, + 0x418, + 0x419, + 0x41A, + 0x41B, + 0x41C, + 0x41D, + 0x41E, + 0x41F, + 0x420, + 0x421, + 0x422, + 0x423, + 0x424, + 0x425, + 0x426, + 0x427, + 0x428, + 0x429, + 0x42A, + 0x42B, + 0x42C, + 0x42D, + 0x42E, + 0x42F, + 0x430, + 0x460, + 0x461, + 0x462, + 0x463, + 0x464, + 0x465, + 0x466, + 0x467, + 0x468, + 0x469, + 0x46A, + 0x46B, + 0x46C, + 0x46D, + 0x46E, + 0x46F, + 0x470, + 0x471, + 0x472, + 0x473, + 0x474, + 0x475, + 0x476, + 0x477, + 0x478, + 0x479, + 0x47A, + 0x47B, + 0x47C, + 0x47D, + 0x47E, + 0x47F, + 0x480, + 0x481, + 0x48A, + 0x48B, + 0x48C, + 0x48D, + 0x48E, + 0x48F, + 0x490, + 0x491, + 0x492, + 0x493, + 0x494, + 0x495, + 0x496, + 0x497, + 0x498, + 0x499, + 0x49A, + 0x49B, + 0x49C, + 0x49D, + 0x49E, + 0x49F, + 0x4A0, + 0x4A1, + 0x4A2, + 0x4A3, + 0x4A4, + 0x4A5, + 0x4A6, + 0x4A7, + 0x4A8, + 0x4A9, + 0x4AA, + 0x4AB, + 0x4AC, + 0x4AD, + 0x4AE, + 0x4AF, + 0x4B0, + 0x4B1, + 0x4B2, + 0x4B3, + 0x4B4, + 0x4B5, + 0x4B6, + 0x4B7, + 0x4B8, + 0x4B9, + 0x4BA, + 0x4BB, + 0x4BC, + 0x4BD, + 0x4BE, + 0x4BF, + 0x4C0, + 0x4C1, + 0x4C2, + 0x4C3, + 0x4C4, + 0x4C5, + 0x4C6, + 0x4C7, + 0x4C8, + 0x4C9, + 0x4CA, + 0x4CB, + 0x4CC, + 0x4CD, + 0x4CE, + 0x4D0, + 0x4D1, + 0x4D2, + 0x4D3, + 0x4D4, + 0x4D5, + 0x4D6, + 0x4D7, + 0x4D8, + 0x4D9, + 0x4DA, + 0x4DB, + 0x4DC, + 0x4DD, + 0x4DE, + 0x4DF, + 0x4E0, + 0x4E1, + 0x4E2, + 0x4E3, + 0x4E4, + 0x4E5, + 0x4E6, + 0x4E7, + 0x4E8, + 0x4E9, + 0x4EA, + 0x4EB, + 0x4EC, + 0x4ED, + 0x4EE, + 0x4EF, + 0x4F0, + 0x4F1, + 0x4F2, + 0x4F3, + 0x4F4, + 0x4F5, + 0x4F6, + 0x4F7, + 0x4F8, + 0x4F9, + 0x4FA, + 0x4FB, + 0x4FC, + 0x4FD, + 0x4FE, + 0x4FF, + 0x500, + 0x501, + 0x502, + 0x503, + 0x504, + 0x505, + 0x506, + 0x507, + 0x508, + 0x509, + 0x50A, + 0x50B, + 0x50C, + 0x50D, + 0x50E, + 0x50F, + 0x510, + 0x511, + 0x512, + 0x513, + 0x514, + 0x515, + 0x516, + 0x517, + 0x518, + 0x519, + 0x51A, + 0x51B, + 0x51C, + 0x51D, + 0x51E, + 0x51F, + 0x520, + 0x521, + 0x522, + 0x523, + 0x524, + 0x525, + 0x526, + 0x527, + 0x528, + 0x529, + 0x52A, + 0x52B, + 0x52C, + 0x52D, + 0x52E, + 0x52F, + 0x530, + 0x531, + 0x532, + 0x533, + 0x534, + 0x535, + 0x536, + 0x537, + 0x538, + 0x539, + 0x53A, + 0x53B, + 0x53C, + 0x53D, + 0x53E, + 0x53F, + 0x540, + 0x541, + 0x542, + 0x543, + 0x544, + 0x545, + 0x546, + 0x547, + 0x548, + 0x549, + 0x54A, + 0x54B, + 0x54C, + 0x54D, + 0x54E, + 0x54F, + 0x550, + 0x551, + 0x552, + 0x553, + 0x554, + 0x555, + 0x556, + 0x557, + 0x558, + 0x559, + 0x587, + 0x588, + 0x58B, + 0x58C, + 0x58D, + 0x590, + 0x591, + 0x5CA, + 0x5D0, + 0x5EB, + 0x5EF, + 0x5F5, + 0x606, + 0x61C, + 0x61D, + 0x675, + 0x676, + 0x677, + 0x678, + 0x679, + 0x6DD, + 0x6DE, + 0x70E, + 0x710, + 0x74B, + 0x74D, + 0x7B2, + 0x7C0, + 0x7FB, + 0x7FD, + 0x82E, + 0x830, + 0x83F, + 0x840, + 0x85C, + 0x85E, + 0x85F, + 0x860, + 0x86B, + 0x870, + 0x890, + 0x897, + 0x8E2, + 0x8E3, + 0x958, + 0x959, + 0x95A, + 0x95B, + 0x95C, + 0x95D, + 0x95E, + 0x95F, + 0x960, + 0x984, + 0x985, + 0x98D, + 0x98F, + 0x991, + 0x993, + 0x9A9, + 0x9AA, + 0x9B1, + 0x9B2, + 0x9B3, + 0x9B6, + 0x9BA, + 0x9BC, + 0x9C5, + 0x9C7, + 0x9C9, + 0x9CB, + 0x9CF, + 0x9D7, + 0x9D8, + 0x9DC, + 0x9DD, + 0x9DE, + 0x9DF, + 0x9E0, + 0x9E4, + 0x9E6, + 0x9FF, + 0xA01, + 0xA04, + 0xA05, + 0xA0B, + 0xA0F, + 0xA11, + 0xA13, + 0xA29, + 0xA2A, + 0xA31, + 0xA32, + 0xA33, + 0xA34, + 0xA35, + 0xA36, + 0xA37, + 0xA38, + 0xA3A, + 0xA3C, + 0xA3D, + 0xA3E, + 0xA43, + 0xA47, + 0xA49, + 0xA4B, + 0xA4E, + 0xA51, + 0xA52, + 0xA59, + 0xA5A, + 0xA5B, + 0xA5C, + 0xA5D, + 0xA5E, + 0xA5F, + 0xA66, + 0xA77, + 0xA81, + 0xA84, + 0xA85, + 0xA8E, + 0xA8F, + 0xA92, + 0xA93, + 0xAA9, + 0xAAA, + 0xAB1, + 0xAB2, + 0xAB4, + 0xAB5, + 0xABA, + 0xABC, + 0xAC6, + 0xAC7, + 0xACA, + 0xACB, + 0xACE, + 0xAD0, + 0xAD1, + 0xAE0, + 0xAE4, + 0xAE6, + 0xAF2, + 0xAF9, + 0xB00, + 0xB01, + 0xB04, + 0xB05, + 0xB0D, + 0xB0F, + 0xB11, + 0xB13, + 0xB29, + 0xB2A, + 0xB31, + 0xB32, + 0xB34, + 0xB35, + 0xB3A, + 0xB3C, + 0xB45, + 0xB47, + 0xB49, + 0xB4B, + 0xB4E, + 0xB53, + 0xB58, + 0xB5C, + 0xB5D, + 0xB5E, + 0xB5F, + 0xB64, + 0xB66, + 0xB78, + 0xB82, + 0xB84, + 0xB85, + 0xB8B, + 0xB8E, + 0xB91, + 0xB92, + 0xB96, + 0xB99, + 0xB9B, + 0xB9C, + 0xB9D, + 0xB9E, + 0xBA0, + 0xBA3, + 0xBA5, + 0xBA8, + 0xBAB, + 0xBAE, + 0xBBA, + 0xBBE, + 0xBC3, + 0xBC6, + 0xBC9, + 0xBCA, + 0xBCE, + 0xBD0, + 0xBD1, + 0xBD7, + 0xBD8, + 0xBE6, + 0xBFB, + 0xC00, + 0xC0D, + 0xC0E, + 0xC11, + 0xC12, + 0xC29, + 0xC2A, + 0xC3A, + 0xC3C, + 0xC45, + 0xC46, + 0xC49, + 0xC4A, + 0xC4E, + 0xC55, + 0xC57, + 0xC58, + 0xC5B, + 0xC5C, + 0xC5E, + 0xC60, + 0xC64, + 0xC66, + 0xC70, + 0xC77, + 0xC8D, + 0xC8E, + 0xC91, + 0xC92, + 0xCA9, + 0xCAA, + 0xCB4, + 0xCB5, + 0xCBA, + 0xCBC, + 0xCC5, + 0xCC6, + 0xCC9, + 0xCCA, + 0xCCE, + 0xCD5, + 0xCD7, + 0xCDC, + 0xCDF, + 0xCE0, + 0xCE4, + 0xCE6, + 0xCF0, + 0xCF1, + 0xCF4, + 0xD00, + 0xD0D, + 0xD0E, + 0xD11, + 0xD12, + 0xD45, + 0xD46, + 0xD49, + 0xD4A, + 0xD50, + 0xD54, + 0xD64, + 0xD66, + 0xD80, + 0xD81, + 0xD84, + 0xD85, + 0xD97, + 0xD9A, + 0xDB2, + 0xDB3, + 0xDBC, + 0xDBD, + 0xDBE, + 0xDC0, + 0xDC7, + 0xDCA, + 0xDCB, + 0xDCF, + 0xDD5, + 0xDD6, + 0xDD7, + 0xDD8, + 0xDE0, + 0xDE6, + 0xDF0, + 0xDF2, + 0xDF5, + 0xE01, + 0xE33, + 0xE34, + 0xE3B, + 0xE3F, + 0xE5C, + 0xE81, + 0xE83, + 0xE84, + 0xE85, + 0xE86, + 0xE8B, + 0xE8C, + 0xEA4, + 0xEA5, + 0xEA6, + 0xEA7, + 0xEB3, + 0xEB4, + 0xEBE, + 0xEC0, + 0xEC5, + 0xEC6, + 0xEC7, + 0xEC8, + 0xECF, + 0xED0, + 0xEDA, + 0xEDC, + 0xEDD, + 0xEDE, + 0xEE0, + 0xF00, + 0xF0C, + 0xF0D, + 0xF43, + 0xF44, + 0xF48, + 0xF49, + 0xF4D, + 0xF4E, + 0xF52, + 0xF53, + 0xF57, + 0xF58, + 0xF5C, + 0xF5D, + 0xF69, + 0xF6A, + 0xF6D, + 0xF71, + 0xF73, + 0xF74, + 0xF75, + 0xF76, + 0xF77, + 0xF78, + 0xF79, + 0xF7A, + 0xF81, + 0xF82, + 0xF93, + 0xF94, + 0xF98, + 0xF99, + 0xF9D, + 0xF9E, + 0xFA2, + 0xFA3, + 0xFA7, + 0xFA8, + 0xFAC, + 0xFAD, + 0xFB9, + 0xFBA, + 0xFBD, + 0xFBE, + 0xFCD, + 0xFCE, + 0xFDB, + 0x1000, + 0x10A0, + 0x10A1, + 0x10A2, + 0x10A3, + 0x10A4, + 0x10A5, + 0x10A6, + 0x10A7, + 0x10A8, + 0x10A9, + 0x10AA, + 0x10AB, + 0x10AC, + 0x10AD, + 0x10AE, + 0x10AF, + 0x10B0, + 0x10B1, + 0x10B2, + 0x10B3, + 0x10B4, + 0x10B5, + 0x10B6, + 0x10B7, + 0x10B8, + 0x10B9, + 0x10BA, + 0x10BB, + 0x10BC, + 0x10BD, + 0x10BE, + 0x10BF, + 0x10C0, + 0x10C1, + 0x10C2, + 0x10C3, + 0x10C4, + 0x10C5, + 0x10C6, + 0x10C7, + 0x10C8, + 0x10CD, + 0x10CE, + 0x10D0, + 0x10FC, + 0x10FD, + 0x115F, + 0x1161, + 0x1249, + 0x124A, + 0x124E, + 0x1250, + 0x1257, + 0x1258, + 0x1259, + 0x125A, + 0x125E, + 0x1260, + 0x1289, + 0x128A, + 0x128E, + 0x1290, + 0x12B1, + 0x12B2, + 0x12B6, + 0x12B8, + 0x12BF, + 0x12C0, + 0x12C1, + 0x12C2, + 0x12C6, + 0x12C8, + 0x12D7, + 0x12D8, + 0x1311, + 0x1312, + 0x1316, + 0x1318, + 0x135B, + 0x135D, + 0x137D, + 0x1380, + 0x139A, + 0x13A0, + 0x13F6, + 0x13F8, + 0x13F9, + 0x13FA, + 0x13FB, + 0x13FC, + 0x13FD, + 0x13FE, + 0x1400, + 0x1680, + 0x1681, + 0x169D, + 0x16A0, + 0x16F9, + 0x1700, + 0x1716, + 0x171F, + 0x1737, + 0x1740, + 0x1754, + 0x1760, + 0x176D, + 0x176E, + 0x1771, + 0x1772, + 0x1774, + 0x1780, + 0x17B4, + 0x17B6, + 0x17DE, + 0x17E0, + 0x17EA, + 0x17F0, + 0x17FA, + 0x1800, + 0x180B, + 0x1810, + 0x181A, + 0x1820, + 0x1879, + 0x1880, + 0x18AB, + 0x18B0, + 0x18F6, + 0x1900, + 0x191F, + 0x1920, + 0x192C, + 0x1930, + 0x193C, + 0x1940, + 0x1941, + 0x1944, + 0x196E, + 0x1970, + 0x1975, + 0x1980, + 0x19AC, + 0x19B0, + 0x19CA, + 0x19D0, + 0x19DB, + 0x19DE, + 0x1A1C, + 0x1A1E, + 0x1A5F, + 0x1A60, + 0x1A7D, + 0x1A7F, + 0x1A8A, + 0x1A90, + 0x1A9A, + 0x1AA0, + 0x1AAE, + 0x1AB0, + 0x1AF1, + 0x1B00, + 0x1B4D, + 0x1B4E, + 0x1BF4, + 0x1BFC, + 0x1C38, + 0x1C3B, + 0x1C4A, + 0x1C4D, + 0x1C80, + 0x1C81, + 0x1C82, + 0x1C83, + 0x1C84, + 0x1C86, + 0x1C87, + 0x1C88, + 0x1C89, + 0x1C8A, + 0x1C8B, + 0x1C90, + 0x1C91, + 0x1C92, + 0x1C93, + 0x1C94, + 0x1C95, + 0x1C96, + 0x1C97, + 0x1C98, + 0x1C99, + 0x1C9A, + 0x1C9B, + 0x1C9C, + 0x1C9D, + 0x1C9E, + 0x1C9F, + 0x1CA0, + 0x1CA1, + 0x1CA2, + 0x1CA3, + 0x1CA4, + 0x1CA5, + 0x1CA6, + 0x1CA7, + 0x1CA8, + 0x1CA9, + 0x1CAA, + 0x1CAB, + 0x1CAC, + 0x1CAD, + 0x1CAE, + 0x1CAF, + 0x1CB0, + 0x1CB1, + 0x1CB2, + 0x1CB3, + 0x1CB4, + 0x1CB5, + 0x1CB6, + 0x1CB7, + 0x1CB8, + 0x1CB9, + 0x1CBA, + 0x1CBB, + 0x1CBD, + 0x1CBE, + 0x1CBF, + 0x1CC0, + 0x1CC8, + 0x1CD0, + 0x1CFB, + 0x1D00, + 0x1D2C, + 0x1D2D, + 0x1D2E, + 0x1D2F, + 0x1D30, + 0x1D31, + 0x1D32, + 0x1D33, + 0x1D34, + 0x1D35, + 0x1D36, + 0x1D37, + 0x1D38, + 0x1D39, + 0x1D3A, + 0x1D3B, + 0x1D3C, + 0x1D3D, + 0x1D3E, + 0x1D3F, + 0x1D40, + 0x1D41, + 0x1D42, + 0x1D43, + 0x1D44, + 0x1D45, + 0x1D46, + 0x1D47, + 0x1D48, + 0x1D49, + 0x1D4A, + 0x1D4B, + 0x1D4C, + 0x1D4D, + 0x1D4E, + 0x1D4F, + 0x1D50, + 0x1D51, + 0x1D52, + 0x1D53, + 0x1D54, + 0x1D55, + 0x1D56, + 0x1D57, + 0x1D58, + 0x1D59, + 0x1D5A, + 0x1D5B, + 0x1D5C, + 0x1D5D, + 0x1D5E, + 0x1D5F, + 0x1D60, + 0x1D61, + 0x1D62, + 0x1D63, + 0x1D64, + 0x1D65, + 0x1D66, + 0x1D67, + 0x1D68, + 0x1D69, + 0x1D6A, + 0x1D6B, + 0x1D78, + 0x1D79, + 0x1D9B, + 0x1D9C, + 0x1D9D, + 0x1D9E, + 0x1D9F, + 0x1DA0, + 0x1DA1, + 0x1DA2, + 0x1DA3, + 0x1DA4, + 0x1DA5, + 0x1DA6, + 0x1DA7, + 0x1DA8, + 0x1DA9, + 0x1DAA, + 0x1DAB, + 0x1DAC, + 0x1DAD, + 0x1DAE, + 0x1DAF, + 0x1DB0, + 0x1DB1, + 0x1DB2, + 0x1DB3, + 0x1DB4, + 0x1DB5, + 0x1DB6, + 0x1DB7, + 0x1DB8, + 0x1DB9, + 0x1DBA, + 0x1DBB, + 0x1DBC, + 0x1DBD, + 0x1DBE, + 0x1DBF, + 0x1DC0, + 0x1E00, + 0x1E01, + 0x1E02, + 0x1E03, + 0x1E04, + 0x1E05, + 0x1E06, + 0x1E07, + 0x1E08, + 0x1E09, + 0x1E0A, + 0x1E0B, + 0x1E0C, + 0x1E0D, + 0x1E0E, + 0x1E0F, + 0x1E10, + 0x1E11, + 0x1E12, + 0x1E13, + 0x1E14, + 0x1E15, + 0x1E16, + 0x1E17, + 0x1E18, + 0x1E19, + 0x1E1A, + 0x1E1B, + 0x1E1C, + 0x1E1D, + 0x1E1E, + 0x1E1F, + 0x1E20, + 0x1E21, + 0x1E22, + 0x1E23, + 0x1E24, + 0x1E25, + 0x1E26, + 0x1E27, + 0x1E28, + 0x1E29, + 0x1E2A, + 0x1E2B, + 0x1E2C, + 0x1E2D, + 0x1E2E, + 0x1E2F, + 0x1E30, + 0x1E31, + 0x1E32, + 0x1E33, + 0x1E34, + 0x1E35, + 0x1E36, + 0x1E37, + 0x1E38, + 0x1E39, + 0x1E3A, + 0x1E3B, + 0x1E3C, + 0x1E3D, + 0x1E3E, + 0x1E3F, + 0x1E40, + 0x1E41, + 0x1E42, + 0x1E43, + 0x1E44, + 0x1E45, + 0x1E46, + 0x1E47, + 0x1E48, + 0x1E49, + 0x1E4A, + 0x1E4B, + 0x1E4C, + 0x1E4D, + 0x1E4E, + 0x1E4F, + 0x1E50, + 0x1E51, + 0x1E52, + 0x1E53, + 0x1E54, + 0x1E55, + 0x1E56, + 0x1E57, + 0x1E58, + 0x1E59, + 0x1E5A, + 0x1E5B, + 0x1E5C, + 0x1E5D, + 0x1E5E, + 0x1E5F, + 0x1E60, + 0x1E61, + 0x1E62, + 0x1E63, + 0x1E64, + 0x1E65, + 0x1E66, + 0x1E67, + 0x1E68, + 0x1E69, + 0x1E6A, + 0x1E6B, + 0x1E6C, + 0x1E6D, + 0x1E6E, + 0x1E6F, + 0x1E70, + 0x1E71, + 0x1E72, + 0x1E73, + 0x1E74, + 0x1E75, + 0x1E76, + 0x1E77, + 0x1E78, + 0x1E79, + 0x1E7A, + 0x1E7B, + 0x1E7C, + 0x1E7D, + 0x1E7E, + 0x1E7F, + 0x1E80, + 0x1E81, + 0x1E82, + 0x1E83, + 0x1E84, + 0x1E85, + 0x1E86, + 0x1E87, + 0x1E88, + 0x1E89, + 0x1E8A, + 0x1E8B, + 0x1E8C, + 0x1E8D, + 0x1E8E, + 0x1E8F, + 0x1E90, + 0x1E91, + 0x1E92, + 0x1E93, + 0x1E94, + 0x1E95, + 0x1E9A, + 0x1E9B, + 0x1E9C, + 0x1E9E, + 0x1E9F, + 0x1EA0, + 0x1EA1, + 0x1EA2, + 0x1EA3, + 0x1EA4, + 0x1EA5, + 0x1EA6, + 0x1EA7, + 0x1EA8, + 0x1EA9, + 0x1EAA, + 0x1EAB, + 0x1EAC, + 0x1EAD, + 0x1EAE, + 0x1EAF, + 0x1EB0, + 0x1EB1, + 0x1EB2, + 0x1EB3, + 0x1EB4, + 0x1EB5, + 0x1EB6, + 0x1EB7, + 0x1EB8, + 0x1EB9, + 0x1EBA, + 0x1EBB, + 0x1EBC, + 0x1EBD, + 0x1EBE, + 0x1EBF, + 0x1EC0, + 0x1EC1, + 0x1EC2, + 0x1EC3, + 0x1EC4, + 0x1EC5, + 0x1EC6, + 0x1EC7, + 0x1EC8, + 0x1EC9, + 0x1ECA, + 0x1ECB, + 0x1ECC, + 0x1ECD, + 0x1ECE, + 0x1ECF, + 0x1ED0, + 0x1ED1, + 0x1ED2, + 0x1ED3, + 0x1ED4, + 0x1ED5, + 0x1ED6, + 0x1ED7, + 0x1ED8, + 0x1ED9, + 0x1EDA, + 0x1EDB, + 0x1EDC, + 0x1EDD, + 0x1EDE, + 0x1EDF, + 0x1EE0, + 0x1EE1, + 0x1EE2, + 0x1EE3, + 0x1EE4, + 0x1EE5, + 0x1EE6, + 0x1EE7, + 0x1EE8, + 0x1EE9, + 0x1EEA, + 0x1EEB, + 0x1EEC, + 0x1EED, + 0x1EEE, + 0x1EEF, + 0x1EF0, + 0x1EF1, + 0x1EF2, + 0x1EF3, + 0x1EF4, + 0x1EF5, + 0x1EF6, + 0x1EF7, + 0x1EF8, + 0x1EF9, + 0x1EFA, + 0x1EFB, + 0x1EFC, + 0x1EFD, + 0x1EFE, + 0x1EFF, + 0x1F08, + 0x1F09, + 0x1F0A, + 0x1F0B, + 0x1F0C, + 0x1F0D, + 0x1F0E, + 0x1F0F, + 0x1F10, + 0x1F16, + 0x1F18, + 0x1F19, + 0x1F1A, + 0x1F1B, + 0x1F1C, + 0x1F1D, + 0x1F1E, + 0x1F20, + 0x1F28, + 0x1F29, + 0x1F2A, + 0x1F2B, + 0x1F2C, + 0x1F2D, + 0x1F2E, + 0x1F2F, + 0x1F30, + 0x1F38, + 0x1F39, + 0x1F3A, + 0x1F3B, + 0x1F3C, + 0x1F3D, + 0x1F3E, + 0x1F3F, + 0x1F40, + 0x1F46, + 0x1F48, + 0x1F49, + 0x1F4A, + 0x1F4B, + 0x1F4C, + 0x1F4D, + 0x1F4E, + 0x1F50, + 0x1F58, + 0x1F59, + 0x1F5A, + 0x1F5B, + 0x1F5C, + 0x1F5D, + 0x1F5E, + 0x1F5F, + 0x1F60, + 0x1F68, + 0x1F69, + 0x1F6A, + 0x1F6B, + 0x1F6C, + 0x1F6D, + 0x1F6E, + 0x1F6F, + 0x1F70, + 0x1F71, + 0x1F72, + 0x1F73, + 0x1F74, + 0x1F75, + 0x1F76, + 0x1F77, + 0x1F78, + 0x1F79, + 0x1F7A, + 0x1F7B, + 0x1F7C, + 0x1F7D, + 0x1F7E, + 0x1F80, + 0x1F81, + 0x1F82, + 0x1F83, + 0x1F84, + 0x1F85, + 0x1F86, + 0x1F87, + 0x1F88, + 0x1F89, + 0x1F8A, + 0x1F8B, + 0x1F8C, + 0x1F8D, + 0x1F8E, + 0x1F8F, + 0x1F90, + 0x1F91, + 0x1F92, + 0x1F93, + 0x1F94, + 0x1F95, + 0x1F96, + 0x1F97, + 0x1F98, + 0x1F99, + 0x1F9A, + 0x1F9B, + 0x1F9C, + 0x1F9D, + 0x1F9E, + 0x1F9F, + 0x1FA0, + 0x1FA1, + 0x1FA2, + 0x1FA3, + 0x1FA4, + 0x1FA5, + 0x1FA6, + 0x1FA7, + 0x1FA8, + 0x1FA9, + 0x1FAA, + 0x1FAB, + 0x1FAC, + 0x1FAD, + 0x1FAE, + 0x1FAF, + 0x1FB0, + 0x1FB2, + 0x1FB3, + 0x1FB4, + 0x1FB5, + 0x1FB6, + 0x1FB7, + 0x1FB8, + 0x1FB9, + 0x1FBA, + 0x1FBB, + 0x1FBC, + 0x1FBD, + 0x1FBE, + 0x1FBF, + 0x1FC0, + 0x1FC1, + 0x1FC2, + 0x1FC3, + 0x1FC4, + 0x1FC5, + 0x1FC6, + 0x1FC7, + 0x1FC8, + 0x1FC9, + 0x1FCA, + 0x1FCB, + 0x1FCC, + 0x1FCD, + 0x1FCE, + 0x1FCF, + 0x1FD0, + 0x1FD3, + 0x1FD4, + 0x1FD6, + 0x1FD8, + 0x1FD9, + 0x1FDA, + 0x1FDB, + 0x1FDC, + 0x1FDD, + 0x1FDE, + 0x1FDF, + 0x1FE0, + 0x1FE3, + 0x1FE4, + 0x1FE8, + 0x1FE9, + 0x1FEA, + 0x1FEB, + 0x1FEC, + 0x1FED, + 0x1FEE, + 0x1FEF, + 0x1FF0, + 0x1FF2, + 0x1FF3, + 0x1FF4, + 0x1FF5, + 0x1FF6, + 0x1FF7, + 0x1FF8, + 0x1FF9, + 0x1FFA, + 0x1FFB, + 0x1FFC, + 0x1FFD, + 0x1FFE, + 0x1FFF, + 0x2000, + 0x200B, + 0x200C, + 0x200E, + 0x2010, + 0x2011, + 0x2012, + 0x2017, + 0x2018, + 0x2024, + 0x2027, + 0x2028, + 0x202F, + 0x2030, + 0x2033, + 0x2034, + 0x2035, + 0x2036, + 0x2037, + 0x2038, + 0x203C, + 0x203D, + 0x203E, + 0x203F, + 0x2047, + 0x2048, + 0x2049, + 0x204A, + 0x2057, + 0x2058, + 0x205F, + 0x2060, + 0x2065, + 0x206A, + 0x2070, + 0x2071, + 0x2072, + 0x2074, + 0x2075, + 0x2076, + 0x2077, + 0x2078, + 0x2079, + 0x207A, + 0x207B, + 0x207C, + 0x207D, + 0x207E, + 0x207F, + 0x2080, + 0x2081, + 0x2082, + 0x2083, + 0x2084, + 0x2085, + 0x2086, + 0x2087, + 0x2088, + 0x2089, + 0x208A, + 0x208B, + 0x208C, + 0x208D, + 0x208E, + 0x208F, + 0x2090, + 0x2091, + 0x2092, + 0x2093, + 0x2094, + 0x2095, + 0x2096, + 0x2097, + 0x2098, + 0x2099, + 0x209A, + 0x209B, + 0x209C, + 0x209D, + 0x209E, + 0x209F, + 0x20A0, + 0x20A8, + 0x20A9, + 0x20C5, + 0x20D0, + 0x20F1, + 0x2100, + 0x2101, + 0x2102, + 0x2103, + 0x2104, + 0x2105, + 0x2106, + 0x2107, + 0x2108, + 0x2109, + 0x210A, + 0x210B, + 0x210F, + 0x2110, + 0x2112, + 0x2114, + 0x2115, + 0x2116, + 0x2117, + 0x2119, + 0x211A, + 0x211B, + 0x211E, + 0x2120, + 0x2121, + 0x2122, + 0x2123, + 0x2124, + 0x2125, + 0x2126, + 0x2127, + 0x2128, + 0x2129, + 0x212A, + 0x212B, + 0x212C, + 0x212D, + 0x212E, + 0x212F, + 0x2131, + 0x2132, + 0x2133, + 0x2134, + 0x2135, + 0x2136, + 0x2137, + 0x2138, + 0x2139, + 0x213A, + 0x213B, + 0x213C, + 0x213D, + 0x213F, + 0x2140, + 0x2141, + 0x2145, + 0x2147, + 0x2148, + 0x2149, + 0x214A, + 0x2150, + 0x2151, + 0x2152, + 0x2153, + 0x2154, + 0x2155, + 0x2156, + 0x2157, + 0x2158, + 0x2159, + 0x215A, + 0x215B, + 0x215C, + 0x215D, + 0x215E, + 0x215F, + 0x2160, + 0x2161, + 0x2162, + 0x2163, + 0x2164, + 0x2165, + 0x2166, + 0x2167, + 0x2168, + 0x2169, + 0x216A, + 0x216B, + 0x216C, + 0x216D, + 0x216E, + 0x216F, + 0x2170, + 0x2171, + 0x2172, + 0x2173, + 0x2174, + 0x2175, + 0x2176, + 0x2177, + 0x2178, + 0x2179, + 0x217A, + 0x217B, + 0x217C, + 0x217D, + 0x217E, + 0x217F, + 0x2180, + 0x2183, + 0x2184, + 0x2189, + 0x218A, + 0x218C, + 0x2190, + 0x222C, + 0x222D, + 0x222E, + 0x222F, + 0x2230, + 0x2231, + 0x2329, + 0x232A, + 0x232B, + 0x242A, + 0x2440, + 0x244B, + 0x2460, + 0x2461, + 0x2462, + 0x2463, + 0x2464, + 0x2465, + 0x2466, + 0x2467, + 0x2468, + 0x2469, + 0x246A, + 0x246B, + 0x246C, + 0x246D, + 0x246E, + 0x246F, + 0x2470, + 0x2471, + 0x2472, + 0x2473, + 0x2474, + 0x2475, + 0x2476, + 0x2477, + 0x2478, + 0x2479, + 0x247A, + 0x247B, + 0x247C, + 0x247D, + 0x247E, + 0x247F, + 0x2480, + 0x2481, + 0x2482, + 0x2483, + 0x2484, + 0x2485, + 0x2486, + 0x2487, + 0x2488, + 0x249C, + 0x249D, + 0x249E, + 0x249F, + 0x24A0, + 0x24A1, + 0x24A2, + 0x24A3, + 0x24A4, + 0x24A5, + 0x24A6, + 0x24A7, + 0x24A8, + 0x24A9, + 0x24AA, + 0x24AB, + 0x24AC, + 0x24AD, + 0x24AE, + 0x24AF, + 0x24B0, + 0x24B1, + 0x24B2, + 0x24B3, + 0x24B4, + 0x24B5, + 0x24B6, + 0x24B7, + 0x24B8, + 0x24B9, + 0x24BA, + 0x24BB, + 0x24BC, + 0x24BD, + 0x24BE, + 0x24BF, + 0x24C0, + 0x24C1, + 0x24C2, + 0x24C3, + 0x24C4, + 0x24C5, + 0x24C6, + 0x24C7, + 0x24C8, + 0x24C9, + 0x24CA, + 0x24CB, + 0x24CC, + 0x24CD, + 0x24CE, + 0x24CF, + 0x24D0, + 0x24D1, + 0x24D2, + 0x24D3, + 0x24D4, + 0x24D5, + 0x24D6, + 0x24D7, + 0x24D8, + 0x24D9, + 0x24DA, + 0x24DB, + 0x24DC, + 0x24DD, + 0x24DE, + 0x24DF, + 0x24E0, + 0x24E1, + 0x24E2, + 0x24E3, + 0x24E4, + 0x24E5, + 0x24E6, + 0x24E7, + 0x24E8, + 0x24E9, + 0x24EA, + 0x24EB, + 0x2A0C, + 0x2A0D, + 0x2A74, + 0x2A75, + 0x2A76, + 0x2A77, + 0x2ADC, + 0x2ADD, + 0x2B74, + 0x2B76, + 0x2C00, + 0x2C01, + 0x2C02, + 0x2C03, + 0x2C04, + 0x2C05, + 0x2C06, + 0x2C07, + 0x2C08, + 0x2C09, + 0x2C0A, + 0x2C0B, + 0x2C0C, + 0x2C0D, + 0x2C0E, + 0x2C0F, + 0x2C10, + 0x2C11, + 0x2C12, + 0x2C13, + 0x2C14, + 0x2C15, + 0x2C16, + 0x2C17, + 0x2C18, + 0x2C19, + 0x2C1A, + 0x2C1B, + 0x2C1C, + 0x2C1D, + 0x2C1E, + 0x2C1F, + 0x2C20, + 0x2C21, + 0x2C22, + 0x2C23, + 0x2C24, + 0x2C25, + 0x2C26, + 0x2C27, + 0x2C28, + 0x2C29, + 0x2C2A, + 0x2C2B, + 0x2C2C, + 0x2C2D, + 0x2C2E, + 0x2C2F, + 0x2C30, + 0x2C60, + 0x2C61, + 0x2C62, + 0x2C63, + 0x2C64, + 0x2C65, + 0x2C67, + 0x2C68, + 0x2C69, + 0x2C6A, + 0x2C6B, + 0x2C6C, + 0x2C6D, + 0x2C6E, + 0x2C6F, + 0x2C70, + 0x2C71, + 0x2C72, + 0x2C73, + 0x2C75, + 0x2C76, + 0x2C7C, + 0x2C7D, + 0x2C7E, + 0x2C7F, + 0x2C80, + 0x2C81, + 0x2C82, + 0x2C83, + 0x2C84, + 0x2C85, + 0x2C86, + 0x2C87, + 0x2C88, + 0x2C89, + 0x2C8A, + 0x2C8B, + 0x2C8C, + 0x2C8D, + 0x2C8E, + 0x2C8F, + 0x2C90, + 0x2C91, + 0x2C92, + 0x2C93, + 0x2C94, + 0x2C95, + 0x2C96, + 0x2C97, + 0x2C98, + 0x2C99, + 0x2C9A, + 0x2C9B, + 0x2C9C, + 0x2C9D, + 0x2C9E, + 0x2C9F, + 0x2CA0, + 0x2CA1, + 0x2CA2, + 0x2CA3, + 0x2CA4, + 0x2CA5, + 0x2CA6, + 0x2CA7, + 0x2CA8, + 0x2CA9, + 0x2CAA, + 0x2CAB, + 0x2CAC, + 0x2CAD, + 0x2CAE, + 0x2CAF, + 0x2CB0, + 0x2CB1, + 0x2CB2, + 0x2CB3, + 0x2CB4, + 0x2CB5, + 0x2CB6, + 0x2CB7, + 0x2CB8, + 0x2CB9, + 0x2CBA, + 0x2CBB, + 0x2CBC, + 0x2CBD, + 0x2CBE, + 0x2CBF, + 0x2CC0, + 0x2CC1, + 0x2CC2, + 0x2CC3, + 0x2CC4, + 0x2CC5, + 0x2CC6, + 0x2CC7, + 0x2CC8, + 0x2CC9, + 0x2CCA, + 0x2CCB, + 0x2CCC, + 0x2CCD, + 0x2CCE, + 0x2CCF, + 0x2CD0, + 0x2CD1, + 0x2CD2, + 0x2CD3, + 0x2CD4, + 0x2CD5, + 0x2CD6, + 0x2CD7, + 0x2CD8, + 0x2CD9, + 0x2CDA, + 0x2CDB, + 0x2CDC, + 0x2CDD, + 0x2CDE, + 0x2CDF, + 0x2CE0, + 0x2CE1, + 0x2CE2, + 0x2CE3, + 0x2CEB, + 0x2CEC, + 0x2CED, + 0x2CEE, + 0x2CF2, + 0x2CF3, + 0x2CF4, + 0x2CF9, + 0x2D26, + 0x2D27, + 0x2D28, + 0x2D2D, + 0x2D2E, + 0x2D30, + 0x2D68, + 0x2D6F, + 0x2D70, + 0x2D71, + 0x2D7F, + 0x2D97, + 0x2DA0, + 0x2DA7, + 0x2DA8, + 0x2DAF, + 0x2DB0, + 0x2DB7, + 0x2DB8, + 0x2DBF, + 0x2DC0, + 0x2DC7, + 0x2DC8, + 0x2DCF, + 0x2DD0, + 0x2DD7, + 0x2DD8, + 0x2DDF, + 0x2DE0, + 0x2E5E, + 0x2E60, + 0x2E64, + 0x2E80, + 0x2E9A, + 0x2E9B, + 0x2E9F, + 0x2EA0, + 0x2EF3, + 0x2EF4, + 0x2F00, + 0x2F01, + 0x2F02, + 0x2F03, + 0x2F04, + 0x2F05, + 0x2F06, + 0x2F07, + 0x2F08, + 0x2F09, + 0x2F0A, + 0x2F0B, + 0x2F0C, + 0x2F0D, + 0x2F0E, + 0x2F0F, + 0x2F10, + 0x2F11, + 0x2F12, + 0x2F13, + 0x2F14, + 0x2F15, + 0x2F16, + 0x2F17, + 0x2F18, + 0x2F19, + 0x2F1A, + 0x2F1B, + 0x2F1C, + 0x2F1D, + 0x2F1E, + 0x2F1F, + 0x2F20, + 0x2F21, + 0x2F22, + 0x2F23, + 0x2F24, + 0x2F25, + 0x2F26, + 0x2F27, + 0x2F28, + 0x2F29, + 0x2F2A, + 0x2F2B, + 0x2F2C, + 0x2F2D, + 0x2F2E, + 0x2F2F, + 0x2F30, + 0x2F31, + 0x2F32, + 0x2F33, + 0x2F34, + 0x2F35, + 0x2F36, + 0x2F37, + 0x2F38, + 0x2F39, + 0x2F3A, + 0x2F3B, + 0x2F3C, + 0x2F3D, + 0x2F3E, + 0x2F3F, + 0x2F40, + 0x2F41, + 0x2F42, + 0x2F43, + 0x2F44, + 0x2F45, + 0x2F46, + 0x2F47, + 0x2F48, + 0x2F49, + 0x2F4A, + 0x2F4B, + 0x2F4C, + 0x2F4D, + 0x2F4E, + 0x2F4F, + 0x2F50, + 0x2F51, + 0x2F52, + 0x2F53, + 0x2F54, + 0x2F55, + 0x2F56, + 0x2F57, + 0x2F58, + 0x2F59, + 0x2F5A, + 0x2F5B, + 0x2F5C, + 0x2F5D, + 0x2F5E, + 0x2F5F, + 0x2F60, + 0x2F61, + 0x2F62, + 0x2F63, + 0x2F64, + 0x2F65, + 0x2F66, + 0x2F67, + 0x2F68, + 0x2F69, + 0x2F6A, + 0x2F6B, + 0x2F6C, + 0x2F6D, + 0x2F6E, + 0x2F6F, + 0x2F70, + 0x2F71, + 0x2F72, + 0x2F73, + 0x2F74, + 0x2F75, + 0x2F76, + 0x2F77, + 0x2F78, + 0x2F79, + 0x2F7A, + 0x2F7B, + 0x2F7C, + 0x2F7D, + 0x2F7E, + 0x2F7F, + 0x2F80, + 0x2F81, + 0x2F82, + 0x2F83, + 0x2F84, + 0x2F85, + 0x2F86, + 0x2F87, + 0x2F88, + 0x2F89, + 0x2F8A, + 0x2F8B, + 0x2F8C, + 0x2F8D, + 0x2F8E, + 0x2F8F, + 0x2F90, + 0x2F91, + 0x2F92, + 0x2F93, + 0x2F94, + 0x2F95, + 0x2F96, + 0x2F97, + 0x2F98, + 0x2F99, + 0x2F9A, + 0x2F9B, + 0x2F9C, + 0x2F9D, + 0x2F9E, + 0x2F9F, + 0x2FA0, + 0x2FA1, + 0x2FA2, + 0x2FA3, + 0x2FA4, + 0x2FA5, + 0x2FA6, + 0x2FA7, + 0x2FA8, + 0x2FA9, + 0x2FAA, + 0x2FAB, + 0x2FAC, + 0x2FAD, + 0x2FAE, + 0x2FAF, + 0x2FB0, + 0x2FB1, + 0x2FB2, + 0x2FB3, + 0x2FB4, + 0x2FB5, + 0x2FB6, + 0x2FB7, + 0x2FB8, + 0x2FB9, + 0x2FBA, + 0x2FBB, + 0x2FBC, + 0x2FBD, + 0x2FBE, + 0x2FBF, + 0x2FC0, + 0x2FC1, + 0x2FC2, + 0x2FC3, + 0x2FC4, + 0x2FC5, + 0x2FC6, + 0x2FC7, + 0x2FC8, + 0x2FC9, + 0x2FCA, + 0x2FCB, + 0x2FCC, + 0x2FCD, + 0x2FCE, + 0x2FCF, + 0x2FD0, + 0x2FD1, + 0x2FD2, + 0x2FD3, + 0x2FD4, + 0x2FD5, + 0x2FD6, + 0x3000, + 0x3001, + 0x3002, + 0x3003, + 0x3036, + 0x3037, + 0x3038, + 0x3039, + 0x303A, + 0x303B, + 0x3040, + 0x3041, + 0x3097, + 0x3099, + 0x309B, + 0x309C, + 0x309D, + 0x309F, + 0x30A0, + 0x30FF, + 0x3100, + 0x3105, + 0x3130, + 0x3131, + 0x3132, + 0x3133, + 0x3134, + 0x3135, + 0x3136, + 0x3137, + 0x3138, + 0x3139, + 0x313A, + 0x313B, + 0x313C, + 0x313D, + 0x313E, + 0x313F, + 0x3140, + 0x3141, + 0x3142, + 0x3143, + 0x3144, + 0x3145, + 0x3146, + 0x3147, + 0x3148, + 0x3149, + 0x314A, + 0x314B, + 0x314C, + 0x314D, + 0x314E, + 0x314F, + 0x3150, + 0x3151, + 0x3152, + 0x3153, + 0x3154, + 0x3155, + 0x3156, + 0x3157, + 0x3158, + 0x3159, + 0x315A, + 0x315B, + 0x315C, + 0x315D, + 0x315E, + 0x315F, + 0x3160, + 0x3161, + 0x3162, + 0x3163, + 0x3164, + 0x3165, + 0x3166, + 0x3167, + 0x3168, + 0x3169, + 0x316A, + 0x316B, + 0x316C, + 0x316D, + 0x316E, + 0x316F, + 0x3170, + 0x3171, + 0x3172, + 0x3173, + 0x3174, + 0x3175, + 0x3176, + 0x3177, + 0x3178, + 0x3179, + 0x317A, + 0x317B, + 0x317C, + 0x317D, + 0x317E, + 0x317F, + 0x3180, + 0x3181, + 0x3182, + 0x3183, + 0x3184, + 0x3185, + 0x3186, + 0x3187, + 0x3188, + 0x3189, + 0x318A, + 0x318B, + 0x318C, + 0x318D, + 0x318E, + 0x318F, + 0x3190, + 0x3192, + 0x3193, + 0x3194, + 0x3195, + 0x3196, + 0x3197, + 0x3198, + 0x3199, + 0x319A, + 0x319B, + 0x319C, + 0x319D, + 0x319E, + 0x319F, + 0x31A0, + 0x31E6, + 0x31F0, + 0x3200, + 0x3201, + 0x3202, + 0x3203, + 0x3204, + 0x3205, + 0x3206, + 0x3207, + 0x3208, + 0x3209, + 0x320A, + 0x320B, + 0x320C, + 0x320D, + 0x320E, + 0x320F, + 0x3210, + 0x3211, + 0x3212, + 0x3213, + 0x3214, + 0x3215, + 0x3216, + 0x3217, + 0x3218, + 0x3219, + 0x321A, + 0x321B, + 0x321C, + 0x321D, + 0x321E, + 0x321F, + 0x3220, + 0x3221, + 0x3222, + 0x3223, + 0x3224, + 0x3225, + 0x3226, + 0x3227, + 0x3228, + 0x3229, + 0x322A, + 0x322B, + 0x322C, + 0x322D, + 0x322E, + 0x322F, + 0x3230, + 0x3231, + 0x3232, + 0x3233, + 0x3234, + 0x3235, + 0x3236, + 0x3237, + 0x3238, + 0x3239, + 0x323A, + 0x323B, + 0x323C, + 0x323D, + 0x323E, + 0x323F, + 0x3240, + 0x3241, + 0x3242, + 0x3243, + 0x3244, + 0x3245, + 0x3246, + 0x3247, + 0x3248, + 0x3250, + 0x3251, + 0x3252, + 0x3253, + 0x3254, + 0x3255, + 0x3256, + 0x3257, + 0x3258, + 0x3259, + 0x325A, + 0x325B, + 0x325C, + 0x325D, + 0x325E, + 0x325F, + 0x3260, + 0x3261, + 0x3262, + 0x3263, + 0x3264, + 0x3265, + 0x3266, + 0x3267, + 0x3268, + 0x3269, + 0x326A, + 0x326B, + 0x326C, + 0x326D, + 0x326E, + 0x326F, + 0x3270, + 0x3271, + 0x3272, + 0x3273, + 0x3274, + 0x3275, + 0x3276, + 0x3277, + 0x3278, + 0x3279, + 0x327A, + 0x327B, + 0x327C, + 0x327D, + 0x327E, + 0x327F, + 0x3280, + 0x3281, + 0x3282, + 0x3283, + 0x3284, + 0x3285, + 0x3286, + 0x3287, + 0x3288, + 0x3289, + 0x328A, + 0x328B, + 0x328C, + 0x328D, + 0x328E, + 0x328F, + 0x3290, + 0x3291, + 0x3292, + 0x3293, + 0x3294, + 0x3295, + 0x3296, + 0x3297, + 0x3298, + 0x3299, + 0x329A, + 0x329B, + 0x329C, + 0x329D, + 0x329E, + 0x329F, + 0x32A0, + 0x32A1, + 0x32A2, + 0x32A3, + 0x32A4, + 0x32A5, + 0x32A6, + 0x32A7, + 0x32A8, + 0x32A9, + 0x32AA, + 0x32AB, + 0x32AC, + 0x32AD, + 0x32AE, + 0x32AF, + 0x32B0, + 0x32B1, + 0x32B2, + 0x32B3, + 0x32B4, + 0x32B5, + 0x32B6, + 0x32B7, + 0x32B8, + 0x32B9, + 0x32BA, + 0x32BB, + 0x32BC, + 0x32BD, + 0x32BE, + 0x32BF, + 0x32C0, + 0x32C1, + 0x32C2, + 0x32C3, + 0x32C4, + 0x32C5, + 0x32C6, + 0x32C7, + 0x32C8, + 0x32C9, + 0x32CA, + 0x32CB, + 0x32CC, + 0x32CD, + 0x32CE, + 0x32CF, + 0x32D0, + 0x32D1, + 0x32D2, + 0x32D3, + 0x32D4, + 0x32D5, + 0x32D6, + 0x32D7, + 0x32D8, + 0x32D9, + 0x32DA, + 0x32DB, + 0x32DC, + 0x32DD, + 0x32DE, + 0x32DF, + 0x32E0, + 0x32E1, + 0x32E2, + 0x32E3, + 0x32E4, + 0x32E5, + 0x32E6, + 0x32E7, + 0x32E8, + 0x32E9, + 0x32EA, + 0x32EB, + 0x32EC, + 0x32ED, + 0x32EE, + 0x32EF, + 0x32F0, + 0x32F1, + 0x32F2, + 0x32F3, + 0x32F4, + 0x32F5, + 0x32F6, + 0x32F7, + 0x32F8, + 0x32F9, + 0x32FA, + 0x32FB, + 0x32FC, + 0x32FD, + 0x32FE, + 0x32FF, + 0x3300, + 0x3301, + 0x3302, + 0x3303, + 0x3304, + 0x3305, + 0x3306, + 0x3307, + 0x3308, + 0x3309, + 0x330A, + 0x330B, + 0x330C, + 0x330D, + 0x330E, + 0x330F, + 0x3310, + 0x3311, + 0x3312, + 0x3313, + 0x3314, + 0x3315, + 0x3316, + 0x3317, + 0x3318, + 0x3319, + 0x331A, + 0x331B, + 0x331C, + 0x331D, + 0x331E, + 0x331F, + 0x3320, + 0x3321, + 0x3322, + 0x3323, + 0x3324, + 0x3325, + 0x3326, + 0x3327, + 0x3328, + 0x3329, + 0x332A, + 0x332B, + 0x332C, + 0x332D, + 0x332E, + 0x332F, + 0x3330, + 0x3331, + 0x3332, + 0x3333, + 0x3334, + 0x3335, + 0x3336, + 0x3337, + 0x3338, + 0x3339, + 0x333A, + 0x333B, + 0x333C, + 0x333D, + 0x333E, + 0x333F, + 0x3340, + 0x3341, + 0x3342, + 0x3343, + 0x3344, + 0x3345, + 0x3346, + 0x3347, + 0x3348, + 0x3349, + 0x334A, + 0x334B, + 0x334C, + 0x334D, + 0x334E, + 0x334F, + 0x3350, + 0x3351, + 0x3352, + 0x3353, + 0x3354, + 0x3355, + 0x3356, + 0x3357, + 0x3358, + 0x3359, + 0x335A, + 0x335B, + 0x335C, + 0x335D, + 0x335E, + 0x335F, + 0x3360, + 0x3361, + 0x3362, + 0x3363, + 0x3364, + 0x3365, + 0x3366, + 0x3367, + 0x3368, + 0x3369, + 0x336A, + 0x336B, + 0x336C, + 0x336D, + 0x336E, + 0x336F, + 0x3370, + 0x3371, + 0x3372, + 0x3373, + 0x3374, + 0x3375, + 0x3376, + 0x3377, + 0x3378, + 0x3379, + 0x337A, + 0x337B, + 0x337C, + 0x337D, + 0x337E, + 0x337F, + 0x3380, + 0x3381, + 0x3382, + 0x3383, + 0x3384, + 0x3385, + 0x3386, + 0x3387, + 0x3388, + 0x3389, + 0x338A, + 0x338B, + 0x338C, + 0x338D, + 0x338E, + 0x338F, + 0x3390, + 0x3391, + 0x3392, + 0x3393, + 0x3394, + 0x3395, + 0x3396, + 0x3397, + 0x3398, + 0x3399, + 0x339A, + 0x339B, + 0x339C, + 0x339D, + 0x339E, + 0x339F, + 0x33A0, + 0x33A1, + 0x33A2, + 0x33A3, + 0x33A4, + 0x33A5, + 0x33A6, + 0x33A7, + 0x33A8, + 0x33A9, + 0x33AA, + 0x33AB, + 0x33AC, + 0x33AD, + 0x33AE, + 0x33AF, + 0x33B0, + 0x33B1, + 0x33B2, + 0x33B3, + 0x33B4, + 0x33B5, + 0x33B6, + 0x33B7, + 0x33B8, + 0x33B9, + 0x33BA, + 0x33BB, + 0x33BC, + 0x33BD, + 0x33BE, + 0x33BF, + 0x33C0, + 0x33C1, + 0x33C2, + 0x33C3, + 0x33C4, + 0x33C5, + 0x33C6, + 0x33C7, + 0x33C8, + 0x33C9, + 0x33CA, + 0x33CB, + 0x33CC, + 0x33CD, + 0x33CE, + 0x33CF, + 0x33D0, + 0x33D1, + 0x33D2, + 0x33D3, + 0x33D4, + 0x33D5, + 0x33D6, + 0x33D7, + 0x33D8, + 0x33D9, + 0x33DA, + 0x33DB, + 0x33DC, + 0x33DD, + 0x33DE, + 0x33DF, + 0x33E0, + 0x33E1, + 0x33E2, + 0x33E3, + 0x33E4, + 0x33E5, + 0x33E6, + 0x33E7, + 0x33E8, + 0x33E9, + 0x33EA, + 0x33EB, + 0x33EC, + 0x33ED, + 0x33EE, + 0x33EF, + 0x33F0, + 0x33F1, + 0x33F2, + 0x33F3, + 0x33F4, + 0x33F5, + 0x33F6, + 0x33F7, + 0x33F8, + 0x33F9, + 0x33FA, + 0x33FB, + 0x33FC, + 0x33FD, + 0x33FE, + 0x33FF, + 0x3400, + 0xA48D, + 0xA490, + 0xA4C7, + 0xA4D0, + 0xA62C, + 0xA640, + 0xA641, + 0xA642, + 0xA643, + 0xA644, + 0xA645, + 0xA646, + 0xA647, + 0xA648, + 0xA649, + 0xA64A, + 0xA64B, + 0xA64C, + 0xA64D, + 0xA64E, + 0xA64F, + 0xA650, + 0xA651, + 0xA652, + 0xA653, + 0xA654, + 0xA655, + 0xA656, + 0xA657, + 0xA658, + 0xA659, + 0xA65A, + 0xA65B, + 0xA65C, + 0xA65D, + 0xA65E, + 0xA65F, + 0xA660, + 0xA661, + 0xA662, + 0xA663, + 0xA664, + 0xA665, + 0xA666, + 0xA667, + 0xA668, + 0xA669, + 0xA66A, + 0xA66B, + 0xA66C, + 0xA66D, + 0xA680, + 0xA681, + 0xA682, + 0xA683, + 0xA684, + 0xA685, + 0xA686, + 0xA687, + 0xA688, + 0xA689, + 0xA68A, + 0xA68B, + 0xA68C, + 0xA68D, + 0xA68E, + 0xA68F, + 0xA690, + 0xA691, + 0xA692, + 0xA693, + 0xA694, + 0xA695, + 0xA696, + 0xA697, + 0xA698, + 0xA699, + 0xA69A, + 0xA69B, + 0xA69C, + 0xA69D, + 0xA69E, + 0xA6F8, + 0xA700, + 0xA722, + 0xA723, + 0xA724, + 0xA725, + 0xA726, + 0xA727, + 0xA728, + 0xA729, + 0xA72A, + 0xA72B, + 0xA72C, + 0xA72D, + 0xA72E, + 0xA72F, + 0xA732, + 0xA733, + 0xA734, + 0xA735, + 0xA736, + 0xA737, + 0xA738, + 0xA739, + 0xA73A, + 0xA73B, + 0xA73C, + 0xA73D, + 0xA73E, + 0xA73F, + 0xA740, + 0xA741, + 0xA742, + 0xA743, + 0xA744, + 0xA745, + 0xA746, + 0xA747, + 0xA748, + 0xA749, + 0xA74A, + 0xA74B, + 0xA74C, + 0xA74D, + 0xA74E, + 0xA74F, + 0xA750, + 0xA751, + 0xA752, + 0xA753, + 0xA754, + 0xA755, + 0xA756, + 0xA757, + 0xA758, + 0xA759, + 0xA75A, + 0xA75B, + 0xA75C, + 0xA75D, + 0xA75E, + 0xA75F, + 0xA760, + 0xA761, + 0xA762, + 0xA763, + 0xA764, + 0xA765, + 0xA766, + 0xA767, + 0xA768, + 0xA769, + 0xA76A, + 0xA76B, + 0xA76C, + 0xA76D, + 0xA76E, + 0xA76F, + 0xA770, + 0xA771, + 0xA779, + 0xA77A, + 0xA77B, + 0xA77C, + 0xA77D, + 0xA77E, + 0xA77F, + 0xA780, + 0xA781, + 0xA782, + 0xA783, + 0xA784, + 0xA785, + 0xA786, + 0xA787, + 0xA78B, + 0xA78C, + 0xA78D, + 0xA78E, + 0xA790, + 0xA791, + 0xA792, + 0xA793, + 0xA796, + 0xA797, + 0xA798, + 0xA799, + 0xA79A, + 0xA79B, + 0xA79C, + 0xA79D, + 0xA79E, + 0xA79F, + 0xA7A0, + 0xA7A1, + 0xA7A2, + 0xA7A3, + 0xA7A4, + 0xA7A5, + 0xA7A6, + 0xA7A7, + 0xA7A8, + 0xA7A9, + 0xA7AA, + 0xA7AB, + 0xA7AC, + 0xA7AD, + 0xA7AE, + 0xA7AF, + 0xA7B0, + 0xA7B1, + 0xA7B2, + 0xA7B3, + 0xA7B4, + 0xA7B5, + 0xA7B6, + 0xA7B7, + 0xA7B8, + 0xA7B9, + 0xA7BA, + 0xA7BB, + 0xA7BC, + 0xA7BD, + 0xA7BE, + 0xA7BF, + 0xA7C0, + 0xA7C1, + 0xA7C2, + 0xA7C3, + 0xA7C4, + 0xA7C5, + 0xA7C6, + 0xA7C7, + 0xA7C8, + 0xA7C9, + 0xA7CA, + 0xA7CB, + 0xA7CC, + 0xA7CD, + 0xA7CE, + 0xA7CF, + 0xA7D0, + 0xA7D1, + 0xA7D2, + 0xA7D3, + 0xA7D4, + 0xA7D5, + 0xA7D6, + 0xA7D7, + 0xA7D8, + 0xA7D9, + 0xA7DA, + 0xA7DB, + 0xA7DC, + 0xA7DD, + 0xA7DE, + 0xA7E2, + 0xA7E3, + 0xA7F1, + 0xA7F2, + 0xA7F3, + 0xA7F4, + 0xA7F5, + 0xA7F6, + 0xA7F8, + 0xA7F9, + 0xA7FA, + 0xA82D, + 0xA830, + 0xA83A, + 0xA840, + 0xA878, + 0xA880, + 0xA8C6, + 0xA8CE, + 0xA8DA, + 0xA8E0, + 0xA954, + 0xA95F, + 0xA97D, + 0xA980, + 0xA9CE, + 0xA9CF, + 0xA9DA, + 0xA9DE, + 0xA9FF, + 0xAA00, + 0xAA37, + 0xAA40, + 0xAA4E, + 0xAA50, + 0xAA5A, + 0xAA5C, + 0xAAC3, + 0xAADB, + 0xAAF7, + 0xAB01, + 0xAB07, + 0xAB09, + 0xAB0F, + 0xAB11, + 0xAB17, + 0xAB20, + 0xAB27, + 0xAB28, + 0xAB2F, + 0xAB30, + 0xAB5C, + 0xAB5D, + 0xAB5E, + 0xAB5F, + 0xAB60, + 0xAB69, + 0xAB6A, + 0xAB6C, + 0xAB6D, + 0xAB6E, + 0xAB70, + 0xAB71, + 0xAB72, + 0xAB73, + 0xAB74, + 0xAB75, + 0xAB76, + 0xAB77, + 0xAB78, + 0xAB79, + 0xAB7A, + 0xAB7B, + 0xAB7C, + 0xAB7D, + 0xAB7E, + 0xAB7F, + 0xAB80, + 0xAB81, + 0xAB82, + 0xAB83, + 0xAB84, + 0xAB85, + 0xAB86, + 0xAB87, + 0xAB88, + 0xAB89, + 0xAB8A, + 0xAB8B, + 0xAB8C, + 0xAB8D, + 0xAB8E, + 0xAB8F, + 0xAB90, + 0xAB91, + 0xAB92, + 0xAB93, + 0xAB94, + 0xAB95, + 0xAB96, + 0xAB97, + 0xAB98, + 0xAB99, + 0xAB9A, + 0xAB9B, + 0xAB9C, + 0xAB9D, + 0xAB9E, + 0xAB9F, + 0xABA0, + 0xABA1, + 0xABA2, + 0xABA3, + 0xABA4, + 0xABA5, + 0xABA6, + 0xABA7, + 0xABA8, + 0xABA9, + 0xABAA, + 0xABAB, + 0xABAC, + 0xABAD, + 0xABAE, + 0xABAF, + 0xABB0, + 0xABB1, + 0xABB2, + 0xABB3, + 0xABB4, + 0xABB5, + 0xABB6, + 0xABB7, + 0xABB8, + 0xABB9, + 0xABBA, + 0xABBB, + 0xABBC, + 0xABBD, + 0xABBE, + 0xABBF, + 0xABC0, + 0xABEE, + 0xABF0, + 0xABFA, + 0xAC00, + 0xD7A4, + 0xD7B0, + 0xD7C7, + 0xD7CB, + 0xD7FC, + 0xF900, + 0xF901, + 0xF902, + 0xF903, + 0xF904, + 0xF905, + 0xF906, + 0xF907, + 0xF909, + 0xF90A, + 0xF90B, + 0xF90C, + 0xF90D, + 0xF90E, + 0xF90F, + 0xF910, + 0xF911, + 0xF912, + 0xF913, + 0xF914, + 0xF915, + 0xF916, + 0xF917, + 0xF918, + 0xF919, + 0xF91A, + 0xF91B, + 0xF91C, + 0xF91D, + 0xF91E, + 0xF91F, + 0xF920, + 0xF921, + 0xF922, + 0xF923, + 0xF924, + 0xF925, + 0xF926, + 0xF927, + 0xF928, + 0xF929, + 0xF92A, + 0xF92B, + 0xF92C, + 0xF92D, + 0xF92E, + 0xF92F, + 0xF930, + 0xF931, + 0xF932, + 0xF933, + 0xF934, + 0xF935, + 0xF936, + 0xF937, + 0xF938, + 0xF939, + 0xF93A, + 0xF93B, + 0xF93C, + 0xF93D, + 0xF93E, + 0xF93F, + 0xF940, + 0xF941, + 0xF942, + 0xF943, + 0xF944, + 0xF945, + 0xF946, + 0xF947, + 0xF948, + 0xF949, + 0xF94A, + 0xF94B, + 0xF94C, + 0xF94D, + 0xF94E, + 0xF94F, + 0xF950, + 0xF951, + 0xF952, + 0xF953, + 0xF954, + 0xF955, + 0xF956, + 0xF957, + 0xF958, + 0xF959, + 0xF95A, + 0xF95B, + 0xF95C, + 0xF95D, + 0xF95E, + 0xF95F, + 0xF960, + 0xF961, + 0xF962, + 0xF963, + 0xF964, + 0xF965, + 0xF966, + 0xF967, + 0xF968, + 0xF969, + 0xF96A, + 0xF96B, + 0xF96C, + 0xF96D, + 0xF96E, + 0xF96F, + 0xF970, + 0xF971, + 0xF972, + 0xF973, + 0xF974, + 0xF975, + 0xF976, + 0xF977, + 0xF978, + 0xF979, + 0xF97A, + 0xF97B, + 0xF97C, + 0xF97D, + 0xF97E, + 0xF97F, + 0xF980, + 0xF981, + 0xF982, + 0xF983, + 0xF984, + 0xF985, + 0xF986, + 0xF987, + 0xF988, + 0xF989, + 0xF98A, + 0xF98B, + 0xF98C, + 0xF98D, + 0xF98E, + 0xF98F, + 0xF990, + 0xF991, + 0xF992, + 0xF993, + 0xF994, + 0xF995, + 0xF996, + 0xF997, + 0xF998, + 0xF999, + 0xF99A, + 0xF99B, + 0xF99C, + 0xF99D, + 0xF99E, + 0xF99F, + 0xF9A0, + 0xF9A1, + 0xF9A2, + 0xF9A3, + 0xF9A4, + 0xF9A5, + 0xF9A6, + 0xF9A7, + 0xF9A8, + 0xF9A9, + 0xF9AA, + 0xF9AB, + 0xF9AC, + 0xF9AD, + 0xF9AE, + 0xF9AF, + 0xF9B0, + 0xF9B1, + 0xF9B2, + 0xF9B3, + 0xF9B4, + 0xF9B5, + 0xF9B6, + 0xF9B7, + 0xF9B8, + 0xF9B9, + 0xF9BA, + 0xF9BB, + 0xF9BC, + 0xF9BD, + 0xF9BE, + 0xF9BF, + 0xF9C0, + 0xF9C1, + 0xF9C2, + 0xF9C3, + 0xF9C4, + 0xF9C5, + 0xF9C6, + 0xF9C7, + 0xF9C8, + 0xF9C9, + 0xF9CA, + 0xF9CB, + 0xF9CC, + 0xF9CD, + 0xF9CE, + 0xF9CF, + 0xF9D0, + 0xF9D1, + 0xF9D2, + 0xF9D3, + 0xF9D4, + 0xF9D5, + 0xF9D6, + 0xF9D7, + 0xF9D8, + 0xF9D9, + 0xF9DA, + 0xF9DB, + 0xF9DC, + 0xF9DD, + 0xF9DE, + 0xF9DF, + 0xF9E0, + 0xF9E1, + 0xF9E2, + 0xF9E3, + 0xF9E4, + 0xF9E5, + 0xF9E6, + 0xF9E7, + 0xF9E8, + 0xF9E9, + 0xF9EA, + 0xF9EB, + 0xF9EC, + 0xF9ED, + 0xF9EE, + 0xF9EF, + 0xF9F0, + 0xF9F1, + 0xF9F2, + 0xF9F3, + 0xF9F4, + 0xF9F5, + 0xF9F6, + 0xF9F7, + 0xF9F8, + 0xF9F9, + 0xF9FA, + 0xF9FB, + 0xF9FC, + 0xF9FD, + 0xF9FE, + 0xF9FF, + 0xFA00, + 0xFA01, + 0xFA02, + 0xFA03, + 0xFA04, + 0xFA05, + 0xFA06, + 0xFA07, + 0xFA08, + 0xFA09, + 0xFA0A, + 0xFA0B, + 0xFA0C, + 0xFA0D, + 0xFA0E, + 0xFA10, + 0xFA11, + 0xFA12, + 0xFA13, + 0xFA15, + 0xFA16, + 0xFA17, + 0xFA18, + 0xFA19, + 0xFA1A, + 0xFA1B, + 0xFA1C, + 0xFA1D, + 0xFA1E, + 0xFA1F, + 0xFA20, + 0xFA21, + 0xFA22, + 0xFA23, + 0xFA25, + 0xFA26, + 0xFA27, + 0xFA2A, + 0xFA2B, + 0xFA2C, + 0xFA2D, + 0xFA2E, + 0xFA2F, + 0xFA30, + 0xFA31, + 0xFA32, + 0xFA33, + 0xFA34, + 0xFA35, + 0xFA36, + 0xFA37, + 0xFA38, + 0xFA39, + 0xFA3A, + 0xFA3B, + 0xFA3C, + 0xFA3D, + 0xFA3E, + 0xFA3F, + 0xFA40, + 0xFA41, + 0xFA42, + 0xFA43, + 0xFA44, + 0xFA45, + 0xFA46, + 0xFA47, + 0xFA48, + 0xFA49, + 0xFA4A, + 0xFA4B, + 0xFA4C, + 0xFA4D, + 0xFA4E, + 0xFA4F, + 0xFA50, + 0xFA51, + 0xFA52, + 0xFA53, + 0xFA54, + 0xFA55, + 0xFA56, + 0xFA57, + 0xFA58, + 0xFA59, + 0xFA5A, + 0xFA5B, + 0xFA5C, + 0xFA5D, + 0xFA5F, + 0xFA60, + 0xFA61, + 0xFA62, + 0xFA63, + 0xFA64, + 0xFA65, + 0xFA66, + 0xFA67, + 0xFA68, + 0xFA69, + 0xFA6A, + 0xFA6B, + 0xFA6C, + 0xFA6D, + 0xFA6E, + 0xFA70, + 0xFA71, + 0xFA72, + 0xFA73, + 0xFA74, + 0xFA75, + 0xFA76, + 0xFA77, + 0xFA78, + 0xFA79, + 0xFA7A, + 0xFA7B, + 0xFA7C, + 0xFA7D, + 0xFA7E, + 0xFA7F, + 0xFA80, + 0xFA81, + 0xFA82, + 0xFA83, + 0xFA84, + 0xFA85, + 0xFA86, + 0xFA87, + 0xFA88, + 0xFA89, + 0xFA8A, + 0xFA8B, + 0xFA8C, + 0xFA8D, + 0xFA8E, + 0xFA8F, + 0xFA90, + 0xFA91, + 0xFA92, + 0xFA93, + 0xFA94, + 0xFA95, + 0xFA96, + 0xFA97, + 0xFA98, + 0xFA99, + 0xFA9A, + 0xFA9B, + 0xFA9C, + 0xFA9D, + 0xFA9E, + 0xFA9F, + 0xFAA0, + 0xFAA1, + 0xFAA2, + 0xFAA3, + 0xFAA4, + 0xFAA5, + 0xFAA6, + 0xFAA7, + 0xFAA8, + 0xFAA9, + 0xFAAA, + 0xFAAB, + 0xFAAC, + 0xFAAD, + 0xFAAE, + 0xFAAF, + 0xFAB0, + 0xFAB1, + 0xFAB2, + 0xFAB3, + 0xFAB4, + 0xFAB5, + 0xFAB6, + 0xFAB7, + 0xFAB8, + 0xFAB9, + 0xFABA, + 0xFABB, + 0xFABC, + 0xFABD, + 0xFABE, + 0xFABF, + 0xFAC0, + 0xFAC1, + 0xFAC2, + 0xFAC3, + 0xFAC4, + 0xFAC5, + 0xFAC6, + 0xFAC7, + 0xFAC8, + 0xFAC9, + 0xFACA, + 0xFACB, + 0xFACC, + 0xFACD, + 0xFACE, + 0xFACF, + 0xFAD0, + 0xFAD1, + 0xFAD2, + 0xFAD3, + 0xFAD4, + 0xFAD5, + 0xFAD6, + 0xFAD7, + 0xFAD8, + 0xFAD9, + 0xFADA, + 0xFB00, + 0xFB01, + 0xFB02, + 0xFB03, + 0xFB04, + 0xFB05, + 0xFB07, + 0xFB13, + 0xFB14, + 0xFB15, + 0xFB16, + 0xFB17, + 0xFB18, + 0xFB1D, + 0xFB1E, + 0xFB1F, + 0xFB20, + 0xFB21, + 0xFB22, + 0xFB23, + 0xFB24, + 0xFB25, + 0xFB26, + 0xFB27, + 0xFB28, + 0xFB29, + 0xFB2A, + 0xFB2B, + 0xFB2C, + 0xFB2D, + 0xFB2E, + 0xFB2F, + 0xFB30, + 0xFB31, + 0xFB32, + 0xFB33, + 0xFB34, + 0xFB35, + 0xFB36, + 0xFB37, + 0xFB38, + 0xFB39, + 0xFB3A, + 0xFB3B, + 0xFB3C, + 0xFB3D, + 0xFB3E, + 0xFB3F, + 0xFB40, + 0xFB41, + 0xFB42, + 0xFB43, + 0xFB44, + 0xFB45, + 0xFB46, + 0xFB47, + 0xFB48, + 0xFB49, + 0xFB4A, + 0xFB4B, + 0xFB4C, + 0xFB4D, + 0xFB4E, + 0xFB4F, + 0xFB50, + 0xFB52, + 0xFB56, + 0xFB5A, + 0xFB5E, + 0xFB62, + 0xFB66, + 0xFB6A, + 0xFB6E, + 0xFB72, + 0xFB76, + 0xFB7A, + 0xFB7E, + 0xFB82, + 0xFB84, + 0xFB86, + 0xFB88, + 0xFB8A, + 0xFB8C, + 0xFB8E, + 0xFB92, + 0xFB96, + 0xFB9A, + 0xFB9E, + 0xFBA0, + 0xFBA4, + 0xFBA6, + 0xFBAA, + 0xFBAE, + 0xFBB0, + 0xFBB2, + 0xFBD3, + 0xFBD7, + 0xFBD9, + 0xFBDB, + 0xFBDD, + 0xFBDE, + 0xFBE0, + 0xFBE2, + 0xFBE4, + 0xFBE8, + 0xFBEA, + 0xFBEC, + 0xFBEE, + 0xFBF0, + 0xFBF2, + 0xFBF4, + 0xFBF6, + 0xFBF9, + 0xFBFC, + 0xFC00, + 0xFC01, + 0xFC02, + 0xFC03, + 0xFC04, + 0xFC05, + 0xFC06, + 0xFC07, + 0xFC08, + 0xFC09, + 0xFC0A, + 0xFC0B, + 0xFC0C, + 0xFC0D, + 0xFC0E, + 0xFC0F, + 0xFC10, + 0xFC11, + 0xFC12, + 0xFC13, + 0xFC14, + 0xFC15, + 0xFC16, + 0xFC17, + 0xFC18, + 0xFC19, + 0xFC1A, + 0xFC1B, + 0xFC1C, + 0xFC1D, + 0xFC1E, + 0xFC1F, + 0xFC20, + 0xFC21, + 0xFC22, + 0xFC23, + 0xFC24, + 0xFC25, + 0xFC26, + 0xFC27, + 0xFC28, + 0xFC29, + 0xFC2A, + 0xFC2B, + 0xFC2C, + 0xFC2D, + 0xFC2E, + 0xFC2F, + 0xFC30, + 0xFC31, + 0xFC32, + 0xFC33, + 0xFC34, + 0xFC35, + 0xFC36, + 0xFC37, + 0xFC38, + 0xFC39, + 0xFC3A, + 0xFC3B, + 0xFC3C, + 0xFC3D, + 0xFC3E, + 0xFC3F, + 0xFC40, + 0xFC41, + 0xFC42, + 0xFC43, + 0xFC44, + 0xFC45, + 0xFC46, + 0xFC47, + 0xFC48, + 0xFC49, + 0xFC4A, + 0xFC4B, + 0xFC4C, + 0xFC4D, + 0xFC4E, + 0xFC4F, + 0xFC50, + 0xFC51, + 0xFC52, + 0xFC53, + 0xFC54, + 0xFC55, + 0xFC56, + 0xFC57, + 0xFC58, + 0xFC59, + 0xFC5A, + 0xFC5B, + 0xFC5C, + 0xFC5D, + 0xFC5E, + 0xFC5F, + 0xFC60, + 0xFC61, + 0xFC62, + 0xFC63, + 0xFC64, + 0xFC65, + 0xFC66, + 0xFC67, + 0xFC68, + 0xFC69, + 0xFC6A, + 0xFC6B, + 0xFC6C, + 0xFC6D, + 0xFC6E, + 0xFC6F, + 0xFC70, + 0xFC71, + 0xFC72, + 0xFC73, + 0xFC74, + 0xFC75, + 0xFC76, + 0xFC77, + 0xFC78, + 0xFC79, + 0xFC7A, + 0xFC7B, + 0xFC7C, + 0xFC7D, + 0xFC7E, + 0xFC7F, + 0xFC80, + 0xFC81, + 0xFC82, + 0xFC83, + 0xFC84, + 0xFC85, + 0xFC86, + 0xFC87, + 0xFC88, + 0xFC89, + 0xFC8A, + 0xFC8B, + 0xFC8C, + 0xFC8D, + 0xFC8E, + 0xFC8F, + 0xFC90, + 0xFC91, + 0xFC92, + 0xFC93, + 0xFC94, + 0xFC95, + 0xFC96, + 0xFC97, + 0xFC98, + 0xFC99, + 0xFC9A, + 0xFC9B, + 0xFC9C, + 0xFC9D, + 0xFC9E, + 0xFC9F, + 0xFCA0, + 0xFCA1, + 0xFCA2, + 0xFCA3, + 0xFCA4, + 0xFCA5, + 0xFCA6, + 0xFCA7, + 0xFCA8, + 0xFCA9, + 0xFCAA, + 0xFCAB, + 0xFCAC, + 0xFCAD, + 0xFCAE, + 0xFCAF, + 0xFCB0, + 0xFCB1, + 0xFCB2, + 0xFCB3, + 0xFCB4, + 0xFCB5, + 0xFCB6, + 0xFCB7, + 0xFCB8, + 0xFCB9, + 0xFCBA, + 0xFCBB, + 0xFCBC, + 0xFCBD, + 0xFCBE, + 0xFCBF, + 0xFCC0, + 0xFCC1, + 0xFCC2, + 0xFCC3, + 0xFCC4, + 0xFCC5, + 0xFCC6, + 0xFCC7, + 0xFCC8, + 0xFCC9, + 0xFCCA, + 0xFCCB, + 0xFCCC, + 0xFCCD, + 0xFCCE, + 0xFCCF, + 0xFCD0, + 0xFCD1, + 0xFCD2, + 0xFCD3, + 0xFCD4, + 0xFCD5, + 0xFCD6, + 0xFCD7, + 0xFCD8, + 0xFCD9, + 0xFCDA, + 0xFCDB, + 0xFCDC, + 0xFCDD, + 0xFCDE, + 0xFCDF, + 0xFCE0, + 0xFCE1, + 0xFCE2, + 0xFCE3, + 0xFCE4, + 0xFCE5, + 0xFCE6, + 0xFCE7, + 0xFCE8, + 0xFCE9, + 0xFCEA, + 0xFCEB, + 0xFCEC, + 0xFCED, + 0xFCEE, + 0xFCEF, + 0xFCF0, + 0xFCF1, + 0xFCF2, + 0xFCF3, + 0xFCF4, + 0xFCF5, + 0xFCF6, + 0xFCF7, + 0xFCF8, + 0xFCF9, + 0xFCFA, + 0xFCFB, + 0xFCFC, + 0xFCFD, + 0xFCFE, + 0xFCFF, + 0xFD00, + 0xFD01, + 0xFD02, + 0xFD03, + 0xFD04, + 0xFD05, + 0xFD06, + 0xFD07, + 0xFD08, + 0xFD09, + 0xFD0A, + 0xFD0B, + 0xFD0C, + 0xFD0D, + 0xFD0E, + 0xFD0F, + 0xFD10, + 0xFD11, + 0xFD12, + 0xFD13, + 0xFD14, + 0xFD15, + 0xFD16, + 0xFD17, + 0xFD18, + 0xFD19, + 0xFD1A, + 0xFD1B, + 0xFD1C, + 0xFD1D, + 0xFD1E, + 0xFD1F, + 0xFD20, + 0xFD21, + 0xFD22, + 0xFD23, + 0xFD24, + 0xFD25, + 0xFD26, + 0xFD27, + 0xFD28, + 0xFD29, + 0xFD2A, + 0xFD2B, + 0xFD2C, + 0xFD2D, + 0xFD2E, + 0xFD2F, + 0xFD30, + 0xFD31, + 0xFD32, + 0xFD33, + 0xFD34, + 0xFD35, + 0xFD36, + 0xFD37, + 0xFD38, + 0xFD39, + 0xFD3A, + 0xFD3B, + 0xFD3C, + 0xFD3E, + 0xFD50, + 0xFD51, + 0xFD53, + 0xFD54, + 0xFD55, + 0xFD56, + 0xFD57, + 0xFD58, + 0xFD5A, + 0xFD5B, + 0xFD5C, + 0xFD5D, + 0xFD5E, + 0xFD5F, + 0xFD61, + 0xFD62, + 0xFD64, + 0xFD66, + 0xFD67, + 0xFD69, + 0xFD6A, + 0xFD6C, + 0xFD6E, + 0xFD6F, + 0xFD71, + 0xFD73, + 0xFD74, + 0xFD75, + 0xFD76, + 0xFD78, + 0xFD79, + 0xFD7A, + 0xFD7B, + 0xFD7C, + 0xFD7E, + 0xFD7F, + 0xFD80, + 0xFD81, + 0xFD82, + 0xFD83, + 0xFD85, + 0xFD87, + 0xFD89, + 0xFD8A, + 0xFD8B, + 0xFD8C, + 0xFD8D, + 0xFD8E, + 0xFD8F, + 0xFD90, + 0xFD92, + 0xFD93, + 0xFD94, + 0xFD95, + 0xFD96, + 0xFD97, + 0xFD99, + 0xFD9A, + 0xFD9B, + 0xFD9C, + 0xFD9E, + 0xFD9F, + 0xFDA0, + 0xFDA1, + 0xFDA2, + 0xFDA3, + 0xFDA4, + 0xFDA5, + 0xFDA6, + 0xFDA7, + 0xFDA8, + 0xFDA9, + 0xFDAA, + 0xFDAB, + 0xFDAC, + 0xFDAD, + 0xFDAE, + 0xFDAF, + 0xFDB0, + 0xFDB1, + 0xFDB2, + 0xFDB3, + 0xFDB4, + 0xFDB5, + 0xFDB6, + 0xFDB7, + 0xFDB8, + 0xFDB9, + 0xFDBA, + 0xFDBB, + 0xFDBC, + 0xFDBD, + 0xFDBE, + 0xFDBF, + 0xFDC0, + 0xFDC1, + 0xFDC2, + 0xFDC3, + 0xFDC4, + 0xFDC5, + 0xFDC6, + 0xFDC7, + 0xFDC8, + 0xFDD0, + 0xFDF0, + 0xFDF1, + 0xFDF2, + 0xFDF3, + 0xFDF4, + 0xFDF5, + 0xFDF6, + 0xFDF7, + 0xFDF8, + 0xFDF9, + 0xFDFA, + 0xFDFB, + 0xFDFC, + 0xFDFD, + 0xFE00, + 0xFE10, + 0xFE11, + 0xFE12, + 0xFE13, + 0xFE14, + 0xFE15, + 0xFE16, + 0xFE17, + 0xFE18, + 0xFE19, + 0xFE20, + 0xFE30, + 0xFE31, + 0xFE32, + 0xFE33, + 0xFE35, + 0xFE36, + 0xFE37, + 0xFE38, + 0xFE39, + 0xFE3A, + 0xFE3B, + 0xFE3C, + 0xFE3D, + 0xFE3E, + 0xFE3F, + 0xFE40, + 0xFE41, + 0xFE42, + 0xFE43, + 0xFE44, + 0xFE45, + 0xFE47, + 0xFE48, + 0xFE49, + 0xFE4D, + 0xFE50, + 0xFE51, + 0xFE52, + 0xFE54, + 0xFE55, + 0xFE56, + 0xFE57, + 0xFE58, + 0xFE59, + 0xFE5A, + 0xFE5B, + 0xFE5C, + 0xFE5D, + 0xFE5E, + 0xFE5F, + 0xFE60, + 0xFE61, + 0xFE62, + 0xFE63, + 0xFE64, + 0xFE65, + 0xFE66, + 0xFE67, + 0xFE68, + 0xFE69, + 0xFE6A, + 0xFE6B, + 0xFE6C, + 0xFE70, + 0xFE71, + 0xFE72, + 0xFE73, + 0xFE74, + 0xFE75, + 0xFE76, + 0xFE77, + 0xFE78, + 0xFE79, + 0xFE7A, + 0xFE7B, + 0xFE7C, + 0xFE7D, + 0xFE7E, + 0xFE7F, + 0xFE80, + 0xFE81, + 0xFE83, + 0xFE85, + 0xFE87, + 0xFE89, + 0xFE8D, + 0xFE8F, + 0xFE93, + 0xFE95, + 0xFE99, + 0xFE9D, + 0xFEA1, + 0xFEA5, + 0xFEA9, + 0xFEAB, + 0xFEAD, + 0xFEAF, + 0xFEB1, + 0xFEB5, + 0xFEB9, + 0xFEBD, + 0xFEC1, + 0xFEC5, + 0xFEC9, + 0xFECD, + 0xFED1, + 0xFED5, + 0xFED9, + 0xFEDD, + 0xFEE1, + 0xFEE5, + 0xFEE9, + 0xFEED, + 0xFEEF, + 0xFEF1, + 0xFEF5, + 0xFEF7, + 0xFEF9, + 0xFEFB, + 0xFEFD, + 0xFEFF, + 0xFF00, + 0xFF01, + 0xFF02, + 0xFF03, + 0xFF04, + 0xFF05, + 0xFF06, + 0xFF07, + 0xFF08, + 0xFF09, + 0xFF0A, + 0xFF0B, + 0xFF0C, + 0xFF0D, + 0xFF0E, + 0xFF0F, + 0xFF10, + 0xFF11, + 0xFF12, + 0xFF13, + 0xFF14, + 0xFF15, + 0xFF16, + 0xFF17, + 0xFF18, + 0xFF19, + 0xFF1A, + 0xFF1B, + 0xFF1C, + 0xFF1D, + 0xFF1E, + 0xFF1F, + 0xFF20, + 0xFF21, + 0xFF22, + 0xFF23, + 0xFF24, + 0xFF25, + 0xFF26, + 0xFF27, + 0xFF28, + 0xFF29, + 0xFF2A, + 0xFF2B, + 0xFF2C, + 0xFF2D, + 0xFF2E, + 0xFF2F, + 0xFF30, + 0xFF31, + 0xFF32, + 0xFF33, + 0xFF34, + 0xFF35, + 0xFF36, + 0xFF37, + 0xFF38, + 0xFF39, + 0xFF3A, + 0xFF3B, + 0xFF3C, + 0xFF3D, + 0xFF3E, + 0xFF3F, + 0xFF40, + 0xFF41, + 0xFF42, + 0xFF43, + 0xFF44, + 0xFF45, + 0xFF46, + 0xFF47, + 0xFF48, + 0xFF49, + 0xFF4A, + 0xFF4B, + 0xFF4C, + 0xFF4D, + 0xFF4E, + 0xFF4F, + 0xFF50, + 0xFF51, + 0xFF52, + 0xFF53, + 0xFF54, + 0xFF55, + 0xFF56, + 0xFF57, + 0xFF58, + 0xFF59, + 0xFF5A, + 0xFF5B, + 0xFF5C, + 0xFF5D, + 0xFF5E, + 0xFF5F, + 0xFF60, + 0xFF61, + 0xFF62, + 0xFF63, + 0xFF64, + 0xFF65, + 0xFF66, + 0xFF67, + 0xFF68, + 0xFF69, + 0xFF6A, + 0xFF6B, + 0xFF6C, + 0xFF6D, + 0xFF6E, + 0xFF6F, + 0xFF70, + 0xFF71, + 0xFF72, + 0xFF73, + 0xFF74, + 0xFF75, + 0xFF76, + 0xFF77, + 0xFF78, + 0xFF79, + 0xFF7A, + 0xFF7B, + 0xFF7C, + 0xFF7D, + 0xFF7E, + 0xFF7F, + 0xFF80, + 0xFF81, + 0xFF82, + 0xFF83, + 0xFF84, + 0xFF85, + 0xFF86, + 0xFF87, + 0xFF88, + 0xFF89, + 0xFF8A, + 0xFF8B, + 0xFF8C, + 0xFF8D, + 0xFF8E, + 0xFF8F, + 0xFF90, + 0xFF91, + 0xFF92, + 0xFF93, + 0xFF94, + 0xFF95, + 0xFF96, + 0xFF97, + 0xFF98, + 0xFF99, + 0xFF9A, + 0xFF9B, + 0xFF9C, + 0xFF9D, + 0xFF9E, + 0xFF9F, + 0xFFA0, + 0xFFA1, + 0xFFA2, + 0xFFA3, + 0xFFA4, + 0xFFA5, + 0xFFA6, + 0xFFA7, + 0xFFA8, + 0xFFA9, + 0xFFAA, + 0xFFAB, + 0xFFAC, + 0xFFAD, + 0xFFAE, + 0xFFAF, + 0xFFB0, + 0xFFB1, + 0xFFB2, + 0xFFB3, + 0xFFB4, + 0xFFB5, + 0xFFB6, + 0xFFB7, + 0xFFB8, + 0xFFB9, + 0xFFBA, + 0xFFBB, + 0xFFBC, + 0xFFBD, + 0xFFBE, + 0xFFBF, + 0xFFC2, + 0xFFC3, + 0xFFC4, + 0xFFC5, + 0xFFC6, + 0xFFC7, + 0xFFC8, + 0xFFCA, + 0xFFCB, + 0xFFCC, + 0xFFCD, + 0xFFCE, + 0xFFCF, + 0xFFD0, + 0xFFD2, + 0xFFD3, + 0xFFD4, + 0xFFD5, + 0xFFD6, + 0xFFD7, + 0xFFD8, + 0xFFDA, + 0xFFDB, + 0xFFDC, + 0xFFDD, + 0xFFE0, + 0xFFE1, + 0xFFE2, + 0xFFE3, + 0xFFE4, + 0xFFE5, + 0xFFE6, + 0xFFE7, + 0xFFE8, + 0xFFE9, + 0xFFEA, + 0xFFEB, + 0xFFEC, + 0xFFED, + 0xFFEE, + 0xFFEF, + 0x10000, + 0x1000C, + 0x1000D, + 0x10027, + 0x10028, + 0x1003B, + 0x1003C, + 0x1003E, + 0x1003F, + 0x1004E, + 0x10050, + 0x1005E, + 0x10080, + 0x100FB, + 0x10100, + 0x10103, + 0x10107, + 0x10134, + 0x10137, + 0x1018F, + 0x10190, + 0x1019D, + 0x101A0, + 0x101A1, + 0x101D0, + 0x101FE, + 0x10280, + 0x1029D, + 0x102A0, + 0x102D1, + 0x102E0, + 0x102FC, + 0x10300, + 0x10324, + 0x1032D, + 0x1034B, + 0x10350, + 0x1037B, + 0x10380, + 0x1039E, + 0x1039F, + 0x103C4, + 0x103C8, + 0x103D6, + 0x10400, + 0x10401, + 0x10402, + 0x10403, + 0x10404, + 0x10405, + 0x10406, + 0x10407, + 0x10408, + 0x10409, + 0x1040A, + 0x1040B, + 0x1040C, + 0x1040D, + 0x1040E, + 0x1040F, + 0x10410, + 0x10411, + 0x10412, + 0x10413, + 0x10414, + 0x10415, + 0x10416, + 0x10417, + 0x10418, + 0x10419, + 0x1041A, + 0x1041B, + 0x1041C, + 0x1041D, + 0x1041E, + 0x1041F, + 0x10420, + 0x10421, + 0x10422, + 0x10423, + 0x10424, + 0x10425, + 0x10426, + 0x10427, + 0x10428, + 0x1049E, + 0x104A0, + 0x104AA, + 0x104B0, + 0x104B1, + 0x104B2, + 0x104B3, + 0x104B4, + 0x104B5, + 0x104B6, + 0x104B7, + 0x104B8, + 0x104B9, + 0x104BA, + 0x104BB, + 0x104BC, + 0x104BD, + 0x104BE, + 0x104BF, + 0x104C0, + 0x104C1, + 0x104C2, + 0x104C3, + 0x104C4, + 0x104C5, + 0x104C6, + 0x104C7, + 0x104C8, + 0x104C9, + 0x104CA, + 0x104CB, + 0x104CC, + 0x104CD, + 0x104CE, + 0x104CF, + 0x104D0, + 0x104D1, + 0x104D2, + 0x104D3, + 0x104D4, + 0x104D8, + 0x104FC, + 0x10500, + 0x10528, + 0x10530, + 0x10564, + 0x1056F, + 0x10570, + 0x10571, + 0x10572, + 0x10573, + 0x10574, + 0x10575, + 0x10576, + 0x10577, + 0x10578, + 0x10579, + 0x1057A, + 0x1057B, + 0x1057C, + 0x1057D, + 0x1057E, + 0x1057F, + 0x10580, + 0x10581, + 0x10582, + 0x10583, + 0x10584, + 0x10585, + 0x10586, + 0x10587, + 0x10588, + 0x10589, + 0x1058A, + 0x1058B, + 0x1058C, + 0x1058D, + 0x1058E, + 0x1058F, + 0x10590, + 0x10591, + 0x10592, + 0x10593, + 0x10594, + 0x10595, + 0x10596, + 0x10597, + 0x105A2, + 0x105A3, + 0x105B2, + 0x105B3, + 0x105BA, + 0x105BB, + 0x105BD, + 0x105C0, + 0x105F4, + 0x10600, + 0x10737, + 0x10740, + 0x10756, + 0x10760, + 0x10768, + 0x10780, + 0x10781, + 0x10782, + 0x10783, + 0x10784, + 0x10785, + 0x10786, + 0x10787, + 0x10788, + 0x10789, + 0x1078A, + 0x1078B, + 0x1078C, + 0x1078D, + 0x1078E, + 0x1078F, + 0x10790, + 0x10791, + 0x10792, + 0x10793, + 0x10794, + 0x10795, + 0x10796, + 0x10797, + 0x10798, + 0x10799, + 0x1079A, + 0x1079B, + 0x1079C, + 0x1079D, + 0x1079E, + 0x1079F, + 0x107A0, + 0x107A1, + 0x107A2, + 0x107A3, + 0x107A4, + 0x107A5, + 0x107A6, + 0x107A7, + 0x107A8, + 0x107A9, + 0x107AA, + 0x107AB, + 0x107AC, + 0x107AD, + 0x107AE, + 0x107AF, + 0x107B0, + 0x107B1, + 0x107B2, + 0x107B3, + 0x107B4, + 0x107B5, + 0x107B6, + 0x107B7, + 0x107B8, + 0x107B9, + 0x107BA, + 0x107BB, + 0x107BC, + 0x107BD, + 0x107BE, + 0x107BF, + 0x107C0, + 0x10800, + 0x10806, + 0x10808, + 0x10809, + 0x1080A, + 0x10836, + 0x10837, + 0x10839, + 0x1083C, + 0x1083D, + 0x1083F, + 0x10856, + 0x10857, + 0x1089F, + 0x108A7, + 0x108B0, + 0x108E0, + 0x108F3, + 0x108F4, + 0x108F6, + 0x108FB, + 0x1091C, + 0x1091F, + 0x1093A, + 0x1093F, + 0x1095A, + 0x10980, + 0x109B8, + 0x109BC, + 0x109D0, + 0x109D2, + 0x10A04, + 0x10A05, + 0x10A07, + 0x10A0C, + 0x10A14, + 0x10A15, + 0x10A18, + 0x10A19, + 0x10A36, + 0x10A38, + 0x10A3B, + 0x10A3F, + 0x10A49, + 0x10A50, + 0x10A59, + 0x10A60, + 0x10AA0, + 0x10AC0, + 0x10AE7, + 0x10AEB, + 0x10AF7, + 0x10B00, + 0x10B36, + 0x10B39, + 0x10B56, + 0x10B58, + 0x10B73, + 0x10B78, + 0x10B92, + 0x10B99, + 0x10B9D, + 0x10BA9, + 0x10BB0, + 0x10C00, + 0x10C49, + 0x10C80, + 0x10C81, + 0x10C82, + 0x10C83, + 0x10C84, + 0x10C85, + 0x10C86, + 0x10C87, + 0x10C88, + 0x10C89, + 0x10C8A, + 0x10C8B, + 0x10C8C, + 0x10C8D, + 0x10C8E, + 0x10C8F, + 0x10C90, + 0x10C91, + 0x10C92, + 0x10C93, + 0x10C94, + 0x10C95, + 0x10C96, + 0x10C97, + 0x10C98, + 0x10C99, + 0x10C9A, + 0x10C9B, + 0x10C9C, + 0x10C9D, + 0x10C9E, + 0x10C9F, + 0x10CA0, + 0x10CA1, + 0x10CA2, + 0x10CA3, + 0x10CA4, + 0x10CA5, + 0x10CA6, + 0x10CA7, + 0x10CA8, + 0x10CA9, + 0x10CAA, + 0x10CAB, + 0x10CAC, + 0x10CAD, + 0x10CAE, + 0x10CAF, + 0x10CB0, + 0x10CB1, + 0x10CB2, + 0x10CB3, + 0x10CC0, + 0x10CF3, + 0x10CFA, + 0x10D28, + 0x10D30, + 0x10D3A, + 0x10D40, + 0x10D50, + 0x10D51, + 0x10D52, + 0x10D53, + 0x10D54, + 0x10D55, + 0x10D56, + 0x10D57, + 0x10D58, + 0x10D59, + 0x10D5A, + 0x10D5B, + 0x10D5C, + 0x10D5D, + 0x10D5E, + 0x10D5F, + 0x10D60, + 0x10D61, + 0x10D62, + 0x10D63, + 0x10D64, + 0x10D65, + 0x10D66, + 0x10D69, + 0x10D86, + 0x10D8E, + 0x10D90, + 0x10E60, + 0x10E7F, + 0x10E80, + 0x10EAA, + 0x10EAB, + 0x10EAE, + 0x10EB0, + 0x10EB2, + 0x10EC2, + 0x10EC8, + 0x10EC9, + 0x10EEF, + 0x10EF0, + 0x10F28, + 0x10F30, + 0x10F5A, + 0x10F70, + 0x10F8A, + 0x10FB0, + 0x10FCC, + 0x10FE0, + 0x10FF7, + 0x11000, + 0x1104E, + 0x11052, + 0x11076, + 0x1107F, + 0x110BD, + 0x110BE, + 0x110C3, + 0x110D0, + 0x110E9, + 0x110F0, + 0x110FA, + 0x11100, + 0x11135, + 0x11136, + 0x11148, + 0x11150, + 0x11177, + 0x11180, + 0x111E0, + 0x111E1, + 0x111F5, + 0x11200, + 0x11212, + 0x11213, + 0x11242, + 0x11280, + 0x11287, + 0x11288, + 0x11289, + 0x1128A, + 0x1128E, + 0x1128F, + 0x1129E, + 0x1129F, + 0x112AA, + 0x112B0, + 0x112EB, + 0x112F0, + 0x112FA, + 0x11300, + 0x11304, + 0x11305, + 0x1130D, + 0x1130F, + 0x11311, + 0x11313, + 0x11329, + 0x1132A, + 0x11331, + 0x11332, + 0x11334, + 0x11335, + 0x1133A, + 0x1133B, + 0x11345, + 0x11347, + 0x11349, + 0x1134B, + 0x1134E, + 0x11350, + 0x11351, + 0x11357, + 0x11358, + 0x1135D, + 0x11364, + 0x11366, + 0x1136D, + 0x11370, + 0x11375, + 0x11380, + 0x1138A, + 0x1138B, + 0x1138C, + 0x1138E, + 0x1138F, + 0x11390, + 0x113B6, + 0x113B7, + 0x113C1, + 0x113C2, + 0x113C3, + 0x113C5, + 0x113C6, + 0x113C7, + 0x113CB, + 0x113CC, + 0x113D6, + 0x113D7, + 0x113D9, + 0x113E1, + 0x113E3, + 0x11400, + 0x1145C, + 0x1145D, + 0x11462, + 0x11480, + 0x114C8, + 0x114D0, + 0x114DA, + 0x11580, + 0x115B6, + 0x115B8, + 0x115DE, + 0x11600, + 0x11645, + 0x11650, + 0x1165A, + 0x11660, + 0x1166D, + 0x11680, + 0x116BA, + 0x116C0, + 0x116CA, + 0x116D0, + 0x116E4, + 0x11700, + 0x1171B, + 0x1171D, + 0x1172C, + 0x11730, + 0x11747, + 0x11800, + 0x1183C, + 0x118A0, + 0x118A1, + 0x118A2, + 0x118A3, + 0x118A4, + 0x118A5, + 0x118A6, + 0x118A7, + 0x118A8, + 0x118A9, + 0x118AA, + 0x118AB, + 0x118AC, + 0x118AD, + 0x118AE, + 0x118AF, + 0x118B0, + 0x118B1, + 0x118B2, + 0x118B3, + 0x118B4, + 0x118B5, + 0x118B6, + 0x118B7, + 0x118B8, + 0x118B9, + 0x118BA, + 0x118BB, + 0x118BC, + 0x118BD, + 0x118BE, + 0x118BF, + 0x118C0, + 0x118F3, + 0x118FF, + 0x11907, + 0x11909, + 0x1190A, + 0x1190C, + 0x11914, + 0x11915, + 0x11917, + 0x11918, + 0x11936, + 0x11937, + 0x11939, + 0x1193B, + 0x11947, + 0x11950, + 0x1195A, + 0x119A0, + 0x119A8, + 0x119AA, + 0x119D8, + 0x119DA, + 0x119E5, + 0x11A00, + 0x11A48, + 0x11A50, + 0x11AA3, + 0x11AB0, + 0x11AF9, + 0x11B00, + 0x11B0B, + 0x11B60, + 0x11B68, + 0x11BC0, + 0x11BE2, + 0x11BF0, + 0x11BFA, + 0x11C00, + 0x11C09, + 0x11C0A, + 0x11C37, + 0x11C38, + 0x11C46, + 0x11C50, + 0x11C6D, + 0x11C70, + 0x11C90, + 0x11C92, + 0x11CA8, + 0x11CA9, + 0x11CB7, + 0x11D00, + 0x11D07, + 0x11D08, + 0x11D0A, + 0x11D0B, + 0x11D37, + 0x11D3A, + 0x11D3B, + 0x11D3C, + 0x11D3E, + 0x11D3F, + 0x11D48, + 0x11D50, + 0x11D5A, + 0x11D60, + 0x11D66, + 0x11D67, + 0x11D69, + 0x11D6A, + 0x11D8F, + 0x11D90, + 0x11D92, + 0x11D93, + 0x11D99, + 0x11DA0, + 0x11DAA, + 0x11DB0, + 0x11DDC, + 0x11DE0, + 0x11DEA, + 0x11DF0, + 0x11DF2, + 0x11EE0, + 0x11EF9, + 0x11F00, + 0x11F11, + 0x11F12, + 0x11F3B, + 0x11F3E, + 0x11F5B, + 0x11FB0, + 0x11FB1, + 0x11FC0, + 0x11FF2, + 0x11FFF, + 0x1239A, + 0x12400, + 0x12544, + 0x12550, + 0x12687, + 0x12F90, + 0x12FF3, + 0x13000, + 0x13430, + 0x13440, + 0x13456, + 0x13460, + 0x143FB, + 0x14400, + 0x14647, + 0x16100, + 0x1613A, + 0x16800, + 0x16A39, + 0x16A40, + 0x16A5F, + 0x16A60, + 0x16A6A, + 0x16A6E, + 0x16ABF, + 0x16AC0, + 0x16ACA, + 0x16AD0, + 0x16AEE, + 0x16AF0, + 0x16AF6, + 0x16B00, + 0x16B46, + 0x16B50, + 0x16B5A, + 0x16B5B, + 0x16B62, + 0x16B63, + 0x16B78, + 0x16B7D, + 0x16B90, + 0x16D40, + 0x16D7A, + 0x16E40, + 0x16E41, + 0x16E42, + 0x16E43, + 0x16E44, + 0x16E45, + 0x16E46, + 0x16E47, + 0x16E48, + 0x16E49, + 0x16E4A, + 0x16E4B, + 0x16E4C, + 0x16E4D, + 0x16E4E, + 0x16E4F, + 0x16E50, + 0x16E51, + 0x16E52, + 0x16E53, + 0x16E54, + 0x16E55, + 0x16E56, + 0x16E57, + 0x16E58, + 0x16E59, + 0x16E5A, + 0x16E5B, + 0x16E5C, + 0x16E5D, + 0x16E5E, + 0x16E5F, + 0x16E60, + 0x16E9B, + 0x16EA0, + 0x16EA1, + 0x16EA2, + 0x16EA3, + 0x16EA4, + 0x16EA5, + 0x16EA6, + 0x16EA7, + 0x16EA8, + 0x16EA9, + 0x16EAA, + 0x16EAB, + 0x16EAC, + 0x16EAD, + 0x16EAE, + 0x16EAF, + 0x16EB0, + 0x16EB1, + 0x16EB2, + 0x16EB3, + 0x16EB4, + 0x16EB5, + 0x16EB6, + 0x16EB7, + 0x16EB8, + 0x16EB9, + 0x16EBB, + 0x16ED4, + 0x16F00, + 0x16F4B, + 0x16F4F, + 0x16F88, + 0x16F8F, + 0x16FA0, + 0x16FE0, + 0x16FE5, + 0x16FF0, + 0x16FF7, + 0x17000, + 0x18CDB, + 0x18CFF, + 0x18D21, + 0x18D80, + 0x18DF3, + 0x18E00, + 0x19192, + 0x191A0, + 0x191D3, + 0x1AFF0, + 0x1AFF4, + 0x1AFF5, + 0x1AFFC, + 0x1AFFD, + 0x1AFFF, + 0x1B000, + 0x1B123, + 0x1B124, + 0x1B125, + 0x1B126, + 0x1B127, + 0x1B129, + 0x1B132, + 0x1B133, + 0x1B150, + 0x1B153, + 0x1B155, + 0x1B156, + 0x1B164, + 0x1B169, + 0x1B170, + 0x1B2FC, + 0x1BC00, + 0x1BC6B, + 0x1BC70, + 0x1BC7D, + 0x1BC80, + 0x1BC89, + 0x1BC90, + 0x1BC9A, + 0x1BC9C, + 0x1BCA0, + 0x1BCA4, + 0x1CC00, + 0x1CCD6, + 0x1CCD7, + 0x1CCD8, + 0x1CCD9, + 0x1CCDA, + 0x1CCDB, + 0x1CCDC, + 0x1CCDD, + 0x1CCDE, + 0x1CCDF, + 0x1CCE0, + 0x1CCE1, + 0x1CCE2, + 0x1CCE3, + 0x1CCE4, + 0x1CCE5, + 0x1CCE6, + 0x1CCE7, + 0x1CCE8, + 0x1CCE9, + 0x1CCEA, + 0x1CCEB, + 0x1CCEC, + 0x1CCED, + 0x1CCEE, + 0x1CCEF, + 0x1CCF0, + 0x1CCF1, + 0x1CCF2, + 0x1CCF3, + 0x1CCF4, + 0x1CCF5, + 0x1CCF6, + 0x1CCF7, + 0x1CCF8, + 0x1CCF9, + 0x1CCFA, + 0x1CCFD, + 0x1CD00, + 0x1CEB4, + 0x1CEBA, + 0x1CED1, + 0x1CED2, + 0x1CED5, + 0x1CEDD, + 0x1CEFE, + 0x1CF00, + 0x1CF2E, + 0x1CF30, + 0x1CF47, + 0x1CF50, + 0x1CFC4, + 0x1D000, + 0x1D0F6, + 0x1D100, + 0x1D15E, + 0x1D15F, + 0x1D160, + 0x1D161, + 0x1D162, + 0x1D163, + 0x1D164, + 0x1D165, + 0x1D173, + 0x1D17B, + 0x1D1BB, + 0x1D1BC, + 0x1D1BD, + 0x1D1BE, + 0x1D1BF, + 0x1D1C0, + 0x1D1C1, + 0x1D246, + 0x1D250, + 0x1D282, + 0x1D2C0, + 0x1D2D4, + 0x1D2E0, + 0x1D2F4, + 0x1D300, + 0x1D357, + 0x1D360, + 0x1D379, + 0x1D400, + 0x1D401, + 0x1D402, + 0x1D403, + 0x1D404, + 0x1D405, + 0x1D406, + 0x1D407, + 0x1D408, + 0x1D409, + 0x1D40A, + 0x1D40B, + 0x1D40C, + 0x1D40D, + 0x1D40E, + 0x1D40F, + 0x1D410, + 0x1D411, + 0x1D412, + 0x1D413, + 0x1D414, + 0x1D415, + 0x1D416, + 0x1D417, + 0x1D418, + 0x1D419, + 0x1D41A, + 0x1D41B, + 0x1D41C, + 0x1D41D, + 0x1D41E, + 0x1D41F, + 0x1D420, + 0x1D421, + 0x1D422, + 0x1D423, + 0x1D424, + 0x1D425, + 0x1D426, + 0x1D427, + 0x1D428, + 0x1D429, + 0x1D42A, + 0x1D42B, + 0x1D42C, + 0x1D42D, + 0x1D42E, + 0x1D42F, + 0x1D430, + 0x1D431, + 0x1D432, + 0x1D433, + 0x1D434, + 0x1D435, + 0x1D436, + 0x1D437, + 0x1D438, + 0x1D439, + 0x1D43A, + 0x1D43B, + 0x1D43C, + 0x1D43D, + 0x1D43E, + 0x1D43F, + 0x1D440, + 0x1D441, + 0x1D442, + 0x1D443, + 0x1D444, + 0x1D445, + 0x1D446, + 0x1D447, + 0x1D448, + 0x1D449, + 0x1D44A, + 0x1D44B, + 0x1D44C, + 0x1D44D, + 0x1D44E, + 0x1D44F, + 0x1D450, + 0x1D451, + 0x1D452, + 0x1D453, + 0x1D454, + 0x1D455, + 0x1D456, + 0x1D457, + 0x1D458, + 0x1D459, + 0x1D45A, + 0x1D45B, + 0x1D45C, + 0x1D45D, + 0x1D45E, + 0x1D45F, + 0x1D460, + 0x1D461, + 0x1D462, + 0x1D463, + 0x1D464, + 0x1D465, + 0x1D466, + 0x1D467, + 0x1D468, + 0x1D469, + 0x1D46A, + 0x1D46B, + 0x1D46C, + 0x1D46D, + 0x1D46E, + 0x1D46F, + 0x1D470, + 0x1D471, + 0x1D472, + 0x1D473, + 0x1D474, + 0x1D475, + 0x1D476, + 0x1D477, + 0x1D478, + 0x1D479, + 0x1D47A, + 0x1D47B, + 0x1D47C, + 0x1D47D, + 0x1D47E, + 0x1D47F, + 0x1D480, + 0x1D481, + 0x1D482, + 0x1D483, + 0x1D484, + 0x1D485, + 0x1D486, + 0x1D487, + 0x1D488, + 0x1D489, + 0x1D48A, + 0x1D48B, + 0x1D48C, + 0x1D48D, + 0x1D48E, + 0x1D48F, + 0x1D490, + 0x1D491, + 0x1D492, + 0x1D493, + 0x1D494, + 0x1D495, + 0x1D496, + 0x1D497, + 0x1D498, + 0x1D499, + 0x1D49A, + 0x1D49B, + 0x1D49C, + 0x1D49D, + 0x1D49E, + 0x1D49F, + 0x1D4A0, + 0x1D4A2, + 0x1D4A3, + 0x1D4A5, + 0x1D4A6, + 0x1D4A7, + 0x1D4A9, + 0x1D4AA, + 0x1D4AB, + 0x1D4AC, + 0x1D4AD, + 0x1D4AE, + 0x1D4AF, + 0x1D4B0, + 0x1D4B1, + 0x1D4B2, + 0x1D4B3, + 0x1D4B4, + 0x1D4B5, + 0x1D4B6, + 0x1D4B7, + 0x1D4B8, + 0x1D4B9, + 0x1D4BA, + 0x1D4BB, + 0x1D4BC, + 0x1D4BD, + 0x1D4BE, + 0x1D4BF, + 0x1D4C0, + 0x1D4C1, + 0x1D4C2, + 0x1D4C3, + 0x1D4C4, + 0x1D4C5, + 0x1D4C6, + 0x1D4C7, + 0x1D4C8, + 0x1D4C9, + 0x1D4CA, + 0x1D4CB, + 0x1D4CC, + 0x1D4CD, + 0x1D4CE, + 0x1D4CF, + 0x1D4D0, + 0x1D4D1, + 0x1D4D2, + 0x1D4D3, + 0x1D4D4, + 0x1D4D5, + 0x1D4D6, + 0x1D4D7, + 0x1D4D8, + 0x1D4D9, + 0x1D4DA, + 0x1D4DB, + 0x1D4DC, + 0x1D4DD, + 0x1D4DE, + 0x1D4DF, + 0x1D4E0, + 0x1D4E1, + 0x1D4E2, + 0x1D4E3, + 0x1D4E4, + 0x1D4E5, + 0x1D4E6, + 0x1D4E7, + 0x1D4E8, + 0x1D4E9, + 0x1D4EA, + 0x1D4EB, + 0x1D4EC, + 0x1D4ED, + 0x1D4EE, + 0x1D4EF, + 0x1D4F0, + 0x1D4F1, + 0x1D4F2, + 0x1D4F3, + 0x1D4F4, + 0x1D4F5, + 0x1D4F6, + 0x1D4F7, + 0x1D4F8, + 0x1D4F9, + 0x1D4FA, + 0x1D4FB, + 0x1D4FC, + 0x1D4FD, + 0x1D4FE, + 0x1D4FF, + 0x1D500, + 0x1D501, + 0x1D502, + 0x1D503, + 0x1D504, + 0x1D505, + 0x1D506, + 0x1D507, + 0x1D508, + 0x1D509, + 0x1D50A, + 0x1D50B, + 0x1D50D, + 0x1D50E, + 0x1D50F, + 0x1D510, + 0x1D511, + 0x1D512, + 0x1D513, + 0x1D514, + 0x1D515, + 0x1D516, + 0x1D517, + 0x1D518, + 0x1D519, + 0x1D51A, + 0x1D51B, + 0x1D51C, + 0x1D51D, + 0x1D51E, + 0x1D51F, + 0x1D520, + 0x1D521, + 0x1D522, + 0x1D523, + 0x1D524, + 0x1D525, + 0x1D526, + 0x1D527, + 0x1D528, + 0x1D529, + 0x1D52A, + 0x1D52B, + 0x1D52C, + 0x1D52D, + 0x1D52E, + 0x1D52F, + 0x1D530, + 0x1D531, + 0x1D532, + 0x1D533, + 0x1D534, + 0x1D535, + 0x1D536, + 0x1D537, + 0x1D538, + 0x1D539, + 0x1D53A, + 0x1D53B, + 0x1D53C, + 0x1D53D, + 0x1D53E, + 0x1D53F, + 0x1D540, + 0x1D541, + 0x1D542, + 0x1D543, + 0x1D544, + 0x1D545, + 0x1D546, + 0x1D547, + 0x1D54A, + 0x1D54B, + 0x1D54C, + 0x1D54D, + 0x1D54E, + 0x1D54F, + 0x1D550, + 0x1D551, + 0x1D552, + 0x1D553, + 0x1D554, + 0x1D555, + 0x1D556, + 0x1D557, + 0x1D558, + 0x1D559, + 0x1D55A, + 0x1D55B, + 0x1D55C, + 0x1D55D, + 0x1D55E, + 0x1D55F, + 0x1D560, + 0x1D561, + 0x1D562, + 0x1D563, + 0x1D564, + 0x1D565, + 0x1D566, + 0x1D567, + 0x1D568, + 0x1D569, + 0x1D56A, + 0x1D56B, + 0x1D56C, + 0x1D56D, + 0x1D56E, + 0x1D56F, + 0x1D570, + 0x1D571, + 0x1D572, + 0x1D573, + 0x1D574, + 0x1D575, + 0x1D576, + 0x1D577, + 0x1D578, + 0x1D579, + 0x1D57A, + 0x1D57B, + 0x1D57C, + 0x1D57D, + 0x1D57E, + 0x1D57F, + 0x1D580, + 0x1D581, + 0x1D582, + 0x1D583, + 0x1D584, + 0x1D585, + 0x1D586, + 0x1D587, + 0x1D588, + 0x1D589, + 0x1D58A, + 0x1D58B, + 0x1D58C, + 0x1D58D, + 0x1D58E, + 0x1D58F, + 0x1D590, + 0x1D591, + 0x1D592, + 0x1D593, + 0x1D594, + 0x1D595, + 0x1D596, + 0x1D597, + 0x1D598, + 0x1D599, + 0x1D59A, + 0x1D59B, + 0x1D59C, + 0x1D59D, + 0x1D59E, + 0x1D59F, + 0x1D5A0, + 0x1D5A1, + 0x1D5A2, + 0x1D5A3, + 0x1D5A4, + 0x1D5A5, + 0x1D5A6, + 0x1D5A7, + 0x1D5A8, + 0x1D5A9, + 0x1D5AA, + 0x1D5AB, + 0x1D5AC, + 0x1D5AD, + 0x1D5AE, + 0x1D5AF, + 0x1D5B0, + 0x1D5B1, + 0x1D5B2, + 0x1D5B3, + 0x1D5B4, + 0x1D5B5, + 0x1D5B6, + 0x1D5B7, + 0x1D5B8, + 0x1D5B9, + 0x1D5BA, + 0x1D5BB, + 0x1D5BC, + 0x1D5BD, + 0x1D5BE, + 0x1D5BF, + 0x1D5C0, + 0x1D5C1, + 0x1D5C2, + 0x1D5C3, + 0x1D5C4, + 0x1D5C5, + 0x1D5C6, + 0x1D5C7, + 0x1D5C8, + 0x1D5C9, + 0x1D5CA, + 0x1D5CB, + 0x1D5CC, + 0x1D5CD, + 0x1D5CE, + 0x1D5CF, + 0x1D5D0, + 0x1D5D1, + 0x1D5D2, + 0x1D5D3, + 0x1D5D4, + 0x1D5D5, + 0x1D5D6, + 0x1D5D7, + 0x1D5D8, + 0x1D5D9, + 0x1D5DA, + 0x1D5DB, + 0x1D5DC, + 0x1D5DD, + 0x1D5DE, + 0x1D5DF, + 0x1D5E0, + 0x1D5E1, + 0x1D5E2, + 0x1D5E3, + 0x1D5E4, + 0x1D5E5, + 0x1D5E6, + 0x1D5E7, + 0x1D5E8, + 0x1D5E9, + 0x1D5EA, + 0x1D5EB, + 0x1D5EC, + 0x1D5ED, + 0x1D5EE, + 0x1D5EF, + 0x1D5F0, + 0x1D5F1, + 0x1D5F2, + 0x1D5F3, + 0x1D5F4, + 0x1D5F5, + 0x1D5F6, + 0x1D5F7, + 0x1D5F8, + 0x1D5F9, + 0x1D5FA, + 0x1D5FB, + 0x1D5FC, + 0x1D5FD, + 0x1D5FE, + 0x1D5FF, + 0x1D600, + 0x1D601, + 0x1D602, + 0x1D603, + 0x1D604, + 0x1D605, + 0x1D606, + 0x1D607, + 0x1D608, + 0x1D609, + 0x1D60A, + 0x1D60B, + 0x1D60C, + 0x1D60D, + 0x1D60E, + 0x1D60F, + 0x1D610, + 0x1D611, + 0x1D612, + 0x1D613, + 0x1D614, + 0x1D615, + 0x1D616, + 0x1D617, + 0x1D618, + 0x1D619, + 0x1D61A, + 0x1D61B, + 0x1D61C, + 0x1D61D, + 0x1D61E, + 0x1D61F, + 0x1D620, + 0x1D621, + 0x1D622, + 0x1D623, + 0x1D624, + 0x1D625, + 0x1D626, + 0x1D627, + 0x1D628, + 0x1D629, + 0x1D62A, + 0x1D62B, + 0x1D62C, + 0x1D62D, + 0x1D62E, + 0x1D62F, + 0x1D630, + 0x1D631, + 0x1D632, + 0x1D633, + 0x1D634, + 0x1D635, + 0x1D636, + 0x1D637, + 0x1D638, + 0x1D639, + 0x1D63A, + 0x1D63B, + 0x1D63C, + 0x1D63D, + 0x1D63E, + 0x1D63F, + 0x1D640, + 0x1D641, + 0x1D642, + 0x1D643, + 0x1D644, + 0x1D645, + 0x1D646, + 0x1D647, + 0x1D648, + 0x1D649, + 0x1D64A, + 0x1D64B, + 0x1D64C, + 0x1D64D, + 0x1D64E, + 0x1D64F, + 0x1D650, + 0x1D651, + 0x1D652, + 0x1D653, + 0x1D654, + 0x1D655, + 0x1D656, + 0x1D657, + 0x1D658, + 0x1D659, + 0x1D65A, + 0x1D65B, + 0x1D65C, + 0x1D65D, + 0x1D65E, + 0x1D65F, + 0x1D660, + 0x1D661, + 0x1D662, + 0x1D663, + 0x1D664, + 0x1D665, + 0x1D666, + 0x1D667, + 0x1D668, + 0x1D669, + 0x1D66A, + 0x1D66B, + 0x1D66C, + 0x1D66D, + 0x1D66E, + 0x1D66F, + 0x1D670, + 0x1D671, + 0x1D672, + 0x1D673, + 0x1D674, + 0x1D675, + 0x1D676, + 0x1D677, + 0x1D678, + 0x1D679, + 0x1D67A, + 0x1D67B, + 0x1D67C, + 0x1D67D, + 0x1D67E, + 0x1D67F, + 0x1D680, + 0x1D681, + 0x1D682, + 0x1D683, + 0x1D684, + 0x1D685, + 0x1D686, + 0x1D687, + 0x1D688, + 0x1D689, + 0x1D68A, + 0x1D68B, + 0x1D68C, + 0x1D68D, + 0x1D68E, + 0x1D68F, + 0x1D690, + 0x1D691, + 0x1D692, + 0x1D693, + 0x1D694, + 0x1D695, + 0x1D696, + 0x1D697, + 0x1D698, + 0x1D699, + 0x1D69A, + 0x1D69B, + 0x1D69C, + 0x1D69D, + 0x1D69E, + 0x1D69F, + 0x1D6A0, + 0x1D6A1, + 0x1D6A2, + 0x1D6A3, + 0x1D6A4, + 0x1D6A5, + 0x1D6A6, + 0x1D6A7, + 0x1D6A8, + 0x1D6A9, + 0x1D6AA, + 0x1D6AB, + 0x1D6AC, + 0x1D6AD, + 0x1D6AE, + 0x1D6AF, + 0x1D6B0, + 0x1D6B1, + 0x1D6B2, + 0x1D6B3, + 0x1D6B4, + 0x1D6B5, + 0x1D6B6, + 0x1D6B7, + 0x1D6B8, + 0x1D6B9, + 0x1D6BA, + 0x1D6BB, + 0x1D6BC, + 0x1D6BD, + 0x1D6BE, + 0x1D6BF, + 0x1D6C0, + 0x1D6C1, + 0x1D6C2, + 0x1D6C3, + 0x1D6C4, + 0x1D6C5, + 0x1D6C6, + 0x1D6C7, + 0x1D6C8, + 0x1D6C9, + 0x1D6CA, + 0x1D6CB, + 0x1D6CC, + 0x1D6CD, + 0x1D6CE, + 0x1D6CF, + 0x1D6D0, + 0x1D6D1, + 0x1D6D2, + 0x1D6D3, + 0x1D6D5, + 0x1D6D6, + 0x1D6D7, + 0x1D6D8, + 0x1D6D9, + 0x1D6DA, + 0x1D6DB, + 0x1D6DC, + 0x1D6DD, + 0x1D6DE, + 0x1D6DF, + 0x1D6E0, + 0x1D6E1, + 0x1D6E2, + 0x1D6E3, + 0x1D6E4, + 0x1D6E5, + 0x1D6E6, + 0x1D6E7, + 0x1D6E8, + 0x1D6E9, + 0x1D6EA, + 0x1D6EB, + 0x1D6EC, + 0x1D6ED, + 0x1D6EE, + 0x1D6EF, + 0x1D6F0, + 0x1D6F1, + 0x1D6F2, + 0x1D6F3, + 0x1D6F4, + 0x1D6F5, + 0x1D6F6, + 0x1D6F7, + 0x1D6F8, + 0x1D6F9, + 0x1D6FA, + 0x1D6FB, + 0x1D6FC, + 0x1D6FD, + 0x1D6FE, + 0x1D6FF, + 0x1D700, + 0x1D701, + 0x1D702, + 0x1D703, + 0x1D704, + 0x1D705, + 0x1D706, + 0x1D707, + 0x1D708, + 0x1D709, + 0x1D70A, + 0x1D70B, + 0x1D70C, + 0x1D70D, + 0x1D70F, + 0x1D710, + 0x1D711, + 0x1D712, + 0x1D713, + 0x1D714, + 0x1D715, + 0x1D716, + 0x1D717, + 0x1D718, + 0x1D719, + 0x1D71A, + 0x1D71B, + 0x1D71C, + 0x1D71D, + 0x1D71E, + 0x1D71F, + 0x1D720, + 0x1D721, + 0x1D722, + 0x1D723, + 0x1D724, + 0x1D725, + 0x1D726, + 0x1D727, + 0x1D728, + 0x1D729, + 0x1D72A, + 0x1D72B, + 0x1D72C, + 0x1D72D, + 0x1D72E, + 0x1D72F, + 0x1D730, + 0x1D731, + 0x1D732, + 0x1D733, + 0x1D734, + 0x1D735, + 0x1D736, + 0x1D737, + 0x1D738, + 0x1D739, + 0x1D73A, + 0x1D73B, + 0x1D73C, + 0x1D73D, + 0x1D73E, + 0x1D73F, + 0x1D740, + 0x1D741, + 0x1D742, + 0x1D743, + 0x1D744, + 0x1D745, + 0x1D746, + 0x1D747, + 0x1D749, + 0x1D74A, + 0x1D74B, + 0x1D74C, + 0x1D74D, + 0x1D74E, + 0x1D74F, + 0x1D750, + 0x1D751, + 0x1D752, + 0x1D753, + 0x1D754, + 0x1D755, + 0x1D756, + 0x1D757, + 0x1D758, + 0x1D759, + 0x1D75A, + 0x1D75B, + 0x1D75C, + 0x1D75D, + 0x1D75E, + 0x1D75F, + 0x1D760, + 0x1D761, + 0x1D762, + 0x1D763, + 0x1D764, + 0x1D765, + 0x1D766, + 0x1D767, + 0x1D768, + 0x1D769, + 0x1D76A, + 0x1D76B, + 0x1D76C, + 0x1D76D, + 0x1D76E, + 0x1D76F, + 0x1D770, + 0x1D771, + 0x1D772, + 0x1D773, + 0x1D774, + 0x1D775, + 0x1D776, + 0x1D777, + 0x1D778, + 0x1D779, + 0x1D77A, + 0x1D77B, + 0x1D77C, + 0x1D77D, + 0x1D77E, + 0x1D77F, + 0x1D780, + 0x1D781, + 0x1D783, + 0x1D784, + 0x1D785, + 0x1D786, + 0x1D787, + 0x1D788, + 0x1D789, + 0x1D78A, + 0x1D78B, + 0x1D78C, + 0x1D78D, + 0x1D78E, + 0x1D78F, + 0x1D790, + 0x1D791, + 0x1D792, + 0x1D793, + 0x1D794, + 0x1D795, + 0x1D796, + 0x1D797, + 0x1D798, + 0x1D799, + 0x1D79A, + 0x1D79B, + 0x1D79C, + 0x1D79D, + 0x1D79E, + 0x1D79F, + 0x1D7A0, + 0x1D7A1, + 0x1D7A2, + 0x1D7A3, + 0x1D7A4, + 0x1D7A5, + 0x1D7A6, + 0x1D7A7, + 0x1D7A8, + 0x1D7A9, + 0x1D7AA, + 0x1D7AB, + 0x1D7AC, + 0x1D7AD, + 0x1D7AE, + 0x1D7AF, + 0x1D7B0, + 0x1D7B1, + 0x1D7B2, + 0x1D7B3, + 0x1D7B4, + 0x1D7B5, + 0x1D7B6, + 0x1D7B7, + 0x1D7B8, + 0x1D7B9, + 0x1D7BA, + 0x1D7BB, + 0x1D7BD, + 0x1D7BE, + 0x1D7BF, + 0x1D7C0, + 0x1D7C1, + 0x1D7C2, + 0x1D7C3, + 0x1D7C4, + 0x1D7C5, + 0x1D7C6, + 0x1D7C7, + 0x1D7C8, + 0x1D7C9, + 0x1D7CA, + 0x1D7CC, + 0x1D7CE, + 0x1D7CF, + 0x1D7D0, + 0x1D7D1, + 0x1D7D2, + 0x1D7D3, + 0x1D7D4, + 0x1D7D5, + 0x1D7D6, + 0x1D7D7, + 0x1D7D8, + 0x1D7D9, + 0x1D7DA, + 0x1D7DB, + 0x1D7DC, + 0x1D7DD, + 0x1D7DE, + 0x1D7DF, + 0x1D7E0, + 0x1D7E1, + 0x1D7E2, + 0x1D7E3, + 0x1D7E4, + 0x1D7E5, + 0x1D7E6, + 0x1D7E7, + 0x1D7E8, + 0x1D7E9, + 0x1D7EA, + 0x1D7EB, + 0x1D7EC, + 0x1D7ED, + 0x1D7EE, + 0x1D7EF, + 0x1D7F0, + 0x1D7F1, + 0x1D7F2, + 0x1D7F3, + 0x1D7F4, + 0x1D7F5, + 0x1D7F6, + 0x1D7F7, + 0x1D7F8, + 0x1D7F9, + 0x1D7FA, + 0x1D7FB, + 0x1D7FC, + 0x1D7FD, + 0x1D7FE, + 0x1D7FF, + 0x1D800, + 0x1DA8C, + 0x1DA9B, + 0x1DAA0, + 0x1DAA1, + 0x1DAB0, + 0x1DB00, + 0x1DB1D, + 0x1DF00, + 0x1DF40, + 0x1DF41, + 0x1DF48, + 0x1DF49, + 0x1DF4A, + 0x1DF4B, + 0x1DF4D, + 0x1DF4E, + 0x1DF51, + 0x1DF52, + 0x1DF68, + 0x1DF69, + 0x1DF6A, + 0x1DF6B, + 0x1DF6C, + 0x1DF6D, + 0x1DF6E, + 0x1DF6F, + 0x1DF72, + 0x1DF73, + 0x1DF74, + 0x1DF75, + 0x1DF76, + 0x1DF77, + 0x1DF78, + 0x1DF79, + 0x1DF7A, + 0x1DF7B, + 0x1DF7C, + 0x1DF7D, + 0x1DF7E, + 0x1DF7F, + 0x1DF82, + 0x1DF90, + 0x1DF95, + 0x1DF96, + 0x1DF97, + 0x1DFCD, + 0x1DFCE, + 0x1DFCF, + 0x1DFD0, + 0x1DFD1, + 0x1DFD2, + 0x1DFD3, + 0x1DFD4, + 0x1DFD5, + 0x1DFD6, + 0x1DFD7, + 0x1DFD8, + 0x1DFD9, + 0x1DFDA, + 0x1DFDB, + 0x1DFDC, + 0x1DFDD, + 0x1DFDE, + 0x1DFDF, + 0x1DFE0, + 0x1DFE1, + 0x1DFE2, + 0x1DFE3, + 0x1DFE4, + 0x1DFE5, + 0x1DFE6, + 0x1DFE7, + 0x1DFE8, + 0x1DFE9, + 0x1DFEA, + 0x1DFEB, + 0x1DFEC, + 0x1DFED, + 0x1DFEE, + 0x1DFEF, + 0x1DFF0, + 0x1DFF1, + 0x1DFF2, + 0x1DFF3, + 0x1DFF4, + 0x1DFF5, + 0x1DFF6, + 0x1DFF7, + 0x1DFF8, + 0x1DFF9, + 0x1DFFA, + 0x1DFFB, + 0x1DFFC, + 0x1DFFD, + 0x1DFFE, + 0x1DFFF, + 0x1E000, + 0x1E007, + 0x1E008, + 0x1E019, + 0x1E01B, + 0x1E022, + 0x1E023, + 0x1E025, + 0x1E026, + 0x1E02B, + 0x1E030, + 0x1E031, + 0x1E032, + 0x1E033, + 0x1E034, + 0x1E035, + 0x1E036, + 0x1E037, + 0x1E038, + 0x1E039, + 0x1E03A, + 0x1E03B, + 0x1E03C, + 0x1E03D, + 0x1E03E, + 0x1E03F, + 0x1E040, + 0x1E041, + 0x1E042, + 0x1E043, + 0x1E044, + 0x1E045, + 0x1E046, + 0x1E047, + 0x1E048, + 0x1E049, + 0x1E04A, + 0x1E04B, + 0x1E04C, + 0x1E04D, + 0x1E04E, + 0x1E04F, + 0x1E050, + 0x1E051, + 0x1E052, + 0x1E053, + 0x1E054, + 0x1E055, + 0x1E056, + 0x1E057, + 0x1E058, + 0x1E059, + 0x1E05A, + 0x1E05B, + 0x1E05C, + 0x1E05D, + 0x1E05E, + 0x1E05F, + 0x1E060, + 0x1E061, + 0x1E062, + 0x1E063, + 0x1E064, + 0x1E065, + 0x1E066, + 0x1E067, + 0x1E068, + 0x1E069, + 0x1E06A, + 0x1E06B, + 0x1E06C, + 0x1E06D, + 0x1E06E, + 0x1E08F, + 0x1E090, + 0x1E100, + 0x1E12D, + 0x1E130, + 0x1E13E, + 0x1E140, + 0x1E14A, + 0x1E14E, + 0x1E150, + 0x1E290, + 0x1E2AF, + 0x1E2C0, + 0x1E2FA, + 0x1E2FF, + 0x1E300, + 0x1E4D0, + 0x1E4FA, + 0x1E5D0, + 0x1E5FB, + 0x1E5FF, + 0x1E600, + 0x1E6C0, + 0x1E6DF, + 0x1E6E0, + 0x1E6F6, + 0x1E6FE, + 0x1E700, + 0x1E7E0, + 0x1E7E7, + 0x1E7E8, + 0x1E7EC, + 0x1E7ED, + 0x1E7EF, + 0x1E7F0, + 0x1E7FF, + 0x1E800, + 0x1E8C5, + 0x1E8C7, + 0x1E8D7, + 0x1E900, + 0x1E901, + 0x1E902, + 0x1E903, + 0x1E904, + 0x1E905, + 0x1E906, + 0x1E907, + 0x1E908, + 0x1E909, + 0x1E90A, + 0x1E90B, + 0x1E90C, + 0x1E90D, + 0x1E90E, + 0x1E90F, + 0x1E910, + 0x1E911, + 0x1E912, + 0x1E913, + 0x1E914, + 0x1E915, + 0x1E916, + 0x1E917, + 0x1E918, + 0x1E919, + 0x1E91A, + 0x1E91B, + 0x1E91C, + 0x1E91D, + 0x1E91E, + 0x1E91F, + 0x1E920, + 0x1E921, + 0x1E922, + 0x1E94C, + 0x1E950, + 0x1E95A, + 0x1E95E, + 0x1E960, + 0x1EC71, + 0x1ECB5, + 0x1ED01, + 0x1ED3E, + 0x1EE00, + 0x1EE01, + 0x1EE02, + 0x1EE03, + 0x1EE04, + 0x1EE05, + 0x1EE06, + 0x1EE07, + 0x1EE08, + 0x1EE09, + 0x1EE0A, + 0x1EE0B, + 0x1EE0C, + 0x1EE0D, + 0x1EE0E, + 0x1EE0F, + 0x1EE10, + 0x1EE11, + 0x1EE12, + 0x1EE13, + 0x1EE14, + 0x1EE15, + 0x1EE16, + 0x1EE17, + 0x1EE18, + 0x1EE19, + 0x1EE1A, + 0x1EE1B, + 0x1EE1C, + 0x1EE1D, + 0x1EE1E, + 0x1EE1F, + 0x1EE20, + 0x1EE21, + 0x1EE22, + 0x1EE23, + 0x1EE24, + 0x1EE25, + 0x1EE27, + 0x1EE28, + 0x1EE29, + 0x1EE2A, + 0x1EE2B, + 0x1EE2C, + 0x1EE2D, + 0x1EE2E, + 0x1EE2F, + 0x1EE30, + 0x1EE31, + 0x1EE32, + 0x1EE33, + 0x1EE34, + 0x1EE35, + 0x1EE36, + 0x1EE37, + 0x1EE38, + 0x1EE39, + 0x1EE3A, + 0x1EE3B, + 0x1EE3C, + 0x1EE42, + 0x1EE43, + 0x1EE47, + 0x1EE48, + 0x1EE49, + 0x1EE4A, + 0x1EE4B, + 0x1EE4C, + 0x1EE4D, + 0x1EE4E, + 0x1EE4F, + 0x1EE50, + 0x1EE51, + 0x1EE52, + 0x1EE53, + 0x1EE54, + 0x1EE55, + 0x1EE57, + 0x1EE58, + 0x1EE59, + 0x1EE5A, + 0x1EE5B, + 0x1EE5C, + 0x1EE5D, + 0x1EE5E, + 0x1EE5F, + 0x1EE60, + 0x1EE61, + 0x1EE62, + 0x1EE63, + 0x1EE64, + 0x1EE65, + 0x1EE67, + 0x1EE68, + 0x1EE69, + 0x1EE6A, + 0x1EE6B, + 0x1EE6C, + 0x1EE6D, + 0x1EE6E, + 0x1EE6F, + 0x1EE70, + 0x1EE71, + 0x1EE72, + 0x1EE73, + 0x1EE74, + 0x1EE75, + 0x1EE76, + 0x1EE77, + 0x1EE78, + 0x1EE79, + 0x1EE7A, + 0x1EE7B, + 0x1EE7C, + 0x1EE7D, + 0x1EE7E, + 0x1EE7F, + 0x1EE80, + 0x1EE81, + 0x1EE82, + 0x1EE83, + 0x1EE84, + 0x1EE85, + 0x1EE86, + 0x1EE87, + 0x1EE88, + 0x1EE89, + 0x1EE8A, + 0x1EE8B, + 0x1EE8C, + 0x1EE8D, + 0x1EE8E, + 0x1EE8F, + 0x1EE90, + 0x1EE91, + 0x1EE92, + 0x1EE93, + 0x1EE94, + 0x1EE95, + 0x1EE96, + 0x1EE97, + 0x1EE98, + 0x1EE99, + 0x1EE9A, + 0x1EE9B, + 0x1EE9C, + 0x1EEA1, + 0x1EEA2, + 0x1EEA3, + 0x1EEA4, + 0x1EEA5, + 0x1EEA6, + 0x1EEA7, + 0x1EEA8, + 0x1EEA9, + 0x1EEAA, + 0x1EEAB, + 0x1EEAC, + 0x1EEAD, + 0x1EEAE, + 0x1EEAF, + 0x1EEB0, + 0x1EEB1, + 0x1EEB2, + 0x1EEB3, + 0x1EEB4, + 0x1EEB5, + 0x1EEB6, + 0x1EEB7, + 0x1EEB8, + 0x1EEB9, + 0x1EEBA, + 0x1EEBB, + 0x1EEBC, + 0x1EEF0, + 0x1EEF2, + 0x1F000, + 0x1F02C, + 0x1F030, + 0x1F094, + 0x1F0A0, + 0x1F0AF, + 0x1F0B1, + 0x1F0C0, + 0x1F0C1, + 0x1F0D0, + 0x1F0D1, + 0x1F0F6, + 0x1F101, + 0x1F102, + 0x1F103, + 0x1F104, + 0x1F105, + 0x1F106, + 0x1F107, + 0x1F108, + 0x1F109, + 0x1F10A, + 0x1F10B, + 0x1F110, + 0x1F111, + 0x1F112, + 0x1F113, + 0x1F114, + 0x1F115, + 0x1F116, + 0x1F117, + 0x1F118, + 0x1F119, + 0x1F11A, + 0x1F11B, + 0x1F11C, + 0x1F11D, + 0x1F11E, + 0x1F11F, + 0x1F120, + 0x1F121, + 0x1F122, + 0x1F123, + 0x1F124, + 0x1F125, + 0x1F126, + 0x1F127, + 0x1F128, + 0x1F129, + 0x1F12A, + 0x1F12B, + 0x1F12C, + 0x1F12D, + 0x1F12E, + 0x1F12F, + 0x1F130, + 0x1F131, + 0x1F132, + 0x1F133, + 0x1F134, + 0x1F135, + 0x1F136, + 0x1F137, + 0x1F138, + 0x1F139, + 0x1F13A, + 0x1F13B, + 0x1F13C, + 0x1F13D, + 0x1F13E, + 0x1F13F, + 0x1F140, + 0x1F141, + 0x1F142, + 0x1F143, + 0x1F144, + 0x1F145, + 0x1F146, + 0x1F147, + 0x1F148, + 0x1F149, + 0x1F14A, + 0x1F14B, + 0x1F14C, + 0x1F14D, + 0x1F14E, + 0x1F14F, + 0x1F150, + 0x1F16A, + 0x1F16B, + 0x1F16C, + 0x1F16D, + 0x1F190, + 0x1F191, + 0x1F1AF, + 0x1F1E6, + 0x1F200, + 0x1F201, + 0x1F202, + 0x1F203, + 0x1F210, + 0x1F211, + 0x1F212, + 0x1F213, + 0x1F214, + 0x1F215, + 0x1F216, + 0x1F217, + 0x1F218, + 0x1F219, + 0x1F21A, + 0x1F21B, + 0x1F21C, + 0x1F21D, + 0x1F21E, + 0x1F21F, + 0x1F220, + 0x1F221, + 0x1F222, + 0x1F223, + 0x1F224, + 0x1F225, + 0x1F226, + 0x1F227, + 0x1F228, + 0x1F229, + 0x1F22A, + 0x1F22B, + 0x1F22C, + 0x1F22D, + 0x1F22E, + 0x1F22F, + 0x1F230, + 0x1F231, + 0x1F232, + 0x1F233, + 0x1F234, + 0x1F235, + 0x1F236, + 0x1F237, + 0x1F238, + 0x1F239, + 0x1F23A, + 0x1F23B, + 0x1F23C, + 0x1F240, + 0x1F241, + 0x1F242, + 0x1F243, + 0x1F244, + 0x1F245, + 0x1F246, + 0x1F247, + 0x1F248, + 0x1F249, + 0x1F250, + 0x1F251, + 0x1F252, + 0x1F260, + 0x1F266, + 0x1F300, + 0x1F6DA, + 0x1F6DC, + 0x1F6ED, + 0x1F6F0, + 0x1F6FD, + 0x1F700, + 0x1F7DC, + 0x1F7E0, + 0x1F7EC, + 0x1F7F0, + 0x1F80C, + 0x1F810, + 0x1F848, + 0x1F850, + 0x1F85A, + 0x1F860, + 0x1F888, + 0x1F890, + 0x1F8AE, + 0x1F8B0, + 0x1F8BC, + 0x1F8C0, + 0x1F8C2, + 0x1F8D0, + 0x1F8D9, + 0x1F900, + 0x1FA58, + 0x1FA60, + 0x1FA6E, + 0x1FA70, + 0x1FA7D, + 0x1FA80, + 0x1FAC7, + 0x1FAC8, + 0x1FAC9, + 0x1FACC, + 0x1FADE, + 0x1FADF, + 0x1FAEC, + 0x1FAEF, + 0x1FAFB, + 0x1FB00, + 0x1FB93, + 0x1FB94, + 0x1FBF0, + 0x1FBF1, + 0x1FBF2, + 0x1FBF3, + 0x1FBF4, + 0x1FBF5, + 0x1FBF6, + 0x1FBF7, + 0x1FBF8, + 0x1FBF9, + 0x1FBFA, + 0x1FBFB, + 0x20000, + 0x2A6E0, + 0x2A700, + 0x2B81F, + 0x2B820, + 0x2CEAE, + 0x2CEB0, + 0x2EBE1, + 0x2EBF0, + 0x2EE5E, + 0x2F800, + 0x2F801, + 0x2F802, + 0x2F803, + 0x2F804, + 0x2F805, + 0x2F806, + 0x2F807, + 0x2F808, + 0x2F809, + 0x2F80A, + 0x2F80B, + 0x2F80C, + 0x2F80D, + 0x2F80E, + 0x2F80F, + 0x2F810, + 0x2F811, + 0x2F812, + 0x2F813, + 0x2F814, + 0x2F815, + 0x2F816, + 0x2F817, + 0x2F818, + 0x2F819, + 0x2F81A, + 0x2F81B, + 0x2F81C, + 0x2F81D, + 0x2F81E, + 0x2F81F, + 0x2F820, + 0x2F821, + 0x2F822, + 0x2F823, + 0x2F824, + 0x2F825, + 0x2F826, + 0x2F827, + 0x2F828, + 0x2F829, + 0x2F82A, + 0x2F82B, + 0x2F82C, + 0x2F82D, + 0x2F82E, + 0x2F82F, + 0x2F830, + 0x2F831, + 0x2F834, + 0x2F835, + 0x2F836, + 0x2F837, + 0x2F838, + 0x2F839, + 0x2F83A, + 0x2F83B, + 0x2F83C, + 0x2F83D, + 0x2F83E, + 0x2F83F, + 0x2F840, + 0x2F841, + 0x2F842, + 0x2F843, + 0x2F844, + 0x2F845, + 0x2F847, + 0x2F848, + 0x2F849, + 0x2F84A, + 0x2F84B, + 0x2F84C, + 0x2F84D, + 0x2F84E, + 0x2F84F, + 0x2F850, + 0x2F851, + 0x2F852, + 0x2F853, + 0x2F854, + 0x2F855, + 0x2F856, + 0x2F857, + 0x2F858, + 0x2F859, + 0x2F85A, + 0x2F85B, + 0x2F85C, + 0x2F85D, + 0x2F85E, + 0x2F85F, + 0x2F860, + 0x2F861, + 0x2F862, + 0x2F863, + 0x2F864, + 0x2F865, + 0x2F866, + 0x2F867, + 0x2F868, + 0x2F869, + 0x2F86A, + 0x2F86C, + 0x2F86D, + 0x2F86E, + 0x2F86F, + 0x2F870, + 0x2F871, + 0x2F872, + 0x2F873, + 0x2F874, + 0x2F875, + 0x2F876, + 0x2F877, + 0x2F878, + 0x2F879, + 0x2F87A, + 0x2F87B, + 0x2F87C, + 0x2F87D, + 0x2F87E, + 0x2F87F, + 0x2F880, + 0x2F881, + 0x2F882, + 0x2F883, + 0x2F884, + 0x2F885, + 0x2F886, + 0x2F887, + 0x2F888, + 0x2F889, + 0x2F88A, + 0x2F88B, + 0x2F88C, + 0x2F88D, + 0x2F88E, + 0x2F88F, + 0x2F890, + 0x2F891, + 0x2F893, + 0x2F894, + 0x2F896, + 0x2F897, + 0x2F898, + 0x2F899, + 0x2F89A, + 0x2F89B, + 0x2F89C, + 0x2F89D, + 0x2F89E, + 0x2F89F, + 0x2F8A0, + 0x2F8A1, + 0x2F8A2, + 0x2F8A3, + 0x2F8A4, + 0x2F8A5, + 0x2F8A6, + 0x2F8A7, + 0x2F8A8, + 0x2F8A9, + 0x2F8AA, + 0x2F8AB, + 0x2F8AC, + 0x2F8AD, + 0x2F8AE, + 0x2F8AF, + 0x2F8B0, + 0x2F8B1, + 0x2F8B2, + 0x2F8B3, + 0x2F8B4, + 0x2F8B5, + 0x2F8B6, + 0x2F8B7, + 0x2F8B8, + 0x2F8B9, + 0x2F8BA, + 0x2F8BB, + 0x2F8BC, + 0x2F8BD, + 0x2F8BE, + 0x2F8BF, + 0x2F8C0, + 0x2F8C1, + 0x2F8C2, + 0x2F8C3, + 0x2F8C4, + 0x2F8C5, + 0x2F8C6, + 0x2F8C7, + 0x2F8C8, + 0x2F8C9, + 0x2F8CA, + 0x2F8CB, + 0x2F8CC, + 0x2F8CD, + 0x2F8CE, + 0x2F8CF, + 0x2F8D0, + 0x2F8D1, + 0x2F8D2, + 0x2F8D3, + 0x2F8D4, + 0x2F8D5, + 0x2F8D6, + 0x2F8D7, + 0x2F8D8, + 0x2F8D9, + 0x2F8DA, + 0x2F8DB, + 0x2F8DC, + 0x2F8DD, + 0x2F8DE, + 0x2F8DF, + 0x2F8E0, + 0x2F8E1, + 0x2F8E2, + 0x2F8E3, + 0x2F8E4, + 0x2F8E5, + 0x2F8E6, + 0x2F8E7, + 0x2F8E8, + 0x2F8E9, + 0x2F8EA, + 0x2F8EB, + 0x2F8EC, + 0x2F8ED, + 0x2F8EE, + 0x2F8EF, + 0x2F8F0, + 0x2F8F1, + 0x2F8F2, + 0x2F8F3, + 0x2F8F4, + 0x2F8F5, + 0x2F8F6, + 0x2F8F7, + 0x2F8F8, + 0x2F8F9, + 0x2F8FA, + 0x2F8FB, + 0x2F8FC, + 0x2F8FD, + 0x2F8FE, + 0x2F8FF, + 0x2F900, + 0x2F901, + 0x2F902, + 0x2F903, + 0x2F904, + 0x2F905, + 0x2F906, + 0x2F907, + 0x2F908, + 0x2F909, + 0x2F90A, + 0x2F90B, + 0x2F90C, + 0x2F90D, + 0x2F90E, + 0x2F90F, + 0x2F910, + 0x2F911, + 0x2F912, + 0x2F913, + 0x2F914, + 0x2F915, + 0x2F916, + 0x2F917, + 0x2F918, + 0x2F919, + 0x2F91A, + 0x2F91B, + 0x2F91C, + 0x2F91D, + 0x2F91E, + 0x2F91F, + 0x2F920, + 0x2F921, + 0x2F922, + 0x2F923, + 0x2F924, + 0x2F925, + 0x2F926, + 0x2F927, + 0x2F928, + 0x2F929, + 0x2F92A, + 0x2F92B, + 0x2F92C, + 0x2F92E, + 0x2F92F, + 0x2F930, + 0x2F931, + 0x2F932, + 0x2F933, + 0x2F934, + 0x2F935, + 0x2F936, + 0x2F937, + 0x2F938, + 0x2F939, + 0x2F93A, + 0x2F93B, + 0x2F93C, + 0x2F93D, + 0x2F93E, + 0x2F93F, + 0x2F940, + 0x2F941, + 0x2F942, + 0x2F943, + 0x2F944, + 0x2F945, + 0x2F946, + 0x2F948, + 0x2F949, + 0x2F94A, + 0x2F94B, + 0x2F94C, + 0x2F94D, + 0x2F94E, + 0x2F94F, + 0x2F950, + 0x2F951, + 0x2F952, + 0x2F953, + 0x2F954, + 0x2F955, + 0x2F956, + 0x2F957, + 0x2F958, + 0x2F959, + 0x2F95A, + 0x2F95B, + 0x2F95C, + 0x2F95D, + 0x2F95F, + 0x2F960, + 0x2F961, + 0x2F962, + 0x2F963, + 0x2F964, + 0x2F965, + 0x2F966, + 0x2F967, + 0x2F968, + 0x2F969, + 0x2F96A, + 0x2F96B, + 0x2F96C, + 0x2F96D, + 0x2F96E, + 0x2F96F, + 0x2F970, + 0x2F971, + 0x2F972, + 0x2F973, + 0x2F974, + 0x2F975, + 0x2F976, + 0x2F977, + 0x2F978, + 0x2F979, + 0x2F97A, + 0x2F97B, + 0x2F97C, + 0x2F97D, + 0x2F97E, + 0x2F97F, + 0x2F980, + 0x2F981, + 0x2F982, + 0x2F983, + 0x2F984, + 0x2F985, + 0x2F986, + 0x2F987, + 0x2F988, + 0x2F989, + 0x2F98A, + 0x2F98B, + 0x2F98C, + 0x2F98D, + 0x2F98E, + 0x2F98F, + 0x2F990, + 0x2F991, + 0x2F992, + 0x2F993, + 0x2F994, + 0x2F995, + 0x2F996, + 0x2F997, + 0x2F998, + 0x2F999, + 0x2F99A, + 0x2F99B, + 0x2F99C, + 0x2F99D, + 0x2F99E, + 0x2F99F, + 0x2F9A0, + 0x2F9A1, + 0x2F9A2, + 0x2F9A3, + 0x2F9A4, + 0x2F9A5, + 0x2F9A6, + 0x2F9A7, + 0x2F9A8, + 0x2F9A9, + 0x2F9AA, + 0x2F9AB, + 0x2F9AC, + 0x2F9AD, + 0x2F9AE, + 0x2F9AF, + 0x2F9B0, + 0x2F9B1, + 0x2F9B2, + 0x2F9B3, + 0x2F9B4, + 0x2F9B5, + 0x2F9B6, + 0x2F9B7, + 0x2F9B8, + 0x2F9B9, + 0x2F9BA, + 0x2F9BB, + 0x2F9BC, + 0x2F9BD, + 0x2F9BE, + 0x2F9BF, + 0x2F9C0, + 0x2F9C1, + 0x2F9C2, + 0x2F9C3, + 0x2F9C4, + 0x2F9C5, + 0x2F9C6, + 0x2F9C7, + 0x2F9C8, + 0x2F9C9, + 0x2F9CA, + 0x2F9CB, + 0x2F9CC, + 0x2F9CD, + 0x2F9CE, + 0x2F9CF, + 0x2F9D0, + 0x2F9D1, + 0x2F9D2, + 0x2F9D3, + 0x2F9D4, + 0x2F9D5, + 0x2F9D6, + 0x2F9D7, + 0x2F9D8, + 0x2F9D9, + 0x2F9DA, + 0x2F9DB, + 0x2F9DC, + 0x2F9DD, + 0x2F9DE, + 0x2F9DF, + 0x2F9E0, + 0x2F9E1, + 0x2F9E2, + 0x2F9E3, + 0x2F9E4, + 0x2F9E5, + 0x2F9E6, + 0x2F9E7, + 0x2F9E8, + 0x2F9E9, + 0x2F9EA, + 0x2F9EB, + 0x2F9EC, + 0x2F9ED, + 0x2F9EE, + 0x2F9EF, + 0x2F9F0, + 0x2F9F1, + 0x2F9F2, + 0x2F9F3, + 0x2F9F4, + 0x2F9F5, + 0x2F9F6, + 0x2F9F7, + 0x2F9F8, + 0x2F9F9, + 0x2F9FA, + 0x2F9FB, + 0x2F9FC, + 0x2F9FD, + 0x2F9FE, + 0x2FA00, + 0x2FA01, + 0x2FA02, + 0x2FA03, + 0x2FA04, + 0x2FA05, + 0x2FA06, + 0x2FA07, + 0x2FA08, + 0x2FA09, + 0x2FA0A, + 0x2FA0B, + 0x2FA0C, + 0x2FA0D, + 0x2FA0E, + 0x2FA0F, + 0x2FA10, + 0x2FA11, + 0x2FA12, + 0x2FA13, + 0x2FA14, + 0x2FA15, + 0x2FA16, + 0x2FA17, + 0x2FA18, + 0x2FA19, + 0x2FA1A, + 0x2FA1B, + 0x2FA1C, + 0x2FA1D, + 0x2FA1E, + 0x30000, + 0x3134B, + 0x31350, + 0x3347A, + 0x3D000, + 0x3FC40, + 0xE0100, + 0xE01F0, + ), +) -def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x0, "V"), - (0x1, "V"), - (0x2, "V"), - (0x3, "V"), - (0x4, "V"), - (0x5, "V"), - (0x6, "V"), - (0x7, "V"), - (0x8, "V"), - (0x9, "V"), - (0xA, "V"), - (0xB, "V"), - (0xC, "V"), - (0xD, "V"), - (0xE, "V"), - (0xF, "V"), - (0x10, "V"), - (0x11, "V"), - (0x12, "V"), - (0x13, "V"), - (0x14, "V"), - (0x15, "V"), - (0x16, "V"), - (0x17, "V"), - (0x18, "V"), - (0x19, "V"), - (0x1A, "V"), - (0x1B, "V"), - (0x1C, "V"), - (0x1D, "V"), - (0x1E, "V"), - (0x1F, "V"), - (0x20, "V"), - (0x21, "V"), - (0x22, "V"), - (0x23, "V"), - (0x24, "V"), - (0x25, "V"), - (0x26, "V"), - (0x27, "V"), - (0x28, "V"), - (0x29, "V"), - (0x2A, "V"), - (0x2B, "V"), - (0x2C, "V"), - (0x2D, "V"), - (0x2E, "V"), - (0x2F, "V"), - (0x30, "V"), - (0x31, "V"), - (0x32, "V"), - (0x33, "V"), - (0x34, "V"), - (0x35, "V"), - (0x36, "V"), - (0x37, "V"), - (0x38, "V"), - (0x39, "V"), - (0x3A, "V"), - (0x3B, "V"), - (0x3C, "V"), - (0x3D, "V"), - (0x3E, "V"), - (0x3F, "V"), - (0x40, "V"), - (0x41, "M", "a"), - (0x42, "M", "b"), - (0x43, "M", "c"), - (0x44, "M", "d"), - (0x45, "M", "e"), - (0x46, "M", "f"), - (0x47, "M", "g"), - (0x48, "M", "h"), - (0x49, "M", "i"), - (0x4A, "M", "j"), - (0x4B, "M", "k"), - (0x4C, "M", "l"), - (0x4D, "M", "m"), - (0x4E, "M", "n"), - (0x4F, "M", "o"), - (0x50, "M", "p"), - (0x51, "M", "q"), - (0x52, "M", "r"), - (0x53, "M", "s"), - (0x54, "M", "t"), - (0x55, "M", "u"), - (0x56, "M", "v"), - (0x57, "M", "w"), - (0x58, "M", "x"), - (0x59, "M", "y"), - (0x5A, "M", "z"), - (0x5B, "V"), - (0x5C, "V"), - (0x5D, "V"), - (0x5E, "V"), - (0x5F, "V"), - (0x60, "V"), - (0x61, "V"), - (0x62, "V"), - (0x63, "V"), - ] +uts46_statuses: bytes = ( + b"VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV" + b"VMMMMMMMMMMMMMMMMMMMMMMMMMMVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV" + b"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXMVVVVVVVMVMVVIVMVVMMMMVVMMMVMMMV" + b"MMMMMMMMMMMMMMMMMMMMMMMVMMMMMMMDVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV" + b"MVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMMVMVMVMVMVMMV" + b"MVMVMVMMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMMVMVMVMVMM" + b"VMVMMVMMMVMMMMVMMVMMMVMMVMMVMVMVMMVMVMVMMVMMMVMVMMVMVMMMMVMVMVMV" + b"MVMVMVMVMVMVMVMVMVMVMVMVMVMMVMMMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVM" + b"VMVMVMVMVMVMVMVMVMVMVMVMVMVMMVMMVMVMMMMVMVMVMVMVMMMMMMMMMVMMMMMM" + b"VMMMMMVMMVMMMVIVMVMVMVMVXMVMMXMMMMMMMXMXMMVMMMMMMMMMMMMMMMMMXMMM" + b"MMMMMMVDVMMMMMMMMVMVMVMVMVMVMVMVMVMVMVMVMVMMMVMMVMVMMVMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMVMVMVMVMVMVMVMVMVMVMV" + b"MVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMV" + b"MVMMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVM" + b"VMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVXMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMXMVMVMMVXVXVXVXVXVMMMMVXVXVXVXVXVXVXVXVX" + b"VXVXVXVMMMMMMMMVXVXVXVXVXVXVXVXVXVXVXMMXMVXVXVXVXVXVXVXVMXVMXVXV" + b"XVXVXVXVXMMMVXMXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVX" + b"VXVXMMXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXV" + b"XVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXV" + b"XVXVMVXVXVXVXVXVXVXVMVXVXVXVXVXMMVXVMVMVXVMVMVMVMVMVXVMVMMMMMVMV" + b"MVXVMVMVMVMVMVXVXVXVMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMXMXV" + b"MVIVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXMMMMMMXVXVXVXVXVXVXVXVX" + b"VXVIVXVXVXVIVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVMMM" + b"MMMMMMVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMVXVXVMMMV" + b"MMMMMMMMMMMVMMMMMMMMMMMMMMMMMMVMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMVMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMVMVMVMVMVMVMVMVMVMVMVMVMVMV" + b"MVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMV" + b"MVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMMVMVM" + b"VMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVM" + b"VMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMMMMMMMMVXMMMMMMXVMMMMMMMMVMMMMMM" + b"MMVXMMMMMMXVXMXMXMXMVMMMMMMMMVMVMVMVMVMVMVMXMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMVMMMXVMMMMMMMMMMMMMMXVMMMMMMMMMVMXVM" + b"MMMXMMMVMVMMMMMMMMXMMMXVMMMMMMMMXMIDXVMVMVXVXMVMMVMMVMVMVMMMVMVM" + b"IXIMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMVMMMMMMMMMMMMMMMMVMVXVXMMMMVMMM" + b"VMMMMMMVMMVMMMVMMMVMVMVMVMMMMVMMMMMMMMMMVMMMMMVMMMMVMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMVMVXVMMVMMVMMVXVXMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMVMMMVMVXVMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMVMMMVMVMVMVMMMMVMVMV" + b"MMMMMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMV" + b"MVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVXVXVXVXVXMVXVXVXVX" + b"VXVXVXVXVXVXVXVXVXVMVMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMVMVMVMMMVXVXVMMVM" + b"VMXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMIMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXVMMMMMMMMMMMMMMVXVMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMMXMMMMMMMMM" + b"MMMMMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVXVXVXMVMVMVMVMVM" + b"VMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVM" + b"MVXVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMV" + b"MVMVMVMVMVMVMVMVMVMVMVMMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMVMMM" + b"MMVMMMMMVMVMVMVMVMVMVMVMMMMVMVMMVMVMVMVMVMVMVMVMMXMXMMMMMVMMVXVX" + b"VXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVMMMMVMVMMXMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMV" + b"XVXVXVXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMVMVMVMMMMMMMMMMVMVMVMMVMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMMMMXMMMMMXMVMMMMMMMMMMMMMMMMMMMMM" + b"MMMXMMMMMXMXMMXMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMVMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVXMMMMMMMMMMMM" + b"MVIMMXMMMMMMXVXMMMMMMMMMMMMMMMMMMMVMMMMMMXMMMMMMMMMMMMMMMMMMMXMM" + b"MMXMMMVMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXIXMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMIMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMM" + b"MMMXMMMMMMXMMMMMMXMMMXMMMMMMMXMMMMMMMXVXVXVXVXVXVXVXVXVXVXVXVXVX" + b"VXVXVXVXVXVXVXVXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVXVXMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXVXVXVXVMMMMMMMMMMMXMMMMMMMMMM" + b"MMMMMXMMMMMMMXMMXVXVXVXVXVXVXVXVXVMMMMMXMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMXMMMMMMMMMMMMMMXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVX" + b"VXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMXVXVXVXVMMMMMMMMMMMMMMMMMMMMMMXVXVXVXVXVX" + b"VXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVX" + b"VXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVX" + b"VXVXVXVXVXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVXVXVXVXVXVXVXVXVXVX" + b"VXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVX" + b"VXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMVXMMMMMMMMMMMMMMMMMMMMMMMMMXVXVXVXVXVXVX" + b"VXVXVXVXVXVXVXVXVMMMMVXVXVXVXVXVXVXVXVXVXVIXVMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMVXVXVXVXVXVXVXVXVXVMMMMMMMVIVMMMMMMVXVXVXVXVXVX" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMXMXMMXMMMMXMMMMMMMMMMMMXMXMMMMMM" + b"MXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMXMMMMXMMMMMMMMXMMMMMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMMXMMMM" + b"MXMXMMMMMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"XMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVXVXVXVXVMVMV" + b"MVMVMVMVMVMVMVMVMVMVMVMVMVMVXVMVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMVXVXVXVXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXV" + b"XVXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVXVXVXVXVXMMMMXMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMXMMXMXMXMMMMMMMMMMXMMMMXMXMXMXMXMXMXMMMXMMXMXMX" + b"MXMXMXMXMMXMXMMMMXMMMMMMMXMMMMXMMMMXMXMMMMMMMMMMXMMMMMMMMMMMMMMM" + b"MMXMMMXMMMMMXMMMMMMMMMMMMMMMMMXVXVXVXVXVXVXVXMMMMMMMMMMVMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMVMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMVMMMVMVX" + b"VMMMXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMXMMMMMMMMMXMMXV" + b"XVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVXVMMMMMMMMMMVXVXVXVX" + b"VXVXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM" + b"MMMMMMMMMMMMMMMMMMMMMMMMXVXVXVXIX" +) - -def _seg_1() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x64, "V"), - (0x65, "V"), - (0x66, "V"), - (0x67, "V"), - (0x68, "V"), - (0x69, "V"), - (0x6A, "V"), - (0x6B, "V"), - (0x6C, "V"), - (0x6D, "V"), - (0x6E, "V"), - (0x6F, "V"), - (0x70, "V"), - (0x71, "V"), - (0x72, "V"), - (0x73, "V"), - (0x74, "V"), - (0x75, "V"), - (0x76, "V"), - (0x77, "V"), - (0x78, "V"), - (0x79, "V"), - (0x7A, "V"), - (0x7B, "V"), - (0x7C, "V"), - (0x7D, "V"), - (0x7E, "V"), - (0x7F, "V"), - (0x80, "X"), - (0x81, "X"), - (0x82, "X"), - (0x83, "X"), - (0x84, "X"), - (0x85, "X"), - (0x86, "X"), - (0x87, "X"), - (0x88, "X"), - (0x89, "X"), - (0x8A, "X"), - (0x8B, "X"), - (0x8C, "X"), - (0x8D, "X"), - (0x8E, "X"), - (0x8F, "X"), - (0x90, "X"), - (0x91, "X"), - (0x92, "X"), - (0x93, "X"), - (0x94, "X"), - (0x95, "X"), - (0x96, "X"), - (0x97, "X"), - (0x98, "X"), - (0x99, "X"), - (0x9A, "X"), - (0x9B, "X"), - (0x9C, "X"), - (0x9D, "X"), - (0x9E, "X"), - (0x9F, "X"), - (0xA0, "M", " "), - (0xA1, "V"), - (0xA2, "V"), - (0xA3, "V"), - (0xA4, "V"), - (0xA5, "V"), - (0xA6, "V"), - (0xA7, "V"), - (0xA8, "M", " ̈"), - (0xA9, "V"), - (0xAA, "M", "a"), - (0xAB, "V"), - (0xAC, "V"), - (0xAD, "I"), - (0xAE, "V"), - (0xAF, "M", " ̄"), - (0xB0, "V"), - (0xB1, "V"), - (0xB2, "M", "2"), - (0xB3, "M", "3"), - (0xB4, "M", " ́"), - (0xB5, "M", "μ"), - (0xB6, "V"), - (0xB7, "V"), - (0xB8, "M", " ̧"), - (0xB9, "M", "1"), - (0xBA, "M", "o"), - (0xBB, "V"), - (0xBC, "M", "1⁄4"), - (0xBD, "M", "1⁄2"), - (0xBE, "M", "3⁄4"), - (0xBF, "V"), - (0xC0, "M", "à"), - (0xC1, "M", "á"), - (0xC2, "M", "â"), - (0xC3, "M", "ã"), - (0xC4, "M", "ä"), - (0xC5, "M", "å"), - (0xC6, "M", "æ"), - (0xC7, "M", "ç"), - ] - - -def _seg_2() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xC8, "M", "è"), - (0xC9, "M", "é"), - (0xCA, "M", "ê"), - (0xCB, "M", "ë"), - (0xCC, "M", "ì"), - (0xCD, "M", "í"), - (0xCE, "M", "î"), - (0xCF, "M", "ï"), - (0xD0, "M", "ð"), - (0xD1, "M", "ñ"), - (0xD2, "M", "ò"), - (0xD3, "M", "ó"), - (0xD4, "M", "ô"), - (0xD5, "M", "õ"), - (0xD6, "M", "ö"), - (0xD7, "V"), - (0xD8, "M", "ø"), - (0xD9, "M", "ù"), - (0xDA, "M", "ú"), - (0xDB, "M", "û"), - (0xDC, "M", "ü"), - (0xDD, "M", "ý"), - (0xDE, "M", "þ"), - (0xDF, "D", "ss"), - (0xE0, "V"), - (0xE1, "V"), - (0xE2, "V"), - (0xE3, "V"), - (0xE4, "V"), - (0xE5, "V"), - (0xE6, "V"), - (0xE7, "V"), - (0xE8, "V"), - (0xE9, "V"), - (0xEA, "V"), - (0xEB, "V"), - (0xEC, "V"), - (0xED, "V"), - (0xEE, "V"), - (0xEF, "V"), - (0xF0, "V"), - (0xF1, "V"), - (0xF2, "V"), - (0xF3, "V"), - (0xF4, "V"), - (0xF5, "V"), - (0xF6, "V"), - (0xF7, "V"), - (0xF8, "V"), - (0xF9, "V"), - (0xFA, "V"), - (0xFB, "V"), - (0xFC, "V"), - (0xFD, "V"), - (0xFE, "V"), - (0xFF, "V"), - (0x100, "M", "ā"), - (0x101, "V"), - (0x102, "M", "ă"), - (0x103, "V"), - (0x104, "M", "ą"), - (0x105, "V"), - (0x106, "M", "ć"), - (0x107, "V"), - (0x108, "M", "ĉ"), - (0x109, "V"), - (0x10A, "M", "ċ"), - (0x10B, "V"), - (0x10C, "M", "č"), - (0x10D, "V"), - (0x10E, "M", "ď"), - (0x10F, "V"), - (0x110, "M", "đ"), - (0x111, "V"), - (0x112, "M", "ē"), - (0x113, "V"), - (0x114, "M", "ĕ"), - (0x115, "V"), - (0x116, "M", "ė"), - (0x117, "V"), - (0x118, "M", "ę"), - (0x119, "V"), - (0x11A, "M", "ě"), - (0x11B, "V"), - (0x11C, "M", "ĝ"), - (0x11D, "V"), - (0x11E, "M", "ğ"), - (0x11F, "V"), - (0x120, "M", "ġ"), - (0x121, "V"), - (0x122, "M", "ģ"), - (0x123, "V"), - (0x124, "M", "ĥ"), - (0x125, "V"), - (0x126, "M", "ħ"), - (0x127, "V"), - (0x128, "M", "ĩ"), - (0x129, "V"), - (0x12A, "M", "ī"), - (0x12B, "V"), - ] - - -def _seg_3() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x12C, "M", "ĭ"), - (0x12D, "V"), - (0x12E, "M", "į"), - (0x12F, "V"), - (0x130, "M", "i̇"), - (0x131, "V"), - (0x132, "M", "ij"), - (0x134, "M", "ĵ"), - (0x135, "V"), - (0x136, "M", "ķ"), - (0x137, "V"), - (0x139, "M", "ĺ"), - (0x13A, "V"), - (0x13B, "M", "ļ"), - (0x13C, "V"), - (0x13D, "M", "ľ"), - (0x13E, "V"), - (0x13F, "M", "l·"), - (0x141, "M", "ł"), - (0x142, "V"), - (0x143, "M", "ń"), - (0x144, "V"), - (0x145, "M", "ņ"), - (0x146, "V"), - (0x147, "M", "ň"), - (0x148, "V"), - (0x149, "M", "ʼn"), - (0x14A, "M", "ŋ"), - (0x14B, "V"), - (0x14C, "M", "ō"), - (0x14D, "V"), - (0x14E, "M", "ŏ"), - (0x14F, "V"), - (0x150, "M", "ő"), - (0x151, "V"), - (0x152, "M", "œ"), - (0x153, "V"), - (0x154, "M", "ŕ"), - (0x155, "V"), - (0x156, "M", "ŗ"), - (0x157, "V"), - (0x158, "M", "ř"), - (0x159, "V"), - (0x15A, "M", "ś"), - (0x15B, "V"), - (0x15C, "M", "ŝ"), - (0x15D, "V"), - (0x15E, "M", "ş"), - (0x15F, "V"), - (0x160, "M", "š"), - (0x161, "V"), - (0x162, "M", "ţ"), - (0x163, "V"), - (0x164, "M", "ť"), - (0x165, "V"), - (0x166, "M", "ŧ"), - (0x167, "V"), - (0x168, "M", "ũ"), - (0x169, "V"), - (0x16A, "M", "ū"), - (0x16B, "V"), - (0x16C, "M", "ŭ"), - (0x16D, "V"), - (0x16E, "M", "ů"), - (0x16F, "V"), - (0x170, "M", "ű"), - (0x171, "V"), - (0x172, "M", "ų"), - (0x173, "V"), - (0x174, "M", "ŵ"), - (0x175, "V"), - (0x176, "M", "ŷ"), - (0x177, "V"), - (0x178, "M", "ÿ"), - (0x179, "M", "ź"), - (0x17A, "V"), - (0x17B, "M", "ż"), - (0x17C, "V"), - (0x17D, "M", "ž"), - (0x17E, "V"), - (0x17F, "M", "s"), - (0x180, "V"), - (0x181, "M", "ɓ"), - (0x182, "M", "ƃ"), - (0x183, "V"), - (0x184, "M", "ƅ"), - (0x185, "V"), - (0x186, "M", "ɔ"), - (0x187, "M", "ƈ"), - (0x188, "V"), - (0x189, "M", "ɖ"), - (0x18A, "M", "ɗ"), - (0x18B, "M", "ƌ"), - (0x18C, "V"), - (0x18E, "M", "ǝ"), - (0x18F, "M", "ə"), - (0x190, "M", "ɛ"), - (0x191, "M", "ƒ"), - (0x192, "V"), - (0x193, "M", "ɠ"), - ] - - -def _seg_4() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x194, "M", "ɣ"), - (0x195, "V"), - (0x196, "M", "ɩ"), - (0x197, "M", "ɨ"), - (0x198, "M", "ƙ"), - (0x199, "V"), - (0x19C, "M", "ɯ"), - (0x19D, "M", "ɲ"), - (0x19E, "V"), - (0x19F, "M", "ɵ"), - (0x1A0, "M", "ơ"), - (0x1A1, "V"), - (0x1A2, "M", "ƣ"), - (0x1A3, "V"), - (0x1A4, "M", "ƥ"), - (0x1A5, "V"), - (0x1A6, "M", "ʀ"), - (0x1A7, "M", "ƨ"), - (0x1A8, "V"), - (0x1A9, "M", "ʃ"), - (0x1AA, "V"), - (0x1AC, "M", "ƭ"), - (0x1AD, "V"), - (0x1AE, "M", "ʈ"), - (0x1AF, "M", "ư"), - (0x1B0, "V"), - (0x1B1, "M", "ʊ"), - (0x1B2, "M", "ʋ"), - (0x1B3, "M", "ƴ"), - (0x1B4, "V"), - (0x1B5, "M", "ƶ"), - (0x1B6, "V"), - (0x1B7, "M", "ʒ"), - (0x1B8, "M", "ƹ"), - (0x1B9, "V"), - (0x1BC, "M", "ƽ"), - (0x1BD, "V"), - (0x1C4, "M", "dž"), - (0x1C7, "M", "lj"), - (0x1CA, "M", "nj"), - (0x1CD, "M", "ǎ"), - (0x1CE, "V"), - (0x1CF, "M", "ǐ"), - (0x1D0, "V"), - (0x1D1, "M", "ǒ"), - (0x1D2, "V"), - (0x1D3, "M", "ǔ"), - (0x1D4, "V"), - (0x1D5, "M", "ǖ"), - (0x1D6, "V"), - (0x1D7, "M", "ǘ"), - (0x1D8, "V"), - (0x1D9, "M", "ǚ"), - (0x1DA, "V"), - (0x1DB, "M", "ǜ"), - (0x1DC, "V"), - (0x1DE, "M", "ǟ"), - (0x1DF, "V"), - (0x1E0, "M", "ǡ"), - (0x1E1, "V"), - (0x1E2, "M", "ǣ"), - (0x1E3, "V"), - (0x1E4, "M", "ǥ"), - (0x1E5, "V"), - (0x1E6, "M", "ǧ"), - (0x1E7, "V"), - (0x1E8, "M", "ǩ"), - (0x1E9, "V"), - (0x1EA, "M", "ǫ"), - (0x1EB, "V"), - (0x1EC, "M", "ǭ"), - (0x1ED, "V"), - (0x1EE, "M", "ǯ"), - (0x1EF, "V"), - (0x1F1, "M", "dz"), - (0x1F4, "M", "ǵ"), - (0x1F5, "V"), - (0x1F6, "M", "ƕ"), - (0x1F7, "M", "ƿ"), - (0x1F8, "M", "ǹ"), - (0x1F9, "V"), - (0x1FA, "M", "ǻ"), - (0x1FB, "V"), - (0x1FC, "M", "ǽ"), - (0x1FD, "V"), - (0x1FE, "M", "ǿ"), - (0x1FF, "V"), - (0x200, "M", "ȁ"), - (0x201, "V"), - (0x202, "M", "ȃ"), - (0x203, "V"), - (0x204, "M", "ȅ"), - (0x205, "V"), - (0x206, "M", "ȇ"), - (0x207, "V"), - (0x208, "M", "ȉ"), - (0x209, "V"), - (0x20A, "M", "ȋ"), - (0x20B, "V"), - (0x20C, "M", "ȍ"), - ] - - -def _seg_5() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x20D, "V"), - (0x20E, "M", "ȏ"), - (0x20F, "V"), - (0x210, "M", "ȑ"), - (0x211, "V"), - (0x212, "M", "ȓ"), - (0x213, "V"), - (0x214, "M", "ȕ"), - (0x215, "V"), - (0x216, "M", "ȗ"), - (0x217, "V"), - (0x218, "M", "ș"), - (0x219, "V"), - (0x21A, "M", "ț"), - (0x21B, "V"), - (0x21C, "M", "ȝ"), - (0x21D, "V"), - (0x21E, "M", "ȟ"), - (0x21F, "V"), - (0x220, "M", "ƞ"), - (0x221, "V"), - (0x222, "M", "ȣ"), - (0x223, "V"), - (0x224, "M", "ȥ"), - (0x225, "V"), - (0x226, "M", "ȧ"), - (0x227, "V"), - (0x228, "M", "ȩ"), - (0x229, "V"), - (0x22A, "M", "ȫ"), - (0x22B, "V"), - (0x22C, "M", "ȭ"), - (0x22D, "V"), - (0x22E, "M", "ȯ"), - (0x22F, "V"), - (0x230, "M", "ȱ"), - (0x231, "V"), - (0x232, "M", "ȳ"), - (0x233, "V"), - (0x23A, "M", "ⱥ"), - (0x23B, "M", "ȼ"), - (0x23C, "V"), - (0x23D, "M", "ƚ"), - (0x23E, "M", "ⱦ"), - (0x23F, "V"), - (0x241, "M", "ɂ"), - (0x242, "V"), - (0x243, "M", "ƀ"), - (0x244, "M", "ʉ"), - (0x245, "M", "ʌ"), - (0x246, "M", "ɇ"), - (0x247, "V"), - (0x248, "M", "ɉ"), - (0x249, "V"), - (0x24A, "M", "ɋ"), - (0x24B, "V"), - (0x24C, "M", "ɍ"), - (0x24D, "V"), - (0x24E, "M", "ɏ"), - (0x24F, "V"), - (0x2B0, "M", "h"), - (0x2B1, "M", "ɦ"), - (0x2B2, "M", "j"), - (0x2B3, "M", "r"), - (0x2B4, "M", "ɹ"), - (0x2B5, "M", "ɻ"), - (0x2B6, "M", "ʁ"), - (0x2B7, "M", "w"), - (0x2B8, "M", "y"), - (0x2B9, "V"), - (0x2D8, "M", " ̆"), - (0x2D9, "M", " ̇"), - (0x2DA, "M", " ̊"), - (0x2DB, "M", " ̨"), - (0x2DC, "M", " ̃"), - (0x2DD, "M", " ̋"), - (0x2DE, "V"), - (0x2E0, "M", "ɣ"), - (0x2E1, "M", "l"), - (0x2E2, "M", "s"), - (0x2E3, "M", "x"), - (0x2E4, "M", "ʕ"), - (0x2E5, "V"), - (0x340, "M", "̀"), - (0x341, "M", "́"), - (0x342, "V"), - (0x343, "M", "̓"), - (0x344, "M", "̈́"), - (0x345, "M", "ι"), - (0x346, "V"), - (0x34F, "I"), - (0x350, "V"), - (0x370, "M", "ͱ"), - (0x371, "V"), - (0x372, "M", "ͳ"), - (0x373, "V"), - (0x374, "M", "ʹ"), - (0x375, "V"), - (0x376, "M", "ͷ"), - (0x377, "V"), - ] - - -def _seg_6() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x378, "X"), - (0x37A, "M", " ι"), - (0x37B, "V"), - (0x37E, "M", ";"), - (0x37F, "M", "ϳ"), - (0x380, "X"), - (0x384, "M", " ́"), - (0x385, "M", " ̈́"), - (0x386, "M", "ά"), - (0x387, "M", "·"), - (0x388, "M", "έ"), - (0x389, "M", "ή"), - (0x38A, "M", "ί"), - (0x38B, "X"), - (0x38C, "M", "ό"), - (0x38D, "X"), - (0x38E, "M", "ύ"), - (0x38F, "M", "ώ"), - (0x390, "V"), - (0x391, "M", "α"), - (0x392, "M", "β"), - (0x393, "M", "γ"), - (0x394, "M", "δ"), - (0x395, "M", "ε"), - (0x396, "M", "ζ"), - (0x397, "M", "η"), - (0x398, "M", "θ"), - (0x399, "M", "ι"), - (0x39A, "M", "κ"), - (0x39B, "M", "λ"), - (0x39C, "M", "μ"), - (0x39D, "M", "ν"), - (0x39E, "M", "ξ"), - (0x39F, "M", "ο"), - (0x3A0, "M", "π"), - (0x3A1, "M", "ρ"), - (0x3A2, "X"), - (0x3A3, "M", "σ"), - (0x3A4, "M", "τ"), - (0x3A5, "M", "υ"), - (0x3A6, "M", "φ"), - (0x3A7, "M", "χ"), - (0x3A8, "M", "ψ"), - (0x3A9, "M", "ω"), - (0x3AA, "M", "ϊ"), - (0x3AB, "M", "ϋ"), - (0x3AC, "V"), - (0x3C2, "D", "σ"), - (0x3C3, "V"), - (0x3CF, "M", "ϗ"), - (0x3D0, "M", "β"), - (0x3D1, "M", "θ"), - (0x3D2, "M", "υ"), - (0x3D3, "M", "ύ"), - (0x3D4, "M", "ϋ"), - (0x3D5, "M", "φ"), - (0x3D6, "M", "π"), - (0x3D7, "V"), - (0x3D8, "M", "ϙ"), - (0x3D9, "V"), - (0x3DA, "M", "ϛ"), - (0x3DB, "V"), - (0x3DC, "M", "ϝ"), - (0x3DD, "V"), - (0x3DE, "M", "ϟ"), - (0x3DF, "V"), - (0x3E0, "M", "ϡ"), - (0x3E1, "V"), - (0x3E2, "M", "ϣ"), - (0x3E3, "V"), - (0x3E4, "M", "ϥ"), - (0x3E5, "V"), - (0x3E6, "M", "ϧ"), - (0x3E7, "V"), - (0x3E8, "M", "ϩ"), - (0x3E9, "V"), - (0x3EA, "M", "ϫ"), - (0x3EB, "V"), - (0x3EC, "M", "ϭ"), - (0x3ED, "V"), - (0x3EE, "M", "ϯ"), - (0x3EF, "V"), - (0x3F0, "M", "κ"), - (0x3F1, "M", "ρ"), - (0x3F2, "M", "σ"), - (0x3F3, "V"), - (0x3F4, "M", "θ"), - (0x3F5, "M", "ε"), - (0x3F6, "V"), - (0x3F7, "M", "ϸ"), - (0x3F8, "V"), - (0x3F9, "M", "σ"), - (0x3FA, "M", "ϻ"), - (0x3FB, "V"), - (0x3FD, "M", "ͻ"), - (0x3FE, "M", "ͼ"), - (0x3FF, "M", "ͽ"), - (0x400, "M", "ѐ"), - (0x401, "M", "ё"), - (0x402, "M", "ђ"), - ] - - -def _seg_7() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x403, "M", "ѓ"), - (0x404, "M", "є"), - (0x405, "M", "ѕ"), - (0x406, "M", "і"), - (0x407, "M", "ї"), - (0x408, "M", "ј"), - (0x409, "M", "љ"), - (0x40A, "M", "њ"), - (0x40B, "M", "ћ"), - (0x40C, "M", "ќ"), - (0x40D, "M", "ѝ"), - (0x40E, "M", "ў"), - (0x40F, "M", "џ"), - (0x410, "M", "а"), - (0x411, "M", "б"), - (0x412, "M", "в"), - (0x413, "M", "г"), - (0x414, "M", "д"), - (0x415, "M", "е"), - (0x416, "M", "ж"), - (0x417, "M", "з"), - (0x418, "M", "и"), - (0x419, "M", "й"), - (0x41A, "M", "к"), - (0x41B, "M", "л"), - (0x41C, "M", "м"), - (0x41D, "M", "н"), - (0x41E, "M", "о"), - (0x41F, "M", "п"), - (0x420, "M", "р"), - (0x421, "M", "с"), - (0x422, "M", "т"), - (0x423, "M", "у"), - (0x424, "M", "ф"), - (0x425, "M", "х"), - (0x426, "M", "ц"), - (0x427, "M", "ч"), - (0x428, "M", "ш"), - (0x429, "M", "щ"), - (0x42A, "M", "ъ"), - (0x42B, "M", "ы"), - (0x42C, "M", "ь"), - (0x42D, "M", "э"), - (0x42E, "M", "ю"), - (0x42F, "M", "я"), - (0x430, "V"), - (0x460, "M", "ѡ"), - (0x461, "V"), - (0x462, "M", "ѣ"), - (0x463, "V"), - (0x464, "M", "ѥ"), - (0x465, "V"), - (0x466, "M", "ѧ"), - (0x467, "V"), - (0x468, "M", "ѩ"), - (0x469, "V"), - (0x46A, "M", "ѫ"), - (0x46B, "V"), - (0x46C, "M", "ѭ"), - (0x46D, "V"), - (0x46E, "M", "ѯ"), - (0x46F, "V"), - (0x470, "M", "ѱ"), - (0x471, "V"), - (0x472, "M", "ѳ"), - (0x473, "V"), - (0x474, "M", "ѵ"), - (0x475, "V"), - (0x476, "M", "ѷ"), - (0x477, "V"), - (0x478, "M", "ѹ"), - (0x479, "V"), - (0x47A, "M", "ѻ"), - (0x47B, "V"), - (0x47C, "M", "ѽ"), - (0x47D, "V"), - (0x47E, "M", "ѿ"), - (0x47F, "V"), - (0x480, "M", "ҁ"), - (0x481, "V"), - (0x48A, "M", "ҋ"), - (0x48B, "V"), - (0x48C, "M", "ҍ"), - (0x48D, "V"), - (0x48E, "M", "ҏ"), - (0x48F, "V"), - (0x490, "M", "ґ"), - (0x491, "V"), - (0x492, "M", "ғ"), - (0x493, "V"), - (0x494, "M", "ҕ"), - (0x495, "V"), - (0x496, "M", "җ"), - (0x497, "V"), - (0x498, "M", "ҙ"), - (0x499, "V"), - (0x49A, "M", "қ"), - (0x49B, "V"), - (0x49C, "M", "ҝ"), - (0x49D, "V"), - ] - - -def _seg_8() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x49E, "M", "ҟ"), - (0x49F, "V"), - (0x4A0, "M", "ҡ"), - (0x4A1, "V"), - (0x4A2, "M", "ң"), - (0x4A3, "V"), - (0x4A4, "M", "ҥ"), - (0x4A5, "V"), - (0x4A6, "M", "ҧ"), - (0x4A7, "V"), - (0x4A8, "M", "ҩ"), - (0x4A9, "V"), - (0x4AA, "M", "ҫ"), - (0x4AB, "V"), - (0x4AC, "M", "ҭ"), - (0x4AD, "V"), - (0x4AE, "M", "ү"), - (0x4AF, "V"), - (0x4B0, "M", "ұ"), - (0x4B1, "V"), - (0x4B2, "M", "ҳ"), - (0x4B3, "V"), - (0x4B4, "M", "ҵ"), - (0x4B5, "V"), - (0x4B6, "M", "ҷ"), - (0x4B7, "V"), - (0x4B8, "M", "ҹ"), - (0x4B9, "V"), - (0x4BA, "M", "һ"), - (0x4BB, "V"), - (0x4BC, "M", "ҽ"), - (0x4BD, "V"), - (0x4BE, "M", "ҿ"), - (0x4BF, "V"), - (0x4C0, "M", "ӏ"), - (0x4C1, "M", "ӂ"), - (0x4C2, "V"), - (0x4C3, "M", "ӄ"), - (0x4C4, "V"), - (0x4C5, "M", "ӆ"), - (0x4C6, "V"), - (0x4C7, "M", "ӈ"), - (0x4C8, "V"), - (0x4C9, "M", "ӊ"), - (0x4CA, "V"), - (0x4CB, "M", "ӌ"), - (0x4CC, "V"), - (0x4CD, "M", "ӎ"), - (0x4CE, "V"), - (0x4D0, "M", "ӑ"), - (0x4D1, "V"), - (0x4D2, "M", "ӓ"), - (0x4D3, "V"), - (0x4D4, "M", "ӕ"), - (0x4D5, "V"), - (0x4D6, "M", "ӗ"), - (0x4D7, "V"), - (0x4D8, "M", "ә"), - (0x4D9, "V"), - (0x4DA, "M", "ӛ"), - (0x4DB, "V"), - (0x4DC, "M", "ӝ"), - (0x4DD, "V"), - (0x4DE, "M", "ӟ"), - (0x4DF, "V"), - (0x4E0, "M", "ӡ"), - (0x4E1, "V"), - (0x4E2, "M", "ӣ"), - (0x4E3, "V"), - (0x4E4, "M", "ӥ"), - (0x4E5, "V"), - (0x4E6, "M", "ӧ"), - (0x4E7, "V"), - (0x4E8, "M", "ө"), - (0x4E9, "V"), - (0x4EA, "M", "ӫ"), - (0x4EB, "V"), - (0x4EC, "M", "ӭ"), - (0x4ED, "V"), - (0x4EE, "M", "ӯ"), - (0x4EF, "V"), - (0x4F0, "M", "ӱ"), - (0x4F1, "V"), - (0x4F2, "M", "ӳ"), - (0x4F3, "V"), - (0x4F4, "M", "ӵ"), - (0x4F5, "V"), - (0x4F6, "M", "ӷ"), - (0x4F7, "V"), - (0x4F8, "M", "ӹ"), - (0x4F9, "V"), - (0x4FA, "M", "ӻ"), - (0x4FB, "V"), - (0x4FC, "M", "ӽ"), - (0x4FD, "V"), - (0x4FE, "M", "ӿ"), - (0x4FF, "V"), - (0x500, "M", "ԁ"), - (0x501, "V"), - (0x502, "M", "ԃ"), - ] - - -def _seg_9() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x503, "V"), - (0x504, "M", "ԅ"), - (0x505, "V"), - (0x506, "M", "ԇ"), - (0x507, "V"), - (0x508, "M", "ԉ"), - (0x509, "V"), - (0x50A, "M", "ԋ"), - (0x50B, "V"), - (0x50C, "M", "ԍ"), - (0x50D, "V"), - (0x50E, "M", "ԏ"), - (0x50F, "V"), - (0x510, "M", "ԑ"), - (0x511, "V"), - (0x512, "M", "ԓ"), - (0x513, "V"), - (0x514, "M", "ԕ"), - (0x515, "V"), - (0x516, "M", "ԗ"), - (0x517, "V"), - (0x518, "M", "ԙ"), - (0x519, "V"), - (0x51A, "M", "ԛ"), - (0x51B, "V"), - (0x51C, "M", "ԝ"), - (0x51D, "V"), - (0x51E, "M", "ԟ"), - (0x51F, "V"), - (0x520, "M", "ԡ"), - (0x521, "V"), - (0x522, "M", "ԣ"), - (0x523, "V"), - (0x524, "M", "ԥ"), - (0x525, "V"), - (0x526, "M", "ԧ"), - (0x527, "V"), - (0x528, "M", "ԩ"), - (0x529, "V"), - (0x52A, "M", "ԫ"), - (0x52B, "V"), - (0x52C, "M", "ԭ"), - (0x52D, "V"), - (0x52E, "M", "ԯ"), - (0x52F, "V"), - (0x530, "X"), - (0x531, "M", "ա"), - (0x532, "M", "բ"), - (0x533, "M", "գ"), - (0x534, "M", "դ"), - (0x535, "M", "ե"), - (0x536, "M", "զ"), - (0x537, "M", "է"), - (0x538, "M", "ը"), - (0x539, "M", "թ"), - (0x53A, "M", "ժ"), - (0x53B, "M", "ի"), - (0x53C, "M", "լ"), - (0x53D, "M", "խ"), - (0x53E, "M", "ծ"), - (0x53F, "M", "կ"), - (0x540, "M", "հ"), - (0x541, "M", "ձ"), - (0x542, "M", "ղ"), - (0x543, "M", "ճ"), - (0x544, "M", "մ"), - (0x545, "M", "յ"), - (0x546, "M", "ն"), - (0x547, "M", "շ"), - (0x548, "M", "ո"), - (0x549, "M", "չ"), - (0x54A, "M", "պ"), - (0x54B, "M", "ջ"), - (0x54C, "M", "ռ"), - (0x54D, "M", "ս"), - (0x54E, "M", "վ"), - (0x54F, "M", "տ"), - (0x550, "M", "ր"), - (0x551, "M", "ց"), - (0x552, "M", "ւ"), - (0x553, "M", "փ"), - (0x554, "M", "ք"), - (0x555, "M", "օ"), - (0x556, "M", "ֆ"), - (0x557, "X"), - (0x559, "V"), - (0x587, "M", "եւ"), - (0x588, "V"), - (0x58B, "X"), - (0x58D, "V"), - (0x590, "X"), - (0x591, "V"), - (0x5C8, "X"), - (0x5D0, "V"), - (0x5EB, "X"), - (0x5EF, "V"), - (0x5F5, "X"), - (0x606, "V"), - (0x61C, "X"), - (0x61D, "V"), - ] - - -def _seg_10() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x675, "M", "اٴ"), - (0x676, "M", "وٴ"), - (0x677, "M", "ۇٴ"), - (0x678, "M", "يٴ"), - (0x679, "V"), - (0x6DD, "X"), - (0x6DE, "V"), - (0x70E, "X"), - (0x710, "V"), - (0x74B, "X"), - (0x74D, "V"), - (0x7B2, "X"), - (0x7C0, "V"), - (0x7FB, "X"), - (0x7FD, "V"), - (0x82E, "X"), - (0x830, "V"), - (0x83F, "X"), - (0x840, "V"), - (0x85C, "X"), - (0x85E, "V"), - (0x85F, "X"), - (0x860, "V"), - (0x86B, "X"), - (0x870, "V"), - (0x88F, "X"), - (0x897, "V"), - (0x8E2, "X"), - (0x8E3, "V"), - (0x958, "M", "क़"), - (0x959, "M", "ख़"), - (0x95A, "M", "ग़"), - (0x95B, "M", "ज़"), - (0x95C, "M", "ड़"), - (0x95D, "M", "ढ़"), - (0x95E, "M", "फ़"), - (0x95F, "M", "य़"), - (0x960, "V"), - (0x984, "X"), - (0x985, "V"), - (0x98D, "X"), - (0x98F, "V"), - (0x991, "X"), - (0x993, "V"), - (0x9A9, "X"), - (0x9AA, "V"), - (0x9B1, "X"), - (0x9B2, "V"), - (0x9B3, "X"), - (0x9B6, "V"), - (0x9BA, "X"), - (0x9BC, "V"), - (0x9C5, "X"), - (0x9C7, "V"), - (0x9C9, "X"), - (0x9CB, "V"), - (0x9CF, "X"), - (0x9D7, "V"), - (0x9D8, "X"), - (0x9DC, "M", "ড়"), - (0x9DD, "M", "ঢ়"), - (0x9DE, "X"), - (0x9DF, "M", "য়"), - (0x9E0, "V"), - (0x9E4, "X"), - (0x9E6, "V"), - (0x9FF, "X"), - (0xA01, "V"), - (0xA04, "X"), - (0xA05, "V"), - (0xA0B, "X"), - (0xA0F, "V"), - (0xA11, "X"), - (0xA13, "V"), - (0xA29, "X"), - (0xA2A, "V"), - (0xA31, "X"), - (0xA32, "V"), - (0xA33, "M", "ਲ਼"), - (0xA34, "X"), - (0xA35, "V"), - (0xA36, "M", "ਸ਼"), - (0xA37, "X"), - (0xA38, "V"), - (0xA3A, "X"), - (0xA3C, "V"), - (0xA3D, "X"), - (0xA3E, "V"), - (0xA43, "X"), - (0xA47, "V"), - (0xA49, "X"), - (0xA4B, "V"), - (0xA4E, "X"), - (0xA51, "V"), - (0xA52, "X"), - (0xA59, "M", "ਖ਼"), - (0xA5A, "M", "ਗ਼"), - (0xA5B, "M", "ਜ਼"), - (0xA5C, "V"), - (0xA5D, "X"), - ] - - -def _seg_11() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xA5E, "M", "ਫ਼"), - (0xA5F, "X"), - (0xA66, "V"), - (0xA77, "X"), - (0xA81, "V"), - (0xA84, "X"), - (0xA85, "V"), - (0xA8E, "X"), - (0xA8F, "V"), - (0xA92, "X"), - (0xA93, "V"), - (0xAA9, "X"), - (0xAAA, "V"), - (0xAB1, "X"), - (0xAB2, "V"), - (0xAB4, "X"), - (0xAB5, "V"), - (0xABA, "X"), - (0xABC, "V"), - (0xAC6, "X"), - (0xAC7, "V"), - (0xACA, "X"), - (0xACB, "V"), - (0xACE, "X"), - (0xAD0, "V"), - (0xAD1, "X"), - (0xAE0, "V"), - (0xAE4, "X"), - (0xAE6, "V"), - (0xAF2, "X"), - (0xAF9, "V"), - (0xB00, "X"), - (0xB01, "V"), - (0xB04, "X"), - (0xB05, "V"), - (0xB0D, "X"), - (0xB0F, "V"), - (0xB11, "X"), - (0xB13, "V"), - (0xB29, "X"), - (0xB2A, "V"), - (0xB31, "X"), - (0xB32, "V"), - (0xB34, "X"), - (0xB35, "V"), - (0xB3A, "X"), - (0xB3C, "V"), - (0xB45, "X"), - (0xB47, "V"), - (0xB49, "X"), - (0xB4B, "V"), - (0xB4E, "X"), - (0xB55, "V"), - (0xB58, "X"), - (0xB5C, "M", "ଡ଼"), - (0xB5D, "M", "ଢ଼"), - (0xB5E, "X"), - (0xB5F, "V"), - (0xB64, "X"), - (0xB66, "V"), - (0xB78, "X"), - (0xB82, "V"), - (0xB84, "X"), - (0xB85, "V"), - (0xB8B, "X"), - (0xB8E, "V"), - (0xB91, "X"), - (0xB92, "V"), - (0xB96, "X"), - (0xB99, "V"), - (0xB9B, "X"), - (0xB9C, "V"), - (0xB9D, "X"), - (0xB9E, "V"), - (0xBA0, "X"), - (0xBA3, "V"), - (0xBA5, "X"), - (0xBA8, "V"), - (0xBAB, "X"), - (0xBAE, "V"), - (0xBBA, "X"), - (0xBBE, "V"), - (0xBC3, "X"), - (0xBC6, "V"), - (0xBC9, "X"), - (0xBCA, "V"), - (0xBCE, "X"), - (0xBD0, "V"), - (0xBD1, "X"), - (0xBD7, "V"), - (0xBD8, "X"), - (0xBE6, "V"), - (0xBFB, "X"), - (0xC00, "V"), - (0xC0D, "X"), - (0xC0E, "V"), - (0xC11, "X"), - (0xC12, "V"), - (0xC29, "X"), - (0xC2A, "V"), - ] - - -def _seg_12() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xC3A, "X"), - (0xC3C, "V"), - (0xC45, "X"), - (0xC46, "V"), - (0xC49, "X"), - (0xC4A, "V"), - (0xC4E, "X"), - (0xC55, "V"), - (0xC57, "X"), - (0xC58, "V"), - (0xC5B, "X"), - (0xC5D, "V"), - (0xC5E, "X"), - (0xC60, "V"), - (0xC64, "X"), - (0xC66, "V"), - (0xC70, "X"), - (0xC77, "V"), - (0xC8D, "X"), - (0xC8E, "V"), - (0xC91, "X"), - (0xC92, "V"), - (0xCA9, "X"), - (0xCAA, "V"), - (0xCB4, "X"), - (0xCB5, "V"), - (0xCBA, "X"), - (0xCBC, "V"), - (0xCC5, "X"), - (0xCC6, "V"), - (0xCC9, "X"), - (0xCCA, "V"), - (0xCCE, "X"), - (0xCD5, "V"), - (0xCD7, "X"), - (0xCDD, "V"), - (0xCDF, "X"), - (0xCE0, "V"), - (0xCE4, "X"), - (0xCE6, "V"), - (0xCF0, "X"), - (0xCF1, "V"), - (0xCF4, "X"), - (0xD00, "V"), - (0xD0D, "X"), - (0xD0E, "V"), - (0xD11, "X"), - (0xD12, "V"), - (0xD45, "X"), - (0xD46, "V"), - (0xD49, "X"), - (0xD4A, "V"), - (0xD50, "X"), - (0xD54, "V"), - (0xD64, "X"), - (0xD66, "V"), - (0xD80, "X"), - (0xD81, "V"), - (0xD84, "X"), - (0xD85, "V"), - (0xD97, "X"), - (0xD9A, "V"), - (0xDB2, "X"), - (0xDB3, "V"), - (0xDBC, "X"), - (0xDBD, "V"), - (0xDBE, "X"), - (0xDC0, "V"), - (0xDC7, "X"), - (0xDCA, "V"), - (0xDCB, "X"), - (0xDCF, "V"), - (0xDD5, "X"), - (0xDD6, "V"), - (0xDD7, "X"), - (0xDD8, "V"), - (0xDE0, "X"), - (0xDE6, "V"), - (0xDF0, "X"), - (0xDF2, "V"), - (0xDF5, "X"), - (0xE01, "V"), - (0xE33, "M", "ํา"), - (0xE34, "V"), - (0xE3B, "X"), - (0xE3F, "V"), - (0xE5C, "X"), - (0xE81, "V"), - (0xE83, "X"), - (0xE84, "V"), - (0xE85, "X"), - (0xE86, "V"), - (0xE8B, "X"), - (0xE8C, "V"), - (0xEA4, "X"), - (0xEA5, "V"), - (0xEA6, "X"), - (0xEA7, "V"), - (0xEB3, "M", "ໍາ"), - (0xEB4, "V"), - ] - - -def _seg_13() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xEBE, "X"), - (0xEC0, "V"), - (0xEC5, "X"), - (0xEC6, "V"), - (0xEC7, "X"), - (0xEC8, "V"), - (0xECF, "X"), - (0xED0, "V"), - (0xEDA, "X"), - (0xEDC, "M", "ຫນ"), - (0xEDD, "M", "ຫມ"), - (0xEDE, "V"), - (0xEE0, "X"), - (0xF00, "V"), - (0xF0C, "M", "་"), - (0xF0D, "V"), - (0xF43, "M", "གྷ"), - (0xF44, "V"), - (0xF48, "X"), - (0xF49, "V"), - (0xF4D, "M", "ཌྷ"), - (0xF4E, "V"), - (0xF52, "M", "དྷ"), - (0xF53, "V"), - (0xF57, "M", "བྷ"), - (0xF58, "V"), - (0xF5C, "M", "ཛྷ"), - (0xF5D, "V"), - (0xF69, "M", "ཀྵ"), - (0xF6A, "V"), - (0xF6D, "X"), - (0xF71, "V"), - (0xF73, "M", "ཱི"), - (0xF74, "V"), - (0xF75, "M", "ཱུ"), - (0xF76, "M", "ྲྀ"), - (0xF77, "M", "ྲཱྀ"), - (0xF78, "M", "ླྀ"), - (0xF79, "M", "ླཱྀ"), - (0xF7A, "V"), - (0xF81, "M", "ཱྀ"), - (0xF82, "V"), - (0xF93, "M", "ྒྷ"), - (0xF94, "V"), - (0xF98, "X"), - (0xF99, "V"), - (0xF9D, "M", "ྜྷ"), - (0xF9E, "V"), - (0xFA2, "M", "ྡྷ"), - (0xFA3, "V"), - (0xFA7, "M", "ྦྷ"), - (0xFA8, "V"), - (0xFAC, "M", "ྫྷ"), - (0xFAD, "V"), - (0xFB9, "M", "ྐྵ"), - (0xFBA, "V"), - (0xFBD, "X"), - (0xFBE, "V"), - (0xFCD, "X"), - (0xFCE, "V"), - (0xFDB, "X"), - (0x1000, "V"), - (0x10A0, "M", "ⴀ"), - (0x10A1, "M", "ⴁ"), - (0x10A2, "M", "ⴂ"), - (0x10A3, "M", "ⴃ"), - (0x10A4, "M", "ⴄ"), - (0x10A5, "M", "ⴅ"), - (0x10A6, "M", "ⴆ"), - (0x10A7, "M", "ⴇ"), - (0x10A8, "M", "ⴈ"), - (0x10A9, "M", "ⴉ"), - (0x10AA, "M", "ⴊ"), - (0x10AB, "M", "ⴋ"), - (0x10AC, "M", "ⴌ"), - (0x10AD, "M", "ⴍ"), - (0x10AE, "M", "ⴎ"), - (0x10AF, "M", "ⴏ"), - (0x10B0, "M", "ⴐ"), - (0x10B1, "M", "ⴑ"), - (0x10B2, "M", "ⴒ"), - (0x10B3, "M", "ⴓ"), - (0x10B4, "M", "ⴔ"), - (0x10B5, "M", "ⴕ"), - (0x10B6, "M", "ⴖ"), - (0x10B7, "M", "ⴗ"), - (0x10B8, "M", "ⴘ"), - (0x10B9, "M", "ⴙ"), - (0x10BA, "M", "ⴚ"), - (0x10BB, "M", "ⴛ"), - (0x10BC, "M", "ⴜ"), - (0x10BD, "M", "ⴝ"), - (0x10BE, "M", "ⴞ"), - (0x10BF, "M", "ⴟ"), - (0x10C0, "M", "ⴠ"), - (0x10C1, "M", "ⴡ"), - (0x10C2, "M", "ⴢ"), - (0x10C3, "M", "ⴣ"), - (0x10C4, "M", "ⴤ"), - (0x10C5, "M", "ⴥ"), - ] - - -def _seg_14() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x10C6, "X"), - (0x10C7, "M", "ⴧ"), - (0x10C8, "X"), - (0x10CD, "M", "ⴭ"), - (0x10CE, "X"), - (0x10D0, "V"), - (0x10FC, "M", "ნ"), - (0x10FD, "V"), - (0x115F, "I"), - (0x1161, "V"), - (0x1249, "X"), - (0x124A, "V"), - (0x124E, "X"), - (0x1250, "V"), - (0x1257, "X"), - (0x1258, "V"), - (0x1259, "X"), - (0x125A, "V"), - (0x125E, "X"), - (0x1260, "V"), - (0x1289, "X"), - (0x128A, "V"), - (0x128E, "X"), - (0x1290, "V"), - (0x12B1, "X"), - (0x12B2, "V"), - (0x12B6, "X"), - (0x12B8, "V"), - (0x12BF, "X"), - (0x12C0, "V"), - (0x12C1, "X"), - (0x12C2, "V"), - (0x12C6, "X"), - (0x12C8, "V"), - (0x12D7, "X"), - (0x12D8, "V"), - (0x1311, "X"), - (0x1312, "V"), - (0x1316, "X"), - (0x1318, "V"), - (0x135B, "X"), - (0x135D, "V"), - (0x137D, "X"), - (0x1380, "V"), - (0x139A, "X"), - (0x13A0, "V"), - (0x13F6, "X"), - (0x13F8, "M", "Ᏸ"), - (0x13F9, "M", "Ᏹ"), - (0x13FA, "M", "Ᏺ"), - (0x13FB, "M", "Ᏻ"), - (0x13FC, "M", "Ᏼ"), - (0x13FD, "M", "Ᏽ"), - (0x13FE, "X"), - (0x1400, "V"), - (0x1680, "X"), - (0x1681, "V"), - (0x169D, "X"), - (0x16A0, "V"), - (0x16F9, "X"), - (0x1700, "V"), - (0x1716, "X"), - (0x171F, "V"), - (0x1737, "X"), - (0x1740, "V"), - (0x1754, "X"), - (0x1760, "V"), - (0x176D, "X"), - (0x176E, "V"), - (0x1771, "X"), - (0x1772, "V"), - (0x1774, "X"), - (0x1780, "V"), - (0x17B4, "I"), - (0x17B6, "V"), - (0x17DE, "X"), - (0x17E0, "V"), - (0x17EA, "X"), - (0x17F0, "V"), - (0x17FA, "X"), - (0x1800, "V"), - (0x180B, "I"), - (0x1810, "V"), - (0x181A, "X"), - (0x1820, "V"), - (0x1879, "X"), - (0x1880, "V"), - (0x18AB, "X"), - (0x18B0, "V"), - (0x18F6, "X"), - (0x1900, "V"), - (0x191F, "X"), - (0x1920, "V"), - (0x192C, "X"), - (0x1930, "V"), - (0x193C, "X"), - (0x1940, "V"), - (0x1941, "X"), - (0x1944, "V"), - (0x196E, "X"), - ] - - -def _seg_15() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1970, "V"), - (0x1975, "X"), - (0x1980, "V"), - (0x19AC, "X"), - (0x19B0, "V"), - (0x19CA, "X"), - (0x19D0, "V"), - (0x19DB, "X"), - (0x19DE, "V"), - (0x1A1C, "X"), - (0x1A1E, "V"), - (0x1A5F, "X"), - (0x1A60, "V"), - (0x1A7D, "X"), - (0x1A7F, "V"), - (0x1A8A, "X"), - (0x1A90, "V"), - (0x1A9A, "X"), - (0x1AA0, "V"), - (0x1AAE, "X"), - (0x1AB0, "V"), - (0x1ACF, "X"), - (0x1B00, "V"), - (0x1B4D, "X"), - (0x1B4E, "V"), - (0x1BF4, "X"), - (0x1BFC, "V"), - (0x1C38, "X"), - (0x1C3B, "V"), - (0x1C4A, "X"), - (0x1C4D, "V"), - (0x1C80, "M", "в"), - (0x1C81, "M", "д"), - (0x1C82, "M", "о"), - (0x1C83, "M", "с"), - (0x1C84, "M", "т"), - (0x1C86, "M", "ъ"), - (0x1C87, "M", "ѣ"), - (0x1C88, "M", "ꙋ"), - (0x1C89, "M", "ᲊ"), - (0x1C8A, "V"), - (0x1C8B, "X"), - (0x1C90, "M", "ა"), - (0x1C91, "M", "ბ"), - (0x1C92, "M", "გ"), - (0x1C93, "M", "დ"), - (0x1C94, "M", "ე"), - (0x1C95, "M", "ვ"), - (0x1C96, "M", "ზ"), - (0x1C97, "M", "თ"), - (0x1C98, "M", "ი"), - (0x1C99, "M", "კ"), - (0x1C9A, "M", "ლ"), - (0x1C9B, "M", "მ"), - (0x1C9C, "M", "ნ"), - (0x1C9D, "M", "ო"), - (0x1C9E, "M", "პ"), - (0x1C9F, "M", "ჟ"), - (0x1CA0, "M", "რ"), - (0x1CA1, "M", "ს"), - (0x1CA2, "M", "ტ"), - (0x1CA3, "M", "უ"), - (0x1CA4, "M", "ფ"), - (0x1CA5, "M", "ქ"), - (0x1CA6, "M", "ღ"), - (0x1CA7, "M", "ყ"), - (0x1CA8, "M", "შ"), - (0x1CA9, "M", "ჩ"), - (0x1CAA, "M", "ც"), - (0x1CAB, "M", "ძ"), - (0x1CAC, "M", "წ"), - (0x1CAD, "M", "ჭ"), - (0x1CAE, "M", "ხ"), - (0x1CAF, "M", "ჯ"), - (0x1CB0, "M", "ჰ"), - (0x1CB1, "M", "ჱ"), - (0x1CB2, "M", "ჲ"), - (0x1CB3, "M", "ჳ"), - (0x1CB4, "M", "ჴ"), - (0x1CB5, "M", "ჵ"), - (0x1CB6, "M", "ჶ"), - (0x1CB7, "M", "ჷ"), - (0x1CB8, "M", "ჸ"), - (0x1CB9, "M", "ჹ"), - (0x1CBA, "M", "ჺ"), - (0x1CBB, "X"), - (0x1CBD, "M", "ჽ"), - (0x1CBE, "M", "ჾ"), - (0x1CBF, "M", "ჿ"), - (0x1CC0, "V"), - (0x1CC8, "X"), - (0x1CD0, "V"), - (0x1CFB, "X"), - (0x1D00, "V"), - (0x1D2C, "M", "a"), - (0x1D2D, "M", "æ"), - (0x1D2E, "M", "b"), - (0x1D2F, "V"), - (0x1D30, "M", "d"), - (0x1D31, "M", "e"), - ] - - -def _seg_16() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D32, "M", "ǝ"), - (0x1D33, "M", "g"), - (0x1D34, "M", "h"), - (0x1D35, "M", "i"), - (0x1D36, "M", "j"), - (0x1D37, "M", "k"), - (0x1D38, "M", "l"), - (0x1D39, "M", "m"), - (0x1D3A, "M", "n"), - (0x1D3B, "V"), - (0x1D3C, "M", "o"), - (0x1D3D, "M", "ȣ"), - (0x1D3E, "M", "p"), - (0x1D3F, "M", "r"), - (0x1D40, "M", "t"), - (0x1D41, "M", "u"), - (0x1D42, "M", "w"), - (0x1D43, "M", "a"), - (0x1D44, "M", "ɐ"), - (0x1D45, "M", "ɑ"), - (0x1D46, "M", "ᴂ"), - (0x1D47, "M", "b"), - (0x1D48, "M", "d"), - (0x1D49, "M", "e"), - (0x1D4A, "M", "ə"), - (0x1D4B, "M", "ɛ"), - (0x1D4C, "M", "ɜ"), - (0x1D4D, "M", "g"), - (0x1D4E, "V"), - (0x1D4F, "M", "k"), - (0x1D50, "M", "m"), - (0x1D51, "M", "ŋ"), - (0x1D52, "M", "o"), - (0x1D53, "M", "ɔ"), - (0x1D54, "M", "ᴖ"), - (0x1D55, "M", "ᴗ"), - (0x1D56, "M", "p"), - (0x1D57, "M", "t"), - (0x1D58, "M", "u"), - (0x1D59, "M", "ᴝ"), - (0x1D5A, "M", "ɯ"), - (0x1D5B, "M", "v"), - (0x1D5C, "M", "ᴥ"), - (0x1D5D, "M", "β"), - (0x1D5E, "M", "γ"), - (0x1D5F, "M", "δ"), - (0x1D60, "M", "φ"), - (0x1D61, "M", "χ"), - (0x1D62, "M", "i"), - (0x1D63, "M", "r"), - (0x1D64, "M", "u"), - (0x1D65, "M", "v"), - (0x1D66, "M", "β"), - (0x1D67, "M", "γ"), - (0x1D68, "M", "ρ"), - (0x1D69, "M", "φ"), - (0x1D6A, "M", "χ"), - (0x1D6B, "V"), - (0x1D78, "M", "н"), - (0x1D79, "V"), - (0x1D9B, "M", "ɒ"), - (0x1D9C, "M", "c"), - (0x1D9D, "M", "ɕ"), - (0x1D9E, "M", "ð"), - (0x1D9F, "M", "ɜ"), - (0x1DA0, "M", "f"), - (0x1DA1, "M", "ɟ"), - (0x1DA2, "M", "ɡ"), - (0x1DA3, "M", "ɥ"), - (0x1DA4, "M", "ɨ"), - (0x1DA5, "M", "ɩ"), - (0x1DA6, "M", "ɪ"), - (0x1DA7, "M", "ᵻ"), - (0x1DA8, "M", "ʝ"), - (0x1DA9, "M", "ɭ"), - (0x1DAA, "M", "ᶅ"), - (0x1DAB, "M", "ʟ"), - (0x1DAC, "M", "ɱ"), - (0x1DAD, "M", "ɰ"), - (0x1DAE, "M", "ɲ"), - (0x1DAF, "M", "ɳ"), - (0x1DB0, "M", "ɴ"), - (0x1DB1, "M", "ɵ"), - (0x1DB2, "M", "ɸ"), - (0x1DB3, "M", "ʂ"), - (0x1DB4, "M", "ʃ"), - (0x1DB5, "M", "ƫ"), - (0x1DB6, "M", "ʉ"), - (0x1DB7, "M", "ʊ"), - (0x1DB8, "M", "ᴜ"), - (0x1DB9, "M", "ʋ"), - (0x1DBA, "M", "ʌ"), - (0x1DBB, "M", "z"), - (0x1DBC, "M", "ʐ"), - (0x1DBD, "M", "ʑ"), - (0x1DBE, "M", "ʒ"), - (0x1DBF, "M", "θ"), - (0x1DC0, "V"), - (0x1E00, "M", "ḁ"), - (0x1E01, "V"), - ] - - -def _seg_17() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1E02, "M", "ḃ"), - (0x1E03, "V"), - (0x1E04, "M", "ḅ"), - (0x1E05, "V"), - (0x1E06, "M", "ḇ"), - (0x1E07, "V"), - (0x1E08, "M", "ḉ"), - (0x1E09, "V"), - (0x1E0A, "M", "ḋ"), - (0x1E0B, "V"), - (0x1E0C, "M", "ḍ"), - (0x1E0D, "V"), - (0x1E0E, "M", "ḏ"), - (0x1E0F, "V"), - (0x1E10, "M", "ḑ"), - (0x1E11, "V"), - (0x1E12, "M", "ḓ"), - (0x1E13, "V"), - (0x1E14, "M", "ḕ"), - (0x1E15, "V"), - (0x1E16, "M", "ḗ"), - (0x1E17, "V"), - (0x1E18, "M", "ḙ"), - (0x1E19, "V"), - (0x1E1A, "M", "ḛ"), - (0x1E1B, "V"), - (0x1E1C, "M", "ḝ"), - (0x1E1D, "V"), - (0x1E1E, "M", "ḟ"), - (0x1E1F, "V"), - (0x1E20, "M", "ḡ"), - (0x1E21, "V"), - (0x1E22, "M", "ḣ"), - (0x1E23, "V"), - (0x1E24, "M", "ḥ"), - (0x1E25, "V"), - (0x1E26, "M", "ḧ"), - (0x1E27, "V"), - (0x1E28, "M", "ḩ"), - (0x1E29, "V"), - (0x1E2A, "M", "ḫ"), - (0x1E2B, "V"), - (0x1E2C, "M", "ḭ"), - (0x1E2D, "V"), - (0x1E2E, "M", "ḯ"), - (0x1E2F, "V"), - (0x1E30, "M", "ḱ"), - (0x1E31, "V"), - (0x1E32, "M", "ḳ"), - (0x1E33, "V"), - (0x1E34, "M", "ḵ"), - (0x1E35, "V"), - (0x1E36, "M", "ḷ"), - (0x1E37, "V"), - (0x1E38, "M", "ḹ"), - (0x1E39, "V"), - (0x1E3A, "M", "ḻ"), - (0x1E3B, "V"), - (0x1E3C, "M", "ḽ"), - (0x1E3D, "V"), - (0x1E3E, "M", "ḿ"), - (0x1E3F, "V"), - (0x1E40, "M", "ṁ"), - (0x1E41, "V"), - (0x1E42, "M", "ṃ"), - (0x1E43, "V"), - (0x1E44, "M", "ṅ"), - (0x1E45, "V"), - (0x1E46, "M", "ṇ"), - (0x1E47, "V"), - (0x1E48, "M", "ṉ"), - (0x1E49, "V"), - (0x1E4A, "M", "ṋ"), - (0x1E4B, "V"), - (0x1E4C, "M", "ṍ"), - (0x1E4D, "V"), - (0x1E4E, "M", "ṏ"), - (0x1E4F, "V"), - (0x1E50, "M", "ṑ"), - (0x1E51, "V"), - (0x1E52, "M", "ṓ"), - (0x1E53, "V"), - (0x1E54, "M", "ṕ"), - (0x1E55, "V"), - (0x1E56, "M", "ṗ"), - (0x1E57, "V"), - (0x1E58, "M", "ṙ"), - (0x1E59, "V"), - (0x1E5A, "M", "ṛ"), - (0x1E5B, "V"), - (0x1E5C, "M", "ṝ"), - (0x1E5D, "V"), - (0x1E5E, "M", "ṟ"), - (0x1E5F, "V"), - (0x1E60, "M", "ṡ"), - (0x1E61, "V"), - (0x1E62, "M", "ṣ"), - (0x1E63, "V"), - (0x1E64, "M", "ṥ"), - (0x1E65, "V"), - ] - - -def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1E66, "M", "ṧ"), - (0x1E67, "V"), - (0x1E68, "M", "ṩ"), - (0x1E69, "V"), - (0x1E6A, "M", "ṫ"), - (0x1E6B, "V"), - (0x1E6C, "M", "ṭ"), - (0x1E6D, "V"), - (0x1E6E, "M", "ṯ"), - (0x1E6F, "V"), - (0x1E70, "M", "ṱ"), - (0x1E71, "V"), - (0x1E72, "M", "ṳ"), - (0x1E73, "V"), - (0x1E74, "M", "ṵ"), - (0x1E75, "V"), - (0x1E76, "M", "ṷ"), - (0x1E77, "V"), - (0x1E78, "M", "ṹ"), - (0x1E79, "V"), - (0x1E7A, "M", "ṻ"), - (0x1E7B, "V"), - (0x1E7C, "M", "ṽ"), - (0x1E7D, "V"), - (0x1E7E, "M", "ṿ"), - (0x1E7F, "V"), - (0x1E80, "M", "ẁ"), - (0x1E81, "V"), - (0x1E82, "M", "ẃ"), - (0x1E83, "V"), - (0x1E84, "M", "ẅ"), - (0x1E85, "V"), - (0x1E86, "M", "ẇ"), - (0x1E87, "V"), - (0x1E88, "M", "ẉ"), - (0x1E89, "V"), - (0x1E8A, "M", "ẋ"), - (0x1E8B, "V"), - (0x1E8C, "M", "ẍ"), - (0x1E8D, "V"), - (0x1E8E, "M", "ẏ"), - (0x1E8F, "V"), - (0x1E90, "M", "ẑ"), - (0x1E91, "V"), - (0x1E92, "M", "ẓ"), - (0x1E93, "V"), - (0x1E94, "M", "ẕ"), - (0x1E95, "V"), - (0x1E9A, "M", "aʾ"), - (0x1E9B, "M", "ṡ"), - (0x1E9C, "V"), - (0x1E9E, "M", "ß"), - (0x1E9F, "V"), - (0x1EA0, "M", "ạ"), - (0x1EA1, "V"), - (0x1EA2, "M", "ả"), - (0x1EA3, "V"), - (0x1EA4, "M", "ấ"), - (0x1EA5, "V"), - (0x1EA6, "M", "ầ"), - (0x1EA7, "V"), - (0x1EA8, "M", "ẩ"), - (0x1EA9, "V"), - (0x1EAA, "M", "ẫ"), - (0x1EAB, "V"), - (0x1EAC, "M", "ậ"), - (0x1EAD, "V"), - (0x1EAE, "M", "ắ"), - (0x1EAF, "V"), - (0x1EB0, "M", "ằ"), - (0x1EB1, "V"), - (0x1EB2, "M", "ẳ"), - (0x1EB3, "V"), - (0x1EB4, "M", "ẵ"), - (0x1EB5, "V"), - (0x1EB6, "M", "ặ"), - (0x1EB7, "V"), - (0x1EB8, "M", "ẹ"), - (0x1EB9, "V"), - (0x1EBA, "M", "ẻ"), - (0x1EBB, "V"), - (0x1EBC, "M", "ẽ"), - (0x1EBD, "V"), - (0x1EBE, "M", "ế"), - (0x1EBF, "V"), - (0x1EC0, "M", "ề"), - (0x1EC1, "V"), - (0x1EC2, "M", "ể"), - (0x1EC3, "V"), - (0x1EC4, "M", "ễ"), - (0x1EC5, "V"), - (0x1EC6, "M", "ệ"), - (0x1EC7, "V"), - (0x1EC8, "M", "ỉ"), - (0x1EC9, "V"), - (0x1ECA, "M", "ị"), - (0x1ECB, "V"), - (0x1ECC, "M", "ọ"), - (0x1ECD, "V"), - (0x1ECE, "M", "ỏ"), - ] - - -def _seg_19() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1ECF, "V"), - (0x1ED0, "M", "ố"), - (0x1ED1, "V"), - (0x1ED2, "M", "ồ"), - (0x1ED3, "V"), - (0x1ED4, "M", "ổ"), - (0x1ED5, "V"), - (0x1ED6, "M", "ỗ"), - (0x1ED7, "V"), - (0x1ED8, "M", "ộ"), - (0x1ED9, "V"), - (0x1EDA, "M", "ớ"), - (0x1EDB, "V"), - (0x1EDC, "M", "ờ"), - (0x1EDD, "V"), - (0x1EDE, "M", "ở"), - (0x1EDF, "V"), - (0x1EE0, "M", "ỡ"), - (0x1EE1, "V"), - (0x1EE2, "M", "ợ"), - (0x1EE3, "V"), - (0x1EE4, "M", "ụ"), - (0x1EE5, "V"), - (0x1EE6, "M", "ủ"), - (0x1EE7, "V"), - (0x1EE8, "M", "ứ"), - (0x1EE9, "V"), - (0x1EEA, "M", "ừ"), - (0x1EEB, "V"), - (0x1EEC, "M", "ử"), - (0x1EED, "V"), - (0x1EEE, "M", "ữ"), - (0x1EEF, "V"), - (0x1EF0, "M", "ự"), - (0x1EF1, "V"), - (0x1EF2, "M", "ỳ"), - (0x1EF3, "V"), - (0x1EF4, "M", "ỵ"), - (0x1EF5, "V"), - (0x1EF6, "M", "ỷ"), - (0x1EF7, "V"), - (0x1EF8, "M", "ỹ"), - (0x1EF9, "V"), - (0x1EFA, "M", "ỻ"), - (0x1EFB, "V"), - (0x1EFC, "M", "ỽ"), - (0x1EFD, "V"), - (0x1EFE, "M", "ỿ"), - (0x1EFF, "V"), - (0x1F08, "M", "ἀ"), - (0x1F09, "M", "ἁ"), - (0x1F0A, "M", "ἂ"), - (0x1F0B, "M", "ἃ"), - (0x1F0C, "M", "ἄ"), - (0x1F0D, "M", "ἅ"), - (0x1F0E, "M", "ἆ"), - (0x1F0F, "M", "ἇ"), - (0x1F10, "V"), - (0x1F16, "X"), - (0x1F18, "M", "ἐ"), - (0x1F19, "M", "ἑ"), - (0x1F1A, "M", "ἒ"), - (0x1F1B, "M", "ἓ"), - (0x1F1C, "M", "ἔ"), - (0x1F1D, "M", "ἕ"), - (0x1F1E, "X"), - (0x1F20, "V"), - (0x1F28, "M", "ἠ"), - (0x1F29, "M", "ἡ"), - (0x1F2A, "M", "ἢ"), - (0x1F2B, "M", "ἣ"), - (0x1F2C, "M", "ἤ"), - (0x1F2D, "M", "ἥ"), - (0x1F2E, "M", "ἦ"), - (0x1F2F, "M", "ἧ"), - (0x1F30, "V"), - (0x1F38, "M", "ἰ"), - (0x1F39, "M", "ἱ"), - (0x1F3A, "M", "ἲ"), - (0x1F3B, "M", "ἳ"), - (0x1F3C, "M", "ἴ"), - (0x1F3D, "M", "ἵ"), - (0x1F3E, "M", "ἶ"), - (0x1F3F, "M", "ἷ"), - (0x1F40, "V"), - (0x1F46, "X"), - (0x1F48, "M", "ὀ"), - (0x1F49, "M", "ὁ"), - (0x1F4A, "M", "ὂ"), - (0x1F4B, "M", "ὃ"), - (0x1F4C, "M", "ὄ"), - (0x1F4D, "M", "ὅ"), - (0x1F4E, "X"), - (0x1F50, "V"), - (0x1F58, "X"), - (0x1F59, "M", "ὑ"), - (0x1F5A, "X"), - (0x1F5B, "M", "ὓ"), - (0x1F5C, "X"), - (0x1F5D, "M", "ὕ"), - ] - - -def _seg_20() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1F5E, "X"), - (0x1F5F, "M", "ὗ"), - (0x1F60, "V"), - (0x1F68, "M", "ὠ"), - (0x1F69, "M", "ὡ"), - (0x1F6A, "M", "ὢ"), - (0x1F6B, "M", "ὣ"), - (0x1F6C, "M", "ὤ"), - (0x1F6D, "M", "ὥ"), - (0x1F6E, "M", "ὦ"), - (0x1F6F, "M", "ὧ"), - (0x1F70, "V"), - (0x1F71, "M", "ά"), - (0x1F72, "V"), - (0x1F73, "M", "έ"), - (0x1F74, "V"), - (0x1F75, "M", "ή"), - (0x1F76, "V"), - (0x1F77, "M", "ί"), - (0x1F78, "V"), - (0x1F79, "M", "ό"), - (0x1F7A, "V"), - (0x1F7B, "M", "ύ"), - (0x1F7C, "V"), - (0x1F7D, "M", "ώ"), - (0x1F7E, "X"), - (0x1F80, "M", "ἀι"), - (0x1F81, "M", "ἁι"), - (0x1F82, "M", "ἂι"), - (0x1F83, "M", "ἃι"), - (0x1F84, "M", "ἄι"), - (0x1F85, "M", "ἅι"), - (0x1F86, "M", "ἆι"), - (0x1F87, "M", "ἇι"), - (0x1F88, "M", "ἀι"), - (0x1F89, "M", "ἁι"), - (0x1F8A, "M", "ἂι"), - (0x1F8B, "M", "ἃι"), - (0x1F8C, "M", "ἄι"), - (0x1F8D, "M", "ἅι"), - (0x1F8E, "M", "ἆι"), - (0x1F8F, "M", "ἇι"), - (0x1F90, "M", "ἠι"), - (0x1F91, "M", "ἡι"), - (0x1F92, "M", "ἢι"), - (0x1F93, "M", "ἣι"), - (0x1F94, "M", "ἤι"), - (0x1F95, "M", "ἥι"), - (0x1F96, "M", "ἦι"), - (0x1F97, "M", "ἧι"), - (0x1F98, "M", "ἠι"), - (0x1F99, "M", "ἡι"), - (0x1F9A, "M", "ἢι"), - (0x1F9B, "M", "ἣι"), - (0x1F9C, "M", "ἤι"), - (0x1F9D, "M", "ἥι"), - (0x1F9E, "M", "ἦι"), - (0x1F9F, "M", "ἧι"), - (0x1FA0, "M", "ὠι"), - (0x1FA1, "M", "ὡι"), - (0x1FA2, "M", "ὢι"), - (0x1FA3, "M", "ὣι"), - (0x1FA4, "M", "ὤι"), - (0x1FA5, "M", "ὥι"), - (0x1FA6, "M", "ὦι"), - (0x1FA7, "M", "ὧι"), - (0x1FA8, "M", "ὠι"), - (0x1FA9, "M", "ὡι"), - (0x1FAA, "M", "ὢι"), - (0x1FAB, "M", "ὣι"), - (0x1FAC, "M", "ὤι"), - (0x1FAD, "M", "ὥι"), - (0x1FAE, "M", "ὦι"), - (0x1FAF, "M", "ὧι"), - (0x1FB0, "V"), - (0x1FB2, "M", "ὰι"), - (0x1FB3, "M", "αι"), - (0x1FB4, "M", "άι"), - (0x1FB5, "X"), - (0x1FB6, "V"), - (0x1FB7, "M", "ᾶι"), - (0x1FB8, "M", "ᾰ"), - (0x1FB9, "M", "ᾱ"), - (0x1FBA, "M", "ὰ"), - (0x1FBB, "M", "ά"), - (0x1FBC, "M", "αι"), - (0x1FBD, "M", " ̓"), - (0x1FBE, "M", "ι"), - (0x1FBF, "M", " ̓"), - (0x1FC0, "M", " ͂"), - (0x1FC1, "M", " ̈͂"), - (0x1FC2, "M", "ὴι"), - (0x1FC3, "M", "ηι"), - (0x1FC4, "M", "ήι"), - (0x1FC5, "X"), - (0x1FC6, "V"), - (0x1FC7, "M", "ῆι"), - (0x1FC8, "M", "ὲ"), - (0x1FC9, "M", "έ"), - (0x1FCA, "M", "ὴ"), - ] - - -def _seg_21() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1FCB, "M", "ή"), - (0x1FCC, "M", "ηι"), - (0x1FCD, "M", " ̓̀"), - (0x1FCE, "M", " ̓́"), - (0x1FCF, "M", " ̓͂"), - (0x1FD0, "V"), - (0x1FD3, "M", "ΐ"), - (0x1FD4, "X"), - (0x1FD6, "V"), - (0x1FD8, "M", "ῐ"), - (0x1FD9, "M", "ῑ"), - (0x1FDA, "M", "ὶ"), - (0x1FDB, "M", "ί"), - (0x1FDC, "X"), - (0x1FDD, "M", " ̔̀"), - (0x1FDE, "M", " ̔́"), - (0x1FDF, "M", " ̔͂"), - (0x1FE0, "V"), - (0x1FE3, "M", "ΰ"), - (0x1FE4, "V"), - (0x1FE8, "M", "ῠ"), - (0x1FE9, "M", "ῡ"), - (0x1FEA, "M", "ὺ"), - (0x1FEB, "M", "ύ"), - (0x1FEC, "M", "ῥ"), - (0x1FED, "M", " ̈̀"), - (0x1FEE, "M", " ̈́"), - (0x1FEF, "M", "`"), - (0x1FF0, "X"), - (0x1FF2, "M", "ὼι"), - (0x1FF3, "M", "ωι"), - (0x1FF4, "M", "ώι"), - (0x1FF5, "X"), - (0x1FF6, "V"), - (0x1FF7, "M", "ῶι"), - (0x1FF8, "M", "ὸ"), - (0x1FF9, "M", "ό"), - (0x1FFA, "M", "ὼ"), - (0x1FFB, "M", "ώ"), - (0x1FFC, "M", "ωι"), - (0x1FFD, "M", " ́"), - (0x1FFE, "M", " ̔"), - (0x1FFF, "X"), - (0x2000, "M", " "), - (0x200B, "I"), - (0x200C, "D", ""), - (0x200E, "X"), - (0x2010, "V"), - (0x2011, "M", "‐"), - (0x2012, "V"), - (0x2017, "M", " ̳"), - (0x2018, "V"), - (0x2024, "X"), - (0x2027, "V"), - (0x2028, "X"), - (0x202F, "M", " "), - (0x2030, "V"), - (0x2033, "M", "′′"), - (0x2034, "M", "′′′"), - (0x2035, "V"), - (0x2036, "M", "‵‵"), - (0x2037, "M", "‵‵‵"), - (0x2038, "V"), - (0x203C, "M", "!!"), - (0x203D, "V"), - (0x203E, "M", " ̅"), - (0x203F, "V"), - (0x2047, "M", "??"), - (0x2048, "M", "?!"), - (0x2049, "M", "!?"), - (0x204A, "V"), - (0x2057, "M", "′′′′"), - (0x2058, "V"), - (0x205F, "M", " "), - (0x2060, "I"), - (0x2065, "X"), - (0x206A, "I"), - (0x2070, "M", "0"), - (0x2071, "M", "i"), - (0x2072, "X"), - (0x2074, "M", "4"), - (0x2075, "M", "5"), - (0x2076, "M", "6"), - (0x2077, "M", "7"), - (0x2078, "M", "8"), - (0x2079, "M", "9"), - (0x207A, "M", "+"), - (0x207B, "M", "−"), - (0x207C, "M", "="), - (0x207D, "M", "("), - (0x207E, "M", ")"), - (0x207F, "M", "n"), - (0x2080, "M", "0"), - (0x2081, "M", "1"), - (0x2082, "M", "2"), - (0x2083, "M", "3"), - (0x2084, "M", "4"), - (0x2085, "M", "5"), - (0x2086, "M", "6"), - (0x2087, "M", "7"), - ] - - -def _seg_22() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2088, "M", "8"), - (0x2089, "M", "9"), - (0x208A, "M", "+"), - (0x208B, "M", "−"), - (0x208C, "M", "="), - (0x208D, "M", "("), - (0x208E, "M", ")"), - (0x208F, "X"), - (0x2090, "M", "a"), - (0x2091, "M", "e"), - (0x2092, "M", "o"), - (0x2093, "M", "x"), - (0x2094, "M", "ə"), - (0x2095, "M", "h"), - (0x2096, "M", "k"), - (0x2097, "M", "l"), - (0x2098, "M", "m"), - (0x2099, "M", "n"), - (0x209A, "M", "p"), - (0x209B, "M", "s"), - (0x209C, "M", "t"), - (0x209D, "X"), - (0x20A0, "V"), - (0x20A8, "M", "rs"), - (0x20A9, "V"), - (0x20C1, "X"), - (0x20D0, "V"), - (0x20F1, "X"), - (0x2100, "M", "a/c"), - (0x2101, "M", "a/s"), - (0x2102, "M", "c"), - (0x2103, "M", "°c"), - (0x2104, "V"), - (0x2105, "M", "c/o"), - (0x2106, "M", "c/u"), - (0x2107, "M", "ɛ"), - (0x2108, "V"), - (0x2109, "M", "°f"), - (0x210A, "M", "g"), - (0x210B, "M", "h"), - (0x210F, "M", "ħ"), - (0x2110, "M", "i"), - (0x2112, "M", "l"), - (0x2114, "V"), - (0x2115, "M", "n"), - (0x2116, "M", "no"), - (0x2117, "V"), - (0x2119, "M", "p"), - (0x211A, "M", "q"), - (0x211B, "M", "r"), - (0x211E, "V"), - (0x2120, "M", "sm"), - (0x2121, "M", "tel"), - (0x2122, "M", "tm"), - (0x2123, "V"), - (0x2124, "M", "z"), - (0x2125, "V"), - (0x2126, "M", "ω"), - (0x2127, "V"), - (0x2128, "M", "z"), - (0x2129, "V"), - (0x212A, "M", "k"), - (0x212B, "M", "å"), - (0x212C, "M", "b"), - (0x212D, "M", "c"), - (0x212E, "V"), - (0x212F, "M", "e"), - (0x2131, "M", "f"), - (0x2132, "M", "ⅎ"), - (0x2133, "M", "m"), - (0x2134, "M", "o"), - (0x2135, "M", "א"), - (0x2136, "M", "ב"), - (0x2137, "M", "ג"), - (0x2138, "M", "ד"), - (0x2139, "M", "i"), - (0x213A, "V"), - (0x213B, "M", "fax"), - (0x213C, "M", "π"), - (0x213D, "M", "γ"), - (0x213F, "M", "π"), - (0x2140, "M", "∑"), - (0x2141, "V"), - (0x2145, "M", "d"), - (0x2147, "M", "e"), - (0x2148, "M", "i"), - (0x2149, "M", "j"), - (0x214A, "V"), - (0x2150, "M", "1⁄7"), - (0x2151, "M", "1⁄9"), - (0x2152, "M", "1⁄10"), - (0x2153, "M", "1⁄3"), - (0x2154, "M", "2⁄3"), - (0x2155, "M", "1⁄5"), - (0x2156, "M", "2⁄5"), - (0x2157, "M", "3⁄5"), - (0x2158, "M", "4⁄5"), - (0x2159, "M", "1⁄6"), - (0x215A, "M", "5⁄6"), - (0x215B, "M", "1⁄8"), - ] - - -def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x215C, "M", "3⁄8"), - (0x215D, "M", "5⁄8"), - (0x215E, "M", "7⁄8"), - (0x215F, "M", "1⁄"), - (0x2160, "M", "i"), - (0x2161, "M", "ii"), - (0x2162, "M", "iii"), - (0x2163, "M", "iv"), - (0x2164, "M", "v"), - (0x2165, "M", "vi"), - (0x2166, "M", "vii"), - (0x2167, "M", "viii"), - (0x2168, "M", "ix"), - (0x2169, "M", "x"), - (0x216A, "M", "xi"), - (0x216B, "M", "xii"), - (0x216C, "M", "l"), - (0x216D, "M", "c"), - (0x216E, "M", "d"), - (0x216F, "M", "m"), - (0x2170, "M", "i"), - (0x2171, "M", "ii"), - (0x2172, "M", "iii"), - (0x2173, "M", "iv"), - (0x2174, "M", "v"), - (0x2175, "M", "vi"), - (0x2176, "M", "vii"), - (0x2177, "M", "viii"), - (0x2178, "M", "ix"), - (0x2179, "M", "x"), - (0x217A, "M", "xi"), - (0x217B, "M", "xii"), - (0x217C, "M", "l"), - (0x217D, "M", "c"), - (0x217E, "M", "d"), - (0x217F, "M", "m"), - (0x2180, "V"), - (0x2183, "M", "ↄ"), - (0x2184, "V"), - (0x2189, "M", "0⁄3"), - (0x218A, "V"), - (0x218C, "X"), - (0x2190, "V"), - (0x222C, "M", "∫∫"), - (0x222D, "M", "∫∫∫"), - (0x222E, "V"), - (0x222F, "M", "∮∮"), - (0x2230, "M", "∮∮∮"), - (0x2231, "V"), - (0x2329, "M", "〈"), - (0x232A, "M", "〉"), - (0x232B, "V"), - (0x242A, "X"), - (0x2440, "V"), - (0x244B, "X"), - (0x2460, "M", "1"), - (0x2461, "M", "2"), - (0x2462, "M", "3"), - (0x2463, "M", "4"), - (0x2464, "M", "5"), - (0x2465, "M", "6"), - (0x2466, "M", "7"), - (0x2467, "M", "8"), - (0x2468, "M", "9"), - (0x2469, "M", "10"), - (0x246A, "M", "11"), - (0x246B, "M", "12"), - (0x246C, "M", "13"), - (0x246D, "M", "14"), - (0x246E, "M", "15"), - (0x246F, "M", "16"), - (0x2470, "M", "17"), - (0x2471, "M", "18"), - (0x2472, "M", "19"), - (0x2473, "M", "20"), - (0x2474, "M", "(1)"), - (0x2475, "M", "(2)"), - (0x2476, "M", "(3)"), - (0x2477, "M", "(4)"), - (0x2478, "M", "(5)"), - (0x2479, "M", "(6)"), - (0x247A, "M", "(7)"), - (0x247B, "M", "(8)"), - (0x247C, "M", "(9)"), - (0x247D, "M", "(10)"), - (0x247E, "M", "(11)"), - (0x247F, "M", "(12)"), - (0x2480, "M", "(13)"), - (0x2481, "M", "(14)"), - (0x2482, "M", "(15)"), - (0x2483, "M", "(16)"), - (0x2484, "M", "(17)"), - (0x2485, "M", "(18)"), - (0x2486, "M", "(19)"), - (0x2487, "M", "(20)"), - (0x2488, "X"), - (0x249C, "M", "(a)"), - (0x249D, "M", "(b)"), - (0x249E, "M", "(c)"), - (0x249F, "M", "(d)"), - ] - - -def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x24A0, "M", "(e)"), - (0x24A1, "M", "(f)"), - (0x24A2, "M", "(g)"), - (0x24A3, "M", "(h)"), - (0x24A4, "M", "(i)"), - (0x24A5, "M", "(j)"), - (0x24A6, "M", "(k)"), - (0x24A7, "M", "(l)"), - (0x24A8, "M", "(m)"), - (0x24A9, "M", "(n)"), - (0x24AA, "M", "(o)"), - (0x24AB, "M", "(p)"), - (0x24AC, "M", "(q)"), - (0x24AD, "M", "(r)"), - (0x24AE, "M", "(s)"), - (0x24AF, "M", "(t)"), - (0x24B0, "M", "(u)"), - (0x24B1, "M", "(v)"), - (0x24B2, "M", "(w)"), - (0x24B3, "M", "(x)"), - (0x24B4, "M", "(y)"), - (0x24B5, "M", "(z)"), - (0x24B6, "M", "a"), - (0x24B7, "M", "b"), - (0x24B8, "M", "c"), - (0x24B9, "M", "d"), - (0x24BA, "M", "e"), - (0x24BB, "M", "f"), - (0x24BC, "M", "g"), - (0x24BD, "M", "h"), - (0x24BE, "M", "i"), - (0x24BF, "M", "j"), - (0x24C0, "M", "k"), - (0x24C1, "M", "l"), - (0x24C2, "M", "m"), - (0x24C3, "M", "n"), - (0x24C4, "M", "o"), - (0x24C5, "M", "p"), - (0x24C6, "M", "q"), - (0x24C7, "M", "r"), - (0x24C8, "M", "s"), - (0x24C9, "M", "t"), - (0x24CA, "M", "u"), - (0x24CB, "M", "v"), - (0x24CC, "M", "w"), - (0x24CD, "M", "x"), - (0x24CE, "M", "y"), - (0x24CF, "M", "z"), - (0x24D0, "M", "a"), - (0x24D1, "M", "b"), - (0x24D2, "M", "c"), - (0x24D3, "M", "d"), - (0x24D4, "M", "e"), - (0x24D5, "M", "f"), - (0x24D6, "M", "g"), - (0x24D7, "M", "h"), - (0x24D8, "M", "i"), - (0x24D9, "M", "j"), - (0x24DA, "M", "k"), - (0x24DB, "M", "l"), - (0x24DC, "M", "m"), - (0x24DD, "M", "n"), - (0x24DE, "M", "o"), - (0x24DF, "M", "p"), - (0x24E0, "M", "q"), - (0x24E1, "M", "r"), - (0x24E2, "M", "s"), - (0x24E3, "M", "t"), - (0x24E4, "M", "u"), - (0x24E5, "M", "v"), - (0x24E6, "M", "w"), - (0x24E7, "M", "x"), - (0x24E8, "M", "y"), - (0x24E9, "M", "z"), - (0x24EA, "M", "0"), - (0x24EB, "V"), - (0x2A0C, "M", "∫∫∫∫"), - (0x2A0D, "V"), - (0x2A74, "M", "::="), - (0x2A75, "M", "=="), - (0x2A76, "M", "==="), - (0x2A77, "V"), - (0x2ADC, "M", "⫝̸"), - (0x2ADD, "V"), - (0x2B74, "X"), - (0x2B76, "V"), - (0x2B96, "X"), - (0x2B97, "V"), - (0x2C00, "M", "ⰰ"), - (0x2C01, "M", "ⰱ"), - (0x2C02, "M", "ⰲ"), - (0x2C03, "M", "ⰳ"), - (0x2C04, "M", "ⰴ"), - (0x2C05, "M", "ⰵ"), - (0x2C06, "M", "ⰶ"), - (0x2C07, "M", "ⰷ"), - (0x2C08, "M", "ⰸ"), - (0x2C09, "M", "ⰹ"), - (0x2C0A, "M", "ⰺ"), - (0x2C0B, "M", "ⰻ"), - ] - - -def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2C0C, "M", "ⰼ"), - (0x2C0D, "M", "ⰽ"), - (0x2C0E, "M", "ⰾ"), - (0x2C0F, "M", "ⰿ"), - (0x2C10, "M", "ⱀ"), - (0x2C11, "M", "ⱁ"), - (0x2C12, "M", "ⱂ"), - (0x2C13, "M", "ⱃ"), - (0x2C14, "M", "ⱄ"), - (0x2C15, "M", "ⱅ"), - (0x2C16, "M", "ⱆ"), - (0x2C17, "M", "ⱇ"), - (0x2C18, "M", "ⱈ"), - (0x2C19, "M", "ⱉ"), - (0x2C1A, "M", "ⱊ"), - (0x2C1B, "M", "ⱋ"), - (0x2C1C, "M", "ⱌ"), - (0x2C1D, "M", "ⱍ"), - (0x2C1E, "M", "ⱎ"), - (0x2C1F, "M", "ⱏ"), - (0x2C20, "M", "ⱐ"), - (0x2C21, "M", "ⱑ"), - (0x2C22, "M", "ⱒ"), - (0x2C23, "M", "ⱓ"), - (0x2C24, "M", "ⱔ"), - (0x2C25, "M", "ⱕ"), - (0x2C26, "M", "ⱖ"), - (0x2C27, "M", "ⱗ"), - (0x2C28, "M", "ⱘ"), - (0x2C29, "M", "ⱙ"), - (0x2C2A, "M", "ⱚ"), - (0x2C2B, "M", "ⱛ"), - (0x2C2C, "M", "ⱜ"), - (0x2C2D, "M", "ⱝ"), - (0x2C2E, "M", "ⱞ"), - (0x2C2F, "M", "ⱟ"), - (0x2C30, "V"), - (0x2C60, "M", "ⱡ"), - (0x2C61, "V"), - (0x2C62, "M", "ɫ"), - (0x2C63, "M", "ᵽ"), - (0x2C64, "M", "ɽ"), - (0x2C65, "V"), - (0x2C67, "M", "ⱨ"), - (0x2C68, "V"), - (0x2C69, "M", "ⱪ"), - (0x2C6A, "V"), - (0x2C6B, "M", "ⱬ"), - (0x2C6C, "V"), - (0x2C6D, "M", "ɑ"), - (0x2C6E, "M", "ɱ"), - (0x2C6F, "M", "ɐ"), - (0x2C70, "M", "ɒ"), - (0x2C71, "V"), - (0x2C72, "M", "ⱳ"), - (0x2C73, "V"), - (0x2C75, "M", "ⱶ"), - (0x2C76, "V"), - (0x2C7C, "M", "j"), - (0x2C7D, "M", "v"), - (0x2C7E, "M", "ȿ"), - (0x2C7F, "M", "ɀ"), - (0x2C80, "M", "ⲁ"), - (0x2C81, "V"), - (0x2C82, "M", "ⲃ"), - (0x2C83, "V"), - (0x2C84, "M", "ⲅ"), - (0x2C85, "V"), - (0x2C86, "M", "ⲇ"), - (0x2C87, "V"), - (0x2C88, "M", "ⲉ"), - (0x2C89, "V"), - (0x2C8A, "M", "ⲋ"), - (0x2C8B, "V"), - (0x2C8C, "M", "ⲍ"), - (0x2C8D, "V"), - (0x2C8E, "M", "ⲏ"), - (0x2C8F, "V"), - (0x2C90, "M", "ⲑ"), - (0x2C91, "V"), - (0x2C92, "M", "ⲓ"), - (0x2C93, "V"), - (0x2C94, "M", "ⲕ"), - (0x2C95, "V"), - (0x2C96, "M", "ⲗ"), - (0x2C97, "V"), - (0x2C98, "M", "ⲙ"), - (0x2C99, "V"), - (0x2C9A, "M", "ⲛ"), - (0x2C9B, "V"), - (0x2C9C, "M", "ⲝ"), - (0x2C9D, "V"), - (0x2C9E, "M", "ⲟ"), - (0x2C9F, "V"), - (0x2CA0, "M", "ⲡ"), - (0x2CA1, "V"), - (0x2CA2, "M", "ⲣ"), - (0x2CA3, "V"), - (0x2CA4, "M", "ⲥ"), - (0x2CA5, "V"), - ] - - -def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2CA6, "M", "ⲧ"), - (0x2CA7, "V"), - (0x2CA8, "M", "ⲩ"), - (0x2CA9, "V"), - (0x2CAA, "M", "ⲫ"), - (0x2CAB, "V"), - (0x2CAC, "M", "ⲭ"), - (0x2CAD, "V"), - (0x2CAE, "M", "ⲯ"), - (0x2CAF, "V"), - (0x2CB0, "M", "ⲱ"), - (0x2CB1, "V"), - (0x2CB2, "M", "ⲳ"), - (0x2CB3, "V"), - (0x2CB4, "M", "ⲵ"), - (0x2CB5, "V"), - (0x2CB6, "M", "ⲷ"), - (0x2CB7, "V"), - (0x2CB8, "M", "ⲹ"), - (0x2CB9, "V"), - (0x2CBA, "M", "ⲻ"), - (0x2CBB, "V"), - (0x2CBC, "M", "ⲽ"), - (0x2CBD, "V"), - (0x2CBE, "M", "ⲿ"), - (0x2CBF, "V"), - (0x2CC0, "M", "ⳁ"), - (0x2CC1, "V"), - (0x2CC2, "M", "ⳃ"), - (0x2CC3, "V"), - (0x2CC4, "M", "ⳅ"), - (0x2CC5, "V"), - (0x2CC6, "M", "ⳇ"), - (0x2CC7, "V"), - (0x2CC8, "M", "ⳉ"), - (0x2CC9, "V"), - (0x2CCA, "M", "ⳋ"), - (0x2CCB, "V"), - (0x2CCC, "M", "ⳍ"), - (0x2CCD, "V"), - (0x2CCE, "M", "ⳏ"), - (0x2CCF, "V"), - (0x2CD0, "M", "ⳑ"), - (0x2CD1, "V"), - (0x2CD2, "M", "ⳓ"), - (0x2CD3, "V"), - (0x2CD4, "M", "ⳕ"), - (0x2CD5, "V"), - (0x2CD6, "M", "ⳗ"), - (0x2CD7, "V"), - (0x2CD8, "M", "ⳙ"), - (0x2CD9, "V"), - (0x2CDA, "M", "ⳛ"), - (0x2CDB, "V"), - (0x2CDC, "M", "ⳝ"), - (0x2CDD, "V"), - (0x2CDE, "M", "ⳟ"), - (0x2CDF, "V"), - (0x2CE0, "M", "ⳡ"), - (0x2CE1, "V"), - (0x2CE2, "M", "ⳣ"), - (0x2CE3, "V"), - (0x2CEB, "M", "ⳬ"), - (0x2CEC, "V"), - (0x2CED, "M", "ⳮ"), - (0x2CEE, "V"), - (0x2CF2, "M", "ⳳ"), - (0x2CF3, "V"), - (0x2CF4, "X"), - (0x2CF9, "V"), - (0x2D26, "X"), - (0x2D27, "V"), - (0x2D28, "X"), - (0x2D2D, "V"), - (0x2D2E, "X"), - (0x2D30, "V"), - (0x2D68, "X"), - (0x2D6F, "M", "ⵡ"), - (0x2D70, "V"), - (0x2D71, "X"), - (0x2D7F, "V"), - (0x2D97, "X"), - (0x2DA0, "V"), - (0x2DA7, "X"), - (0x2DA8, "V"), - (0x2DAF, "X"), - (0x2DB0, "V"), - (0x2DB7, "X"), - (0x2DB8, "V"), - (0x2DBF, "X"), - (0x2DC0, "V"), - (0x2DC7, "X"), - (0x2DC8, "V"), - (0x2DCF, "X"), - (0x2DD0, "V"), - (0x2DD7, "X"), - (0x2DD8, "V"), - (0x2DDF, "X"), - (0x2DE0, "V"), - (0x2E5E, "X"), - ] - - -def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2E80, "V"), - (0x2E9A, "X"), - (0x2E9B, "V"), - (0x2E9F, "M", "母"), - (0x2EA0, "V"), - (0x2EF3, "M", "龟"), - (0x2EF4, "X"), - (0x2F00, "M", "一"), - (0x2F01, "M", "丨"), - (0x2F02, "M", "丶"), - (0x2F03, "M", "丿"), - (0x2F04, "M", "乙"), - (0x2F05, "M", "亅"), - (0x2F06, "M", "二"), - (0x2F07, "M", "亠"), - (0x2F08, "M", "人"), - (0x2F09, "M", "儿"), - (0x2F0A, "M", "入"), - (0x2F0B, "M", "八"), - (0x2F0C, "M", "冂"), - (0x2F0D, "M", "冖"), - (0x2F0E, "M", "冫"), - (0x2F0F, "M", "几"), - (0x2F10, "M", "凵"), - (0x2F11, "M", "刀"), - (0x2F12, "M", "力"), - (0x2F13, "M", "勹"), - (0x2F14, "M", "匕"), - (0x2F15, "M", "匚"), - (0x2F16, "M", "匸"), - (0x2F17, "M", "十"), - (0x2F18, "M", "卜"), - (0x2F19, "M", "卩"), - (0x2F1A, "M", "厂"), - (0x2F1B, "M", "厶"), - (0x2F1C, "M", "又"), - (0x2F1D, "M", "口"), - (0x2F1E, "M", "囗"), - (0x2F1F, "M", "土"), - (0x2F20, "M", "士"), - (0x2F21, "M", "夂"), - (0x2F22, "M", "夊"), - (0x2F23, "M", "夕"), - (0x2F24, "M", "大"), - (0x2F25, "M", "女"), - (0x2F26, "M", "子"), - (0x2F27, "M", "宀"), - (0x2F28, "M", "寸"), - (0x2F29, "M", "小"), - (0x2F2A, "M", "尢"), - (0x2F2B, "M", "尸"), - (0x2F2C, "M", "屮"), - (0x2F2D, "M", "山"), - (0x2F2E, "M", "巛"), - (0x2F2F, "M", "工"), - (0x2F30, "M", "己"), - (0x2F31, "M", "巾"), - (0x2F32, "M", "干"), - (0x2F33, "M", "幺"), - (0x2F34, "M", "广"), - (0x2F35, "M", "廴"), - (0x2F36, "M", "廾"), - (0x2F37, "M", "弋"), - (0x2F38, "M", "弓"), - (0x2F39, "M", "彐"), - (0x2F3A, "M", "彡"), - (0x2F3B, "M", "彳"), - (0x2F3C, "M", "心"), - (0x2F3D, "M", "戈"), - (0x2F3E, "M", "戶"), - (0x2F3F, "M", "手"), - (0x2F40, "M", "支"), - (0x2F41, "M", "攴"), - (0x2F42, "M", "文"), - (0x2F43, "M", "斗"), - (0x2F44, "M", "斤"), - (0x2F45, "M", "方"), - (0x2F46, "M", "无"), - (0x2F47, "M", "日"), - (0x2F48, "M", "曰"), - (0x2F49, "M", "月"), - (0x2F4A, "M", "木"), - (0x2F4B, "M", "欠"), - (0x2F4C, "M", "止"), - (0x2F4D, "M", "歹"), - (0x2F4E, "M", "殳"), - (0x2F4F, "M", "毋"), - (0x2F50, "M", "比"), - (0x2F51, "M", "毛"), - (0x2F52, "M", "氏"), - (0x2F53, "M", "气"), - (0x2F54, "M", "水"), - (0x2F55, "M", "火"), - (0x2F56, "M", "爪"), - (0x2F57, "M", "父"), - (0x2F58, "M", "爻"), - (0x2F59, "M", "爿"), - (0x2F5A, "M", "片"), - (0x2F5B, "M", "牙"), - (0x2F5C, "M", "牛"), - ] - - -def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2F5D, "M", "犬"), - (0x2F5E, "M", "玄"), - (0x2F5F, "M", "玉"), - (0x2F60, "M", "瓜"), - (0x2F61, "M", "瓦"), - (0x2F62, "M", "甘"), - (0x2F63, "M", "生"), - (0x2F64, "M", "用"), - (0x2F65, "M", "田"), - (0x2F66, "M", "疋"), - (0x2F67, "M", "疒"), - (0x2F68, "M", "癶"), - (0x2F69, "M", "白"), - (0x2F6A, "M", "皮"), - (0x2F6B, "M", "皿"), - (0x2F6C, "M", "目"), - (0x2F6D, "M", "矛"), - (0x2F6E, "M", "矢"), - (0x2F6F, "M", "石"), - (0x2F70, "M", "示"), - (0x2F71, "M", "禸"), - (0x2F72, "M", "禾"), - (0x2F73, "M", "穴"), - (0x2F74, "M", "立"), - (0x2F75, "M", "竹"), - (0x2F76, "M", "米"), - (0x2F77, "M", "糸"), - (0x2F78, "M", "缶"), - (0x2F79, "M", "网"), - (0x2F7A, "M", "羊"), - (0x2F7B, "M", "羽"), - (0x2F7C, "M", "老"), - (0x2F7D, "M", "而"), - (0x2F7E, "M", "耒"), - (0x2F7F, "M", "耳"), - (0x2F80, "M", "聿"), - (0x2F81, "M", "肉"), - (0x2F82, "M", "臣"), - (0x2F83, "M", "自"), - (0x2F84, "M", "至"), - (0x2F85, "M", "臼"), - (0x2F86, "M", "舌"), - (0x2F87, "M", "舛"), - (0x2F88, "M", "舟"), - (0x2F89, "M", "艮"), - (0x2F8A, "M", "色"), - (0x2F8B, "M", "艸"), - (0x2F8C, "M", "虍"), - (0x2F8D, "M", "虫"), - (0x2F8E, "M", "血"), - (0x2F8F, "M", "行"), - (0x2F90, "M", "衣"), - (0x2F91, "M", "襾"), - (0x2F92, "M", "見"), - (0x2F93, "M", "角"), - (0x2F94, "M", "言"), - (0x2F95, "M", "谷"), - (0x2F96, "M", "豆"), - (0x2F97, "M", "豕"), - (0x2F98, "M", "豸"), - (0x2F99, "M", "貝"), - (0x2F9A, "M", "赤"), - (0x2F9B, "M", "走"), - (0x2F9C, "M", "足"), - (0x2F9D, "M", "身"), - (0x2F9E, "M", "車"), - (0x2F9F, "M", "辛"), - (0x2FA0, "M", "辰"), - (0x2FA1, "M", "辵"), - (0x2FA2, "M", "邑"), - (0x2FA3, "M", "酉"), - (0x2FA4, "M", "釆"), - (0x2FA5, "M", "里"), - (0x2FA6, "M", "金"), - (0x2FA7, "M", "長"), - (0x2FA8, "M", "門"), - (0x2FA9, "M", "阜"), - (0x2FAA, "M", "隶"), - (0x2FAB, "M", "隹"), - (0x2FAC, "M", "雨"), - (0x2FAD, "M", "靑"), - (0x2FAE, "M", "非"), - (0x2FAF, "M", "面"), - (0x2FB0, "M", "革"), - (0x2FB1, "M", "韋"), - (0x2FB2, "M", "韭"), - (0x2FB3, "M", "音"), - (0x2FB4, "M", "頁"), - (0x2FB5, "M", "風"), - (0x2FB6, "M", "飛"), - (0x2FB7, "M", "食"), - (0x2FB8, "M", "首"), - (0x2FB9, "M", "香"), - (0x2FBA, "M", "馬"), - (0x2FBB, "M", "骨"), - (0x2FBC, "M", "高"), - (0x2FBD, "M", "髟"), - (0x2FBE, "M", "鬥"), - (0x2FBF, "M", "鬯"), - (0x2FC0, "M", "鬲"), - ] - - -def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2FC1, "M", "鬼"), - (0x2FC2, "M", "魚"), - (0x2FC3, "M", "鳥"), - (0x2FC4, "M", "鹵"), - (0x2FC5, "M", "鹿"), - (0x2FC6, "M", "麥"), - (0x2FC7, "M", "麻"), - (0x2FC8, "M", "黃"), - (0x2FC9, "M", "黍"), - (0x2FCA, "M", "黑"), - (0x2FCB, "M", "黹"), - (0x2FCC, "M", "黽"), - (0x2FCD, "M", "鼎"), - (0x2FCE, "M", "鼓"), - (0x2FCF, "M", "鼠"), - (0x2FD0, "M", "鼻"), - (0x2FD1, "M", "齊"), - (0x2FD2, "M", "齒"), - (0x2FD3, "M", "龍"), - (0x2FD4, "M", "龜"), - (0x2FD5, "M", "龠"), - (0x2FD6, "X"), - (0x3000, "M", " "), - (0x3001, "V"), - (0x3002, "M", "."), - (0x3003, "V"), - (0x3036, "M", "〒"), - (0x3037, "V"), - (0x3038, "M", "十"), - (0x3039, "M", "卄"), - (0x303A, "M", "卅"), - (0x303B, "V"), - (0x3040, "X"), - (0x3041, "V"), - (0x3097, "X"), - (0x3099, "V"), - (0x309B, "M", " ゙"), - (0x309C, "M", " ゚"), - (0x309D, "V"), - (0x309F, "M", "より"), - (0x30A0, "V"), - (0x30FF, "M", "コト"), - (0x3100, "X"), - (0x3105, "V"), - (0x3130, "X"), - (0x3131, "M", "ᄀ"), - (0x3132, "M", "ᄁ"), - (0x3133, "M", "ᆪ"), - (0x3134, "M", "ᄂ"), - (0x3135, "M", "ᆬ"), - (0x3136, "M", "ᆭ"), - (0x3137, "M", "ᄃ"), - (0x3138, "M", "ᄄ"), - (0x3139, "M", "ᄅ"), - (0x313A, "M", "ᆰ"), - (0x313B, "M", "ᆱ"), - (0x313C, "M", "ᆲ"), - (0x313D, "M", "ᆳ"), - (0x313E, "M", "ᆴ"), - (0x313F, "M", "ᆵ"), - (0x3140, "M", "ᄚ"), - (0x3141, "M", "ᄆ"), - (0x3142, "M", "ᄇ"), - (0x3143, "M", "ᄈ"), - (0x3144, "M", "ᄡ"), - (0x3145, "M", "ᄉ"), - (0x3146, "M", "ᄊ"), - (0x3147, "M", "ᄋ"), - (0x3148, "M", "ᄌ"), - (0x3149, "M", "ᄍ"), - (0x314A, "M", "ᄎ"), - (0x314B, "M", "ᄏ"), - (0x314C, "M", "ᄐ"), - (0x314D, "M", "ᄑ"), - (0x314E, "M", "ᄒ"), - (0x314F, "M", "ᅡ"), - (0x3150, "M", "ᅢ"), - (0x3151, "M", "ᅣ"), - (0x3152, "M", "ᅤ"), - (0x3153, "M", "ᅥ"), - (0x3154, "M", "ᅦ"), - (0x3155, "M", "ᅧ"), - (0x3156, "M", "ᅨ"), - (0x3157, "M", "ᅩ"), - (0x3158, "M", "ᅪ"), - (0x3159, "M", "ᅫ"), - (0x315A, "M", "ᅬ"), - (0x315B, "M", "ᅭ"), - (0x315C, "M", "ᅮ"), - (0x315D, "M", "ᅯ"), - (0x315E, "M", "ᅰ"), - (0x315F, "M", "ᅱ"), - (0x3160, "M", "ᅲ"), - (0x3161, "M", "ᅳ"), - (0x3162, "M", "ᅴ"), - (0x3163, "M", "ᅵ"), - (0x3164, "I"), - (0x3165, "M", "ᄔ"), - (0x3166, "M", "ᄕ"), - (0x3167, "M", "ᇇ"), - ] - - -def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x3168, "M", "ᇈ"), - (0x3169, "M", "ᇌ"), - (0x316A, "M", "ᇎ"), - (0x316B, "M", "ᇓ"), - (0x316C, "M", "ᇗ"), - (0x316D, "M", "ᇙ"), - (0x316E, "M", "ᄜ"), - (0x316F, "M", "ᇝ"), - (0x3170, "M", "ᇟ"), - (0x3171, "M", "ᄝ"), - (0x3172, "M", "ᄞ"), - (0x3173, "M", "ᄠ"), - (0x3174, "M", "ᄢ"), - (0x3175, "M", "ᄣ"), - (0x3176, "M", "ᄧ"), - (0x3177, "M", "ᄩ"), - (0x3178, "M", "ᄫ"), - (0x3179, "M", "ᄬ"), - (0x317A, "M", "ᄭ"), - (0x317B, "M", "ᄮ"), - (0x317C, "M", "ᄯ"), - (0x317D, "M", "ᄲ"), - (0x317E, "M", "ᄶ"), - (0x317F, "M", "ᅀ"), - (0x3180, "M", "ᅇ"), - (0x3181, "M", "ᅌ"), - (0x3182, "M", "ᇱ"), - (0x3183, "M", "ᇲ"), - (0x3184, "M", "ᅗ"), - (0x3185, "M", "ᅘ"), - (0x3186, "M", "ᅙ"), - (0x3187, "M", "ᆄ"), - (0x3188, "M", "ᆅ"), - (0x3189, "M", "ᆈ"), - (0x318A, "M", "ᆑ"), - (0x318B, "M", "ᆒ"), - (0x318C, "M", "ᆔ"), - (0x318D, "M", "ᆞ"), - (0x318E, "M", "ᆡ"), - (0x318F, "X"), - (0x3190, "V"), - (0x3192, "M", "一"), - (0x3193, "M", "二"), - (0x3194, "M", "三"), - (0x3195, "M", "四"), - (0x3196, "M", "上"), - (0x3197, "M", "中"), - (0x3198, "M", "下"), - (0x3199, "M", "甲"), - (0x319A, "M", "乙"), - (0x319B, "M", "丙"), - (0x319C, "M", "丁"), - (0x319D, "M", "天"), - (0x319E, "M", "地"), - (0x319F, "M", "人"), - (0x31A0, "V"), - (0x31E6, "X"), - (0x31F0, "V"), - (0x3200, "M", "(ᄀ)"), - (0x3201, "M", "(ᄂ)"), - (0x3202, "M", "(ᄃ)"), - (0x3203, "M", "(ᄅ)"), - (0x3204, "M", "(ᄆ)"), - (0x3205, "M", "(ᄇ)"), - (0x3206, "M", "(ᄉ)"), - (0x3207, "M", "(ᄋ)"), - (0x3208, "M", "(ᄌ)"), - (0x3209, "M", "(ᄎ)"), - (0x320A, "M", "(ᄏ)"), - (0x320B, "M", "(ᄐ)"), - (0x320C, "M", "(ᄑ)"), - (0x320D, "M", "(ᄒ)"), - (0x320E, "M", "(가)"), - (0x320F, "M", "(나)"), - (0x3210, "M", "(다)"), - (0x3211, "M", "(라)"), - (0x3212, "M", "(마)"), - (0x3213, "M", "(바)"), - (0x3214, "M", "(사)"), - (0x3215, "M", "(아)"), - (0x3216, "M", "(자)"), - (0x3217, "M", "(차)"), - (0x3218, "M", "(카)"), - (0x3219, "M", "(타)"), - (0x321A, "M", "(파)"), - (0x321B, "M", "(하)"), - (0x321C, "M", "(주)"), - (0x321D, "M", "(오전)"), - (0x321E, "M", "(오후)"), - (0x321F, "X"), - (0x3220, "M", "(一)"), - (0x3221, "M", "(二)"), - (0x3222, "M", "(三)"), - (0x3223, "M", "(四)"), - (0x3224, "M", "(五)"), - (0x3225, "M", "(六)"), - (0x3226, "M", "(七)"), - (0x3227, "M", "(八)"), - (0x3228, "M", "(九)"), - (0x3229, "M", "(十)"), - ] - - -def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x322A, "M", "(月)"), - (0x322B, "M", "(火)"), - (0x322C, "M", "(水)"), - (0x322D, "M", "(木)"), - (0x322E, "M", "(金)"), - (0x322F, "M", "(土)"), - (0x3230, "M", "(日)"), - (0x3231, "M", "(株)"), - (0x3232, "M", "(有)"), - (0x3233, "M", "(社)"), - (0x3234, "M", "(名)"), - (0x3235, "M", "(特)"), - (0x3236, "M", "(財)"), - (0x3237, "M", "(祝)"), - (0x3238, "M", "(労)"), - (0x3239, "M", "(代)"), - (0x323A, "M", "(呼)"), - (0x323B, "M", "(学)"), - (0x323C, "M", "(監)"), - (0x323D, "M", "(企)"), - (0x323E, "M", "(資)"), - (0x323F, "M", "(協)"), - (0x3240, "M", "(祭)"), - (0x3241, "M", "(休)"), - (0x3242, "M", "(自)"), - (0x3243, "M", "(至)"), - (0x3244, "M", "問"), - (0x3245, "M", "幼"), - (0x3246, "M", "文"), - (0x3247, "M", "箏"), - (0x3248, "V"), - (0x3250, "M", "pte"), - (0x3251, "M", "21"), - (0x3252, "M", "22"), - (0x3253, "M", "23"), - (0x3254, "M", "24"), - (0x3255, "M", "25"), - (0x3256, "M", "26"), - (0x3257, "M", "27"), - (0x3258, "M", "28"), - (0x3259, "M", "29"), - (0x325A, "M", "30"), - (0x325B, "M", "31"), - (0x325C, "M", "32"), - (0x325D, "M", "33"), - (0x325E, "M", "34"), - (0x325F, "M", "35"), - (0x3260, "M", "ᄀ"), - (0x3261, "M", "ᄂ"), - (0x3262, "M", "ᄃ"), - (0x3263, "M", "ᄅ"), - (0x3264, "M", "ᄆ"), - (0x3265, "M", "ᄇ"), - (0x3266, "M", "ᄉ"), - (0x3267, "M", "ᄋ"), - (0x3268, "M", "ᄌ"), - (0x3269, "M", "ᄎ"), - (0x326A, "M", "ᄏ"), - (0x326B, "M", "ᄐ"), - (0x326C, "M", "ᄑ"), - (0x326D, "M", "ᄒ"), - (0x326E, "M", "가"), - (0x326F, "M", "나"), - (0x3270, "M", "다"), - (0x3271, "M", "라"), - (0x3272, "M", "마"), - (0x3273, "M", "바"), - (0x3274, "M", "사"), - (0x3275, "M", "아"), - (0x3276, "M", "자"), - (0x3277, "M", "차"), - (0x3278, "M", "카"), - (0x3279, "M", "타"), - (0x327A, "M", "파"), - (0x327B, "M", "하"), - (0x327C, "M", "참고"), - (0x327D, "M", "주의"), - (0x327E, "M", "우"), - (0x327F, "V"), - (0x3280, "M", "一"), - (0x3281, "M", "二"), - (0x3282, "M", "三"), - (0x3283, "M", "四"), - (0x3284, "M", "五"), - (0x3285, "M", "六"), - (0x3286, "M", "七"), - (0x3287, "M", "八"), - (0x3288, "M", "九"), - (0x3289, "M", "十"), - (0x328A, "M", "月"), - (0x328B, "M", "火"), - (0x328C, "M", "水"), - (0x328D, "M", "木"), - (0x328E, "M", "金"), - (0x328F, "M", "土"), - (0x3290, "M", "日"), - (0x3291, "M", "株"), - (0x3292, "M", "有"), - (0x3293, "M", "社"), - (0x3294, "M", "名"), - ] - - -def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x3295, "M", "特"), - (0x3296, "M", "財"), - (0x3297, "M", "祝"), - (0x3298, "M", "労"), - (0x3299, "M", "秘"), - (0x329A, "M", "男"), - (0x329B, "M", "女"), - (0x329C, "M", "適"), - (0x329D, "M", "優"), - (0x329E, "M", "印"), - (0x329F, "M", "注"), - (0x32A0, "M", "項"), - (0x32A1, "M", "休"), - (0x32A2, "M", "写"), - (0x32A3, "M", "正"), - (0x32A4, "M", "上"), - (0x32A5, "M", "中"), - (0x32A6, "M", "下"), - (0x32A7, "M", "左"), - (0x32A8, "M", "右"), - (0x32A9, "M", "医"), - (0x32AA, "M", "宗"), - (0x32AB, "M", "学"), - (0x32AC, "M", "監"), - (0x32AD, "M", "企"), - (0x32AE, "M", "資"), - (0x32AF, "M", "協"), - (0x32B0, "M", "夜"), - (0x32B1, "M", "36"), - (0x32B2, "M", "37"), - (0x32B3, "M", "38"), - (0x32B4, "M", "39"), - (0x32B5, "M", "40"), - (0x32B6, "M", "41"), - (0x32B7, "M", "42"), - (0x32B8, "M", "43"), - (0x32B9, "M", "44"), - (0x32BA, "M", "45"), - (0x32BB, "M", "46"), - (0x32BC, "M", "47"), - (0x32BD, "M", "48"), - (0x32BE, "M", "49"), - (0x32BF, "M", "50"), - (0x32C0, "M", "1月"), - (0x32C1, "M", "2月"), - (0x32C2, "M", "3月"), - (0x32C3, "M", "4月"), - (0x32C4, "M", "5月"), - (0x32C5, "M", "6月"), - (0x32C6, "M", "7月"), - (0x32C7, "M", "8月"), - (0x32C8, "M", "9月"), - (0x32C9, "M", "10月"), - (0x32CA, "M", "11月"), - (0x32CB, "M", "12月"), - (0x32CC, "M", "hg"), - (0x32CD, "M", "erg"), - (0x32CE, "M", "ev"), - (0x32CF, "M", "ltd"), - (0x32D0, "M", "ア"), - (0x32D1, "M", "イ"), - (0x32D2, "M", "ウ"), - (0x32D3, "M", "エ"), - (0x32D4, "M", "オ"), - (0x32D5, "M", "カ"), - (0x32D6, "M", "キ"), - (0x32D7, "M", "ク"), - (0x32D8, "M", "ケ"), - (0x32D9, "M", "コ"), - (0x32DA, "M", "サ"), - (0x32DB, "M", "シ"), - (0x32DC, "M", "ス"), - (0x32DD, "M", "セ"), - (0x32DE, "M", "ソ"), - (0x32DF, "M", "タ"), - (0x32E0, "M", "チ"), - (0x32E1, "M", "ツ"), - (0x32E2, "M", "テ"), - (0x32E3, "M", "ト"), - (0x32E4, "M", "ナ"), - (0x32E5, "M", "ニ"), - (0x32E6, "M", "ヌ"), - (0x32E7, "M", "ネ"), - (0x32E8, "M", "ノ"), - (0x32E9, "M", "ハ"), - (0x32EA, "M", "ヒ"), - (0x32EB, "M", "フ"), - (0x32EC, "M", "ヘ"), - (0x32ED, "M", "ホ"), - (0x32EE, "M", "マ"), - (0x32EF, "M", "ミ"), - (0x32F0, "M", "ム"), - (0x32F1, "M", "メ"), - (0x32F2, "M", "モ"), - (0x32F3, "M", "ヤ"), - (0x32F4, "M", "ユ"), - (0x32F5, "M", "ヨ"), - (0x32F6, "M", "ラ"), - (0x32F7, "M", "リ"), - (0x32F8, "M", "ル"), - ] - - -def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x32F9, "M", "レ"), - (0x32FA, "M", "ロ"), - (0x32FB, "M", "ワ"), - (0x32FC, "M", "ヰ"), - (0x32FD, "M", "ヱ"), - (0x32FE, "M", "ヲ"), - (0x32FF, "M", "令和"), - (0x3300, "M", "アパート"), - (0x3301, "M", "アルファ"), - (0x3302, "M", "アンペア"), - (0x3303, "M", "アール"), - (0x3304, "M", "イニング"), - (0x3305, "M", "インチ"), - (0x3306, "M", "ウォン"), - (0x3307, "M", "エスクード"), - (0x3308, "M", "エーカー"), - (0x3309, "M", "オンス"), - (0x330A, "M", "オーム"), - (0x330B, "M", "カイリ"), - (0x330C, "M", "カラット"), - (0x330D, "M", "カロリー"), - (0x330E, "M", "ガロン"), - (0x330F, "M", "ガンマ"), - (0x3310, "M", "ギガ"), - (0x3311, "M", "ギニー"), - (0x3312, "M", "キュリー"), - (0x3313, "M", "ギルダー"), - (0x3314, "M", "キロ"), - (0x3315, "M", "キログラム"), - (0x3316, "M", "キロメートル"), - (0x3317, "M", "キロワット"), - (0x3318, "M", "グラム"), - (0x3319, "M", "グラムトン"), - (0x331A, "M", "クルゼイロ"), - (0x331B, "M", "クローネ"), - (0x331C, "M", "ケース"), - (0x331D, "M", "コルナ"), - (0x331E, "M", "コーポ"), - (0x331F, "M", "サイクル"), - (0x3320, "M", "サンチーム"), - (0x3321, "M", "シリング"), - (0x3322, "M", "センチ"), - (0x3323, "M", "セント"), - (0x3324, "M", "ダース"), - (0x3325, "M", "デシ"), - (0x3326, "M", "ドル"), - (0x3327, "M", "トン"), - (0x3328, "M", "ナノ"), - (0x3329, "M", "ノット"), - (0x332A, "M", "ハイツ"), - (0x332B, "M", "パーセント"), - (0x332C, "M", "パーツ"), - (0x332D, "M", "バーレル"), - (0x332E, "M", "ピアストル"), - (0x332F, "M", "ピクル"), - (0x3330, "M", "ピコ"), - (0x3331, "M", "ビル"), - (0x3332, "M", "ファラッド"), - (0x3333, "M", "フィート"), - (0x3334, "M", "ブッシェル"), - (0x3335, "M", "フラン"), - (0x3336, "M", "ヘクタール"), - (0x3337, "M", "ペソ"), - (0x3338, "M", "ペニヒ"), - (0x3339, "M", "ヘルツ"), - (0x333A, "M", "ペンス"), - (0x333B, "M", "ページ"), - (0x333C, "M", "ベータ"), - (0x333D, "M", "ポイント"), - (0x333E, "M", "ボルト"), - (0x333F, "M", "ホン"), - (0x3340, "M", "ポンド"), - (0x3341, "M", "ホール"), - (0x3342, "M", "ホーン"), - (0x3343, "M", "マイクロ"), - (0x3344, "M", "マイル"), - (0x3345, "M", "マッハ"), - (0x3346, "M", "マルク"), - (0x3347, "M", "マンション"), - (0x3348, "M", "ミクロン"), - (0x3349, "M", "ミリ"), - (0x334A, "M", "ミリバール"), - (0x334B, "M", "メガ"), - (0x334C, "M", "メガトン"), - (0x334D, "M", "メートル"), - (0x334E, "M", "ヤード"), - (0x334F, "M", "ヤール"), - (0x3350, "M", "ユアン"), - (0x3351, "M", "リットル"), - (0x3352, "M", "リラ"), - (0x3353, "M", "ルピー"), - (0x3354, "M", "ルーブル"), - (0x3355, "M", "レム"), - (0x3356, "M", "レントゲン"), - (0x3357, "M", "ワット"), - (0x3358, "M", "0点"), - (0x3359, "M", "1点"), - (0x335A, "M", "2点"), - (0x335B, "M", "3点"), - (0x335C, "M", "4点"), - ] - - -def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x335D, "M", "5点"), - (0x335E, "M", "6点"), - (0x335F, "M", "7点"), - (0x3360, "M", "8点"), - (0x3361, "M", "9点"), - (0x3362, "M", "10点"), - (0x3363, "M", "11点"), - (0x3364, "M", "12点"), - (0x3365, "M", "13点"), - (0x3366, "M", "14点"), - (0x3367, "M", "15点"), - (0x3368, "M", "16点"), - (0x3369, "M", "17点"), - (0x336A, "M", "18点"), - (0x336B, "M", "19点"), - (0x336C, "M", "20点"), - (0x336D, "M", "21点"), - (0x336E, "M", "22点"), - (0x336F, "M", "23点"), - (0x3370, "M", "24点"), - (0x3371, "M", "hpa"), - (0x3372, "M", "da"), - (0x3373, "M", "au"), - (0x3374, "M", "bar"), - (0x3375, "M", "ov"), - (0x3376, "M", "pc"), - (0x3377, "M", "dm"), - (0x3378, "M", "dm2"), - (0x3379, "M", "dm3"), - (0x337A, "M", "iu"), - (0x337B, "M", "平成"), - (0x337C, "M", "昭和"), - (0x337D, "M", "大正"), - (0x337E, "M", "明治"), - (0x337F, "M", "株式会社"), - (0x3380, "M", "pa"), - (0x3381, "M", "na"), - (0x3382, "M", "μa"), - (0x3383, "M", "ma"), - (0x3384, "M", "ka"), - (0x3385, "M", "kb"), - (0x3386, "M", "mb"), - (0x3387, "M", "gb"), - (0x3388, "M", "cal"), - (0x3389, "M", "kcal"), - (0x338A, "M", "pf"), - (0x338B, "M", "nf"), - (0x338C, "M", "μf"), - (0x338D, "M", "μg"), - (0x338E, "M", "mg"), - (0x338F, "M", "kg"), - (0x3390, "M", "hz"), - (0x3391, "M", "khz"), - (0x3392, "M", "mhz"), - (0x3393, "M", "ghz"), - (0x3394, "M", "thz"), - (0x3395, "M", "μl"), - (0x3396, "M", "ml"), - (0x3397, "M", "dl"), - (0x3398, "M", "kl"), - (0x3399, "M", "fm"), - (0x339A, "M", "nm"), - (0x339B, "M", "μm"), - (0x339C, "M", "mm"), - (0x339D, "M", "cm"), - (0x339E, "M", "km"), - (0x339F, "M", "mm2"), - (0x33A0, "M", "cm2"), - (0x33A1, "M", "m2"), - (0x33A2, "M", "km2"), - (0x33A3, "M", "mm3"), - (0x33A4, "M", "cm3"), - (0x33A5, "M", "m3"), - (0x33A6, "M", "km3"), - (0x33A7, "M", "m∕s"), - (0x33A8, "M", "m∕s2"), - (0x33A9, "M", "pa"), - (0x33AA, "M", "kpa"), - (0x33AB, "M", "mpa"), - (0x33AC, "M", "gpa"), - (0x33AD, "M", "rad"), - (0x33AE, "M", "rad∕s"), - (0x33AF, "M", "rad∕s2"), - (0x33B0, "M", "ps"), - (0x33B1, "M", "ns"), - (0x33B2, "M", "μs"), - (0x33B3, "M", "ms"), - (0x33B4, "M", "pv"), - (0x33B5, "M", "nv"), - (0x33B6, "M", "μv"), - (0x33B7, "M", "mv"), - (0x33B8, "M", "kv"), - (0x33B9, "M", "mv"), - (0x33BA, "M", "pw"), - (0x33BB, "M", "nw"), - (0x33BC, "M", "μw"), - (0x33BD, "M", "mw"), - (0x33BE, "M", "kw"), - (0x33BF, "M", "mw"), - (0x33C0, "M", "kω"), - ] - - -def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x33C1, "M", "mω"), - (0x33C2, "X"), - (0x33C3, "M", "bq"), - (0x33C4, "M", "cc"), - (0x33C5, "M", "cd"), - (0x33C6, "M", "c∕kg"), - (0x33C7, "X"), - (0x33C8, "M", "db"), - (0x33C9, "M", "gy"), - (0x33CA, "M", "ha"), - (0x33CB, "M", "hp"), - (0x33CC, "M", "in"), - (0x33CD, "M", "kk"), - (0x33CE, "M", "km"), - (0x33CF, "M", "kt"), - (0x33D0, "M", "lm"), - (0x33D1, "M", "ln"), - (0x33D2, "M", "log"), - (0x33D3, "M", "lx"), - (0x33D4, "M", "mb"), - (0x33D5, "M", "mil"), - (0x33D6, "M", "mol"), - (0x33D7, "M", "ph"), - (0x33D8, "X"), - (0x33D9, "M", "ppm"), - (0x33DA, "M", "pr"), - (0x33DB, "M", "sr"), - (0x33DC, "M", "sv"), - (0x33DD, "M", "wb"), - (0x33DE, "M", "v∕m"), - (0x33DF, "M", "a∕m"), - (0x33E0, "M", "1日"), - (0x33E1, "M", "2日"), - (0x33E2, "M", "3日"), - (0x33E3, "M", "4日"), - (0x33E4, "M", "5日"), - (0x33E5, "M", "6日"), - (0x33E6, "M", "7日"), - (0x33E7, "M", "8日"), - (0x33E8, "M", "9日"), - (0x33E9, "M", "10日"), - (0x33EA, "M", "11日"), - (0x33EB, "M", "12日"), - (0x33EC, "M", "13日"), - (0x33ED, "M", "14日"), - (0x33EE, "M", "15日"), - (0x33EF, "M", "16日"), - (0x33F0, "M", "17日"), - (0x33F1, "M", "18日"), - (0x33F2, "M", "19日"), - (0x33F3, "M", "20日"), - (0x33F4, "M", "21日"), - (0x33F5, "M", "22日"), - (0x33F6, "M", "23日"), - (0x33F7, "M", "24日"), - (0x33F8, "M", "25日"), - (0x33F9, "M", "26日"), - (0x33FA, "M", "27日"), - (0x33FB, "M", "28日"), - (0x33FC, "M", "29日"), - (0x33FD, "M", "30日"), - (0x33FE, "M", "31日"), - (0x33FF, "M", "gal"), - (0x3400, "V"), - (0xA48D, "X"), - (0xA490, "V"), - (0xA4C7, "X"), - (0xA4D0, "V"), - (0xA62C, "X"), - (0xA640, "M", "ꙁ"), - (0xA641, "V"), - (0xA642, "M", "ꙃ"), - (0xA643, "V"), - (0xA644, "M", "ꙅ"), - (0xA645, "V"), - (0xA646, "M", "ꙇ"), - (0xA647, "V"), - (0xA648, "M", "ꙉ"), - (0xA649, "V"), - (0xA64A, "M", "ꙋ"), - (0xA64B, "V"), - (0xA64C, "M", "ꙍ"), - (0xA64D, "V"), - (0xA64E, "M", "ꙏ"), - (0xA64F, "V"), - (0xA650, "M", "ꙑ"), - (0xA651, "V"), - (0xA652, "M", "ꙓ"), - (0xA653, "V"), - (0xA654, "M", "ꙕ"), - (0xA655, "V"), - (0xA656, "M", "ꙗ"), - (0xA657, "V"), - (0xA658, "M", "ꙙ"), - (0xA659, "V"), - (0xA65A, "M", "ꙛ"), - (0xA65B, "V"), - (0xA65C, "M", "ꙝ"), - (0xA65D, "V"), - (0xA65E, "M", "ꙟ"), - ] - - -def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xA65F, "V"), - (0xA660, "M", "ꙡ"), - (0xA661, "V"), - (0xA662, "M", "ꙣ"), - (0xA663, "V"), - (0xA664, "M", "ꙥ"), - (0xA665, "V"), - (0xA666, "M", "ꙧ"), - (0xA667, "V"), - (0xA668, "M", "ꙩ"), - (0xA669, "V"), - (0xA66A, "M", "ꙫ"), - (0xA66B, "V"), - (0xA66C, "M", "ꙭ"), - (0xA66D, "V"), - (0xA680, "M", "ꚁ"), - (0xA681, "V"), - (0xA682, "M", "ꚃ"), - (0xA683, "V"), - (0xA684, "M", "ꚅ"), - (0xA685, "V"), - (0xA686, "M", "ꚇ"), - (0xA687, "V"), - (0xA688, "M", "ꚉ"), - (0xA689, "V"), - (0xA68A, "M", "ꚋ"), - (0xA68B, "V"), - (0xA68C, "M", "ꚍ"), - (0xA68D, "V"), - (0xA68E, "M", "ꚏ"), - (0xA68F, "V"), - (0xA690, "M", "ꚑ"), - (0xA691, "V"), - (0xA692, "M", "ꚓ"), - (0xA693, "V"), - (0xA694, "M", "ꚕ"), - (0xA695, "V"), - (0xA696, "M", "ꚗ"), - (0xA697, "V"), - (0xA698, "M", "ꚙ"), - (0xA699, "V"), - (0xA69A, "M", "ꚛ"), - (0xA69B, "V"), - (0xA69C, "M", "ъ"), - (0xA69D, "M", "ь"), - (0xA69E, "V"), - (0xA6F8, "X"), - (0xA700, "V"), - (0xA722, "M", "ꜣ"), - (0xA723, "V"), - (0xA724, "M", "ꜥ"), - (0xA725, "V"), - (0xA726, "M", "ꜧ"), - (0xA727, "V"), - (0xA728, "M", "ꜩ"), - (0xA729, "V"), - (0xA72A, "M", "ꜫ"), - (0xA72B, "V"), - (0xA72C, "M", "ꜭ"), - (0xA72D, "V"), - (0xA72E, "M", "ꜯ"), - (0xA72F, "V"), - (0xA732, "M", "ꜳ"), - (0xA733, "V"), - (0xA734, "M", "ꜵ"), - (0xA735, "V"), - (0xA736, "M", "ꜷ"), - (0xA737, "V"), - (0xA738, "M", "ꜹ"), - (0xA739, "V"), - (0xA73A, "M", "ꜻ"), - (0xA73B, "V"), - (0xA73C, "M", "ꜽ"), - (0xA73D, "V"), - (0xA73E, "M", "ꜿ"), - (0xA73F, "V"), - (0xA740, "M", "ꝁ"), - (0xA741, "V"), - (0xA742, "M", "ꝃ"), - (0xA743, "V"), - (0xA744, "M", "ꝅ"), - (0xA745, "V"), - (0xA746, "M", "ꝇ"), - (0xA747, "V"), - (0xA748, "M", "ꝉ"), - (0xA749, "V"), - (0xA74A, "M", "ꝋ"), - (0xA74B, "V"), - (0xA74C, "M", "ꝍ"), - (0xA74D, "V"), - (0xA74E, "M", "ꝏ"), - (0xA74F, "V"), - (0xA750, "M", "ꝑ"), - (0xA751, "V"), - (0xA752, "M", "ꝓ"), - (0xA753, "V"), - (0xA754, "M", "ꝕ"), - (0xA755, "V"), - (0xA756, "M", "ꝗ"), - (0xA757, "V"), - ] - - -def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xA758, "M", "ꝙ"), - (0xA759, "V"), - (0xA75A, "M", "ꝛ"), - (0xA75B, "V"), - (0xA75C, "M", "ꝝ"), - (0xA75D, "V"), - (0xA75E, "M", "ꝟ"), - (0xA75F, "V"), - (0xA760, "M", "ꝡ"), - (0xA761, "V"), - (0xA762, "M", "ꝣ"), - (0xA763, "V"), - (0xA764, "M", "ꝥ"), - (0xA765, "V"), - (0xA766, "M", "ꝧ"), - (0xA767, "V"), - (0xA768, "M", "ꝩ"), - (0xA769, "V"), - (0xA76A, "M", "ꝫ"), - (0xA76B, "V"), - (0xA76C, "M", "ꝭ"), - (0xA76D, "V"), - (0xA76E, "M", "ꝯ"), - (0xA76F, "V"), - (0xA770, "M", "ꝯ"), - (0xA771, "V"), - (0xA779, "M", "ꝺ"), - (0xA77A, "V"), - (0xA77B, "M", "ꝼ"), - (0xA77C, "V"), - (0xA77D, "M", "ᵹ"), - (0xA77E, "M", "ꝿ"), - (0xA77F, "V"), - (0xA780, "M", "ꞁ"), - (0xA781, "V"), - (0xA782, "M", "ꞃ"), - (0xA783, "V"), - (0xA784, "M", "ꞅ"), - (0xA785, "V"), - (0xA786, "M", "ꞇ"), - (0xA787, "V"), - (0xA78B, "M", "ꞌ"), - (0xA78C, "V"), - (0xA78D, "M", "ɥ"), - (0xA78E, "V"), - (0xA790, "M", "ꞑ"), - (0xA791, "V"), - (0xA792, "M", "ꞓ"), - (0xA793, "V"), - (0xA796, "M", "ꞗ"), - (0xA797, "V"), - (0xA798, "M", "ꞙ"), - (0xA799, "V"), - (0xA79A, "M", "ꞛ"), - (0xA79B, "V"), - (0xA79C, "M", "ꞝ"), - (0xA79D, "V"), - (0xA79E, "M", "ꞟ"), - (0xA79F, "V"), - (0xA7A0, "M", "ꞡ"), - (0xA7A1, "V"), - (0xA7A2, "M", "ꞣ"), - (0xA7A3, "V"), - (0xA7A4, "M", "ꞥ"), - (0xA7A5, "V"), - (0xA7A6, "M", "ꞧ"), - (0xA7A7, "V"), - (0xA7A8, "M", "ꞩ"), - (0xA7A9, "V"), - (0xA7AA, "M", "ɦ"), - (0xA7AB, "M", "ɜ"), - (0xA7AC, "M", "ɡ"), - (0xA7AD, "M", "ɬ"), - (0xA7AE, "M", "ɪ"), - (0xA7AF, "V"), - (0xA7B0, "M", "ʞ"), - (0xA7B1, "M", "ʇ"), - (0xA7B2, "M", "ʝ"), - (0xA7B3, "M", "ꭓ"), - (0xA7B4, "M", "ꞵ"), - (0xA7B5, "V"), - (0xA7B6, "M", "ꞷ"), - (0xA7B7, "V"), - (0xA7B8, "M", "ꞹ"), - (0xA7B9, "V"), - (0xA7BA, "M", "ꞻ"), - (0xA7BB, "V"), - (0xA7BC, "M", "ꞽ"), - (0xA7BD, "V"), - (0xA7BE, "M", "ꞿ"), - (0xA7BF, "V"), - (0xA7C0, "M", "ꟁ"), - (0xA7C1, "V"), - (0xA7C2, "M", "ꟃ"), - (0xA7C3, "V"), - (0xA7C4, "M", "ꞔ"), - (0xA7C5, "M", "ʂ"), - (0xA7C6, "M", "ᶎ"), - (0xA7C7, "M", "ꟈ"), - (0xA7C8, "V"), - ] - - -def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xA7C9, "M", "ꟊ"), - (0xA7CA, "V"), - (0xA7CB, "M", "ɤ"), - (0xA7CC, "M", "ꟍ"), - (0xA7CD, "V"), - (0xA7CE, "X"), - (0xA7D0, "M", "ꟑ"), - (0xA7D1, "V"), - (0xA7D2, "X"), - (0xA7D3, "V"), - (0xA7D4, "X"), - (0xA7D5, "V"), - (0xA7D6, "M", "ꟗ"), - (0xA7D7, "V"), - (0xA7D8, "M", "ꟙ"), - (0xA7D9, "V"), - (0xA7DA, "M", "ꟛ"), - (0xA7DB, "V"), - (0xA7DC, "M", "ƛ"), - (0xA7DD, "X"), - (0xA7F2, "M", "c"), - (0xA7F3, "M", "f"), - (0xA7F4, "M", "q"), - (0xA7F5, "M", "ꟶ"), - (0xA7F6, "V"), - (0xA7F8, "M", "ħ"), - (0xA7F9, "M", "œ"), - (0xA7FA, "V"), - (0xA82D, "X"), - (0xA830, "V"), - (0xA83A, "X"), - (0xA840, "V"), - (0xA878, "X"), - (0xA880, "V"), - (0xA8C6, "X"), - (0xA8CE, "V"), - (0xA8DA, "X"), - (0xA8E0, "V"), - (0xA954, "X"), - (0xA95F, "V"), - (0xA97D, "X"), - (0xA980, "V"), - (0xA9CE, "X"), - (0xA9CF, "V"), - (0xA9DA, "X"), - (0xA9DE, "V"), - (0xA9FF, "X"), - (0xAA00, "V"), - (0xAA37, "X"), - (0xAA40, "V"), - (0xAA4E, "X"), - (0xAA50, "V"), - (0xAA5A, "X"), - (0xAA5C, "V"), - (0xAAC3, "X"), - (0xAADB, "V"), - (0xAAF7, "X"), - (0xAB01, "V"), - (0xAB07, "X"), - (0xAB09, "V"), - (0xAB0F, "X"), - (0xAB11, "V"), - (0xAB17, "X"), - (0xAB20, "V"), - (0xAB27, "X"), - (0xAB28, "V"), - (0xAB2F, "X"), - (0xAB30, "V"), - (0xAB5C, "M", "ꜧ"), - (0xAB5D, "M", "ꬷ"), - (0xAB5E, "M", "ɫ"), - (0xAB5F, "M", "ꭒ"), - (0xAB60, "V"), - (0xAB69, "M", "ʍ"), - (0xAB6A, "V"), - (0xAB6C, "X"), - (0xAB70, "M", "Ꭰ"), - (0xAB71, "M", "Ꭱ"), - (0xAB72, "M", "Ꭲ"), - (0xAB73, "M", "Ꭳ"), - (0xAB74, "M", "Ꭴ"), - (0xAB75, "M", "Ꭵ"), - (0xAB76, "M", "Ꭶ"), - (0xAB77, "M", "Ꭷ"), - (0xAB78, "M", "Ꭸ"), - (0xAB79, "M", "Ꭹ"), - (0xAB7A, "M", "Ꭺ"), - (0xAB7B, "M", "Ꭻ"), - (0xAB7C, "M", "Ꭼ"), - (0xAB7D, "M", "Ꭽ"), - (0xAB7E, "M", "Ꭾ"), - (0xAB7F, "M", "Ꭿ"), - (0xAB80, "M", "Ꮀ"), - (0xAB81, "M", "Ꮁ"), - (0xAB82, "M", "Ꮂ"), - (0xAB83, "M", "Ꮃ"), - (0xAB84, "M", "Ꮄ"), - (0xAB85, "M", "Ꮅ"), - (0xAB86, "M", "Ꮆ"), - (0xAB87, "M", "Ꮇ"), - ] - - -def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xAB88, "M", "Ꮈ"), - (0xAB89, "M", "Ꮉ"), - (0xAB8A, "M", "Ꮊ"), - (0xAB8B, "M", "Ꮋ"), - (0xAB8C, "M", "Ꮌ"), - (0xAB8D, "M", "Ꮍ"), - (0xAB8E, "M", "Ꮎ"), - (0xAB8F, "M", "Ꮏ"), - (0xAB90, "M", "Ꮐ"), - (0xAB91, "M", "Ꮑ"), - (0xAB92, "M", "Ꮒ"), - (0xAB93, "M", "Ꮓ"), - (0xAB94, "M", "Ꮔ"), - (0xAB95, "M", "Ꮕ"), - (0xAB96, "M", "Ꮖ"), - (0xAB97, "M", "Ꮗ"), - (0xAB98, "M", "Ꮘ"), - (0xAB99, "M", "Ꮙ"), - (0xAB9A, "M", "Ꮚ"), - (0xAB9B, "M", "Ꮛ"), - (0xAB9C, "M", "Ꮜ"), - (0xAB9D, "M", "Ꮝ"), - (0xAB9E, "M", "Ꮞ"), - (0xAB9F, "M", "Ꮟ"), - (0xABA0, "M", "Ꮠ"), - (0xABA1, "M", "Ꮡ"), - (0xABA2, "M", "Ꮢ"), - (0xABA3, "M", "Ꮣ"), - (0xABA4, "M", "Ꮤ"), - (0xABA5, "M", "Ꮥ"), - (0xABA6, "M", "Ꮦ"), - (0xABA7, "M", "Ꮧ"), - (0xABA8, "M", "Ꮨ"), - (0xABA9, "M", "Ꮩ"), - (0xABAA, "M", "Ꮪ"), - (0xABAB, "M", "Ꮫ"), - (0xABAC, "M", "Ꮬ"), - (0xABAD, "M", "Ꮭ"), - (0xABAE, "M", "Ꮮ"), - (0xABAF, "M", "Ꮯ"), - (0xABB0, "M", "Ꮰ"), - (0xABB1, "M", "Ꮱ"), - (0xABB2, "M", "Ꮲ"), - (0xABB3, "M", "Ꮳ"), - (0xABB4, "M", "Ꮴ"), - (0xABB5, "M", "Ꮵ"), - (0xABB6, "M", "Ꮶ"), - (0xABB7, "M", "Ꮷ"), - (0xABB8, "M", "Ꮸ"), - (0xABB9, "M", "Ꮹ"), - (0xABBA, "M", "Ꮺ"), - (0xABBB, "M", "Ꮻ"), - (0xABBC, "M", "Ꮼ"), - (0xABBD, "M", "Ꮽ"), - (0xABBE, "M", "Ꮾ"), - (0xABBF, "M", "Ꮿ"), - (0xABC0, "V"), - (0xABEE, "X"), - (0xABF0, "V"), - (0xABFA, "X"), - (0xAC00, "V"), - (0xD7A4, "X"), - (0xD7B0, "V"), - (0xD7C7, "X"), - (0xD7CB, "V"), - (0xD7FC, "X"), - (0xF900, "M", "豈"), - (0xF901, "M", "更"), - (0xF902, "M", "車"), - (0xF903, "M", "賈"), - (0xF904, "M", "滑"), - (0xF905, "M", "串"), - (0xF906, "M", "句"), - (0xF907, "M", "龜"), - (0xF909, "M", "契"), - (0xF90A, "M", "金"), - (0xF90B, "M", "喇"), - (0xF90C, "M", "奈"), - (0xF90D, "M", "懶"), - (0xF90E, "M", "癩"), - (0xF90F, "M", "羅"), - (0xF910, "M", "蘿"), - (0xF911, "M", "螺"), - (0xF912, "M", "裸"), - (0xF913, "M", "邏"), - (0xF914, "M", "樂"), - (0xF915, "M", "洛"), - (0xF916, "M", "烙"), - (0xF917, "M", "珞"), - (0xF918, "M", "落"), - (0xF919, "M", "酪"), - (0xF91A, "M", "駱"), - (0xF91B, "M", "亂"), - (0xF91C, "M", "卵"), - (0xF91D, "M", "欄"), - (0xF91E, "M", "爛"), - (0xF91F, "M", "蘭"), - (0xF920, "M", "鸞"), - (0xF921, "M", "嵐"), - (0xF922, "M", "濫"), - ] - - -def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xF923, "M", "藍"), - (0xF924, "M", "襤"), - (0xF925, "M", "拉"), - (0xF926, "M", "臘"), - (0xF927, "M", "蠟"), - (0xF928, "M", "廊"), - (0xF929, "M", "朗"), - (0xF92A, "M", "浪"), - (0xF92B, "M", "狼"), - (0xF92C, "M", "郎"), - (0xF92D, "M", "來"), - (0xF92E, "M", "冷"), - (0xF92F, "M", "勞"), - (0xF930, "M", "擄"), - (0xF931, "M", "櫓"), - (0xF932, "M", "爐"), - (0xF933, "M", "盧"), - (0xF934, "M", "老"), - (0xF935, "M", "蘆"), - (0xF936, "M", "虜"), - (0xF937, "M", "路"), - (0xF938, "M", "露"), - (0xF939, "M", "魯"), - (0xF93A, "M", "鷺"), - (0xF93B, "M", "碌"), - (0xF93C, "M", "祿"), - (0xF93D, "M", "綠"), - (0xF93E, "M", "菉"), - (0xF93F, "M", "錄"), - (0xF940, "M", "鹿"), - (0xF941, "M", "論"), - (0xF942, "M", "壟"), - (0xF943, "M", "弄"), - (0xF944, "M", "籠"), - (0xF945, "M", "聾"), - (0xF946, "M", "牢"), - (0xF947, "M", "磊"), - (0xF948, "M", "賂"), - (0xF949, "M", "雷"), - (0xF94A, "M", "壘"), - (0xF94B, "M", "屢"), - (0xF94C, "M", "樓"), - (0xF94D, "M", "淚"), - (0xF94E, "M", "漏"), - (0xF94F, "M", "累"), - (0xF950, "M", "縷"), - (0xF951, "M", "陋"), - (0xF952, "M", "勒"), - (0xF953, "M", "肋"), - (0xF954, "M", "凜"), - (0xF955, "M", "凌"), - (0xF956, "M", "稜"), - (0xF957, "M", "綾"), - (0xF958, "M", "菱"), - (0xF959, "M", "陵"), - (0xF95A, "M", "讀"), - (0xF95B, "M", "拏"), - (0xF95C, "M", "樂"), - (0xF95D, "M", "諾"), - (0xF95E, "M", "丹"), - (0xF95F, "M", "寧"), - (0xF960, "M", "怒"), - (0xF961, "M", "率"), - (0xF962, "M", "異"), - (0xF963, "M", "北"), - (0xF964, "M", "磻"), - (0xF965, "M", "便"), - (0xF966, "M", "復"), - (0xF967, "M", "不"), - (0xF968, "M", "泌"), - (0xF969, "M", "數"), - (0xF96A, "M", "索"), - (0xF96B, "M", "參"), - (0xF96C, "M", "塞"), - (0xF96D, "M", "省"), - (0xF96E, "M", "葉"), - (0xF96F, "M", "說"), - (0xF970, "M", "殺"), - (0xF971, "M", "辰"), - (0xF972, "M", "沈"), - (0xF973, "M", "拾"), - (0xF974, "M", "若"), - (0xF975, "M", "掠"), - (0xF976, "M", "略"), - (0xF977, "M", "亮"), - (0xF978, "M", "兩"), - (0xF979, "M", "凉"), - (0xF97A, "M", "梁"), - (0xF97B, "M", "糧"), - (0xF97C, "M", "良"), - (0xF97D, "M", "諒"), - (0xF97E, "M", "量"), - (0xF97F, "M", "勵"), - (0xF980, "M", "呂"), - (0xF981, "M", "女"), - (0xF982, "M", "廬"), - (0xF983, "M", "旅"), - (0xF984, "M", "濾"), - (0xF985, "M", "礪"), - (0xF986, "M", "閭"), - ] - - -def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xF987, "M", "驪"), - (0xF988, "M", "麗"), - (0xF989, "M", "黎"), - (0xF98A, "M", "力"), - (0xF98B, "M", "曆"), - (0xF98C, "M", "歷"), - (0xF98D, "M", "轢"), - (0xF98E, "M", "年"), - (0xF98F, "M", "憐"), - (0xF990, "M", "戀"), - (0xF991, "M", "撚"), - (0xF992, "M", "漣"), - (0xF993, "M", "煉"), - (0xF994, "M", "璉"), - (0xF995, "M", "秊"), - (0xF996, "M", "練"), - (0xF997, "M", "聯"), - (0xF998, "M", "輦"), - (0xF999, "M", "蓮"), - (0xF99A, "M", "連"), - (0xF99B, "M", "鍊"), - (0xF99C, "M", "列"), - (0xF99D, "M", "劣"), - (0xF99E, "M", "咽"), - (0xF99F, "M", "烈"), - (0xF9A0, "M", "裂"), - (0xF9A1, "M", "說"), - (0xF9A2, "M", "廉"), - (0xF9A3, "M", "念"), - (0xF9A4, "M", "捻"), - (0xF9A5, "M", "殮"), - (0xF9A6, "M", "簾"), - (0xF9A7, "M", "獵"), - (0xF9A8, "M", "令"), - (0xF9A9, "M", "囹"), - (0xF9AA, "M", "寧"), - (0xF9AB, "M", "嶺"), - (0xF9AC, "M", "怜"), - (0xF9AD, "M", "玲"), - (0xF9AE, "M", "瑩"), - (0xF9AF, "M", "羚"), - (0xF9B0, "M", "聆"), - (0xF9B1, "M", "鈴"), - (0xF9B2, "M", "零"), - (0xF9B3, "M", "靈"), - (0xF9B4, "M", "領"), - (0xF9B5, "M", "例"), - (0xF9B6, "M", "禮"), - (0xF9B7, "M", "醴"), - (0xF9B8, "M", "隸"), - (0xF9B9, "M", "惡"), - (0xF9BA, "M", "了"), - (0xF9BB, "M", "僚"), - (0xF9BC, "M", "寮"), - (0xF9BD, "M", "尿"), - (0xF9BE, "M", "料"), - (0xF9BF, "M", "樂"), - (0xF9C0, "M", "燎"), - (0xF9C1, "M", "療"), - (0xF9C2, "M", "蓼"), - (0xF9C3, "M", "遼"), - (0xF9C4, "M", "龍"), - (0xF9C5, "M", "暈"), - (0xF9C6, "M", "阮"), - (0xF9C7, "M", "劉"), - (0xF9C8, "M", "杻"), - (0xF9C9, "M", "柳"), - (0xF9CA, "M", "流"), - (0xF9CB, "M", "溜"), - (0xF9CC, "M", "琉"), - (0xF9CD, "M", "留"), - (0xF9CE, "M", "硫"), - (0xF9CF, "M", "紐"), - (0xF9D0, "M", "類"), - (0xF9D1, "M", "六"), - (0xF9D2, "M", "戮"), - (0xF9D3, "M", "陸"), - (0xF9D4, "M", "倫"), - (0xF9D5, "M", "崙"), - (0xF9D6, "M", "淪"), - (0xF9D7, "M", "輪"), - (0xF9D8, "M", "律"), - (0xF9D9, "M", "慄"), - (0xF9DA, "M", "栗"), - (0xF9DB, "M", "率"), - (0xF9DC, "M", "隆"), - (0xF9DD, "M", "利"), - (0xF9DE, "M", "吏"), - (0xF9DF, "M", "履"), - (0xF9E0, "M", "易"), - (0xF9E1, "M", "李"), - (0xF9E2, "M", "梨"), - (0xF9E3, "M", "泥"), - (0xF9E4, "M", "理"), - (0xF9E5, "M", "痢"), - (0xF9E6, "M", "罹"), - (0xF9E7, "M", "裏"), - (0xF9E8, "M", "裡"), - (0xF9E9, "M", "里"), - (0xF9EA, "M", "離"), - ] - - -def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xF9EB, "M", "匿"), - (0xF9EC, "M", "溺"), - (0xF9ED, "M", "吝"), - (0xF9EE, "M", "燐"), - (0xF9EF, "M", "璘"), - (0xF9F0, "M", "藺"), - (0xF9F1, "M", "隣"), - (0xF9F2, "M", "鱗"), - (0xF9F3, "M", "麟"), - (0xF9F4, "M", "林"), - (0xF9F5, "M", "淋"), - (0xF9F6, "M", "臨"), - (0xF9F7, "M", "立"), - (0xF9F8, "M", "笠"), - (0xF9F9, "M", "粒"), - (0xF9FA, "M", "狀"), - (0xF9FB, "M", "炙"), - (0xF9FC, "M", "識"), - (0xF9FD, "M", "什"), - (0xF9FE, "M", "茶"), - (0xF9FF, "M", "刺"), - (0xFA00, "M", "切"), - (0xFA01, "M", "度"), - (0xFA02, "M", "拓"), - (0xFA03, "M", "糖"), - (0xFA04, "M", "宅"), - (0xFA05, "M", "洞"), - (0xFA06, "M", "暴"), - (0xFA07, "M", "輻"), - (0xFA08, "M", "行"), - (0xFA09, "M", "降"), - (0xFA0A, "M", "見"), - (0xFA0B, "M", "廓"), - (0xFA0C, "M", "兀"), - (0xFA0D, "M", "嗀"), - (0xFA0E, "V"), - (0xFA10, "M", "塚"), - (0xFA11, "V"), - (0xFA12, "M", "晴"), - (0xFA13, "V"), - (0xFA15, "M", "凞"), - (0xFA16, "M", "猪"), - (0xFA17, "M", "益"), - (0xFA18, "M", "礼"), - (0xFA19, "M", "神"), - (0xFA1A, "M", "祥"), - (0xFA1B, "M", "福"), - (0xFA1C, "M", "靖"), - (0xFA1D, "M", "精"), - (0xFA1E, "M", "羽"), - (0xFA1F, "V"), - (0xFA20, "M", "蘒"), - (0xFA21, "V"), - (0xFA22, "M", "諸"), - (0xFA23, "V"), - (0xFA25, "M", "逸"), - (0xFA26, "M", "都"), - (0xFA27, "V"), - (0xFA2A, "M", "飯"), - (0xFA2B, "M", "飼"), - (0xFA2C, "M", "館"), - (0xFA2D, "M", "鶴"), - (0xFA2E, "M", "郞"), - (0xFA2F, "M", "隷"), - (0xFA30, "M", "侮"), - (0xFA31, "M", "僧"), - (0xFA32, "M", "免"), - (0xFA33, "M", "勉"), - (0xFA34, "M", "勤"), - (0xFA35, "M", "卑"), - (0xFA36, "M", "喝"), - (0xFA37, "M", "嘆"), - (0xFA38, "M", "器"), - (0xFA39, "M", "塀"), - (0xFA3A, "M", "墨"), - (0xFA3B, "M", "層"), - (0xFA3C, "M", "屮"), - (0xFA3D, "M", "悔"), - (0xFA3E, "M", "慨"), - (0xFA3F, "M", "憎"), - (0xFA40, "M", "懲"), - (0xFA41, "M", "敏"), - (0xFA42, "M", "既"), - (0xFA43, "M", "暑"), - (0xFA44, "M", "梅"), - (0xFA45, "M", "海"), - (0xFA46, "M", "渚"), - (0xFA47, "M", "漢"), - (0xFA48, "M", "煮"), - (0xFA49, "M", "爫"), - (0xFA4A, "M", "琢"), - (0xFA4B, "M", "碑"), - (0xFA4C, "M", "社"), - (0xFA4D, "M", "祉"), - (0xFA4E, "M", "祈"), - (0xFA4F, "M", "祐"), - (0xFA50, "M", "祖"), - (0xFA51, "M", "祝"), - (0xFA52, "M", "禍"), - (0xFA53, "M", "禎"), - ] - - -def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFA54, "M", "穀"), - (0xFA55, "M", "突"), - (0xFA56, "M", "節"), - (0xFA57, "M", "練"), - (0xFA58, "M", "縉"), - (0xFA59, "M", "繁"), - (0xFA5A, "M", "署"), - (0xFA5B, "M", "者"), - (0xFA5C, "M", "臭"), - (0xFA5D, "M", "艹"), - (0xFA5F, "M", "著"), - (0xFA60, "M", "褐"), - (0xFA61, "M", "視"), - (0xFA62, "M", "謁"), - (0xFA63, "M", "謹"), - (0xFA64, "M", "賓"), - (0xFA65, "M", "贈"), - (0xFA66, "M", "辶"), - (0xFA67, "M", "逸"), - (0xFA68, "M", "難"), - (0xFA69, "M", "響"), - (0xFA6A, "M", "頻"), - (0xFA6B, "M", "恵"), - (0xFA6C, "M", "𤋮"), - (0xFA6D, "M", "舘"), - (0xFA6E, "X"), - (0xFA70, "M", "並"), - (0xFA71, "M", "况"), - (0xFA72, "M", "全"), - (0xFA73, "M", "侀"), - (0xFA74, "M", "充"), - (0xFA75, "M", "冀"), - (0xFA76, "M", "勇"), - (0xFA77, "M", "勺"), - (0xFA78, "M", "喝"), - (0xFA79, "M", "啕"), - (0xFA7A, "M", "喙"), - (0xFA7B, "M", "嗢"), - (0xFA7C, "M", "塚"), - (0xFA7D, "M", "墳"), - (0xFA7E, "M", "奄"), - (0xFA7F, "M", "奔"), - (0xFA80, "M", "婢"), - (0xFA81, "M", "嬨"), - (0xFA82, "M", "廒"), - (0xFA83, "M", "廙"), - (0xFA84, "M", "彩"), - (0xFA85, "M", "徭"), - (0xFA86, "M", "惘"), - (0xFA87, "M", "慎"), - (0xFA88, "M", "愈"), - (0xFA89, "M", "憎"), - (0xFA8A, "M", "慠"), - (0xFA8B, "M", "懲"), - (0xFA8C, "M", "戴"), - (0xFA8D, "M", "揄"), - (0xFA8E, "M", "搜"), - (0xFA8F, "M", "摒"), - (0xFA90, "M", "敖"), - (0xFA91, "M", "晴"), - (0xFA92, "M", "朗"), - (0xFA93, "M", "望"), - (0xFA94, "M", "杖"), - (0xFA95, "M", "歹"), - (0xFA96, "M", "殺"), - (0xFA97, "M", "流"), - (0xFA98, "M", "滛"), - (0xFA99, "M", "滋"), - (0xFA9A, "M", "漢"), - (0xFA9B, "M", "瀞"), - (0xFA9C, "M", "煮"), - (0xFA9D, "M", "瞧"), - (0xFA9E, "M", "爵"), - (0xFA9F, "M", "犯"), - (0xFAA0, "M", "猪"), - (0xFAA1, "M", "瑱"), - (0xFAA2, "M", "甆"), - (0xFAA3, "M", "画"), - (0xFAA4, "M", "瘝"), - (0xFAA5, "M", "瘟"), - (0xFAA6, "M", "益"), - (0xFAA7, "M", "盛"), - (0xFAA8, "M", "直"), - (0xFAA9, "M", "睊"), - (0xFAAA, "M", "着"), - (0xFAAB, "M", "磌"), - (0xFAAC, "M", "窱"), - (0xFAAD, "M", "節"), - (0xFAAE, "M", "类"), - (0xFAAF, "M", "絛"), - (0xFAB0, "M", "練"), - (0xFAB1, "M", "缾"), - (0xFAB2, "M", "者"), - (0xFAB3, "M", "荒"), - (0xFAB4, "M", "華"), - (0xFAB5, "M", "蝹"), - (0xFAB6, "M", "襁"), - (0xFAB7, "M", "覆"), - (0xFAB8, "M", "視"), - (0xFAB9, "M", "調"), - ] - - -def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFABA, "M", "諸"), - (0xFABB, "M", "請"), - (0xFABC, "M", "謁"), - (0xFABD, "M", "諾"), - (0xFABE, "M", "諭"), - (0xFABF, "M", "謹"), - (0xFAC0, "M", "變"), - (0xFAC1, "M", "贈"), - (0xFAC2, "M", "輸"), - (0xFAC3, "M", "遲"), - (0xFAC4, "M", "醙"), - (0xFAC5, "M", "鉶"), - (0xFAC6, "M", "陼"), - (0xFAC7, "M", "難"), - (0xFAC8, "M", "靖"), - (0xFAC9, "M", "韛"), - (0xFACA, "M", "響"), - (0xFACB, "M", "頋"), - (0xFACC, "M", "頻"), - (0xFACD, "M", "鬒"), - (0xFACE, "M", "龜"), - (0xFACF, "M", "𢡊"), - (0xFAD0, "M", "𢡄"), - (0xFAD1, "M", "𣏕"), - (0xFAD2, "M", "㮝"), - (0xFAD3, "M", "䀘"), - (0xFAD4, "M", "䀹"), - (0xFAD5, "M", "𥉉"), - (0xFAD6, "M", "𥳐"), - (0xFAD7, "M", "𧻓"), - (0xFAD8, "M", "齃"), - (0xFAD9, "M", "龎"), - (0xFADA, "X"), - (0xFB00, "M", "ff"), - (0xFB01, "M", "fi"), - (0xFB02, "M", "fl"), - (0xFB03, "M", "ffi"), - (0xFB04, "M", "ffl"), - (0xFB05, "M", "st"), - (0xFB07, "X"), - (0xFB13, "M", "մն"), - (0xFB14, "M", "մե"), - (0xFB15, "M", "մի"), - (0xFB16, "M", "վն"), - (0xFB17, "M", "մխ"), - (0xFB18, "X"), - (0xFB1D, "M", "יִ"), - (0xFB1E, "V"), - (0xFB1F, "M", "ײַ"), - (0xFB20, "M", "ע"), - (0xFB21, "M", "א"), - (0xFB22, "M", "ד"), - (0xFB23, "M", "ה"), - (0xFB24, "M", "כ"), - (0xFB25, "M", "ל"), - (0xFB26, "M", "ם"), - (0xFB27, "M", "ר"), - (0xFB28, "M", "ת"), - (0xFB29, "M", "+"), - (0xFB2A, "M", "שׁ"), - (0xFB2B, "M", "שׂ"), - (0xFB2C, "M", "שּׁ"), - (0xFB2D, "M", "שּׂ"), - (0xFB2E, "M", "אַ"), - (0xFB2F, "M", "אָ"), - (0xFB30, "M", "אּ"), - (0xFB31, "M", "בּ"), - (0xFB32, "M", "גּ"), - (0xFB33, "M", "דּ"), - (0xFB34, "M", "הּ"), - (0xFB35, "M", "וּ"), - (0xFB36, "M", "זּ"), - (0xFB37, "X"), - (0xFB38, "M", "טּ"), - (0xFB39, "M", "יּ"), - (0xFB3A, "M", "ךּ"), - (0xFB3B, "M", "כּ"), - (0xFB3C, "M", "לּ"), - (0xFB3D, "X"), - (0xFB3E, "M", "מּ"), - (0xFB3F, "X"), - (0xFB40, "M", "נּ"), - (0xFB41, "M", "סּ"), - (0xFB42, "X"), - (0xFB43, "M", "ףּ"), - (0xFB44, "M", "פּ"), - (0xFB45, "X"), - (0xFB46, "M", "צּ"), - (0xFB47, "M", "קּ"), - (0xFB48, "M", "רּ"), - (0xFB49, "M", "שּ"), - (0xFB4A, "M", "תּ"), - (0xFB4B, "M", "וֹ"), - (0xFB4C, "M", "בֿ"), - (0xFB4D, "M", "כֿ"), - (0xFB4E, "M", "פֿ"), - (0xFB4F, "M", "אל"), - (0xFB50, "M", "ٱ"), - (0xFB52, "M", "ٻ"), - (0xFB56, "M", "پ"), - ] - - -def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFB5A, "M", "ڀ"), - (0xFB5E, "M", "ٺ"), - (0xFB62, "M", "ٿ"), - (0xFB66, "M", "ٹ"), - (0xFB6A, "M", "ڤ"), - (0xFB6E, "M", "ڦ"), - (0xFB72, "M", "ڄ"), - (0xFB76, "M", "ڃ"), - (0xFB7A, "M", "چ"), - (0xFB7E, "M", "ڇ"), - (0xFB82, "M", "ڍ"), - (0xFB84, "M", "ڌ"), - (0xFB86, "M", "ڎ"), - (0xFB88, "M", "ڈ"), - (0xFB8A, "M", "ژ"), - (0xFB8C, "M", "ڑ"), - (0xFB8E, "M", "ک"), - (0xFB92, "M", "گ"), - (0xFB96, "M", "ڳ"), - (0xFB9A, "M", "ڱ"), - (0xFB9E, "M", "ں"), - (0xFBA0, "M", "ڻ"), - (0xFBA4, "M", "ۀ"), - (0xFBA6, "M", "ہ"), - (0xFBAA, "M", "ھ"), - (0xFBAE, "M", "ے"), - (0xFBB0, "M", "ۓ"), - (0xFBB2, "V"), - (0xFBC3, "X"), - (0xFBD3, "M", "ڭ"), - (0xFBD7, "M", "ۇ"), - (0xFBD9, "M", "ۆ"), - (0xFBDB, "M", "ۈ"), - (0xFBDD, "M", "ۇٴ"), - (0xFBDE, "M", "ۋ"), - (0xFBE0, "M", "ۅ"), - (0xFBE2, "M", "ۉ"), - (0xFBE4, "M", "ې"), - (0xFBE8, "M", "ى"), - (0xFBEA, "M", "ئا"), - (0xFBEC, "M", "ئە"), - (0xFBEE, "M", "ئو"), - (0xFBF0, "M", "ئۇ"), - (0xFBF2, "M", "ئۆ"), - (0xFBF4, "M", "ئۈ"), - (0xFBF6, "M", "ئې"), - (0xFBF9, "M", "ئى"), - (0xFBFC, "M", "ی"), - (0xFC00, "M", "ئج"), - (0xFC01, "M", "ئح"), - (0xFC02, "M", "ئم"), - (0xFC03, "M", "ئى"), - (0xFC04, "M", "ئي"), - (0xFC05, "M", "بج"), - (0xFC06, "M", "بح"), - (0xFC07, "M", "بخ"), - (0xFC08, "M", "بم"), - (0xFC09, "M", "بى"), - (0xFC0A, "M", "بي"), - (0xFC0B, "M", "تج"), - (0xFC0C, "M", "تح"), - (0xFC0D, "M", "تخ"), - (0xFC0E, "M", "تم"), - (0xFC0F, "M", "تى"), - (0xFC10, "M", "تي"), - (0xFC11, "M", "ثج"), - (0xFC12, "M", "ثم"), - (0xFC13, "M", "ثى"), - (0xFC14, "M", "ثي"), - (0xFC15, "M", "جح"), - (0xFC16, "M", "جم"), - (0xFC17, "M", "حج"), - (0xFC18, "M", "حم"), - (0xFC19, "M", "خج"), - (0xFC1A, "M", "خح"), - (0xFC1B, "M", "خم"), - (0xFC1C, "M", "سج"), - (0xFC1D, "M", "سح"), - (0xFC1E, "M", "سخ"), - (0xFC1F, "M", "سم"), - (0xFC20, "M", "صح"), - (0xFC21, "M", "صم"), - (0xFC22, "M", "ضج"), - (0xFC23, "M", "ضح"), - (0xFC24, "M", "ضخ"), - (0xFC25, "M", "ضم"), - (0xFC26, "M", "طح"), - (0xFC27, "M", "طم"), - (0xFC28, "M", "ظم"), - (0xFC29, "M", "عج"), - (0xFC2A, "M", "عم"), - (0xFC2B, "M", "غج"), - (0xFC2C, "M", "غم"), - (0xFC2D, "M", "فج"), - (0xFC2E, "M", "فح"), - (0xFC2F, "M", "فخ"), - (0xFC30, "M", "فم"), - (0xFC31, "M", "فى"), - (0xFC32, "M", "في"), - (0xFC33, "M", "قح"), - ] - - -def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFC34, "M", "قم"), - (0xFC35, "M", "قى"), - (0xFC36, "M", "قي"), - (0xFC37, "M", "كا"), - (0xFC38, "M", "كج"), - (0xFC39, "M", "كح"), - (0xFC3A, "M", "كخ"), - (0xFC3B, "M", "كل"), - (0xFC3C, "M", "كم"), - (0xFC3D, "M", "كى"), - (0xFC3E, "M", "كي"), - (0xFC3F, "M", "لج"), - (0xFC40, "M", "لح"), - (0xFC41, "M", "لخ"), - (0xFC42, "M", "لم"), - (0xFC43, "M", "لى"), - (0xFC44, "M", "لي"), - (0xFC45, "M", "مج"), - (0xFC46, "M", "مح"), - (0xFC47, "M", "مخ"), - (0xFC48, "M", "مم"), - (0xFC49, "M", "مى"), - (0xFC4A, "M", "مي"), - (0xFC4B, "M", "نج"), - (0xFC4C, "M", "نح"), - (0xFC4D, "M", "نخ"), - (0xFC4E, "M", "نم"), - (0xFC4F, "M", "نى"), - (0xFC50, "M", "ني"), - (0xFC51, "M", "هج"), - (0xFC52, "M", "هم"), - (0xFC53, "M", "هى"), - (0xFC54, "M", "هي"), - (0xFC55, "M", "يج"), - (0xFC56, "M", "يح"), - (0xFC57, "M", "يخ"), - (0xFC58, "M", "يم"), - (0xFC59, "M", "يى"), - (0xFC5A, "M", "يي"), - (0xFC5B, "M", "ذٰ"), - (0xFC5C, "M", "رٰ"), - (0xFC5D, "M", "ىٰ"), - (0xFC5E, "M", " ٌّ"), - (0xFC5F, "M", " ٍّ"), - (0xFC60, "M", " َّ"), - (0xFC61, "M", " ُّ"), - (0xFC62, "M", " ِّ"), - (0xFC63, "M", " ّٰ"), - (0xFC64, "M", "ئر"), - (0xFC65, "M", "ئز"), - (0xFC66, "M", "ئم"), - (0xFC67, "M", "ئن"), - (0xFC68, "M", "ئى"), - (0xFC69, "M", "ئي"), - (0xFC6A, "M", "بر"), - (0xFC6B, "M", "بز"), - (0xFC6C, "M", "بم"), - (0xFC6D, "M", "بن"), - (0xFC6E, "M", "بى"), - (0xFC6F, "M", "بي"), - (0xFC70, "M", "تر"), - (0xFC71, "M", "تز"), - (0xFC72, "M", "تم"), - (0xFC73, "M", "تن"), - (0xFC74, "M", "تى"), - (0xFC75, "M", "تي"), - (0xFC76, "M", "ثر"), - (0xFC77, "M", "ثز"), - (0xFC78, "M", "ثم"), - (0xFC79, "M", "ثن"), - (0xFC7A, "M", "ثى"), - (0xFC7B, "M", "ثي"), - (0xFC7C, "M", "فى"), - (0xFC7D, "M", "في"), - (0xFC7E, "M", "قى"), - (0xFC7F, "M", "قي"), - (0xFC80, "M", "كا"), - (0xFC81, "M", "كل"), - (0xFC82, "M", "كم"), - (0xFC83, "M", "كى"), - (0xFC84, "M", "كي"), - (0xFC85, "M", "لم"), - (0xFC86, "M", "لى"), - (0xFC87, "M", "لي"), - (0xFC88, "M", "ما"), - (0xFC89, "M", "مم"), - (0xFC8A, "M", "نر"), - (0xFC8B, "M", "نز"), - (0xFC8C, "M", "نم"), - (0xFC8D, "M", "نن"), - (0xFC8E, "M", "نى"), - (0xFC8F, "M", "ني"), - (0xFC90, "M", "ىٰ"), - (0xFC91, "M", "ير"), - (0xFC92, "M", "يز"), - (0xFC93, "M", "يم"), - (0xFC94, "M", "ين"), - (0xFC95, "M", "يى"), - (0xFC96, "M", "يي"), - (0xFC97, "M", "ئج"), - ] - - -def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFC98, "M", "ئح"), - (0xFC99, "M", "ئخ"), - (0xFC9A, "M", "ئم"), - (0xFC9B, "M", "ئه"), - (0xFC9C, "M", "بج"), - (0xFC9D, "M", "بح"), - (0xFC9E, "M", "بخ"), - (0xFC9F, "M", "بم"), - (0xFCA0, "M", "به"), - (0xFCA1, "M", "تج"), - (0xFCA2, "M", "تح"), - (0xFCA3, "M", "تخ"), - (0xFCA4, "M", "تم"), - (0xFCA5, "M", "ته"), - (0xFCA6, "M", "ثم"), - (0xFCA7, "M", "جح"), - (0xFCA8, "M", "جم"), - (0xFCA9, "M", "حج"), - (0xFCAA, "M", "حم"), - (0xFCAB, "M", "خج"), - (0xFCAC, "M", "خم"), - (0xFCAD, "M", "سج"), - (0xFCAE, "M", "سح"), - (0xFCAF, "M", "سخ"), - (0xFCB0, "M", "سم"), - (0xFCB1, "M", "صح"), - (0xFCB2, "M", "صخ"), - (0xFCB3, "M", "صم"), - (0xFCB4, "M", "ضج"), - (0xFCB5, "M", "ضح"), - (0xFCB6, "M", "ضخ"), - (0xFCB7, "M", "ضم"), - (0xFCB8, "M", "طح"), - (0xFCB9, "M", "ظم"), - (0xFCBA, "M", "عج"), - (0xFCBB, "M", "عم"), - (0xFCBC, "M", "غج"), - (0xFCBD, "M", "غم"), - (0xFCBE, "M", "فج"), - (0xFCBF, "M", "فح"), - (0xFCC0, "M", "فخ"), - (0xFCC1, "M", "فم"), - (0xFCC2, "M", "قح"), - (0xFCC3, "M", "قم"), - (0xFCC4, "M", "كج"), - (0xFCC5, "M", "كح"), - (0xFCC6, "M", "كخ"), - (0xFCC7, "M", "كل"), - (0xFCC8, "M", "كم"), - (0xFCC9, "M", "لج"), - (0xFCCA, "M", "لح"), - (0xFCCB, "M", "لخ"), - (0xFCCC, "M", "لم"), - (0xFCCD, "M", "له"), - (0xFCCE, "M", "مج"), - (0xFCCF, "M", "مح"), - (0xFCD0, "M", "مخ"), - (0xFCD1, "M", "مم"), - (0xFCD2, "M", "نج"), - (0xFCD3, "M", "نح"), - (0xFCD4, "M", "نخ"), - (0xFCD5, "M", "نم"), - (0xFCD6, "M", "نه"), - (0xFCD7, "M", "هج"), - (0xFCD8, "M", "هم"), - (0xFCD9, "M", "هٰ"), - (0xFCDA, "M", "يج"), - (0xFCDB, "M", "يح"), - (0xFCDC, "M", "يخ"), - (0xFCDD, "M", "يم"), - (0xFCDE, "M", "يه"), - (0xFCDF, "M", "ئم"), - (0xFCE0, "M", "ئه"), - (0xFCE1, "M", "بم"), - (0xFCE2, "M", "به"), - (0xFCE3, "M", "تم"), - (0xFCE4, "M", "ته"), - (0xFCE5, "M", "ثم"), - (0xFCE6, "M", "ثه"), - (0xFCE7, "M", "سم"), - (0xFCE8, "M", "سه"), - (0xFCE9, "M", "شم"), - (0xFCEA, "M", "شه"), - (0xFCEB, "M", "كل"), - (0xFCEC, "M", "كم"), - (0xFCED, "M", "لم"), - (0xFCEE, "M", "نم"), - (0xFCEF, "M", "نه"), - (0xFCF0, "M", "يم"), - (0xFCF1, "M", "يه"), - (0xFCF2, "M", "ـَّ"), - (0xFCF3, "M", "ـُّ"), - (0xFCF4, "M", "ـِّ"), - (0xFCF5, "M", "طى"), - (0xFCF6, "M", "طي"), - (0xFCF7, "M", "عى"), - (0xFCF8, "M", "عي"), - (0xFCF9, "M", "غى"), - (0xFCFA, "M", "غي"), - (0xFCFB, "M", "سى"), - ] - - -def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFCFC, "M", "سي"), - (0xFCFD, "M", "شى"), - (0xFCFE, "M", "شي"), - (0xFCFF, "M", "حى"), - (0xFD00, "M", "حي"), - (0xFD01, "M", "جى"), - (0xFD02, "M", "جي"), - (0xFD03, "M", "خى"), - (0xFD04, "M", "خي"), - (0xFD05, "M", "صى"), - (0xFD06, "M", "صي"), - (0xFD07, "M", "ضى"), - (0xFD08, "M", "ضي"), - (0xFD09, "M", "شج"), - (0xFD0A, "M", "شح"), - (0xFD0B, "M", "شخ"), - (0xFD0C, "M", "شم"), - (0xFD0D, "M", "شر"), - (0xFD0E, "M", "سر"), - (0xFD0F, "M", "صر"), - (0xFD10, "M", "ضر"), - (0xFD11, "M", "طى"), - (0xFD12, "M", "طي"), - (0xFD13, "M", "عى"), - (0xFD14, "M", "عي"), - (0xFD15, "M", "غى"), - (0xFD16, "M", "غي"), - (0xFD17, "M", "سى"), - (0xFD18, "M", "سي"), - (0xFD19, "M", "شى"), - (0xFD1A, "M", "شي"), - (0xFD1B, "M", "حى"), - (0xFD1C, "M", "حي"), - (0xFD1D, "M", "جى"), - (0xFD1E, "M", "جي"), - (0xFD1F, "M", "خى"), - (0xFD20, "M", "خي"), - (0xFD21, "M", "صى"), - (0xFD22, "M", "صي"), - (0xFD23, "M", "ضى"), - (0xFD24, "M", "ضي"), - (0xFD25, "M", "شج"), - (0xFD26, "M", "شح"), - (0xFD27, "M", "شخ"), - (0xFD28, "M", "شم"), - (0xFD29, "M", "شر"), - (0xFD2A, "M", "سر"), - (0xFD2B, "M", "صر"), - (0xFD2C, "M", "ضر"), - (0xFD2D, "M", "شج"), - (0xFD2E, "M", "شح"), - (0xFD2F, "M", "شخ"), - (0xFD30, "M", "شم"), - (0xFD31, "M", "سه"), - (0xFD32, "M", "شه"), - (0xFD33, "M", "طم"), - (0xFD34, "M", "سج"), - (0xFD35, "M", "سح"), - (0xFD36, "M", "سخ"), - (0xFD37, "M", "شج"), - (0xFD38, "M", "شح"), - (0xFD39, "M", "شخ"), - (0xFD3A, "M", "طم"), - (0xFD3B, "M", "ظم"), - (0xFD3C, "M", "اً"), - (0xFD3E, "V"), - (0xFD50, "M", "تجم"), - (0xFD51, "M", "تحج"), - (0xFD53, "M", "تحم"), - (0xFD54, "M", "تخم"), - (0xFD55, "M", "تمج"), - (0xFD56, "M", "تمح"), - (0xFD57, "M", "تمخ"), - (0xFD58, "M", "جمح"), - (0xFD5A, "M", "حمي"), - (0xFD5B, "M", "حمى"), - (0xFD5C, "M", "سحج"), - (0xFD5D, "M", "سجح"), - (0xFD5E, "M", "سجى"), - (0xFD5F, "M", "سمح"), - (0xFD61, "M", "سمج"), - (0xFD62, "M", "سمم"), - (0xFD64, "M", "صحح"), - (0xFD66, "M", "صمم"), - (0xFD67, "M", "شحم"), - (0xFD69, "M", "شجي"), - (0xFD6A, "M", "شمخ"), - (0xFD6C, "M", "شمم"), - (0xFD6E, "M", "ضحى"), - (0xFD6F, "M", "ضخم"), - (0xFD71, "M", "طمح"), - (0xFD73, "M", "طمم"), - (0xFD74, "M", "طمي"), - (0xFD75, "M", "عجم"), - (0xFD76, "M", "عمم"), - (0xFD78, "M", "عمى"), - (0xFD79, "M", "غمم"), - (0xFD7A, "M", "غمي"), - (0xFD7B, "M", "غمى"), - (0xFD7C, "M", "فخم"), - ] - - -def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFD7E, "M", "قمح"), - (0xFD7F, "M", "قمم"), - (0xFD80, "M", "لحم"), - (0xFD81, "M", "لحي"), - (0xFD82, "M", "لحى"), - (0xFD83, "M", "لجج"), - (0xFD85, "M", "لخم"), - (0xFD87, "M", "لمح"), - (0xFD89, "M", "محج"), - (0xFD8A, "M", "محم"), - (0xFD8B, "M", "محي"), - (0xFD8C, "M", "مجح"), - (0xFD8D, "M", "مجم"), - (0xFD8E, "M", "مخج"), - (0xFD8F, "M", "مخم"), - (0xFD90, "X"), - (0xFD92, "M", "مجخ"), - (0xFD93, "M", "همج"), - (0xFD94, "M", "همم"), - (0xFD95, "M", "نحم"), - (0xFD96, "M", "نحى"), - (0xFD97, "M", "نجم"), - (0xFD99, "M", "نجى"), - (0xFD9A, "M", "نمي"), - (0xFD9B, "M", "نمى"), - (0xFD9C, "M", "يمم"), - (0xFD9E, "M", "بخي"), - (0xFD9F, "M", "تجي"), - (0xFDA0, "M", "تجى"), - (0xFDA1, "M", "تخي"), - (0xFDA2, "M", "تخى"), - (0xFDA3, "M", "تمي"), - (0xFDA4, "M", "تمى"), - (0xFDA5, "M", "جمي"), - (0xFDA6, "M", "جحى"), - (0xFDA7, "M", "جمى"), - (0xFDA8, "M", "سخى"), - (0xFDA9, "M", "صحي"), - (0xFDAA, "M", "شحي"), - (0xFDAB, "M", "ضحي"), - (0xFDAC, "M", "لجي"), - (0xFDAD, "M", "لمي"), - (0xFDAE, "M", "يحي"), - (0xFDAF, "M", "يجي"), - (0xFDB0, "M", "يمي"), - (0xFDB1, "M", "ممي"), - (0xFDB2, "M", "قمي"), - (0xFDB3, "M", "نحي"), - (0xFDB4, "M", "قمح"), - (0xFDB5, "M", "لحم"), - (0xFDB6, "M", "عمي"), - (0xFDB7, "M", "كمي"), - (0xFDB8, "M", "نجح"), - (0xFDB9, "M", "مخي"), - (0xFDBA, "M", "لجم"), - (0xFDBB, "M", "كمم"), - (0xFDBC, "M", "لجم"), - (0xFDBD, "M", "نجح"), - (0xFDBE, "M", "جحي"), - (0xFDBF, "M", "حجي"), - (0xFDC0, "M", "مجي"), - (0xFDC1, "M", "فمي"), - (0xFDC2, "M", "بحي"), - (0xFDC3, "M", "كمم"), - (0xFDC4, "M", "عجم"), - (0xFDC5, "M", "صمم"), - (0xFDC6, "M", "سخي"), - (0xFDC7, "M", "نجي"), - (0xFDC8, "X"), - (0xFDCF, "V"), - (0xFDD0, "X"), - (0xFDF0, "M", "صلے"), - (0xFDF1, "M", "قلے"), - (0xFDF2, "M", "الله"), - (0xFDF3, "M", "اكبر"), - (0xFDF4, "M", "محمد"), - (0xFDF5, "M", "صلعم"), - (0xFDF6, "M", "رسول"), - (0xFDF7, "M", "عليه"), - (0xFDF8, "M", "وسلم"), - (0xFDF9, "M", "صلى"), - (0xFDFA, "M", "صلى الله عليه وسلم"), - (0xFDFB, "M", "جل جلاله"), - (0xFDFC, "M", "ریال"), - (0xFDFD, "V"), - (0xFE00, "I"), - (0xFE10, "M", ","), - (0xFE11, "M", "、"), - (0xFE12, "X"), - (0xFE13, "M", ":"), - (0xFE14, "M", ";"), - (0xFE15, "M", "!"), - (0xFE16, "M", "?"), - (0xFE17, "M", "〖"), - (0xFE18, "M", "〗"), - (0xFE19, "X"), - (0xFE20, "V"), - (0xFE30, "X"), - (0xFE31, "M", "—"), - (0xFE32, "M", "–"), - ] - - -def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFE33, "M", "_"), - (0xFE35, "M", "("), - (0xFE36, "M", ")"), - (0xFE37, "M", "{"), - (0xFE38, "M", "}"), - (0xFE39, "M", "〔"), - (0xFE3A, "M", "〕"), - (0xFE3B, "M", "【"), - (0xFE3C, "M", "】"), - (0xFE3D, "M", "《"), - (0xFE3E, "M", "》"), - (0xFE3F, "M", "〈"), - (0xFE40, "M", "〉"), - (0xFE41, "M", "「"), - (0xFE42, "M", "」"), - (0xFE43, "M", "『"), - (0xFE44, "M", "』"), - (0xFE45, "V"), - (0xFE47, "M", "["), - (0xFE48, "M", "]"), - (0xFE49, "M", " ̅"), - (0xFE4D, "M", "_"), - (0xFE50, "M", ","), - (0xFE51, "M", "、"), - (0xFE52, "X"), - (0xFE54, "M", ";"), - (0xFE55, "M", ":"), - (0xFE56, "M", "?"), - (0xFE57, "M", "!"), - (0xFE58, "M", "—"), - (0xFE59, "M", "("), - (0xFE5A, "M", ")"), - (0xFE5B, "M", "{"), - (0xFE5C, "M", "}"), - (0xFE5D, "M", "〔"), - (0xFE5E, "M", "〕"), - (0xFE5F, "M", "#"), - (0xFE60, "M", "&"), - (0xFE61, "M", "*"), - (0xFE62, "M", "+"), - (0xFE63, "M", "-"), - (0xFE64, "M", "<"), - (0xFE65, "M", ">"), - (0xFE66, "M", "="), - (0xFE67, "X"), - (0xFE68, "M", "\\"), - (0xFE69, "M", "$"), - (0xFE6A, "M", "%"), - (0xFE6B, "M", "@"), - (0xFE6C, "X"), - (0xFE70, "M", " ً"), - (0xFE71, "M", "ـً"), - (0xFE72, "M", " ٌ"), - (0xFE73, "V"), - (0xFE74, "M", " ٍ"), - (0xFE75, "X"), - (0xFE76, "M", " َ"), - (0xFE77, "M", "ـَ"), - (0xFE78, "M", " ُ"), - (0xFE79, "M", "ـُ"), - (0xFE7A, "M", " ِ"), - (0xFE7B, "M", "ـِ"), - (0xFE7C, "M", " ّ"), - (0xFE7D, "M", "ـّ"), - (0xFE7E, "M", " ْ"), - (0xFE7F, "M", "ـْ"), - (0xFE80, "M", "ء"), - (0xFE81, "M", "آ"), - (0xFE83, "M", "أ"), - (0xFE85, "M", "ؤ"), - (0xFE87, "M", "إ"), - (0xFE89, "M", "ئ"), - (0xFE8D, "M", "ا"), - (0xFE8F, "M", "ب"), - (0xFE93, "M", "ة"), - (0xFE95, "M", "ت"), - (0xFE99, "M", "ث"), - (0xFE9D, "M", "ج"), - (0xFEA1, "M", "ح"), - (0xFEA5, "M", "خ"), - (0xFEA9, "M", "د"), - (0xFEAB, "M", "ذ"), - (0xFEAD, "M", "ر"), - (0xFEAF, "M", "ز"), - (0xFEB1, "M", "س"), - (0xFEB5, "M", "ش"), - (0xFEB9, "M", "ص"), - (0xFEBD, "M", "ض"), - (0xFEC1, "M", "ط"), - (0xFEC5, "M", "ظ"), - (0xFEC9, "M", "ع"), - (0xFECD, "M", "غ"), - (0xFED1, "M", "ف"), - (0xFED5, "M", "ق"), - (0xFED9, "M", "ك"), - (0xFEDD, "M", "ل"), - (0xFEE1, "M", "م"), - (0xFEE5, "M", "ن"), - (0xFEE9, "M", "ه"), - (0xFEED, "M", "و"), - ] - - -def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFEEF, "M", "ى"), - (0xFEF1, "M", "ي"), - (0xFEF5, "M", "لآ"), - (0xFEF7, "M", "لأ"), - (0xFEF9, "M", "لإ"), - (0xFEFB, "M", "لا"), - (0xFEFD, "X"), - (0xFEFF, "I"), - (0xFF00, "X"), - (0xFF01, "M", "!"), - (0xFF02, "M", '"'), - (0xFF03, "M", "#"), - (0xFF04, "M", "$"), - (0xFF05, "M", "%"), - (0xFF06, "M", "&"), - (0xFF07, "M", "'"), - (0xFF08, "M", "("), - (0xFF09, "M", ")"), - (0xFF0A, "M", "*"), - (0xFF0B, "M", "+"), - (0xFF0C, "M", ","), - (0xFF0D, "M", "-"), - (0xFF0E, "M", "."), - (0xFF0F, "M", "/"), - (0xFF10, "M", "0"), - (0xFF11, "M", "1"), - (0xFF12, "M", "2"), - (0xFF13, "M", "3"), - (0xFF14, "M", "4"), - (0xFF15, "M", "5"), - (0xFF16, "M", "6"), - (0xFF17, "M", "7"), - (0xFF18, "M", "8"), - (0xFF19, "M", "9"), - (0xFF1A, "M", ":"), - (0xFF1B, "M", ";"), - (0xFF1C, "M", "<"), - (0xFF1D, "M", "="), - (0xFF1E, "M", ">"), - (0xFF1F, "M", "?"), - (0xFF20, "M", "@"), - (0xFF21, "M", "a"), - (0xFF22, "M", "b"), - (0xFF23, "M", "c"), - (0xFF24, "M", "d"), - (0xFF25, "M", "e"), - (0xFF26, "M", "f"), - (0xFF27, "M", "g"), - (0xFF28, "M", "h"), - (0xFF29, "M", "i"), - (0xFF2A, "M", "j"), - (0xFF2B, "M", "k"), - (0xFF2C, "M", "l"), - (0xFF2D, "M", "m"), - (0xFF2E, "M", "n"), - (0xFF2F, "M", "o"), - (0xFF30, "M", "p"), - (0xFF31, "M", "q"), - (0xFF32, "M", "r"), - (0xFF33, "M", "s"), - (0xFF34, "M", "t"), - (0xFF35, "M", "u"), - (0xFF36, "M", "v"), - (0xFF37, "M", "w"), - (0xFF38, "M", "x"), - (0xFF39, "M", "y"), - (0xFF3A, "M", "z"), - (0xFF3B, "M", "["), - (0xFF3C, "M", "\\"), - (0xFF3D, "M", "]"), - (0xFF3E, "M", "^"), - (0xFF3F, "M", "_"), - (0xFF40, "M", "`"), - (0xFF41, "M", "a"), - (0xFF42, "M", "b"), - (0xFF43, "M", "c"), - (0xFF44, "M", "d"), - (0xFF45, "M", "e"), - (0xFF46, "M", "f"), - (0xFF47, "M", "g"), - (0xFF48, "M", "h"), - (0xFF49, "M", "i"), - (0xFF4A, "M", "j"), - (0xFF4B, "M", "k"), - (0xFF4C, "M", "l"), - (0xFF4D, "M", "m"), - (0xFF4E, "M", "n"), - (0xFF4F, "M", "o"), - (0xFF50, "M", "p"), - (0xFF51, "M", "q"), - (0xFF52, "M", "r"), - (0xFF53, "M", "s"), - (0xFF54, "M", "t"), - (0xFF55, "M", "u"), - (0xFF56, "M", "v"), - (0xFF57, "M", "w"), - (0xFF58, "M", "x"), - (0xFF59, "M", "y"), - (0xFF5A, "M", "z"), - (0xFF5B, "M", "{"), - ] - - -def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFF5C, "M", "|"), - (0xFF5D, "M", "}"), - (0xFF5E, "M", "~"), - (0xFF5F, "M", "⦅"), - (0xFF60, "M", "⦆"), - (0xFF61, "M", "."), - (0xFF62, "M", "「"), - (0xFF63, "M", "」"), - (0xFF64, "M", "、"), - (0xFF65, "M", "・"), - (0xFF66, "M", "ヲ"), - (0xFF67, "M", "ァ"), - (0xFF68, "M", "ィ"), - (0xFF69, "M", "ゥ"), - (0xFF6A, "M", "ェ"), - (0xFF6B, "M", "ォ"), - (0xFF6C, "M", "ャ"), - (0xFF6D, "M", "ュ"), - (0xFF6E, "M", "ョ"), - (0xFF6F, "M", "ッ"), - (0xFF70, "M", "ー"), - (0xFF71, "M", "ア"), - (0xFF72, "M", "イ"), - (0xFF73, "M", "ウ"), - (0xFF74, "M", "エ"), - (0xFF75, "M", "オ"), - (0xFF76, "M", "カ"), - (0xFF77, "M", "キ"), - (0xFF78, "M", "ク"), - (0xFF79, "M", "ケ"), - (0xFF7A, "M", "コ"), - (0xFF7B, "M", "サ"), - (0xFF7C, "M", "シ"), - (0xFF7D, "M", "ス"), - (0xFF7E, "M", "セ"), - (0xFF7F, "M", "ソ"), - (0xFF80, "M", "タ"), - (0xFF81, "M", "チ"), - (0xFF82, "M", "ツ"), - (0xFF83, "M", "テ"), - (0xFF84, "M", "ト"), - (0xFF85, "M", "ナ"), - (0xFF86, "M", "ニ"), - (0xFF87, "M", "ヌ"), - (0xFF88, "M", "ネ"), - (0xFF89, "M", "ノ"), - (0xFF8A, "M", "ハ"), - (0xFF8B, "M", "ヒ"), - (0xFF8C, "M", "フ"), - (0xFF8D, "M", "ヘ"), - (0xFF8E, "M", "ホ"), - (0xFF8F, "M", "マ"), - (0xFF90, "M", "ミ"), - (0xFF91, "M", "ム"), - (0xFF92, "M", "メ"), - (0xFF93, "M", "モ"), - (0xFF94, "M", "ヤ"), - (0xFF95, "M", "ユ"), - (0xFF96, "M", "ヨ"), - (0xFF97, "M", "ラ"), - (0xFF98, "M", "リ"), - (0xFF99, "M", "ル"), - (0xFF9A, "M", "レ"), - (0xFF9B, "M", "ロ"), - (0xFF9C, "M", "ワ"), - (0xFF9D, "M", "ン"), - (0xFF9E, "M", "゙"), - (0xFF9F, "M", "゚"), - (0xFFA0, "I"), - (0xFFA1, "M", "ᄀ"), - (0xFFA2, "M", "ᄁ"), - (0xFFA3, "M", "ᆪ"), - (0xFFA4, "M", "ᄂ"), - (0xFFA5, "M", "ᆬ"), - (0xFFA6, "M", "ᆭ"), - (0xFFA7, "M", "ᄃ"), - (0xFFA8, "M", "ᄄ"), - (0xFFA9, "M", "ᄅ"), - (0xFFAA, "M", "ᆰ"), - (0xFFAB, "M", "ᆱ"), - (0xFFAC, "M", "ᆲ"), - (0xFFAD, "M", "ᆳ"), - (0xFFAE, "M", "ᆴ"), - (0xFFAF, "M", "ᆵ"), - (0xFFB0, "M", "ᄚ"), - (0xFFB1, "M", "ᄆ"), - (0xFFB2, "M", "ᄇ"), - (0xFFB3, "M", "ᄈ"), - (0xFFB4, "M", "ᄡ"), - (0xFFB5, "M", "ᄉ"), - (0xFFB6, "M", "ᄊ"), - (0xFFB7, "M", "ᄋ"), - (0xFFB8, "M", "ᄌ"), - (0xFFB9, "M", "ᄍ"), - (0xFFBA, "M", "ᄎ"), - (0xFFBB, "M", "ᄏ"), - (0xFFBC, "M", "ᄐ"), - (0xFFBD, "M", "ᄑ"), - (0xFFBE, "M", "ᄒ"), - (0xFFBF, "X"), - ] - - -def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0xFFC2, "M", "ᅡ"), - (0xFFC3, "M", "ᅢ"), - (0xFFC4, "M", "ᅣ"), - (0xFFC5, "M", "ᅤ"), - (0xFFC6, "M", "ᅥ"), - (0xFFC7, "M", "ᅦ"), - (0xFFC8, "X"), - (0xFFCA, "M", "ᅧ"), - (0xFFCB, "M", "ᅨ"), - (0xFFCC, "M", "ᅩ"), - (0xFFCD, "M", "ᅪ"), - (0xFFCE, "M", "ᅫ"), - (0xFFCF, "M", "ᅬ"), - (0xFFD0, "X"), - (0xFFD2, "M", "ᅭ"), - (0xFFD3, "M", "ᅮ"), - (0xFFD4, "M", "ᅯ"), - (0xFFD5, "M", "ᅰ"), - (0xFFD6, "M", "ᅱ"), - (0xFFD7, "M", "ᅲ"), - (0xFFD8, "X"), - (0xFFDA, "M", "ᅳ"), - (0xFFDB, "M", "ᅴ"), - (0xFFDC, "M", "ᅵ"), - (0xFFDD, "X"), - (0xFFE0, "M", "¢"), - (0xFFE1, "M", "£"), - (0xFFE2, "M", "¬"), - (0xFFE3, "M", " ̄"), - (0xFFE4, "M", "¦"), - (0xFFE5, "M", "¥"), - (0xFFE6, "M", "₩"), - (0xFFE7, "X"), - (0xFFE8, "M", "│"), - (0xFFE9, "M", "←"), - (0xFFEA, "M", "↑"), - (0xFFEB, "M", "→"), - (0xFFEC, "M", "↓"), - (0xFFED, "M", "■"), - (0xFFEE, "M", "○"), - (0xFFEF, "X"), - (0x10000, "V"), - (0x1000C, "X"), - (0x1000D, "V"), - (0x10027, "X"), - (0x10028, "V"), - (0x1003B, "X"), - (0x1003C, "V"), - (0x1003E, "X"), - (0x1003F, "V"), - (0x1004E, "X"), - (0x10050, "V"), - (0x1005E, "X"), - (0x10080, "V"), - (0x100FB, "X"), - (0x10100, "V"), - (0x10103, "X"), - (0x10107, "V"), - (0x10134, "X"), - (0x10137, "V"), - (0x1018F, "X"), - (0x10190, "V"), - (0x1019D, "X"), - (0x101A0, "V"), - (0x101A1, "X"), - (0x101D0, "V"), - (0x101FE, "X"), - (0x10280, "V"), - (0x1029D, "X"), - (0x102A0, "V"), - (0x102D1, "X"), - (0x102E0, "V"), - (0x102FC, "X"), - (0x10300, "V"), - (0x10324, "X"), - (0x1032D, "V"), - (0x1034B, "X"), - (0x10350, "V"), - (0x1037B, "X"), - (0x10380, "V"), - (0x1039E, "X"), - (0x1039F, "V"), - (0x103C4, "X"), - (0x103C8, "V"), - (0x103D6, "X"), - (0x10400, "M", "𐐨"), - (0x10401, "M", "𐐩"), - (0x10402, "M", "𐐪"), - (0x10403, "M", "𐐫"), - (0x10404, "M", "𐐬"), - (0x10405, "M", "𐐭"), - (0x10406, "M", "𐐮"), - (0x10407, "M", "𐐯"), - (0x10408, "M", "𐐰"), - (0x10409, "M", "𐐱"), - (0x1040A, "M", "𐐲"), - (0x1040B, "M", "𐐳"), - (0x1040C, "M", "𐐴"), - (0x1040D, "M", "𐐵"), - (0x1040E, "M", "𐐶"), - ] - - -def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1040F, "M", "𐐷"), - (0x10410, "M", "𐐸"), - (0x10411, "M", "𐐹"), - (0x10412, "M", "𐐺"), - (0x10413, "M", "𐐻"), - (0x10414, "M", "𐐼"), - (0x10415, "M", "𐐽"), - (0x10416, "M", "𐐾"), - (0x10417, "M", "𐐿"), - (0x10418, "M", "𐑀"), - (0x10419, "M", "𐑁"), - (0x1041A, "M", "𐑂"), - (0x1041B, "M", "𐑃"), - (0x1041C, "M", "𐑄"), - (0x1041D, "M", "𐑅"), - (0x1041E, "M", "𐑆"), - (0x1041F, "M", "𐑇"), - (0x10420, "M", "𐑈"), - (0x10421, "M", "𐑉"), - (0x10422, "M", "𐑊"), - (0x10423, "M", "𐑋"), - (0x10424, "M", "𐑌"), - (0x10425, "M", "𐑍"), - (0x10426, "M", "𐑎"), - (0x10427, "M", "𐑏"), - (0x10428, "V"), - (0x1049E, "X"), - (0x104A0, "V"), - (0x104AA, "X"), - (0x104B0, "M", "𐓘"), - (0x104B1, "M", "𐓙"), - (0x104B2, "M", "𐓚"), - (0x104B3, "M", "𐓛"), - (0x104B4, "M", "𐓜"), - (0x104B5, "M", "𐓝"), - (0x104B6, "M", "𐓞"), - (0x104B7, "M", "𐓟"), - (0x104B8, "M", "𐓠"), - (0x104B9, "M", "𐓡"), - (0x104BA, "M", "𐓢"), - (0x104BB, "M", "𐓣"), - (0x104BC, "M", "𐓤"), - (0x104BD, "M", "𐓥"), - (0x104BE, "M", "𐓦"), - (0x104BF, "M", "𐓧"), - (0x104C0, "M", "𐓨"), - (0x104C1, "M", "𐓩"), - (0x104C2, "M", "𐓪"), - (0x104C3, "M", "𐓫"), - (0x104C4, "M", "𐓬"), - (0x104C5, "M", "𐓭"), - (0x104C6, "M", "𐓮"), - (0x104C7, "M", "𐓯"), - (0x104C8, "M", "𐓰"), - (0x104C9, "M", "𐓱"), - (0x104CA, "M", "𐓲"), - (0x104CB, "M", "𐓳"), - (0x104CC, "M", "𐓴"), - (0x104CD, "M", "𐓵"), - (0x104CE, "M", "𐓶"), - (0x104CF, "M", "𐓷"), - (0x104D0, "M", "𐓸"), - (0x104D1, "M", "𐓹"), - (0x104D2, "M", "𐓺"), - (0x104D3, "M", "𐓻"), - (0x104D4, "X"), - (0x104D8, "V"), - (0x104FC, "X"), - (0x10500, "V"), - (0x10528, "X"), - (0x10530, "V"), - (0x10564, "X"), - (0x1056F, "V"), - (0x10570, "M", "𐖗"), - (0x10571, "M", "𐖘"), - (0x10572, "M", "𐖙"), - (0x10573, "M", "𐖚"), - (0x10574, "M", "𐖛"), - (0x10575, "M", "𐖜"), - (0x10576, "M", "𐖝"), - (0x10577, "M", "𐖞"), - (0x10578, "M", "𐖟"), - (0x10579, "M", "𐖠"), - (0x1057A, "M", "𐖡"), - (0x1057B, "X"), - (0x1057C, "M", "𐖣"), - (0x1057D, "M", "𐖤"), - (0x1057E, "M", "𐖥"), - (0x1057F, "M", "𐖦"), - (0x10580, "M", "𐖧"), - (0x10581, "M", "𐖨"), - (0x10582, "M", "𐖩"), - (0x10583, "M", "𐖪"), - (0x10584, "M", "𐖫"), - (0x10585, "M", "𐖬"), - (0x10586, "M", "𐖭"), - (0x10587, "M", "𐖮"), - (0x10588, "M", "𐖯"), - (0x10589, "M", "𐖰"), - (0x1058A, "M", "𐖱"), - ] - - -def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1058B, "X"), - (0x1058C, "M", "𐖳"), - (0x1058D, "M", "𐖴"), - (0x1058E, "M", "𐖵"), - (0x1058F, "M", "𐖶"), - (0x10590, "M", "𐖷"), - (0x10591, "M", "𐖸"), - (0x10592, "M", "𐖹"), - (0x10593, "X"), - (0x10594, "M", "𐖻"), - (0x10595, "M", "𐖼"), - (0x10596, "X"), - (0x10597, "V"), - (0x105A2, "X"), - (0x105A3, "V"), - (0x105B2, "X"), - (0x105B3, "V"), - (0x105BA, "X"), - (0x105BB, "V"), - (0x105BD, "X"), - (0x105C0, "V"), - (0x105F4, "X"), - (0x10600, "V"), - (0x10737, "X"), - (0x10740, "V"), - (0x10756, "X"), - (0x10760, "V"), - (0x10768, "X"), - (0x10780, "V"), - (0x10781, "M", "ː"), - (0x10782, "M", "ˑ"), - (0x10783, "M", "æ"), - (0x10784, "M", "ʙ"), - (0x10785, "M", "ɓ"), - (0x10786, "X"), - (0x10787, "M", "ʣ"), - (0x10788, "M", "ꭦ"), - (0x10789, "M", "ʥ"), - (0x1078A, "M", "ʤ"), - (0x1078B, "M", "ɖ"), - (0x1078C, "M", "ɗ"), - (0x1078D, "M", "ᶑ"), - (0x1078E, "M", "ɘ"), - (0x1078F, "M", "ɞ"), - (0x10790, "M", "ʩ"), - (0x10791, "M", "ɤ"), - (0x10792, "M", "ɢ"), - (0x10793, "M", "ɠ"), - (0x10794, "M", "ʛ"), - (0x10795, "M", "ħ"), - (0x10796, "M", "ʜ"), - (0x10797, "M", "ɧ"), - (0x10798, "M", "ʄ"), - (0x10799, "M", "ʪ"), - (0x1079A, "M", "ʫ"), - (0x1079B, "M", "ɬ"), - (0x1079C, "M", "𝼄"), - (0x1079D, "M", "ꞎ"), - (0x1079E, "M", "ɮ"), - (0x1079F, "M", "𝼅"), - (0x107A0, "M", "ʎ"), - (0x107A1, "M", "𝼆"), - (0x107A2, "M", "ø"), - (0x107A3, "M", "ɶ"), - (0x107A4, "M", "ɷ"), - (0x107A5, "M", "q"), - (0x107A6, "M", "ɺ"), - (0x107A7, "M", "𝼈"), - (0x107A8, "M", "ɽ"), - (0x107A9, "M", "ɾ"), - (0x107AA, "M", "ʀ"), - (0x107AB, "M", "ʨ"), - (0x107AC, "M", "ʦ"), - (0x107AD, "M", "ꭧ"), - (0x107AE, "M", "ʧ"), - (0x107AF, "M", "ʈ"), - (0x107B0, "M", "ⱱ"), - (0x107B1, "X"), - (0x107B2, "M", "ʏ"), - (0x107B3, "M", "ʡ"), - (0x107B4, "M", "ʢ"), - (0x107B5, "M", "ʘ"), - (0x107B6, "M", "ǀ"), - (0x107B7, "M", "ǁ"), - (0x107B8, "M", "ǂ"), - (0x107B9, "M", "𝼊"), - (0x107BA, "M", "𝼞"), - (0x107BB, "X"), - (0x10800, "V"), - (0x10806, "X"), - (0x10808, "V"), - (0x10809, "X"), - (0x1080A, "V"), - (0x10836, "X"), - (0x10837, "V"), - (0x10839, "X"), - (0x1083C, "V"), - (0x1083D, "X"), - (0x1083F, "V"), - (0x10856, "X"), - ] - - -def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x10857, "V"), - (0x1089F, "X"), - (0x108A7, "V"), - (0x108B0, "X"), - (0x108E0, "V"), - (0x108F3, "X"), - (0x108F4, "V"), - (0x108F6, "X"), - (0x108FB, "V"), - (0x1091C, "X"), - (0x1091F, "V"), - (0x1093A, "X"), - (0x1093F, "V"), - (0x10940, "X"), - (0x10980, "V"), - (0x109B8, "X"), - (0x109BC, "V"), - (0x109D0, "X"), - (0x109D2, "V"), - (0x10A04, "X"), - (0x10A05, "V"), - (0x10A07, "X"), - (0x10A0C, "V"), - (0x10A14, "X"), - (0x10A15, "V"), - (0x10A18, "X"), - (0x10A19, "V"), - (0x10A36, "X"), - (0x10A38, "V"), - (0x10A3B, "X"), - (0x10A3F, "V"), - (0x10A49, "X"), - (0x10A50, "V"), - (0x10A59, "X"), - (0x10A60, "V"), - (0x10AA0, "X"), - (0x10AC0, "V"), - (0x10AE7, "X"), - (0x10AEB, "V"), - (0x10AF7, "X"), - (0x10B00, "V"), - (0x10B36, "X"), - (0x10B39, "V"), - (0x10B56, "X"), - (0x10B58, "V"), - (0x10B73, "X"), - (0x10B78, "V"), - (0x10B92, "X"), - (0x10B99, "V"), - (0x10B9D, "X"), - (0x10BA9, "V"), - (0x10BB0, "X"), - (0x10C00, "V"), - (0x10C49, "X"), - (0x10C80, "M", "𐳀"), - (0x10C81, "M", "𐳁"), - (0x10C82, "M", "𐳂"), - (0x10C83, "M", "𐳃"), - (0x10C84, "M", "𐳄"), - (0x10C85, "M", "𐳅"), - (0x10C86, "M", "𐳆"), - (0x10C87, "M", "𐳇"), - (0x10C88, "M", "𐳈"), - (0x10C89, "M", "𐳉"), - (0x10C8A, "M", "𐳊"), - (0x10C8B, "M", "𐳋"), - (0x10C8C, "M", "𐳌"), - (0x10C8D, "M", "𐳍"), - (0x10C8E, "M", "𐳎"), - (0x10C8F, "M", "𐳏"), - (0x10C90, "M", "𐳐"), - (0x10C91, "M", "𐳑"), - (0x10C92, "M", "𐳒"), - (0x10C93, "M", "𐳓"), - (0x10C94, "M", "𐳔"), - (0x10C95, "M", "𐳕"), - (0x10C96, "M", "𐳖"), - (0x10C97, "M", "𐳗"), - (0x10C98, "M", "𐳘"), - (0x10C99, "M", "𐳙"), - (0x10C9A, "M", "𐳚"), - (0x10C9B, "M", "𐳛"), - (0x10C9C, "M", "𐳜"), - (0x10C9D, "M", "𐳝"), - (0x10C9E, "M", "𐳞"), - (0x10C9F, "M", "𐳟"), - (0x10CA0, "M", "𐳠"), - (0x10CA1, "M", "𐳡"), - (0x10CA2, "M", "𐳢"), - (0x10CA3, "M", "𐳣"), - (0x10CA4, "M", "𐳤"), - (0x10CA5, "M", "𐳥"), - (0x10CA6, "M", "𐳦"), - (0x10CA7, "M", "𐳧"), - (0x10CA8, "M", "𐳨"), - (0x10CA9, "M", "𐳩"), - (0x10CAA, "M", "𐳪"), - (0x10CAB, "M", "𐳫"), - (0x10CAC, "M", "𐳬"), - (0x10CAD, "M", "𐳭"), - ] - - -def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x10CAE, "M", "𐳮"), - (0x10CAF, "M", "𐳯"), - (0x10CB0, "M", "𐳰"), - (0x10CB1, "M", "𐳱"), - (0x10CB2, "M", "𐳲"), - (0x10CB3, "X"), - (0x10CC0, "V"), - (0x10CF3, "X"), - (0x10CFA, "V"), - (0x10D28, "X"), - (0x10D30, "V"), - (0x10D3A, "X"), - (0x10D40, "V"), - (0x10D50, "M", "𐵰"), - (0x10D51, "M", "𐵱"), - (0x10D52, "M", "𐵲"), - (0x10D53, "M", "𐵳"), - (0x10D54, "M", "𐵴"), - (0x10D55, "M", "𐵵"), - (0x10D56, "M", "𐵶"), - (0x10D57, "M", "𐵷"), - (0x10D58, "M", "𐵸"), - (0x10D59, "M", "𐵹"), - (0x10D5A, "M", "𐵺"), - (0x10D5B, "M", "𐵻"), - (0x10D5C, "M", "𐵼"), - (0x10D5D, "M", "𐵽"), - (0x10D5E, "M", "𐵾"), - (0x10D5F, "M", "𐵿"), - (0x10D60, "M", "𐶀"), - (0x10D61, "M", "𐶁"), - (0x10D62, "M", "𐶂"), - (0x10D63, "M", "𐶃"), - (0x10D64, "M", "𐶄"), - (0x10D65, "M", "𐶅"), - (0x10D66, "X"), - (0x10D69, "V"), - (0x10D86, "X"), - (0x10D8E, "V"), - (0x10D90, "X"), - (0x10E60, "V"), - (0x10E7F, "X"), - (0x10E80, "V"), - (0x10EAA, "X"), - (0x10EAB, "V"), - (0x10EAE, "X"), - (0x10EB0, "V"), - (0x10EB2, "X"), - (0x10EC2, "V"), - (0x10EC5, "X"), - (0x10EFC, "V"), - (0x10F28, "X"), - (0x10F30, "V"), - (0x10F5A, "X"), - (0x10F70, "V"), - (0x10F8A, "X"), - (0x10FB0, "V"), - (0x10FCC, "X"), - (0x10FE0, "V"), - (0x10FF7, "X"), - (0x11000, "V"), - (0x1104E, "X"), - (0x11052, "V"), - (0x11076, "X"), - (0x1107F, "V"), - (0x110BD, "X"), - (0x110BE, "V"), - (0x110C3, "X"), - (0x110D0, "V"), - (0x110E9, "X"), - (0x110F0, "V"), - (0x110FA, "X"), - (0x11100, "V"), - (0x11135, "X"), - (0x11136, "V"), - (0x11148, "X"), - (0x11150, "V"), - (0x11177, "X"), - (0x11180, "V"), - (0x111E0, "X"), - (0x111E1, "V"), - (0x111F5, "X"), - (0x11200, "V"), - (0x11212, "X"), - (0x11213, "V"), - (0x11242, "X"), - (0x11280, "V"), - (0x11287, "X"), - (0x11288, "V"), - (0x11289, "X"), - (0x1128A, "V"), - (0x1128E, "X"), - (0x1128F, "V"), - (0x1129E, "X"), - (0x1129F, "V"), - (0x112AA, "X"), - (0x112B0, "V"), - (0x112EB, "X"), - (0x112F0, "V"), - (0x112FA, "X"), - ] - - -def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x11300, "V"), - (0x11304, "X"), - (0x11305, "V"), - (0x1130D, "X"), - (0x1130F, "V"), - (0x11311, "X"), - (0x11313, "V"), - (0x11329, "X"), - (0x1132A, "V"), - (0x11331, "X"), - (0x11332, "V"), - (0x11334, "X"), - (0x11335, "V"), - (0x1133A, "X"), - (0x1133B, "V"), - (0x11345, "X"), - (0x11347, "V"), - (0x11349, "X"), - (0x1134B, "V"), - (0x1134E, "X"), - (0x11350, "V"), - (0x11351, "X"), - (0x11357, "V"), - (0x11358, "X"), - (0x1135D, "V"), - (0x11364, "X"), - (0x11366, "V"), - (0x1136D, "X"), - (0x11370, "V"), - (0x11375, "X"), - (0x11380, "V"), - (0x1138A, "X"), - (0x1138B, "V"), - (0x1138C, "X"), - (0x1138E, "V"), - (0x1138F, "X"), - (0x11390, "V"), - (0x113B6, "X"), - (0x113B7, "V"), - (0x113C1, "X"), - (0x113C2, "V"), - (0x113C3, "X"), - (0x113C5, "V"), - (0x113C6, "X"), - (0x113C7, "V"), - (0x113CB, "X"), - (0x113CC, "V"), - (0x113D6, "X"), - (0x113D7, "V"), - (0x113D9, "X"), - (0x113E1, "V"), - (0x113E3, "X"), - (0x11400, "V"), - (0x1145C, "X"), - (0x1145D, "V"), - (0x11462, "X"), - (0x11480, "V"), - (0x114C8, "X"), - (0x114D0, "V"), - (0x114DA, "X"), - (0x11580, "V"), - (0x115B6, "X"), - (0x115B8, "V"), - (0x115DE, "X"), - (0x11600, "V"), - (0x11645, "X"), - (0x11650, "V"), - (0x1165A, "X"), - (0x11660, "V"), - (0x1166D, "X"), - (0x11680, "V"), - (0x116BA, "X"), - (0x116C0, "V"), - (0x116CA, "X"), - (0x116D0, "V"), - (0x116E4, "X"), - (0x11700, "V"), - (0x1171B, "X"), - (0x1171D, "V"), - (0x1172C, "X"), - (0x11730, "V"), - (0x11747, "X"), - (0x11800, "V"), - (0x1183C, "X"), - (0x118A0, "M", "𑣀"), - (0x118A1, "M", "𑣁"), - (0x118A2, "M", "𑣂"), - (0x118A3, "M", "𑣃"), - (0x118A4, "M", "𑣄"), - (0x118A5, "M", "𑣅"), - (0x118A6, "M", "𑣆"), - (0x118A7, "M", "𑣇"), - (0x118A8, "M", "𑣈"), - (0x118A9, "M", "𑣉"), - (0x118AA, "M", "𑣊"), - (0x118AB, "M", "𑣋"), - (0x118AC, "M", "𑣌"), - (0x118AD, "M", "𑣍"), - (0x118AE, "M", "𑣎"), - (0x118AF, "M", "𑣏"), - ] - - -def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x118B0, "M", "𑣐"), - (0x118B1, "M", "𑣑"), - (0x118B2, "M", "𑣒"), - (0x118B3, "M", "𑣓"), - (0x118B4, "M", "𑣔"), - (0x118B5, "M", "𑣕"), - (0x118B6, "M", "𑣖"), - (0x118B7, "M", "𑣗"), - (0x118B8, "M", "𑣘"), - (0x118B9, "M", "𑣙"), - (0x118BA, "M", "𑣚"), - (0x118BB, "M", "𑣛"), - (0x118BC, "M", "𑣜"), - (0x118BD, "M", "𑣝"), - (0x118BE, "M", "𑣞"), - (0x118BF, "M", "𑣟"), - (0x118C0, "V"), - (0x118F3, "X"), - (0x118FF, "V"), - (0x11907, "X"), - (0x11909, "V"), - (0x1190A, "X"), - (0x1190C, "V"), - (0x11914, "X"), - (0x11915, "V"), - (0x11917, "X"), - (0x11918, "V"), - (0x11936, "X"), - (0x11937, "V"), - (0x11939, "X"), - (0x1193B, "V"), - (0x11947, "X"), - (0x11950, "V"), - (0x1195A, "X"), - (0x119A0, "V"), - (0x119A8, "X"), - (0x119AA, "V"), - (0x119D8, "X"), - (0x119DA, "V"), - (0x119E5, "X"), - (0x11A00, "V"), - (0x11A48, "X"), - (0x11A50, "V"), - (0x11AA3, "X"), - (0x11AB0, "V"), - (0x11AF9, "X"), - (0x11B00, "V"), - (0x11B0A, "X"), - (0x11BC0, "V"), - (0x11BE2, "X"), - (0x11BF0, "V"), - (0x11BFA, "X"), - (0x11C00, "V"), - (0x11C09, "X"), - (0x11C0A, "V"), - (0x11C37, "X"), - (0x11C38, "V"), - (0x11C46, "X"), - (0x11C50, "V"), - (0x11C6D, "X"), - (0x11C70, "V"), - (0x11C90, "X"), - (0x11C92, "V"), - (0x11CA8, "X"), - (0x11CA9, "V"), - (0x11CB7, "X"), - (0x11D00, "V"), - (0x11D07, "X"), - (0x11D08, "V"), - (0x11D0A, "X"), - (0x11D0B, "V"), - (0x11D37, "X"), - (0x11D3A, "V"), - (0x11D3B, "X"), - (0x11D3C, "V"), - (0x11D3E, "X"), - (0x11D3F, "V"), - (0x11D48, "X"), - (0x11D50, "V"), - (0x11D5A, "X"), - (0x11D60, "V"), - (0x11D66, "X"), - (0x11D67, "V"), - (0x11D69, "X"), - (0x11D6A, "V"), - (0x11D8F, "X"), - (0x11D90, "V"), - (0x11D92, "X"), - (0x11D93, "V"), - (0x11D99, "X"), - (0x11DA0, "V"), - (0x11DAA, "X"), - (0x11EE0, "V"), - (0x11EF9, "X"), - (0x11F00, "V"), - (0x11F11, "X"), - (0x11F12, "V"), - (0x11F3B, "X"), - (0x11F3E, "V"), - (0x11F5B, "X"), - ] - - -def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x11FB0, "V"), - (0x11FB1, "X"), - (0x11FC0, "V"), - (0x11FF2, "X"), - (0x11FFF, "V"), - (0x1239A, "X"), - (0x12400, "V"), - (0x1246F, "X"), - (0x12470, "V"), - (0x12475, "X"), - (0x12480, "V"), - (0x12544, "X"), - (0x12F90, "V"), - (0x12FF3, "X"), - (0x13000, "V"), - (0x13430, "X"), - (0x13440, "V"), - (0x13456, "X"), - (0x13460, "V"), - (0x143FB, "X"), - (0x14400, "V"), - (0x14647, "X"), - (0x16100, "V"), - (0x1613A, "X"), - (0x16800, "V"), - (0x16A39, "X"), - (0x16A40, "V"), - (0x16A5F, "X"), - (0x16A60, "V"), - (0x16A6A, "X"), - (0x16A6E, "V"), - (0x16ABF, "X"), - (0x16AC0, "V"), - (0x16ACA, "X"), - (0x16AD0, "V"), - (0x16AEE, "X"), - (0x16AF0, "V"), - (0x16AF6, "X"), - (0x16B00, "V"), - (0x16B46, "X"), - (0x16B50, "V"), - (0x16B5A, "X"), - (0x16B5B, "V"), - (0x16B62, "X"), - (0x16B63, "V"), - (0x16B78, "X"), - (0x16B7D, "V"), - (0x16B90, "X"), - (0x16D40, "V"), - (0x16D7A, "X"), - (0x16E40, "M", "𖹠"), - (0x16E41, "M", "𖹡"), - (0x16E42, "M", "𖹢"), - (0x16E43, "M", "𖹣"), - (0x16E44, "M", "𖹤"), - (0x16E45, "M", "𖹥"), - (0x16E46, "M", "𖹦"), - (0x16E47, "M", "𖹧"), - (0x16E48, "M", "𖹨"), - (0x16E49, "M", "𖹩"), - (0x16E4A, "M", "𖹪"), - (0x16E4B, "M", "𖹫"), - (0x16E4C, "M", "𖹬"), - (0x16E4D, "M", "𖹭"), - (0x16E4E, "M", "𖹮"), - (0x16E4F, "M", "𖹯"), - (0x16E50, "M", "𖹰"), - (0x16E51, "M", "𖹱"), - (0x16E52, "M", "𖹲"), - (0x16E53, "M", "𖹳"), - (0x16E54, "M", "𖹴"), - (0x16E55, "M", "𖹵"), - (0x16E56, "M", "𖹶"), - (0x16E57, "M", "𖹷"), - (0x16E58, "M", "𖹸"), - (0x16E59, "M", "𖹹"), - (0x16E5A, "M", "𖹺"), - (0x16E5B, "M", "𖹻"), - (0x16E5C, "M", "𖹼"), - (0x16E5D, "M", "𖹽"), - (0x16E5E, "M", "𖹾"), - (0x16E5F, "M", "𖹿"), - (0x16E60, "V"), - (0x16E9B, "X"), - (0x16F00, "V"), - (0x16F4B, "X"), - (0x16F4F, "V"), - (0x16F88, "X"), - (0x16F8F, "V"), - (0x16FA0, "X"), - (0x16FE0, "V"), - (0x16FE5, "X"), - (0x16FF0, "V"), - (0x16FF2, "X"), - (0x17000, "V"), - (0x187F8, "X"), - (0x18800, "V"), - (0x18CD6, "X"), - (0x18CFF, "V"), - (0x18D09, "X"), - ] - - -def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1AFF0, "V"), - (0x1AFF4, "X"), - (0x1AFF5, "V"), - (0x1AFFC, "X"), - (0x1AFFD, "V"), - (0x1AFFF, "X"), - (0x1B000, "V"), - (0x1B123, "X"), - (0x1B132, "V"), - (0x1B133, "X"), - (0x1B150, "V"), - (0x1B153, "X"), - (0x1B155, "V"), - (0x1B156, "X"), - (0x1B164, "V"), - (0x1B168, "X"), - (0x1B170, "V"), - (0x1B2FC, "X"), - (0x1BC00, "V"), - (0x1BC6B, "X"), - (0x1BC70, "V"), - (0x1BC7D, "X"), - (0x1BC80, "V"), - (0x1BC89, "X"), - (0x1BC90, "V"), - (0x1BC9A, "X"), - (0x1BC9C, "V"), - (0x1BCA0, "I"), - (0x1BCA4, "X"), - (0x1CC00, "V"), - (0x1CCD6, "M", "a"), - (0x1CCD7, "M", "b"), - (0x1CCD8, "M", "c"), - (0x1CCD9, "M", "d"), - (0x1CCDA, "M", "e"), - (0x1CCDB, "M", "f"), - (0x1CCDC, "M", "g"), - (0x1CCDD, "M", "h"), - (0x1CCDE, "M", "i"), - (0x1CCDF, "M", "j"), - (0x1CCE0, "M", "k"), - (0x1CCE1, "M", "l"), - (0x1CCE2, "M", "m"), - (0x1CCE3, "M", "n"), - (0x1CCE4, "M", "o"), - (0x1CCE5, "M", "p"), - (0x1CCE6, "M", "q"), - (0x1CCE7, "M", "r"), - (0x1CCE8, "M", "s"), - (0x1CCE9, "M", "t"), - (0x1CCEA, "M", "u"), - (0x1CCEB, "M", "v"), - (0x1CCEC, "M", "w"), - (0x1CCED, "M", "x"), - (0x1CCEE, "M", "y"), - (0x1CCEF, "M", "z"), - (0x1CCF0, "M", "0"), - (0x1CCF1, "M", "1"), - (0x1CCF2, "M", "2"), - (0x1CCF3, "M", "3"), - (0x1CCF4, "M", "4"), - (0x1CCF5, "M", "5"), - (0x1CCF6, "M", "6"), - (0x1CCF7, "M", "7"), - (0x1CCF8, "M", "8"), - (0x1CCF9, "M", "9"), - (0x1CCFA, "X"), - (0x1CD00, "V"), - (0x1CEB4, "X"), - (0x1CF00, "V"), - (0x1CF2E, "X"), - (0x1CF30, "V"), - (0x1CF47, "X"), - (0x1CF50, "V"), - (0x1CFC4, "X"), - (0x1D000, "V"), - (0x1D0F6, "X"), - (0x1D100, "V"), - (0x1D127, "X"), - (0x1D129, "V"), - (0x1D15E, "M", "𝅗𝅥"), - (0x1D15F, "M", "𝅘𝅥"), - (0x1D160, "M", "𝅘𝅥𝅮"), - (0x1D161, "M", "𝅘𝅥𝅯"), - (0x1D162, "M", "𝅘𝅥𝅰"), - (0x1D163, "M", "𝅘𝅥𝅱"), - (0x1D164, "M", "𝅘𝅥𝅲"), - (0x1D165, "V"), - (0x1D173, "I"), - (0x1D17B, "V"), - (0x1D1BB, "M", "𝆹𝅥"), - (0x1D1BC, "M", "𝆺𝅥"), - (0x1D1BD, "M", "𝆹𝅥𝅮"), - (0x1D1BE, "M", "𝆺𝅥𝅮"), - (0x1D1BF, "M", "𝆹𝅥𝅯"), - (0x1D1C0, "M", "𝆺𝅥𝅯"), - (0x1D1C1, "V"), - (0x1D1EB, "X"), - (0x1D200, "V"), - (0x1D246, "X"), - ] - - -def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D2C0, "V"), - (0x1D2D4, "X"), - (0x1D2E0, "V"), - (0x1D2F4, "X"), - (0x1D300, "V"), - (0x1D357, "X"), - (0x1D360, "V"), - (0x1D379, "X"), - (0x1D400, "M", "a"), - (0x1D401, "M", "b"), - (0x1D402, "M", "c"), - (0x1D403, "M", "d"), - (0x1D404, "M", "e"), - (0x1D405, "M", "f"), - (0x1D406, "M", "g"), - (0x1D407, "M", "h"), - (0x1D408, "M", "i"), - (0x1D409, "M", "j"), - (0x1D40A, "M", "k"), - (0x1D40B, "M", "l"), - (0x1D40C, "M", "m"), - (0x1D40D, "M", "n"), - (0x1D40E, "M", "o"), - (0x1D40F, "M", "p"), - (0x1D410, "M", "q"), - (0x1D411, "M", "r"), - (0x1D412, "M", "s"), - (0x1D413, "M", "t"), - (0x1D414, "M", "u"), - (0x1D415, "M", "v"), - (0x1D416, "M", "w"), - (0x1D417, "M", "x"), - (0x1D418, "M", "y"), - (0x1D419, "M", "z"), - (0x1D41A, "M", "a"), - (0x1D41B, "M", "b"), - (0x1D41C, "M", "c"), - (0x1D41D, "M", "d"), - (0x1D41E, "M", "e"), - (0x1D41F, "M", "f"), - (0x1D420, "M", "g"), - (0x1D421, "M", "h"), - (0x1D422, "M", "i"), - (0x1D423, "M", "j"), - (0x1D424, "M", "k"), - (0x1D425, "M", "l"), - (0x1D426, "M", "m"), - (0x1D427, "M", "n"), - (0x1D428, "M", "o"), - (0x1D429, "M", "p"), - (0x1D42A, "M", "q"), - (0x1D42B, "M", "r"), - (0x1D42C, "M", "s"), - (0x1D42D, "M", "t"), - (0x1D42E, "M", "u"), - (0x1D42F, "M", "v"), - (0x1D430, "M", "w"), - (0x1D431, "M", "x"), - (0x1D432, "M", "y"), - (0x1D433, "M", "z"), - (0x1D434, "M", "a"), - (0x1D435, "M", "b"), - (0x1D436, "M", "c"), - (0x1D437, "M", "d"), - (0x1D438, "M", "e"), - (0x1D439, "M", "f"), - (0x1D43A, "M", "g"), - (0x1D43B, "M", "h"), - (0x1D43C, "M", "i"), - (0x1D43D, "M", "j"), - (0x1D43E, "M", "k"), - (0x1D43F, "M", "l"), - (0x1D440, "M", "m"), - (0x1D441, "M", "n"), - (0x1D442, "M", "o"), - (0x1D443, "M", "p"), - (0x1D444, "M", "q"), - (0x1D445, "M", "r"), - (0x1D446, "M", "s"), - (0x1D447, "M", "t"), - (0x1D448, "M", "u"), - (0x1D449, "M", "v"), - (0x1D44A, "M", "w"), - (0x1D44B, "M", "x"), - (0x1D44C, "M", "y"), - (0x1D44D, "M", "z"), - (0x1D44E, "M", "a"), - (0x1D44F, "M", "b"), - (0x1D450, "M", "c"), - (0x1D451, "M", "d"), - (0x1D452, "M", "e"), - (0x1D453, "M", "f"), - (0x1D454, "M", "g"), - (0x1D455, "X"), - (0x1D456, "M", "i"), - (0x1D457, "M", "j"), - (0x1D458, "M", "k"), - (0x1D459, "M", "l"), - (0x1D45A, "M", "m"), - (0x1D45B, "M", "n"), - ] - - -def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D45C, "M", "o"), - (0x1D45D, "M", "p"), - (0x1D45E, "M", "q"), - (0x1D45F, "M", "r"), - (0x1D460, "M", "s"), - (0x1D461, "M", "t"), - (0x1D462, "M", "u"), - (0x1D463, "M", "v"), - (0x1D464, "M", "w"), - (0x1D465, "M", "x"), - (0x1D466, "M", "y"), - (0x1D467, "M", "z"), - (0x1D468, "M", "a"), - (0x1D469, "M", "b"), - (0x1D46A, "M", "c"), - (0x1D46B, "M", "d"), - (0x1D46C, "M", "e"), - (0x1D46D, "M", "f"), - (0x1D46E, "M", "g"), - (0x1D46F, "M", "h"), - (0x1D470, "M", "i"), - (0x1D471, "M", "j"), - (0x1D472, "M", "k"), - (0x1D473, "M", "l"), - (0x1D474, "M", "m"), - (0x1D475, "M", "n"), - (0x1D476, "M", "o"), - (0x1D477, "M", "p"), - (0x1D478, "M", "q"), - (0x1D479, "M", "r"), - (0x1D47A, "M", "s"), - (0x1D47B, "M", "t"), - (0x1D47C, "M", "u"), - (0x1D47D, "M", "v"), - (0x1D47E, "M", "w"), - (0x1D47F, "M", "x"), - (0x1D480, "M", "y"), - (0x1D481, "M", "z"), - (0x1D482, "M", "a"), - (0x1D483, "M", "b"), - (0x1D484, "M", "c"), - (0x1D485, "M", "d"), - (0x1D486, "M", "e"), - (0x1D487, "M", "f"), - (0x1D488, "M", "g"), - (0x1D489, "M", "h"), - (0x1D48A, "M", "i"), - (0x1D48B, "M", "j"), - (0x1D48C, "M", "k"), - (0x1D48D, "M", "l"), - (0x1D48E, "M", "m"), - (0x1D48F, "M", "n"), - (0x1D490, "M", "o"), - (0x1D491, "M", "p"), - (0x1D492, "M", "q"), - (0x1D493, "M", "r"), - (0x1D494, "M", "s"), - (0x1D495, "M", "t"), - (0x1D496, "M", "u"), - (0x1D497, "M", "v"), - (0x1D498, "M", "w"), - (0x1D499, "M", "x"), - (0x1D49A, "M", "y"), - (0x1D49B, "M", "z"), - (0x1D49C, "M", "a"), - (0x1D49D, "X"), - (0x1D49E, "M", "c"), - (0x1D49F, "M", "d"), - (0x1D4A0, "X"), - (0x1D4A2, "M", "g"), - (0x1D4A3, "X"), - (0x1D4A5, "M", "j"), - (0x1D4A6, "M", "k"), - (0x1D4A7, "X"), - (0x1D4A9, "M", "n"), - (0x1D4AA, "M", "o"), - (0x1D4AB, "M", "p"), - (0x1D4AC, "M", "q"), - (0x1D4AD, "X"), - (0x1D4AE, "M", "s"), - (0x1D4AF, "M", "t"), - (0x1D4B0, "M", "u"), - (0x1D4B1, "M", "v"), - (0x1D4B2, "M", "w"), - (0x1D4B3, "M", "x"), - (0x1D4B4, "M", "y"), - (0x1D4B5, "M", "z"), - (0x1D4B6, "M", "a"), - (0x1D4B7, "M", "b"), - (0x1D4B8, "M", "c"), - (0x1D4B9, "M", "d"), - (0x1D4BA, "X"), - (0x1D4BB, "M", "f"), - (0x1D4BC, "X"), - (0x1D4BD, "M", "h"), - (0x1D4BE, "M", "i"), - (0x1D4BF, "M", "j"), - (0x1D4C0, "M", "k"), - (0x1D4C1, "M", "l"), - (0x1D4C2, "M", "m"), - ] - - -def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D4C3, "M", "n"), - (0x1D4C4, "X"), - (0x1D4C5, "M", "p"), - (0x1D4C6, "M", "q"), - (0x1D4C7, "M", "r"), - (0x1D4C8, "M", "s"), - (0x1D4C9, "M", "t"), - (0x1D4CA, "M", "u"), - (0x1D4CB, "M", "v"), - (0x1D4CC, "M", "w"), - (0x1D4CD, "M", "x"), - (0x1D4CE, "M", "y"), - (0x1D4CF, "M", "z"), - (0x1D4D0, "M", "a"), - (0x1D4D1, "M", "b"), - (0x1D4D2, "M", "c"), - (0x1D4D3, "M", "d"), - (0x1D4D4, "M", "e"), - (0x1D4D5, "M", "f"), - (0x1D4D6, "M", "g"), - (0x1D4D7, "M", "h"), - (0x1D4D8, "M", "i"), - (0x1D4D9, "M", "j"), - (0x1D4DA, "M", "k"), - (0x1D4DB, "M", "l"), - (0x1D4DC, "M", "m"), - (0x1D4DD, "M", "n"), - (0x1D4DE, "M", "o"), - (0x1D4DF, "M", "p"), - (0x1D4E0, "M", "q"), - (0x1D4E1, "M", "r"), - (0x1D4E2, "M", "s"), - (0x1D4E3, "M", "t"), - (0x1D4E4, "M", "u"), - (0x1D4E5, "M", "v"), - (0x1D4E6, "M", "w"), - (0x1D4E7, "M", "x"), - (0x1D4E8, "M", "y"), - (0x1D4E9, "M", "z"), - (0x1D4EA, "M", "a"), - (0x1D4EB, "M", "b"), - (0x1D4EC, "M", "c"), - (0x1D4ED, "M", "d"), - (0x1D4EE, "M", "e"), - (0x1D4EF, "M", "f"), - (0x1D4F0, "M", "g"), - (0x1D4F1, "M", "h"), - (0x1D4F2, "M", "i"), - (0x1D4F3, "M", "j"), - (0x1D4F4, "M", "k"), - (0x1D4F5, "M", "l"), - (0x1D4F6, "M", "m"), - (0x1D4F7, "M", "n"), - (0x1D4F8, "M", "o"), - (0x1D4F9, "M", "p"), - (0x1D4FA, "M", "q"), - (0x1D4FB, "M", "r"), - (0x1D4FC, "M", "s"), - (0x1D4FD, "M", "t"), - (0x1D4FE, "M", "u"), - (0x1D4FF, "M", "v"), - (0x1D500, "M", "w"), - (0x1D501, "M", "x"), - (0x1D502, "M", "y"), - (0x1D503, "M", "z"), - (0x1D504, "M", "a"), - (0x1D505, "M", "b"), - (0x1D506, "X"), - (0x1D507, "M", "d"), - (0x1D508, "M", "e"), - (0x1D509, "M", "f"), - (0x1D50A, "M", "g"), - (0x1D50B, "X"), - (0x1D50D, "M", "j"), - (0x1D50E, "M", "k"), - (0x1D50F, "M", "l"), - (0x1D510, "M", "m"), - (0x1D511, "M", "n"), - (0x1D512, "M", "o"), - (0x1D513, "M", "p"), - (0x1D514, "M", "q"), - (0x1D515, "X"), - (0x1D516, "M", "s"), - (0x1D517, "M", "t"), - (0x1D518, "M", "u"), - (0x1D519, "M", "v"), - (0x1D51A, "M", "w"), - (0x1D51B, "M", "x"), - (0x1D51C, "M", "y"), - (0x1D51D, "X"), - (0x1D51E, "M", "a"), - (0x1D51F, "M", "b"), - (0x1D520, "M", "c"), - (0x1D521, "M", "d"), - (0x1D522, "M", "e"), - (0x1D523, "M", "f"), - (0x1D524, "M", "g"), - (0x1D525, "M", "h"), - (0x1D526, "M", "i"), - (0x1D527, "M", "j"), - ] - - -def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D528, "M", "k"), - (0x1D529, "M", "l"), - (0x1D52A, "M", "m"), - (0x1D52B, "M", "n"), - (0x1D52C, "M", "o"), - (0x1D52D, "M", "p"), - (0x1D52E, "M", "q"), - (0x1D52F, "M", "r"), - (0x1D530, "M", "s"), - (0x1D531, "M", "t"), - (0x1D532, "M", "u"), - (0x1D533, "M", "v"), - (0x1D534, "M", "w"), - (0x1D535, "M", "x"), - (0x1D536, "M", "y"), - (0x1D537, "M", "z"), - (0x1D538, "M", "a"), - (0x1D539, "M", "b"), - (0x1D53A, "X"), - (0x1D53B, "M", "d"), - (0x1D53C, "M", "e"), - (0x1D53D, "M", "f"), - (0x1D53E, "M", "g"), - (0x1D53F, "X"), - (0x1D540, "M", "i"), - (0x1D541, "M", "j"), - (0x1D542, "M", "k"), - (0x1D543, "M", "l"), - (0x1D544, "M", "m"), - (0x1D545, "X"), - (0x1D546, "M", "o"), - (0x1D547, "X"), - (0x1D54A, "M", "s"), - (0x1D54B, "M", "t"), - (0x1D54C, "M", "u"), - (0x1D54D, "M", "v"), - (0x1D54E, "M", "w"), - (0x1D54F, "M", "x"), - (0x1D550, "M", "y"), - (0x1D551, "X"), - (0x1D552, "M", "a"), - (0x1D553, "M", "b"), - (0x1D554, "M", "c"), - (0x1D555, "M", "d"), - (0x1D556, "M", "e"), - (0x1D557, "M", "f"), - (0x1D558, "M", "g"), - (0x1D559, "M", "h"), - (0x1D55A, "M", "i"), - (0x1D55B, "M", "j"), - (0x1D55C, "M", "k"), - (0x1D55D, "M", "l"), - (0x1D55E, "M", "m"), - (0x1D55F, "M", "n"), - (0x1D560, "M", "o"), - (0x1D561, "M", "p"), - (0x1D562, "M", "q"), - (0x1D563, "M", "r"), - (0x1D564, "M", "s"), - (0x1D565, "M", "t"), - (0x1D566, "M", "u"), - (0x1D567, "M", "v"), - (0x1D568, "M", "w"), - (0x1D569, "M", "x"), - (0x1D56A, "M", "y"), - (0x1D56B, "M", "z"), - (0x1D56C, "M", "a"), - (0x1D56D, "M", "b"), - (0x1D56E, "M", "c"), - (0x1D56F, "M", "d"), - (0x1D570, "M", "e"), - (0x1D571, "M", "f"), - (0x1D572, "M", "g"), - (0x1D573, "M", "h"), - (0x1D574, "M", "i"), - (0x1D575, "M", "j"), - (0x1D576, "M", "k"), - (0x1D577, "M", "l"), - (0x1D578, "M", "m"), - (0x1D579, "M", "n"), - (0x1D57A, "M", "o"), - (0x1D57B, "M", "p"), - (0x1D57C, "M", "q"), - (0x1D57D, "M", "r"), - (0x1D57E, "M", "s"), - (0x1D57F, "M", "t"), - (0x1D580, "M", "u"), - (0x1D581, "M", "v"), - (0x1D582, "M", "w"), - (0x1D583, "M", "x"), - (0x1D584, "M", "y"), - (0x1D585, "M", "z"), - (0x1D586, "M", "a"), - (0x1D587, "M", "b"), - (0x1D588, "M", "c"), - (0x1D589, "M", "d"), - (0x1D58A, "M", "e"), - (0x1D58B, "M", "f"), - (0x1D58C, "M", "g"), - (0x1D58D, "M", "h"), - ] - - -def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D58E, "M", "i"), - (0x1D58F, "M", "j"), - (0x1D590, "M", "k"), - (0x1D591, "M", "l"), - (0x1D592, "M", "m"), - (0x1D593, "M", "n"), - (0x1D594, "M", "o"), - (0x1D595, "M", "p"), - (0x1D596, "M", "q"), - (0x1D597, "M", "r"), - (0x1D598, "M", "s"), - (0x1D599, "M", "t"), - (0x1D59A, "M", "u"), - (0x1D59B, "M", "v"), - (0x1D59C, "M", "w"), - (0x1D59D, "M", "x"), - (0x1D59E, "M", "y"), - (0x1D59F, "M", "z"), - (0x1D5A0, "M", "a"), - (0x1D5A1, "M", "b"), - (0x1D5A2, "M", "c"), - (0x1D5A3, "M", "d"), - (0x1D5A4, "M", "e"), - (0x1D5A5, "M", "f"), - (0x1D5A6, "M", "g"), - (0x1D5A7, "M", "h"), - (0x1D5A8, "M", "i"), - (0x1D5A9, "M", "j"), - (0x1D5AA, "M", "k"), - (0x1D5AB, "M", "l"), - (0x1D5AC, "M", "m"), - (0x1D5AD, "M", "n"), - (0x1D5AE, "M", "o"), - (0x1D5AF, "M", "p"), - (0x1D5B0, "M", "q"), - (0x1D5B1, "M", "r"), - (0x1D5B2, "M", "s"), - (0x1D5B3, "M", "t"), - (0x1D5B4, "M", "u"), - (0x1D5B5, "M", "v"), - (0x1D5B6, "M", "w"), - (0x1D5B7, "M", "x"), - (0x1D5B8, "M", "y"), - (0x1D5B9, "M", "z"), - (0x1D5BA, "M", "a"), - (0x1D5BB, "M", "b"), - (0x1D5BC, "M", "c"), - (0x1D5BD, "M", "d"), - (0x1D5BE, "M", "e"), - (0x1D5BF, "M", "f"), - (0x1D5C0, "M", "g"), - (0x1D5C1, "M", "h"), - (0x1D5C2, "M", "i"), - (0x1D5C3, "M", "j"), - (0x1D5C4, "M", "k"), - (0x1D5C5, "M", "l"), - (0x1D5C6, "M", "m"), - (0x1D5C7, "M", "n"), - (0x1D5C8, "M", "o"), - (0x1D5C9, "M", "p"), - (0x1D5CA, "M", "q"), - (0x1D5CB, "M", "r"), - (0x1D5CC, "M", "s"), - (0x1D5CD, "M", "t"), - (0x1D5CE, "M", "u"), - (0x1D5CF, "M", "v"), - (0x1D5D0, "M", "w"), - (0x1D5D1, "M", "x"), - (0x1D5D2, "M", "y"), - (0x1D5D3, "M", "z"), - (0x1D5D4, "M", "a"), - (0x1D5D5, "M", "b"), - (0x1D5D6, "M", "c"), - (0x1D5D7, "M", "d"), - (0x1D5D8, "M", "e"), - (0x1D5D9, "M", "f"), - (0x1D5DA, "M", "g"), - (0x1D5DB, "M", "h"), - (0x1D5DC, "M", "i"), - (0x1D5DD, "M", "j"), - (0x1D5DE, "M", "k"), - (0x1D5DF, "M", "l"), - (0x1D5E0, "M", "m"), - (0x1D5E1, "M", "n"), - (0x1D5E2, "M", "o"), - (0x1D5E3, "M", "p"), - (0x1D5E4, "M", "q"), - (0x1D5E5, "M", "r"), - (0x1D5E6, "M", "s"), - (0x1D5E7, "M", "t"), - (0x1D5E8, "M", "u"), - (0x1D5E9, "M", "v"), - (0x1D5EA, "M", "w"), - (0x1D5EB, "M", "x"), - (0x1D5EC, "M", "y"), - (0x1D5ED, "M", "z"), - (0x1D5EE, "M", "a"), - (0x1D5EF, "M", "b"), - (0x1D5F0, "M", "c"), - (0x1D5F1, "M", "d"), - ] - - -def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D5F2, "M", "e"), - (0x1D5F3, "M", "f"), - (0x1D5F4, "M", "g"), - (0x1D5F5, "M", "h"), - (0x1D5F6, "M", "i"), - (0x1D5F7, "M", "j"), - (0x1D5F8, "M", "k"), - (0x1D5F9, "M", "l"), - (0x1D5FA, "M", "m"), - (0x1D5FB, "M", "n"), - (0x1D5FC, "M", "o"), - (0x1D5FD, "M", "p"), - (0x1D5FE, "M", "q"), - (0x1D5FF, "M", "r"), - (0x1D600, "M", "s"), - (0x1D601, "M", "t"), - (0x1D602, "M", "u"), - (0x1D603, "M", "v"), - (0x1D604, "M", "w"), - (0x1D605, "M", "x"), - (0x1D606, "M", "y"), - (0x1D607, "M", "z"), - (0x1D608, "M", "a"), - (0x1D609, "M", "b"), - (0x1D60A, "M", "c"), - (0x1D60B, "M", "d"), - (0x1D60C, "M", "e"), - (0x1D60D, "M", "f"), - (0x1D60E, "M", "g"), - (0x1D60F, "M", "h"), - (0x1D610, "M", "i"), - (0x1D611, "M", "j"), - (0x1D612, "M", "k"), - (0x1D613, "M", "l"), - (0x1D614, "M", "m"), - (0x1D615, "M", "n"), - (0x1D616, "M", "o"), - (0x1D617, "M", "p"), - (0x1D618, "M", "q"), - (0x1D619, "M", "r"), - (0x1D61A, "M", "s"), - (0x1D61B, "M", "t"), - (0x1D61C, "M", "u"), - (0x1D61D, "M", "v"), - (0x1D61E, "M", "w"), - (0x1D61F, "M", "x"), - (0x1D620, "M", "y"), - (0x1D621, "M", "z"), - (0x1D622, "M", "a"), - (0x1D623, "M", "b"), - (0x1D624, "M", "c"), - (0x1D625, "M", "d"), - (0x1D626, "M", "e"), - (0x1D627, "M", "f"), - (0x1D628, "M", "g"), - (0x1D629, "M", "h"), - (0x1D62A, "M", "i"), - (0x1D62B, "M", "j"), - (0x1D62C, "M", "k"), - (0x1D62D, "M", "l"), - (0x1D62E, "M", "m"), - (0x1D62F, "M", "n"), - (0x1D630, "M", "o"), - (0x1D631, "M", "p"), - (0x1D632, "M", "q"), - (0x1D633, "M", "r"), - (0x1D634, "M", "s"), - (0x1D635, "M", "t"), - (0x1D636, "M", "u"), - (0x1D637, "M", "v"), - (0x1D638, "M", "w"), - (0x1D639, "M", "x"), - (0x1D63A, "M", "y"), - (0x1D63B, "M", "z"), - (0x1D63C, "M", "a"), - (0x1D63D, "M", "b"), - (0x1D63E, "M", "c"), - (0x1D63F, "M", "d"), - (0x1D640, "M", "e"), - (0x1D641, "M", "f"), - (0x1D642, "M", "g"), - (0x1D643, "M", "h"), - (0x1D644, "M", "i"), - (0x1D645, "M", "j"), - (0x1D646, "M", "k"), - (0x1D647, "M", "l"), - (0x1D648, "M", "m"), - (0x1D649, "M", "n"), - (0x1D64A, "M", "o"), - (0x1D64B, "M", "p"), - (0x1D64C, "M", "q"), - (0x1D64D, "M", "r"), - (0x1D64E, "M", "s"), - (0x1D64F, "M", "t"), - (0x1D650, "M", "u"), - (0x1D651, "M", "v"), - (0x1D652, "M", "w"), - (0x1D653, "M", "x"), - (0x1D654, "M", "y"), - (0x1D655, "M", "z"), - ] - - -def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D656, "M", "a"), - (0x1D657, "M", "b"), - (0x1D658, "M", "c"), - (0x1D659, "M", "d"), - (0x1D65A, "M", "e"), - (0x1D65B, "M", "f"), - (0x1D65C, "M", "g"), - (0x1D65D, "M", "h"), - (0x1D65E, "M", "i"), - (0x1D65F, "M", "j"), - (0x1D660, "M", "k"), - (0x1D661, "M", "l"), - (0x1D662, "M", "m"), - (0x1D663, "M", "n"), - (0x1D664, "M", "o"), - (0x1D665, "M", "p"), - (0x1D666, "M", "q"), - (0x1D667, "M", "r"), - (0x1D668, "M", "s"), - (0x1D669, "M", "t"), - (0x1D66A, "M", "u"), - (0x1D66B, "M", "v"), - (0x1D66C, "M", "w"), - (0x1D66D, "M", "x"), - (0x1D66E, "M", "y"), - (0x1D66F, "M", "z"), - (0x1D670, "M", "a"), - (0x1D671, "M", "b"), - (0x1D672, "M", "c"), - (0x1D673, "M", "d"), - (0x1D674, "M", "e"), - (0x1D675, "M", "f"), - (0x1D676, "M", "g"), - (0x1D677, "M", "h"), - (0x1D678, "M", "i"), - (0x1D679, "M", "j"), - (0x1D67A, "M", "k"), - (0x1D67B, "M", "l"), - (0x1D67C, "M", "m"), - (0x1D67D, "M", "n"), - (0x1D67E, "M", "o"), - (0x1D67F, "M", "p"), - (0x1D680, "M", "q"), - (0x1D681, "M", "r"), - (0x1D682, "M", "s"), - (0x1D683, "M", "t"), - (0x1D684, "M", "u"), - (0x1D685, "M", "v"), - (0x1D686, "M", "w"), - (0x1D687, "M", "x"), - (0x1D688, "M", "y"), - (0x1D689, "M", "z"), - (0x1D68A, "M", "a"), - (0x1D68B, "M", "b"), - (0x1D68C, "M", "c"), - (0x1D68D, "M", "d"), - (0x1D68E, "M", "e"), - (0x1D68F, "M", "f"), - (0x1D690, "M", "g"), - (0x1D691, "M", "h"), - (0x1D692, "M", "i"), - (0x1D693, "M", "j"), - (0x1D694, "M", "k"), - (0x1D695, "M", "l"), - (0x1D696, "M", "m"), - (0x1D697, "M", "n"), - (0x1D698, "M", "o"), - (0x1D699, "M", "p"), - (0x1D69A, "M", "q"), - (0x1D69B, "M", "r"), - (0x1D69C, "M", "s"), - (0x1D69D, "M", "t"), - (0x1D69E, "M", "u"), - (0x1D69F, "M", "v"), - (0x1D6A0, "M", "w"), - (0x1D6A1, "M", "x"), - (0x1D6A2, "M", "y"), - (0x1D6A3, "M", "z"), - (0x1D6A4, "M", "ı"), - (0x1D6A5, "M", "ȷ"), - (0x1D6A6, "X"), - (0x1D6A8, "M", "α"), - (0x1D6A9, "M", "β"), - (0x1D6AA, "M", "γ"), - (0x1D6AB, "M", "δ"), - (0x1D6AC, "M", "ε"), - (0x1D6AD, "M", "ζ"), - (0x1D6AE, "M", "η"), - (0x1D6AF, "M", "θ"), - (0x1D6B0, "M", "ι"), - (0x1D6B1, "M", "κ"), - (0x1D6B2, "M", "λ"), - (0x1D6B3, "M", "μ"), - (0x1D6B4, "M", "ν"), - (0x1D6B5, "M", "ξ"), - (0x1D6B6, "M", "ο"), - (0x1D6B7, "M", "π"), - (0x1D6B8, "M", "ρ"), - (0x1D6B9, "M", "θ"), - (0x1D6BA, "M", "σ"), - ] - - -def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D6BB, "M", "τ"), - (0x1D6BC, "M", "υ"), - (0x1D6BD, "M", "φ"), - (0x1D6BE, "M", "χ"), - (0x1D6BF, "M", "ψ"), - (0x1D6C0, "M", "ω"), - (0x1D6C1, "M", "∇"), - (0x1D6C2, "M", "α"), - (0x1D6C3, "M", "β"), - (0x1D6C4, "M", "γ"), - (0x1D6C5, "M", "δ"), - (0x1D6C6, "M", "ε"), - (0x1D6C7, "M", "ζ"), - (0x1D6C8, "M", "η"), - (0x1D6C9, "M", "θ"), - (0x1D6CA, "M", "ι"), - (0x1D6CB, "M", "κ"), - (0x1D6CC, "M", "λ"), - (0x1D6CD, "M", "μ"), - (0x1D6CE, "M", "ν"), - (0x1D6CF, "M", "ξ"), - (0x1D6D0, "M", "ο"), - (0x1D6D1, "M", "π"), - (0x1D6D2, "M", "ρ"), - (0x1D6D3, "M", "σ"), - (0x1D6D5, "M", "τ"), - (0x1D6D6, "M", "υ"), - (0x1D6D7, "M", "φ"), - (0x1D6D8, "M", "χ"), - (0x1D6D9, "M", "ψ"), - (0x1D6DA, "M", "ω"), - (0x1D6DB, "M", "∂"), - (0x1D6DC, "M", "ε"), - (0x1D6DD, "M", "θ"), - (0x1D6DE, "M", "κ"), - (0x1D6DF, "M", "φ"), - (0x1D6E0, "M", "ρ"), - (0x1D6E1, "M", "π"), - (0x1D6E2, "M", "α"), - (0x1D6E3, "M", "β"), - (0x1D6E4, "M", "γ"), - (0x1D6E5, "M", "δ"), - (0x1D6E6, "M", "ε"), - (0x1D6E7, "M", "ζ"), - (0x1D6E8, "M", "η"), - (0x1D6E9, "M", "θ"), - (0x1D6EA, "M", "ι"), - (0x1D6EB, "M", "κ"), - (0x1D6EC, "M", "λ"), - (0x1D6ED, "M", "μ"), - (0x1D6EE, "M", "ν"), - (0x1D6EF, "M", "ξ"), - (0x1D6F0, "M", "ο"), - (0x1D6F1, "M", "π"), - (0x1D6F2, "M", "ρ"), - (0x1D6F3, "M", "θ"), - (0x1D6F4, "M", "σ"), - (0x1D6F5, "M", "τ"), - (0x1D6F6, "M", "υ"), - (0x1D6F7, "M", "φ"), - (0x1D6F8, "M", "χ"), - (0x1D6F9, "M", "ψ"), - (0x1D6FA, "M", "ω"), - (0x1D6FB, "M", "∇"), - (0x1D6FC, "M", "α"), - (0x1D6FD, "M", "β"), - (0x1D6FE, "M", "γ"), - (0x1D6FF, "M", "δ"), - (0x1D700, "M", "ε"), - (0x1D701, "M", "ζ"), - (0x1D702, "M", "η"), - (0x1D703, "M", "θ"), - (0x1D704, "M", "ι"), - (0x1D705, "M", "κ"), - (0x1D706, "M", "λ"), - (0x1D707, "M", "μ"), - (0x1D708, "M", "ν"), - (0x1D709, "M", "ξ"), - (0x1D70A, "M", "ο"), - (0x1D70B, "M", "π"), - (0x1D70C, "M", "ρ"), - (0x1D70D, "M", "σ"), - (0x1D70F, "M", "τ"), - (0x1D710, "M", "υ"), - (0x1D711, "M", "φ"), - (0x1D712, "M", "χ"), - (0x1D713, "M", "ψ"), - (0x1D714, "M", "ω"), - (0x1D715, "M", "∂"), - (0x1D716, "M", "ε"), - (0x1D717, "M", "θ"), - (0x1D718, "M", "κ"), - (0x1D719, "M", "φ"), - (0x1D71A, "M", "ρ"), - (0x1D71B, "M", "π"), - (0x1D71C, "M", "α"), - (0x1D71D, "M", "β"), - (0x1D71E, "M", "γ"), - (0x1D71F, "M", "δ"), - (0x1D720, "M", "ε"), - ] - - -def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D721, "M", "ζ"), - (0x1D722, "M", "η"), - (0x1D723, "M", "θ"), - (0x1D724, "M", "ι"), - (0x1D725, "M", "κ"), - (0x1D726, "M", "λ"), - (0x1D727, "M", "μ"), - (0x1D728, "M", "ν"), - (0x1D729, "M", "ξ"), - (0x1D72A, "M", "ο"), - (0x1D72B, "M", "π"), - (0x1D72C, "M", "ρ"), - (0x1D72D, "M", "θ"), - (0x1D72E, "M", "σ"), - (0x1D72F, "M", "τ"), - (0x1D730, "M", "υ"), - (0x1D731, "M", "φ"), - (0x1D732, "M", "χ"), - (0x1D733, "M", "ψ"), - (0x1D734, "M", "ω"), - (0x1D735, "M", "∇"), - (0x1D736, "M", "α"), - (0x1D737, "M", "β"), - (0x1D738, "M", "γ"), - (0x1D739, "M", "δ"), - (0x1D73A, "M", "ε"), - (0x1D73B, "M", "ζ"), - (0x1D73C, "M", "η"), - (0x1D73D, "M", "θ"), - (0x1D73E, "M", "ι"), - (0x1D73F, "M", "κ"), - (0x1D740, "M", "λ"), - (0x1D741, "M", "μ"), - (0x1D742, "M", "ν"), - (0x1D743, "M", "ξ"), - (0x1D744, "M", "ο"), - (0x1D745, "M", "π"), - (0x1D746, "M", "ρ"), - (0x1D747, "M", "σ"), - (0x1D749, "M", "τ"), - (0x1D74A, "M", "υ"), - (0x1D74B, "M", "φ"), - (0x1D74C, "M", "χ"), - (0x1D74D, "M", "ψ"), - (0x1D74E, "M", "ω"), - (0x1D74F, "M", "∂"), - (0x1D750, "M", "ε"), - (0x1D751, "M", "θ"), - (0x1D752, "M", "κ"), - (0x1D753, "M", "φ"), - (0x1D754, "M", "ρ"), - (0x1D755, "M", "π"), - (0x1D756, "M", "α"), - (0x1D757, "M", "β"), - (0x1D758, "M", "γ"), - (0x1D759, "M", "δ"), - (0x1D75A, "M", "ε"), - (0x1D75B, "M", "ζ"), - (0x1D75C, "M", "η"), - (0x1D75D, "M", "θ"), - (0x1D75E, "M", "ι"), - (0x1D75F, "M", "κ"), - (0x1D760, "M", "λ"), - (0x1D761, "M", "μ"), - (0x1D762, "M", "ν"), - (0x1D763, "M", "ξ"), - (0x1D764, "M", "ο"), - (0x1D765, "M", "π"), - (0x1D766, "M", "ρ"), - (0x1D767, "M", "θ"), - (0x1D768, "M", "σ"), - (0x1D769, "M", "τ"), - (0x1D76A, "M", "υ"), - (0x1D76B, "M", "φ"), - (0x1D76C, "M", "χ"), - (0x1D76D, "M", "ψ"), - (0x1D76E, "M", "ω"), - (0x1D76F, "M", "∇"), - (0x1D770, "M", "α"), - (0x1D771, "M", "β"), - (0x1D772, "M", "γ"), - (0x1D773, "M", "δ"), - (0x1D774, "M", "ε"), - (0x1D775, "M", "ζ"), - (0x1D776, "M", "η"), - (0x1D777, "M", "θ"), - (0x1D778, "M", "ι"), - (0x1D779, "M", "κ"), - (0x1D77A, "M", "λ"), - (0x1D77B, "M", "μ"), - (0x1D77C, "M", "ν"), - (0x1D77D, "M", "ξ"), - (0x1D77E, "M", "ο"), - (0x1D77F, "M", "π"), - (0x1D780, "M", "ρ"), - (0x1D781, "M", "σ"), - (0x1D783, "M", "τ"), - (0x1D784, "M", "υ"), - (0x1D785, "M", "φ"), - (0x1D786, "M", "χ"), - ] - - -def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D787, "M", "ψ"), - (0x1D788, "M", "ω"), - (0x1D789, "M", "∂"), - (0x1D78A, "M", "ε"), - (0x1D78B, "M", "θ"), - (0x1D78C, "M", "κ"), - (0x1D78D, "M", "φ"), - (0x1D78E, "M", "ρ"), - (0x1D78F, "M", "π"), - (0x1D790, "M", "α"), - (0x1D791, "M", "β"), - (0x1D792, "M", "γ"), - (0x1D793, "M", "δ"), - (0x1D794, "M", "ε"), - (0x1D795, "M", "ζ"), - (0x1D796, "M", "η"), - (0x1D797, "M", "θ"), - (0x1D798, "M", "ι"), - (0x1D799, "M", "κ"), - (0x1D79A, "M", "λ"), - (0x1D79B, "M", "μ"), - (0x1D79C, "M", "ν"), - (0x1D79D, "M", "ξ"), - (0x1D79E, "M", "ο"), - (0x1D79F, "M", "π"), - (0x1D7A0, "M", "ρ"), - (0x1D7A1, "M", "θ"), - (0x1D7A2, "M", "σ"), - (0x1D7A3, "M", "τ"), - (0x1D7A4, "M", "υ"), - (0x1D7A5, "M", "φ"), - (0x1D7A6, "M", "χ"), - (0x1D7A7, "M", "ψ"), - (0x1D7A8, "M", "ω"), - (0x1D7A9, "M", "∇"), - (0x1D7AA, "M", "α"), - (0x1D7AB, "M", "β"), - (0x1D7AC, "M", "γ"), - (0x1D7AD, "M", "δ"), - (0x1D7AE, "M", "ε"), - (0x1D7AF, "M", "ζ"), - (0x1D7B0, "M", "η"), - (0x1D7B1, "M", "θ"), - (0x1D7B2, "M", "ι"), - (0x1D7B3, "M", "κ"), - (0x1D7B4, "M", "λ"), - (0x1D7B5, "M", "μ"), - (0x1D7B6, "M", "ν"), - (0x1D7B7, "M", "ξ"), - (0x1D7B8, "M", "ο"), - (0x1D7B9, "M", "π"), - (0x1D7BA, "M", "ρ"), - (0x1D7BB, "M", "σ"), - (0x1D7BD, "M", "τ"), - (0x1D7BE, "M", "υ"), - (0x1D7BF, "M", "φ"), - (0x1D7C0, "M", "χ"), - (0x1D7C1, "M", "ψ"), - (0x1D7C2, "M", "ω"), - (0x1D7C3, "M", "∂"), - (0x1D7C4, "M", "ε"), - (0x1D7C5, "M", "θ"), - (0x1D7C6, "M", "κ"), - (0x1D7C7, "M", "φ"), - (0x1D7C8, "M", "ρ"), - (0x1D7C9, "M", "π"), - (0x1D7CA, "M", "ϝ"), - (0x1D7CC, "X"), - (0x1D7CE, "M", "0"), - (0x1D7CF, "M", "1"), - (0x1D7D0, "M", "2"), - (0x1D7D1, "M", "3"), - (0x1D7D2, "M", "4"), - (0x1D7D3, "M", "5"), - (0x1D7D4, "M", "6"), - (0x1D7D5, "M", "7"), - (0x1D7D6, "M", "8"), - (0x1D7D7, "M", "9"), - (0x1D7D8, "M", "0"), - (0x1D7D9, "M", "1"), - (0x1D7DA, "M", "2"), - (0x1D7DB, "M", "3"), - (0x1D7DC, "M", "4"), - (0x1D7DD, "M", "5"), - (0x1D7DE, "M", "6"), - (0x1D7DF, "M", "7"), - (0x1D7E0, "M", "8"), - (0x1D7E1, "M", "9"), - (0x1D7E2, "M", "0"), - (0x1D7E3, "M", "1"), - (0x1D7E4, "M", "2"), - (0x1D7E5, "M", "3"), - (0x1D7E6, "M", "4"), - (0x1D7E7, "M", "5"), - (0x1D7E8, "M", "6"), - (0x1D7E9, "M", "7"), - (0x1D7EA, "M", "8"), - (0x1D7EB, "M", "9"), - (0x1D7EC, "M", "0"), - (0x1D7ED, "M", "1"), - ] - - -def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1D7EE, "M", "2"), - (0x1D7EF, "M", "3"), - (0x1D7F0, "M", "4"), - (0x1D7F1, "M", "5"), - (0x1D7F2, "M", "6"), - (0x1D7F3, "M", "7"), - (0x1D7F4, "M", "8"), - (0x1D7F5, "M", "9"), - (0x1D7F6, "M", "0"), - (0x1D7F7, "M", "1"), - (0x1D7F8, "M", "2"), - (0x1D7F9, "M", "3"), - (0x1D7FA, "M", "4"), - (0x1D7FB, "M", "5"), - (0x1D7FC, "M", "6"), - (0x1D7FD, "M", "7"), - (0x1D7FE, "M", "8"), - (0x1D7FF, "M", "9"), - (0x1D800, "V"), - (0x1DA8C, "X"), - (0x1DA9B, "V"), - (0x1DAA0, "X"), - (0x1DAA1, "V"), - (0x1DAB0, "X"), - (0x1DF00, "V"), - (0x1DF1F, "X"), - (0x1DF25, "V"), - (0x1DF2B, "X"), - (0x1E000, "V"), - (0x1E007, "X"), - (0x1E008, "V"), - (0x1E019, "X"), - (0x1E01B, "V"), - (0x1E022, "X"), - (0x1E023, "V"), - (0x1E025, "X"), - (0x1E026, "V"), - (0x1E02B, "X"), - (0x1E030, "M", "а"), - (0x1E031, "M", "б"), - (0x1E032, "M", "в"), - (0x1E033, "M", "г"), - (0x1E034, "M", "д"), - (0x1E035, "M", "е"), - (0x1E036, "M", "ж"), - (0x1E037, "M", "з"), - (0x1E038, "M", "и"), - (0x1E039, "M", "к"), - (0x1E03A, "M", "л"), - (0x1E03B, "M", "м"), - (0x1E03C, "M", "о"), - (0x1E03D, "M", "п"), - (0x1E03E, "M", "р"), - (0x1E03F, "M", "с"), - (0x1E040, "M", "т"), - (0x1E041, "M", "у"), - (0x1E042, "M", "ф"), - (0x1E043, "M", "х"), - (0x1E044, "M", "ц"), - (0x1E045, "M", "ч"), - (0x1E046, "M", "ш"), - (0x1E047, "M", "ы"), - (0x1E048, "M", "э"), - (0x1E049, "M", "ю"), - (0x1E04A, "M", "ꚉ"), - (0x1E04B, "M", "ә"), - (0x1E04C, "M", "і"), - (0x1E04D, "M", "ј"), - (0x1E04E, "M", "ө"), - (0x1E04F, "M", "ү"), - (0x1E050, "M", "ӏ"), - (0x1E051, "M", "а"), - (0x1E052, "M", "б"), - (0x1E053, "M", "в"), - (0x1E054, "M", "г"), - (0x1E055, "M", "д"), - (0x1E056, "M", "е"), - (0x1E057, "M", "ж"), - (0x1E058, "M", "з"), - (0x1E059, "M", "и"), - (0x1E05A, "M", "к"), - (0x1E05B, "M", "л"), - (0x1E05C, "M", "о"), - (0x1E05D, "M", "п"), - (0x1E05E, "M", "с"), - (0x1E05F, "M", "у"), - (0x1E060, "M", "ф"), - (0x1E061, "M", "х"), - (0x1E062, "M", "ц"), - (0x1E063, "M", "ч"), - (0x1E064, "M", "ш"), - (0x1E065, "M", "ъ"), - (0x1E066, "M", "ы"), - (0x1E067, "M", "ґ"), - (0x1E068, "M", "і"), - (0x1E069, "M", "ѕ"), - (0x1E06A, "M", "џ"), - (0x1E06B, "M", "ҫ"), - (0x1E06C, "M", "ꙑ"), - (0x1E06D, "M", "ұ"), - ] - - -def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1E06E, "X"), - (0x1E08F, "V"), - (0x1E090, "X"), - (0x1E100, "V"), - (0x1E12D, "X"), - (0x1E130, "V"), - (0x1E13E, "X"), - (0x1E140, "V"), - (0x1E14A, "X"), - (0x1E14E, "V"), - (0x1E150, "X"), - (0x1E290, "V"), - (0x1E2AF, "X"), - (0x1E2C0, "V"), - (0x1E2FA, "X"), - (0x1E2FF, "V"), - (0x1E300, "X"), - (0x1E4D0, "V"), - (0x1E4FA, "X"), - (0x1E5D0, "V"), - (0x1E5FB, "X"), - (0x1E5FF, "V"), - (0x1E600, "X"), - (0x1E7E0, "V"), - (0x1E7E7, "X"), - (0x1E7E8, "V"), - (0x1E7EC, "X"), - (0x1E7ED, "V"), - (0x1E7EF, "X"), - (0x1E7F0, "V"), - (0x1E7FF, "X"), - (0x1E800, "V"), - (0x1E8C5, "X"), - (0x1E8C7, "V"), - (0x1E8D7, "X"), - (0x1E900, "M", "𞤢"), - (0x1E901, "M", "𞤣"), - (0x1E902, "M", "𞤤"), - (0x1E903, "M", "𞤥"), - (0x1E904, "M", "𞤦"), - (0x1E905, "M", "𞤧"), - (0x1E906, "M", "𞤨"), - (0x1E907, "M", "𞤩"), - (0x1E908, "M", "𞤪"), - (0x1E909, "M", "𞤫"), - (0x1E90A, "M", "𞤬"), - (0x1E90B, "M", "𞤭"), - (0x1E90C, "M", "𞤮"), - (0x1E90D, "M", "𞤯"), - (0x1E90E, "M", "𞤰"), - (0x1E90F, "M", "𞤱"), - (0x1E910, "M", "𞤲"), - (0x1E911, "M", "𞤳"), - (0x1E912, "M", "𞤴"), - (0x1E913, "M", "𞤵"), - (0x1E914, "M", "𞤶"), - (0x1E915, "M", "𞤷"), - (0x1E916, "M", "𞤸"), - (0x1E917, "M", "𞤹"), - (0x1E918, "M", "𞤺"), - (0x1E919, "M", "𞤻"), - (0x1E91A, "M", "𞤼"), - (0x1E91B, "M", "𞤽"), - (0x1E91C, "M", "𞤾"), - (0x1E91D, "M", "𞤿"), - (0x1E91E, "M", "𞥀"), - (0x1E91F, "M", "𞥁"), - (0x1E920, "M", "𞥂"), - (0x1E921, "M", "𞥃"), - (0x1E922, "V"), - (0x1E94C, "X"), - (0x1E950, "V"), - (0x1E95A, "X"), - (0x1E95E, "V"), - (0x1E960, "X"), - (0x1EC71, "V"), - (0x1ECB5, "X"), - (0x1ED01, "V"), - (0x1ED3E, "X"), - (0x1EE00, "M", "ا"), - (0x1EE01, "M", "ب"), - (0x1EE02, "M", "ج"), - (0x1EE03, "M", "د"), - (0x1EE04, "X"), - (0x1EE05, "M", "و"), - (0x1EE06, "M", "ز"), - (0x1EE07, "M", "ح"), - (0x1EE08, "M", "ط"), - (0x1EE09, "M", "ي"), - (0x1EE0A, "M", "ك"), - (0x1EE0B, "M", "ل"), - (0x1EE0C, "M", "م"), - (0x1EE0D, "M", "ن"), - (0x1EE0E, "M", "س"), - (0x1EE0F, "M", "ع"), - (0x1EE10, "M", "ف"), - (0x1EE11, "M", "ص"), - (0x1EE12, "M", "ق"), - (0x1EE13, "M", "ر"), - (0x1EE14, "M", "ش"), - ] - - -def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1EE15, "M", "ت"), - (0x1EE16, "M", "ث"), - (0x1EE17, "M", "خ"), - (0x1EE18, "M", "ذ"), - (0x1EE19, "M", "ض"), - (0x1EE1A, "M", "ظ"), - (0x1EE1B, "M", "غ"), - (0x1EE1C, "M", "ٮ"), - (0x1EE1D, "M", "ں"), - (0x1EE1E, "M", "ڡ"), - (0x1EE1F, "M", "ٯ"), - (0x1EE20, "X"), - (0x1EE21, "M", "ب"), - (0x1EE22, "M", "ج"), - (0x1EE23, "X"), - (0x1EE24, "M", "ه"), - (0x1EE25, "X"), - (0x1EE27, "M", "ح"), - (0x1EE28, "X"), - (0x1EE29, "M", "ي"), - (0x1EE2A, "M", "ك"), - (0x1EE2B, "M", "ل"), - (0x1EE2C, "M", "م"), - (0x1EE2D, "M", "ن"), - (0x1EE2E, "M", "س"), - (0x1EE2F, "M", "ع"), - (0x1EE30, "M", "ف"), - (0x1EE31, "M", "ص"), - (0x1EE32, "M", "ق"), - (0x1EE33, "X"), - (0x1EE34, "M", "ش"), - (0x1EE35, "M", "ت"), - (0x1EE36, "M", "ث"), - (0x1EE37, "M", "خ"), - (0x1EE38, "X"), - (0x1EE39, "M", "ض"), - (0x1EE3A, "X"), - (0x1EE3B, "M", "غ"), - (0x1EE3C, "X"), - (0x1EE42, "M", "ج"), - (0x1EE43, "X"), - (0x1EE47, "M", "ح"), - (0x1EE48, "X"), - (0x1EE49, "M", "ي"), - (0x1EE4A, "X"), - (0x1EE4B, "M", "ل"), - (0x1EE4C, "X"), - (0x1EE4D, "M", "ن"), - (0x1EE4E, "M", "س"), - (0x1EE4F, "M", "ع"), - (0x1EE50, "X"), - (0x1EE51, "M", "ص"), - (0x1EE52, "M", "ق"), - (0x1EE53, "X"), - (0x1EE54, "M", "ش"), - (0x1EE55, "X"), - (0x1EE57, "M", "خ"), - (0x1EE58, "X"), - (0x1EE59, "M", "ض"), - (0x1EE5A, "X"), - (0x1EE5B, "M", "غ"), - (0x1EE5C, "X"), - (0x1EE5D, "M", "ں"), - (0x1EE5E, "X"), - (0x1EE5F, "M", "ٯ"), - (0x1EE60, "X"), - (0x1EE61, "M", "ب"), - (0x1EE62, "M", "ج"), - (0x1EE63, "X"), - (0x1EE64, "M", "ه"), - (0x1EE65, "X"), - (0x1EE67, "M", "ح"), - (0x1EE68, "M", "ط"), - (0x1EE69, "M", "ي"), - (0x1EE6A, "M", "ك"), - (0x1EE6B, "X"), - (0x1EE6C, "M", "م"), - (0x1EE6D, "M", "ن"), - (0x1EE6E, "M", "س"), - (0x1EE6F, "M", "ع"), - (0x1EE70, "M", "ف"), - (0x1EE71, "M", "ص"), - (0x1EE72, "M", "ق"), - (0x1EE73, "X"), - (0x1EE74, "M", "ش"), - (0x1EE75, "M", "ت"), - (0x1EE76, "M", "ث"), - (0x1EE77, "M", "خ"), - (0x1EE78, "X"), - (0x1EE79, "M", "ض"), - (0x1EE7A, "M", "ظ"), - (0x1EE7B, "M", "غ"), - (0x1EE7C, "M", "ٮ"), - (0x1EE7D, "X"), - (0x1EE7E, "M", "ڡ"), - (0x1EE7F, "X"), - (0x1EE80, "M", "ا"), - (0x1EE81, "M", "ب"), - (0x1EE82, "M", "ج"), - (0x1EE83, "M", "د"), - ] - - -def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1EE84, "M", "ه"), - (0x1EE85, "M", "و"), - (0x1EE86, "M", "ز"), - (0x1EE87, "M", "ح"), - (0x1EE88, "M", "ط"), - (0x1EE89, "M", "ي"), - (0x1EE8A, "X"), - (0x1EE8B, "M", "ل"), - (0x1EE8C, "M", "م"), - (0x1EE8D, "M", "ن"), - (0x1EE8E, "M", "س"), - (0x1EE8F, "M", "ع"), - (0x1EE90, "M", "ف"), - (0x1EE91, "M", "ص"), - (0x1EE92, "M", "ق"), - (0x1EE93, "M", "ر"), - (0x1EE94, "M", "ش"), - (0x1EE95, "M", "ت"), - (0x1EE96, "M", "ث"), - (0x1EE97, "M", "خ"), - (0x1EE98, "M", "ذ"), - (0x1EE99, "M", "ض"), - (0x1EE9A, "M", "ظ"), - (0x1EE9B, "M", "غ"), - (0x1EE9C, "X"), - (0x1EEA1, "M", "ب"), - (0x1EEA2, "M", "ج"), - (0x1EEA3, "M", "د"), - (0x1EEA4, "X"), - (0x1EEA5, "M", "و"), - (0x1EEA6, "M", "ز"), - (0x1EEA7, "M", "ح"), - (0x1EEA8, "M", "ط"), - (0x1EEA9, "M", "ي"), - (0x1EEAA, "X"), - (0x1EEAB, "M", "ل"), - (0x1EEAC, "M", "م"), - (0x1EEAD, "M", "ن"), - (0x1EEAE, "M", "س"), - (0x1EEAF, "M", "ع"), - (0x1EEB0, "M", "ف"), - (0x1EEB1, "M", "ص"), - (0x1EEB2, "M", "ق"), - (0x1EEB3, "M", "ر"), - (0x1EEB4, "M", "ش"), - (0x1EEB5, "M", "ت"), - (0x1EEB6, "M", "ث"), - (0x1EEB7, "M", "خ"), - (0x1EEB8, "M", "ذ"), - (0x1EEB9, "M", "ض"), - (0x1EEBA, "M", "ظ"), - (0x1EEBB, "M", "غ"), - (0x1EEBC, "X"), - (0x1EEF0, "V"), - (0x1EEF2, "X"), - (0x1F000, "V"), - (0x1F02C, "X"), - (0x1F030, "V"), - (0x1F094, "X"), - (0x1F0A0, "V"), - (0x1F0AF, "X"), - (0x1F0B1, "V"), - (0x1F0C0, "X"), - (0x1F0C1, "V"), - (0x1F0D0, "X"), - (0x1F0D1, "V"), - (0x1F0F6, "X"), - (0x1F101, "M", "0,"), - (0x1F102, "M", "1,"), - (0x1F103, "M", "2,"), - (0x1F104, "M", "3,"), - (0x1F105, "M", "4,"), - (0x1F106, "M", "5,"), - (0x1F107, "M", "6,"), - (0x1F108, "M", "7,"), - (0x1F109, "M", "8,"), - (0x1F10A, "M", "9,"), - (0x1F10B, "V"), - (0x1F110, "M", "(a)"), - (0x1F111, "M", "(b)"), - (0x1F112, "M", "(c)"), - (0x1F113, "M", "(d)"), - (0x1F114, "M", "(e)"), - (0x1F115, "M", "(f)"), - (0x1F116, "M", "(g)"), - (0x1F117, "M", "(h)"), - (0x1F118, "M", "(i)"), - (0x1F119, "M", "(j)"), - (0x1F11A, "M", "(k)"), - (0x1F11B, "M", "(l)"), - (0x1F11C, "M", "(m)"), - (0x1F11D, "M", "(n)"), - (0x1F11E, "M", "(o)"), - (0x1F11F, "M", "(p)"), - (0x1F120, "M", "(q)"), - (0x1F121, "M", "(r)"), - (0x1F122, "M", "(s)"), - (0x1F123, "M", "(t)"), - (0x1F124, "M", "(u)"), - (0x1F125, "M", "(v)"), - ] - - -def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1F126, "M", "(w)"), - (0x1F127, "M", "(x)"), - (0x1F128, "M", "(y)"), - (0x1F129, "M", "(z)"), - (0x1F12A, "M", "〔s〕"), - (0x1F12B, "M", "c"), - (0x1F12C, "M", "r"), - (0x1F12D, "M", "cd"), - (0x1F12E, "M", "wz"), - (0x1F12F, "V"), - (0x1F130, "M", "a"), - (0x1F131, "M", "b"), - (0x1F132, "M", "c"), - (0x1F133, "M", "d"), - (0x1F134, "M", "e"), - (0x1F135, "M", "f"), - (0x1F136, "M", "g"), - (0x1F137, "M", "h"), - (0x1F138, "M", "i"), - (0x1F139, "M", "j"), - (0x1F13A, "M", "k"), - (0x1F13B, "M", "l"), - (0x1F13C, "M", "m"), - (0x1F13D, "M", "n"), - (0x1F13E, "M", "o"), - (0x1F13F, "M", "p"), - (0x1F140, "M", "q"), - (0x1F141, "M", "r"), - (0x1F142, "M", "s"), - (0x1F143, "M", "t"), - (0x1F144, "M", "u"), - (0x1F145, "M", "v"), - (0x1F146, "M", "w"), - (0x1F147, "M", "x"), - (0x1F148, "M", "y"), - (0x1F149, "M", "z"), - (0x1F14A, "M", "hv"), - (0x1F14B, "M", "mv"), - (0x1F14C, "M", "sd"), - (0x1F14D, "M", "ss"), - (0x1F14E, "M", "ppv"), - (0x1F14F, "M", "wc"), - (0x1F150, "V"), - (0x1F16A, "M", "mc"), - (0x1F16B, "M", "md"), - (0x1F16C, "M", "mr"), - (0x1F16D, "V"), - (0x1F190, "M", "dj"), - (0x1F191, "V"), - (0x1F1AE, "X"), - (0x1F1E6, "V"), - (0x1F200, "M", "ほか"), - (0x1F201, "M", "ココ"), - (0x1F202, "M", "サ"), - (0x1F203, "X"), - (0x1F210, "M", "手"), - (0x1F211, "M", "字"), - (0x1F212, "M", "双"), - (0x1F213, "M", "デ"), - (0x1F214, "M", "二"), - (0x1F215, "M", "多"), - (0x1F216, "M", "解"), - (0x1F217, "M", "天"), - (0x1F218, "M", "交"), - (0x1F219, "M", "映"), - (0x1F21A, "M", "無"), - (0x1F21B, "M", "料"), - (0x1F21C, "M", "前"), - (0x1F21D, "M", "後"), - (0x1F21E, "M", "再"), - (0x1F21F, "M", "新"), - (0x1F220, "M", "初"), - (0x1F221, "M", "終"), - (0x1F222, "M", "生"), - (0x1F223, "M", "販"), - (0x1F224, "M", "声"), - (0x1F225, "M", "吹"), - (0x1F226, "M", "演"), - (0x1F227, "M", "投"), - (0x1F228, "M", "捕"), - (0x1F229, "M", "一"), - (0x1F22A, "M", "三"), - (0x1F22B, "M", "遊"), - (0x1F22C, "M", "左"), - (0x1F22D, "M", "中"), - (0x1F22E, "M", "右"), - (0x1F22F, "M", "指"), - (0x1F230, "M", "走"), - (0x1F231, "M", "打"), - (0x1F232, "M", "禁"), - (0x1F233, "M", "空"), - (0x1F234, "M", "合"), - (0x1F235, "M", "満"), - (0x1F236, "M", "有"), - (0x1F237, "M", "月"), - (0x1F238, "M", "申"), - (0x1F239, "M", "割"), - (0x1F23A, "M", "営"), - (0x1F23B, "M", "配"), - (0x1F23C, "X"), - ] - - -def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x1F240, "M", "〔本〕"), - (0x1F241, "M", "〔三〕"), - (0x1F242, "M", "〔二〕"), - (0x1F243, "M", "〔安〕"), - (0x1F244, "M", "〔点〕"), - (0x1F245, "M", "〔打〕"), - (0x1F246, "M", "〔盗〕"), - (0x1F247, "M", "〔勝〕"), - (0x1F248, "M", "〔敗〕"), - (0x1F249, "X"), - (0x1F250, "M", "得"), - (0x1F251, "M", "可"), - (0x1F252, "X"), - (0x1F260, "V"), - (0x1F266, "X"), - (0x1F300, "V"), - (0x1F6D8, "X"), - (0x1F6DC, "V"), - (0x1F6ED, "X"), - (0x1F6F0, "V"), - (0x1F6FD, "X"), - (0x1F700, "V"), - (0x1F777, "X"), - (0x1F77B, "V"), - (0x1F7DA, "X"), - (0x1F7E0, "V"), - (0x1F7EC, "X"), - (0x1F7F0, "V"), - (0x1F7F1, "X"), - (0x1F800, "V"), - (0x1F80C, "X"), - (0x1F810, "V"), - (0x1F848, "X"), - (0x1F850, "V"), - (0x1F85A, "X"), - (0x1F860, "V"), - (0x1F888, "X"), - (0x1F890, "V"), - (0x1F8AE, "X"), - (0x1F8B0, "V"), - (0x1F8BC, "X"), - (0x1F8C0, "V"), - (0x1F8C2, "X"), - (0x1F900, "V"), - (0x1FA54, "X"), - (0x1FA60, "V"), - (0x1FA6E, "X"), - (0x1FA70, "V"), - (0x1FA7D, "X"), - (0x1FA80, "V"), - (0x1FA8A, "X"), - (0x1FA8F, "V"), - (0x1FAC7, "X"), - (0x1FACE, "V"), - (0x1FADD, "X"), - (0x1FADF, "V"), - (0x1FAEA, "X"), - (0x1FAF0, "V"), - (0x1FAF9, "X"), - (0x1FB00, "V"), - (0x1FB93, "X"), - (0x1FB94, "V"), - (0x1FBF0, "M", "0"), - (0x1FBF1, "M", "1"), - (0x1FBF2, "M", "2"), - (0x1FBF3, "M", "3"), - (0x1FBF4, "M", "4"), - (0x1FBF5, "M", "5"), - (0x1FBF6, "M", "6"), - (0x1FBF7, "M", "7"), - (0x1FBF8, "M", "8"), - (0x1FBF9, "M", "9"), - (0x1FBFA, "X"), - (0x20000, "V"), - (0x2A6E0, "X"), - (0x2A700, "V"), - (0x2B73A, "X"), - (0x2B740, "V"), - (0x2B81E, "X"), - (0x2B820, "V"), - (0x2CEA2, "X"), - (0x2CEB0, "V"), - (0x2EBE1, "X"), - (0x2EBF0, "V"), - (0x2EE5E, "X"), - (0x2F800, "M", "丽"), - (0x2F801, "M", "丸"), - (0x2F802, "M", "乁"), - (0x2F803, "M", "𠄢"), - (0x2F804, "M", "你"), - (0x2F805, "M", "侮"), - (0x2F806, "M", "侻"), - (0x2F807, "M", "倂"), - (0x2F808, "M", "偺"), - (0x2F809, "M", "備"), - (0x2F80A, "M", "僧"), - (0x2F80B, "M", "像"), - (0x2F80C, "M", "㒞"), - (0x2F80D, "M", "𠘺"), - (0x2F80E, "M", "免"), - ] - - -def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2F80F, "M", "兔"), - (0x2F810, "M", "兤"), - (0x2F811, "M", "具"), - (0x2F812, "M", "𠔜"), - (0x2F813, "M", "㒹"), - (0x2F814, "M", "內"), - (0x2F815, "M", "再"), - (0x2F816, "M", "𠕋"), - (0x2F817, "M", "冗"), - (0x2F818, "M", "冤"), - (0x2F819, "M", "仌"), - (0x2F81A, "M", "冬"), - (0x2F81B, "M", "况"), - (0x2F81C, "M", "𩇟"), - (0x2F81D, "M", "凵"), - (0x2F81E, "M", "刃"), - (0x2F81F, "M", "㓟"), - (0x2F820, "M", "刻"), - (0x2F821, "M", "剆"), - (0x2F822, "M", "割"), - (0x2F823, "M", "剷"), - (0x2F824, "M", "㔕"), - (0x2F825, "M", "勇"), - (0x2F826, "M", "勉"), - (0x2F827, "M", "勤"), - (0x2F828, "M", "勺"), - (0x2F829, "M", "包"), - (0x2F82A, "M", "匆"), - (0x2F82B, "M", "北"), - (0x2F82C, "M", "卉"), - (0x2F82D, "M", "卑"), - (0x2F82E, "M", "博"), - (0x2F82F, "M", "即"), - (0x2F830, "M", "卽"), - (0x2F831, "M", "卿"), - (0x2F834, "M", "𠨬"), - (0x2F835, "M", "灰"), - (0x2F836, "M", "及"), - (0x2F837, "M", "叟"), - (0x2F838, "M", "𠭣"), - (0x2F839, "M", "叫"), - (0x2F83A, "M", "叱"), - (0x2F83B, "M", "吆"), - (0x2F83C, "M", "咞"), - (0x2F83D, "M", "吸"), - (0x2F83E, "M", "呈"), - (0x2F83F, "M", "周"), - (0x2F840, "M", "咢"), - (0x2F841, "M", "哶"), - (0x2F842, "M", "唐"), - (0x2F843, "M", "啓"), - (0x2F844, "M", "啣"), - (0x2F845, "M", "善"), - (0x2F847, "M", "喙"), - (0x2F848, "M", "喫"), - (0x2F849, "M", "喳"), - (0x2F84A, "M", "嗂"), - (0x2F84B, "M", "圖"), - (0x2F84C, "M", "嘆"), - (0x2F84D, "M", "圗"), - (0x2F84E, "M", "噑"), - (0x2F84F, "M", "噴"), - (0x2F850, "M", "切"), - (0x2F851, "M", "壮"), - (0x2F852, "M", "城"), - (0x2F853, "M", "埴"), - (0x2F854, "M", "堍"), - (0x2F855, "M", "型"), - (0x2F856, "M", "堲"), - (0x2F857, "M", "報"), - (0x2F858, "M", "墬"), - (0x2F859, "M", "𡓤"), - (0x2F85A, "M", "売"), - (0x2F85B, "M", "壷"), - (0x2F85C, "M", "夆"), - (0x2F85D, "M", "多"), - (0x2F85E, "M", "夢"), - (0x2F85F, "M", "奢"), - (0x2F860, "M", "𡚨"), - (0x2F861, "M", "𡛪"), - (0x2F862, "M", "姬"), - (0x2F863, "M", "娛"), - (0x2F864, "M", "娧"), - (0x2F865, "M", "姘"), - (0x2F866, "M", "婦"), - (0x2F867, "M", "㛮"), - (0x2F868, "M", "㛼"), - (0x2F869, "M", "嬈"), - (0x2F86A, "M", "嬾"), - (0x2F86C, "M", "𡧈"), - (0x2F86D, "M", "寃"), - (0x2F86E, "M", "寘"), - (0x2F86F, "M", "寧"), - (0x2F870, "M", "寳"), - (0x2F871, "M", "𡬘"), - (0x2F872, "M", "寿"), - (0x2F873, "M", "将"), - (0x2F874, "M", "当"), - (0x2F875, "M", "尢"), - (0x2F876, "M", "㞁"), - ] - - -def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2F877, "M", "屠"), - (0x2F878, "M", "屮"), - (0x2F879, "M", "峀"), - (0x2F87A, "M", "岍"), - (0x2F87B, "M", "𡷤"), - (0x2F87C, "M", "嵃"), - (0x2F87D, "M", "𡷦"), - (0x2F87E, "M", "嵮"), - (0x2F87F, "M", "嵫"), - (0x2F880, "M", "嵼"), - (0x2F881, "M", "巡"), - (0x2F882, "M", "巢"), - (0x2F883, "M", "㠯"), - (0x2F884, "M", "巽"), - (0x2F885, "M", "帨"), - (0x2F886, "M", "帽"), - (0x2F887, "M", "幩"), - (0x2F888, "M", "㡢"), - (0x2F889, "M", "𢆃"), - (0x2F88A, "M", "㡼"), - (0x2F88B, "M", "庰"), - (0x2F88C, "M", "庳"), - (0x2F88D, "M", "庶"), - (0x2F88E, "M", "廊"), - (0x2F88F, "M", "𪎒"), - (0x2F890, "M", "廾"), - (0x2F891, "M", "𢌱"), - (0x2F893, "M", "舁"), - (0x2F894, "M", "弢"), - (0x2F896, "M", "㣇"), - (0x2F897, "M", "𣊸"), - (0x2F898, "M", "𦇚"), - (0x2F899, "M", "形"), - (0x2F89A, "M", "彫"), - (0x2F89B, "M", "㣣"), - (0x2F89C, "M", "徚"), - (0x2F89D, "M", "忍"), - (0x2F89E, "M", "志"), - (0x2F89F, "M", "忹"), - (0x2F8A0, "M", "悁"), - (0x2F8A1, "M", "㤺"), - (0x2F8A2, "M", "㤜"), - (0x2F8A3, "M", "悔"), - (0x2F8A4, "M", "𢛔"), - (0x2F8A5, "M", "惇"), - (0x2F8A6, "M", "慈"), - (0x2F8A7, "M", "慌"), - (0x2F8A8, "M", "慎"), - (0x2F8A9, "M", "慌"), - (0x2F8AA, "M", "慺"), - (0x2F8AB, "M", "憎"), - (0x2F8AC, "M", "憲"), - (0x2F8AD, "M", "憤"), - (0x2F8AE, "M", "憯"), - (0x2F8AF, "M", "懞"), - (0x2F8B0, "M", "懲"), - (0x2F8B1, "M", "懶"), - (0x2F8B2, "M", "成"), - (0x2F8B3, "M", "戛"), - (0x2F8B4, "M", "扝"), - (0x2F8B5, "M", "抱"), - (0x2F8B6, "M", "拔"), - (0x2F8B7, "M", "捐"), - (0x2F8B8, "M", "𢬌"), - (0x2F8B9, "M", "挽"), - (0x2F8BA, "M", "拼"), - (0x2F8BB, "M", "捨"), - (0x2F8BC, "M", "掃"), - (0x2F8BD, "M", "揤"), - (0x2F8BE, "M", "𢯱"), - (0x2F8BF, "M", "搢"), - (0x2F8C0, "M", "揅"), - (0x2F8C1, "M", "掩"), - (0x2F8C2, "M", "㨮"), - (0x2F8C3, "M", "摩"), - (0x2F8C4, "M", "摾"), - (0x2F8C5, "M", "撝"), - (0x2F8C6, "M", "摷"), - (0x2F8C7, "M", "㩬"), - (0x2F8C8, "M", "敏"), - (0x2F8C9, "M", "敬"), - (0x2F8CA, "M", "𣀊"), - (0x2F8CB, "M", "旣"), - (0x2F8CC, "M", "書"), - (0x2F8CD, "M", "晉"), - (0x2F8CE, "M", "㬙"), - (0x2F8CF, "M", "暑"), - (0x2F8D0, "M", "㬈"), - (0x2F8D1, "M", "㫤"), - (0x2F8D2, "M", "冒"), - (0x2F8D3, "M", "冕"), - (0x2F8D4, "M", "最"), - (0x2F8D5, "M", "暜"), - (0x2F8D6, "M", "肭"), - (0x2F8D7, "M", "䏙"), - (0x2F8D8, "M", "朗"), - (0x2F8D9, "M", "望"), - (0x2F8DA, "M", "朡"), - (0x2F8DB, "M", "杞"), - (0x2F8DC, "M", "杓"), - ] - - -def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2F8DD, "M", "𣏃"), - (0x2F8DE, "M", "㭉"), - (0x2F8DF, "M", "柺"), - (0x2F8E0, "M", "枅"), - (0x2F8E1, "M", "桒"), - (0x2F8E2, "M", "梅"), - (0x2F8E3, "M", "𣑭"), - (0x2F8E4, "M", "梎"), - (0x2F8E5, "M", "栟"), - (0x2F8E6, "M", "椔"), - (0x2F8E7, "M", "㮝"), - (0x2F8E8, "M", "楂"), - (0x2F8E9, "M", "榣"), - (0x2F8EA, "M", "槪"), - (0x2F8EB, "M", "檨"), - (0x2F8EC, "M", "𣚣"), - (0x2F8ED, "M", "櫛"), - (0x2F8EE, "M", "㰘"), - (0x2F8EF, "M", "次"), - (0x2F8F0, "M", "𣢧"), - (0x2F8F1, "M", "歔"), - (0x2F8F2, "M", "㱎"), - (0x2F8F3, "M", "歲"), - (0x2F8F4, "M", "殟"), - (0x2F8F5, "M", "殺"), - (0x2F8F6, "M", "殻"), - (0x2F8F7, "M", "𣪍"), - (0x2F8F8, "M", "𡴋"), - (0x2F8F9, "M", "𣫺"), - (0x2F8FA, "M", "汎"), - (0x2F8FB, "M", "𣲼"), - (0x2F8FC, "M", "沿"), - (0x2F8FD, "M", "泍"), - (0x2F8FE, "M", "汧"), - (0x2F8FF, "M", "洖"), - (0x2F900, "M", "派"), - (0x2F901, "M", "海"), - (0x2F902, "M", "流"), - (0x2F903, "M", "浩"), - (0x2F904, "M", "浸"), - (0x2F905, "M", "涅"), - (0x2F906, "M", "𣴞"), - (0x2F907, "M", "洴"), - (0x2F908, "M", "港"), - (0x2F909, "M", "湮"), - (0x2F90A, "M", "㴳"), - (0x2F90B, "M", "滋"), - (0x2F90C, "M", "滇"), - (0x2F90D, "M", "𣻑"), - (0x2F90E, "M", "淹"), - (0x2F90F, "M", "潮"), - (0x2F910, "M", "𣽞"), - (0x2F911, "M", "𣾎"), - (0x2F912, "M", "濆"), - (0x2F913, "M", "瀹"), - (0x2F914, "M", "瀞"), - (0x2F915, "M", "瀛"), - (0x2F916, "M", "㶖"), - (0x2F917, "M", "灊"), - (0x2F918, "M", "災"), - (0x2F919, "M", "灷"), - (0x2F91A, "M", "炭"), - (0x2F91B, "M", "𠔥"), - (0x2F91C, "M", "煅"), - (0x2F91D, "M", "𤉣"), - (0x2F91E, "M", "熜"), - (0x2F91F, "M", "𤎫"), - (0x2F920, "M", "爨"), - (0x2F921, "M", "爵"), - (0x2F922, "M", "牐"), - (0x2F923, "M", "𤘈"), - (0x2F924, "M", "犀"), - (0x2F925, "M", "犕"), - (0x2F926, "M", "𤜵"), - (0x2F927, "M", "𤠔"), - (0x2F928, "M", "獺"), - (0x2F929, "M", "王"), - (0x2F92A, "M", "㺬"), - (0x2F92B, "M", "玥"), - (0x2F92C, "M", "㺸"), - (0x2F92E, "M", "瑇"), - (0x2F92F, "M", "瑜"), - (0x2F930, "M", "瑱"), - (0x2F931, "M", "璅"), - (0x2F932, "M", "瓊"), - (0x2F933, "M", "㼛"), - (0x2F934, "M", "甤"), - (0x2F935, "M", "𤰶"), - (0x2F936, "M", "甾"), - (0x2F937, "M", "𤲒"), - (0x2F938, "M", "異"), - (0x2F939, "M", "𢆟"), - (0x2F93A, "M", "瘐"), - (0x2F93B, "M", "𤾡"), - (0x2F93C, "M", "𤾸"), - (0x2F93D, "M", "𥁄"), - (0x2F93E, "M", "㿼"), - (0x2F93F, "M", "䀈"), - (0x2F940, "M", "直"), - (0x2F941, "M", "𥃳"), - ] - - -def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2F942, "M", "𥃲"), - (0x2F943, "M", "𥄙"), - (0x2F944, "M", "𥄳"), - (0x2F945, "M", "眞"), - (0x2F946, "M", "真"), - (0x2F948, "M", "睊"), - (0x2F949, "M", "䀹"), - (0x2F94A, "M", "瞋"), - (0x2F94B, "M", "䁆"), - (0x2F94C, "M", "䂖"), - (0x2F94D, "M", "𥐝"), - (0x2F94E, "M", "硎"), - (0x2F94F, "M", "碌"), - (0x2F950, "M", "磌"), - (0x2F951, "M", "䃣"), - (0x2F952, "M", "𥘦"), - (0x2F953, "M", "祖"), - (0x2F954, "M", "𥚚"), - (0x2F955, "M", "𥛅"), - (0x2F956, "M", "福"), - (0x2F957, "M", "秫"), - (0x2F958, "M", "䄯"), - (0x2F959, "M", "穀"), - (0x2F95A, "M", "穊"), - (0x2F95B, "M", "穏"), - (0x2F95C, "M", "𥥼"), - (0x2F95D, "M", "𥪧"), - (0x2F95F, "M", "竮"), - (0x2F960, "M", "䈂"), - (0x2F961, "M", "𥮫"), - (0x2F962, "M", "篆"), - (0x2F963, "M", "築"), - (0x2F964, "M", "䈧"), - (0x2F965, "M", "𥲀"), - (0x2F966, "M", "糒"), - (0x2F967, "M", "䊠"), - (0x2F968, "M", "糨"), - (0x2F969, "M", "糣"), - (0x2F96A, "M", "紀"), - (0x2F96B, "M", "𥾆"), - (0x2F96C, "M", "絣"), - (0x2F96D, "M", "䌁"), - (0x2F96E, "M", "緇"), - (0x2F96F, "M", "縂"), - (0x2F970, "M", "繅"), - (0x2F971, "M", "䌴"), - (0x2F972, "M", "𦈨"), - (0x2F973, "M", "𦉇"), - (0x2F974, "M", "䍙"), - (0x2F975, "M", "𦋙"), - (0x2F976, "M", "罺"), - (0x2F977, "M", "𦌾"), - (0x2F978, "M", "羕"), - (0x2F979, "M", "翺"), - (0x2F97A, "M", "者"), - (0x2F97B, "M", "𦓚"), - (0x2F97C, "M", "𦔣"), - (0x2F97D, "M", "聠"), - (0x2F97E, "M", "𦖨"), - (0x2F97F, "M", "聰"), - (0x2F980, "M", "𣍟"), - (0x2F981, "M", "䏕"), - (0x2F982, "M", "育"), - (0x2F983, "M", "脃"), - (0x2F984, "M", "䐋"), - (0x2F985, "M", "脾"), - (0x2F986, "M", "媵"), - (0x2F987, "M", "𦞧"), - (0x2F988, "M", "𦞵"), - (0x2F989, "M", "𣎓"), - (0x2F98A, "M", "𣎜"), - (0x2F98B, "M", "舁"), - (0x2F98C, "M", "舄"), - (0x2F98D, "M", "辞"), - (0x2F98E, "M", "䑫"), - (0x2F98F, "M", "芑"), - (0x2F990, "M", "芋"), - (0x2F991, "M", "芝"), - (0x2F992, "M", "劳"), - (0x2F993, "M", "花"), - (0x2F994, "M", "芳"), - (0x2F995, "M", "芽"), - (0x2F996, "M", "苦"), - (0x2F997, "M", "𦬼"), - (0x2F998, "M", "若"), - (0x2F999, "M", "茝"), - (0x2F99A, "M", "荣"), - (0x2F99B, "M", "莭"), - (0x2F99C, "M", "茣"), - (0x2F99D, "M", "莽"), - (0x2F99E, "M", "菧"), - (0x2F99F, "M", "著"), - (0x2F9A0, "M", "荓"), - (0x2F9A1, "M", "菊"), - (0x2F9A2, "M", "菌"), - (0x2F9A3, "M", "菜"), - (0x2F9A4, "M", "𦰶"), - (0x2F9A5, "M", "𦵫"), - (0x2F9A6, "M", "𦳕"), - (0x2F9A7, "M", "䔫"), - ] - - -def _seg_82() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2F9A8, "M", "蓱"), - (0x2F9A9, "M", "蓳"), - (0x2F9AA, "M", "蔖"), - (0x2F9AB, "M", "𧏊"), - (0x2F9AC, "M", "蕤"), - (0x2F9AD, "M", "𦼬"), - (0x2F9AE, "M", "䕝"), - (0x2F9AF, "M", "䕡"), - (0x2F9B0, "M", "𦾱"), - (0x2F9B1, "M", "𧃒"), - (0x2F9B2, "M", "䕫"), - (0x2F9B3, "M", "虐"), - (0x2F9B4, "M", "虜"), - (0x2F9B5, "M", "虧"), - (0x2F9B6, "M", "虩"), - (0x2F9B7, "M", "蚩"), - (0x2F9B8, "M", "蚈"), - (0x2F9B9, "M", "蜎"), - (0x2F9BA, "M", "蛢"), - (0x2F9BB, "M", "蝹"), - (0x2F9BC, "M", "蜨"), - (0x2F9BD, "M", "蝫"), - (0x2F9BE, "M", "螆"), - (0x2F9BF, "M", "䗗"), - (0x2F9C0, "M", "蟡"), - (0x2F9C1, "M", "蠁"), - (0x2F9C2, "M", "䗹"), - (0x2F9C3, "M", "衠"), - (0x2F9C4, "M", "衣"), - (0x2F9C5, "M", "𧙧"), - (0x2F9C6, "M", "裗"), - (0x2F9C7, "M", "裞"), - (0x2F9C8, "M", "䘵"), - (0x2F9C9, "M", "裺"), - (0x2F9CA, "M", "㒻"), - (0x2F9CB, "M", "𧢮"), - (0x2F9CC, "M", "𧥦"), - (0x2F9CD, "M", "䚾"), - (0x2F9CE, "M", "䛇"), - (0x2F9CF, "M", "誠"), - (0x2F9D0, "M", "諭"), - (0x2F9D1, "M", "變"), - (0x2F9D2, "M", "豕"), - (0x2F9D3, "M", "𧲨"), - (0x2F9D4, "M", "貫"), - (0x2F9D5, "M", "賁"), - (0x2F9D6, "M", "贛"), - (0x2F9D7, "M", "起"), - (0x2F9D8, "M", "𧼯"), - (0x2F9D9, "M", "𠠄"), - (0x2F9DA, "M", "跋"), - (0x2F9DB, "M", "趼"), - (0x2F9DC, "M", "跰"), - (0x2F9DD, "M", "𠣞"), - (0x2F9DE, "M", "軔"), - (0x2F9DF, "M", "輸"), - (0x2F9E0, "M", "𨗒"), - (0x2F9E1, "M", "𨗭"), - (0x2F9E2, "M", "邔"), - (0x2F9E3, "M", "郱"), - (0x2F9E4, "M", "鄑"), - (0x2F9E5, "M", "𨜮"), - (0x2F9E6, "M", "鄛"), - (0x2F9E7, "M", "鈸"), - (0x2F9E8, "M", "鋗"), - (0x2F9E9, "M", "鋘"), - (0x2F9EA, "M", "鉼"), - (0x2F9EB, "M", "鏹"), - (0x2F9EC, "M", "鐕"), - (0x2F9ED, "M", "𨯺"), - (0x2F9EE, "M", "開"), - (0x2F9EF, "M", "䦕"), - (0x2F9F0, "M", "閷"), - (0x2F9F1, "M", "𨵷"), - (0x2F9F2, "M", "䧦"), - (0x2F9F3, "M", "雃"), - (0x2F9F4, "M", "嶲"), - (0x2F9F5, "M", "霣"), - (0x2F9F6, "M", "𩅅"), - (0x2F9F7, "M", "𩈚"), - (0x2F9F8, "M", "䩮"), - (0x2F9F9, "M", "䩶"), - (0x2F9FA, "M", "韠"), - (0x2F9FB, "M", "𩐊"), - (0x2F9FC, "M", "䪲"), - (0x2F9FD, "M", "𩒖"), - (0x2F9FE, "M", "頋"), - (0x2FA00, "M", "頩"), - (0x2FA01, "M", "𩖶"), - (0x2FA02, "M", "飢"), - (0x2FA03, "M", "䬳"), - (0x2FA04, "M", "餩"), - (0x2FA05, "M", "馧"), - (0x2FA06, "M", "駂"), - (0x2FA07, "M", "駾"), - (0x2FA08, "M", "䯎"), - (0x2FA09, "M", "𩬰"), - (0x2FA0A, "M", "鬒"), - (0x2FA0B, "M", "鱀"), - (0x2FA0C, "M", "鳽"), - ] - - -def _seg_83() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]: - return [ - (0x2FA0D, "M", "䳎"), - (0x2FA0E, "M", "䳭"), - (0x2FA0F, "M", "鵧"), - (0x2FA10, "M", "𪃎"), - (0x2FA11, "M", "䳸"), - (0x2FA12, "M", "𪄅"), - (0x2FA13, "M", "𪈎"), - (0x2FA14, "M", "𪊑"), - (0x2FA15, "M", "麻"), - (0x2FA16, "M", "䵖"), - (0x2FA17, "M", "黹"), - (0x2FA18, "M", "黾"), - (0x2FA19, "M", "鼅"), - (0x2FA1A, "M", "鼏"), - (0x2FA1B, "M", "鼖"), - (0x2FA1C, "M", "鼻"), - (0x2FA1D, "M", "𪘀"), - (0x2FA1E, "X"), - (0x30000, "V"), - (0x3134B, "X"), - (0x31350, "V"), - (0x323B0, "X"), - (0xE0100, "I"), - (0xE01F0, "X"), - ] - - -uts46data = tuple( - _seg_0() - + _seg_1() - + _seg_2() - + _seg_3() - + _seg_4() - + _seg_5() - + _seg_6() - + _seg_7() - + _seg_8() - + _seg_9() - + _seg_10() - + _seg_11() - + _seg_12() - + _seg_13() - + _seg_14() - + _seg_15() - + _seg_16() - + _seg_17() - + _seg_18() - + _seg_19() - + _seg_20() - + _seg_21() - + _seg_22() - + _seg_23() - + _seg_24() - + _seg_25() - + _seg_26() - + _seg_27() - + _seg_28() - + _seg_29() - + _seg_30() - + _seg_31() - + _seg_32() - + _seg_33() - + _seg_34() - + _seg_35() - + _seg_36() - + _seg_37() - + _seg_38() - + _seg_39() - + _seg_40() - + _seg_41() - + _seg_42() - + _seg_43() - + _seg_44() - + _seg_45() - + _seg_46() - + _seg_47() - + _seg_48() - + _seg_49() - + _seg_50() - + _seg_51() - + _seg_52() - + _seg_53() - + _seg_54() - + _seg_55() - + _seg_56() - + _seg_57() - + _seg_58() - + _seg_59() - + _seg_60() - + _seg_61() - + _seg_62() - + _seg_63() - + _seg_64() - + _seg_65() - + _seg_66() - + _seg_67() - + _seg_68() - + _seg_69() - + _seg_70() - + _seg_71() - + _seg_72() - + _seg_73() - + _seg_74() - + _seg_75() - + _seg_76() - + _seg_77() - + _seg_78() - + _seg_79() - + _seg_80() - + _seg_81() - + _seg_82() - + _seg_83() -) # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...] +uts46_replacements: tuple[str | None, ...] = ( + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + " ", + None, + None, + None, + None, + None, + None, + None, + " ̈", + None, + "a", + None, + None, + None, + None, + " ̄", + None, + None, + "2", + "3", + " ́", + "μ", + None, + None, + " ̧", + "1", + "o", + None, + "1⁄4", + "1⁄2", + "3⁄4", + None, + "à", + "á", + "â", + "ã", + "ä", + "å", + "æ", + "ç", + "è", + "é", + "ê", + "ë", + "ì", + "í", + "î", + "ï", + "ð", + "ñ", + "ò", + "ó", + "ô", + "õ", + "ö", + None, + "ø", + "ù", + "ú", + "û", + "ü", + "ý", + "þ", + "ss", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ā", + None, + "ă", + None, + "ą", + None, + "ć", + None, + "ĉ", + None, + "ċ", + None, + "č", + None, + "ď", + None, + "đ", + None, + "ē", + None, + "ĕ", + None, + "ė", + None, + "ę", + None, + "ě", + None, + "ĝ", + None, + "ğ", + None, + "ġ", + None, + "ģ", + None, + "ĥ", + None, + "ħ", + None, + "ĩ", + None, + "ī", + None, + "ĭ", + None, + "į", + None, + "i̇", + None, + "ij", + "ĵ", + None, + "ķ", + None, + "ĺ", + None, + "ļ", + None, + "ľ", + None, + "l·", + "ł", + None, + "ń", + None, + "ņ", + None, + "ň", + None, + "ʼn", + "ŋ", + None, + "ō", + None, + "ŏ", + None, + "ő", + None, + "œ", + None, + "ŕ", + None, + "ŗ", + None, + "ř", + None, + "ś", + None, + "ŝ", + None, + "ş", + None, + "š", + None, + "ţ", + None, + "ť", + None, + "ŧ", + None, + "ũ", + None, + "ū", + None, + "ŭ", + None, + "ů", + None, + "ű", + None, + "ų", + None, + "ŵ", + None, + "ŷ", + None, + "ÿ", + "ź", + None, + "ż", + None, + "ž", + None, + "s", + None, + "ɓ", + "ƃ", + None, + "ƅ", + None, + "ɔ", + "ƈ", + None, + "ɖ", + "ɗ", + "ƌ", + None, + "ǝ", + "ə", + "ɛ", + "ƒ", + None, + "ɠ", + "ɣ", + None, + "ɩ", + "ɨ", + "ƙ", + None, + "ɯ", + "ɲ", + None, + "ɵ", + "ơ", + None, + "ƣ", + None, + "ƥ", + None, + "ʀ", + "ƨ", + None, + "ʃ", + None, + "ƭ", + None, + "ʈ", + "ư", + None, + "ʊ", + "ʋ", + "ƴ", + None, + "ƶ", + None, + "ʒ", + "ƹ", + None, + "ƽ", + None, + "dž", + "lj", + "nj", + "ǎ", + None, + "ǐ", + None, + "ǒ", + None, + "ǔ", + None, + "ǖ", + None, + "ǘ", + None, + "ǚ", + None, + "ǜ", + None, + "ǟ", + None, + "ǡ", + None, + "ǣ", + None, + "ǥ", + None, + "ǧ", + None, + "ǩ", + None, + "ǫ", + None, + "ǭ", + None, + "ǯ", + None, + "dz", + "ǵ", + None, + "ƕ", + "ƿ", + "ǹ", + None, + "ǻ", + None, + "ǽ", + None, + "ǿ", + None, + "ȁ", + None, + "ȃ", + None, + "ȅ", + None, + "ȇ", + None, + "ȉ", + None, + "ȋ", + None, + "ȍ", + None, + "ȏ", + None, + "ȑ", + None, + "ȓ", + None, + "ȕ", + None, + "ȗ", + None, + "ș", + None, + "ț", + None, + "ȝ", + None, + "ȟ", + None, + "ƞ", + None, + "ȣ", + None, + "ȥ", + None, + "ȧ", + None, + "ȩ", + None, + "ȫ", + None, + "ȭ", + None, + "ȯ", + None, + "ȱ", + None, + "ȳ", + None, + "ⱥ", + "ȼ", + None, + "ƚ", + "ⱦ", + None, + "ɂ", + None, + "ƀ", + "ʉ", + "ʌ", + "ɇ", + None, + "ɉ", + None, + "ɋ", + None, + "ɍ", + None, + "ɏ", + None, + "h", + "ɦ", + "j", + "r", + "ɹ", + "ɻ", + "ʁ", + "w", + "y", + None, + " ̆", + " ̇", + " ̊", + " ̨", + " ̃", + " ̋", + None, + "ɣ", + "l", + "s", + "x", + "ʕ", + None, + "̀", + "́", + None, + "̓", + "̈́", + "ι", + None, + None, + None, + "ͱ", + None, + "ͳ", + None, + "ʹ", + None, + "ͷ", + None, + None, + " ι", + None, + ";", + "ϳ", + None, + " ́", + " ̈́", + "ά", + "·", + "έ", + "ή", + "ί", + None, + "ό", + None, + "ύ", + "ώ", + None, + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + None, + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "ϊ", + "ϋ", + None, + "σ", + None, + "ϗ", + "β", + "θ", + "υ", + "ύ", + "ϋ", + "φ", + "π", + None, + "ϙ", + None, + "ϛ", + None, + "ϝ", + None, + "ϟ", + None, + "ϡ", + None, + "ϣ", + None, + "ϥ", + None, + "ϧ", + None, + "ϩ", + None, + "ϫ", + None, + "ϭ", + None, + "ϯ", + None, + "κ", + "ρ", + "σ", + None, + "θ", + "ε", + None, + "ϸ", + None, + "σ", + "ϻ", + None, + "ͻ", + "ͼ", + "ͽ", + "ѐ", + "ё", + "ђ", + "ѓ", + "є", + "ѕ", + "і", + "ї", + "ј", + "љ", + "њ", + "ћ", + "ќ", + "ѝ", + "ў", + "џ", + "а", + "б", + "в", + "г", + "д", + "е", + "ж", + "з", + "и", + "й", + "к", + "л", + "м", + "н", + "о", + "п", + "р", + "с", + "т", + "у", + "ф", + "х", + "ц", + "ч", + "ш", + "щ", + "ъ", + "ы", + "ь", + "э", + "ю", + "я", + None, + "ѡ", + None, + "ѣ", + None, + "ѥ", + None, + "ѧ", + None, + "ѩ", + None, + "ѫ", + None, + "ѭ", + None, + "ѯ", + None, + "ѱ", + None, + "ѳ", + None, + "ѵ", + None, + "ѷ", + None, + "ѹ", + None, + "ѻ", + None, + "ѽ", + None, + "ѿ", + None, + "ҁ", + None, + "ҋ", + None, + "ҍ", + None, + "ҏ", + None, + "ґ", + None, + "ғ", + None, + "ҕ", + None, + "җ", + None, + "ҙ", + None, + "қ", + None, + "ҝ", + None, + "ҟ", + None, + "ҡ", + None, + "ң", + None, + "ҥ", + None, + "ҧ", + None, + "ҩ", + None, + "ҫ", + None, + "ҭ", + None, + "ү", + None, + "ұ", + None, + "ҳ", + None, + "ҵ", + None, + "ҷ", + None, + "ҹ", + None, + "һ", + None, + "ҽ", + None, + "ҿ", + None, + "ӏ", + "ӂ", + None, + "ӄ", + None, + "ӆ", + None, + "ӈ", + None, + "ӊ", + None, + "ӌ", + None, + "ӎ", + None, + "ӑ", + None, + "ӓ", + None, + "ӕ", + None, + "ӗ", + None, + "ә", + None, + "ӛ", + None, + "ӝ", + None, + "ӟ", + None, + "ӡ", + None, + "ӣ", + None, + "ӥ", + None, + "ӧ", + None, + "ө", + None, + "ӫ", + None, + "ӭ", + None, + "ӯ", + None, + "ӱ", + None, + "ӳ", + None, + "ӵ", + None, + "ӷ", + None, + "ӹ", + None, + "ӻ", + None, + "ӽ", + None, + "ӿ", + None, + "ԁ", + None, + "ԃ", + None, + "ԅ", + None, + "ԇ", + None, + "ԉ", + None, + "ԋ", + None, + "ԍ", + None, + "ԏ", + None, + "ԑ", + None, + "ԓ", + None, + "ԕ", + None, + "ԗ", + None, + "ԙ", + None, + "ԛ", + None, + "ԝ", + None, + "ԟ", + None, + "ԡ", + None, + "ԣ", + None, + "ԥ", + None, + "ԧ", + None, + "ԩ", + None, + "ԫ", + None, + "ԭ", + None, + "ԯ", + None, + None, + "ա", + "բ", + "գ", + "դ", + "ե", + "զ", + "է", + "ը", + "թ", + "ժ", + "ի", + "լ", + "խ", + "ծ", + "կ", + "հ", + "ձ", + "ղ", + "ճ", + "մ", + "յ", + "ն", + "շ", + "ո", + "չ", + "պ", + "ջ", + "ռ", + "ս", + "վ", + "տ", + "ր", + "ց", + "ւ", + "փ", + "ք", + "օ", + "ֆ", + None, + "է", + None, + "եւ", + None, + "ի", + "յ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "اٴ", + "وٴ", + "ۇٴ", + "يٴ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "क़", + "ख़", + "ग़", + "ज़", + "ड़", + "ढ़", + "फ़", + "य़", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ড়", + "ঢ়", + None, + "য়", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ਲ਼", + None, + None, + "ਸ਼", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ਖ਼", + "ਗ਼", + "ਜ਼", + None, + None, + "ਫ਼", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ଡ଼", + "ଢ଼", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ํา", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ໍາ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ຫນ", + "ຫມ", + None, + None, + None, + "་", + None, + "གྷ", + None, + None, + None, + "ཌྷ", + None, + "དྷ", + None, + "བྷ", + None, + "ཛྷ", + None, + "ཀྵ", + None, + None, + None, + "ཱི", + None, + "ཱུ", + "ྲྀ", + "ྲཱྀ", + "ླྀ", + "ླཱྀ", + None, + "ཱྀ", + None, + "ྒྷ", + None, + None, + None, + "ྜྷ", + None, + "ྡྷ", + None, + "ྦྷ", + None, + "ྫྷ", + None, + "ྐྵ", + None, + None, + None, + None, + None, + None, + None, + "ⴀ", + "ⴁ", + "ⴂ", + "ⴃ", + "ⴄ", + "ⴅ", + "ⴆ", + "ⴇ", + "ⴈ", + "ⴉ", + "ⴊ", + "ⴋ", + "ⴌ", + "ⴍ", + "ⴎ", + "ⴏ", + "ⴐ", + "ⴑ", + "ⴒ", + "ⴓ", + "ⴔ", + "ⴕ", + "ⴖ", + "ⴗ", + "ⴘ", + "ⴙ", + "ⴚ", + "ⴛ", + "ⴜ", + "ⴝ", + "ⴞ", + "ⴟ", + "ⴠ", + "ⴡ", + "ⴢ", + "ⴣ", + "ⴤ", + "ⴥ", + None, + "ⴧ", + None, + "ⴭ", + None, + None, + "ნ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "Ᏸ", + "Ᏹ", + "Ᏺ", + "Ᏻ", + "Ᏼ", + "Ᏽ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "в", + "д", + "о", + "с", + "т", + "ъ", + "ѣ", + "ꙋ", + "ᲊ", + None, + None, + "ა", + "ბ", + "გ", + "დ", + "ე", + "ვ", + "ზ", + "თ", + "ი", + "კ", + "ლ", + "მ", + "ნ", + "ო", + "პ", + "ჟ", + "რ", + "ს", + "ტ", + "უ", + "ფ", + "ქ", + "ღ", + "ყ", + "შ", + "ჩ", + "ც", + "ძ", + "წ", + "ჭ", + "ხ", + "ჯ", + "ჰ", + "ჱ", + "ჲ", + "ჳ", + "ჴ", + "ჵ", + "ჶ", + "ჷ", + "ჸ", + "ჹ", + "ჺ", + None, + "ჽ", + "ჾ", + "ჿ", + None, + None, + None, + None, + None, + "a", + "æ", + "b", + None, + "d", + "e", + "ǝ", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + None, + "o", + "ȣ", + "p", + "r", + "t", + "u", + "w", + "a", + "ɐ", + "ɑ", + "ᴂ", + "b", + "d", + "e", + "ə", + "ɛ", + "ɜ", + "g", + None, + "k", + "m", + "ŋ", + "o", + "ɔ", + "ᴖ", + "ᴗ", + "p", + "t", + "u", + "ᴝ", + "ɯ", + "v", + "ᴥ", + "β", + "γ", + "δ", + "φ", + "χ", + "i", + "r", + "u", + "v", + "β", + "γ", + "ρ", + "φ", + "χ", + None, + "н", + None, + "ɒ", + "c", + "ɕ", + "ð", + "ɜ", + "f", + "ɟ", + "ɡ", + "ɥ", + "ɨ", + "ɩ", + "ɪ", + "ᵻ", + "ʝ", + "ɭ", + "ᶅ", + "ʟ", + "ɱ", + "ɰ", + "ɲ", + "ɳ", + "ɴ", + "ɵ", + "ɸ", + "ʂ", + "ʃ", + "ƫ", + "ʉ", + "ʊ", + "ᴜ", + "ʋ", + "ʌ", + "z", + "ʐ", + "ʑ", + "ʒ", + "θ", + None, + "ḁ", + None, + "ḃ", + None, + "ḅ", + None, + "ḇ", + None, + "ḉ", + None, + "ḋ", + None, + "ḍ", + None, + "ḏ", + None, + "ḑ", + None, + "ḓ", + None, + "ḕ", + None, + "ḗ", + None, + "ḙ", + None, + "ḛ", + None, + "ḝ", + None, + "ḟ", + None, + "ḡ", + None, + "ḣ", + None, + "ḥ", + None, + "ḧ", + None, + "ḩ", + None, + "ḫ", + None, + "ḭ", + None, + "ḯ", + None, + "ḱ", + None, + "ḳ", + None, + "ḵ", + None, + "ḷ", + None, + "ḹ", + None, + "ḻ", + None, + "ḽ", + None, + "ḿ", + None, + "ṁ", + None, + "ṃ", + None, + "ṅ", + None, + "ṇ", + None, + "ṉ", + None, + "ṋ", + None, + "ṍ", + None, + "ṏ", + None, + "ṑ", + None, + "ṓ", + None, + "ṕ", + None, + "ṗ", + None, + "ṙ", + None, + "ṛ", + None, + "ṝ", + None, + "ṟ", + None, + "ṡ", + None, + "ṣ", + None, + "ṥ", + None, + "ṧ", + None, + "ṩ", + None, + "ṫ", + None, + "ṭ", + None, + "ṯ", + None, + "ṱ", + None, + "ṳ", + None, + "ṵ", + None, + "ṷ", + None, + "ṹ", + None, + "ṻ", + None, + "ṽ", + None, + "ṿ", + None, + "ẁ", + None, + "ẃ", + None, + "ẅ", + None, + "ẇ", + None, + "ẉ", + None, + "ẋ", + None, + "ẍ", + None, + "ẏ", + None, + "ẑ", + None, + "ẓ", + None, + "ẕ", + None, + "aʾ", + "ṡ", + None, + "ß", + None, + "ạ", + None, + "ả", + None, + "ấ", + None, + "ầ", + None, + "ẩ", + None, + "ẫ", + None, + "ậ", + None, + "ắ", + None, + "ằ", + None, + "ẳ", + None, + "ẵ", + None, + "ặ", + None, + "ẹ", + None, + "ẻ", + None, + "ẽ", + None, + "ế", + None, + "ề", + None, + "ể", + None, + "ễ", + None, + "ệ", + None, + "ỉ", + None, + "ị", + None, + "ọ", + None, + "ỏ", + None, + "ố", + None, + "ồ", + None, + "ổ", + None, + "ỗ", + None, + "ộ", + None, + "ớ", + None, + "ờ", + None, + "ở", + None, + "ỡ", + None, + "ợ", + None, + "ụ", + None, + "ủ", + None, + "ứ", + None, + "ừ", + None, + "ử", + None, + "ữ", + None, + "ự", + None, + "ỳ", + None, + "ỵ", + None, + "ỷ", + None, + "ỹ", + None, + "ỻ", + None, + "ỽ", + None, + "ỿ", + None, + "ἀ", + "ἁ", + "ἂ", + "ἃ", + "ἄ", + "ἅ", + "ἆ", + "ἇ", + None, + None, + "ἐ", + "ἑ", + "ἒ", + "ἓ", + "ἔ", + "ἕ", + None, + None, + "ἠ", + "ἡ", + "ἢ", + "ἣ", + "ἤ", + "ἥ", + "ἦ", + "ἧ", + None, + "ἰ", + "ἱ", + "ἲ", + "ἳ", + "ἴ", + "ἵ", + "ἶ", + "ἷ", + None, + None, + "ὀ", + "ὁ", + "ὂ", + "ὃ", + "ὄ", + "ὅ", + None, + None, + None, + "ὑ", + None, + "ὓ", + None, + "ὕ", + None, + "ὗ", + None, + "ὠ", + "ὡ", + "ὢ", + "ὣ", + "ὤ", + "ὥ", + "ὦ", + "ὧ", + None, + "ά", + None, + "έ", + None, + "ή", + None, + "ί", + None, + "ό", + None, + "ύ", + None, + "ώ", + None, + "ἀι", + "ἁι", + "ἂι", + "ἃι", + "ἄι", + "ἅι", + "ἆι", + "ἇι", + "ἀι", + "ἁι", + "ἂι", + "ἃι", + "ἄι", + "ἅι", + "ἆι", + "ἇι", + "ἠι", + "ἡι", + "ἢι", + "ἣι", + "ἤι", + "ἥι", + "ἦι", + "ἧι", + "ἠι", + "ἡι", + "ἢι", + "ἣι", + "ἤι", + "ἥι", + "ἦι", + "ἧι", + "ὠι", + "ὡι", + "ὢι", + "ὣι", + "ὤι", + "ὥι", + "ὦι", + "ὧι", + "ὠι", + "ὡι", + "ὢι", + "ὣι", + "ὤι", + "ὥι", + "ὦι", + "ὧι", + None, + "ὰι", + "αι", + "άι", + None, + None, + "ᾶι", + "ᾰ", + "ᾱ", + "ὰ", + "ά", + "αι", + " ̓", + "ι", + " ̓", + " ͂", + " ̈͂", + "ὴι", + "ηι", + "ήι", + None, + None, + "ῆι", + "ὲ", + "έ", + "ὴ", + "ή", + "ηι", + " ̓̀", + " ̓́", + " ̓͂", + None, + "ΐ", + None, + None, + "ῐ", + "ῑ", + "ὶ", + "ί", + None, + " ̔̀", + " ̔́", + " ̔͂", + None, + "ΰ", + None, + "ῠ", + "ῡ", + "ὺ", + "ύ", + "ῥ", + " ̈̀", + " ̈́", + "`", + None, + "ὼι", + "ωι", + "ώι", + None, + None, + "ῶι", + "ὸ", + "ό", + "ὼ", + "ώ", + "ωι", + " ́", + " ̔", + None, + " ", + None, + "", + None, + None, + "‐", + None, + " ̳", + None, + None, + None, + None, + " ", + None, + "′′", + "′′′", + None, + "‵‵", + "‵‵‵", + None, + "!!", + None, + " ̅", + None, + "??", + "?!", + "!?", + None, + "′′′′", + None, + " ", + None, + None, + None, + "0", + "i", + None, + "4", + "5", + "6", + "7", + "8", + "9", + "+", + "−", + "=", + "(", + ")", + "n", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "+", + "−", + "=", + "(", + ")", + None, + "a", + "e", + "o", + "x", + "ə", + "h", + "k", + "l", + "m", + "n", + "p", + "s", + "t", + "w", + "y", + "z", + None, + "rs", + None, + None, + None, + None, + "a/c", + "a/s", + "c", + "°c", + None, + "c/o", + "c/u", + "ɛ", + None, + "°f", + "g", + "h", + "ħ", + "i", + "l", + None, + "n", + "no", + None, + "p", + "q", + "r", + None, + "sm", + "tel", + "tm", + None, + "z", + None, + "ω", + None, + "z", + None, + "k", + "å", + "b", + "c", + None, + "e", + "f", + "ⅎ", + "m", + "o", + "א", + "ב", + "ג", + "ד", + "i", + None, + "fax", + "π", + "γ", + "π", + "∑", + None, + "d", + "e", + "i", + "j", + None, + "1⁄7", + "1⁄9", + "1⁄10", + "1⁄3", + "2⁄3", + "1⁄5", + "2⁄5", + "3⁄5", + "4⁄5", + "1⁄6", + "5⁄6", + "1⁄8", + "3⁄8", + "5⁄8", + "7⁄8", + "1⁄", + "i", + "ii", + "iii", + "iv", + "v", + "vi", + "vii", + "viii", + "ix", + "x", + "xi", + "xii", + "l", + "c", + "d", + "m", + "i", + "ii", + "iii", + "iv", + "v", + "vi", + "vii", + "viii", + "ix", + "x", + "xi", + "xii", + "l", + "c", + "d", + "m", + None, + "ↄ", + None, + "0⁄3", + None, + None, + None, + "∫∫", + "∫∫∫", + None, + "∮∮", + "∮∮∮", + None, + "〈", + "〉", + None, + None, + None, + None, + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "10", + "11", + "12", + "13", + "14", + "15", + "16", + "17", + "18", + "19", + "20", + "(1)", + "(2)", + "(3)", + "(4)", + "(5)", + "(6)", + "(7)", + "(8)", + "(9)", + "(10)", + "(11)", + "(12)", + "(13)", + "(14)", + "(15)", + "(16)", + "(17)", + "(18)", + "(19)", + "(20)", + None, + "(a)", + "(b)", + "(c)", + "(d)", + "(e)", + "(f)", + "(g)", + "(h)", + "(i)", + "(j)", + "(k)", + "(l)", + "(m)", + "(n)", + "(o)", + "(p)", + "(q)", + "(r)", + "(s)", + "(t)", + "(u)", + "(v)", + "(w)", + "(x)", + "(y)", + "(z)", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "0", + None, + "∫∫∫∫", + None, + "::=", + "==", + "===", + None, + "⫝̸", + None, + None, + None, + "ⰰ", + "ⰱ", + "ⰲ", + "ⰳ", + "ⰴ", + "ⰵ", + "ⰶ", + "ⰷ", + "ⰸ", + "ⰹ", + "ⰺ", + "ⰻ", + "ⰼ", + "ⰽ", + "ⰾ", + "ⰿ", + "ⱀ", + "ⱁ", + "ⱂ", + "ⱃ", + "ⱄ", + "ⱅ", + "ⱆ", + "ⱇ", + "ⱈ", + "ⱉ", + "ⱊ", + "ⱋ", + "ⱌ", + "ⱍ", + "ⱎ", + "ⱏ", + "ⱐ", + "ⱑ", + "ⱒ", + "ⱓ", + "ⱔ", + "ⱕ", + "ⱖ", + "ⱗ", + "ⱘ", + "ⱙ", + "ⱚ", + "ⱛ", + "ⱜ", + "ⱝ", + "ⱞ", + "ⱟ", + None, + "ⱡ", + None, + "ɫ", + "ᵽ", + "ɽ", + None, + "ⱨ", + None, + "ⱪ", + None, + "ⱬ", + None, + "ɑ", + "ɱ", + "ɐ", + "ɒ", + None, + "ⱳ", + None, + "ⱶ", + None, + "j", + "v", + "ȿ", + "ɀ", + "ⲁ", + None, + "ⲃ", + None, + "ⲅ", + None, + "ⲇ", + None, + "ⲉ", + None, + "ⲋ", + None, + "ⲍ", + None, + "ⲏ", + None, + "ⲑ", + None, + "ⲓ", + None, + "ⲕ", + None, + "ⲗ", + None, + "ⲙ", + None, + "ⲛ", + None, + "ⲝ", + None, + "ⲟ", + None, + "ⲡ", + None, + "ⲣ", + None, + "ⲥ", + None, + "ⲧ", + None, + "ⲩ", + None, + "ⲫ", + None, + "ⲭ", + None, + "ⲯ", + None, + "ⲱ", + None, + "ⲳ", + None, + "ⲵ", + None, + "ⲷ", + None, + "ⲹ", + None, + "ⲻ", + None, + "ⲽ", + None, + "ⲿ", + None, + "ⳁ", + None, + "ⳃ", + None, + "ⳅ", + None, + "ⳇ", + None, + "ⳉ", + None, + "ⳋ", + None, + "ⳍ", + None, + "ⳏ", + None, + "ⳑ", + None, + "ⳓ", + None, + "ⳕ", + None, + "ⳗ", + None, + "ⳙ", + None, + "ⳛ", + None, + "ⳝ", + None, + "ⳟ", + None, + "ⳡ", + None, + "ⳣ", + None, + "ⳬ", + None, + "ⳮ", + None, + "ⳳ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ⵡ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "母", + None, + "龟", + None, + "一", + "丨", + "丶", + "丿", + "乙", + "亅", + "二", + "亠", + "人", + "儿", + "入", + "八", + "冂", + "冖", + "冫", + "几", + "凵", + "刀", + "力", + "勹", + "匕", + "匚", + "匸", + "十", + "卜", + "卩", + "厂", + "厶", + "又", + "口", + "囗", + "土", + "士", + "夂", + "夊", + "夕", + "大", + "女", + "子", + "宀", + "寸", + "小", + "尢", + "尸", + "屮", + "山", + "巛", + "工", + "己", + "巾", + "干", + "幺", + "广", + "廴", + "廾", + "弋", + "弓", + "彐", + "彡", + "彳", + "心", + "戈", + "戶", + "手", + "支", + "攴", + "文", + "斗", + "斤", + "方", + "无", + "日", + "曰", + "月", + "木", + "欠", + "止", + "歹", + "殳", + "毋", + "比", + "毛", + "氏", + "气", + "水", + "火", + "爪", + "父", + "爻", + "爿", + "片", + "牙", + "牛", + "犬", + "玄", + "玉", + "瓜", + "瓦", + "甘", + "生", + "用", + "田", + "疋", + "疒", + "癶", + "白", + "皮", + "皿", + "目", + "矛", + "矢", + "石", + "示", + "禸", + "禾", + "穴", + "立", + "竹", + "米", + "糸", + "缶", + "网", + "羊", + "羽", + "老", + "而", + "耒", + "耳", + "聿", + "肉", + "臣", + "自", + "至", + "臼", + "舌", + "舛", + "舟", + "艮", + "色", + "艸", + "虍", + "虫", + "血", + "行", + "衣", + "襾", + "見", + "角", + "言", + "谷", + "豆", + "豕", + "豸", + "貝", + "赤", + "走", + "足", + "身", + "車", + "辛", + "辰", + "辵", + "邑", + "酉", + "釆", + "里", + "金", + "長", + "門", + "阜", + "隶", + "隹", + "雨", + "靑", + "非", + "面", + "革", + "韋", + "韭", + "音", + "頁", + "風", + "飛", + "食", + "首", + "香", + "馬", + "骨", + "高", + "髟", + "鬥", + "鬯", + "鬲", + "鬼", + "魚", + "鳥", + "鹵", + "鹿", + "麥", + "麻", + "黃", + "黍", + "黑", + "黹", + "黽", + "鼎", + "鼓", + "鼠", + "鼻", + "齊", + "齒", + "龍", + "龜", + "龠", + None, + " ", + None, + ".", + None, + "〒", + None, + "十", + "卄", + "卅", + None, + None, + None, + None, + None, + " ゙", + " ゚", + None, + "より", + None, + "コト", + None, + None, + None, + "ᄀ", + "ᄁ", + "ᆪ", + "ᄂ", + "ᆬ", + "ᆭ", + "ᄃ", + "ᄄ", + "ᄅ", + "ᆰ", + "ᆱ", + "ᆲ", + "ᆳ", + "ᆴ", + "ᆵ", + "ᄚ", + "ᄆ", + "ᄇ", + "ᄈ", + "ᄡ", + "ᄉ", + "ᄊ", + "ᄋ", + "ᄌ", + "ᄍ", + "ᄎ", + "ᄏ", + "ᄐ", + "ᄑ", + "ᄒ", + "ᅡ", + "ᅢ", + "ᅣ", + "ᅤ", + "ᅥ", + "ᅦ", + "ᅧ", + "ᅨ", + "ᅩ", + "ᅪ", + "ᅫ", + "ᅬ", + "ᅭ", + "ᅮ", + "ᅯ", + "ᅰ", + "ᅱ", + "ᅲ", + "ᅳ", + "ᅴ", + "ᅵ", + None, + "ᄔ", + "ᄕ", + "ᇇ", + "ᇈ", + "ᇌ", + "ᇎ", + "ᇓ", + "ᇗ", + "ᇙ", + "ᄜ", + "ᇝ", + "ᇟ", + "ᄝ", + "ᄞ", + "ᄠ", + "ᄢ", + "ᄣ", + "ᄧ", + "ᄩ", + "ᄫ", + "ᄬ", + "ᄭ", + "ᄮ", + "ᄯ", + "ᄲ", + "ᄶ", + "ᅀ", + "ᅇ", + "ᅌ", + "ᇱ", + "ᇲ", + "ᅗ", + "ᅘ", + "ᅙ", + "ᆄ", + "ᆅ", + "ᆈ", + "ᆑ", + "ᆒ", + "ᆔ", + "ᆞ", + "ᆡ", + None, + None, + "一", + "二", + "三", + "四", + "上", + "中", + "下", + "甲", + "乙", + "丙", + "丁", + "天", + "地", + "人", + None, + None, + None, + "(ᄀ)", + "(ᄂ)", + "(ᄃ)", + "(ᄅ)", + "(ᄆ)", + "(ᄇ)", + "(ᄉ)", + "(ᄋ)", + "(ᄌ)", + "(ᄎ)", + "(ᄏ)", + "(ᄐ)", + "(ᄑ)", + "(ᄒ)", + "(가)", + "(나)", + "(다)", + "(라)", + "(마)", + "(바)", + "(사)", + "(아)", + "(자)", + "(차)", + "(카)", + "(타)", + "(파)", + "(하)", + "(주)", + "(오전)", + "(오후)", + None, + "(一)", + "(二)", + "(三)", + "(四)", + "(五)", + "(六)", + "(七)", + "(八)", + "(九)", + "(十)", + "(月)", + "(火)", + "(水)", + "(木)", + "(金)", + "(土)", + "(日)", + "(株)", + "(有)", + "(社)", + "(名)", + "(特)", + "(財)", + "(祝)", + "(労)", + "(代)", + "(呼)", + "(学)", + "(監)", + "(企)", + "(資)", + "(協)", + "(祭)", + "(休)", + "(自)", + "(至)", + "問", + "幼", + "文", + "箏", + None, + "pte", + "21", + "22", + "23", + "24", + "25", + "26", + "27", + "28", + "29", + "30", + "31", + "32", + "33", + "34", + "35", + "ᄀ", + "ᄂ", + "ᄃ", + "ᄅ", + "ᄆ", + "ᄇ", + "ᄉ", + "ᄋ", + "ᄌ", + "ᄎ", + "ᄏ", + "ᄐ", + "ᄑ", + "ᄒ", + "가", + "나", + "다", + "라", + "마", + "바", + "사", + "아", + "자", + "차", + "카", + "타", + "파", + "하", + "참고", + "주의", + "우", + None, + "一", + "二", + "三", + "四", + "五", + "六", + "七", + "八", + "九", + "十", + "月", + "火", + "水", + "木", + "金", + "土", + "日", + "株", + "有", + "社", + "名", + "特", + "財", + "祝", + "労", + "秘", + "男", + "女", + "適", + "優", + "印", + "注", + "項", + "休", + "写", + "正", + "上", + "中", + "下", + "左", + "右", + "医", + "宗", + "学", + "監", + "企", + "資", + "協", + "夜", + "36", + "37", + "38", + "39", + "40", + "41", + "42", + "43", + "44", + "45", + "46", + "47", + "48", + "49", + "50", + "1月", + "2月", + "3月", + "4月", + "5月", + "6月", + "7月", + "8月", + "9月", + "10月", + "11月", + "12月", + "hg", + "erg", + "ev", + "ltd", + "ア", + "イ", + "ウ", + "エ", + "オ", + "カ", + "キ", + "ク", + "ケ", + "コ", + "サ", + "シ", + "ス", + "セ", + "ソ", + "タ", + "チ", + "ツ", + "テ", + "ト", + "ナ", + "ニ", + "ヌ", + "ネ", + "ノ", + "ハ", + "ヒ", + "フ", + "ヘ", + "ホ", + "マ", + "ミ", + "ム", + "メ", + "モ", + "ヤ", + "ユ", + "ヨ", + "ラ", + "リ", + "ル", + "レ", + "ロ", + "ワ", + "ヰ", + "ヱ", + "ヲ", + "令和", + "アパート", + "アルファ", + "アンペア", + "アール", + "イニング", + "インチ", + "ウォン", + "エスクード", + "エーカー", + "オンス", + "オーム", + "カイリ", + "カラット", + "カロリー", + "ガロン", + "ガンマ", + "ギガ", + "ギニー", + "キュリー", + "ギルダー", + "キロ", + "キログラム", + "キロメートル", + "キロワット", + "グラム", + "グラムトン", + "クルゼイロ", + "クローネ", + "ケース", + "コルナ", + "コーポ", + "サイクル", + "サンチーム", + "シリング", + "センチ", + "セント", + "ダース", + "デシ", + "ドル", + "トン", + "ナノ", + "ノット", + "ハイツ", + "パーセント", + "パーツ", + "バーレル", + "ピアストル", + "ピクル", + "ピコ", + "ビル", + "ファラッド", + "フィート", + "ブッシェル", + "フラン", + "ヘクタール", + "ペソ", + "ペニヒ", + "ヘルツ", + "ペンス", + "ページ", + "ベータ", + "ポイント", + "ボルト", + "ホン", + "ポンド", + "ホール", + "ホーン", + "マイクロ", + "マイル", + "マッハ", + "マルク", + "マンション", + "ミクロン", + "ミリ", + "ミリバール", + "メガ", + "メガトン", + "メートル", + "ヤード", + "ヤール", + "ユアン", + "リットル", + "リラ", + "ルピー", + "ルーブル", + "レム", + "レントゲン", + "ワット", + "0点", + "1点", + "2点", + "3点", + "4点", + "5点", + "6点", + "7点", + "8点", + "9点", + "10点", + "11点", + "12点", + "13点", + "14点", + "15点", + "16点", + "17点", + "18点", + "19点", + "20点", + "21点", + "22点", + "23点", + "24点", + "hpa", + "da", + "au", + "bar", + "ov", + "pc", + "dm", + "dm2", + "dm3", + "iu", + "平成", + "昭和", + "大正", + "明治", + "株式会社", + "pa", + "na", + "μa", + "ma", + "ka", + "kb", + "mb", + "gb", + "cal", + "kcal", + "pf", + "nf", + "μf", + "μg", + "mg", + "kg", + "hz", + "khz", + "mhz", + "ghz", + "thz", + "μl", + "ml", + "dl", + "kl", + "fm", + "nm", + "μm", + "mm", + "cm", + "km", + "mm2", + "cm2", + "m2", + "km2", + "mm3", + "cm3", + "m3", + "km3", + "m∕s", + "m∕s2", + "pa", + "kpa", + "mpa", + "gpa", + "rad", + "rad∕s", + "rad∕s2", + "ps", + "ns", + "μs", + "ms", + "pv", + "nv", + "μv", + "mv", + "kv", + "mv", + "pw", + "nw", + "μw", + "mw", + "kw", + "mw", + "kω", + "mω", + None, + "bq", + "cc", + "cd", + "c∕kg", + None, + "db", + "gy", + "ha", + "hp", + "in", + "kk", + "km", + "kt", + "lm", + "ln", + "log", + "lx", + "mb", + "mil", + "mol", + "ph", + None, + "ppm", + "pr", + "sr", + "sv", + "wb", + "v∕m", + "a∕m", + "1日", + "2日", + "3日", + "4日", + "5日", + "6日", + "7日", + "8日", + "9日", + "10日", + "11日", + "12日", + "13日", + "14日", + "15日", + "16日", + "17日", + "18日", + "19日", + "20日", + "21日", + "22日", + "23日", + "24日", + "25日", + "26日", + "27日", + "28日", + "29日", + "30日", + "31日", + "gal", + None, + None, + None, + None, + None, + None, + "ꙁ", + None, + "ꙃ", + None, + "ꙅ", + None, + "ꙇ", + None, + "ꙉ", + None, + "ꙋ", + None, + "ꙍ", + None, + "ꙏ", + None, + "ꙑ", + None, + "ꙓ", + None, + "ꙕ", + None, + "ꙗ", + None, + "ꙙ", + None, + "ꙛ", + None, + "ꙝ", + None, + "ꙟ", + None, + "ꙡ", + None, + "ꙣ", + None, + "ꙥ", + None, + "ꙧ", + None, + "ꙩ", + None, + "ꙫ", + None, + "ꙭ", + None, + "ꚁ", + None, + "ꚃ", + None, + "ꚅ", + None, + "ꚇ", + None, + "ꚉ", + None, + "ꚋ", + None, + "ꚍ", + None, + "ꚏ", + None, + "ꚑ", + None, + "ꚓ", + None, + "ꚕ", + None, + "ꚗ", + None, + "ꚙ", + None, + "ꚛ", + None, + "ъ", + "ь", + None, + None, + None, + "ꜣ", + None, + "ꜥ", + None, + "ꜧ", + None, + "ꜩ", + None, + "ꜫ", + None, + "ꜭ", + None, + "ꜯ", + None, + "ꜳ", + None, + "ꜵ", + None, + "ꜷ", + None, + "ꜹ", + None, + "ꜻ", + None, + "ꜽ", + None, + "ꜿ", + None, + "ꝁ", + None, + "ꝃ", + None, + "ꝅ", + None, + "ꝇ", + None, + "ꝉ", + None, + "ꝋ", + None, + "ꝍ", + None, + "ꝏ", + None, + "ꝑ", + None, + "ꝓ", + None, + "ꝕ", + None, + "ꝗ", + None, + "ꝙ", + None, + "ꝛ", + None, + "ꝝ", + None, + "ꝟ", + None, + "ꝡ", + None, + "ꝣ", + None, + "ꝥ", + None, + "ꝧ", + None, + "ꝩ", + None, + "ꝫ", + None, + "ꝭ", + None, + "ꝯ", + None, + "ꝯ", + None, + "ꝺ", + None, + "ꝼ", + None, + "ᵹ", + "ꝿ", + None, + "ꞁ", + None, + "ꞃ", + None, + "ꞅ", + None, + "ꞇ", + None, + "ꞌ", + None, + "ɥ", + None, + "ꞑ", + None, + "ꞓ", + None, + "ꞗ", + None, + "ꞙ", + None, + "ꞛ", + None, + "ꞝ", + None, + "ꞟ", + None, + "ꞡ", + None, + "ꞣ", + None, + "ꞥ", + None, + "ꞧ", + None, + "ꞩ", + None, + "ɦ", + "ɜ", + "ɡ", + "ɬ", + "ɪ", + None, + "ʞ", + "ʇ", + "ʝ", + "ꭓ", + "ꞵ", + None, + "ꞷ", + None, + "ꞹ", + None, + "ꞻ", + None, + "ꞽ", + None, + "ꞿ", + None, + "ꟁ", + None, + "ꟃ", + None, + "ꞔ", + "ʂ", + "ᶎ", + "ꟈ", + None, + "ꟊ", + None, + "ɤ", + "ꟍ", + None, + "꟏", + None, + "ꟑ", + None, + "ꟓ", + None, + "ꟕ", + None, + "ꟗ", + None, + "ꟙ", + None, + "ꟛ", + None, + "ƛ", + "ɷ", + None, + "ɼ", + None, + "s", + "c", + "f", + "q", + "ꟶ", + None, + "ħ", + "œ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ꜧ", + "ꬷ", + "ɫ", + "ꭒ", + None, + "ʍ", + None, + "ꭋ", + "ꭌ", + None, + "Ꭰ", + "Ꭱ", + "Ꭲ", + "Ꭳ", + "Ꭴ", + "Ꭵ", + "Ꭶ", + "Ꭷ", + "Ꭸ", + "Ꭹ", + "Ꭺ", + "Ꭻ", + "Ꭼ", + "Ꭽ", + "Ꭾ", + "Ꭿ", + "Ꮀ", + "Ꮁ", + "Ꮂ", + "Ꮃ", + "Ꮄ", + "Ꮅ", + "Ꮆ", + "Ꮇ", + "Ꮈ", + "Ꮉ", + "Ꮊ", + "Ꮋ", + "Ꮌ", + "Ꮍ", + "Ꮎ", + "Ꮏ", + "Ꮐ", + "Ꮑ", + "Ꮒ", + "Ꮓ", + "Ꮔ", + "Ꮕ", + "Ꮖ", + "Ꮗ", + "Ꮘ", + "Ꮙ", + "Ꮚ", + "Ꮛ", + "Ꮜ", + "Ꮝ", + "Ꮞ", + "Ꮟ", + "Ꮠ", + "Ꮡ", + "Ꮢ", + "Ꮣ", + "Ꮤ", + "Ꮥ", + "Ꮦ", + "Ꮧ", + "Ꮨ", + "Ꮩ", + "Ꮪ", + "Ꮫ", + "Ꮬ", + "Ꮭ", + "Ꮮ", + "Ꮯ", + "Ꮰ", + "Ꮱ", + "Ꮲ", + "Ꮳ", + "Ꮴ", + "Ꮵ", + "Ꮶ", + "Ꮷ", + "Ꮸ", + "Ꮹ", + "Ꮺ", + "Ꮻ", + "Ꮼ", + "Ꮽ", + "Ꮾ", + "Ꮿ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "豈", + "更", + "車", + "賈", + "滑", + "串", + "句", + "龜", + "契", + "金", + "喇", + "奈", + "懶", + "癩", + "羅", + "蘿", + "螺", + "裸", + "邏", + "樂", + "洛", + "烙", + "珞", + "落", + "酪", + "駱", + "亂", + "卵", + "欄", + "爛", + "蘭", + "鸞", + "嵐", + "濫", + "藍", + "襤", + "拉", + "臘", + "蠟", + "廊", + "朗", + "浪", + "狼", + "郎", + "來", + "冷", + "勞", + "擄", + "櫓", + "爐", + "盧", + "老", + "蘆", + "虜", + "路", + "露", + "魯", + "鷺", + "碌", + "祿", + "綠", + "菉", + "錄", + "鹿", + "論", + "壟", + "弄", + "籠", + "聾", + "牢", + "磊", + "賂", + "雷", + "壘", + "屢", + "樓", + "淚", + "漏", + "累", + "縷", + "陋", + "勒", + "肋", + "凜", + "凌", + "稜", + "綾", + "菱", + "陵", + "讀", + "拏", + "樂", + "諾", + "丹", + "寧", + "怒", + "率", + "異", + "北", + "磻", + "便", + "復", + "不", + "泌", + "數", + "索", + "參", + "塞", + "省", + "葉", + "說", + "殺", + "辰", + "沈", + "拾", + "若", + "掠", + "略", + "亮", + "兩", + "凉", + "梁", + "糧", + "良", + "諒", + "量", + "勵", + "呂", + "女", + "廬", + "旅", + "濾", + "礪", + "閭", + "驪", + "麗", + "黎", + "力", + "曆", + "歷", + "轢", + "年", + "憐", + "戀", + "撚", + "漣", + "煉", + "璉", + "秊", + "練", + "聯", + "輦", + "蓮", + "連", + "鍊", + "列", + "劣", + "咽", + "烈", + "裂", + "說", + "廉", + "念", + "捻", + "殮", + "簾", + "獵", + "令", + "囹", + "寧", + "嶺", + "怜", + "玲", + "瑩", + "羚", + "聆", + "鈴", + "零", + "靈", + "領", + "例", + "禮", + "醴", + "隸", + "惡", + "了", + "僚", + "寮", + "尿", + "料", + "樂", + "燎", + "療", + "蓼", + "遼", + "龍", + "暈", + "阮", + "劉", + "杻", + "柳", + "流", + "溜", + "琉", + "留", + "硫", + "紐", + "類", + "六", + "戮", + "陸", + "倫", + "崙", + "淪", + "輪", + "律", + "慄", + "栗", + "率", + "隆", + "利", + "吏", + "履", + "易", + "李", + "梨", + "泥", + "理", + "痢", + "罹", + "裏", + "裡", + "里", + "離", + "匿", + "溺", + "吝", + "燐", + "璘", + "藺", + "隣", + "鱗", + "麟", + "林", + "淋", + "臨", + "立", + "笠", + "粒", + "狀", + "炙", + "識", + "什", + "茶", + "刺", + "切", + "度", + "拓", + "糖", + "宅", + "洞", + "暴", + "輻", + "行", + "降", + "見", + "廓", + "兀", + "嗀", + None, + "塚", + None, + "晴", + None, + "凞", + "猪", + "益", + "礼", + "神", + "祥", + "福", + "靖", + "精", + "羽", + None, + "蘒", + None, + "諸", + None, + "逸", + "都", + None, + "飯", + "飼", + "館", + "鶴", + "郞", + "隷", + "侮", + "僧", + "免", + "勉", + "勤", + "卑", + "喝", + "嘆", + "器", + "塀", + "墨", + "層", + "屮", + "悔", + "慨", + "憎", + "懲", + "敏", + "既", + "暑", + "梅", + "海", + "渚", + "漢", + "煮", + "爫", + "琢", + "碑", + "社", + "祉", + "祈", + "祐", + "祖", + "祝", + "禍", + "禎", + "穀", + "突", + "節", + "練", + "縉", + "繁", + "署", + "者", + "臭", + "艹", + "著", + "褐", + "視", + "謁", + "謹", + "賓", + "贈", + "辶", + "逸", + "難", + "響", + "頻", + "恵", + "𤋮", + "舘", + None, + "並", + "况", + "全", + "侀", + "充", + "冀", + "勇", + "勺", + "喝", + "啕", + "喙", + "嗢", + "塚", + "墳", + "奄", + "奔", + "婢", + "嬨", + "廒", + "廙", + "彩", + "徭", + "惘", + "慎", + "愈", + "憎", + "慠", + "懲", + "戴", + "揄", + "搜", + "摒", + "敖", + "晴", + "朗", + "望", + "杖", + "歹", + "殺", + "流", + "滛", + "滋", + "漢", + "瀞", + "煮", + "瞧", + "爵", + "犯", + "猪", + "瑱", + "甆", + "画", + "瘝", + "瘟", + "益", + "盛", + "直", + "睊", + "着", + "磌", + "窱", + "節", + "类", + "絛", + "練", + "缾", + "者", + "荒", + "華", + "蝹", + "襁", + "覆", + "視", + "調", + "諸", + "請", + "謁", + "諾", + "諭", + "謹", + "變", + "贈", + "輸", + "遲", + "醙", + "鉶", + "陼", + "難", + "靖", + "韛", + "響", + "頋", + "頻", + "鬒", + "龜", + "𢡊", + "𢡄", + "𣏕", + "㮝", + "䀘", + "䀹", + "𥉉", + "𥳐", + "𧻓", + "齃", + "龎", + None, + "ff", + "fi", + "fl", + "ffi", + "ffl", + "st", + None, + "մն", + "մե", + "մի", + "վն", + "մխ", + None, + "יִ", + None, + "ײַ", + "ע", + "א", + "ד", + "ה", + "כ", + "ל", + "ם", + "ר", + "ת", + "+", + "שׁ", + "שׂ", + "שּׁ", + "שּׂ", + "אַ", + "אָ", + "אּ", + "בּ", + "גּ", + "דּ", + "הּ", + "וּ", + "זּ", + None, + "טּ", + "יּ", + "ךּ", + "כּ", + "לּ", + None, + "מּ", + None, + "נּ", + "סּ", + None, + "ףּ", + "פּ", + None, + "צּ", + "קּ", + "רּ", + "שּ", + "תּ", + "וֹ", + "בֿ", + "כֿ", + "פֿ", + "אל", + "ٱ", + "ٻ", + "پ", + "ڀ", + "ٺ", + "ٿ", + "ٹ", + "ڤ", + "ڦ", + "ڄ", + "ڃ", + "چ", + "ڇ", + "ڍ", + "ڌ", + "ڎ", + "ڈ", + "ژ", + "ڑ", + "ک", + "گ", + "ڳ", + "ڱ", + "ں", + "ڻ", + "ۀ", + "ہ", + "ھ", + "ے", + "ۓ", + None, + "ڭ", + "ۇ", + "ۆ", + "ۈ", + "ۇٴ", + "ۋ", + "ۅ", + "ۉ", + "ې", + "ى", + "ئا", + "ئە", + "ئو", + "ئۇ", + "ئۆ", + "ئۈ", + "ئې", + "ئى", + "ی", + "ئج", + "ئح", + "ئم", + "ئى", + "ئي", + "بج", + "بح", + "بخ", + "بم", + "بى", + "بي", + "تج", + "تح", + "تخ", + "تم", + "تى", + "تي", + "ثج", + "ثم", + "ثى", + "ثي", + "جح", + "جم", + "حج", + "حم", + "خج", + "خح", + "خم", + "سج", + "سح", + "سخ", + "سم", + "صح", + "صم", + "ضج", + "ضح", + "ضخ", + "ضم", + "طح", + "طم", + "ظم", + "عج", + "عم", + "غج", + "غم", + "فج", + "فح", + "فخ", + "فم", + "فى", + "في", + "قح", + "قم", + "قى", + "قي", + "كا", + "كج", + "كح", + "كخ", + "كل", + "كم", + "كى", + "كي", + "لج", + "لح", + "لخ", + "لم", + "لى", + "لي", + "مج", + "مح", + "مخ", + "مم", + "مى", + "مي", + "نج", + "نح", + "نخ", + "نم", + "نى", + "ني", + "هج", + "هم", + "هى", + "هي", + "يج", + "يح", + "يخ", + "يم", + "يى", + "يي", + "ذٰ", + "رٰ", + "ىٰ", + " ٌّ", + " ٍّ", + " َّ", + " ُّ", + " ِّ", + " ّٰ", + "ئر", + "ئز", + "ئم", + "ئن", + "ئى", + "ئي", + "بر", + "بز", + "بم", + "بن", + "بى", + "بي", + "تر", + "تز", + "تم", + "تن", + "تى", + "تي", + "ثر", + "ثز", + "ثم", + "ثن", + "ثى", + "ثي", + "فى", + "في", + "قى", + "قي", + "كا", + "كل", + "كم", + "كى", + "كي", + "لم", + "لى", + "لي", + "ما", + "مم", + "نر", + "نز", + "نم", + "نن", + "نى", + "ني", + "ىٰ", + "ير", + "يز", + "يم", + "ين", + "يى", + "يي", + "ئج", + "ئح", + "ئخ", + "ئم", + "ئه", + "بج", + "بح", + "بخ", + "بم", + "به", + "تج", + "تح", + "تخ", + "تم", + "ته", + "ثم", + "جح", + "جم", + "حج", + "حم", + "خج", + "خم", + "سج", + "سح", + "سخ", + "سم", + "صح", + "صخ", + "صم", + "ضج", + "ضح", + "ضخ", + "ضم", + "طح", + "ظم", + "عج", + "عم", + "غج", + "غم", + "فج", + "فح", + "فخ", + "فم", + "قح", + "قم", + "كج", + "كح", + "كخ", + "كل", + "كم", + "لج", + "لح", + "لخ", + "لم", + "له", + "مج", + "مح", + "مخ", + "مم", + "نج", + "نح", + "نخ", + "نم", + "نه", + "هج", + "هم", + "هٰ", + "يج", + "يح", + "يخ", + "يم", + "يه", + "ئم", + "ئه", + "بم", + "به", + "تم", + "ته", + "ثم", + "ثه", + "سم", + "سه", + "شم", + "شه", + "كل", + "كم", + "لم", + "نم", + "نه", + "يم", + "يه", + "ـَّ", + "ـُّ", + "ـِّ", + "طى", + "طي", + "عى", + "عي", + "غى", + "غي", + "سى", + "سي", + "شى", + "شي", + "حى", + "حي", + "جى", + "جي", + "خى", + "خي", + "صى", + "صي", + "ضى", + "ضي", + "شج", + "شح", + "شخ", + "شم", + "شر", + "سر", + "صر", + "ضر", + "طى", + "طي", + "عى", + "عي", + "غى", + "غي", + "سى", + "سي", + "شى", + "شي", + "حى", + "حي", + "جى", + "جي", + "خى", + "خي", + "صى", + "صي", + "ضى", + "ضي", + "شج", + "شح", + "شخ", + "شم", + "شر", + "سر", + "صر", + "ضر", + "شج", + "شح", + "شخ", + "شم", + "سه", + "شه", + "طم", + "سج", + "سح", + "سخ", + "شج", + "شح", + "شخ", + "طم", + "ظم", + "اً", + None, + "تجم", + "تحج", + "تحم", + "تخم", + "تمج", + "تمح", + "تمخ", + "جمح", + "حمي", + "حمى", + "سحج", + "سجح", + "سجى", + "سمح", + "سمج", + "سمم", + "صحح", + "صمم", + "شحم", + "شجي", + "شمخ", + "شمم", + "ضحى", + "ضخم", + "طمح", + "طمم", + "طمي", + "عجم", + "عمم", + "عمى", + "غمم", + "غمي", + "غمى", + "فخم", + "قمح", + "قمم", + "لحم", + "لحي", + "لحى", + "لجج", + "لخم", + "لمح", + "محج", + "محم", + "محي", + "مجح", + "مجم", + "مخج", + "مخم", + None, + "مجخ", + "همج", + "همم", + "نحم", + "نحى", + "نجم", + "نجى", + "نمي", + "نمى", + "يمم", + "بخي", + "تجي", + "تجى", + "تخي", + "تخى", + "تمي", + "تمى", + "جمي", + "جحى", + "جمى", + "سخى", + "صحي", + "شحي", + "ضحي", + "لجي", + "لمي", + "يحي", + "يجي", + "يمي", + "ممي", + "قمي", + "نحي", + "قمح", + "لحم", + "عمي", + "كمي", + "نجح", + "مخي", + "لجم", + "كمم", + "لجم", + "نجح", + "جحي", + "حجي", + "مجي", + "فمي", + "بحي", + "كمم", + "عجم", + "صمم", + "سخي", + "نجي", + None, + None, + "صلے", + "قلے", + "الله", + "اكبر", + "محمد", + "صلعم", + "رسول", + "عليه", + "وسلم", + "صلى", + "صلى الله عليه وسلم", + "جل جلاله", + "ریال", + None, + None, + ",", + "、", + None, + ":", + ";", + "!", + "?", + "〖", + "〗", + None, + None, + None, + "—", + "–", + "_", + "(", + ")", + "{", + "}", + "〔", + "〕", + "【", + "】", + "《", + "》", + "〈", + "〉", + "「", + "」", + "『", + "』", + None, + "[", + "]", + " ̅", + "_", + ",", + "、", + None, + ";", + ":", + "?", + "!", + "—", + "(", + ")", + "{", + "}", + "〔", + "〕", + "#", + "&", + "*", + "+", + "-", + "<", + ">", + "=", + None, + "\\", + "$", + "%", + "@", + None, + " ً", + "ـً", + " ٌ", + None, + " ٍ", + None, + " َ", + "ـَ", + " ُ", + "ـُ", + " ِ", + "ـِ", + " ّ", + "ـّ", + " ْ", + "ـْ", + "ء", + "آ", + "أ", + "ؤ", + "إ", + "ئ", + "ا", + "ب", + "ة", + "ت", + "ث", + "ج", + "ح", + "خ", + "د", + "ذ", + "ر", + "ز", + "س", + "ش", + "ص", + "ض", + "ط", + "ظ", + "ع", + "غ", + "ف", + "ق", + "ك", + "ل", + "م", + "ن", + "ه", + "و", + "ى", + "ي", + "لآ", + "لأ", + "لإ", + "لا", + None, + None, + None, + "!", + '"', + "#", + "$", + "%", + "&", + "'", + "(", + ")", + "*", + "+", + ",", + "-", + ".", + "/", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + ":", + ";", + "<", + "=", + ">", + "?", + "@", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "[", + "\\", + "]", + "^", + "_", + "`", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "{", + "|", + "}", + "~", + "⦅", + "⦆", + ".", + "「", + "」", + "、", + "・", + "ヲ", + "ァ", + "ィ", + "ゥ", + "ェ", + "ォ", + "ャ", + "ュ", + "ョ", + "ッ", + "ー", + "ア", + "イ", + "ウ", + "エ", + "オ", + "カ", + "キ", + "ク", + "ケ", + "コ", + "サ", + "シ", + "ス", + "セ", + "ソ", + "タ", + "チ", + "ツ", + "テ", + "ト", + "ナ", + "ニ", + "ヌ", + "ネ", + "ノ", + "ハ", + "ヒ", + "フ", + "ヘ", + "ホ", + "マ", + "ミ", + "ム", + "メ", + "モ", + "ヤ", + "ユ", + "ヨ", + "ラ", + "リ", + "ル", + "レ", + "ロ", + "ワ", + "ン", + "゙", + "゚", + None, + "ᄀ", + "ᄁ", + "ᆪ", + "ᄂ", + "ᆬ", + "ᆭ", + "ᄃ", + "ᄄ", + "ᄅ", + "ᆰ", + "ᆱ", + "ᆲ", + "ᆳ", + "ᆴ", + "ᆵ", + "ᄚ", + "ᄆ", + "ᄇ", + "ᄈ", + "ᄡ", + "ᄉ", + "ᄊ", + "ᄋ", + "ᄌ", + "ᄍ", + "ᄎ", + "ᄏ", + "ᄐ", + "ᄑ", + "ᄒ", + None, + "ᅡ", + "ᅢ", + "ᅣ", + "ᅤ", + "ᅥ", + "ᅦ", + None, + "ᅧ", + "ᅨ", + "ᅩ", + "ᅪ", + "ᅫ", + "ᅬ", + None, + "ᅭ", + "ᅮ", + "ᅯ", + "ᅰ", + "ᅱ", + "ᅲ", + None, + "ᅳ", + "ᅴ", + "ᅵ", + None, + "¢", + "£", + "¬", + " ̄", + "¦", + "¥", + "₩", + None, + "│", + "←", + "↑", + "→", + "↓", + "■", + "○", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "𐐨", + "𐐩", + "𐐪", + "𐐫", + "𐐬", + "𐐭", + "𐐮", + "𐐯", + "𐐰", + "𐐱", + "𐐲", + "𐐳", + "𐐴", + "𐐵", + "𐐶", + "𐐷", + "𐐸", + "𐐹", + "𐐺", + "𐐻", + "𐐼", + "𐐽", + "𐐾", + "𐐿", + "𐑀", + "𐑁", + "𐑂", + "𐑃", + "𐑄", + "𐑅", + "𐑆", + "𐑇", + "𐑈", + "𐑉", + "𐑊", + "𐑋", + "𐑌", + "𐑍", + "𐑎", + "𐑏", + None, + None, + None, + None, + "𐓘", + "𐓙", + "𐓚", + "𐓛", + "𐓜", + "𐓝", + "𐓞", + "𐓟", + "𐓠", + "𐓡", + "𐓢", + "𐓣", + "𐓤", + "𐓥", + "𐓦", + "𐓧", + "𐓨", + "𐓩", + "𐓪", + "𐓫", + "𐓬", + "𐓭", + "𐓮", + "𐓯", + "𐓰", + "𐓱", + "𐓲", + "𐓳", + "𐓴", + "𐓵", + "𐓶", + "𐓷", + "𐓸", + "𐓹", + "𐓺", + "𐓻", + None, + None, + None, + None, + None, + None, + None, + None, + "𐖗", + "𐖘", + "𐖙", + "𐖚", + "𐖛", + "𐖜", + "𐖝", + "𐖞", + "𐖟", + "𐖠", + "𐖡", + None, + "𐖣", + "𐖤", + "𐖥", + "𐖦", + "𐖧", + "𐖨", + "𐖩", + "𐖪", + "𐖫", + "𐖬", + "𐖭", + "𐖮", + "𐖯", + "𐖰", + "𐖱", + None, + "𐖳", + "𐖴", + "𐖵", + "𐖶", + "𐖷", + "𐖸", + "𐖹", + None, + "𐖻", + "𐖼", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ː", + "ˑ", + "æ", + "ʙ", + "ɓ", + None, + "ʣ", + "ꭦ", + "ʥ", + "ʤ", + "ɖ", + "ɗ", + "ᶑ", + "ɘ", + "ɞ", + "ʩ", + "ɤ", + "ɢ", + "ɠ", + "ʛ", + "ħ", + "ʜ", + "ɧ", + "ʄ", + "ʪ", + "ʫ", + "ɬ", + "𝼄", + "ꞎ", + "ɮ", + "𝼅", + "ʎ", + "𝼆", + "ø", + "ɶ", + "ɷ", + "q", + "ɺ", + "𝼈", + "ɽ", + "ɾ", + "ʀ", + "ʨ", + "ʦ", + "ꭧ", + "ʧ", + "ʈ", + "ⱱ", + None, + "ʏ", + "ʡ", + "ʢ", + "ʘ", + "ǀ", + "ǁ", + "ǂ", + "𝼊", + "𝼞", + "ʇ", + "ʖ", + "ʗ", + "ʞ", + "𝼋", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "𐳀", + "𐳁", + "𐳂", + "𐳃", + "𐳄", + "𐳅", + "𐳆", + "𐳇", + "𐳈", + "𐳉", + "𐳊", + "𐳋", + "𐳌", + "𐳍", + "𐳎", + "𐳏", + "𐳐", + "𐳑", + "𐳒", + "𐳓", + "𐳔", + "𐳕", + "𐳖", + "𐳗", + "𐳘", + "𐳙", + "𐳚", + "𐳛", + "𐳜", + "𐳝", + "𐳞", + "𐳟", + "𐳠", + "𐳡", + "𐳢", + "𐳣", + "𐳤", + "𐳥", + "𐳦", + "𐳧", + "𐳨", + "𐳩", + "𐳪", + "𐳫", + "𐳬", + "𐳭", + "𐳮", + "𐳯", + "𐳰", + "𐳱", + "𐳲", + None, + None, + None, + None, + None, + None, + None, + None, + "𐵰", + "𐵱", + "𐵲", + "𐵳", + "𐵴", + "𐵵", + "𐵶", + "𐵷", + "𐵸", + "𐵹", + "𐵺", + "𐵻", + "𐵼", + "𐵽", + "𐵾", + "𐵿", + "𐶀", + "𐶁", + "𐶂", + "𐶃", + "𐶄", + "𐶅", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "𑣀", + "𑣁", + "𑣂", + "𑣃", + "𑣄", + "𑣅", + "𑣆", + "𑣇", + "𑣈", + "𑣉", + "𑣊", + "𑣋", + "𑣌", + "𑣍", + "𑣎", + "𑣏", + "𑣐", + "𑣑", + "𑣒", + "𑣓", + "𑣔", + "𑣕", + "𑣖", + "𑣗", + "𑣘", + "𑣙", + "𑣚", + "𑣛", + "𑣜", + "𑣝", + "𑣞", + "𑣟", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "𖹠", + "𖹡", + "𖹢", + "𖹣", + "𖹤", + "𖹥", + "𖹦", + "𖹧", + "𖹨", + "𖹩", + "𖹪", + "𖹫", + "𖹬", + "𖹭", + "𖹮", + "𖹯", + "𖹰", + "𖹱", + "𖹲", + "𖹳", + "𖹴", + "𖹵", + "𖹶", + "𖹷", + "𖹸", + "𖹹", + "𖹺", + "𖹻", + "𖹼", + "𖹽", + "𖹾", + "𖹿", + None, + None, + "𖺻", + "𖺼", + "𖺽", + "𖺾", + "𖺿", + "𖻀", + "𖻁", + "𖻂", + "𖻃", + "𖻄", + "𖻅", + "𖻆", + "𖻇", + "𖻈", + "𖻉", + "𖻊", + "𖻋", + "𖻌", + "𖻍", + "𖻎", + "𖻏", + "𖻐", + "𖻑", + "𖻒", + "𖻓", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "こと", + "トキ", + "トテ", + "ヨリ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "𝅗𝅥", + "𝅘𝅥", + "𝅘𝅥𝅮", + "𝅘𝅥𝅯", + "𝅘𝅥𝅰", + "𝅘𝅥𝅱", + "𝅘𝅥𝅲", + None, + None, + None, + "𝆹𝅥", + "𝆺𝅥", + "𝆹𝅥𝅮", + "𝆺𝅥𝅮", + "𝆹𝅥𝅯", + "𝆺𝅥𝅯", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + None, + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + None, + "c", + "d", + None, + "g", + None, + "j", + "k", + None, + "n", + "o", + "p", + "q", + None, + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + None, + "f", + None, + "h", + "i", + "j", + "k", + "l", + "m", + "n", + None, + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + None, + "d", + "e", + "f", + "g", + None, + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + None, + "s", + "t", + "u", + "v", + "w", + "x", + "y", + None, + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + None, + "d", + "e", + "f", + "g", + None, + "i", + "j", + "k", + "l", + "m", + None, + "o", + None, + "s", + "t", + "u", + "v", + "w", + "x", + "y", + None, + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "ı", + "ȷ", + "ss", + None, + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "θ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∇", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∂", + "ε", + "θ", + "κ", + "φ", + "ρ", + "π", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "θ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∇", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∂", + "ε", + "θ", + "κ", + "φ", + "ρ", + "π", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "θ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∇", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∂", + "ε", + "θ", + "κ", + "φ", + "ρ", + "π", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "θ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∇", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∂", + "ε", + "θ", + "κ", + "φ", + "ρ", + "π", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "θ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∇", + "α", + "β", + "γ", + "δ", + "ε", + "ζ", + "η", + "θ", + "ι", + "κ", + "λ", + "μ", + "ν", + "ξ", + "ο", + "π", + "ρ", + "σ", + "τ", + "υ", + "φ", + "χ", + "ψ", + "ω", + "∂", + "ε", + "θ", + "κ", + "φ", + "ρ", + "π", + "ϝ", + None, + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + None, + None, + None, + None, + None, + None, + None, + None, + None, + "𝽁", + None, + "𝽉", + None, + "𝽋", + None, + "𝽎", + None, + "𝽒", + None, + "𝽩", + None, + "𝽫", + None, + "𝽭", + None, + "𝽯", + None, + "𝽳", + None, + "𝽵", + None, + "𝽷", + None, + "𝽹", + None, + "𝽻", + None, + "𝽽", + None, + "𝽿", + None, + None, + None, + "ss", + None, + None, + "𝽗", + "𝽘", + "𝽙", + "ɣ", + "ᴘ", + "ƀ", + "đ", + "ǥ", + "ł", + "ƚ", + "𝽐", + "𝼾", + "ɉ", + "ᵿ", + "𝼿", + "ƞ", + "ɼ", + "ȸ", + "ȹ", + "𝼫", + "𝼙", + "ʆ", + "ᶘ", + "𝼬", + "𝼜", + "ʓ", + "ᶚ", + "ᴅ", + "ᴀ", + "ᴇ", + "ɿ", + "ʅ", + "ʮ", + "ʯ", + "ȡ", + "ȴ", + "ȵ", + "ȶ", + "ψ", + "ω", + "ᶁ", + "ꞕ", + "ᶇ", + "ᶊ", + "ᶎ", + "ƈ", + "ƙ", + "ƥ", + "ʠ", + "ƭ", + "𝼉", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "а", + "б", + "в", + "г", + "д", + "е", + "ж", + "з", + "и", + "к", + "л", + "м", + "о", + "п", + "р", + "с", + "т", + "у", + "ф", + "х", + "ц", + "ч", + "ш", + "ы", + "э", + "ю", + "ꚉ", + "ә", + "і", + "ј", + "ө", + "ү", + "ӏ", + "а", + "б", + "в", + "г", + "д", + "е", + "ж", + "з", + "и", + "к", + "л", + "о", + "п", + "с", + "у", + "ф", + "х", + "ц", + "ч", + "ш", + "ъ", + "ы", + "ґ", + "і", + "ѕ", + "џ", + "ҫ", + "ꙑ", + "ұ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "𞤢", + "𞤣", + "𞤤", + "𞤥", + "𞤦", + "𞤧", + "𞤨", + "𞤩", + "𞤪", + "𞤫", + "𞤬", + "𞤭", + "𞤮", + "𞤯", + "𞤰", + "𞤱", + "𞤲", + "𞤳", + "𞤴", + "𞤵", + "𞤶", + "𞤷", + "𞤸", + "𞤹", + "𞤺", + "𞤻", + "𞤼", + "𞤽", + "𞤾", + "𞤿", + "𞥀", + "𞥁", + "𞥂", + "𞥃", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "ا", + "ب", + "ج", + "د", + None, + "و", + "ز", + "ح", + "ط", + "ي", + "ك", + "ل", + "م", + "ن", + "س", + "ع", + "ف", + "ص", + "ق", + "ر", + "ش", + "ت", + "ث", + "خ", + "ذ", + "ض", + "ظ", + "غ", + "ٮ", + "ں", + "ڡ", + "ٯ", + None, + "ب", + "ج", + None, + "ه", + None, + "ح", + None, + "ي", + "ك", + "ل", + "م", + "ن", + "س", + "ع", + "ف", + "ص", + "ق", + None, + "ش", + "ت", + "ث", + "خ", + None, + "ض", + None, + "غ", + None, + "ج", + None, + "ح", + None, + "ي", + None, + "ل", + None, + "ن", + "س", + "ع", + None, + "ص", + "ق", + None, + "ش", + None, + "خ", + None, + "ض", + None, + "غ", + None, + "ں", + None, + "ٯ", + None, + "ب", + "ج", + None, + "ه", + None, + "ح", + "ط", + "ي", + "ك", + None, + "م", + "ن", + "س", + "ع", + "ف", + "ص", + "ق", + None, + "ش", + "ت", + "ث", + "خ", + None, + "ض", + "ظ", + "غ", + "ٮ", + None, + "ڡ", + None, + "ا", + "ب", + "ج", + "د", + "ه", + "و", + "ز", + "ح", + "ط", + "ي", + None, + "ل", + "م", + "ن", + "س", + "ع", + "ف", + "ص", + "ق", + "ر", + "ش", + "ت", + "ث", + "خ", + "ذ", + "ض", + "ظ", + "غ", + None, + "ب", + "ج", + "د", + None, + "و", + "ز", + "ح", + "ط", + "ي", + None, + "ل", + "م", + "ن", + "س", + "ع", + "ف", + "ص", + "ق", + "ر", + "ش", + "ت", + "ث", + "خ", + "ذ", + "ض", + "ظ", + "غ", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "0,", + "1,", + "2,", + "3,", + "4,", + "5,", + "6,", + "7,", + "8,", + "9,", + None, + "(a)", + "(b)", + "(c)", + "(d)", + "(e)", + "(f)", + "(g)", + "(h)", + "(i)", + "(j)", + "(k)", + "(l)", + "(m)", + "(n)", + "(o)", + "(p)", + "(q)", + "(r)", + "(s)", + "(t)", + "(u)", + "(v)", + "(w)", + "(x)", + "(y)", + "(z)", + "〔s〕", + "c", + "r", + "cd", + "wz", + None, + "a", + "b", + "c", + "d", + "e", + "f", + "g", + "h", + "i", + "j", + "k", + "l", + "m", + "n", + "o", + "p", + "q", + "r", + "s", + "t", + "u", + "v", + "w", + "x", + "y", + "z", + "hv", + "mv", + "sd", + "ss", + "ppv", + "wc", + None, + "mc", + "md", + "mr", + None, + "dj", + None, + None, + None, + "ほか", + "ココ", + "サ", + None, + "手", + "字", + "双", + "デ", + "二", + "多", + "解", + "天", + "交", + "映", + "無", + "料", + "前", + "後", + "再", + "新", + "初", + "終", + "生", + "販", + "声", + "吹", + "演", + "投", + "捕", + "一", + "三", + "遊", + "左", + "中", + "右", + "指", + "走", + "打", + "禁", + "空", + "合", + "満", + "有", + "月", + "申", + "割", + "営", + "配", + None, + "〔本〕", + "〔三〕", + "〔二〕", + "〔安〕", + "〔点〕", + "〔打〕", + "〔盗〕", + "〔勝〕", + "〔敗〕", + None, + "得", + "可", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "0", + "1", + "2", + "3", + "4", + "5", + "6", + "7", + "8", + "9", + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + None, + "丽", + "丸", + "乁", + "𠄢", + "你", + "侮", + "侻", + "倂", + "偺", + "備", + "僧", + "像", + "㒞", + "𠘺", + "免", + "兔", + "兤", + "具", + "𠔜", + "㒹", + "內", + "再", + "𠕋", + "冗", + "冤", + "仌", + "冬", + "况", + "𩇟", + "凵", + "刃", + "㓟", + "刻", + "剆", + "割", + "剷", + "㔕", + "勇", + "勉", + "勤", + "勺", + "包", + "匆", + "北", + "卉", + "卑", + "博", + "即", + "卽", + "卿", + "𠨬", + "灰", + "及", + "叟", + "𠭣", + "叫", + "叱", + "吆", + "咞", + "吸", + "呈", + "周", + "咢", + "哶", + "唐", + "啓", + "啣", + "善", + "喙", + "喫", + "喳", + "嗂", + "圖", + "嘆", + "圗", + "噑", + "噴", + "切", + "壮", + "城", + "埴", + "堍", + "型", + "堲", + "報", + "墬", + "𡓤", + "売", + "壷", + "夆", + "多", + "夢", + "奢", + "𡚨", + "𡛪", + "姬", + "娛", + "娧", + "姘", + "婦", + "㛮", + "㛼", + "嬈", + "嬾", + "𡧈", + "寃", + "寘", + "寧", + "寳", + "𡬘", + "寿", + "将", + "当", + "尢", + "㞁", + "屠", + "屮", + "峀", + "岍", + "𡷤", + "嵃", + "𡷦", + "嵮", + "嵫", + "嵼", + "巡", + "巢", + "㠯", + "巽", + "帨", + "帽", + "幩", + "㡢", + "𢆃", + "㡼", + "庰", + "庳", + "庶", + "廊", + "𪎒", + "廾", + "𢌱", + "舁", + "弢", + "㣇", + "𣊸", + "𦇚", + "形", + "彫", + "㣣", + "徚", + "忍", + "志", + "忹", + "悁", + "㤺", + "㤜", + "悔", + "𢛔", + "惇", + "慈", + "慌", + "慎", + "慌", + "慺", + "憎", + "憲", + "憤", + "憯", + "懞", + "懲", + "懶", + "成", + "戛", + "扝", + "抱", + "拔", + "捐", + "𢬌", + "挽", + "拼", + "捨", + "掃", + "揤", + "𢯱", + "搢", + "揅", + "掩", + "㨮", + "摩", + "摾", + "撝", + "摷", + "㩬", + "敏", + "敬", + "𣀊", + "旣", + "書", + "晉", + "㬙", + "暑", + "㬈", + "㫤", + "冒", + "冕", + "最", + "暜", + "肭", + "䏙", + "朗", + "望", + "朡", + "杞", + "杓", + "𣏃", + "㭉", + "柺", + "枅", + "桒", + "梅", + "𣑭", + "梎", + "栟", + "椔", + "㮝", + "楂", + "榣", + "槪", + "檨", + "𣚣", + "櫛", + "㰘", + "次", + "𣢧", + "歔", + "㱎", + "歲", + "殟", + "殺", + "殻", + "𣪍", + "𡴋", + "𣫺", + "汎", + "𣲼", + "沿", + "泍", + "汧", + "洖", + "派", + "海", + "流", + "浩", + "浸", + "涅", + "𣴞", + "洴", + "港", + "湮", + "㴳", + "滋", + "滇", + "𣻑", + "淹", + "潮", + "𣽞", + "𣾎", + "濆", + "瀹", + "瀞", + "瀛", + "㶖", + "灊", + "災", + "灷", + "炭", + "𠔥", + "煅", + "𤉣", + "熜", + "𤎫", + "爨", + "爵", + "牐", + "𤘈", + "犀", + "犕", + "𤜵", + "𤠔", + "獺", + "王", + "㺬", + "玥", + "㺸", + "瑇", + "瑜", + "瑱", + "璅", + "瓊", + "㼛", + "甤", + "𤰶", + "甾", + "𤲒", + "異", + "𢆟", + "瘐", + "𤾡", + "𤾸", + "𥁄", + "㿼", + "䀈", + "直", + "𥃳", + "𥃲", + "𥄙", + "𥄳", + "眞", + "真", + "睊", + "䀹", + "瞋", + "䁆", + "䂖", + "𥐝", + "硎", + "碌", + "磌", + "䃣", + "𥘦", + "祖", + "𥚚", + "𥛅", + "福", + "秫", + "䄯", + "穀", + "穊", + "穏", + "𥥼", + "𥪧", + "竮", + "䈂", + "𥮫", + "篆", + "築", + "䈧", + "𥲀", + "糒", + "䊠", + "糨", + "糣", + "紀", + "𥾆", + "絣", + "䌁", + "緇", + "縂", + "繅", + "䌴", + "𦈨", + "𦉇", + "䍙", + "𦋙", + "罺", + "𦌾", + "羕", + "翺", + "者", + "𦓚", + "𦔣", + "聠", + "𦖨", + "聰", + "𣍟", + "䏕", + "育", + "脃", + "䐋", + "脾", + "媵", + "𦞧", + "𦞵", + "𣎓", + "𣎜", + "舁", + "舄", + "辞", + "䑫", + "芑", + "芋", + "芝", + "劳", + "花", + "芳", + "芽", + "苦", + "𦬼", + "若", + "茝", + "荣", + "莭", + "茣", + "莽", + "菧", + "著", + "荓", + "菊", + "菌", + "菜", + "𦰶", + "𦵫", + "𦳕", + "䔫", + "蓱", + "蓳", + "蔖", + "𧏊", + "蕤", + "𦼬", + "䕝", + "䕡", + "𦾱", + "𧃒", + "䕫", + "虐", + "虜", + "虧", + "虩", + "蚩", + "蚈", + "蜎", + "蛢", + "蝹", + "蜨", + "蝫", + "螆", + "䗗", + "蟡", + "蠁", + "䗹", + "衠", + "衣", + "𧙧", + "裗", + "裞", + "䘵", + "裺", + "㒻", + "𧢮", + "𧥦", + "䚾", + "䛇", + "誠", + "諭", + "變", + "豕", + "𧲨", + "貫", + "賁", + "贛", + "起", + "𧼯", + "𠠄", + "跋", + "趼", + "跰", + "𠣞", + "軔", + "輸", + "𨗒", + "𨗭", + "邔", + "郱", + "鄑", + "𨜮", + "鄛", + "鈸", + "鋗", + "鋘", + "鉼", + "鏹", + "鐕", + "𨯺", + "開", + "䦕", + "閷", + "𨵷", + "䧦", + "雃", + "嶲", + "霣", + "𩅅", + "𩈚", + "䩮", + "䩶", + "韠", + "𩐊", + "䪲", + "𩒖", + "頋", + "頩", + "𩖶", + "飢", + "䬳", + "餩", + "馧", + "駂", + "駾", + "䯎", + "𩬰", + "鬒", + "鱀", + "鳽", + "䳎", + "䳭", + "鵧", + "𪃎", + "䳸", + "𪄅", + "𪈎", + "𪊑", + "麻", + "䵖", + "黹", + "黾", + "鼅", + "鼏", + "鼖", + "鼻", + "𪘀", + None, + None, + None, + None, + None, + None, + None, + None, + None, +) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/__init__.py index f3266b7..1bbdbba 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/__init__.py @@ -4,8 +4,8 @@ import os from .exceptions import * # noqa: F403 from .ext import ExtType, Timestamp -version = (1, 1, 2) -__version__ = "1.1.2" +version = (1, 2, 4) +__version__ = "1.2.4" if os.environ.get("MSGPACK_PUREPYTHON"): diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/ext.py b/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/ext.py index 9694819..abaaad9 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/ext.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/ext.py @@ -2,6 +2,8 @@ import datetime import struct from collections import namedtuple +_EPOCH = datetime.datetime(1970, 1, 1, tzinfo=datetime.timezone.utc) + class ExtType(namedtuple("ExtType", "code data")): """ExtType represents ext type in msgpack.""" @@ -156,8 +158,7 @@ class Timestamp: :rtype: `datetime.datetime` """ - utc = datetime.timezone.utc - return datetime.datetime.fromtimestamp(0, utc) + datetime.timedelta( + return _EPOCH + datetime.timedelta( seconds=self.seconds, microseconds=self.nanoseconds // 1000 ) @@ -167,4 +168,17 @@ class Timestamp: :rtype: Timestamp """ - return Timestamp(seconds=int(dt.timestamp()), nanoseconds=dt.microsecond * 1000) + # Use integer timedelta arithmetic (like the Cython packer) rather than + # ``int(dt.timestamp() // 1)``. ``datetime.timestamp()`` returns a float + # that cannot hold microsecond precision for datetimes far from the epoch, + # so it may round the whole-second part up while the exact ``microsecond`` + # is still used for the nanoseconds -- producing a Timestamp one second in + # the future (and OverflowError near datetime.max). + if dt.tzinfo is None: + # Match datetime.timestamp(): a naive datetime is treated as local time. + dt = dt.astimezone() + delta = dt - _EPOCH + return Timestamp( + seconds=delta.days * 86400 + delta.seconds, + nanoseconds=delta.microseconds * 1000, + ) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/fallback.py b/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/fallback.py index b02e47c..9151a6b 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/fallback.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/msgpack/fallback.py @@ -37,6 +37,17 @@ else: return [] +# frozendict is a builtin type added in Python 3.15 (PEP 814). +if sys.version_info >= (3, 15): + import builtins + + frozendict = builtins.frozendict +else: + + class frozendict: + pass + + from .exceptions import BufferFull, ExtraData, FormatError, OutOfData, StackError from .ext import ExtType, Timestamp @@ -52,7 +63,7 @@ TYPE_RAW = 3 TYPE_BIN = 4 TYPE_EXT = 5 -DEFAULT_RECURSE_LIMIT = 511 +DEFAULT_RECURSE_LIMIT = 1024 def _check_type_strict(obj, t, type=type, tuple=tuple): @@ -137,7 +148,7 @@ class Unpacker: If specified, unpacker reads serialized data from it and `.feed()` is not usable. :param int read_size: - Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`) + Used as `file_like.read(read_size)`. Must be equal to or smaller than *max_buffer_size*. :param bool use_list: If true, unpack msgpack array to Python list. @@ -328,7 +339,7 @@ class Unpacker: self._buf_checkpoint = 0 # Use extend here: INPLACE_ADD += doesn't reliably typecast memoryview in jython - self._buffer.extend(view) + self._buffer.extend(view if view.contiguous else view.tobytes()) view.release() def _consume(self): @@ -345,7 +356,8 @@ class Unpacker: def read_bytes(self, n): ret = self._read(n, raise_outofdata=False) self._consume() - return ret + # The C extension returns bytes. A bytearray slice cannot be a dict key. + return bytes(ret) def _read(self, n, raise_outofdata=True): # (int) -> bytearray @@ -490,10 +502,13 @@ class Unpacker: if execute == EX_READ_ARRAY_HEADER: if typ != TYPE_ARRAY: + # Leave the object unread, as the C extension does. + self._buff_i = self._buf_checkpoint raise ValueError("Expected array") return n if execute == EX_READ_MAP_HEADER: if typ != TYPE_MAP: + self._buff_i = self._buf_checkpoint raise ValueError("Expected map") return n # TODO should we eliminate the recursion? @@ -503,7 +518,7 @@ class Unpacker: # TODO check whether we need to call `list_hook` self._unpack(EX_SKIP) return - ret = newlist_hint(n) + ret = newlist_hint(min(n, 10000)) for i in range(n): ret.append(self._unpack(EX_CONSTRUCT)) if self._list_hook is not None: @@ -518,9 +533,15 @@ class Unpacker: self._unpack(EX_SKIP) return if self._object_pairs_hook is not None: - ret = self._object_pairs_hook( - (self._unpack(EX_CONSTRUCT), self._unpack(EX_CONSTRUCT)) for _ in range(n) - ) + # Pass a list, as the C extension does, so the whole map is + # consumed even if the hook does not iterate it. + pairs = [] + for _ in range(n): + key = self._unpack(EX_CONSTRUCT) + if self._strict_map_key and type(key) not in (str, bytes): + raise ValueError("%s is not allowed for map key" % str(type(key))) + pairs.append((key, self._unpack(EX_CONSTRUCT))) + ret = self._object_pairs_hook(pairs) else: ret = {} for _ in range(n): @@ -576,7 +597,10 @@ class Unpacker: next = __next__ def skip(self): - self._unpack(EX_SKIP) + try: + self._unpack(EX_SKIP) + except RecursionError: + raise StackError self._consume() def unpack(self): @@ -686,6 +710,7 @@ class Packer: list_types = list else: list_types = (list, tuple) + dict_types = (dict, frozendict) while True: if nest_limit < 0: raise ValueError("recursion limit exceeded") @@ -779,7 +804,7 @@ class Packer: for i in range(n): self._pack(obj[i], nest_limit - 1) return - if check(obj, dict): + if check(obj, dict_types): return self._pack_map_pairs(len(obj), obj.items(), nest_limit - 1) if self._datetime and check(obj, _DateTime) and obj.tzinfo is not None: @@ -816,6 +841,8 @@ class Packer: return ret def pack_array_header(self, n): + if n < 0: + raise ValueError("array size must be non-negative") if n >= 2**32: raise ValueError self._pack_array_header(n) @@ -825,6 +852,8 @@ class Packer: return ret def pack_map_header(self, n): + if n < 0: + raise ValueError("map size must be non-negative") if n >= 2**32: raise ValueError self._pack_map_header(n) @@ -861,6 +890,10 @@ class Packer: self._buffer.write(b"\xc9" + struct.pack(">I", L)) self._buffer.write(struct.pack("B", typecode)) self._buffer.write(data) + if self._autoreset: + ret = self._buffer.getvalue() + self._buffer = BytesIO() + return ret def _pack_array_header(self, n): if n <= 0x0F: diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/__init__.py index 21695a7..5a96915 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/__init__.py @@ -6,7 +6,7 @@ __title__ = "packaging" __summary__ = "Core utilities for Python packages" __uri__ = "https://github.com/pypa/packaging" -__version__ = "26.0" +__version__ = "26.3" __author__ = "Donald Stufft and individual contributors" __email__ = "donald@stufft.io" diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_elffile.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_elffile.py index 497b064..1ce081d 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_elffile.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_elffile.py @@ -34,7 +34,7 @@ class EMachine(enum.IntEnum): S390 = 22 Arm = 40 X8664 = 62 - AArc64 = 183 + AArch64 = 183 class ELFFile: @@ -57,8 +57,8 @@ class ELFFile: self.encoding = ident[5] # Data structure encoding (endianness). try: - # e_fmt: Format for program header. - # p_fmt: Format for section header. + # e_fmt: Format for the ELF header. + # p_fmt: Format for a program header. # p_idx: Indexes to find p_type, p_offset, and p_filesz. e_fmt, self._p_fmt, self._p_idx = { (1, 1): (" Generator[ELFFile | None, None, None]: try: @@ -136,11 +138,11 @@ def _glibc_version_string_ctypes() -> str | None: # glibc. return None - # Call gnu_get_libc_version, which returns a string like "2.5" + # Call gnu_get_libc_version, which returns a string like "2.5". gnu_get_libc_version.restype = ctypes.c_char_p - version_str: str = gnu_get_libc_version() - # py2 / py3 compatibility: - if not isinstance(version_str, str): + # A c_char_p restype comes back as bytes, so decode to text. + version_str: str | bytes = gnu_get_libc_version() + if isinstance(version_str, bytes): version_str = version_str.decode("ascii") return version_str @@ -179,30 +181,44 @@ def _get_glibc_version() -> _GLibCVersion: # From PEP 513, PEP 600 +@functools.lru_cache(maxsize=1) +def _get_manylinux_module() -> types.ModuleType | None: + """Return the ``_manylinux`` C extension module, or None if unavailable. + + The result is cached for the lifetime of the process, since the presence + of the module does not change while running. + """ + try: + return __import__("_manylinux") + except ImportError: + return None + + def _is_compatible(arch: str, version: _GLibCVersion) -> bool: sys_glibc = _get_glibc_version() if sys_glibc < version: return False # Check for presence of _manylinux module. - try: - import _manylinux # noqa: PLC0415 - except ImportError: + manylinux_mod = _get_manylinux_module() + if manylinux_mod is None: return True - if hasattr(_manylinux, "manylinux_compatible"): - result = _manylinux.manylinux_compatible(version[0], version[1], arch) + if hasattr(manylinux_mod, "manylinux_compatible"): + result = manylinux_mod.manylinux_compatible(version[0], version[1], arch) if result is not None: return bool(result) return True - if version == _GLibCVersion(2, 5) and hasattr(_manylinux, "manylinux1_compatible"): - return bool(_manylinux.manylinux1_compatible) + if version == _GLibCVersion(2, 5) and hasattr( + manylinux_mod, "manylinux1_compatible" + ): + return bool(manylinux_mod.manylinux1_compatible) if version == _GLibCVersion(2, 12) and hasattr( - _manylinux, "manylinux2010_compatible" + manylinux_mod, "manylinux2010_compatible" ): - return bool(_manylinux.manylinux2010_compatible) + return bool(manylinux_mod.manylinux2010_compatible) if version == _GLibCVersion(2, 17) and hasattr( - _manylinux, "manylinux2014_compatible" + manylinux_mod, "manylinux2014_compatible" ): - return bool(_manylinux.manylinux2014_compatible) + return bool(manylinux_mod.manylinux2014_compatible) return True diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_musllinux.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_musllinux.py index 4e8116a..74c4136 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_musllinux.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_musllinux.py @@ -10,10 +10,13 @@ import functools import re import subprocess import sys -from typing import Iterator, NamedTuple, Sequence +from typing import TYPE_CHECKING, NamedTuple from ._elffile import ELFFile +if TYPE_CHECKING: + from collections.abc import Iterator, Sequence + class _MuslVersion(NamedTuple): major: int @@ -81,5 +84,5 @@ if __name__ == "__main__": # pragma: no cover print("plat:", plat) print("musl:", _get_musl_version(sys.executable)) print("tags:", end=" ") - for t in platform_tags(re.sub(r"[.-]", "_", plat.split("-", 1)[-1])): + for t in platform_tags([re.sub(r"[.-]", "_", plat.split("-", 1)[-1])]): print(t, end="\n ") diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_parser.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_parser.py index f6c1f5c..9331b4b 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_parser.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_parser.py @@ -7,9 +7,10 @@ the implementation. from __future__ import annotations import ast -from typing import List, Literal, NamedTuple, Sequence, Tuple, Union +from collections.abc import Sequence +from typing import Literal, NamedTuple, Union -from ._tokenizer import DEFAULT_RULES, Tokenizer +from ._tokenizer import DEFAULT_RULES, ParserSyntaxError, Tokenizer class Node: @@ -27,6 +28,34 @@ class Node: def serialize(self) -> str: raise NotImplementedError + def __getstate__(self) -> str: + # Return just the value string for compactness and stability. + return self.value + + def _restore_value(self, value: object) -> None: + if not isinstance(value, str): + raise TypeError( + f"Cannot restore {self.__class__.__name__} value from {value!r}" + ) + self.value = value + + def __setstate__(self, state: object) -> None: + if isinstance(state, str): + # New format (26.2+): just the value string. + self._restore_value(state) + return + if isinstance(state, tuple) and len(state) == 2: + # Old format (packaging <= 26.0, __slots__): (None, {slot: value}). + _, slot_dict = state + if isinstance(slot_dict, dict) and "value" in slot_dict: + self._restore_value(slot_dict["value"]) + return + if isinstance(state, dict) and "value" in state: + # Old format (packaging <= 25.0, no __slots__): plain __dict__. + self._restore_value(state["value"]) + return + raise TypeError(f"Cannot restore {self.__class__.__name__} from {state!r}") + class Variable(Node): __slots__ = () @@ -39,7 +68,14 @@ class Value(Node): __slots__ = () def serialize(self) -> str: - return f'"{self}"' + value = str(self) + if '"' not in value: + return f'"{value}"' + if "'" not in value: + return f"'{value}'" + raise ValueError( + "Cannot serialize marker value containing both quote characters" + ) class Op(Node): @@ -51,9 +87,9 @@ class Op(Node): MarkerLogical = Literal["and", "or"] MarkerVar = Union[Variable, Value] -MarkerItem = Tuple[MarkerVar, Op, MarkerVar] +MarkerItem = tuple[MarkerVar, Op, MarkerVar] MarkerAtom = Union[MarkerItem, Sequence["MarkerAtom"]] -MarkerList = List[Union["MarkerList", MarkerAtom, MarkerLogical]] +MarkerList = list[Union["MarkerList", MarkerAtom, MarkerLogical]] class ParsedRequirement(NamedTuple): @@ -236,10 +272,19 @@ def _parse_version_many(tokenizer: Tokenizer) -> str: parsed_specifiers = "" while tokenizer.check("SPECIFIER"): span_start = tokenizer.position - parsed_specifiers += tokenizer.read().text + specifier = tokenizer.read().text + parsed_specifiers += specifier if tokenizer.check("VERSION_PREFIX_TRAIL", peek=True): + message = ".* suffix can only be used with `==` or `!=` operators" + if specifier.startswith("!=") or ( + specifier.startswith("==") and not specifier.startswith("===") + ): + message = ( + ".* suffix cannot be used with pre-release, post-release, " + "dev or local versions" + ) tokenizer.raise_syntax_error( - ".* suffix can only be used with `==` or `!=` operators", + message, span_start=span_start, span_end=tokenizer.position + 1, ) @@ -326,7 +371,15 @@ def _parse_marker_var(tokenizer: Tokenizer) -> MarkerVar: # noqa: RET503 if tokenizer.check("VARIABLE"): return process_env_var(tokenizer.read().text.replace(".", "_")) elif tokenizer.check("QUOTED_STRING"): - return process_python_str(tokenizer.read().text) + token = tokenizer.read() + try: + return process_python_str(token.text) + except (SyntaxError, ValueError) as exc: + raise ParserSyntaxError( + "Invalid quoted string", + source=tokenizer.source, + span=(token.position, token.position + len(token.text)), + ) from exc else: tokenizer.raise_syntax_error( message="Expected a marker variable or quoted string" diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_structures.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_structures.py index 225e2ee..4306784 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_structures.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_structures.py @@ -2,68 +2,32 @@ # 2.0, and the BSD License. See the LICENSE file in the root of this repository # for complete details. -import typing +"""Backward-compatibility shim for unpickling Version objects serialized before +packaging 26.1. + +Old pickles reference ``packaging._structures.InfinityType`` and +``packaging._structures.NegativeInfinityType``. This module provides minimal +stand-in classes so that ``pickle.loads()`` can resolve those references. +The deserialized objects are not used for comparisons — ``Version.__setstate__`` +discards the stale ``_key`` cache and recomputes it from the core version fields. +""" + +from __future__ import annotations -@typing.final class InfinityType: - __slots__ = () + """Stand-in for the removed ``InfinityType`` used in old comparison keys.""" def __repr__(self) -> str: return "Infinity" - def __hash__(self) -> int: - return hash(repr(self)) - def __lt__(self, other: object) -> bool: - return False - - def __le__(self, other: object) -> bool: - return False - - def __eq__(self, other: object) -> bool: - return isinstance(other, self.__class__) - - def __gt__(self, other: object) -> bool: - return True - - def __ge__(self, other: object) -> bool: - return True - - def __neg__(self: object) -> "NegativeInfinityType": - return NegativeInfinity - - -Infinity = InfinityType() - - -@typing.final class NegativeInfinityType: - __slots__ = () + """Stand-in for the removed ``NegativeInfinityType`` used in old comparison keys.""" def __repr__(self) -> str: return "-Infinity" - def __hash__(self) -> int: - return hash(repr(self)) - - def __lt__(self, other: object) -> bool: - return True - - def __le__(self, other: object) -> bool: - return True - - def __eq__(self, other: object) -> bool: - return isinstance(other, self.__class__) - - def __gt__(self, other: object) -> bool: - return False - - def __ge__(self, other: object) -> bool: - return False - - def __neg__(self: object) -> InfinityType: - return Infinity - +Infinity = InfinityType() NegativeInfinity = NegativeInfinityType() diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_tokenizer.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_tokenizer.py index e6d20dd..db7cd17 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_tokenizer.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/_tokenizer.py @@ -3,13 +3,18 @@ from __future__ import annotations import contextlib import re from dataclasses import dataclass -from typing import Generator, Mapping, NoReturn +from typing import TYPE_CHECKING, NoReturn from .specifiers import Specifier +if TYPE_CHECKING: + from collections.abc import Generator, Mapping + @dataclass class Token: + __slots__ = ("name", "position", "text") + name: str text: str position: int @@ -75,7 +80,7 @@ DEFAULT_RULES: dict[str, re.Pattern[str]] = { re.VERBOSE, ), "SPECIFIER": re.compile( - Specifier._operator_regex_str + Specifier._version_regex_str, + Specifier._specifier_regex_str, re.VERBOSE | re.IGNORECASE, ), "AT": re.compile(r"\@"), @@ -84,7 +89,7 @@ DEFAULT_RULES: dict[str, re.Pattern[str]] = { "VERSION_PREFIX_TRAIL": re.compile(r"\.\*"), "VERSION_LOCAL_LABEL_TRAIL": re.compile(r"\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*"), "WS": re.compile(r"[ \t]+"), - "END": re.compile(r"$"), + "END": re.compile(r"\Z"), } @@ -95,6 +100,8 @@ class Tokenizer: matches. """ + __slots__ = ("next_token", "position", "rules", "source") + def __init__( self, source: str, @@ -135,7 +142,7 @@ class Tokenizer: def expect(self, name: str, *, expected: str) -> Token: """Expect a certain token name next, failing with a syntax error otherwise. - The token is *not* read. + The token is read and returned. """ if not self.check(name): raise self.raise_syntax_error(f"Expected {expected}") diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/licenses/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/licenses/__init__.py index 335b275..f95ac02 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/licenses/__init__.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/licenses/__init__.py @@ -42,24 +42,63 @@ __all__ = [ "canonicalize_license_expression", ] -license_ref_allowed = re.compile("^[A-Za-z0-9.-]*$") + +# Simple __dir__ implementation since there are no public submodules +def __dir__() -> list[str]: + return __all__ + + +license_ref_allowed = re.compile("^[A-Za-z0-9.-]+$") NormalizedLicenseExpression = NewType("NormalizedLicenseExpression", str) +""" +A :class:`typing.NewType` of :class:`str`, representing a normalized +License-Expression. +""" class InvalidLicenseExpression(ValueError): """Raised when a license-expression string is invalid + >>> from packaging.licenses import canonicalize_license_expression >>> canonicalize_license_expression("invalid") Traceback (most recent call last): ... - packaging.licenses.InvalidLicenseExpression: Invalid license expression: 'invalid' + packaging.licenses.InvalidLicenseExpression: Unknown license: 'invalid' """ def canonicalize_license_expression( raw_license_expression: str, ) -> NormalizedLicenseExpression: + """ + This function takes a valid License-Expression, and returns the normalized + form of it. + + The return type is typed as :class:`NormalizedLicenseExpression`. This + allows type checkers to help require that a string has passed through this + function before use. + + :param str raw_license_expression: The License-Expression to canonicalize. + :raises InvalidLicenseExpression: If the License-Expression is invalid due to an + invalid/unknown license identifier or invalid syntax. + + .. doctest:: + + >>> from packaging.licenses import canonicalize_license_expression + >>> canonicalize_license_expression("mit") + 'MIT' + >>> canonicalize_license_expression("mit and (apache-2.0 or bsd-2-clause)") + 'MIT AND (Apache-2.0 OR BSD-2-Clause)' + >>> canonicalize_license_expression("(mit") + Traceback (most recent call last): + ... + InvalidLicenseExpression: Invalid license expression: '(mit' + >>> canonicalize_license_expression("Use-it-after-midnight") + Traceback (most recent call last): + ... + InvalidLicenseExpression: Unknown license: 'Use-it-after-midnight' + """ if not raw_license_expression: message = f"Invalid license expression: {raw_license_expression!r}" raise InvalidLicenseExpression(message) @@ -109,9 +148,18 @@ def canonicalize_license_expression( # Take a final pass to check for unknown licenses/exceptions. normalized_tokens = [] - for token in tokens: + last_license_start = False + for index, token in enumerate(tokens): if token in {"or", "and", "with", "(", ")"}: + if token == "with" and ( + not last_license_start + or index + 1 == len(tokens) + or tokens[index + 1] in {"or", "and", "with", "(", ")"} + ): + message = f"Invalid license expression: {raw_license_expression!r}" + raise InvalidLicenseExpression(message) normalized_tokens.append(token.upper()) + last_license_start = False continue if normalized_tokens and normalized_tokens[-1] == "WITH": @@ -120,6 +168,7 @@ def canonicalize_license_expression( raise InvalidLicenseExpression(message) normalized_tokens.append(EXCEPTIONS[token]["id"]) + last_license_start = False else: if token.endswith("+"): final_token = token[:-1] @@ -129,15 +178,17 @@ def canonicalize_license_expression( suffix = "" if final_token.startswith("licenseref-"): - if not license_ref_allowed.match(final_token): - message = f"Invalid licenseref: {final_token!r}" + license_ref_id = final_token[len("licenseref-") :] + if suffix or not license_ref_allowed.match(license_ref_id): + message = f"Invalid licenseref: {token!r}" raise InvalidLicenseExpression(message) - normalized_tokens.append(license_refs[final_token] + suffix) + normalized_tokens.append(license_refs[final_token]) else: if final_token not in LICENSES: message = f"Unknown license: {final_token!r}" raise InvalidLicenseExpression(message) normalized_tokens.append(LICENSES[final_token]["id"] + suffix) + last_license_start = True normalized_expression = " ".join(normalized_tokens) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/markers.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/markers.py index ca3706f..6920805 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/markers.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/markers.py @@ -4,11 +4,13 @@ from __future__ import annotations +import functools import operator import os import platform import sys -from typing import AbstractSet, Callable, Literal, Mapping, TypedDict, Union, cast +from collections.abc import Set as AbstractSet +from typing import TYPE_CHECKING, Callable, Literal, TypedDict, Union, cast from ._parser import MarkerAtom, MarkerList, Op, Value, Variable from ._parser import parse_marker as _parse_marker @@ -16,6 +18,9 @@ from ._tokenizer import ParserSyntaxError from .specifiers import InvalidSpecifier, Specifier from .utils import canonicalize_name +if TYPE_CHECKING: + from collections.abc import Mapping + __all__ = [ "Environment", "EvaluateContext", @@ -26,8 +31,24 @@ __all__ = [ "default_environment", ] + +def __dir__() -> list[str]: + return __all__ + + Operator = Callable[[str, Union[str, AbstractSet[str]]], bool] EvaluateContext = Literal["metadata", "lock_file", "requirement"] +"""A ``typing.Literal`` enumerating valid marker evaluation contexts. + +Valid values for the ``context`` passed to :meth:`Marker.evaluate` are: + +* ``"metadata"`` (for core metadata; default) +* ``"lock_file"`` (for lock files) +* ``"requirement"`` (i.e. all other situations) + +.. versionadded:: 25.0 +""" + MARKERS_ALLOWING_SET = {"extras", "dependency_groups"} MARKERS_REQUIRING_VERSION = { "implementation_version", @@ -38,25 +59,41 @@ MARKERS_REQUIRING_VERSION = { class InvalidMarker(ValueError): - """ - An invalid marker was found, users should refer to PEP 508. + """Raised when attempting to create a :class:`Marker` from invalid input. + + This error indicates that the given marker string does not conform to the + :ref:`specification of dependency specifiers `. """ class UndefinedComparison(ValueError): - """ - An invalid operation was attempted on a value that doesn't support it. + """Raised when evaluating an unsupported marker comparison. + + This can happen when marker values are compared as versions but do not + conform to the :ref:`specification of version specifiers + `. """ -class UndefinedEnvironmentName(ValueError): - """ - A name was attempted to be used that does not exist inside of the - environment. +class UndefinedEnvironmentName(KeyError): + """Raised when evaluating a marker that references a missing environment key. + + Subclasses :class:`KeyError` so that code catching the bare ``KeyError`` that + a missing environment lookup historically produced keeps working. + + .. versionchanged:: 26.3 + Now subclasses :class:`KeyError` (was :class:`ValueError`) and is raised by + :meth:`Marker.evaluate` for missing environment keys, where a bare + ``KeyError`` was raised before. """ class Environment(TypedDict): + """ + A dictionary that represents a Python environment as captured by + :func:`default_environment`. All fields are required. + """ + implementation_name: str """The implementation's identifier, e.g. ``'cpython'``.""" @@ -131,16 +168,30 @@ class Environment(TypedDict): def _normalize_extras( result: MarkerList | MarkerAtom | str, ) -> MarkerList | MarkerAtom | str: + if isinstance(result, list): + return [_normalize_extras(r) for r in result] if not isinstance(result, tuple): return result lhs, op, rhs = result - if isinstance(lhs, Variable) and lhs.value == "extra": + if isinstance(lhs, Variable) and lhs.value == "extra" and isinstance(rhs, Value): normalized_extra = canonicalize_name(rhs.value) rhs = Value(normalized_extra) - elif isinstance(rhs, Variable) and rhs.value == "extra": + elif isinstance(rhs, Variable) and rhs.value == "extra" and isinstance(lhs, Value): normalized_extra = canonicalize_name(lhs.value) lhs = Value(normalized_extra) + elif ( + isinstance(rhs, Variable) + and rhs.value in MARKERS_ALLOWING_SET + and isinstance(lhs, Value) + ): + # PEP 685 (extras) / PEP 735 (dependency_groups): the set-valued membership + # literal must also be normalized. evaluate() already canonicalizes both + # operands for these keys (see _normalize), so normalizing the literal at + # parse time keeps __str__/__eq__/__hash__ consistent with evaluate() -- e.g. + # Marker('"Foo" in extras') and Marker('"foo" in extras') must compare and + # hash equal (the membership variable is always the right-hand operand). + lhs = Value(canonicalize_name(lhs.value)) return lhs, op, rhs @@ -157,16 +208,14 @@ def _format_marker( ) -> str: assert isinstance(marker, (list, tuple, str)) - # Sometimes we have a structure like [[...]] which is a single item list - # where the single item is itself it's own list. In that case we want skip - # the rest of this function so that we don't get extraneous () on the - # outside. + # Unwrap a redundant [[...]] wrapper, but keep the nesting context so a + # nested group keeps the parentheses its and/or precedence needs. if ( isinstance(marker, list) and len(marker) == 1 and isinstance(marker[0], (list, tuple)) ): - return _format_marker(marker[0]) + return _format_marker(marker[0], first=first) if isinstance(marker, list): inner = (_format_marker(m, first=False) for m in marker) @@ -230,6 +279,15 @@ def _normalize( return lhs, rhs +def _lookup_environment( + environment: dict[str, str | AbstractSet[str]], key: str +) -> str | AbstractSet[str]: + try: + return environment[key] + except KeyError: + raise UndefinedEnvironmentName(key) from None + + def _evaluate_markers( markers: MarkerList, environment: dict[str, str | AbstractSet[str]] ) -> bool: @@ -243,14 +301,20 @@ def _evaluate_markers( if isinstance(lhs, Variable): environment_key = lhs.value - lhs_value = environment[environment_key] + lhs_value = _lookup_environment(environment, environment_key) rhs_value = rhs.value else: lhs_value = lhs.value environment_key = rhs.value - rhs_value = environment[environment_key] + rhs_value = _lookup_environment(environment, environment_key) - assert isinstance(lhs_value, str), "lhs must be a string" + if not isinstance(lhs_value, str): + raise UndefinedComparison( + f"Set-valued marker {environment_key!r} can only be used " + f'with the membership form (e.g. "" in ' + f"{environment_key}); it cannot appear on the left-hand " + f"side of {op.serialize()!r}." + ) lhs_value, rhs_value = _normalize(lhs_value, rhs_value, key=environment_key) groups[-1].append(_eval_op(lhs_value, op, rhs_value, key=environment_key)) elif marker == "or": @@ -263,7 +327,7 @@ def _evaluate_markers( return any(all(item) for item in groups) -def format_full_version(info: sys._version_info) -> str: +def _format_full_version(info: sys._version_info) -> str: version = f"{info.major}.{info.minor}.{info.micro}" kind = info.releaselevel if kind != "final": @@ -271,8 +335,16 @@ def format_full_version(info: sys._version_info) -> str: return version -def default_environment() -> Environment: - iver = format_full_version(sys.implementation.version) +@functools.cache +def _cached_default_environment() -> Environment: + """Build the default marker environment for the current Python process. + + The values are derived from process-constant data (the running interpreter + and the host platform), so this is cached and built only once. The result is + shared between callers and must never be mutated; :func:`default_environment` + returns a fresh copy. + """ + iver = _format_full_version(sys.implementation.version) implementation_name = sys.implementation.name return { "implementation_name": implementation_name, @@ -289,7 +361,44 @@ def default_environment() -> Environment: } +def default_environment() -> Environment: + """Return the default marker environment for the current Python process. + + This is the base environment used by :meth:`Marker.evaluate`. A fresh copy + is returned on every call so callers may freely mutate the result; a shallow + copy suffices because all values are immutable strings. + + .. versionchanged:: 26.3 + The environment is computed once per process and cached, since it is + derived from process-constant data. Patching ``platform``/``sys``/``os`` + after the first call has no effect; pass an explicit ``environment`` to + :meth:`Marker.evaluate` to evaluate against different values. + """ + return cast("Environment", dict(_cached_default_environment())) + + class Marker: + """Represents a parsed dependency marker expression. + + Marker expressions are parsed according to the + :ref:`specification of dependency specifiers `. + + :param marker: The string representation of a marker expression. + :raises InvalidMarker: If ``marker`` cannot be parsed. + + Instances are safe to serialize with :mod:`pickle`. They use a stable + format so the same pickle can be loaded in future packaging releases. + + .. versionchanged:: 26.2 + + Added a stable pickle format. Pickles created with packaging 26.2+ can + be unpickled with future releases. Backward compatibility with pickles + from pip._vendor.packaging < 26.2 is supported but may be removed in a future + release. + """ + + __slots__ = ("_markers",) + def __init__(self, marker: str) -> None: # Note: We create a Marker object without calling this constructor in # packaging.requirements.Requirement. If any additional logic is @@ -320,11 +429,21 @@ class Marker: except ParserSyntaxError as e: raise InvalidMarker(str(e)) from e + @classmethod + def _from_markers(cls, markers: MarkerList) -> Marker: + """Create a Marker instance from a pre-parsed marker tree. + + This avoids re-parsing serialised marker strings when combining markers. + """ + new = cls.__new__(cls) + new._markers = markers + return new + def __str__(self) -> str: return _format_marker(self._markers) def __repr__(self) -> str: - return f"<{self.__class__.__name__}('{self}')>" + return f"<{self.__class__.__name__}({str(self)!r})>" def __hash__(self) -> int: return hash(str(self)) @@ -335,6 +454,53 @@ class Marker: return str(self) == str(other) + def __getstate__(self) -> str: + # Return the marker expression string for compactness and stability. + # Internal Node objects are excluded; the string is re-parsed on load. + return str(self) + + def __setstate__(self, state: object) -> None: + if isinstance(state, str): + # New format (26.2+): just the marker expression string. + try: + self._markers = _normalize_extra_values(_parse_marker(state)) + except ParserSyntaxError as exc: + raise TypeError(f"Cannot restore Marker from {state!r}") from exc + return + if isinstance(state, dict) and "_markers" in state: + # Old format (packaging <= 26.1, no __slots__): plain __dict__. + markers = state["_markers"] + if isinstance(markers, list): + self._markers = markers + return + if isinstance(state, tuple) and len(state) == 2: + # Old format (packaging <= 26.1, __slots__): (None, {slot: value}). + _, slot_dict = state + if isinstance(slot_dict, dict) and "_markers" in slot_dict: + markers = slot_dict["_markers"] + if isinstance(markers, list): + self._markers = markers + return + raise TypeError(f"Cannot restore Marker from {state!r}") + + def __and__(self, other: Marker) -> Marker: + """Combine this marker with another using ``and``. + + .. versionadded:: 26.1 + """ + if not isinstance(other, Marker): + return NotImplemented + return self._from_markers([self._markers, "and", other._markers]) + + def __or__(self, other: Marker) -> Marker: + """Combine this marker with another using ``or``. + + .. versionadded:: 26.1 + """ + if not isinstance(other, Marker): + return NotImplemented + return self._from_markers([self._markers, "or", other._markers]) + def evaluate( self, environment: Mapping[str, str | AbstractSet[str]] | None = None, @@ -342,27 +508,40 @@ class Marker: ) -> bool: """Evaluate a marker. - Return the boolean from evaluating the given marker against the - environment. environment is an optional argument to override all or - part of the determined environment. The *context* parameter specifies what - context the markers are being evaluated for, which influences what markers - are considered valid. Acceptable values are "metadata" (for core metadata; - default), "lock_file", and "requirement" (i.e. all other situations). + Return the boolean from evaluating this marker against the environment. + The environment is determined from the current Python process unless + passed in explicitly. - The environment is determined from the current Python process. + :param environment: Mapping containing keys and values to override the + detected environment. + :param EvaluateContext context: The context in which the marker is + evaluated, which influences what marker names are considered valid. + Accepted values are ``"metadata"`` (for core metadata; default), + ``"lock_file"``, and ``"requirement"`` (i.e. all other situations). + :raises UndefinedComparison: If the marker uses a comparison on values + that are not valid versions per the :ref:`specification of version + specifiers `. + :raises UndefinedEnvironmentName: If the marker references a value that + is missing from the evaluation environment. + :returns: ``True`` if the marker matches, otherwise ``False``. + + .. versionchanged:: 25.0 + Added the ``context`` parameter, which influences which marker names + are considered valid. """ current_environment = cast( "dict[str, str | AbstractSet[str]]", default_environment() ) if context == "lock_file": - current_environment.update( - extras=frozenset(), dependency_groups=frozenset() - ) + current_environment |= { + "extras": frozenset(), + "dependency_groups": frozenset(), + } elif context == "metadata": current_environment["extra"] = "" if environment is not None: - current_environment.update(environment) + current_environment |= environment if "extra" in current_environment: # The API used to allow setting extra to None. We need to handle # this case for backwards compatibility. Also skip running @@ -375,6 +554,16 @@ class Marker: ) +def _pep440_python_full_version(python_full_version: str) -> str: + """ + Work around platform.python_version() returning something that is not PEP 440 + compliant for non-tagged Python builds. + """ + if python_full_version.endswith("+"): + return f"{python_full_version}local" + return python_full_version + + def _repair_python_full_version( env: dict[str, str | AbstractSet[str]], ) -> dict[str, str | AbstractSet[str]]: @@ -383,6 +572,5 @@ def _repair_python_full_version( compliant for non-tagged Python builds. """ python_full_version = cast("str", env["python_full_version"]) - if python_full_version.endswith("+"): - env["python_full_version"] = f"{python_full_version}local" + env["python_full_version"] = _pep440_python_full_version(python_full_version) return env diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/metadata.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/metadata.py index 253f6b1..1061105 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/metadata.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/metadata.py @@ -1,13 +1,12 @@ from __future__ import annotations -import email.feedparser import email.header import email.message import email.parser import email.policy import keyword import pathlib -import sys +import re import typing from typing import ( Any, @@ -20,37 +19,35 @@ from typing import ( from . import licenses, requirements, specifiers, utils from . import version as version_module +from .errors import ExceptionGroup, _ErrorCollector if typing.TYPE_CHECKING: from .licenses import NormalizedLicenseExpression + from .version import Version T = typing.TypeVar("T") -if sys.version_info >= (3, 11): # pragma: no cover - ExceptionGroup = ExceptionGroup # noqa: F821 -else: # pragma: no cover +__all__ = [ + "ExceptionGroup", # Keep this for a bit (makes mypy happy w/ 26.0 compat) + "InvalidMetadata", + "Metadata", + "RFC822Message", + "RFC822Policy", + "RawMetadata", + "parse_email", +] - class ExceptionGroup(Exception): - """A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11. - If :external:exc:`ExceptionGroup` is already defined by Python itself, - that version is used instead. - """ - - message: str - exceptions: list[Exception] - - def __init__(self, message: str, exceptions: list[Exception]) -> None: - self.message = message - self.exceptions = exceptions - - def __repr__(self) -> str: - return f"{self.__class__.__name__}({self.message!r}, {self.exceptions!r})" +def __dir__() -> list[str]: + return __all__ class InvalidMetadata(ValueError): - """A metadata field contains invalid data.""" + """A metadata field contains invalid data. + + .. versionadded:: 23.2 + """ field: str """The name of the field that contains invalid data.""" @@ -59,6 +56,10 @@ class InvalidMetadata(ValueError): self.field = field super().__init__(message) + # Support pickling; ``args`` does not match ``__init__``'s signature. + def __reduce__(self) -> tuple[type[InvalidMetadata], tuple[str, str]]: + return (self.__class__, (self.field, self.args[0])) + # The RawMetadata class attempts to make as few assumptions about the underlying # serialization formats as possible. The idea is that as long as a serialization @@ -76,8 +77,8 @@ class RawMetadata(TypedDict, total=False): Core metadata fields that can be specified multiple times are stored as a list or dict depending on which is appropriate for the field. Any fields - which hold multiple values in a single field are stored as a list. - + which hold multiple values in a single field are stored as a list. All fields + are considered optional. """ # Metadata 1.0 - PEP 241 @@ -133,11 +134,17 @@ class RawMetadata(TypedDict, total=False): # Metadata 2.4 - PEP 639 license_expression: str + """.. versionadded:: 24.2""" license_files: list[str] + """.. versionadded:: 24.2""" # Metadata 2.5 - PEP 794 import_names: list[str] + """.. versionadded:: 26.0""" import_namespaces: list[str] + """.. versionadded:: 26.0""" + + # Metadata 2.6 - PEP 808 (no new fields, behavior change for Dynamic) # 'keywords' is special as it's a string in the core metadata spec, but we @@ -233,13 +240,19 @@ def _get_payload(msg: email.message.Message, source: bytes | str) -> str: # and we don't need to deal with it. if isinstance(source, str): payload = msg.get_payload() - assert isinstance(payload, str) + # A multipart payload makes get_payload() return a list of messages + # rather than a str; route it to ``unparsed``. + if not isinstance(payload, str): + raise ValueError("payload is not a string") # noqa: TRY004 return payload # If our source is a bytes, then we're managing the encoding and we need # to deal with it. else: bpayload = msg.get_payload(decode=True) - assert isinstance(bpayload, bytes) + # A multipart payload makes get_payload(decode=True) return None; + # route it to ``unparsed``. + if not isinstance(bpayload, bytes): + raise ValueError("payload in an invalid encoding") # noqa: TRY004 try: return bpayload.decode("utf8", "strict") except UnicodeDecodeError as exc: @@ -295,11 +308,19 @@ _EMAIL_TO_RAW_MAPPING = { _RAW_TO_EMAIL_MAPPING = {raw: email for email, raw in _EMAIL_TO_RAW_MAPPING.items()} +# A bare "\r" makes the email generator raise ``HeaderWriteError``, and on +# CPython releases without the CVE-2024-6923 fix any ``str.splitlines`` +# boundary ends the header line, so fold all of them, not just "\n". +_LINE_BOUNDARY_RE = re.compile(r"\r\n|[\n\r\v\f\x1c\x1d\x1e\x85\u2028\u2029]") + + # This class is for writing RFC822 messages class RFC822Policy(email.policy.EmailPolicy): """ This is :class:`email.policy.EmailPolicy`, but with a simple ``header_store_parse`` implementation that handles multi-line values, and some nice defaults. + + .. versionadded:: 26.0 """ utf8 = True @@ -308,7 +329,7 @@ class RFC822Policy(email.policy.EmailPolicy): def header_store_parse(self, name: str, value: str) -> tuple[str, str]: size = len(name) + 2 - value = value.replace("\n", "\n" + " " * size) + value = _LINE_BOUNDARY_RE.sub("\n" + " " * size, value) return (name, value) @@ -318,6 +339,8 @@ class RFC822Message(email.message.EmailMessage): This is :class:`email.message.EmailMessage` with two small changes: it defaults to our `RFC822Policy`, and it correctly writes unicode when being called with `bytes()`. + + .. versionadded:: 26.0 """ def __init__(self) -> None: @@ -519,8 +542,20 @@ _NOT_FOUND = object() # Keep the two values in sync. -_VALID_METADATA_VERSIONS = ["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4", "2.5"] -_MetadataVersion = Literal["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4", "2.5"] +_VALID_METADATA_VERSIONS = [ + "1.0", + "1.1", + "1.2", + "2.1", + "2.2", + "2.3", + "2.4", + "2.5", + "2.6", +] +_MetadataVersion = Literal[ + "1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4", "2.5", "2.6" +] _REQUIRED_ATTRS = frozenset(["metadata_version", "name", "version"]) @@ -580,9 +615,7 @@ class _Validator(Generic[T]): def _invalid_metadata( self, msg: str, cause: Exception | None = None ) -> InvalidMetadata: - exc = InvalidMetadata( - self.raw_name, msg.format_map({"field": repr(self.raw_name)}) - ) + exc = InvalidMetadata(self.raw_name, msg) exc.__cause__ = cause return exc @@ -594,67 +627,82 @@ class _Validator(Generic[T]): def _process_name(self, value: str) -> str: if not value: - raise self._invalid_metadata("{field} is a required field") + raise self._invalid_metadata(f"{self.raw_name!r} is a required field") # Validate the name as a side-effect. try: utils.canonicalize_name(value, validate=True) except utils.InvalidName as exc: raise self._invalid_metadata( - f"{value!r} is invalid for {{field}}", cause=exc + f"{value!r} is invalid for {self.raw_name!r}", cause=exc ) from exc else: return value - def _process_version(self, value: str) -> version_module.Version: + def _process_version(self, value: str) -> Version: if not value: - raise self._invalid_metadata("{field} is a required field") + raise self._invalid_metadata(f"{self.raw_name!r} is a required field") try: return version_module.parse(value) except version_module.InvalidVersion as exc: raise self._invalid_metadata( - f"{value!r} is invalid for {{field}}", cause=exc + f"{value!r} is invalid for {self.raw_name!r}", cause=exc ) from exc def _process_summary(self, value: str) -> str: - """Check the field contains no newlines.""" - if "\n" in value: - raise self._invalid_metadata("{field} must be a single line") + """Check the field contains no line breaks.""" + if _LINE_BOUNDARY_RE.search(value): + raise self._invalid_metadata(f"{self.raw_name!r} must be a single line") return value def _process_description_content_type(self, value: str) -> str: content_types = {"text/plain", "text/x-rst", "text/markdown"} + invalid_msg = ( + f"{self.raw_name!r} must be one of {list(content_types)}, not {value!r}" + ) message = email.message.EmailMessage() - message["content-type"] = value + try: + message["content-type"] = value + # The email parser can raise IndexError on malformed RFC 2231 + # parameters such as "text/plain; x*". + except (ValueError, IndexError) as exc: + msg = f"{value!r} is not a valid content type for {self.raw_name!r}" + raise self._invalid_metadata(msg, cause=exc) from exc + content_type_header = message["content-type"] + if content_type_header.defects: + defect = content_type_header.defects[0] + msg = ( + f"{value!r} is not a valid content type for {self.raw_name!r}: {defect}" + ) + raise self._invalid_metadata(msg, cause=defect) from defect content_type, parameters = ( # Defaults to `text/plain` if parsing failed. message.get_content_type().lower(), - message["content-type"].params, + content_type_header.params, ) # Check if content-type is valid or defaulted to `text/plain` and thus was # not parseable. if content_type not in content_types or content_type not in value.lower(): - raise self._invalid_metadata( - f"{{field}} must be one of {list(content_types)}, not {value!r}" - ) + raise self._invalid_metadata(invalid_msg) charset = parameters.get("charset", "UTF-8") - if charset != "UTF-8": + if charset.lower() != "utf-8": raise self._invalid_metadata( - f"{{field}} can only specify the UTF-8 charset, not {list(charset)}" + f"{self.raw_name!r} can only specify the UTF-8 charset, not {charset!r}" ) markdown_variants = {"GFM", "CommonMark"} variant = parameters.get("variant", "GFM") # Use an acceptable default. if content_type == "text/markdown" and variant not in markdown_variants: raise self._invalid_metadata( - f"valid Markdown variants for {{field}} are {list(markdown_variants)}, " - f"not {variant!r}", + f"valid Markdown variants for {self.raw_name!r} are " + f"{list(markdown_variants)}, not {variant!r}", ) return value def _process_dynamic(self, value: list[str]) -> list[str]: - for dynamic_field in map(str.lower, value): + dynamic_fields = list(map(str.lower, value)) + for dynamic_field in dynamic_fields: if dynamic_field in {"name", "version", "metadata-version"}: raise self._invalid_metadata( f"{dynamic_field!r} is not allowed as a dynamic field" @@ -663,7 +711,7 @@ class _Validator(Generic[T]): raise self._invalid_metadata( f"{dynamic_field!r} is not a valid dynamic field" ) - return list(map(str.lower, value)) + return dynamic_fields def _process_provides_extra( self, @@ -675,7 +723,7 @@ class _Validator(Generic[T]): normalized_names.append(utils.canonicalize_name(name, validate=True)) except utils.InvalidName as exc: raise self._invalid_metadata( - f"{name!r} is invalid for {{field}}", cause=exc + f"{name!r} is invalid for {self.raw_name!r}", cause=exc ) from exc else: return normalized_names @@ -685,7 +733,7 @@ class _Validator(Generic[T]): return specifiers.SpecifierSet(value) except specifiers.InvalidSpecifier as exc: raise self._invalid_metadata( - f"{value!r} is invalid for {{field}}", cause=exc + f"{value!r} is invalid for {self.raw_name!r}", cause=exc ) from exc def _process_requires_dist( @@ -698,7 +746,7 @@ class _Validator(Generic[T]): reqs.append(requirements.Requirement(req)) except requirements.InvalidRequirement as exc: raise self._invalid_metadata( - f"{req!r} is invalid for {{field}}", cause=exc + f"{req!r} is invalid for {self.raw_name!r}", cause=exc ) from exc else: return reqs @@ -708,7 +756,7 @@ class _Validator(Generic[T]): return licenses.canonicalize_license_expression(value) except ValueError as exc: raise self._invalid_metadata( - f"{value!r} is invalid for {{field}}", cause=exc + f"{value!r} is invalid for {self.raw_name!r}", cause=exc ) from exc def _process_license_files(self, value: list[str]) -> list[str]: @@ -716,23 +764,24 @@ class _Validator(Generic[T]): for path in value: if ".." in path: raise self._invalid_metadata( - f"{path!r} is invalid for {{field}}, " + f"{path!r} is invalid for {self.raw_name!r}, " "parent directory indicators are not allowed" ) if "*" in path: raise self._invalid_metadata( - f"{path!r} is invalid for {{field}}, paths must be resolved" + f"{path!r} is invalid for {self.raw_name!r}, paths must be resolved" ) if ( pathlib.PurePosixPath(path).is_absolute() or pathlib.PureWindowsPath(path).is_absolute() ): raise self._invalid_metadata( - f"{path!r} is invalid for {{field}}, paths must be relative" + f"{path!r} is invalid for {self.raw_name!r}, paths must be relative" ) if pathlib.PureWindowsPath(path).as_posix() != path: raise self._invalid_metadata( - f"{path!r} is invalid for {{field}}, paths must use '/' delimiter" + f"{path!r} is invalid for {self.raw_name!r}, " + "paths must use '/' delimiter" ) paths.append(path) return paths @@ -744,17 +793,17 @@ class _Validator(Generic[T]): for identifier in name.split("."): if not identifier.isidentifier(): raise self._invalid_metadata( - f"{name!r} is invalid for {{field}}; " + f"{name!r} is invalid for {self.raw_name!r}; " f"{identifier!r} is not a valid identifier" ) elif keyword.iskeyword(identifier): raise self._invalid_metadata( - f"{name!r} is invalid for {{field}}; " + f"{name!r} is invalid for {self.raw_name!r}; " f"{identifier!r} is a keyword" ) if semicolon and private.lstrip() != "private": raise self._invalid_metadata( - f"{import_name!r} is invalid for {{field}}; " + f"{import_name!r} is invalid for {self.raw_name!r}; " "the only valid option is 'private'" ) return value @@ -769,6 +818,12 @@ class Metadata: metadata fields instead of only using built-in types. Any invalid metadata will cause :exc:`InvalidMetadata` to be raised (with a :py:attr:`~BaseException.__cause__` attribute as appropriate). + + .. versionadded:: 23.2 + + .. versionchanged:: 24.0 + Optional attributes now return None when the field is absent instead of + raising. """ _raw: RawMetadata @@ -777,20 +832,19 @@ class Metadata: def from_raw(cls, data: RawMetadata, *, validate: bool = True) -> Metadata: """Create an instance from :class:`RawMetadata`. - If *validate* is true, all metadata will be validated. All exceptions - related to validation will be gathered and raised as an :class:`ExceptionGroup`. + If *validate* is true, all metadata will be validated and all related + exceptions will be gathered and raised as an :class:`ExceptionGroup`; + otherwise, validation happens per attribute when it is accessed. """ ins = cls() ins._raw = data.copy() # Mutations occur due to caching enriched values. if validate: - exceptions: list[Exception] = [] - try: + collector = _ErrorCollector() + metadata_version = None + with collector.collect(InvalidMetadata): metadata_version = ins.metadata_version metadata_age = _VALID_METADATA_VERSIONS.index(metadata_version) - except InvalidMetadata as metadata_version_exc: - exceptions.append(metadata_version_exc) - metadata_version = None # Make sure to check for the fields that are present, the required # fields (so their absence can be reported). @@ -807,7 +861,7 @@ class Metadata: field_metadata_version = cls.__dict__[key].added except KeyError: exc = InvalidMetadata(key, f"unrecognized field: {key!r}") - exceptions.append(exc) + collector.error(exc) continue field_age = _VALID_METADATA_VERSIONS.index( field_metadata_version @@ -819,14 +873,13 @@ class Metadata: f"{field} introduced in metadata version " f"{field_metadata_version}, not {metadata_version}", ) - exceptions.append(exc) + collector.error(exc) continue getattr(ins, key) except InvalidMetadata as exc: - exceptions.append(exc) + collector.error(exc) - if exceptions: - raise ExceptionGroup("invalid metadata", exceptions) + collector.finalize("invalid metadata") return ins @@ -840,23 +893,32 @@ class Metadata: raw, unparsed = parse_email(data) if validate: - exceptions: list[Exception] = [] - for unparsed_key in unparsed: - if unparsed_key in _EMAIL_TO_RAW_MAPPING: - message = f"{unparsed_key!r} has invalid data" + with _ErrorCollector().on_exit("invalid or unparsed metadata") as collector: + for unparsed_key in unparsed: + if unparsed_key in _EMAIL_TO_RAW_MAPPING: + message = f"{unparsed_key!r} has invalid data" + else: + message = f"unrecognized field: {unparsed_key!r}" + collector.error(InvalidMetadata(unparsed_key, message)) + try: + validated = cls.from_raw(raw, validate=validate) + except ExceptionGroup as exc_group: + # The no-branch pragmas cover arcs only seen by Python 3.9. + for exc in exc_group.exceptions: # pragma: no branch + # A required field reported above as unparsed is absent + # from `raw`, so skip from_raw's duplicate "missing" + # complaint. + if not ( + isinstance(exc, InvalidMetadata) + and exc.field in unparsed + and _EMAIL_TO_RAW_MAPPING.get(exc.field) not in raw + ): + collector.error(exc) else: - message = f"unrecognized field: {unparsed_key!r}" - exceptions.append(InvalidMetadata(unparsed_key, message)) + if not collector.errors: # pragma: no branch + return validated - if exceptions: - raise ExceptionGroup("unparsed", exceptions) - - try: - return cls.from_raw(raw, validate=validate) - except ExceptionGroup as exc_group: - raise ExceptionGroup( - "invalid or unparsed metadata", exc_group.exceptions - ) from None + return cls.from_raw(raw, validate=validate) metadata_version: _Validator[_MetadataVersion] = _Validator() """:external:ref:`core-metadata-metadata-version` @@ -867,7 +929,7 @@ class Metadata: """:external:ref:`core-metadata-name` (required; validated using :func:`~packaging.utils.canonicalize_name` and its *validate* parameter)""" - version: _Validator[version_module.Version] = _Validator() + version: _Validator[Version] = _Validator() """:external:ref:`core-metadata-version` (required)""" dynamic: _Validator[list[str] | None] = _Validator( added="2.2", @@ -903,9 +965,15 @@ class Metadata: license_expression: _Validator[NormalizedLicenseExpression | None] = _Validator( added="2.4" ) - """:external:ref:`core-metadata-license-expression`""" + """:external:ref:`core-metadata-license-expression` + + .. versionadded:: 24.2 + """ license_files: _Validator[list[str] | None] = _Validator(added="2.4") - """:external:ref:`core-metadata-license-file`""" + """:external:ref:`core-metadata-license-file` + + .. versionadded:: 24.2 + """ classifiers: _Validator[list[str] | None] = _Validator(added="1.1") """:external:ref:`core-metadata-classifier`""" requires_dist: _Validator[list[requirements.Requirement] | None] = _Validator( @@ -933,9 +1001,15 @@ class Metadata: obsoletes_dist: _Validator[list[str] | None] = _Validator(added="1.2") """:external:ref:`core-metadata-obsoletes-dist`""" import_names: _Validator[list[str] | None] = _Validator(added="2.5") - """:external:ref:`core-metadata-import-name`""" + """:external:ref:`core-metadata-import-name` + + .. versionadded:: 26.0 + """ import_namespaces: _Validator[list[str] | None] = _Validator(added="2.5") - """:external:ref:`core-metadata-import-namespace`""" + """:external:ref:`core-metadata-import-namespace` + + .. versionadded:: 26.0 + """ requires: _Validator[list[str] | None] = _Validator(added="1.1") """``Requires`` (deprecated)""" provides: _Validator[list[str] | None] = _Validator(added="1.1") @@ -946,6 +1020,8 @@ class Metadata: def as_rfc822(self) -> RFC822Message: """ Return an RFC822 message with the metadata. + + .. versionadded:: 26.0 """ message = RFC822Message() self._write_metadata(message) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/pylock.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/pylock.py index a564f15..b797623 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/pylock.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/pylock.py @@ -12,18 +12,34 @@ from typing import ( Callable, Protocol, TypeVar, + cast, ) +from urllib.parse import unquote, urlparse -from .markers import Marker +from .markers import ( + Environment, + Marker, + _pep440_python_full_version, + default_environment, +) from .specifiers import SpecifierSet -from .utils import NormalizedName, is_normalized_name +from .tags import create_compatible_tags_selector, sys_tags +from .utils import ( + NormalizedName, + is_normalized_name, + parse_sdist_filename, + parse_wheel_filename, +) from .version import Version if TYPE_CHECKING: # pragma: no cover + from collections.abc import Collection, Iterator from pathlib import Path from typing_extensions import Self + from .tags import Tag + _logger = logging.getLogger(__name__) __all__ = [ @@ -34,11 +50,17 @@ __all__ = [ "PackageVcs", "PackageWheel", "Pylock", + "PylockSelectError", "PylockUnsupportedVersionError", "PylockValidationError", "is_valid_pylock_path", ] + +def __dir__() -> list[str]: + return __all__ + + _T = TypeVar("_T") _T2 = TypeVar("_T2") @@ -83,7 +105,10 @@ def _get(d: Mapping[str, Any], expected_type: type[_T], key: str) -> _T | None: """Get a value from the dictionary and verify it's the expected type.""" if (value := d.get(key)) is None: return None - if not isinstance(value, expected_type): + if not isinstance(value, expected_type) or ( + # Special case: bool is a subclass of int, but TOML distinguishes the two + expected_type is int and isinstance(value, bool) + ): raise PylockValidationError( f"Unexpected type {type(value).__name__} " f"(expected {expected_type.__name__})", @@ -222,6 +247,27 @@ def _validate_path_url(path: str | None, url: str | None) -> None: raise PylockValidationError("path or url must be provided") +def _path_name(path: str | None) -> str | None: + if not path: + return None + # If the path is relative it MAY use POSIX-style path separators explicitly + # for portability + if "/" in path: + return path.rsplit("/", 1)[-1] + elif "\\" in path: + return path.rsplit("\\", 1)[-1] + else: + return path + + +def _url_name(url: str | None) -> str | None: + if not url: + return None + url_path = urlparse(url).path + # The last path component is percent-encoded, so decode it to the file name + return unquote(url_path.rsplit("/", 1)[-1]) + + def _validate_hashes(hashes: Mapping[str, Any]) -> Mapping[str, Any]: if not hashes: raise PylockValidationError("At least one hash must be provided") @@ -269,6 +315,13 @@ class PylockUnsupportedVersionError(PylockValidationError): """Raised when encountering an unsupported `lock_version`.""" +class PylockSelectError(Exception): + """Base exception for errors raised by :meth:`Pylock.select`. + + .. versionadded:: 26.1 + """ + + @dataclass(frozen=True, init=False) class PackageVcs: type: str @@ -418,6 +471,17 @@ class PackageSdist: _validate_path_url(package_sdist.path, package_sdist.url) return package_sdist + @property + def filename(self) -> str: + """Get the filename of the sdist. + + .. versionadded:: 26.1 + """ + filename = self.name or _path_name(self.path) or _url_name(self.url) + if not filename: + raise PylockValidationError("Cannot determine sdist filename") + return filename + @dataclass(frozen=True, init=False) class PackageWheel: @@ -459,6 +523,14 @@ class PackageWheel: _validate_path_url(package_wheel.path, package_wheel.url) return package_wheel + @property + def filename(self) -> str: + """Get the filename of the wheel.""" + filename = self.name or _path_name(self.path) or _url_name(self.url) + if not filename: + raise PylockValidationError("Cannot determine wheel filename") + return filename + @dataclass(frozen=True, init=False) class Package: @@ -538,6 +610,46 @@ class Package: "Exactly one of vcs, directory, archive must be set " "if sdist and wheels are not set" ) + for i, wheel in enumerate(package.wheels or []): + try: + (name, version, _, _) = parse_wheel_filename(wheel.filename) + except Exception as e: + raise PylockValidationError( + f"Invalid wheel filename {wheel.filename!r}", + context=f"wheels[{i}]", + ) from e + if name != package.name: + raise PylockValidationError( + f"Name in {wheel.filename!r} is not consistent with " + f"package name {package.name!r}", + context=f"wheels[{i}]", + ) + if package.version and version != package.version: + raise PylockValidationError( + f"Version in {wheel.filename!r} is not consistent with " + f"package version {str(package.version)!r}", + context=f"wheels[{i}]", + ) + if package.sdist: + try: + name, version = parse_sdist_filename(package.sdist.filename) + except Exception as e: + raise PylockValidationError( + f"Invalid sdist filename {package.sdist.filename!r}", + context="sdist", + ) from e + if name != package.name: + raise PylockValidationError( + f"Name in {package.sdist.filename!r} is not consistent with " + f"package name {package.name!r}", + context="sdist", + ) + if package.version and version != package.version: + raise PylockValidationError( + f"Version in {package.sdist.filename!r} is not consistent with " + f"package version {str(package.version)!r}", + context="sdist", + ) try: for i, attestation_identity in enumerate( # noqa: B007 package.attestation_identities or [] @@ -633,3 +745,199 @@ class Pylock: Raises :class:`PylockValidationError` otherwise.""" self.from_dict(self.to_dict()) + + def select( + self, + *, + environment: Environment | None = None, + tags: Sequence[Tag] | None = None, + extras: Collection[str] | None = None, + dependency_groups: Collection[str] | None = None, + prefer_sdist_predicate: Callable[[NormalizedName], bool] | None = None, + ) -> Iterator[ + tuple[ + Package, + PackageVcs + | PackageDirectory + | PackageArchive + | PackageWheel + | PackageSdist, + ] + ]: + """Select what to install from the lock file. + + The *environment* and *tags* parameters represent the environment being + selected for. If unspecified, ``packaging.markers.default_environment()`` and + ``packaging.tags.sys_tags()`` are used. + + The *extras* parameter represents the extras to install. + + The *dependency_groups* parameter represents the groups to install. If + unspecified, the default groups are used. + + The *prefer_sdist_predicate* parameter is called for packages with a source + distribution. If it returns ``True``, the source distribution is selected + before attempting wheel compatibility. If no source distribution is + available, wheel selection proceeds as usual without calling the predicate. + + This method must be used on valid Pylock instances (i.e. one obtained + from :meth:`Pylock.from_dict` or if constructed manually, after calling + :meth:`Pylock.validate`). + + .. versionadded:: 26.1 + + .. versionchanged:: 26.3 + Added the *prefer_sdist_predicate* parameter. + """ + compatible_tags_selector = create_compatible_tags_selector( + tags if tags is not None else sys_tags() + ) + + # #. Gather the extras and dependency groups to install and set ``extras`` and + # ``dependency_groups`` for marker evaluation, respectively. + # + # #. ``extras`` SHOULD be set to the empty set by default. + # #. ``dependency_groups`` SHOULD be the set created from + # :ref:`pylock-default-groups` by default. + env = cast( + "dict[str, str | frozenset[str]]", + dict( + environment or {}, # Marker.evaluate will fill-up + extras=frozenset(extras or []), + dependency_groups=frozenset( + (self.default_groups or []) + if dependency_groups is None # to allow selecting no group + else dependency_groups + ), + ), + ) + env_python_full_version = _pep440_python_full_version( + environment["python_full_version"] + if environment + else default_environment()["python_full_version"] + ) + + # #. Check if the metadata version specified by :ref:`pylock-lock-version` is + # supported; an error or warning MUST be raised as appropriate. + # Covered by lock.validate() which is a precondition for this method. + + # #. If :ref:`pylock-requires-python` is specified, check that the environment + # being installed for meets the requirement; an error MUST be raised if it is + # not met. + if self.requires_python and not self.requires_python.contains( + env_python_full_version, + ): + raise PylockSelectError( + f"python_full_version {env_python_full_version!r} " + f"in provided environment does not satisfy the Python version " + f"requirement {str(self.requires_python)!r}" + ) + + # #. If :ref:`pylock-environments` is specified, check that at least one of the + # environment marker expressions is satisfied; an error MUST be raised if no + # expression is satisfied. + if self.environments: + for env_marker in self.environments: + if env_marker.evaluate( + cast("dict[str, str]", environment or {}), context="requirement" + ): + break + else: + raise PylockSelectError( + "Provided environment does not satisfy any of the " + "environments specified in the lock file" + ) + + # #. For each package listed in :ref:`pylock-packages`: + selected_packages_by_name: dict[str, tuple[int, Package]] = {} + for package_index, package in enumerate(self.packages): + # #. If :ref:`pylock-packages-marker` is specified, check if it is + # satisfied;if it isn't, skip to the next package. + if package.marker and not package.marker.evaluate(env, context="lock_file"): + continue + + # #. If :ref:`pylock-packages-requires-python` is specified, check if it is + # satisfied; an error MUST be raised if it isn't. + if package.requires_python and not package.requires_python.contains( + env_python_full_version, + ): + raise PylockSelectError( + f"python_full_version {env_python_full_version!r} " + f"in provided environment does not satisfy the Python version " + f"requirement {str(package.requires_python)!r} for package " + f"{package.name!r} at packages[{package_index}]" + ) + + # #. Check that no other conflicting instance of the package has been slated + # to be installed; an error about the ambiguity MUST be raised otherwise. + if package.name in selected_packages_by_name: + raise PylockSelectError( + f"Multiple packages with the name {package.name!r} are " + f"selected at packages[{package_index}] and " + f"packages[{selected_packages_by_name[package.name][0]}]" + ) + + # #. Check that the source of the package is specified appropriately (i.e. + # there are no conflicting sources in the package entry); + # an error MUST be raised if any issues are found. + # Covered by lock.validate() which is a precondition for this method. + + # #. Add the package to the set of packages to install. + selected_packages_by_name[package.name] = (package_index, package) + + # #. For each package to be installed: + for package_index, package in selected_packages_by_name.values(): + # - If :ref:`pylock-packages-vcs` is set: + if package.vcs is not None: + yield package, package.vcs + + # - Else if :ref:`pylock-packages-directory` is set: + elif package.directory is not None: + yield package, package.directory + + # - Else if :ref:`pylock-packages-archive` is set: + elif package.archive is not None: + yield package, package.archive + + # - Else if source preference selects an available + # :ref:`pylock-packages-sdist`: + elif ( + package.sdist is not None + and prefer_sdist_predicate is not None + and prefer_sdist_predicate(package.name) + ): + yield package, package.sdist + + # - Else if there are entries for :ref:`pylock-packages-wheels`: + elif package.wheels: + # #. Look for the appropriate wheel file based on + # :ref:`pylock-packages-wheels-name`; if one is not found then move + # on to :ref:`pylock-packages-sdist` or an error MUST be raised about + # a lack of source for the project. + best_wheel = next( + compatible_tags_selector( + (wheel, parse_wheel_filename(wheel.filename)[-1]) + for wheel in package.wheels + ), + None, + ) + if best_wheel: + yield package, best_wheel + elif package.sdist is not None: + yield package, package.sdist + else: + raise PylockSelectError( + f"No wheel found matching the provided tags " + f"for package {package.name!r} " + f"at packages[{package_index}], " + f"and no sdist available as a fallback" + ) + + # - Else if no :ref:`pylock-packages-wheels` file is found or + # :ref:`pylock-packages-sdist` is solely set: + elif package.sdist is not None: + yield package, package.sdist + + else: + # Covered by lock.validate() which is a precondition for this method. + raise NotImplementedError # pragma: no cover diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/requirements.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/requirements.py index 3079be6..a877831 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/requirements.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/requirements.py @@ -3,18 +3,32 @@ # for complete details. from __future__ import annotations -from typing import Iterator +from typing import TYPE_CHECKING from ._parser import parse_requirement as _parse_requirement from ._tokenizer import ParserSyntaxError from .markers import Marker, _normalize_extra_values -from .specifiers import SpecifierSet +from .specifiers import InvalidSpecifier, SpecifierSet from .utils import canonicalize_name +if TYPE_CHECKING: + from collections.abc import Iterator + +__all__ = [ + "InvalidRequirement", + "Requirement", +] + + +def __dir__() -> list[str]: + return __all__ + class InvalidRequirement(ValueError): """ An invalid requirement was found, users should refer to PEP 508. + + .. versionadded:: 16.1 """ @@ -24,6 +38,38 @@ class Requirement: Parse a given requirement string into its parts, such as name, specifier, URL, and extras. Raises InvalidRequirement on a badly-formed requirement string. + + .. versionadded:: 16.1 + + .. versionchanged:: 22.0 + Added equality (``__eq__``) and hashing (``__hash__``) so requirements + can be compared and stored in sets / dicts. + + .. versionchanged:: 23.2 + Equality and hashing began canonicalizing requirement names, so + requirements whose names differ only by normalization (e.g. + ``Requirement("Foo")`` vs ``Requirement("foo")``) now compare and hash + equal. + + Instances are safe to serialize with :mod:`pickle`. They use a stable + format so the same pickle can be loaded in future packaging releases. + + .. versionchanged:: 26.2 + + Added a stable pickle format. Pickles created with packaging 26.2+ can + be unpickled with future releases. Backward compatibility with pickles + from pip._vendor.packaging < 26.2 is supported but may be removed in a future + release. + + .. versionchanged:: 26.3 + + The dedicated pickle support introduced in 26.2 did not preserve the + specifier's explicit :attr:`~packaging.specifiers.SpecifierSet.prereleases` + override; it is now included again. + + Equality and hashing normalize requirement names, extras, and + equivalent specifiers. The string representation still preserves the + parsed name and extras spelling. """ # TODO: Can we test whether something is contained within a requirement? @@ -31,6 +77,8 @@ class Requirement: # the thing as well as the version? What about the markers? # TODO: Can we normalize the name and extra name? + __slots__ = ("extras", "marker", "name", "specifier", "url") + def __init__(self, requirement_string: str) -> None: try: parsed = _parse_requirement(requirement_string) @@ -39,8 +87,11 @@ class Requirement: self.name: str = parsed.name self.url: str | None = parsed.url or None - self.extras: set[str] = set(parsed.extras or []) - self.specifier: SpecifierSet = SpecifierSet(parsed.specifier) + self.extras: set[str] = set(parsed.extras) + try: + self.specifier: SpecifierSet = SpecifierSet(parsed.specifier) + except InvalidSpecifier as e: + raise InvalidRequirement(str(e)) from e self.marker: Marker | None = None if parsed.marker is not None: self.marker = Marker.__new__(Marker) @@ -64,22 +115,77 @@ class Requirement: if self.marker: yield f"; {self.marker}" + def __getstate__(self) -> tuple[str, bool | None]: + # Return the requirement string for compactness and stability, paired + # with the specifier's explicit prereleases override, which is not + # captured by the string form. Re-parsed on load to reconstruct all + # other fields. + return (str(self), self.specifier._prereleases) + + def __setstate__(self, state: object) -> None: + if isinstance(state, str): + # Format (26.2): just the requirement string. + requirement_string: str = state + prereleases: bool | None = None + elif ( + isinstance(state, tuple) + and len(state) == 2 + and isinstance(state[0], str) + and (state[1] is None or isinstance(state[1], bool)) + ): + # New format (26.3+): (requirement string, specifier prereleases). + requirement_string, prereleases = state + elif isinstance(state, dict) and state.keys() >= set(self.__slots__): + # Old format (packaging <= 26.1, no __slots__): plain __dict__. + for key in self.__slots__: + setattr(self, key, state[key]) + return + else: + raise TypeError(f"Cannot restore Requirement from {state!r}") + + try: + tmp = Requirement(requirement_string) + except InvalidRequirement as exc: + raise TypeError(f"Cannot restore Requirement from {state!r}") from exc + self.name = tmp.name + self.url = tmp.url + self.extras = tmp.extras + self.specifier = tmp.specifier + self.specifier._prereleases = prereleases + self.marker = tmp.marker + def __str__(self) -> str: return "".join(self._iter_parts(self.name)) def __repr__(self) -> str: - return f"<{self.__class__.__name__}('{self}')>" + return f"<{self.__class__.__name__}({str(self)!r})>" def __hash__(self) -> int: - return hash(tuple(self._iter_parts(canonicalize_name(self.name)))) + # Mirror __eq__ by hashing the canonical specifier object rather than + # its raw string. ``_iter_parts`` yields ``str(self.specifier)``, which + # is non-canonical, so trailing-zero-equivalent requirements such as + # ``foo==1.0.0`` and ``foo==1.0.0.0`` (which compare equal) would + # otherwise hash differently, breaking the hash/__eq__ invariant. + return hash( + ( + canonicalize_name(self.name), + frozenset(canonicalize_name(e) for e in self.extras), + self.specifier, + self.url, + self.marker, + ) + ) def __eq__(self, other: object) -> bool: if not isinstance(other, Requirement): return NotImplemented + # Extras must be normalized before comparison as per PEP 685. + self_extras = frozenset(canonicalize_name(e) for e in self.extras) + other_extras = frozenset(canonicalize_name(e) for e in other.extras) return ( canonicalize_name(self.name) == canonicalize_name(other.name) - and self.extras == other.extras + and self_extras == other_extras and self.specifier == other.specifier and self.url == other.url and self.marker == other.marker diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/specifiers.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/specifiers.py index e4b9c44..534a70e 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/specifiers.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/specifiers.py @@ -11,33 +11,112 @@ from __future__ import annotations import abc -import itertools import re -from typing import Callable, Final, Iterable, Iterator, TypeVar, Union +import typing +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Final, + TypeVar, + Union, +) +from ._ranges import ( + FULL_RANGE, + bounds_for_spec, + coerce_version, + filter_by_ranges, + intersect_specifier_bounds, + matches_bounds_only, + ranges_are_prerelease_only, + resolve_prereleases, + trim_release, +) from .utils import canonicalize_version -from .version import InvalidVersion, Version +from .version import Version +if TYPE_CHECKING: + import sys + from collections.abc import Iterable, Iterator, Sequence + + if sys.version_info >= (3, 10): + from typing import TypeGuard + else: + from typing_extensions import TypeGuard + + from . import ranges + from ._ranges import Interval + + +__all__ = [ + "BaseSpecifier", + "InvalidSpecifier", + "Specifier", + "SpecifierSet", +] + + +def __dir__() -> list[str]: + return __all__ + + +def _validate_spec(spec: object, /) -> TypeGuard[tuple[str, str]]: + return ( + isinstance(spec, tuple) + and len(spec) == 2 + and isinstance(spec[0], str) + and isinstance(spec[1], str) + ) + + +def _validate_pre(pre: object, /) -> TypeGuard[bool | None]: + return pre is None or isinstance(pre, bool) + + +T = TypeVar("T") UnparsedVersion = Union[Version, str] UnparsedVersionVar = TypeVar("UnparsedVersionVar", bound=UnparsedVersion) -CallableOperator = Callable[[Version, str], bool] -def _coerce_version(version: UnparsedVersion) -> Version | None: - if not isinstance(version, Version): - try: - version = Version(version) - except InvalidVersion: - return None - return version +# Operators whose result is just a direct Version comparison, given a parsed +# item with no local. ``<=``/``==``/``!=`` need that no-local guard because +# PEP 440 strips locals on those; ``>=`` works regardless. +_DIRECT_COMPARE_OPS: dict[str, Callable[[Version, Version], bool]] = { + ">=": Version.__ge__, + "<=": Version.__le__, + "==": Version.__eq__, + "!=": Version.__ne__, +} -def _public_version(version: Version) -> Version: - return version.__replace__(local=None) +def _fast_match(specifier: Specifier, parsed: Version) -> bool | None: + """Match ``parsed`` against ``specifier`` without building a range. + Handles ``>=``, ``<=``, ``==``, ``!=``, ``<``, ``>`` when the spec is + not a wildcard and ``parsed`` has no local. Returns ``None`` when the + range path must be used. Pre-release policy is left to the caller. + """ + op_str, ver_str = specifier._spec + if ver_str.endswith(".*") or parsed.local is not None: + return None -def _base_version(version: Version) -> Version: - return version.__replace__(pre=None, post=None, dev=None, local=None) + direct_compare = _DIRECT_COMPARE_OPS.get(op_str) + if direct_compare is not None: + return direct_compare(parsed, specifier._require_spec_version(ver_str)) + + if op_str in ("<", ">"): + spec_v = specifier._require_spec_version(ver_str) + # ``V`` carve out V's family (pre/dev/post); that only + # matters when parsed shares V's epoch and trimmed release. + # Otherwise a direct cmpkey comparison is correct. + if parsed.epoch != spec_v.epoch or trim_release(parsed.release) != trim_release( + spec_v.release + ): + return parsed < spec_v if op_str == "<" else parsed > spec_v + return None + + return None class InvalidSpecifier(ValueError): @@ -53,6 +132,10 @@ class InvalidSpecifier(ValueError): class BaseSpecifier(metaclass=abc.ABCMeta): + """ + Abstract base class for :class:`Specifier` and :class:`SpecifierSet`. + """ + __slots__ = () __match_args__ = ("_str",) @@ -105,10 +188,29 @@ class BaseSpecifier(metaclass=abc.ABCMeta): Determines if the given item is contained within this specifier. """ + @typing.overload + def filter( + self, + iterable: Iterable[UnparsedVersionVar], + prereleases: bool | None = None, + key: None = ..., + ) -> Iterator[UnparsedVersionVar]: ... + + @typing.overload + def filter( + self, + iterable: Iterable[T], + prereleases: bool | None = None, + key: Callable[[T], UnparsedVersion] = ..., + ) -> Iterator[T]: ... + @abc.abstractmethod def filter( - self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None - ) -> Iterator[UnparsedVersionVar]: + self, + iterable: Iterable[Any], + prereleases: bool | None = None, + key: Callable[[Any], UnparsedVersion] | None = None, + ) -> Iterator[Any]: """ Takes an iterable of items and filters them so that only items which are contained within this specifier are allowed in it. @@ -123,22 +225,34 @@ class Specifier(BaseSpecifier): It is generally not required to instantiate this manually. You should instead prefer to work with :class:`SpecifierSet` instead, which can parse comma-separated version specifiers (which is what package metadata contains). + + Instances are safe to serialize with :mod:`pickle`. They use a stable + format so the same pickle can be loaded in future packaging releases. + + .. versionchanged:: 26.2 + + Added a stable pickle format. Pickles created with packaging 26.2+ can + be unpickled with future releases. Backward compatibility with pickles + from pip._vendor.packaging < 26.2 is supported but may be removed in a future + release. """ - __slots__ = ("_prereleases", "_spec", "_spec_version") + __slots__ = ( + "_prereleases", + "_ranges", + "_spec", + "_spec_version", + ) - _operator_regex_str = r""" - (?P(~=|==|!=|<=|>=|<|>|===)) - """ - _version_regex_str = r""" - (?P + _specifier_regex_str = r""" + (?: (?: # The identity operators allow for an escape hatch that will # do an exact string match of the version you wish to install. # This will not be parsed by PEP 440 and we cannot determine # any semantic meaning from it. This operator is discouraged # but included entirely as an escape hatch. - (?<====) # Only match for the identity operator + === # Only match for the identity operator \s* [^\s;)]* # The arbitrary version can be just about anything, # we match everything except for whitespace, a @@ -150,7 +264,7 @@ class Specifier(BaseSpecifier): # The (non)equality operators allow for wild card and local # versions to be specified so we have to define these two # operators separately to enable that. - (?<===|!=) # Only match for equals and not equals + (?:==|!=) # Only match for equals and not equals \s* v? @@ -162,24 +276,24 @@ class Specifier(BaseSpecifier): (?: \.\* # Wild card syntax of .* | - (?: # pre release + (?a: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? - (?: # post release + (?a: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? - (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release - (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local + (?a:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + (?a:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local )? ) | (?: # The compatible operator requires at least two digits in the # release segment. - (?<=~=) # Only match for the compatible operator + (?:~=) # Only match for the compatible operator \s* v? @@ -202,33 +316,31 @@ class Specifier(BaseSpecifier): # (non)equality operators do. Specifically they do not allow # local versions to be specified nor do they allow the prefix # matching wild cards. - (?=|<|>) \s* v? (?:[0-9]+!)? # epoch [0-9]+(?:\.[0-9]+)* # release - (?: # pre release + (?a: # pre release [-_\.]? (alpha|beta|preview|pre|a|b|c|rc) [-_\.]? [0-9]* )? - (?: # post release + (?a: # post release (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*) )? - (?:[-_\.]?dev[-_\.]?[0-9]*)? # dev release + (?a:[-_\.]?dev[-_\.]?[0-9]*)? # dev release ) ) """ _regex = re.compile( - r"\s*" + _operator_regex_str + _version_regex_str + r"\s*", - re.VERBOSE | re.IGNORECASE, + r"\s*" + _specifier_regex_str + r"\s*", re.VERBOSE | re.IGNORECASE ) + # Legacy unused attribute, kept for backward compatibility _operators: Final = { "~=": "compatible", "==": "equal", @@ -253,14 +365,18 @@ class Specifier(BaseSpecifier): :raises InvalidSpecifier: If the given specifier is invalid (i.e. bad syntax). """ - match = self._regex.fullmatch(spec) - if not match: + if not self._regex.fullmatch(spec): raise InvalidSpecifier(f"Invalid specifier: {spec!r}") - self._spec: tuple[str, str] = ( - match.group("operator").strip(), - match.group("version").strip(), - ) + spec = spec.strip() + if spec.startswith("==="): + operator, version = spec[:3], spec[3:].strip() + elif spec.startswith(("~=", "==", "!=", "<=", ">=")): + operator, version = spec[:2], spec[2:].strip() + else: + operator, version = spec[:1], spec[1:].strip() + + self._spec: tuple[str, str] = (operator, version) # Store whether or not this Specifier should accept prereleases self._prereleases = prereleases @@ -268,12 +384,15 @@ class Specifier(BaseSpecifier): # Specifier version cache self._spec_version: tuple[str, Version] | None = None + # Version range cache (populated by _to_ranges) + self._ranges: Sequence[Interval] | None = None + def _get_spec_version(self, version: str) -> Version | None: """One element cache, as only one spec Version is needed per Specifier.""" if self._spec_version is not None and self._spec_version[0] == version: return self._spec_version[1] - version_specifier = _coerce_version(version) + version_specifier = coerce_version(version) if version_specifier is None: return None @@ -290,6 +409,27 @@ class Specifier(BaseSpecifier): assert spec_version is not None return spec_version + def _to_ranges(self) -> Sequence[Interval]: + """Convert this specifier to sorted, non-overlapping version ranges. + + Each standard operator maps to one or two ranges. ``===`` is + modeled as full range (actual check done separately). Cached. + """ + if self._ranges is not None: + return self._ranges + + op = self.operator + ver_str = self.version + + if op == "===": + result: Sequence[Interval] = FULL_RANGE + else: + version = self._require_spec_version(ver_str.removesuffix(".*")) + result = bounds_for_spec(op, ver_str, version) + + self._ranges = result + return result + @property def prereleases(self) -> bool | None: # If there is an explicit prereleases set for this, then we'll just @@ -300,29 +440,67 @@ class Specifier(BaseSpecifier): # Only the "!=" operator does not imply prereleases when # the version in the specifier is a prerelease. operator, version_str = self._spec - if operator != "!=": - # The == specifier with trailing .* cannot include prereleases - # e.g. "==1.0a1.*" is not valid. - if operator == "==" and version_str.endswith(".*"): - return False + if operator == "!=": + return False - # "===" can have arbitrary string versions, so we cannot parse - # those, we take prereleases as unknown (None) for those. - version = self._get_spec_version(version_str) - if version is None: - return None + # The == specifier with trailing .* cannot include prereleases + # e.g. "==1.0a1.*" is not valid. + if operator == "==" and version_str.endswith(".*"): + return False - # For all other operators, use the check if spec Version - # object implies pre-releases. - if version.is_prerelease: - return True + # "===" can have arbitrary string versions, so we cannot parse + # those, we take prereleases as unknown (None) for those. + version = self._get_spec_version(version_str) + if version is None: + return None - return False + # For all other operators, use the check if spec Version + # object implies pre-releases. + return version.is_prerelease @prereleases.setter def prereleases(self, value: bool | None) -> None: self._prereleases = value + def __getstate__(self) -> tuple[tuple[str, str], bool | None]: + # Return state as a 2-item tuple for compactness: + # ((operator, version), prereleases) + # Cache members are excluded and will be recomputed on demand. + return (self._spec, self._prereleases) + + def __setstate__(self, state: object) -> None: + # Always discard cached values - they will be recomputed on demand. + self._spec_version = None + self._ranges = None + + if isinstance(state, tuple): + if len(state) == 2: + # New format (26.2+): ((operator, version), prereleases) + spec, prereleases = state + if _validate_spec(spec) and _validate_pre(prereleases): + self._spec = spec + self._prereleases = prereleases + return + if len(state) == 2 and isinstance(state[1], dict): + # Format (packaging 26.0-26.1): (None, {slot: value}). + _, slot_dict = state + spec = slot_dict.get("_spec") + prereleases = slot_dict.get("_prereleases", "invalid") + if _validate_spec(spec) and _validate_pre(prereleases): + self._spec = spec + self._prereleases = prereleases + return + if isinstance(state, dict): + # Old format (packaging <= 25.x, no __slots__): state is a plain dict. + spec = state.get("_spec") + prereleases = state.get("_prereleases", "invalid") + if _validate_spec(spec) and _validate_pre(prereleases): + self._spec = spec + self._prereleases = prereleases + return + + raise TypeError(f"Cannot restore Specifier from {state!r}") + @property def operator(self) -> str: """The operator of this specifier. @@ -415,151 +593,6 @@ class Specifier(BaseSpecifier): return self._canonical_spec == other._canonical_spec - def _get_operator(self, op: str) -> CallableOperator: - operator_callable: CallableOperator = getattr( - self, f"_compare_{self._operators[op]}" - ) - return operator_callable - - def _compare_compatible(self, prospective: Version, spec: str) -> bool: - # Compatible releases have an equivalent combination of >= and ==. That - # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to - # implement this in terms of the other specifiers instead of - # implementing it ourselves. The only thing we need to do is construct - # the other specifiers. - - # We want everything but the last item in the version, but we want to - # ignore suffix segments. - prefix = _version_join( - list(itertools.takewhile(_is_not_suffix, _version_split(spec)))[:-1] - ) - - # Add the prefix notation to the end of our string - prefix += ".*" - - return self._get_operator(">=")(prospective, spec) and self._get_operator("==")( - prospective, prefix - ) - - def _compare_equal(self, prospective: Version, spec: str) -> bool: - # We need special logic to handle prefix matching - if spec.endswith(".*"): - # In the case of prefix matching we want to ignore local segment. - normalized_prospective = canonicalize_version( - _public_version(prospective), strip_trailing_zero=False - ) - # Get the normalized version string ignoring the trailing .* - normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False) - # Split the spec out by bangs and dots, and pretend that there is - # an implicit dot in between a release segment and a pre-release segment. - split_spec = _version_split(normalized_spec) - - # Split the prospective version out by bangs and dots, and pretend - # that there is an implicit dot in between a release segment and - # a pre-release segment. - split_prospective = _version_split(normalized_prospective) - - # 0-pad the prospective version before shortening it to get the correct - # shortened version. - padded_prospective, _ = _pad_version(split_prospective, split_spec) - - # Shorten the prospective version to be the same length as the spec - # so that we can determine if the specifier is a prefix of the - # prospective version or not. - shortened_prospective = padded_prospective[: len(split_spec)] - - return shortened_prospective == split_spec - else: - # Convert our spec string into a Version - spec_version = self._require_spec_version(spec) - - # If the specifier does not have a local segment, then we want to - # act as if the prospective version also does not have a local - # segment. - if not spec_version.local: - prospective = _public_version(prospective) - - return prospective == spec_version - - def _compare_not_equal(self, prospective: Version, spec: str) -> bool: - return not self._compare_equal(prospective, spec) - - def _compare_less_than_equal(self, prospective: Version, spec: str) -> bool: - # NB: Local version identifiers are NOT permitted in the version - # specifier, so local version labels can be universally removed from - # the prospective version. - return _public_version(prospective) <= self._require_spec_version(spec) - - def _compare_greater_than_equal(self, prospective: Version, spec: str) -> bool: - # NB: Local version identifiers are NOT permitted in the version - # specifier, so local version labels can be universally removed from - # the prospective version. - return _public_version(prospective) >= self._require_spec_version(spec) - - def _compare_less_than(self, prospective: Version, spec_str: str) -> bool: - # Convert our spec to a Version instance, since we'll want to work with - # it as a version. - spec = self._require_spec_version(spec_str) - - # Check to see if the prospective version is less than the spec - # version. If it's not we can short circuit and just return False now - # instead of doing extra unneeded work. - if not prospective < spec: - return False - - # This special case is here so that, unless the specifier itself - # includes is a pre-release version, that we do not accept pre-release - # versions for the version mentioned in the specifier (e.g. <3.1 should - # not match 3.1.dev0, but should match 3.0.dev0). - if ( - not spec.is_prerelease - and prospective.is_prerelease - and _base_version(prospective) == _base_version(spec) - ): - return False - - # If we've gotten to here, it means that prospective version is both - # less than the spec version *and* it's not a pre-release of the same - # version in the spec. - return True - - def _compare_greater_than(self, prospective: Version, spec_str: str) -> bool: - # Convert our spec to a Version instance, since we'll want to work with - # it as a version. - spec = self._require_spec_version(spec_str) - - # Check to see if the prospective version is greater than the spec - # version. If it's not we can short circuit and just return False now - # instead of doing extra unneeded work. - if not prospective > spec: - return False - - # This special case is here so that, unless the specifier itself - # includes is a post-release version, that we do not accept - # post-release versions for the version mentioned in the specifier - # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0). - if ( - not spec.is_postrelease - and prospective.is_postrelease - and _base_version(prospective) == _base_version(spec) - ): - return False - - # Ensure that we do not allow a local version of the version mentioned - # in the specifier, which is technically greater than, to match. - if prospective.local is not None and _base_version( - prospective - ) == _base_version(spec): - return False - - # If we've gotten to here, it means that prospective version is both - # greater than the spec version *and* it's not a pre-release of the - # same version in the spec. - return True - - def _compare_arbitrary(self, prospective: Version | str, spec: str) -> bool: - return str(prospective).lower() == str(spec).lower() - def __contains__(self, item: str | Version) -> bool: """Return whether or not the item is contained in this specifier. @@ -586,7 +619,7 @@ class Specifier(BaseSpecifier): :param item: The item to check for, which can be a version string or a - :class:`Version` instance. + :class:`~packaging.version.Version` instance. :param prereleases: Whether or not to match prereleases with this Specifier. If set to ``None`` (the default), it will follow the recommendation from @@ -604,22 +637,75 @@ class Specifier(BaseSpecifier): False >>> Specifier(">=1.2.3").contains("1.3.0a1") True - """ - return bool(list(self.filter([item], prereleases=prereleases))) + .. versionchanged:: 26.0 + + With ``prereleases=None``, a prerelease now matches. A single + version has no alternatives, so the :pep:`440` rule to accept + prereleases when nothing else satisfies the specifier applies. + Earlier versions rejected it. An unparsable version now returns + ``False`` instead of raising :exc:`~packaging.version.InvalidVersion`. + """ + # ``===`` compares the raw string, so a Version parse here would + # be wasted. + if self._spec[0] == "===": + return bool(list(self.filter([item], prereleases=prereleases))) + + parsed = coerce_version(item) + if parsed is None: + # Standard operators never match an unparsable input. + return False + + if prereleases is None: + prereleases = resolve_prereleases(self._prereleases, self.prereleases) + + if prereleases is False and parsed.is_prerelease: + return False + + # ``_fast_match`` answers the simple operators without building a + # range; otherwise fall back to the engine's bounds membership. + match = _fast_match(self, parsed) + if match is not None: + return match + + return matches_bounds_only(self._to_ranges(), parsed) + + @typing.overload + def filter( + self, + iterable: Iterable[UnparsedVersionVar], + prereleases: bool | None = None, + key: None = ..., + ) -> Iterator[UnparsedVersionVar]: ... + + @typing.overload + def filter( + self, + iterable: Iterable[T], + prereleases: bool | None = None, + key: Callable[[T], UnparsedVersion] = ..., + ) -> Iterator[T]: ... def filter( - self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None - ) -> Iterator[UnparsedVersionVar]: + self, + iterable: Iterable[Any], + prereleases: bool | None = None, + key: Callable[[Any], UnparsedVersion] | None = None, + ) -> Iterator[Any]: """Filter items in the given iterable, that match the specifier. :param iterable: - An iterable that can contain version strings and :class:`Version` instances. - The items in the iterable will be filtered according to the specifier. + An iterable that can contain version strings and + :class:`~packaging.version.Version` instances. The items in the + iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will follow the recommendation from :pep:`440` and match prereleases if there are no other versions. + :param key: + A callable that takes a single argument (an item from the iterable) and + returns a version string or :class:`~packaging.version.Version` + instance to be used for filtering. >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] @@ -631,106 +717,49 @@ class Specifier(BaseSpecifier): ['1.3', '1.5a1'] >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] + >>> list(Specifier(">=1.2.3").filter( + ... [{"ver": "1.2"}, {"ver": "1.3"}], + ... key=lambda x: x["ver"])) + [{'ver': '1.3'}] + + .. versionchanged:: 26.1 + + Added the ``key`` parameter. """ - prereleases_versions = [] - found_non_prereleases = False + if prereleases is None: + prereleases = resolve_prereleases(self._prereleases, self.prereleases) - # Determine if to include prereleases by default - include_prereleases = ( - prereleases if prereleases is not None else self.prereleases - ) + if self.operator == "===": + spec_lower = self.version.lower() + matches = ( + item + for item in iterable + if str(item if key is None else key(item)).lower() == spec_lower + ) + return _apply_prereleases_filter(matches, key, prereleases) - # Get the matching operator - operator_callable = self._get_operator(self.operator) - - # Filter versions - for version in iterable: - parsed_version = _coerce_version(version) - if parsed_version is None: - # === operator can match arbitrary (non-version) strings - if self.operator == "===" and self._compare_arbitrary( - version, self.version - ): - yield version - elif operator_callable(parsed_version, self.version): - # If it's not a prerelease or prereleases are allowed, yield it directly - if not parsed_version.is_prerelease or include_prereleases: - found_non_prereleases = True - yield version - # Otherwise collect prereleases for potential later use - elif prereleases is None and self._prereleases is not False: - prereleases_versions.append(version) - - # If no non-prereleases were found and prereleases weren't - # explicitly forbidden, yield the collected prereleases - if ( - not found_non_prereleases - and prereleases is None - and self._prereleases is not False - ): - yield from prereleases_versions + return filter_by_ranges(self._to_ranges(), iterable, key, prereleases) -_prefix_regex = re.compile(r"([0-9]+)((?:a|b|c|rc)[0-9]+)") +def _apply_prereleases_filter( + matches: Iterable[Any], + key: Callable[[Any], UnparsedVersion] | None, + prereleases: bool | None, +) -> Iterator[Any]: + """Apply ``prereleases=`` handling to an already-matched iterable. - -def _version_split(version: str) -> list[str]: - """Split version into components. - - The split components are intended for version comparison. The logic does - not attempt to retain the original version string, so joining the - components back with :func:`_version_join` may not produce the original - version string. + ``None`` means PEP 440 default (buffer pre-releases until a final + appears); ``True`` yields everything; ``False`` drops pre-releases. """ - result: list[str] = [] - - epoch, _, rest = version.rpartition("!") - result.append(epoch or "0") - - for item in rest.split("."): - match = _prefix_regex.fullmatch(item) - if match: - result.extend(match.groups()) - else: - result.append(item) - return result - - -def _version_join(components: list[str]) -> str: - """Join split version components into a version string. - - This function assumes the input came from :func:`_version_split`, where the - first component must be the epoch (either empty or numeric), and all other - components numeric. - """ - epoch, *rest = components - return f"{epoch}!{'.'.join(rest)}" - - -def _is_not_suffix(segment: str) -> bool: - return not any( - segment.startswith(prefix) for prefix in ("dev", "a", "b", "rc", "post") - ) - - -def _pad_version(left: list[str], right: list[str]) -> tuple[list[str], list[str]]: - left_split, right_split = [], [] - - # Get the release segment of our versions - left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left))) - right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right))) - - # Get the rest of our versions - left_split.append(left[len(left_split[0]) :]) - right_split.append(right[len(right_split[0]) :]) - - # Insert our padding - left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0]))) - right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0]))) - + if prereleases is None: + return _pep440_filter_prereleases(matches, key) + if prereleases: + return iter(matches) return ( - list(itertools.chain.from_iterable(left_split)), - list(itertools.chain.from_iterable(right_split)), + item + for item in matches + if (parsed := coerce_version(item if key is None else key(item))) is None + or not parsed.is_prerelease ) @@ -739,9 +768,28 @@ class SpecifierSet(BaseSpecifier): It can be passed a single specifier (``>=3.0``), a comma-separated list of specifiers (``>=3.0,!=3.1``), or no specifier at all. + + Instances are safe to serialize with :mod:`pickle`. They use a stable + format so the same pickle can be loaded in future packaging + releases. + + .. versionchanged:: 26.2 + + Added a stable pickle format. Pickles created with + packaging 26.2+ can be unpickled with future releases. + Backward compatibility with pickles from + packaging < 26.2 is supported but may be removed in a future + release. """ - __slots__ = ("_prereleases", "_specs") + __slots__ = ( + "_canonicalized", + "_has_arbitrary", + "_is_unsatisfiable", + "_prereleases", + "_ranges", + "_specs", + ) def __init__( self, @@ -770,17 +818,30 @@ class SpecifierSet(BaseSpecifier): # strip each item to remove leading/trailing whitespace. split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()] - # Make each individual specifier a Specifier and save in a frozen set - # for later. - self._specs = frozenset(map(Specifier, split_specifiers)) + self._specs: tuple[Specifier, ...] = tuple(map(Specifier, split_specifiers)) + # Fast substring check; avoids iterating parsed specs. + self._has_arbitrary = "===" in specifiers else: - # Save the supplied specifiers in a frozen set. - self._specs = frozenset(specifiers) + self._specs = tuple(specifiers) + # Substring check works for both Specifier objects and plain + # strings (setuptools passes lists of strings). + self._has_arbitrary = any("===" in str(s) for s in self._specs) + + self._canonicalized = len(self._specs) <= 1 + self._is_unsatisfiable: bool | None = None + self._ranges: Sequence[Interval] | None = None # Store our prereleases value so we can use it later to determine if # we accept prereleases or not. self._prereleases = prereleases + def _canonical_specs(self) -> tuple[Specifier, ...]: + """Deduplicate, sort, and cache specs for order-sensitive operations.""" + if not self._canonicalized: + self._specs = tuple(dict.fromkeys(sorted(self._specs, key=str))) + self._canonicalized = True + return self._specs + @property def prereleases(self) -> bool | None: # If we have been given an explicit prerelease modifier, then we'll @@ -804,6 +865,70 @@ class SpecifierSet(BaseSpecifier): @prereleases.setter def prereleases(self, value: bool | None) -> None: self._prereleases = value + self._is_unsatisfiable = None + + def __getstate__(self) -> tuple[tuple[Specifier, ...], bool | None]: + # Return state as a 2-item tuple for compactness: + # (specs, prereleases) + # Cache members are excluded and will be recomputed on demand. + return (self._specs, self._prereleases) + + def __setstate__(self, state: object) -> None: + # Always discard cached values - they will be recomputed on demand. + self._ranges = None + self._is_unsatisfiable = None + + if isinstance(state, tuple): + if len(state) == 2: + # New format (26.2+): (specs, prereleases) + specs, prereleases = state + if ( + isinstance(specs, tuple) + and all(isinstance(s, Specifier) for s in specs) + and _validate_pre(prereleases) + ): + self._specs = specs + self._prereleases = prereleases + self._canonicalized = len(specs) <= 1 + self._has_arbitrary = any("===" in str(s) for s in specs) + return + if len(state) == 2 and isinstance(state[1], dict): + # Format (packaging 26.0-26.1): (None, {slot: value}). + _, slot_dict = state + specs = slot_dict.get("_specs", ()) + prereleases = slot_dict.get("_prereleases") + # Convert frozenset to tuple (26.0 stored as frozenset) + if isinstance(specs, frozenset): + specs = tuple(sorted(specs, key=str)) + if ( + isinstance(specs, tuple) + and all(isinstance(s, Specifier) for s in specs) + and _validate_pre(prereleases) + ): + self._specs = specs + self._prereleases = prereleases + self._canonicalized = len(self._specs) <= 1 + self._has_arbitrary = any("===" in str(s) for s in self._specs) + return + if isinstance(state, dict): + # Old format (packaging <= 25.x, no __slots__): state is a plain dict. + specs = state.get("_specs", ()) + prereleases = state.get("_prereleases") + # Convert frozenset to tuple (26.0 stored as frozenset) + if isinstance(specs, frozenset): + specs = tuple(sorted(specs, key=str)) + if ( + isinstance(specs, tuple) + and all(isinstance(s, Specifier) for s in specs) + and _validate_pre(prereleases) + ): + self._specs = specs + self._prereleases = prereleases + self._canonicalized = len(self._specs) <= 1 + self._has_arbitrary = any("===" in str(s) for s in self._specs) + return + + raise TypeError(f"Cannot restore SpecifierSet from {state!r}") def __repr__(self) -> str: """A representation of the specifier set that shows all internal state. @@ -824,7 +949,7 @@ class SpecifierSet(BaseSpecifier): else "" ) - return f"" + return f"<{self.__class__.__name__}({str(self)!r}{pre})>" def __str__(self) -> str: """A string representation of the specifier set that can be round-tripped. @@ -837,10 +962,10 @@ class SpecifierSet(BaseSpecifier): >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False)) '!=1.0.1,>=1.0.0' """ - return ",".join(sorted(str(s) for s in self._specs)) + return ",".join(str(s) for s in self._canonical_specs()) def __hash__(self) -> int: - return hash(self._specs) + return hash(self._canonical_specs()) def __and__(self, other: SpecifierSet | str) -> SpecifierSet: """Return a SpecifierSet which is a combination of the two sets. @@ -858,13 +983,14 @@ class SpecifierSet(BaseSpecifier): return NotImplemented specifier = SpecifierSet() - specifier._specs = frozenset(self._specs | other._specs) + specifier._specs = self._specs + other._specs + specifier._canonicalized = len(specifier._specs) <= 1 + specifier._has_arbitrary = self._has_arbitrary or other._has_arbitrary - if self._prereleases is None and other._prereleases is not None: + # Combine prerelease settings: use common or non-None value + if self._prereleases is None or self._prereleases == other._prereleases: specifier._prereleases = other._prereleases - elif ( - self._prereleases is not None and other._prereleases is None - ) or self._prereleases == other._prereleases: + elif other._prereleases is None: specifier._prereleases = self._prereleases else: raise ValueError( @@ -897,7 +1023,7 @@ class SpecifierSet(BaseSpecifier): elif not isinstance(other, SpecifierSet): return NotImplemented - return self._specs == other._specs + return self._canonical_specs() == other._canonical_specs() def __len__(self) -> int: """Returns the number of specifiers in this specifier set.""" @@ -913,6 +1039,171 @@ class SpecifierSet(BaseSpecifier): """ return iter(self._specs) + def _get_ranges(self) -> Sequence[Interval]: + """Intersect all specifiers into a single sequence of version ranges. + + Empty when unsatisfiable. Callers must ensure ``self._specs`` + is non-empty. + """ + if self._ranges is not None: + return self._ranges + + self._ranges = intersect_specifier_bounds(s._to_ranges() for s in self._specs) + return self._ranges + + def is_unsatisfiable(self) -> bool: + """Check whether this specifier set can never be satisfied. + + Returns True if no version can satisfy all specifiers simultaneously. + + >>> SpecifierSet(">=2.0,<1.0").is_unsatisfiable() + True + >>> SpecifierSet(">=1.0,<2.0").is_unsatisfiable() + False + >>> SpecifierSet("").is_unsatisfiable() + False + >>> SpecifierSet("==1.0,!=1.0").is_unsatisfiable() + True + + .. versionadded:: 26.1 + """ + cached = self._is_unsatisfiable + if cached is not None: + return cached + + if not self._specs: + self._is_unsatisfiable = False + return False + + result = not self._get_ranges() + + if not result: + result = self._check_arbitrary_unsatisfiable() + + if not result and self.prereleases is False: + result = ranges_are_prerelease_only(self._get_ranges()) + + self._is_unsatisfiable = result + return result + + def _check_arbitrary_unsatisfiable(self) -> bool: + """Check === (arbitrary equality) specs for unsatisfiability. + + === uses case-insensitive string comparison, so the only candidate + that can match ``===V`` is the literal string V. This method + checks whether that candidate is excluded by other specifiers. + """ + arbitrary = [s for s in self._specs if s.operator == "==="] + if not arbitrary: + return False + + # Multiple === must agree on the same string (case-insensitive). + first = arbitrary[0].version.lower() + if any(s.version.lower() != first for s in arbitrary[1:]): + return True + + # The sole candidate is the === version string. Check whether + # it can satisfy every standard spec. + candidate = coerce_version(arbitrary[0].version) + + # With prereleases=False, a prerelease candidate is excluded + # by contains() before the === string check even runs. + if ( + self.prereleases is False + and candidate is not None + and candidate.is_prerelease + ): + return True + + standard = [s for s in self._specs if s.operator != "==="] + if not standard: + return False + + if candidate is None: + # Unparsable string cannot satisfy any standard spec. + return True + + return not all(s.contains(candidate) for s in standard) + + def to_range(self) -> ranges.VersionRange: + """Return the :class:`~packaging.ranges.VersionRange` this set accepts. + + An empty set yields the full range; an unsatisfiable set yields the + empty range. ``===`` specifiers contribute literal-string admission. + + >>> SpecifierSet(">=1.0,<2.0").to_range() + + + .. versionadded:: 26.3 + """ + from .ranges import VersionRange # noqa: PLC0415 + + return VersionRange._from_specifier_set(self) + + def _check_relation_operand(self, other: object) -> None: + if not isinstance(other, SpecifierSet): + raise TypeError("expected a SpecifierSet") + if self._has_arbitrary or other._has_arbitrary: + raise ValueError("set relations do not support === specifiers") + + def is_subset(self, other: SpecifierSet) -> bool: + """Return whether every version matching this set also matches other. + + :raises ValueError: + If either set uses ``===`` specifiers, or the two sets were + given different ``prereleases`` arguments (unset on one side + counts as different). + :raises TypeError: + If other is not a :class:`SpecifierSet`. + + >>> SpecifierSet(">=3.12,<3.13").is_subset(SpecifierSet(">=3.12")) + True + >>> SpecifierSet(">=3.12").is_subset(SpecifierSet(">=3.12,<3.13")) + False + + .. versionadded:: 26.3 + """ + self._check_relation_operand(other) + return self.to_range().is_subset(other.to_range()) + + def is_superset(self, other: SpecifierSet) -> bool: + """Return whether every version matching other also matches this set. + + :raises ValueError: + If either set uses ``===`` specifiers, or the two sets were + given different ``prereleases`` arguments (unset on one side + counts as different). + :raises TypeError: + If other is not a :class:`SpecifierSet`. + + >>> SpecifierSet(">=3.12").is_superset(SpecifierSet(">=3.12,<3.13")) + True + + .. versionadded:: 26.3 + """ + self._check_relation_operand(other) + return self.to_range().is_superset(other.to_range()) + + def is_disjoint(self, other: SpecifierSet) -> bool: + """Return whether this set and other share no matching versions. + + :raises ValueError: + If either set uses ``===`` specifiers, or the two sets were + given different ``prereleases`` arguments (unset on one side + counts as different). + :raises TypeError: + If other is not a :class:`SpecifierSet`. + + >>> SpecifierSet("<3.12").is_disjoint(SpecifierSet(">=3.12")) + True + >>> SpecifierSet("<3.12").is_disjoint(SpecifierSet(">=3.11")) + False + + .. versionadded:: 26.3 + """ + self._check_relation_operand(other) + return self.to_range().is_disjoint(other.to_range()) + def __contains__(self, item: UnparsedVersion) -> bool: """Return whether or not the item is contained in this specifier. @@ -944,7 +1235,7 @@ class SpecifierSet(BaseSpecifier): :param item: The item to check for, which can be a version string or a - :class:`Version` instance. + :class:`~packaging.version.Version` instance. :param prereleases: Whether or not to match prereleases with this SpecifierSet. If set to ``None`` (the default), it will follow the recommendation from :pep:`440` @@ -965,27 +1256,99 @@ class SpecifierSet(BaseSpecifier): False >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True) True + + .. versionchanged:: 26.0 + + With ``prereleases=None``, a prerelease now matches. A single + version has no alternatives, so the :pep:`440` rule to accept + prereleases when nothing else satisfies the specifiers applies. + Earlier versions rejected it. An unparsable version now returns + ``False`` instead of raising :exc:`~packaging.version.InvalidVersion`. """ - version = _coerce_version(item) + version = coerce_version(item) if version is not None and installed and version.is_prerelease: prereleases = True - check_item = item if version is None else version + # When item is a string and === is involved, keep it as-is + # so the comparison isn't done against the normalized form. + if version is None or (self._has_arbitrary and not isinstance(item, Version)): + check_item = item + else: + check_item = version + + # Fast path: a parseable, local-free version against a rangelike set. + # A local on ``version`` needs PEP 440 stripping that the range path + # applies. + if ( + version is not None + and not self._has_arbitrary + and version.local is None + and self._specs + ): + if version.is_prerelease and ( + prereleases is False + or (prereleases is None and self._prereleases is False) + ): + return False + + bounds = self._ranges + if bounds is None: + # Per-spec ``_fast_match`` answers a set of simple specifiers + # without folding anything. If a spec needs the range path, + # fold the intersected bounds once and cache them so repeated + # checks on the same set stay cheap. + for spec in self._specs: + match = _fast_match(spec, version) + if match is None: + break + if not match: + return False + else: + return True + + bounds = self._ranges = self._get_ranges() + + return matches_bounds_only(bounds, version) + return bool(list(self.filter([check_item], prereleases=prereleases))) + @typing.overload def filter( - self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None - ) -> Iterator[UnparsedVersionVar]: + self, + iterable: Iterable[UnparsedVersionVar], + prereleases: bool | None = None, + key: None = ..., + ) -> Iterator[UnparsedVersionVar]: ... + + @typing.overload + def filter( + self, + iterable: Iterable[T], + prereleases: bool | None = None, + key: Callable[[T], UnparsedVersion] = ..., + ) -> Iterator[T]: ... + + def filter( + self, + iterable: Iterable[Any], + prereleases: bool | None = None, + key: Callable[[Any], UnparsedVersion] | None = None, + ) -> Iterator[Any]: """Filter items in the given iterable, that match the specifiers in this set. :param iterable: - An iterable that can contain version strings and :class:`Version` instances. - The items in the iterable will be filtered according to the specifier. + An iterable that can contain version strings and + :class:`~packaging.version.Version` instances. The items in the + iterable will be filtered according to the specifier. :param prereleases: Whether or not to allow prereleases in the returned iterator. If set to ``None`` (the default), it will follow the recommendation from :pep:`440` and match prereleases if there are no other versions. + :param key: + A callable that takes a single argument (an item from the iterable) and + returns a version string or :class:`~packaging.version.Version` + instance to be used for filtering. >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"])) ['1.3'] @@ -997,6 +1360,10 @@ class SpecifierSet(BaseSpecifier): ['1.3', '1.5a1'] >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"])) ['1.3', '1.5a1'] + >>> list(SpecifierSet(">=1.2.3").filter( + ... [{"ver": "1.2"}, {"ver": "1.3"}], + ... key=lambda x: x["ver"])) + [{'ver': '1.3'}] An "empty" SpecifierSet will filter items based on the presence of prerelease versions in the set. @@ -1009,6 +1376,15 @@ class SpecifierSet(BaseSpecifier): ['1.3', '1.5a1'] >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True)) ['1.3', '1.5a1'] + + .. versionchanged:: 26.0 + + Prerelease filtering now follows the PEP 440 recommendation of + yielding prereleases only when no final release is present. + + .. versionchanged:: 26.1 + + Added the ``key`` parameter. """ # Determine if we're forcing a prerelease or not, if we're not forcing # one for this particular filter call, then we'll use whatever the @@ -1016,53 +1392,66 @@ class SpecifierSet(BaseSpecifier): if prereleases is None and self.prereleases is not None: prereleases = self.prereleases - # If we have any specifiers, then we want to wrap our iterable in the - # filter method for each one, this will act as a logical AND amongst - # each specifier. if self._specs: - # When prereleases is None, we need to let all versions through - # the individual filters, then decide about prereleases at the end - # based on whether any non-prereleases matched ALL specs. - for spec in self._specs: - iterable = spec.filter( - iterable, prereleases=True if prereleases is None else prereleases - ) - - if prereleases is not None: - # If we have a forced prereleases value, - # we can immediately return the iterator. - return iter(iterable) - else: - # Handle empty SpecifierSet cases where prereleases is not None. - if prereleases is True: - return iter(iterable) - - if prereleases is False: - return ( + if self._has_arbitrary: + # Slow path for === + specs = self._specs + matches = ( item for item in iterable - if (version := _coerce_version(item)) is None - or not version.is_prerelease + if all( + s.contains(item if key is None else key(item), prereleases=True) + for s in specs + ) ) + return _apply_prereleases_filter(matches, key, prereleases) - # Finally if prereleases is None, apply PEP 440 logic: - # exclude prereleases unless there are no final releases that matched. - filtered_items: list[UnparsedVersionVar] = [] - found_prereleases: list[UnparsedVersionVar] = [] - found_final_release = False + ranges = self._ranges + if ranges is None: + ranges = self._get_ranges() + return filter_by_ranges(ranges, iterable, key, prereleases) - for item in iterable: - parsed_version = _coerce_version(item) + # Empty SpecifierSet. + return _apply_prereleases_filter(iterable, key, prereleases) + + +def _pep440_filter_prereleases( + iterable: Iterable[Any], key: Callable[[Any], UnparsedVersion] | None +) -> Iterator[Any]: + """Filter per PEP 440: exclude prereleases unless no finals exist.""" + # Two lists used: + # * all_nonfinal to preserve order if no finals exist + # * arbitrary_strings for streaming when first final found + all_nonfinal: list[Any] = [] + arbitrary_strings: list[Any] = [] + + found_final = False + for item in iterable: + parsed = coerce_version(item if key is None else key(item)) + + if parsed is None: # Arbitrary strings are always included as it is not # possible to determine if they are prereleases, # and they have already passed all specifiers. - if parsed_version is None: - filtered_items.append(item) - found_prereleases.append(item) - elif parsed_version.is_prerelease: - found_prereleases.append(item) + if found_final: + yield item else: - filtered_items.append(item) - found_final_release = True + arbitrary_strings.append(item) + all_nonfinal.append(item) + continue - return iter(filtered_items if found_final_release else found_prereleases) + if not parsed.is_prerelease: + # Final release found - flush arbitrary strings, then yield + if not found_final: + yield from arbitrary_strings + found_final = True + yield item + continue + + # Prerelease - buffer if no finals yet, otherwise skip + if not found_final: + all_nonfinal.append(item) + + # No finals found - yield all buffered items + if not found_final: + yield from all_nonfinal diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/tags.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/tags.py index 5ef27c8..5ba4a4d 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/tags.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/tags.py @@ -5,28 +5,72 @@ from __future__ import annotations import logging +import operator import platform import re import struct import subprocess import sys import sysconfig +from collections.abc import Iterable, Iterator, Sequence from importlib.machinery import EXTENSION_SUFFIXES from typing import ( - Any, - Iterable, - Iterator, - Sequence, - Tuple, + TYPE_CHECKING, + TypeVar, cast, ) from . import _manylinux, _musllinux +if TYPE_CHECKING: + from collections.abc import Callable + from collections.abc import Set as AbstractSet + + +__all__ = [ + "INTERPRETER_SHORT_NAMES", + "AppleVersion", + "InvalidTag", + "PythonVersion", + "Tag", + "TooManyTagsError", + "UnsortedTagsError", + "android_platforms", + "compatible_tags", + "cpython_tags", + "create_compatible_tags_selector", + "generic_tags", + "interpreter_name", + "interpreter_version", + "ios_platforms", + "mac_platforms", + "parse_tag", + "platform_tags", + "pure_python_tags", + "sys_tags", +] + + +def __dir__() -> list[str]: + return __all__ + + logger = logging.getLogger(__name__) PythonVersion = Sequence[int] -AppleVersion = Tuple[int, int] +""" +A sequence of integers describing a Python version, e.g. ``(3, 13)``. + +.. versionadded:: 20.0 +""" + +AppleVersion = tuple[int, int] +""" +A ``(major, minor)`` integer pair describing an Apple OS version. + +.. versionadded:: 24.2 +""" +_T = TypeVar("_T") INTERPRETER_SHORT_NAMES: dict[str, str] = { "python": "py", # Generic. @@ -37,7 +81,38 @@ INTERPRETER_SHORT_NAMES: dict[str, str] = { } -_32_BIT_INTERPRETER = struct.calcsize("P") == 4 +# This function can be unit tested without reloading the module +# (Unlike _32_BIT_INTERPRETER) +def _compute_32_bit_interpreter() -> bool: + return struct.calcsize("P") == 4 + + +_32_BIT_INTERPRETER = _compute_32_bit_interpreter() + + +class UnsortedTagsError(ValueError): + """ + Raised when a tag component is not in sorted order per PEP 425. + + .. versionadded:: 26.1 + """ + + +class InvalidTag(ValueError): + """ + Raised when an interpreter component is not an identifier, a tag component + is empty, or a tag does not have exactly three components. + + .. versionadded:: 26.3 + """ + + +class TooManyTagsError(ValueError): + """ + Raised when a compressed tag set exceeds the configured limit. + + .. versionadded:: 26.3 + """ class Tag: @@ -46,11 +121,29 @@ class Tag: Instances are considered immutable and thus are hashable. Equality checking is also supported. + + Instances are safe to serialize with :mod:`pickle`. They use a stable + format so the same pickle can be loaded in future packaging releases. + + .. versionchanged:: 26.2 + + Added a stable pickle format. Pickles created with packaging 26.2+ can + be unpickled with future releases. Backward compatibility with pickles + from pip._vendor.packaging < 26.2 is supported but may be removed in a future + release. """ __slots__ = ["_abi", "_hash", "_interpreter", "_platform"] def __init__(self, interpreter: str, abi: str, platform: str) -> None: + """ + :param str interpreter: The interpreter name, e.g. ``"py"`` + (see :attr:`INTERPRETER_SHORT_NAMES` for mapping + well-known interpreter names to their short names). + :param str abi: The ABI that a wheel supports, e.g. ``"cp37m"``. + :param str platform: The OS/platform the wheel supports, + e.g. ``"win_amd64"``. + """ self._interpreter = interpreter.lower() self._abi = abi.lower() self._platform = platform.lower() @@ -63,14 +156,25 @@ class Tag: @property def interpreter(self) -> str: + """ + The interpreter name, e.g. ``"py"`` (see + :attr:`INTERPRETER_SHORT_NAMES` for mapping well-known interpreter + names to their short names). + """ return self._interpreter @property def abi(self) -> str: + """ + The supported ABI. + """ return self._abi @property def platform(self) -> str: + """ + The OS/platform. + """ return self._platform def __eq__(self, other: object) -> bool: @@ -93,28 +197,117 @@ class Tag: def __repr__(self) -> str: return f"<{self} @ {id(self)}>" - def __setstate__(self, state: tuple[None, dict[str, Any]]) -> None: - # The cached _hash is wrong when unpickling. - _, slots = state - for k, v in slots.items(): - setattr(self, k, v) - self._hash = hash((self._interpreter, self._abi, self._platform)) + def __getstate__(self) -> tuple[str, str, str]: + # Return state as a 3-item tuple: (interpreter, abi, platform). + # Cache member _hash is excluded and will be recomputed. + return (self._interpreter, self._abi, self._platform) + + def __setstate__(self, state: object) -> None: + if isinstance(state, tuple): + if len(state) == 3 and all(isinstance(s, str) for s in state): + # New format (26.2+): (interpreter, abi, platform) + self._interpreter, self._abi, self._platform = state + self._hash = hash((self._interpreter, self._abi, self._platform)) + return + if len(state) == 2 and isinstance(state[1], dict): + # Old format (packaging <= 26.1, __slots__): (None, {slot: value}). + _, slots = state + try: + interpreter = slots["_interpreter"] + abi = slots["_abi"] + platform = slots["_platform"] + except KeyError: + raise TypeError(f"Cannot restore Tag from {state!r}") from None + if not all( + isinstance(value, str) for value in (interpreter, abi, platform) + ): + raise TypeError(f"Cannot restore Tag from {state!r}") + self._interpreter = interpreter.lower() + self._abi = abi.lower() + self._platform = platform.lower() + self._hash = hash((self._interpreter, self._abi, self._platform)) + return + raise TypeError(f"Cannot restore Tag from {state!r}") -def parse_tag(tag: str) -> frozenset[Tag]: +def parse_tag( + tag: str, *, validate_order: bool = False, limit: int | None = None +) -> frozenset[Tag]: """ - Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances. + Parses the provided tag (e.g. `py3-none-any`) into a frozenset of + :class:`Tag` instances. Returning a set is required due to the possibility that the tag is a - compressed tag set. + `compressed tag set`_, e.g. ``"py2.py3-none-any"`` which supports both + Python 2 and Python 3. + + If **validate_order** is true, compressed tag set components are checked + to be in sorted order as required by PEP 425. + + If **limit** is not ``None``, the compressed tag set can generate at most + that many tags. + + :param str tag: The tag to parse, e.g. ``"py3-none-any"``. + :param bool validate_order: Check whether compressed tag set components + are in sorted order. + :param int | None limit: The maximum number of tags to parse. + :raises UnsortedTagsError: If **validate_order** is true and any compressed tag + set component is not in sorted order. + :raises InvalidTag: If the interpreter field is not an identifier; if the + interpreter, ABI, or platform field (or any member of a compressed tag + set) is empty; or if the tag does not have exactly three components. + :raises TooManyTagsError: If **limit** is not ``None`` and the compressed tag + set would generate more than **limit** tags. + :raises ValueError: If **limit** is negative. + + .. versionadded:: 26.1 + The *validate_order* parameter. + + .. versionadded:: 26.3 + Raises :class:`InvalidTag` when an interpreter component is not an + identifier, a tag component is empty, or a tag does not have exactly + three components. + Added the *limit* parameter. Raises :class:`TooManyTagsError` if the compressed + tag set would generate more than *limit* tags. """ - tags = set() - interpreters, abis, platforms = tag.split("-") - for interpreter in interpreters.split("."): - for abi in abis.split("."): - for platform_ in platforms.split("."): - tags.add(Tag(interpreter, abi, platform_)) - return frozenset(tags) + + if limit is not None and limit < 0: + raise ValueError("limit must be non-negative") + + component_parts = [component.split(".") for component in tag.split("-")] + for parts in component_parts: + if "" in parts: + component = ".".join(parts) + raise InvalidTag(f"Tag {tag!r} has an empty component: {component!r}") + if validate_order and parts != sorted(parts): + component = ".".join(parts) + raise UnsortedTagsError( + f"Tag component {component!r} is not in sorted order per PEP 425" + ) + + tag_count = 1 + for parts in component_parts: + tag_count *= len(parts) + + if limit is not None and tag_count > limit: + raise TooManyTagsError( + f"Compressed tag set would generate {tag_count} tags, exceeding " + f"limit {limit}" + ) + + try: + interpreters, abis, platforms = component_parts + except ValueError as exc: + raise InvalidTag(f"Tag {tag!r} must have exactly three components") from exc + for interpreter in interpreters: + if not interpreter.isidentifier(): + raise InvalidTag(f"Tag {tag!r} has an invalid interpreter: {interpreter!r}") + return frozenset( + Tag(interpreter, abi, platform_) + for interpreter in interpreters + for abi in abis + for platform_ in platforms + ) def _get_config_var(name: str, warn: bool = False) -> int | str | None: @@ -150,12 +343,25 @@ def _abi3_applies(python_version: PythonVersion, threading: bool) -> bool: """ Determine if the Python version supports abi3. - PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`) + PEP 384 was first implemented in Python 3.2. The free-threaded builds do not support abi3. """ return len(python_version) > 1 and tuple(python_version) >= (3, 2) and not threading +def _abi3t_applies(python_version: PythonVersion, threading: bool) -> bool: + """ + Determine if the Python version supports abi3t. + + PEP 803 was first implemented in Python 3.15 but, per PEP 803, this + returns tags going back to Python 3.2 to mirror the abi3 + implementation and leave open the possibility of abi3t wheels + supporting older Python versions. + + """ + return len(python_version) > 1 and tuple(python_version) >= (3, 2) and threading + + def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> list[str]: py_version = tuple(py_version) # To allow for version comparison. abis = [] @@ -197,19 +403,33 @@ def cpython_tags( warn: bool = False, ) -> Iterator[Tag]: """ - Yields the tags for a CPython interpreter. + Yields the tags for the CPython interpreter. - The tags consist of: - - cp-- - - cp-abi3- - - cp-none- - - cp-abi3- # Older Python versions down to 3.2. + The specific tags generated are: - If python_version only specifies a major version then user-provided ABIs and - the 'none' ABItag will be used. + - ``cp--`` + - ``cp--`` + - ``cp-none-`` + - ``cp--`` where "older version" is all older + minor versions down to Python 3.2 (when ``abi3`` was introduced) - If 'abi3' or 'none' are specified in 'abis' then they will be yielded at - their normal position and not at the beginning. + If ``python_version`` only provides a major-only version then only + user-provided ABIs via ``abis`` and the ``none`` ABI will be used. + + The ``stable_abi`` will be either ``abi3`` or ``abi3t`` if `abi` is a + GIL-enabled ABI like `"cp315"` or a free-threaded ABI like `"cp315t"`, + respectively. + + :param Sequence python_version: A one- or two-item sequence representing the + targeted Python version. Defaults to + ``sys.version_info[:2]``. + :param Iterable abis: Iterable of compatible ABIs. Defaults to the ABIs + compatible with the current system. + :param Iterable platforms: Iterable of compatible platforms. Defaults to the + platforms compatible with the current system. + :param bool warn: Whether warnings should be logged. Defaults to ``False``. + + .. versionadded:: 20.0 """ if not python_version: python_version = sys.version_info[:2] @@ -219,8 +439,10 @@ def cpython_tags( if abis is None: abis = _cpython_abis(python_version, warn) if len(python_version) > 1 else [] abis = list(abis) - # 'abi3' and 'none' are explicitly handled later. - for explicit_abi in ("abi3", "none"): + threading = _is_threaded_cpython(abis) + # Stable ABIs and 'none' are explicitly handled later. + explicit_abis = ("abi3", "abi3t", "none") if threading else ("abi3", "none") + for explicit_abi in explicit_abis: try: abis.remove(explicit_abi) except ValueError: # noqa: PERF203 @@ -231,18 +453,27 @@ def cpython_tags( for platform_ in platforms: yield Tag(interpreter, abi, platform_) - threading = _is_threaded_cpython(abis) use_abi3 = _abi3_applies(python_version, threading) + use_abi3t = _abi3t_applies(python_version, threading) if use_abi3: yield from (Tag(interpreter, "abi3", platform_) for platform_ in platforms) + if use_abi3t: + yield from (Tag(interpreter, "abi3t", platform_) for platform_ in platforms) + yield from (Tag(interpreter, "none", platform_) for platform_ in platforms) - if use_abi3: + if use_abi3 or use_abi3t: for minor_version in range(python_version[1] - 1, 1, -1): for platform_ in platforms: version = _version_nodot((python_version[0], minor_version)) interpreter = f"cp{version}" - yield Tag(interpreter, "abi3", platform_) + if use_abi3: + yield Tag(interpreter, "abi3", platform_) + if use_abi3t: + # Support for abi3t was introduced in Python 3.15, but in + # principle abi3t wheels are possible for older limited API + # versions, so allow things like ("cp37", "abi3t", "platform") + yield Tag(interpreter, "abi3t", platform_) def _generic_abi() -> list[str]: @@ -261,7 +492,7 @@ def _generic_abi() -> list[str]: # => graalpy_38_native ext_suffix = _get_config_var("EXT_SUFFIX", warn=True) - if not isinstance(ext_suffix, str) or ext_suffix[0] != ".": + if not isinstance(ext_suffix, str) or not ext_suffix.startswith("."): raise SystemError("invalid sysconfig.get_config_var('EXT_SUFFIX')") parts = ext_suffix.split(".") if len(parts) < 3: @@ -270,7 +501,10 @@ def _generic_abi() -> list[str]: soabi = parts[1] if soabi.startswith("cpython"): # non-windows - abi = "cp" + soabi.split("-")[1] + cpython_parts = soabi.split("-") + if len(cpython_parts) < 2 or not cpython_parts[1]: + raise SystemError("invalid sysconfig.get_config_var('EXT_SUFFIX')") + abi = "cp" + cpython_parts[1] elif soabi.startswith("cp"): # windows abi = soabi.split("-")[0] @@ -294,12 +528,27 @@ def generic_tags( warn: bool = False, ) -> Iterator[Tag]: """ - Yields the tags for a generic interpreter. + Yields the tags for an interpreter which requires no specialization. - The tags consist of: - - -- + This function should be used if one of the other interpreter-specific + functions provided by this module is not appropriate (i.e. not calculating + tags for a CPython interpreter). - The "none" ABI will be added if it was not explicitly provided. + The specific tags generated are: + + - ``--`` + + The ``"none"`` ABI will be added if it was not explicitly provided. + + :param str interpreter: The name of the interpreter. Defaults to being + calculated. + :param Iterable abis: Iterable of compatible ABIs. Defaults to the ABIs + compatible with the current system. + :param Iterable platforms: Iterable of compatible platforms. Defaults to the + platforms compatible with the current system. + :param bool warn: Whether warnings should be logged. Defaults to ``False``. + + .. versionadded:: 20.0 """ if not interpreter: interp_name = interpreter_name() @@ -329,18 +578,54 @@ def _py_interpreter_range(py_version: PythonVersion) -> Iterator[str]: yield f"py{_version_nodot((py_version[0], minor))}" +def pure_python_tags( + python_version: PythonVersion | None = None, +) -> Iterator[Tag]: + """ + Yields the pure-Python tags compatible with ``python_version``. + + The tags use the ``"none"`` ABI and ``"any"`` platform, so their + generation does not depend on the running platform. + + .. versionadded:: 26.3 + + :param Sequence python_version: A one- or two-item sequence representing the + compatible version of Python. Defaults to + ``sys.version_info[:2]``. + :raises ValueError: If ``python_version`` is an empty sequence. + """ + if python_version is None: + python_version = sys.version_info[:2] + elif not python_version: + raise ValueError("python_version must contain at least one item") + for version in _py_interpreter_range(python_version): + yield Tag(version, "none", "any") + + def compatible_tags( python_version: PythonVersion | None = None, interpreter: str | None = None, platforms: Iterable[str] | None = None, ) -> Iterator[Tag]: """ - Yields the sequence of tags that are compatible with a specific version of Python. + Yields the tags for an interpreter compatible with the Python version + specified by ``python_version``. - The tags consist of: - - py*-none- - - -none-any # ... if `interpreter` is provided. - - py*-none-any + The specific tags generated are: + + - ``py*-none-`` + - ``-none-any`` if ``interpreter`` is provided + - ``py*-none-any`` + + :param Sequence python_version: A one- or two-item sequence representing the + compatible version of Python. Defaults to + ``sys.version_info[:2]``. + :param str interpreter: The name of the interpreter (if known), e.g. + ``"cp38"``. Defaults to the current interpreter. + :param Iterable platforms: Iterable of compatible platforms. Defaults to the + platforms compatible with the current system. + + .. versionadded:: 20.0 """ if not python_version: python_version = sys.version_info[:2] @@ -350,8 +635,7 @@ def compatible_tags( yield Tag(version, "none", platform_) if interpreter: yield Tag(interpreter, "none", "any") - for version in _py_interpreter_range(python_version): - yield Tag(version, "none", "any") + yield from pure_python_tags(python_version) def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str: @@ -369,12 +653,12 @@ def _mac_binary_formats(version: AppleVersion, cpu_arch: str) -> list[str]: if cpu_arch == "x86_64": if version < (10, 4): return [] - formats.extend(["intel", "fat64", "fat32"]) + formats.extend(["intel", "fat64", "fat3"]) elif cpu_arch == "i386": if version < (10, 4): return [] - formats.extend(["intel", "fat32", "fat"]) + formats.extend(["intel", "fat3", "fat"]) elif cpu_arch == "ppc64": # TODO: Need to care about 32-bit PPC for ppc64 through 10.2? @@ -385,7 +669,7 @@ def _mac_binary_formats(version: AppleVersion, cpu_arch: str) -> list[str]: elif cpu_arch == "ppc": if version > (10, 6): return [] - formats.extend(["fat32", "fat"]) + formats.extend(["fat3", "fat"]) if cpu_arch in {"arm64", "x86_64"}: formats.append("universal2") @@ -400,35 +684,52 @@ def mac_platforms( version: AppleVersion | None = None, arch: str | None = None ) -> Iterator[str]: """ - Yields the platform tags for a macOS system. + Yields the :attr:`~Tag.platform` tags for macOS. The `version` parameter is a two-item tuple specifying the macOS version to generate platform tags for. The `arch` parameter is the CPU architecture to generate platform tags for. Both parameters default to the appropriate value for the current system. - """ - version_str, _, cpu_arch = platform.mac_ver() - if version is None: - version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) - if version == (10, 16): - # When built against an older macOS SDK, Python will report macOS 10.16 - # instead of the real version. - version_str = subprocess.run( - [ - sys.executable, - "-sS", - "-c", - "import platform; print(platform.mac_ver()[0])", - ], - check=True, - env={"SYSTEM_VERSION_COMPAT": "0"}, - stdout=subprocess.PIPE, - text=True, - ).stdout - version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) - if arch is None: - arch = _mac_arch(cpu_arch) + :param tuple version: A two-item tuple representing the version of macOS. + Defaults to the current system's version. + :param str arch: The CPU architecture. Defaults to the architecture of the + current system, e.g. ``"x86_64"``. + + .. note:: + Equivalent support for the other major platforms is purposefully not + provided: + + - On Windows, platform compatibility is statically specified + - On Linux, code must be run on the system itself to determine + compatibility + + .. versionadded:: 20.0 + """ + if version is None or arch is None: + version_str, _, cpu_arch = platform.mac_ver() + if version is None: + version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2]))) + if version == (10, 16): + # When built against an older macOS SDK, Python will report macOS 10.16 + # instead of the real version. + version_str = subprocess.run( + [ + sys.executable, + "-sS", + "-c", + "import platform; print(platform.mac_ver()[0])", + ], + check=True, + env={"SYSTEM_VERSION_COMPAT": "0"}, + stdout=subprocess.PIPE, + text=True, + ).stdout + version = cast( + "AppleVersion", tuple(map(int, version_str.split(".")[:2])) + ) + if arch is None: + arch = _mac_arch(cpu_arch) if (10, 0) <= version < (11, 0): # Prior to Mac OS 11, each yearly release of Mac OS bumped the @@ -450,7 +751,6 @@ def mac_platforms( for binary_format in binary_formats: yield f"macosx_{major_version}_{minor_version}_{binary_format}" - if version >= (11, 0): # Mac OS 11 on x86_64 is compatible with binaries from previous releases. # Arm64 support was introduced in 11.0, so no Arm binaries from previous # releases exist. @@ -476,14 +776,21 @@ def ios_platforms( version: AppleVersion | None = None, multiarch: str | None = None ) -> Iterator[str]: """ - Yields the platform tags for an iOS system. - :param version: A two-item tuple specifying the iOS version to generate - platform tags for. Defaults to the current iOS version. - :param multiarch: The CPU architecture+ABI to generate platform tags for - - (the value used by `sys.implementation._multiarch` e.g., - `arm64_iphoneos` or `x84_64_iphonesimulator`). Defaults to the current - multiarch value. + Yields the :attr:`~Tag.platform` tags for iOS. + + :param tuple version: A two-item tuple representing the version of iOS. + Defaults to the current system's version. + :param str multiarch: The CPU architecture+ABI to be used. This should be in + the format by ``sys.implementation._multiarch`` (e.g., + ``arm64_iphoneos`` or ``x86_64_iphonesimulator``). + Defaults to the current system's multiarch value. + + .. note:: + Behavior of this method is undefined if invoked on non-iOS platforms + without providing explicit version and multiarch arguments. + + .. versionadded:: 24.2 """ if version is None: # if iOS is the current platform, ios_ver *must* be defined. However, @@ -543,6 +850,8 @@ def android_platforms( e.g. ``arm64_v8a``. Defaults to the current system's ABI , as returned by ``sysconfig.get_platform``. Hyphens and periods will be replaced with underscores. + + .. versionadded:: 25.0 """ if platform.system() != "Android" and (api_level is None or abi is None): raise TypeError( @@ -579,10 +888,19 @@ def _linux_platforms(is_32bit: bool = _32_BIT_INTERPRETER) -> Iterator[str]: linux = "linux_armv8l" _, arch = linux.split("_", 1) archs = {"armv8l": ["armv8l", "armv7l"]}.get(arch, [arch]) - yield from _manylinux.platform_tags(archs) - yield from _musllinux.platform_tags(archs) for arch in archs: yield f"linux_{arch}" + yield from _manylinux.platform_tags(archs) + yield from _musllinux.platform_tags(archs) + + +def _emscripten_platforms() -> Iterator[str]: + pyemscripten_platform_version = sysconfig.get_config_var( + "PYEMSCRIPTEN_PLATFORM_VERSION" + ) + if pyemscripten_platform_version: + yield f"pyemscripten_{pyemscripten_platform_version}_wasm32" + yield from _generic_platforms() def _generic_platforms() -> Iterator[str]: @@ -591,7 +909,9 @@ def _generic_platforms() -> Iterator[str]: def platform_tags() -> Iterator[str]: """ - Provides the platform tags for this installation. + Yields the :attr:`~Tag.platform` tags for the running interpreter. + + .. versionadded:: 21.1 """ if platform.system() == "Darwin": return mac_platforms() @@ -601,6 +921,8 @@ def platform_tags() -> Iterator[str]: return android_platforms() elif platform.system() == "Linux": return _linux_platforms() + elif platform.system() == "Emscripten": + return _emscripten_platforms() else: return _generic_platforms() @@ -611,6 +933,10 @@ def interpreter_name() -> str: Some implementations have a reserved, two-letter abbreviation which will be returned when appropriate. + + This typically acts as the prefix to the :attr:`~Tag.interpreter` tag. + + .. versionadded:: 20.0 """ name = sys.implementation.name return INTERPRETER_SHORT_NAMES.get(name) or name @@ -618,7 +944,13 @@ def interpreter_name() -> str: def interpreter_version(*, warn: bool = False) -> str: """ - Returns the version of the running interpreter. + Returns the running interpreter's version. + + This typically acts as the suffix to the :attr:`~Tag.interpreter` tag. + + :param bool warn: Whether warnings should be logged. Defaults to ``False``. + + .. versionadded:: 20.0 """ version = _get_config_var("py_version_nodot", warn=warn) return str(version) if version else _version_nodot(sys.version_info[:2]) @@ -630,17 +962,41 @@ def _version_nodot(version: PythonVersion) -> str: def sys_tags(*, warn: bool = False) -> Iterator[Tag]: """ - Returns the sequence of tag triples for the running interpreter. + Yields the sequence of tag triples that the running interpreter supports. - The order of the sequence corresponds to priority order for the - interpreter, from most to least important. + The iterable is ordered so that the best-matching tag is first in the + sequence. The exact preferential order to tags is interpreter-specific, but + in general the tag importance is in the order of: + + 1. Interpreter + 2. Platform + 3. ABI + + This order is due to the fact that an ABI is inherently tied to the + platform, but platform-specific code is not necessarily tied to the ABI. The + interpreter is the most important tag as it dictates basic support for any + wheel. + + The function returns an iterable in order to allow for the possible + short-circuiting of tag generation if the entire sequence is not necessary + and tag calculation happens to be expensive. + + :param bool warn: Whether warnings should be logged. Defaults to ``False``. + + .. versionchanged:: 21.3 + Added the `pp3-none-any` tag (:issue:`311`). + .. versionchanged:: 26.1 + Added the `abi3t` tag (:issue:`1099`). + .. versionchanged:: 26.3 + Native ``linux_*`` platform tags are now ordered before ``manylinux`` + and ``musllinux`` tags (:issue:`160`). """ interp_name = interpreter_name() if interp_name == "cp": yield from cpython_tags(warn=warn) else: - yield from generic_tags() + yield from generic_tags(warn=warn) if interp_name == "pp": interp = "pp3" @@ -649,3 +1005,49 @@ def sys_tags(*, warn: bool = False) -> Iterator[Tag]: else: interp = None yield from compatible_tags(interpreter=interp) + + +def create_compatible_tags_selector( + tags: Iterable[Tag], +) -> Callable[[Iterable[tuple[_T, AbstractSet[Tag]]]], Iterator[_T]]: + """Create a callable to select things compatible with supported tags. + + This function accepts an ordered sequence of tags, with the preferred + tags first. + + The returned callable accepts an iterable of tuples (thing, set[Tag]), + and returns an iterator of things, with the things with the best + matching tags first. + + Example to select compatible wheel filenames: + + >>> from packaging import tags + >>> from packaging.utils import parse_wheel_filename + >>> selector = tags.create_compatible_tags_selector(tags.sys_tags()) + >>> filenames = ["foo-1.0-py3-none-any.whl", "foo-1.0-py2-none-any.whl"] + >>> list(selector([ + ... (filename, parse_wheel_filename(filename)[-1]) for filename in filenames + ... ])) + ['foo-1.0-py3-none-any.whl'] + + .. versionadded:: 26.1 + """ + tag_ranks: dict[Tag, int] = {} + for rank, tag in enumerate(tags): + tag_ranks.setdefault(tag, rank) # ignore duplicate tags, keep first + supported_tags = tag_ranks.keys() + + def selector( + tagged_things: Iterable[tuple[_T, AbstractSet[Tag]]], + ) -> Iterator[_T]: + ranked_things: list[tuple[_T, int]] = [] + for thing, thing_tags in tagged_things: + supported_thing_tags = thing_tags & supported_tags + if supported_thing_tags: + thing_rank = min(tag_ranks[t] for t in supported_thing_tags) + ranked_things.append((thing, thing_rank)) + return iter( + thing for thing, _ in sorted(ranked_things, key=operator.itemgetter(1)) + ) + + return selector diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/utils.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/utils.py index c41c813..2f0ce20 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/utils.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/utils.py @@ -5,41 +5,113 @@ from __future__ import annotations import re -from typing import NewType, Tuple, Union, cast +from typing import NewType, Union, cast -from .tags import Tag, parse_tag +from .tags import InvalidTag, Tag, UnsortedTagsError, parse_tag from .version import InvalidVersion, Version, _TrimmedRelease -BuildTag = Union[Tuple[()], Tuple[int, str]] +__all__ = [ + "BuildTag", + "InvalidName", + "InvalidSdistFilename", + "InvalidWheelFilename", + "NormalizedName", + "canonicalize_name", + "canonicalize_version", + "is_normalized_name", + "parse_sdist_filename", + "parse_wheel_filename", +] + + +def __dir__() -> list[str]: + return __all__ + + +BuildTag = Union[tuple[()], tuple[int, str]] +""" +A wheel build tag: an empty tuple, or a ``(build number, build tag suffix)`` pair. + +.. versionadded:: 20.9 +""" + NormalizedName = NewType("NormalizedName", str) +""" +A :class:`typing.NewType` of :class:`str`, representing a normalized name. + +.. versionadded:: 20.4 +""" class InvalidName(ValueError): """ An invalid distribution name; users should refer to the packaging user guide. + + .. versionadded:: 23.2 """ class InvalidWheelFilename(ValueError): """ An invalid wheel filename was found, users should refer to PEP 427. + + .. versionadded:: 20.9 """ class InvalidSdistFilename(ValueError): """ An invalid sdist filename was found, users should refer to the packaging user guide. + + .. versionadded:: 20.9 """ # Core metadata spec for `Name` -_validate_regex = re.compile(r"[A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9]", re.IGNORECASE) -_normalized_regex = re.compile(r"[a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9]") +_validate_regex = re.compile( + r"[a-z0-9]|[a-z0-9][a-z0-9._-]*[a-z0-9]", re.IGNORECASE | re.ASCII +) +_normalized_regex = re.compile(r"[a-z0-9]+(?:-[a-z0-9]+)*", re.ASCII) # PEP 427: The build number must start with a digit. -_build_tag_regex = re.compile(r"(\d+)(.*)") +_build_tag_regex = re.compile(r"(\d+)(.*)", re.ASCII) +# PEP 427: Valid characters for an escaped project name in a wheel filename. +# Requires at least one character so an empty project name is rejected. +_wheel_name_regex = re.compile(r"^[\w._]+\Z", re.UNICODE) def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName: + """ + This function takes a valid Python package or extra name, and returns the + normalized form of it. + + The return type is typed as :class:`NormalizedName`. This allows type + checkers to help require that a string has passed through this function + before use. + + If **validate** is true, then the function will check if **name** is a valid + distribution name before normalizing. + + :param str name: The name to normalize. + :param bool validate: Check whether the name is a valid distribution name. + :raises InvalidName: If **validate** is true and the name is not an + acceptable distribution name. + + >>> from packaging.utils import canonicalize_name + >>> canonicalize_name("Django") + 'django' + >>> canonicalize_name("oslo.concurrency") + 'oslo-concurrency' + >>> canonicalize_name("requests") + 'requests' + + .. versionadded:: 16.2 + + .. versionchanged:: 20.4 + The return type was changed to :class:`NormalizedName`. + + .. versionchanged:: 23.2 + Added the *validate* keyword parameter. + """ if validate and not _validate_regex.fullmatch(name): raise InvalidName(f"name is invalid: {name!r}") # Ensure all ``.`` and ``_`` are ``-`` @@ -53,15 +125,43 @@ def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName: def is_normalized_name(name: str) -> bool: + """ + Check if a name is a normalized project name (i.e. a valid name that + :func:`canonicalize_name` would roundtrip to the same value). + + The roundtrip only characterizes normalized names for *valid* names. A name + must start and end with an ASCII letter or digit, which + :func:`canonicalize_name` does not enforce: it leaves a leading or trailing + hyphen in place, so such a name roundtrips without being normalized. + + :param str name: The name to check. + + >>> from packaging.utils import canonicalize_name, is_normalized_name + >>> is_normalized_name("requests") + True + >>> is_normalized_name("Django") + False + >>> canonicalize_name("_not_legal") + '-not-legal' + >>> is_normalized_name("-not-legal") # roundtrips, but not a valid name + False + + .. versionadded:: 23.2 + """ return _normalized_regex.fullmatch(name) is not None def canonicalize_version( version: Version | str, *, strip_trailing_zero: bool = True ) -> str: - """ - Return a canonical form of a version as a string. + """Return a canonical form of a version as a string. + This function takes a string representing a package version (or a + :class:`~packaging.version.Version` instance), and returns the + normalized form of it. By default, it strips trailing zeros from + the release segment. + + >>> from packaging.utils import canonicalize_version >>> canonicalize_version('1.0.1') '1.0.1' @@ -77,6 +177,17 @@ def canonicalize_version( >>> canonicalize_version('foo bar baz') 'foo bar baz' + + >>> canonicalize_version('1.4.0.0.0') + '1.4' + + .. versionadded:: 17.1 + + .. versionchanged:: 21.0 + The return type was narrowed to :class:`str`. + + .. versionchanged:: 22.0 + Added the *strip_trailing_zero* keyword parameter. """ if isinstance(version, str): try: @@ -88,7 +199,59 @@ def canonicalize_version( def parse_wheel_filename( filename: str, + *, + validate_order: bool = False, ) -> tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]: + """ + This function takes the filename of a wheel file, and parses it, + returning a tuple of name, version, build number, and tags. + + The name part of the tuple is normalized and typed as + :class:`NormalizedName`. The version portion is an instance of + :class:`~packaging.version.Version`. The build number is ``()`` if + there is no build number in the wheel filename, otherwise a + two-item tuple of an integer for the leading digits and + a string for the rest of the build number. The tags portion is a + frozen set of :class:`~packaging.tags.Tag` instances (as the tag + string format allows multiple tags to be combined into a single + string). + + If **validate_order** is true, compressed tag set components are + checked to be in sorted order as required by PEP 425. + + :param str filename: The name of the wheel file. + :param bool validate_order: Check whether compressed tag set components + are in sorted order. + :raises InvalidWheelFilename: If the filename in question + does not follow the :ref:`wheel specification + `. + + >>> from packaging.utils import parse_wheel_filename + >>> from packaging.tags import Tag + >>> from packaging.version import Version + >>> name, ver, build, tags = parse_wheel_filename("foo-1.0-py3-none-any.whl") + >>> name + 'foo' + >>> ver == Version('1.0') + True + >>> tags == {Tag("py3", "none", "any")} + True + >>> not build + True + + .. versionadded:: 20.9 + + .. versionchanged:: 23.2 + Raises :class:`InvalidWheelFilename` when the version component is invalid. + + .. versionadded:: 26.1 + The *validate_order* parameter. + + .. versionchanged:: 26.3 + Raises :class:`InvalidWheelFilename` when an interpreter component is + not an identifier, a tag set component is empty, or the project name is + empty. + """ if not filename.endswith(".whl"): raise InvalidWheelFilename( f"Invalid wheel filename (extension must be '.whl'): {filename!r}" @@ -104,7 +267,7 @@ def parse_wheel_filename( parts = filename.split("-", dashes - 2) name_part = parts[0] # See PEP 427 for the rules on escaping the project name. - if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None: + if "__" in name_part or _wheel_name_regex.match(name_part) is None: raise InvalidWheelFilename(f"Invalid project name: {filename!r}") name = canonicalize_name(name_part) @@ -125,11 +288,56 @@ def parse_wheel_filename( build = cast("BuildTag", (int(build_match.group(1)), build_match.group(2))) else: build = () - tags = parse_tag(parts[-1]) + tag_str = parts[-1] + try: + tags = parse_tag(tag_str, validate_order=validate_order) + except UnsortedTagsError: + raise InvalidWheelFilename( + f"Invalid wheel filename (compressed tag set components must be in " + f"sorted order per PEP 425): {filename!r}" + ) from None + except InvalidTag: + raise InvalidWheelFilename( + f"Invalid wheel filename (invalid tag component): {filename!r}" + ) from None return (name, version, build, tags) def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]: + """ + This function takes the filename of a sdist file (as specified + in the `Source distribution format`_ documentation), and parses + it, returning a tuple of the normalized name and version as + represented by an instance of :class:`~packaging.version.Version`. + + :param str filename: The name of the sdist file. + :raises InvalidSdistFilename: If the filename does not end + with an sdist extension (``.zip`` or ``.tar.gz``), if it does not + contain a dash separating the name and the version of the distribution, + if the project name is empty, or if the version portion is not a valid + version. + + >>> from packaging.utils import parse_sdist_filename + >>> from packaging.version import Version + >>> name, ver = parse_sdist_filename("foo-1.0.tar.gz") + >>> name + 'foo' + >>> ver == Version('1.0') + True + + .. versionadded:: 20.9 + + .. versionchanged:: 21.0 + Added support for ``.zip`` source distributions. + + .. versionchanged:: 23.2 + Raises :class:`InvalidSdistFilename` when the version component is invalid. + + .. versionchanged:: 26.3 + Raises :class:`InvalidSdistFilename` on an empty project name. + + .. _Source distribution format: https://packaging.python.org/specifications/source-distribution-format/#source-distribution-file-name + """ if filename.endswith(".tar.gz"): file_stem = filename[: -len(".tar.gz")] elif filename.endswith(".zip"): @@ -145,6 +353,10 @@ def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]: name_part, sep, version_part = file_stem.rpartition("-") if not sep: raise InvalidSdistFilename(f"Invalid sdist filename: {filename!r}") + if not name_part: + raise InvalidSdistFilename( + f"Invalid sdist filename (empty project name): {filename!r}" + ) name = canonicalize_name(name_part) diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/version.py b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/version.py index d250a26..a0d57d9 100644 --- a/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/version.py +++ b/.venv/lib/python3.14/site-packages/pip/_vendor/packaging/version.py @@ -4,7 +4,7 @@ """ .. testsetup:: - from pip._vendor.packaging.version import parse, Version + from pip._vendor.packaging.version import parse, normalize_pre, Version, _cmpkey """ from __future__ import annotations @@ -18,13 +18,10 @@ from typing import ( Literal, NamedTuple, SupportsInt, - Tuple, TypedDict, Union, ) -from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType - if typing.TYPE_CHECKING: from typing_extensions import Self, Unpack @@ -37,7 +34,7 @@ else: # pragma: no cover import warnings def _deprecated(message: str) -> object: - def decorator(func: object) -> object: + def decorator(func: Callable[[...], object]) -> object: @functools.wraps(func) def wrapper(*args: object, **kwargs: object) -> object: warnings.warn( @@ -62,22 +59,20 @@ _LETTER_NORMALIZATION = { "r": "post", } -__all__ = ["VERSION_PATTERN", "InvalidVersion", "Version", "parse"] +__all__ = ["VERSION_PATTERN", "InvalidVersion", "Version", "normalize_pre", "parse"] -LocalType = Tuple[Union[int, str], ...] -CmpPrePostDevType = Union[InfinityType, NegativeInfinityType, Tuple[str, int]] -CmpLocalType = Union[ - NegativeInfinityType, - Tuple[Union[Tuple[int, str], Tuple[NegativeInfinityType, Union[int, str]]], ...], -] -CmpKey = Tuple[ - int, - Tuple[int, ...], - CmpPrePostDevType, - CmpPrePostDevType, - CmpPrePostDevType, - CmpLocalType, +def __dir__() -> list[str]: + return __all__ + + +LocalType = tuple[Union[int, str], ...] + +CmpLocalType = tuple[tuple[int, str], ...] +CmpSuffix = tuple[int, int, int, int, int, int] +CmpKey = Union[ + tuple[int, tuple[int, ...], CmpSuffix], + tuple[int, tuple[int, ...], CmpSuffix, CmpLocalType], ] VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool] @@ -85,15 +80,38 @@ VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool] class _VersionReplace(TypedDict, total=False): epoch: int | None release: tuple[int, ...] | None - pre: tuple[Literal["a", "b", "rc"], int] | None + pre: tuple[str, int] | None post: int | None dev: int | None local: str | None +def normalize_pre(letter: str, /) -> str: + """Normalize the pre-release segment of a version string. + + Returns a lowercase version of the string if not a known pre-release + identifier. + + >>> normalize_pre('alpha') + 'a' + >>> normalize_pre('BETA') + 'b' + >>> normalize_pre('rc') + 'rc' + + :param letter: + + .. versionadded:: 26.1 + """ + letter = letter.lower() + return _LETTER_NORMALIZATION.get(letter, letter) + + def parse(version: str) -> Version: """Parse the given version string. + This is identical to the :class:`Version` constructor. + >>> parse('1.0.dev1') @@ -173,7 +191,7 @@ class _BaseVersion: # Note that ++ doesn't behave identically on CPython and PyPy, so not using it here _VERSION_PATTERN = r""" v?+ # optional leading v - (?: + (?a: (?:(?P[0-9]+)!)?+ # epoch (?P[0-9]+(?:\.[0-9]+)*+) # release segment (?P
                                          # pre-release
@@ -199,7 +217,7 @@ _VERSION_PATTERN = r"""
             (?P[0-9]+)?
         )?+
     )
-    (?:\+
+    (?a:\+
         (?P                                        # local version
             [a-z0-9]+
             (?:[._-][a-z0-9]+)*+
@@ -227,12 +245,21 @@ expressions (for example, matching a version number as part of a file name). The
 regular expression should be compiled with the ``re.VERBOSE`` and ``re.IGNORECASE``
 flags set.
 
+.. versionchanged:: 26.0
+
+   The regex now uses possessive qualifiers on Python 3.11 if they are
+   supported (CPython 3.11.5+, PyPy 3.11.13+).
+
 :meta hide-value:
 """
 
 
 # Validation pattern for local version in replace()
-_LOCAL_PATTERN = re.compile(r"[a-z0-9]+(?:[._-][a-z0-9]+)*", re.IGNORECASE)
+_LOCAL_PATTERN = re.compile(r"[a-z0-9]+(?:[._-][a-z0-9]+)*", re.IGNORECASE | re.ASCII)
+
+# Fast path: If a version has only digits and dots then we
+# can skip the regex and parse it as a release segment
+_SIMPLE_VERSION_INDICATORS = frozenset(".0123456789")
 
 
 def _validate_epoch(value: object, /) -> int:
@@ -258,14 +285,17 @@ def _validate_release(value: object, /) -> tuple[int, ...]:
 def _validate_pre(value: object, /) -> tuple[Literal["a", "b", "rc"], int] | None:
     if value is None:
         return value
-    if (
-        isinstance(value, tuple)
-        and len(value) == 2
-        and value[0] in ("a", "b", "rc")
-        and isinstance(value[1], int)
-        and value[1] >= 0
-    ):
-        return value
+    if isinstance(value, tuple) and len(value) == 2:
+        letter, number = value
+        # The letter must be a string before it can be normalized.
+        if (
+            isinstance(letter, str)
+            and (normalized := normalize_pre(letter)) in {"a", "b", "rc"}
+            and isinstance(number, int)
+            and number >= 0
+        ):
+            # type checkers can't infer the Literal type here on letter
+            return (normalized, number)  # type: ignore[return-value]
     msg = f"pre must be a tuple of ('a'|'b'|'rc', non-negative int), got {value}"
     raise InvalidVersion(msg)
 
@@ -301,9 +331,9 @@ def _validate_local(value: object, /) -> LocalType | None:
 class _Version(NamedTuple):
     epoch: int
     release: tuple[int, ...]
-    dev: tuple[str, int] | None
-    pre: tuple[str, int] | None
-    post: tuple[str, int] | None
+    dev: tuple[Literal["dev"], int] | None
+    pre: tuple[Literal["a", "b", "rc"], int] | None
+    post: tuple[Literal["post"], int] | None
     local: LocalType | None
 
 
@@ -329,20 +359,50 @@ class Version(_BaseVersion):
     False
     >>> v1 <= v2
     True
+
+    :class:`Version` is immutable; use :meth:`__replace__` to change
+    part of a version.
+
+    Instances are safe to serialize with :mod:`pickle`. They use a stable
+    format so the same pickle can be loaded in future packaging releases.
+
+    .. versionchanged:: 26.2
+
+        Added a stable pickle format. Pickles created with packaging 26.2+ can
+        be unpickled with future releases.  Backward compatibility with pickles
+        from pip._vendor.packaging < 26.2 is supported but may be removed in a future
+        release.
     """
 
-    __slots__ = ("_dev", "_epoch", "_key_cache", "_local", "_post", "_pre", "_release")
+    __slots__ = (
+        "_dev",
+        "_epoch",
+        "_hash_cache",
+        "_key_cache",
+        "_local",
+        "_post",
+        "_pre",
+        "_release",
+    )
     __match_args__ = ("_str",)
+    """
+    Pattern matching is supported on Python 3.10+.
+
+    .. versionadded:: 26.0
+
+    :meta hide-value:
+    """
 
     _regex = re.compile(r"\s*" + VERSION_PATTERN + r"\s*", re.VERBOSE | re.IGNORECASE)
 
     _epoch: int
     _release: tuple[int, ...]
-    _dev: tuple[str, int] | None
-    _pre: tuple[str, int] | None
-    _post: tuple[str, int] | None
+    _dev: tuple[Literal["dev"], int] | None
+    _pre: tuple[Literal["a", "b", "rc"], int] | None
+    _post: tuple[Literal["post"], int] | None
     _local: LocalType | None
 
+    _hash_cache: int | None
     _key_cache: CmpKey | None
 
     def __init__(self, version: str) -> None:
@@ -355,23 +415,128 @@ class Version(_BaseVersion):
             If the ``version`` does not conform to PEP 440 in any way then this
             exception will be raised.
         """
+        try:
+            is_simple = _SIMPLE_VERSION_INDICATORS.issuperset(version)
+        except TypeError:
+            raise InvalidVersion(f"Invalid version: {version!r}") from None
+
+        if is_simple:
+            try:
+                self._release = tuple(map(int, version.split(".")))
+            except AttributeError:
+                raise InvalidVersion(f"Invalid version: {version!r}") from None
+            except ValueError:
+                # Empty parts (from "1..2", ".1", etc.) are invalid versions.
+                # Any other ValueError (e.g. int str-digits limit) should
+                # propagate to the caller.
+                if "" in version.split("."):
+                    raise InvalidVersion(f"Invalid version: {version!r}") from None
+                # TODO: remove "no cover" when Python 3.9 is dropped.
+                raise  # pragma: no cover
+
+            self._epoch = 0
+            self._pre = None
+            self._post = None
+            self._dev = None
+            self._local = None
+            self._key_cache = None
+            self._hash_cache = None
+            return
+
         # Validate the version and parse it into pieces
-        match = self._regex.fullmatch(version)
+        try:
+            match = self._regex.fullmatch(version)
+        except TypeError:
+            raise InvalidVersion(f"Invalid version: {version!r}") from None
         if not match:
             raise InvalidVersion(f"Invalid version: {version!r}")
         self._epoch = int(match.group("epoch")) if match.group("epoch") else 0
         self._release = tuple(map(int, match.group("release").split(".")))
-        self._pre = _parse_letter_version(match.group("pre_l"), match.group("pre_n"))
-        self._post = _parse_letter_version(
+        # We can type ignore the assignments below because the regex guarantees
+        # the correct strings
+        self._pre = _parse_letter_version(match.group("pre_l"), match.group("pre_n"))  # type: ignore[assignment]
+        self._post = _parse_letter_version(  # type: ignore[assignment]
             match.group("post_l"), match.group("post_n1") or match.group("post_n2")
         )
-        self._dev = _parse_letter_version(match.group("dev_l"), match.group("dev_n"))
+        self._dev = _parse_letter_version(match.group("dev_l"), match.group("dev_n"))  # type: ignore[assignment]
         self._local = _parse_local_version(match.group("local"))
 
         # Key which will be used for sorting
         self._key_cache = None
+        self._hash_cache = None
+
+    @classmethod
+    def from_parts(
+        cls,
+        *,
+        epoch: int = 0,
+        release: tuple[int, ...],
+        pre: tuple[str, int] | None = None,
+        post: int | None = None,
+        dev: int | None = None,
+        local: str | None = None,
+    ) -> Self:
+        """
+        Return a new version composed of the various parts.
+
+        This allows you to build a version without going though a string and
+        running a regular expression. It normalizes pre-release strings. The
+        ``release=`` keyword argument is required.
+
+        >>> Version.from_parts(release=(1,2,3))
+        
+        >>> Version.from_parts(release=(0,1,0), pre=("b", 1))
+        
+
+        :param epoch:
+        :param release: This version tuple is required
+
+        .. versionadded:: 26.1
+        """
+        _epoch = _validate_epoch(epoch)
+        _release = _validate_release(release)
+        _pre = _validate_pre(pre) if pre is not None else None
+        _post = _validate_post(post) if post is not None else None
+        _dev = _validate_dev(dev) if dev is not None else None
+        _local = _validate_local(local) if local is not None else None
+
+        new_version = cls.__new__(cls)
+        new_version._key_cache = None
+        new_version._hash_cache = None
+        new_version._epoch = _epoch
+        new_version._release = _release
+        new_version._pre = _pre
+        new_version._post = _post
+        new_version._dev = _dev
+        new_version._local = _local
+
+        return new_version
 
     def __replace__(self, **kwargs: Unpack[_VersionReplace]) -> Self:
+        """
+        __replace__(*, epoch=..., release=..., pre=..., post=..., dev=..., local=...)
+
+        Return a new version with parts replaced.
+
+        This returns a new version (unless no parts were changed). The
+        pre-release is normalized. Setting a value to ``None`` clears it.
+
+        >>> v = Version("1.2.3")
+        >>> v.__replace__(pre=("a", 1))
+        
+
+        :param int | None epoch:
+        :param tuple[int, ...] | None release:
+        :param tuple[str, int] | None pre:
+        :param int | None post:
+        :param int | None dev:
+        :param str | None local:
+
+        .. versionadded:: 26.0
+        .. versionchanged:: 26.1
+
+           The pre-release portion is now normalized.
+        """
         epoch = _validate_epoch(kwargs["epoch"]) if "epoch" in kwargs else self._epoch
         release = (
             _validate_release(kwargs["release"])
@@ -395,6 +560,7 @@ class Version(_BaseVersion):
 
         new_version = self.__class__.__new__(self.__class__)
         new_version._key_cache = None
+        new_version._hash_cache = None
         new_version._epoch = epoch
         new_version._release = release
         new_version._pre = pre
@@ -417,6 +583,255 @@ class Version(_BaseVersion):
             )
         return self._key_cache
 
+    # __hash__ must be defined when __eq__ is overridden,
+    # otherwise Python sets __hash__ to None.
+    def __hash__(self) -> int:
+        if (cached_hash := self._hash_cache) is not None:
+            return cached_hash
+
+        if (key := self._key_cache) is None:
+            self._key_cache = key = _cmpkey(
+                self._epoch,
+                self._release,
+                self._pre,
+                self._post,
+                self._dev,
+                self._local,
+            )
+        self._hash_cache = cached_hash = hash(key)
+        return cached_hash
+
+    # Override comparison methods to use direct _key_cache access
+    # This is faster than property access, especially before Python 3.12
+    def __lt__(self, other: _BaseVersion) -> bool:
+        if isinstance(other, Version):
+            if self._key_cache is None:
+                self._key_cache = _cmpkey(
+                    self._epoch,
+                    self._release,
+                    self._pre,
+                    self._post,
+                    self._dev,
+                    self._local,
+                )
+            if other._key_cache is None:
+                other._key_cache = _cmpkey(
+                    other._epoch,
+                    other._release,
+                    other._pre,
+                    other._post,
+                    other._dev,
+                    other._local,
+                )
+            return self._key_cache < other._key_cache
+
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return super().__lt__(other)
+
+    def __le__(self, other: _BaseVersion) -> bool:
+        if isinstance(other, Version):
+            if self._key_cache is None:
+                self._key_cache = _cmpkey(
+                    self._epoch,
+                    self._release,
+                    self._pre,
+                    self._post,
+                    self._dev,
+                    self._local,
+                )
+            if other._key_cache is None:
+                other._key_cache = _cmpkey(
+                    other._epoch,
+                    other._release,
+                    other._pre,
+                    other._post,
+                    other._dev,
+                    other._local,
+                )
+            return self._key_cache <= other._key_cache
+
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return super().__le__(other)
+
+    def __eq__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            if self._key_cache is None:
+                self._key_cache = _cmpkey(
+                    self._epoch,
+                    self._release,
+                    self._pre,
+                    self._post,
+                    self._dev,
+                    self._local,
+                )
+            if other._key_cache is None:
+                other._key_cache = _cmpkey(
+                    other._epoch,
+                    other._release,
+                    other._pre,
+                    other._post,
+                    other._dev,
+                    other._local,
+                )
+            return self._key_cache == other._key_cache
+
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return super().__eq__(other)
+
+    def __ge__(self, other: _BaseVersion) -> bool:
+        if isinstance(other, Version):
+            if self._key_cache is None:
+                self._key_cache = _cmpkey(
+                    self._epoch,
+                    self._release,
+                    self._pre,
+                    self._post,
+                    self._dev,
+                    self._local,
+                )
+            if other._key_cache is None:
+                other._key_cache = _cmpkey(
+                    other._epoch,
+                    other._release,
+                    other._pre,
+                    other._post,
+                    other._dev,
+                    other._local,
+                )
+            return self._key_cache >= other._key_cache
+
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return super().__ge__(other)
+
+    def __gt__(self, other: _BaseVersion) -> bool:
+        if isinstance(other, Version):
+            if self._key_cache is None:
+                self._key_cache = _cmpkey(
+                    self._epoch,
+                    self._release,
+                    self._pre,
+                    self._post,
+                    self._dev,
+                    self._local,
+                )
+            if other._key_cache is None:
+                other._key_cache = _cmpkey(
+                    other._epoch,
+                    other._release,
+                    other._pre,
+                    other._post,
+                    other._dev,
+                    other._local,
+                )
+            return self._key_cache > other._key_cache
+
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return super().__gt__(other)
+
+    def __ne__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            if self._key_cache is None:
+                self._key_cache = _cmpkey(
+                    self._epoch,
+                    self._release,
+                    self._pre,
+                    self._post,
+                    self._dev,
+                    self._local,
+                )
+            if other._key_cache is None:
+                other._key_cache = _cmpkey(
+                    other._epoch,
+                    other._release,
+                    other._pre,
+                    other._post,
+                    other._dev,
+                    other._local,
+                )
+            return self._key_cache != other._key_cache
+
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return super().__ne__(other)
+
+    def __getstate__(
+        self,
+    ) -> tuple[
+        int,
+        tuple[int, ...],
+        tuple[str, int] | None,
+        tuple[str, int] | None,
+        tuple[str, int] | None,
+        LocalType | None,
+    ]:
+        # Return state as a 6-item tuple for compactness:
+        #   (epoch, release, pre, post, dev, local)
+        # Cache members are excluded and will be recomputed on demand
+        return (
+            self._epoch,
+            self._release,
+            self._pre,
+            self._post,
+            self._dev,
+            self._local,
+        )
+
+    def __setstate__(self, state: object) -> None:
+        # Always discard cached values — they may contain stale references
+        # (e.g. packaging._structures.InfinityType from pre-26.1 pickles)
+        # and will be recomputed on demand from the core fields above.
+        self._key_cache = None
+        self._hash_cache = None
+
+        if isinstance(state, tuple):
+            if len(state) == 6:
+                # New format (26.2+): (epoch, release, pre, post, dev, local)
+                (
+                    self._epoch,
+                    self._release,
+                    self._pre,
+                    self._post,
+                    self._dev,
+                    self._local,
+                ) = state
+                return
+            if len(state) == 2:
+                # Format (packaging 26.0-26.1): (None, {slot: value}).
+                _, slot_dict = state
+                if isinstance(slot_dict, dict):
+                    self._epoch = slot_dict["_epoch"]
+                    self._release = slot_dict["_release"]
+                    self._pre = slot_dict.get("_pre")
+                    self._post = slot_dict.get("_post")
+                    self._dev = slot_dict.get("_dev")
+                    self._local = slot_dict.get("_local")
+                    return
+        if isinstance(state, dict):
+            # Old format (packaging <= 25.x, no __slots__): state is a plain
+            # dict with "_version" (_Version NamedTuple) and "_key" entries.
+            version_nt = state.get("_version")
+            if version_nt is not None:
+                self._epoch = version_nt.epoch
+                self._release = version_nt.release
+                self._pre = version_nt.pre
+                self._post = version_nt.post
+                self._dev = version_nt.dev
+                self._local = version_nt.local
+                return
+
+        raise TypeError(f"Cannot restore Version from {state!r}")
+
     @property
     @_deprecated("Version._version is private and will be removed soon")
     def _version(self) -> _Version:
@@ -434,6 +849,7 @@ class Version(_BaseVersion):
         self._post = value.post
         self._local = value.local
         self._key_cache = None
+        self._hash_cache = None
 
     def __repr__(self) -> str:
         """A representation of the Version that shows all internal state.
@@ -441,7 +857,7 @@ class Version(_BaseVersion):
         >>> Version('1.0.0')
         
         """
-        return f""
+        return f"<{self.__class__.__name__}({str(self)!r})>"
 
     def __str__(self) -> str:
         """A string representation of the version that can be round-tripped.
@@ -507,7 +923,7 @@ class Version(_BaseVersion):
         return self._release
 
     @property
-    def pre(self) -> tuple[str, int] | None:
+    def pre(self) -> tuple[Literal["a", "b", "rc"], int] | None:
         """The pre-release segment of the version.
 
         >>> print(Version("1.2.3").pre)
@@ -561,6 +977,9 @@ class Version(_BaseVersion):
     def public(self) -> str:
         """The public portion of the version.
 
+        This returns a string. If you want a :class:`Version` again and care
+        about performance, use ``v.__replace__(local=None)`` instead.
+
         >>> Version("1.2.3").public
         '1.2.3'
         >>> Version("1.2.3+abc").public
@@ -574,6 +993,10 @@ class Version(_BaseVersion):
     def base_version(self) -> str:
         """The "base version" of the version.
 
+        This returns a string. If you want a :class:`Version` again and care
+        about performance, use
+        ``v.__replace__(pre=None, post=None, dev=None, local=None)`` instead.
+
         >>> Version("1.2.3").base_version
         '1.2.3'
         >>> Version("1.2.3+abc").base_version
@@ -632,6 +1055,8 @@ class Version(_BaseVersion):
 
         >>> Version("1.2.3").major
         1
+
+        .. versionadded:: 20.0
         """
         return self.release[0] if len(self.release) >= 1 else 0
 
@@ -643,6 +1068,8 @@ class Version(_BaseVersion):
         2
         >>> Version("1").minor
         0
+
+        .. versionadded:: 20.0
         """
         return self.release[1] if len(self.release) >= 2 else 0
 
@@ -654,6 +1081,8 @@ class Version(_BaseVersion):
         3
         >>> Version("1").micro
         0
+
+        .. versionadded:: 20.0
         """
         return self.release[2] if len(self.release) >= 3 else 0
 
@@ -670,6 +1099,7 @@ class _TrimmedRelease(Version):
             self._post = version._post
             self._local = version._local
             self._key_cache = version._key_cache
+            self._hash_cache = version._hash_cache
             return
         super().__init__(version)  # pragma: no cover
 
@@ -721,7 +1151,8 @@ _local_version_separators = re.compile(r"[\._-]")
 
 def _parse_local_version(local: str | None) -> LocalType | None:
     """
-    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    Takes a string like ``"abc.1.twelve"`` and turns it into
+    ``("abc", 1, "twelve")``.
     """
     if local is not None:
         return tuple(
@@ -731,6 +1162,19 @@ def _parse_local_version(local: str | None) -> LocalType | None:
     return None
 
 
+# Sort ranks for pre-release: dev-only < a < b < rc < stable (no pre-release).
+_PRE_RANK = {"a": 0, "b": 1, "rc": 2}
+_PRE_RANK_DEV_ONLY = -1  # sorts before a(0)
+_PRE_RANK_STABLE = 3  # sorts after rc(2)
+
+# In local version segments, strings sort before ints per PEP 440.
+_LOCAL_STR_RANK = -1  # sorts before all non-negative ints
+
+# Pre-computed suffix for stable releases (no pre, post, or dev segments).
+# See _cmpkey() for the suffix layout.
+_STABLE_SUFFIX = (_PRE_RANK_STABLE, 0, 0, 0, 1, 0)
+
+
 def _cmpkey(
     epoch: int,
     release: tuple[int, ...],
@@ -739,54 +1183,70 @@ def _cmpkey(
     dev: tuple[str, int] | None,
     local: LocalType | None,
 ) -> CmpKey:
-    # When we compare a release version, we want to compare it with all of the
-    # trailing zeros removed. We will use this for our sorting key.
+    """Build a comparison key for PEP 440 ordering.
+
+    Returns ``(epoch, release, suffix)`` or
+    ``(epoch, release, suffix, local)`` so that plain tuple
+    comparison gives the correct order.
+
+    Trailing zeros are stripped from the release so that ``1.0.0 == 1``.
+
+    The suffix is a flat 6-int tuple that encodes pre/post/dev:
+    ``(pre_rank, pre_n, post_rank, post_n, dev_rank, dev_n)``
+
+    pre_rank: dev-only=-1, a=0, b=1, rc=2, no-pre=3
+        Dev-only releases (no pre or post) get -1 so they sort before
+        any alpha/beta/rc.  Releases without a pre-release tag get 3
+        so they sort after rc.
+    post_rank: no-post=0, post=1
+        Releases without a post segment sort before those with one.
+    dev_rank: dev=0, no-dev=1
+        Releases without a dev segment sort after those with one.
+
+    Local segments use ``(n, "")`` for ints and ``(-1, s)`` for strings,
+    following PEP 440: strings sort before ints, strings compare
+    lexicographically, ints compare numerically, and shorter segments
+    sort before longer when prefixes match.  Versions without a local
+    segment sort before those with one (3-tuple < 4-tuple).
+
+    >>> _cmpkey(0, (1, 0, 0), None, None, None, None)
+    (0, (1,), (3, 0, 0, 0, 1, 0))
+    >>> _cmpkey(0, (1,), ("a", 1), None, None, None)
+    (0, (1,), (0, 1, 0, 0, 1, 0))
+    >>> _cmpkey(0, (1,), None, None, None, ("ubuntu", 1))
+    (0, (1,), (3, 0, 0, 0, 1, 0), ((-1, 'ubuntu'), (1, '')))
+    """
+    # Strip trailing zeros: 1.0.0 compares equal to 1.
     len_release = len(release)
     i = len_release
     while i and release[i - 1] == 0:
         i -= 1
-    _release = release if i == len_release else release[:i]
+    trimmed = release if i == len_release else release[:i]
+
+    # Fast path: stable release with no local segment.
+    if pre is None and post is None and dev is None and local is None:
+        return epoch, trimmed, _STABLE_SUFFIX
 
-    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
-    # We'll do this by abusing the pre segment, but we _only_ want to do this
-    # if there is not a pre or a post segment. If we have one of those then
-    # the normal sorting rules will handle this case correctly.
     if pre is None and post is None and dev is not None:
-        _pre: CmpPrePostDevType = NegativeInfinity
-    # Versions without a pre-release (except as noted above) should sort after
-    # those with one.
+        # dev-only (e.g. 1.0.dev1) sorts before all pre-releases.
+        pre_rank, pre_n = _PRE_RANK_DEV_ONLY, 0
     elif pre is None:
-        _pre = Infinity
+        pre_rank, pre_n = _PRE_RANK_STABLE, 0
     else:
-        _pre = pre
+        pre_rank, pre_n = _PRE_RANK[pre[0]], pre[1]
 
-    # Versions without a post segment should sort before those with one.
-    if post is None:
-        _post: CmpPrePostDevType = NegativeInfinity
+    post_rank = 0 if post is None else 1
+    post_n = 0 if post is None else post[1]
 
-    else:
-        _post = post
+    dev_rank = 1 if dev is None else 0
+    dev_n = 0 if dev is None else dev[1]
 
-    # Versions without a development segment should sort after those with one.
-    if dev is None:
-        _dev: CmpPrePostDevType = Infinity
-
-    else:
-        _dev = dev
+    suffix = (pre_rank, pre_n, post_rank, post_n, dev_rank, dev_n)
 
     if local is None:
-        # Versions without a local segment should sort before those with one.
-        _local: CmpLocalType = NegativeInfinity
-    else:
-        # Versions with a local segment need that segment parsed to implement
-        # the sorting rules in PEP440.
-        # - Alpha numeric segments sort before numeric segments
-        # - Alpha numeric segments sort lexicographically
-        # - Numeric segments sort numerically
-        # - Shorter versions sort before longer versions when the prefixes
-        #   match exactly
-        _local = tuple(
-            (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local
-        )
+        return epoch, trimmed, suffix
 
-    return epoch, _release, _pre, _post, _dev, _local
+    cmp_local: CmpLocalType = tuple(
+        (seg, "") if isinstance(seg, int) else (_LOCAL_STR_RANK, seg) for seg in local
+    )
+    return epoch, trimmed, suffix, cmp_local
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__init__.py
index 2325ec2..b083a8a 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__init__.py
@@ -1,8 +1,12 @@
-"""
-Utilities for determining application-specific dirs.
+"""Utilities for determining application-specific dirs.
+
+Provides convenience functions (e.g. :func:`user_data_dir`, :func:`user_config_path`), a :data:`PlatformDirs` class that
+auto-detects the current platform, and the :class:`~platformdirs.api.PlatformDirsABC` base class.
 
 See  for details and usage.
 
+PYTEST_DONT_REWRITE: Applications may import platformdirs before starting pytest.
+
 """
 
 from __future__ import annotations
@@ -11,7 +15,7 @@ import os
 import sys
 from typing import TYPE_CHECKING
 
-from .api import PlatformDirsABC
+from .api import PlatformDirsABC, RuntimeDirWarning
 from .version import __version__
 from .version import __version_tuple__ as __version_info__
 
@@ -23,19 +27,24 @@ if sys.platform == "win32":
     from pip._vendor.platformdirs.windows import Windows as _Result
 elif sys.platform == "darwin":
     from pip._vendor.platformdirs.macos import MacOS as _Result
+elif sys.platform == "ios":
+    from pip._vendor.platformdirs.ios import IOS as _Result  # ruff:ignore[constant-imported-as-non-constant]  # a class, PEP 8 acronym
 else:
     from pip._vendor.platformdirs.unix import Unix as _Result
 
 
 def _set_platform_dir_class() -> type[PlatformDirsABC]:
-    if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
+    # Every Android build of CPython has sys.getandroidapilevel, even in a process started with a cleared environment.
+    if hasattr(sys, "getandroidapilevel") or (
+        os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system"
+    ):
         if os.getenv("SHELL") or os.getenv("PREFIX"):
             return _Result
 
-        from pip._vendor.platformdirs.android import _android_folder  # noqa: PLC0415
+        from pip._vendor.platformdirs.android import _android_folder  # ruff:ignore[import-outside-top-level]
 
         if _android_folder() is not None:
-            from pip._vendor.platformdirs.android import Android  # noqa: PLC0415
+            from pip._vendor.platformdirs.android import Android  # ruff:ignore[import-outside-top-level]
 
             return Android  # return to avoid redefinition of a result
 
@@ -50,20 +59,23 @@ else:
 AppDirs = PlatformDirs  #: Backwards compatibility with appdirs
 
 
-def user_data_dir(
+def user_data_dir(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    roaming: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    roaming: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param roaming: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: data directory tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -71,6 +83,7 @@ def user_data_dir(
         version=version,
         roaming=roaming,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_data_dir
 
 
@@ -78,16 +91,17 @@ def site_data_dir(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    multipath: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    multipath: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
-    :param multipath: See `roaming `.
+    :param multipath: See `multipath `.
     :param ensure_exists: See `ensure_exists `.
+
     :returns: data directory shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -98,20 +112,23 @@ def site_data_dir(
     ).site_data_dir
 
 
-def user_config_dir(
+def user_config_dir(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    roaming: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    roaming: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param roaming: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: config directory tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -119,6 +136,7 @@ def user_config_dir(
         version=version,
         roaming=roaming,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_config_dir
 
 
@@ -126,16 +144,17 @@ def site_config_dir(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    multipath: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    multipath: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
-    :param multipath: See `roaming `.
+    :param multipath: See `multipath `.
     :param ensure_exists: See `ensure_exists `.
-    :returns: config directory shared by the users
+
+    :returns: config directory shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -146,20 +165,23 @@ def site_config_dir(
     ).site_config_dir
 
 
-def user_cache_dir(
+def user_cache_dir(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
-    :param opinion: See `roaming `.
+    :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: cache directory tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -167,47 +189,56 @@ def user_cache_dir(
         version=version,
         opinion=opinion,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_cache_dir
 
 
-def site_cache_dir(
+def site_cache_dir(  # ruff:ignore[too-many-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    *,
+    multipath: bool = False,
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
-    :returns: cache directory tied to the user
+    :param multipath: See `multipath `.
+
+    :returns: cache directory shared by users
+
     """
     return PlatformDirs(
         appname=appname,
         appauthor=appauthor,
         version=version,
+        multipath=multipath,
         opinion=opinion,
         ensure_exists=ensure_exists,
     ).site_cache_dir
 
 
-def user_state_dir(
+def user_state_dir(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    roaming: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    roaming: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param roaming: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: state directory tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -215,23 +246,79 @@ def user_state_dir(
         version=version,
         roaming=roaming,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_state_dir
 
 
-def user_log_dir(
+def site_state_dir(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
-    :param opinion: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+
+    :returns: state directory shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        ensure_exists=ensure_exists,
+    ).site_state_dir
+
+
+def user_log_dir(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    *,
+    roaming: bool = False,
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+    :param roaming: See `roaming `.
+
     :returns: log directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_log_dir
+
+
+def site_log_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: log directory shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -239,7 +326,7 @@ def user_log_dir(
         version=version,
         opinion=opinion,
         ensure_exists=ensure_exists,
-    ).user_log_dir
+    ).site_log_dir
 
 
 def user_documents_dir() -> str:
@@ -272,20 +359,138 @@ def user_desktop_dir() -> str:
     return PlatformDirs().user_desktop_dir
 
 
-def user_runtime_dir(
+def user_projects_dir() -> str:
+    """:returns: projects directory tied to the user"""
+    return PlatformDirs().user_projects_dir
+
+
+def user_publicshare_dir() -> str:
+    """:returns: public share directory tied to the user"""
+    return PlatformDirs().user_publicshare_dir
+
+
+def user_templates_dir() -> str:
+    """:returns: templates directory tied to the user"""
+    return PlatformDirs().user_templates_dir
+
+
+def user_fonts_dir() -> str:
+    """:returns: fonts directory tied to the user"""
+    return PlatformDirs().user_fonts_dir
+
+
+def user_preference_dir(  # ruff:ignore[too-many-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    *,
+    roaming: bool = False,
+    ensure_exists: bool = False,
+    use_site_for_root: bool = False,
 ) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: preference directory tied to the user
+
     """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_preference_dir
+
+
+def user_bin_dir(*, use_site_for_root: bool = False) -> str:
+    """:param use_site_for_root: See `use_site_for_root `.
+
+    :returns: bin directory tied to the user
+
+    """
+    return PlatformDirs(use_site_for_root=use_site_for_root).user_bin_dir
+
+
+def site_bin_dir() -> str:
+    """:returns: bin directory shared by users"""
+    return PlatformDirs().site_bin_dir
+
+
+def user_applications_dir(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    *,
+    ensure_exists: bool = False,
+    use_site_for_root: bool = False,
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: applications directory tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_applications_dir
+
+
+def site_applications_dir(
+    multipath: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    *,
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+) -> str:
+    """:param multipath: See `multipath `.
+    :param ensure_exists: See `ensure_exists `.
     :param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
+
+    :returns: applications directory shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_applications_dir
+
+
+def user_runtime_dir(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+) -> str:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
     :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: runtime directory tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -293,6 +498,7 @@ def user_runtime_dir(
         version=version,
         opinion=opinion,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_runtime_dir
 
 
@@ -300,16 +506,17 @@ def site_runtime_dir(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> str:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
+
     :returns: runtime directory shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -320,20 +527,23 @@ def site_runtime_dir(
     ).site_runtime_dir
 
 
-def user_data_path(
+def user_data_path(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    roaming: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    roaming: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param roaming: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: data path tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -341,6 +551,7 @@ def user_data_path(
         version=version,
         roaming=roaming,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_data_path
 
 
@@ -348,16 +559,17 @@ def site_data_path(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    multipath: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    multipath: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param multipath: See `multipath `.
     :param ensure_exists: See `ensure_exists `.
+
     :returns: data path shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -368,20 +580,23 @@ def site_data_path(
     ).site_data_path
 
 
-def user_config_path(
+def user_config_path(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    roaming: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    roaming: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param roaming: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: config path tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -389,6 +604,7 @@ def user_config_path(
         version=version,
         roaming=roaming,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_config_path
 
 
@@ -396,16 +612,17 @@ def site_config_path(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    multipath: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    multipath: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
-    :param multipath: See `roaming `.
+    :param multipath: See `multipath `.
     :param ensure_exists: See `ensure_exists `.
-    :returns: config path shared by the users
+
+    :returns: config path shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -416,44 +633,52 @@ def site_config_path(
     ).site_config_path
 
 
-def site_cache_path(
+def site_cache_path(  # ruff:ignore[too-many-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    *,
+    multipath: bool = False,
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
-    :returns: cache directory tied to the user
+    :param multipath: See `multipath `.
+
+    :returns: cache path shared by users
+
     """
     return PlatformDirs(
         appname=appname,
         appauthor=appauthor,
         version=version,
+        multipath=multipath,
         opinion=opinion,
         ensure_exists=ensure_exists,
     ).site_cache_path
 
 
-def user_cache_path(
+def user_cache_path(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
-    :param opinion: See `roaming `.
+    :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: cache path tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -461,23 +686,27 @@ def user_cache_path(
         version=version,
         opinion=opinion,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_cache_path
 
 
-def user_state_path(
+def user_state_path(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    roaming: bool = False,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    roaming: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param roaming: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: state path tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -485,23 +714,79 @@ def user_state_path(
         version=version,
         roaming=roaming,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_state_path
 
 
-def user_log_path(
+def site_state_path(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
-    :param opinion: See `roaming `.
     :param ensure_exists: See `ensure_exists `.
+
+    :returns: state path shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        ensure_exists=ensure_exists,
+    ).site_state_path
+
+
+def user_log_path(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    *,
+    roaming: bool = False,
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+    :param roaming: See `roaming `.
+
     :returns: log path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_log_path
+
+
+def site_log_path(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param opinion: See `opinion `.
+    :param ensure_exists: See `ensure_exists `.
+
+    :returns: log path shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -509,11 +794,11 @@ def user_log_path(
         version=version,
         opinion=opinion,
         ensure_exists=ensure_exists,
-    ).user_log_path
+    ).site_log_path
 
 
 def user_documents_path() -> Path:
-    """:returns: documents a path tied to the user"""
+    """:returns: documents path tied to the user"""
     return PlatformDirs().user_documents_path
 
 
@@ -542,20 +827,138 @@ def user_desktop_path() -> Path:
     return PlatformDirs().user_desktop_path
 
 
-def user_runtime_path(
+def user_projects_path() -> Path:
+    """:returns: projects path tied to the user"""
+    return PlatformDirs().user_projects_path
+
+
+def user_publicshare_path() -> Path:
+    """:returns: public share path tied to the user"""
+    return PlatformDirs().user_publicshare_path
+
+
+def user_templates_path() -> Path:
+    """:returns: templates path tied to the user"""
+    return PlatformDirs().user_templates_path
+
+
+def user_fonts_path() -> Path:
+    """:returns: fonts path tied to the user"""
+    return PlatformDirs().user_fonts_path
+
+
+def user_preference_path(  # ruff:ignore[too-many-arguments]
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    *,
+    roaming: bool = False,
+    ensure_exists: bool = False,
+    use_site_for_root: bool = False,
 ) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param roaming: See `roaming `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: preference path tied to the user
+
     """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_preference_path
+
+
+def user_bin_path(*, use_site_for_root: bool = False) -> Path:
+    """:param use_site_for_root: See `use_site_for_root `.
+
+    :returns: bin path tied to the user
+
+    """
+    return PlatformDirs(use_site_for_root=use_site_for_root).user_bin_path
+
+
+def site_bin_path() -> Path:
+    """:returns: bin path shared by users"""
+    return PlatformDirs().site_bin_path
+
+
+def user_applications_path(
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    *,
+    ensure_exists: bool = False,
+    use_site_for_root: bool = False,
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
+    :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
+    :returns: applications path tied to the user
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
+    ).user_applications_path
+
+
+def site_applications_path(
+    multipath: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    *,
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+) -> Path:
+    """:param multipath: See `multipath `.
+    :param ensure_exists: See `ensure_exists `.
     :param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
+
+    :returns: applications path shared by users
+
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_applications_path
+
+
+def user_runtime_path(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
+    appname: str | None = None,
+    appauthor: str | Literal[False] | None = None,
+    version: str | None = None,
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+) -> Path:
+    """:param appname: See `appname `.
+    :param appauthor: See `appauthor `.
+    :param version: See `version `.
     :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
+    :param use_site_for_root: See `use_site_for_root `.
+
     :returns: runtime path tied to the user
+
     """
     return PlatformDirs(
         appname=appname,
@@ -563,6 +966,7 @@ def user_runtime_path(
         version=version,
         opinion=opinion,
         ensure_exists=ensure_exists,
+        use_site_for_root=use_site_for_root,
     ).user_runtime_path
 
 
@@ -570,16 +974,17 @@ def site_runtime_path(
     appname: str | None = None,
     appauthor: str | Literal[False] | None = None,
     version: str | None = None,
-    opinion: bool = True,  # noqa: FBT001, FBT002
-    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+    ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
 ) -> Path:
-    """
-    :param appname: See `appname `.
+    """:param appname: See `appname `.
     :param appauthor: See `appauthor `.
     :param version: See `version `.
     :param opinion: See `opinion `.
     :param ensure_exists: See `ensure_exists `.
+
     :returns: runtime path shared by users
+
     """
     return PlatformDirs(
         appname=appname,
@@ -594,16 +999,29 @@ __all__ = [
     "AppDirs",
     "PlatformDirs",
     "PlatformDirsABC",
+    "RuntimeDirWarning",
     "__version__",
     "__version_info__",
+    "site_applications_dir",
+    "site_applications_path",
+    "site_bin_dir",
+    "site_bin_path",
     "site_cache_dir",
     "site_cache_path",
     "site_config_dir",
     "site_config_path",
     "site_data_dir",
     "site_data_path",
+    "site_log_dir",
+    "site_log_path",
     "site_runtime_dir",
     "site_runtime_path",
+    "site_state_dir",
+    "site_state_path",
+    "user_applications_dir",
+    "user_applications_path",
+    "user_bin_dir",
+    "user_bin_path",
     "user_cache_dir",
     "user_cache_path",
     "user_config_dir",
@@ -616,16 +1034,26 @@ __all__ = [
     "user_documents_path",
     "user_downloads_dir",
     "user_downloads_path",
+    "user_fonts_dir",
+    "user_fonts_path",
     "user_log_dir",
     "user_log_path",
     "user_music_dir",
     "user_music_path",
     "user_pictures_dir",
     "user_pictures_path",
+    "user_preference_dir",
+    "user_preference_path",
+    "user_projects_dir",
+    "user_projects_path",
+    "user_publicshare_dir",
+    "user_publicshare_path",
     "user_runtime_dir",
     "user_runtime_path",
     "user_state_dir",
     "user_state_path",
+    "user_templates_dir",
+    "user_templates_path",
     "user_videos_dir",
     "user_videos_path",
 ]
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__main__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__main__.py
index fa8a677..47dfe58 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__main__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/__main__.py
@@ -2,8 +2,13 @@
 
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from pip._vendor.platformdirs import PlatformDirs, __version__
 
+if TYPE_CHECKING:
+    from pip._vendor.platformdirs.api import PlatformDirsABC
+
 PROPS = (
     "user_data_dir",
     "user_config_dir",
@@ -15,10 +20,22 @@ PROPS = (
     "user_pictures_dir",
     "user_videos_dir",
     "user_music_dir",
+    "user_desktop_dir",
+    "user_projects_dir",
+    "user_publicshare_dir",
+    "user_templates_dir",
+    "user_fonts_dir",
+    "user_preference_dir",
+    "user_bin_dir",
+    "site_bin_dir",
+    "user_applications_dir",
     "user_runtime_dir",
     "site_data_dir",
     "site_config_dir",
     "site_cache_dir",
+    "site_state_dir",
+    "site_log_dir",
+    "site_applications_dir",
     "site_runtime_dir",
 )
 
@@ -28,27 +45,32 @@ def main() -> None:
     app_name = "MyApp"
     app_author = "MyCompany"
 
-    print(f"-- platformdirs {__version__} --")  # noqa: T201
+    print(f"-- platformdirs {__version__} --")  # ruff:ignore[print]
 
-    print("-- app dirs (with optional 'version')")  # noqa: T201
-    dirs = PlatformDirs(app_name, app_author, version="1.0")
-    for prop in PROPS:
-        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+    print("-- app dirs (with optional 'version')")  # ruff:ignore[print]
+    _print_dirs(PlatformDirs(app_name, app_author, version="1.0"))
 
-    print("\n-- app dirs (without optional 'version')")  # noqa: T201
-    dirs = PlatformDirs(app_name, app_author)
-    for prop in PROPS:
-        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+    print("\n-- app dirs (without optional 'version')")  # ruff:ignore[print]
+    _print_dirs(PlatformDirs(app_name, app_author))
 
-    print("\n-- app dirs (without optional 'appauthor')")  # noqa: T201
-    dirs = PlatformDirs(app_name)
-    for prop in PROPS:
-        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+    print("\n-- app dirs (without optional 'appauthor')")  # ruff:ignore[print]
+    _print_dirs(PlatformDirs(app_name))
 
-    print("\n-- app dirs (with disabled 'appauthor')")  # noqa: T201
-    dirs = PlatformDirs(app_name, appauthor=False)
+    print("\n-- app dirs (with disabled 'appauthor')")  # ruff:ignore[print]
+    _print_dirs(PlatformDirs(app_name, appauthor=False))
+
+
+def _print_dirs(dirs: PlatformDirsABC) -> None:
     for prop in PROPS:
-        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+        print(f"{prop}: {_dir_or_error(dirs, prop)}")  # ruff:ignore[print]
+
+
+def _dir_or_error(dirs: PlatformDirsABC, prop: str) -> str:
+    # user_runtime_dir raises when its temporary fallback is not a directory the user owns.
+    try:
+        return getattr(dirs, prop)
+    except PermissionError as error:
+        return str(error)
 
 
 if __name__ == "__main__":
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/android.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/android.py
index 92efc85..fd0ac0e 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/android.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/android.py
@@ -5,243 +5,260 @@ from __future__ import annotations
 import os
 import re
 import sys
-from functools import lru_cache
-from typing import TYPE_CHECKING, cast
+from contextlib import suppress
+from functools import cache, lru_cache
+from typing import Final
 
 from .api import PlatformDirsABC
 
 
-class Android(PlatformDirsABC):
-    """
-    Follows the guidance `from here `_.
+class Android(PlatformDirsABC):  # ruff:ignore[too-many-public-methods]
+    """Platform directories for Android.
+
+    Follows the guidance `from here `_. Directories are typically located
+    under the app's private storage (``/data/user///``).
 
     Makes use of the `appname `, `version
-    `, `ensure_exists `.
+    `, `opinion `, `ensure_exists
+    `.
 
     """
 
     @property
     def user_data_dir(self) -> str:
-        """:return: data directory tied to the user, e.g. ``/data/user///files/``"""
-        return self._append_app_name_and_version(cast("str", _android_folder()), "files")
+        """Data directory tied to the user, e.g. ``/data/user///files/``."""
+        return self._append_app_name_and_version(_require_android_folder(), "files", private=True)
 
     @property
     def site_data_dir(self) -> str:
-        """:return: data directory shared by users, same as `user_data_dir`"""
+        """Data directory shared by users, same as `user_data_dir`."""
         return self.user_data_dir
 
     @property
     def user_config_dir(self) -> str:
-        """
-        :return: config directory tied to the user, e.g. \
-        ``/data/user///shared_prefs/``
-        """
-        return self._append_app_name_and_version(cast("str", _android_folder()), "shared_prefs")
+        """Config directory tied to the user, e.g. ``/data/user///shared_prefs/``."""
+        return self._append_app_name_and_version(_require_android_folder(), "shared_prefs", private=True)
 
     @property
     def site_config_dir(self) -> str:
-        """:return: config directory shared by the users, same as `user_config_dir`"""
+        """Config directory shared by users, same as `user_config_dir`."""
         return self.user_config_dir
 
     @property
     def user_cache_dir(self) -> str:
-        """:return: cache directory tied to the user, e.g.,``/data/user///cache/``"""
-        return self._append_app_name_and_version(cast("str", _android_folder()), "cache")
+        """Cache directory tied to the user, e.g.,``/data/user///cache/``."""
+        return self._append_app_name_and_version(_require_android_folder(), "cache", private=True)
 
     @property
     def site_cache_dir(self) -> str:
-        """:return: cache directory shared by users, same as `user_cache_dir`"""
+        """Cache directory shared by users, same as `user_cache_dir`."""
         return self.user_cache_dir
 
     @property
     def user_state_dir(self) -> str:
-        """:return: state directory tied to the user, same as `user_data_dir`"""
+        """State directory tied to the user, same as `user_data_dir`."""
         return self.user_data_dir
 
+    @property
+    def site_state_dir(self) -> str:
+        """State directory shared by users, same as `user_state_dir`."""
+        return self.user_state_dir
+
     @property
     def user_log_dir(self) -> str:
-        """
-        :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it,
-          e.g. ``/data/user///cache//log``
-        """
+        """Log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it, e.g. ``/data/user///cache//log``."""
         path = self.user_cache_dir
         if self.opinion:
-            path = os.path.join(path, "log")  # noqa: PTH118
+            path = os.path.join(path, "log")  # ruff:ignore[os-path-join]
+            self._optionally_create_directory(path, private=True)
         return path
 
+    @property
+    def site_log_dir(self) -> str:
+        """Log directory shared by users, same as `user_log_dir`."""
+        return self.user_log_dir
+
     @property
     def user_documents_dir(self) -> str:
-        """:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``"""
-        return _android_documents_folder()
+        """Documents directory tied to the user e.g. ``/storage/emulated/0/Documents``."""
+        return _android_public_folder("Documents")
 
     @property
     def user_downloads_dir(self) -> str:
-        """:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``"""
-        return _android_downloads_folder()
+        """Downloads directory tied to the user e.g. ``/storage/emulated/0/Download``."""
+        return _android_public_folder("Download")
 
     @property
     def user_pictures_dir(self) -> str:
-        """:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``"""
-        return _android_pictures_folder()
+        """Pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``."""
+        return _android_public_folder("Pictures")
 
     @property
     def user_videos_dir(self) -> str:
-        """:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``"""
-        return _android_videos_folder()
+        """Videos directory tied to the user e.g. ``/storage/emulated/0/Movies``."""
+        return _android_public_folder("Movies")
 
     @property
     def user_music_dir(self) -> str:
-        """:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``"""
-        return _android_music_folder()
+        """Music directory tied to the user e.g. ``/storage/emulated/0/Music``."""
+        return _android_public_folder("Music")
 
+    # Android lets apps create top-level shared folders only from its standard list, so these live in Documents.
     @property
     def user_desktop_dir(self) -> str:
-        """:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``"""
-        return "/storage/emulated/0/Desktop"
+        """Desktop directory tied to the user e.g. ``/storage/emulated/0/Documents/Desktop``."""
+        return f"{_shared_storage()}/Documents/Desktop"
+
+    @property
+    def user_projects_dir(self) -> str:
+        """Projects directory tied to the user e.g. ``/storage/emulated/0/Documents/Projects``."""
+        return f"{_shared_storage()}/Documents/Projects"
+
+    @property
+    def user_publicshare_dir(self) -> str:
+        """Public share directory tied to the user e.g. ``/storage/emulated/0/Documents/Public``."""
+        return f"{_shared_storage()}/Documents/Public"
+
+    @property
+    def user_templates_dir(self) -> str:
+        """Templates directory tied to the user e.g. ``/storage/emulated/0/Documents/Templates``."""
+        return f"{_shared_storage()}/Documents/Templates"
+
+    @property
+    def user_fonts_dir(self) -> str:
+        """Fonts directory tied to the user e.g. ``/storage/emulated/0/Documents/fonts``."""
+        return f"{_shared_storage()}/Documents/fonts"
+
+    @property
+    def user_preference_dir(self) -> str:
+        """Preference directory tied to the user, same as ``user_config_dir``."""
+        return self.user_config_dir
+
+    @property
+    def user_bin_dir(self) -> str:
+        """Bin directory tied to the user, e.g. ``/data/user///files/bin``."""
+        return os.path.join(_require_android_folder(), "files", "bin")  # ruff:ignore[os-path-join]
+
+    @property
+    def site_bin_dir(self) -> str:
+        """Bin directory shared by users, same as `user_bin_dir`."""
+        return self.user_bin_dir
+
+    @property
+    def user_applications_dir(self) -> str:
+        """Applications directory tied to the user, same as `user_data_dir`."""
+        return self.user_data_dir
+
+    @property
+    def site_applications_dir(self) -> str:
+        """Applications directory shared by users, same as `user_applications_dir`."""
+        return self.user_applications_dir
 
     @property
     def user_runtime_dir(self) -> str:
-        """
-        :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it,
-          e.g. ``/data/user///cache//tmp``
-        """
+        """Runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it, e.g. ``/data/user///cache//tmp``."""
         path = self.user_cache_dir
         if self.opinion:
-            path = os.path.join(path, "tmp")  # noqa: PTH118
+            path = os.path.join(path, "tmp")  # ruff:ignore[os-path-join]
+            self._optionally_create_directory(path, private=True)
         return path
 
     @property
     def site_runtime_dir(self) -> str:
-        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        """Runtime directory shared by users, same as `user_runtime_dir`."""
         return self.user_runtime_dir
 
 
+def _require_android_folder() -> str:
+    if (folder := _android_folder()) is None:
+        msg = "cannot find the Android app folder: python4android and pyjnius failed and no app folder is on sys.path"
+        raise RuntimeError(msg)
+    return folder
+
+
 @lru_cache(maxsize=1)
-def _android_folder() -> str | None:  # noqa: C901
-    """:return: base folder for the Android OS or None if it cannot be found"""
-    result: str | None = None
-    # type checker isn't happy with our "import android", just don't do this when type checking see
-    # https://stackoverflow.com/a/61394121
-    if not TYPE_CHECKING:
-        try:
-            # First try to get a path to android app using python4android (if available)...
-            from android import mActivity  # noqa: PLC0415
-
-            context = cast("android.content.Context", mActivity.getApplicationContext())  # noqa: F821
-            result = context.getFilesDir().getParentFile().getAbsolutePath()
-        except Exception:  # noqa: BLE001
-            result = None
-    if result is None:
-        try:
-            # ...and fall back to using plain pyjnius, if python4android isn't available or doesn't deliver any useful
-            # result...
-            from jnius import autoclass  # noqa: PLC0415
-
-            context = autoclass("android.content.Context")
-            result = context.getFilesDir().getParentFile().getAbsolutePath()
-        except Exception:  # noqa: BLE001
-            result = None
+def _android_folder() -> str | None:
+    """:returns: base folder for the Android OS or None if it cannot be found"""
+    result = _python_for_android_folder()
     if result is None:
         # and if that fails, too, find an android folder looking at path on the sys.path
         # warning: only works for apps installed under /data, not adopted storage etc.
-        pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files")
+        pattern = re.compile(
+            r"""
+            (?P
+                /data/(?:data|user/\d+)  # internal storage of the primary user or of user N
+                /[^/]+                   # package name, one path segment
+            )
+            /files                       # the files directory the interpreter runs from
+            """,
+            re.VERBOSE,
+        )
         for path in sys.path:
-            if pattern.match(path):
-                result = path.split("/files")[0]
+            if match := pattern.match(path):
+                result = match["folder"]
                 break
         else:
             result = None
     if result is None:
         # one last try: find an android folder looking at path on the sys.path taking adopted storage paths into
         # account
-        pattern = re.compile(r"/mnt/expand/[a-fA-F0-9-]{36}/(data|user/\d+)/(.+)/files")
+        pattern = re.compile(
+            r"""
+            (?P
+                /mnt/expand/[a-fA-F0-9-]{36}  # adopted storage volume, named by its UUID
+                /(?:data|user/\d+)             # the primary user or user N
+                /[^/]+                         # package name, one path segment
+            )
+            /files                             # the files directory the interpreter runs from
+            """,
+            re.VERBOSE,
+        )
         for path in sys.path:
-            if pattern.match(path):
-                result = path.split("/files")[0]
+            if match := pattern.match(path):
+                result = match["folder"]
                 break
         else:
             result = None
     return result
 
 
-@lru_cache(maxsize=1)
-def _android_documents_folder() -> str:
-    """:return: documents folder for the Android OS"""
-    # Get directories with pyjnius
-    try:
-        from jnius import autoclass  # noqa: PLC0415
-
-        context = autoclass("android.content.Context")
-        environment = autoclass("android.os.Environment")
-        documents_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOCUMENTS).getAbsolutePath()
-    except Exception:  # noqa: BLE001
-        documents_dir = "/storage/emulated/0/Documents"
-
-    return documents_dir
+_USER_ID: Final = re.compile(
+    r"""
+    /user/         # the per-user data root, under /data or an adopted /mnt/expand volume
+    (?P\d+)  # the Android user id
+    /              # followed by the package folder
+    """,
+    re.VERBOSE,
+)
 
 
-@lru_cache(maxsize=1)
-def _android_downloads_folder() -> str:
-    """:return: downloads folder for the Android OS"""
-    # Get directories with pyjnius
-    try:
-        from jnius import autoclass  # noqa: PLC0415
-
-        context = autoclass("android.content.Context")
-        environment = autoclass("android.os.Environment")
-        downloads_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOWNLOADS).getAbsolutePath()
-    except Exception:  # noqa: BLE001
-        downloads_dir = "/storage/emulated/0/Downloads"
-
-    return downloads_dir
+def _shared_storage() -> str:
+    # Android mounts each user's shared storage at /storage/emulated/, and an app sees only its own user's.
+    user = match["user"] if (match := _USER_ID.search(_android_folder() or "")) else "0"
+    return f"/storage/emulated/{user}"
 
 
-@lru_cache(maxsize=1)
-def _android_pictures_folder() -> str:
-    """:return: pictures folder for the Android OS"""
-    # Get directories with pyjnius
-    try:
-        from jnius import autoclass  # noqa: PLC0415
+def _python_for_android_folder() -> str | None:
+    with suppress(ImportError):
+        from jnius import JavaException, autoclass  # ruff:ignore[import-outside-top-level]  # ty: ignore[unresolved-import]
 
-        context = autoclass("android.content.Context")
-        environment = autoclass("android.os.Environment")
-        pictures_dir: str = context.getExternalFilesDir(environment.DIRECTORY_PICTURES).getAbsolutePath()
-    except Exception:  # noqa: BLE001
-        pictures_dir = "/storage/emulated/0/Pictures"
-
-    return pictures_dir
+        with suppress(JavaException):
+            # A python-for-android service runs in its own process, where the activity is null.
+            if (context := autoclass("org.kivy.android.PythonActivity").mActivity) is None:
+                context = autoclass("org.kivy.android.PythonService").mService
+            if context is not None:
+                return context.getFilesDir().getParentFile().getAbsolutePath()
+    return None
 
 
-@lru_cache(maxsize=1)
-def _android_videos_folder() -> str:
-    """:return: videos folder for the Android OS"""
-    # Get directories with pyjnius
-    try:
-        from jnius import autoclass  # noqa: PLC0415
+@cache
+def _android_public_folder(name: str) -> str:
+    with suppress(ImportError):
+        from jnius import JavaException, autoclass  # ruff:ignore[import-outside-top-level]  # ty: ignore[unresolved-import]
 
-        context = autoclass("android.content.Context")
-        environment = autoclass("android.os.Environment")
-        videos_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DCIM).getAbsolutePath()
-    except Exception:  # noqa: BLE001
-        videos_dir = "/storage/emulated/0/DCIM/Camera"
-
-    return videos_dir
-
-
-@lru_cache(maxsize=1)
-def _android_music_folder() -> str:
-    """:return: music folder for the Android OS"""
-    # Get directories with pyjnius
-    try:
-        from jnius import autoclass  # noqa: PLC0415
-
-        context = autoclass("android.content.Context")
-        environment = autoclass("android.os.Environment")
-        music_dir: str = context.getExternalFilesDir(environment.DIRECTORY_MUSIC).getAbsolutePath()
-    except Exception:  # noqa: BLE001
-        music_dir = "/storage/emulated/0/Music"
-
-    return music_dir
+        with suppress(JavaException):
+            return autoclass("android.os.Environment").getExternalStoragePublicDirectory(name).getAbsolutePath()
+    return f"{_shared_storage()}/{name}"
 
 
 __all__ = [
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/api.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/api.py
index 251600e..ff2e83c 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/api.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/api.py
@@ -4,29 +4,37 @@ from __future__ import annotations
 
 import os
 from abc import ABC, abstractmethod
+from contextlib import suppress
+from copy import copy
 from pathlib import Path
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from collections.abc import Iterator
+    from collections.abc import Callable, Iterable, Iterator
     from typing import Literal
 
 
-class PlatformDirsABC(ABC):  # noqa: PLR0904
-    """Abstract base class for platform directories."""
+class PlatformDirsABC(ABC):  # ruff:ignore[too-many-public-methods]
+    """Abstract base class defining all platform directory properties, their :class:`~pathlib.Path` variants, and iterators.
 
-    def __init__(  # noqa: PLR0913, PLR0917
+    Platform-specific subclasses (e.g. :class:`~platformdirs.windows.Windows`, :class:`~platformdirs.macos.MacOS`,
+    :class:`~platformdirs.unix.Unix`) implement the abstract properties to return the appropriate paths for each
+    operating system.
+
+    """
+
+    def __init__(  # ruff:ignore[too-many-arguments, too-many-positional-arguments]
         self,
         appname: str | None = None,
         appauthor: str | Literal[False] | None = None,
         version: str | None = None,
-        roaming: bool = False,  # noqa: FBT001, FBT002
-        multipath: bool = False,  # noqa: FBT001, FBT002
-        opinion: bool = True,  # noqa: FBT001, FBT002
-        ensure_exists: bool = False,  # noqa: FBT001, FBT002
+        roaming: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+        multipath: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+        opinion: bool = True,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+        ensure_exists: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
+        use_site_for_root: bool = False,  # ruff:ignore[boolean-type-hint-positional-argument, boolean-default-value-positional-argument]
     ) -> None:
-        """
-        Create a new platform directory.
+        """Create a new platform directory.
 
         :param appname: See `appname`.
         :param appauthor: See `appauthor`.
@@ -35,248 +43,486 @@ class PlatformDirsABC(ABC):  # noqa: PLR0904
         :param multipath: See `multipath`.
         :param opinion: See `opinion`.
         :param ensure_exists: See `ensure_exists`.
+        :param use_site_for_root: See `use_site_for_root`.
 
         """
-        self.appname = appname  #: The name of application.
+        self.appname = appname
         self.appauthor = appauthor
+        self.version = version
+        self.roaming = roaming
+        """Whether to use the roaming appdata directory on Windows.
+
+        That means that for users on a Windows network setup for roaming profiles, this user data will be synced on
+        login (see `here `_).
+
         """
-        The name of the app author or distributing body for this application.
+        self.multipath = multipath
+        """An optional parameter which indicates that the entire list of data dirs should be returned.
+
+        When ``False``, only the first item is returned. Affects ``site_data_dir``, ``site_config_dir`` and
+        ``site_applications_dir`` on Unix and macOS, and ``site_cache_dir`` on macOS under Homebrew.
+
+        """
+        self.opinion = opinion
+        """Whether to use opinionated values.
+
+        When enabled, appends an additional subdirectory for certain directories: e.g. ``Cache`` for cache and ``Logs``
+        for logs on Windows, ``log`` for logs on Unix.
+
+        """
+        self.ensure_exists = ensure_exists
+        """Create the directory a property returns, with missing parents, each time the property is read.
+
+        Media directories qualify only when the user set them through XDG. platformdirs never creates fonts, bin,
+        applications or default media directories. Off by default.
+
+        """
+        self.use_site_for_root = use_site_for_root
+        """Whether to redirect ``user_*_dir`` calls to their ``site_*_dir`` equivalents when running as root (uid 0).
+
+        Only has an effect on Unix. Disabled by default for backwards compatibility. When enabled, XDG user environment
+        variables (e.g. ``XDG_DATA_HOME``) are bypassed for the redirected directories.
+
+        """
+
+    @property
+    def appname(self) -> str | None:
+        """The name of the application."""
+        return self._appname
+
+    @appname.setter
+    def appname(self, value: str | None) -> None:
+        _ensure_inside_base("appname", value)
+        self._appname = value
+
+    @property
+    def appauthor(self) -> str | Literal[False] | None:
+        """The name of the app author or distributing body for this application.
 
         Typically, it is the owning company name. Defaults to `appname`. You may pass ``False`` to disable it.
 
+        .. note::
+
+            On Windows, the directory structure is ``//``. When ``appauthor`` is ``None`` (the
+            default), it falls back to ``appname``, resulting in ``//`` (e.g.
+            ``AppData/Local/myapp/myapp``). Pass ``appauthor=False`` to omit the author directory entirely and get
+            ``/``.
+
         """
-        self.version = version
-        """
-        An optional version path element to append to the path.
+        return self._appauthor
+
+    @appauthor.setter
+    def appauthor(self, value: str | Literal[False] | None) -> None:
+        _ensure_inside_base("appauthor", value)
+        self._appauthor = value
+
+    @property
+    def version(self) -> str | None:
+        """An optional version path element to append to the path.
 
         You might want to use this if you want multiple versions of your app to be able to run independently. If used,
         this would typically be ``.``.
 
         """
-        self.roaming = roaming
-        """
-        Whether to use the roaming appdata directory on Windows.
+        return self._version
 
-        That means that for users on a Windows network setup for roaming profiles, this user data will be synced on
-        login (see
-        `here `_).
+    @version.setter
+    def version(self, value: str | None) -> None:
+        _ensure_inside_base("version", value)
+        self._version = value
 
-        """
-        self.multipath = multipath
-        """
-        An optional parameter which indicates that the entire list of data dirs should be returned.
+    def _append_app_name_and_version(self, *base: str, private: bool) -> str:
+        path = self._join_app_name_and_version(*base)
+        self._optionally_create_directory(path, private=private)
+        return path
 
-        By default, the first item would only be returned.
-
-        """
-        self.opinion = opinion  #: A flag to indicating to use opinionated values.
-        self.ensure_exists = ensure_exists
-        """
-        Optionally create the directory (and any missing parents) upon access if it does not exist.
-
-        By default, no directories are created.
-
-        """
-
-    def _append_app_name_and_version(self, *base: str) -> str:
+    def _join_app_name_and_version(self, *base: str) -> str:
         params = list(base[1:])
         if self.appname:
             params.append(self.appname)
             if self.version:
                 params.append(self.version)
-        path = os.path.join(base[0], *params)  # noqa: PTH118
-        self._optionally_create_directory(path)
-        return path
+        return os.path.join(base[0], *params)  # ruff:ignore[os-path-join]
 
-    def _optionally_create_directory(self, path: str) -> None:
-        if self.ensure_exists:
+    def _optionally_create_directory(self, path: str, *, private: bool) -> None:
+        if not self.ensure_exists:
+            return
+        _ensure_home_known(path)
+        if private:
+            _make_private_directories(Path(path))
+        else:
             Path(path).mkdir(parents=True, exist_ok=True)
 
-    def _first_item_as_path_if_multipath(self, directory: str) -> Path:
-        if self.multipath:
-            # If multipath is True, the first path is returned.
-            directory = directory.partition(os.pathsep)[0]
-        return Path(directory)
+    def _optionally_create_media_directory(self, path: str) -> None:
+        # Only called for a media directory the user configured. Media directories are often symlinks to removable or
+        # network storage, so a dangling link is returned as-is, like before ensure_exists covered them.
+        with suppress(FileExistsError):
+            self._optionally_create_directory(path, private=False)
+
+    def _select_site_dirs(self, dirs: list[str]) -> str:
+        # Site lists are built without touching the disk, so ensure_exists only creates what the caller gets back.
+        selected = dirs if self.multipath else dirs[:1]
+        for path in selected:
+            self._optionally_create_directory(path, private=False)
+        return os.pathsep.join(selected)
+
+    def _create_as_yielded(self, dirs: Iterable[str]) -> Iterator[str]:
+        for path in dirs:
+            self._optionally_create_directory(path, private=False)
+            yield path
+
+    def _first_site_dir_as_path(self, dirs: list[str]) -> Path:
+        # A *_path property always returns the first entry, regardless of multipath, so only that entry is created.
+        path = dirs[0]
+        self._optionally_create_directory(path, private=False)
+        return Path(path)
 
     @property
     @abstractmethod
     def user_data_dir(self) -> str:
-        """:return: data directory tied to the user"""
+        """Data directory tied to the user."""
 
     @property
     @abstractmethod
     def site_data_dir(self) -> str:
-        """:return: data directory shared by users"""
+        """Data directory shared by users."""
+
+    @property
+    def _site_data_dirs(self) -> list[str]:
+        return [self.site_data_dir]
 
     @property
     @abstractmethod
     def user_config_dir(self) -> str:
-        """:return: config directory tied to the user"""
+        """Config directory tied to the user."""
 
     @property
     @abstractmethod
     def site_config_dir(self) -> str:
-        """:return: config directory shared by the users"""
+        """Config directory shared by users."""
+
+    @property
+    def _site_config_dirs(self) -> list[str]:
+        return [self.site_config_dir]
 
     @property
     @abstractmethod
     def user_cache_dir(self) -> str:
-        """:return: cache directory tied to the user"""
+        """Cache directory tied to the user."""
 
     @property
     @abstractmethod
     def site_cache_dir(self) -> str:
-        """:return: cache directory shared by users"""
+        """Cache directory shared by users."""
+
+    @property
+    def _site_cache_dirs(self) -> list[str]:
+        return [self.site_cache_dir]
 
     @property
     @abstractmethod
     def user_state_dir(self) -> str:
-        """:return: state directory tied to the user"""
+        """State directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def site_state_dir(self) -> str:
+        """State directory shared by users."""
 
     @property
     @abstractmethod
     def user_log_dir(self) -> str:
-        """:return: log directory tied to the user"""
+        """Log directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def site_log_dir(self) -> str:
+        """Log directory shared by users."""
 
     @property
     @abstractmethod
     def user_documents_dir(self) -> str:
-        """:return: documents directory tied to the user"""
+        """Documents directory tied to the user."""
 
     @property
     @abstractmethod
     def user_downloads_dir(self) -> str:
-        """:return: downloads directory tied to the user"""
+        """Downloads directory tied to the user."""
 
     @property
     @abstractmethod
     def user_pictures_dir(self) -> str:
-        """:return: pictures directory tied to the user"""
+        """Pictures directory tied to the user."""
 
     @property
     @abstractmethod
     def user_videos_dir(self) -> str:
-        """:return: videos directory tied to the user"""
+        """Videos directory tied to the user."""
 
     @property
     @abstractmethod
     def user_music_dir(self) -> str:
-        """:return: music directory tied to the user"""
+        """Music directory tied to the user."""
 
     @property
     @abstractmethod
     def user_desktop_dir(self) -> str:
-        """:return: desktop directory tied to the user"""
+        """Desktop directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def user_projects_dir(self) -> str:
+        """Projects directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def user_publicshare_dir(self) -> str:
+        """Public share directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def user_templates_dir(self) -> str:
+        """Templates directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def user_fonts_dir(self) -> str:
+        """Fonts directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def user_preference_dir(self) -> str:
+        """Preference directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def user_bin_dir(self) -> str:
+        """Bin directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def site_bin_dir(self) -> str:
+        """Bin directory shared by users."""
+
+    @property
+    @abstractmethod
+    def user_applications_dir(self) -> str:
+        """Applications directory tied to the user."""
+
+    @property
+    @abstractmethod
+    def site_applications_dir(self) -> str:
+        """Applications directory shared by users."""
+
+    @property
+    def _site_applications_dirs(self) -> list[str]:
+        return [self.site_applications_dir]
 
     @property
     @abstractmethod
     def user_runtime_dir(self) -> str:
-        """:return: runtime directory tied to the user"""
+        """Runtime directory tied to the user."""
 
     @property
     @abstractmethod
     def site_runtime_dir(self) -> str:
-        """:return: runtime directory shared by users"""
+        """Runtime directory shared by users."""
 
     @property
     def user_data_path(self) -> Path:
-        """:return: data path tied to the user"""
+        """Data path tied to the user."""
         return Path(self.user_data_dir)
 
     @property
     def site_data_path(self) -> Path:
-        """:return: data path shared by users"""
-        return Path(self.site_data_dir)
+        """Data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``."""
+        return self._first_site_dir_as_path(self._site_data_dirs)
 
     @property
     def user_config_path(self) -> Path:
-        """:return: config path tied to the user"""
+        """Config path tied to the user."""
         return Path(self.user_config_dir)
 
     @property
     def site_config_path(self) -> Path:
-        """:return: config path shared by the users"""
-        return Path(self.site_config_dir)
+        """Config path shared by users. Only return the first item, even if ``multipath`` is set to ``True``."""
+        return self._first_site_dir_as_path(self._site_config_dirs)
 
     @property
     def user_cache_path(self) -> Path:
-        """:return: cache path tied to the user"""
+        """Cache path tied to the user."""
         return Path(self.user_cache_dir)
 
     @property
     def site_cache_path(self) -> Path:
-        """:return: cache path shared by users"""
-        return Path(self.site_cache_dir)
+        """Cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``."""
+        return self._first_site_dir_as_path(self._site_cache_dirs)
 
     @property
     def user_state_path(self) -> Path:
-        """:return: state path tied to the user"""
+        """State path tied to the user."""
         return Path(self.user_state_dir)
 
+    @property
+    def site_state_path(self) -> Path:
+        """State path shared by users."""
+        return Path(self.site_state_dir)
+
     @property
     def user_log_path(self) -> Path:
-        """:return: log path tied to the user"""
+        """Log path tied to the user."""
         return Path(self.user_log_dir)
 
+    @property
+    def site_log_path(self) -> Path:
+        """Log path shared by users."""
+        return Path(self.site_log_dir)
+
     @property
     def user_documents_path(self) -> Path:
-        """:return: documents a path tied to the user"""
+        """Documents path tied to the user."""
         return Path(self.user_documents_dir)
 
     @property
     def user_downloads_path(self) -> Path:
-        """:return: downloads path tied to the user"""
+        """Downloads path tied to the user."""
         return Path(self.user_downloads_dir)
 
     @property
     def user_pictures_path(self) -> Path:
-        """:return: pictures path tied to the user"""
+        """Pictures path tied to the user."""
         return Path(self.user_pictures_dir)
 
     @property
     def user_videos_path(self) -> Path:
-        """:return: videos path tied to the user"""
+        """Videos path tied to the user."""
         return Path(self.user_videos_dir)
 
     @property
     def user_music_path(self) -> Path:
-        """:return: music path tied to the user"""
+        """Music path tied to the user."""
         return Path(self.user_music_dir)
 
     @property
     def user_desktop_path(self) -> Path:
-        """:return: desktop path tied to the user"""
+        """Desktop path tied to the user."""
         return Path(self.user_desktop_dir)
 
+    @property
+    def user_projects_path(self) -> Path:
+        """Projects path tied to the user."""
+        return Path(self.user_projects_dir)
+
+    @property
+    def user_publicshare_path(self) -> Path:
+        """Public share path tied to the user."""
+        return Path(self.user_publicshare_dir)
+
+    @property
+    def user_templates_path(self) -> Path:
+        """Templates path tied to the user."""
+        return Path(self.user_templates_dir)
+
+    @property
+    def user_fonts_path(self) -> Path:
+        """Fonts path tied to the user."""
+        return Path(self.user_fonts_dir)
+
+    @property
+    def user_preference_path(self) -> Path:
+        """Preference path tied to the user."""
+        return Path(self.user_preference_dir)
+
+    @property
+    def user_bin_path(self) -> Path:
+        """Bin path tied to the user."""
+        return Path(self.user_bin_dir)
+
+    @property
+    def site_bin_path(self) -> Path:
+        """Bin path shared by users."""
+        return Path(self.site_bin_dir)
+
+    @property
+    def user_applications_path(self) -> Path:
+        """Applications path tied to the user."""
+        return Path(self.user_applications_dir)
+
+    @property
+    def site_applications_path(self) -> Path:
+        """Applications path shared by users. Only return the first item, even if ``multipath`` is set to ``True``."""
+        return Path(self._site_applications_dirs[0])
+
     @property
     def user_runtime_path(self) -> Path:
-        """:return: runtime path tied to the user"""
+        """Runtime path tied to the user."""
         return Path(self.user_runtime_dir)
 
     @property
     def site_runtime_path(self) -> Path:
-        """:return: runtime path shared by users"""
+        """Runtime path shared by users."""
         return Path(self.site_runtime_dir)
 
     def iter_config_dirs(self) -> Iterator[str]:
         """:yield: all user and site configuration directories."""
-        yield self.user_config_dir
-        yield self.site_config_dir
+        yield from _unique(self._iter_config_dirs())
+
+    def _iter_config_dirs(self) -> Iterator[str]:
+        if not self._use_site:
+            yield self.user_config_dir
+        yield from self._create_as_yielded(self._site_config_dirs)
 
     def iter_data_dirs(self) -> Iterator[str]:
         """:yield: all user and site data directories."""
-        yield self.user_data_dir
-        yield self.site_data_dir
+        yield from _unique(self._iter_data_dirs())
+
+    def _iter_data_dirs(self) -> Iterator[str]:
+        if not self._use_site:
+            yield self.user_data_dir
+        yield from self._create_as_yielded(self._site_data_dirs)
 
     def iter_cache_dirs(self) -> Iterator[str]:
         """:yield: all user and site cache directories."""
-        yield self.user_cache_dir
-        yield self.site_cache_dir
+        yield from _unique(self._iter_cache_dirs())
+
+    def _iter_cache_dirs(self) -> Iterator[str]:
+        if not self._use_site:
+            yield self.user_cache_dir
+        yield from self._create_as_yielded(self._site_cache_dirs)
+
+    def iter_state_dirs(self) -> Iterator[str]:
+        """:yield: all user and site state directories."""
+        yield from _unique(self._iter_state_dirs())
+
+    def _iter_state_dirs(self) -> Iterator[str]:
+        if not self._use_site:
+            yield self.user_state_dir
+        yield self.site_state_dir
+
+    def iter_log_dirs(self) -> Iterator[str]:
+        """:yield: all user and site log directories."""
+        yield from _unique(self._iter_log_dirs())
+
+    def _iter_log_dirs(self) -> Iterator[str]:
+        if not self._use_site:
+            yield self.user_log_dir
+        yield self.site_log_dir
 
     def iter_runtime_dirs(self) -> Iterator[str]:
         """:yield: all user and site runtime directories."""
+        yield from _unique(self._iter_runtime_dirs())
+
+    def _iter_runtime_dirs(self) -> Iterator[str]:
         yield self.user_runtime_dir
-        yield self.site_runtime_dir
+        # Root's user runtime dir is already the site one; site_runtime_dir reads the invoking user's XDG_RUNTIME_DIR.
+        if not self._use_site:
+            yield self.site_runtime_dir
+
+    @property
+    def _use_site(self) -> bool:
+        # Only Unix redirects root's user dirs to the site ones. The iterators then skip the user dir, since under
+        # multipath it is the joined site string that _unique cannot match against any single entry.
+        return False
 
     def iter_config_paths(self) -> Iterator[Path]:
         """:yield: all user and site configuration paths."""
@@ -293,7 +539,187 @@ class PlatformDirsABC(ABC):  # noqa: PLR0904
         for path in self.iter_cache_dirs():
             yield Path(path)
 
+    def iter_state_paths(self) -> Iterator[Path]:
+        """:yield: all user and site state paths."""
+        for path in self.iter_state_dirs():
+            yield Path(path)
+
+    def iter_log_paths(self) -> Iterator[Path]:
+        """:yield: all user and site log paths."""
+        for path in self.iter_log_dirs():
+            yield Path(path)
+
     def iter_runtime_paths(self) -> Iterator[Path]:
         """:yield: all user and site runtime paths."""
         for path in self.iter_runtime_dirs():
             yield Path(path)
+
+    def place_config_file(self, name: str | os.PathLike[str]) -> Path:
+        """Return the path of ``name`` under `user_config_path`, creating the missing directories on the way.
+
+        Each directory it creates, including the user directory itself, gets mode ``0o700`` whether or not
+        `ensure_exists` is set; directories that already exist keep their mode. On Unix, root with `use_site_for_root`
+        places the file under the site directory instead and creates the missing directories with the default mode, so
+        other users can read them. It does not create the file.
+
+        :param name: file path relative to the user directory, e.g. ``"sub/app.toml"``.
+
+        :raises ValueError: if ``name`` is empty, absolute, has a drive or climbs out through ``..``.
+        :raises RuntimeError: if the user directory starts with ``~`` because the home directory is unknown.
+
+        """
+        return self._place_file(lambda dirs: dirs.user_config_path, name)
+
+    def place_data_file(self, name: str | os.PathLike[str]) -> Path:
+        """Like `place_config_file`, under `user_data_path`."""
+        return self._place_file(lambda dirs: dirs.user_data_path, name)
+
+    def place_cache_file(self, name: str | os.PathLike[str]) -> Path:
+        """Like `place_config_file`, under `user_cache_path`."""
+        return self._place_file(lambda dirs: dirs.user_cache_path, name)
+
+    def place_state_file(self, name: str | os.PathLike[str]) -> Path:
+        """Like `place_config_file`, under `user_state_path`."""
+        return self._place_file(lambda dirs: dirs.user_state_path, name)
+
+    def place_log_file(self, name: str | os.PathLike[str]) -> Path:
+        """Like `place_config_file`, under `user_log_path`."""
+        return self._place_file(lambda dirs: dirs.user_log_path, name)
+
+    def place_runtime_file(self, name: str | os.PathLike[str]) -> Path:
+        """Like `place_config_file`, under `user_runtime_path`.
+
+        :raises PermissionError: on Unix, if another user owns the temporary fallback directory.
+
+        """
+        return self._place_file(lambda dirs: dirs.user_runtime_path, name)
+
+    def _place_file(self, user_path: Callable[[PlatformDirsABC], Path], name: str | os.PathLike[str]) -> Path:
+        _ensure_inside_base("name", relative := os.fspath(name))
+        if not Path(relative).parts:
+            msg = f"name must point to a file, got {relative!r}"
+            raise ValueError(msg)
+        # Under ensure_exists the lookup itself would create the user directory with the default mode, not 0o700.
+        (lookup := copy(self)).ensure_exists = False
+        # Under multipath *_dir joins the site directories with os.pathsep, so place under the single *_path.
+        _ensure_home_known(str(directory := user_path(lookup)))
+        path = directory / relative
+        if self._use_site:
+            # Site directories keep the default mode, as under ensure_exists, so other users can still read them.
+            path.parent.mkdir(parents=True, exist_ok=True)
+        else:
+            _make_private_directories(path.parent)
+        return path
+
+    def find_config_file(self, name: str | os.PathLike[str]) -> Path | None:
+        """Find the first ``name`` file in :meth:`iter_config_paths` order, without creating any directory.
+
+        :param name: path relative to each directory, may contain subdirectories.
+
+        :returns: the file, or ``None`` when no directory holds one.
+
+        :raises ValueError: if ``name`` is absolute, has a drive or climbs out with ``..``.
+
+        """
+        return next(self._find_files(PlatformDirsABC.iter_config_paths, name), None)
+
+    def find_config_files(self, name: str | os.PathLike[str]) -> list[Path]:
+        """Find every ``name`` file in :meth:`iter_config_paths` order, without creating any directory.
+
+        :param name: see :meth:`find_config_file`.
+
+        :returns: the files, user directory first.
+
+        :raises ValueError: see :meth:`find_config_file`.
+
+        """
+        return list(self._find_files(PlatformDirsABC.iter_config_paths, name))
+
+    def find_data_file(self, name: str | os.PathLike[str]) -> Path | None:
+        """Like :meth:`find_config_file`, searching :meth:`iter_data_paths`."""
+        return next(self._find_files(PlatformDirsABC.iter_data_paths, name), None)
+
+    def find_data_files(self, name: str | os.PathLike[str]) -> list[Path]:
+        """Like :meth:`find_config_files`, searching :meth:`iter_data_paths`."""
+        return list(self._find_files(PlatformDirsABC.iter_data_paths, name))
+
+    def find_cache_file(self, name: str | os.PathLike[str]) -> Path | None:
+        """Like :meth:`find_config_file`, searching :meth:`iter_cache_paths`."""
+        return next(self._find_files(PlatformDirsABC.iter_cache_paths, name), None)
+
+    def find_cache_files(self, name: str | os.PathLike[str]) -> list[Path]:
+        """Like :meth:`find_config_files`, searching :meth:`iter_cache_paths`."""
+        return list(self._find_files(PlatformDirsABC.iter_cache_paths, name))
+
+    def find_state_file(self, name: str | os.PathLike[str]) -> Path | None:
+        """Like :meth:`find_config_file`, searching :meth:`iter_state_paths`."""
+        return next(self._find_files(PlatformDirsABC.iter_state_paths, name), None)
+
+    def find_state_files(self, name: str | os.PathLike[str]) -> list[Path]:
+        """Like :meth:`find_config_files`, searching :meth:`iter_state_paths`."""
+        return list(self._find_files(PlatformDirsABC.iter_state_paths, name))
+
+    def find_log_file(self, name: str | os.PathLike[str]) -> Path | None:
+        """Like :meth:`find_config_file`, searching :meth:`iter_log_paths`."""
+        return next(self._find_files(PlatformDirsABC.iter_log_paths, name), None)
+
+    def find_log_files(self, name: str | os.PathLike[str]) -> list[Path]:
+        """Like :meth:`find_config_files`, searching :meth:`iter_log_paths`."""
+        return list(self._find_files(PlatformDirsABC.iter_log_paths, name))
+
+    def find_runtime_file(self, name: str | os.PathLike[str]) -> Path | None:
+        """Like :meth:`find_config_file`, searching :meth:`iter_runtime_paths`."""
+        return next(self._find_files(PlatformDirsABC.iter_runtime_paths, name), None)
+
+    def find_runtime_files(self, name: str | os.PathLike[str]) -> list[Path]:
+        """Like :meth:`find_config_files`, searching :meth:`iter_runtime_paths`."""
+        return list(self._find_files(PlatformDirsABC.iter_runtime_paths, name))
+
+    def _find_files(
+        self, iter_paths: Callable[[PlatformDirsABC], Iterator[Path]], name: str | os.PathLike[str]
+    ) -> Iterator[Path]:
+        _ensure_inside_base("name", relative := os.fspath(name))
+        # The iterators create each directory they yield under ensure_exists, and a lookup must only read the disk.
+        (lookup := copy(self)).ensure_exists = False
+        return (path for directory in iter_paths(lookup) if (path := directory / relative).is_file())
+
+
+def _ensure_inside_base(name: str, value: str | Literal[False] | None) -> None:
+    if not value:
+        return
+    # os.path.join discards the base when a later component has a root or a drive, and ``..`` climbs out of it.
+    drive, tail = os.path.splitdrive(value)
+    if drive or tail.startswith(("/", "\\")) or ".." in tail.replace("\\", "/").split("/"):
+        msg = f"{name} must stay inside the base directory, got {value!r}"
+        raise ValueError(msg)
+
+
+def _ensure_home_known(path: str) -> None:
+    # expanduser leaves "~" when the home is unknown, and creating it would make a "~" directory in the cwd.
+    if path.startswith("~"):
+        msg = f"could not determine the home directory, refusing to create {path!r}"
+        raise RuntimeError(msg)
+
+
+def _unique(dirs: Iterable[str]) -> Iterator[str]:
+    """:yield: ``dirs`` in order, skipping any directory already yielded."""
+    # Lazy on purpose: under ensure_exists reading a site_*_dir creates it, so draining ``dirs`` up front would
+    # create directories for a caller that stops after the first entry.
+    seen: set[str] = set()
+    for path in dirs:
+        if path not in seen:
+            seen.add(path)
+            yield path
+
+
+def _make_private_directories(path: Path) -> None:
+    # XDG asks for 0o700 on each directory created on the way, while Path.mkdir(parents=True) applies it to the last.
+    try:
+        path.mkdir(mode=0o700, exist_ok=True)
+    except FileNotFoundError:
+        _make_private_directories(path.parent)
+        path.mkdir(mode=0o700, exist_ok=True)
+
+
+class RuntimeDirWarning(UserWarning):
+    """Emitted when the Unix :attr:`~platformdirs.unix.Unix.user_runtime_dir` cannot use ``$XDG_RUNTIME_DIR``."""
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/macos.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/macos.py
index 30ab368..f6b40d2 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/macos.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/macos.py
@@ -2,145 +2,203 @@
 
 from __future__ import annotations
 
-import os.path
+import re
 import sys
-from typing import TYPE_CHECKING
+from typing import Final
 
+from ._xdg import XDGMixin, _expand_user
 from .api import PlatformDirsABC
 
-if TYPE_CHECKING:
-    from pathlib import Path
 
+class _MacOSDefaults(PlatformDirsABC):  # ruff:ignore[too-many-public-methods]
+    """Default platform directories for macOS without XDG environment variable overrides.
 
-class MacOS(PlatformDirsABC):
-    """
-    Platform directories for the macOS operating system.
-
-    Follows the guidance from
-    `Apple documentation `_.
-    Makes use of the `appname `,
-    `version `,
-    `ensure_exists `.
+    Follows the guidance from `Apple's File System Programming Guide
+    `_.
+    The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`.
 
     """
 
+    def _base_user_app_support_dir(self) -> str:
+        return self._append_app_name_and_version(_expand_user("~/Library/Application Support"), private=True)
+
+    def _base_site_dirs(self) -> list[str]:
+        path_list = [self._join_app_name_and_version(f"{prefix}/share")] if (prefix := _homebrew_prefix()) else []
+        path_list.append(self._join_app_name_and_version("/Library/Application Support"))
+        return path_list
+
     @property
     def user_data_dir(self) -> str:
-        """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``"""
-        return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support"))  # noqa: PTH111
+        """Data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``."""
+        return self._base_user_app_support_dir()
 
     @property
-    def site_data_dir(self) -> str:
-        """
-        :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``.
-          If we're using a Python binary managed by `Homebrew `_, the directory
-          will be under the Homebrew prefix, e.g. ``$homebrew_prefix/share/$appname/$version``.
-          If `multipath ` is enabled, and we're in Homebrew,
-          the response is a multi-path string separated by ":", e.g.
-          ``$homebrew_prefix/share/$appname/$version:/Library/Application Support/$appname/$version``
-        """
-        is_homebrew = "/opt/python" in sys.prefix
-        homebrew_prefix = sys.prefix.split("/opt/python")[0] if is_homebrew else ""
-        path_list = [self._append_app_name_and_version(f"{homebrew_prefix}/share")] if is_homebrew else []
-        path_list.append(self._append_app_name_and_version("/Library/Application Support"))
-        if self.multipath:
-            return os.pathsep.join(path_list)
-        return path_list[0]
-
-    @property
-    def site_data_path(self) -> Path:
-        """:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
-        return self._first_item_as_path_if_multipath(self.site_data_dir)
+    def _site_data_dirs(self) -> list[str]:
+        return self._base_site_dirs()
 
     @property
     def user_config_dir(self) -> str:
-        """:return: config directory tied to the user, same as `user_data_dir`"""
-        return self.user_data_dir
+        """Config directory tied to the user, same as `user_data_dir`."""
+        return self._base_user_app_support_dir()
 
     @property
-    def site_config_dir(self) -> str:
-        """:return: config directory shared by the users, same as `site_data_dir`"""
-        return self.site_data_dir
+    def _site_config_dirs(self) -> list[str]:
+        return self._base_site_dirs()
 
     @property
     def user_cache_dir(self) -> str:
-        """:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``"""
-        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches"))  # noqa: PTH111
+        """Cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``."""
+        return self._append_app_name_and_version(_expand_user("~/Library/Caches"), private=True)
+
+    @property
+    def _site_cache_dirs(self) -> list[str]:
+        path_list = [self._join_app_name_and_version(f"{prefix}/var/cache")] if (prefix := _homebrew_prefix()) else []
+        path_list.append(self._join_app_name_and_version("/Library/Caches"))
+        return path_list
 
     @property
     def site_cache_dir(self) -> str:
-        """
-        :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``.
-          If we're using a Python binary managed by `Homebrew `_, the directory
-          will be under the Homebrew prefix, e.g. ``$homebrew_prefix/var/cache/$appname/$version``.
-          If `multipath ` is enabled, and we're in Homebrew,
-          the response is a multi-path string separated by ":", e.g.
-          ``$homebrew_prefix/var/cache/$appname/$version:/Library/Caches/$appname/$version``
-        """
-        is_homebrew = "/opt/python" in sys.prefix
-        homebrew_prefix = sys.prefix.split("/opt/python")[0] if is_homebrew else ""
-        path_list = [self._append_app_name_and_version(f"{homebrew_prefix}/var/cache")] if is_homebrew else []
-        path_list.append(self._append_app_name_and_version("/Library/Caches"))
-        if self.multipath:
-            return os.pathsep.join(path_list)
-        return path_list[0]
-
-    @property
-    def site_cache_path(self) -> Path:
-        """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
-        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+        """Cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``. If we're using a Python binary managed by `Homebrew `_, the directory will be under the Homebrew prefix, e.g. ``$homebrew_prefix/var/cache/$appname/$version``. If `multipath ` is enabled, and we're in Homebrew, the response is a multi-path string separated by ":", e.g. ``$homebrew_prefix/var/cache/$appname/$version:/Library/Caches/$appname/$version``."""
+        return self._select_site_dirs(self._site_cache_dirs)
 
     @property
     def user_state_dir(self) -> str:
-        """:return: state directory tied to the user, same as `user_data_dir`"""
-        return self.user_data_dir
+        """State directory tied to the user, same as `user_data_dir` without ``$XDG_DATA_HOME``, e.g. ``~/Library/Application Support/$appname/$version``."""
+        return self._base_user_app_support_dir()
+
+    @property
+    def site_state_dir(self) -> str:
+        """State directory shared by users, the first entry of `site_data_dir` without ``$XDG_DATA_DIRS``, ignoring `multipath `."""
+        path = self._base_site_dirs()[0]
+        self._optionally_create_directory(path, private=False)
+        return path
 
     @property
     def user_log_dir(self) -> str:
-        """:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``"""
-        return self._append_app_name_and_version(os.path.expanduser("~/Library/Logs"))  # noqa: PTH111
+        """Log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``."""
+        return self._append_app_name_and_version(_expand_user("~/Library/Logs"), private=True)
+
+    @property
+    def site_log_dir(self) -> str:
+        """Log directory shared by users, e.g. ``/Library/Logs/$appname/$version``."""
+        return self._append_app_name_and_version("/Library/Logs", private=False)
 
     @property
     def user_documents_dir(self) -> str:
-        """:return: documents directory tied to the user, e.g. ``~/Documents``"""
-        return os.path.expanduser("~/Documents")  # noqa: PTH111
+        """Documents directory tied to the user, e.g. ``~/Documents``."""
+        return _expand_user("~/Documents")
 
     @property
     def user_downloads_dir(self) -> str:
-        """:return: downloads directory tied to the user, e.g. ``~/Downloads``"""
-        return os.path.expanduser("~/Downloads")  # noqa: PTH111
+        """Downloads directory tied to the user, e.g. ``~/Downloads``."""
+        return _expand_user("~/Downloads")
 
     @property
     def user_pictures_dir(self) -> str:
-        """:return: pictures directory tied to the user, e.g. ``~/Pictures``"""
-        return os.path.expanduser("~/Pictures")  # noqa: PTH111
+        """Pictures directory tied to the user, e.g. ``~/Pictures``."""
+        return _expand_user("~/Pictures")
 
     @property
     def user_videos_dir(self) -> str:
-        """:return: videos directory tied to the user, e.g. ``~/Movies``"""
-        return os.path.expanduser("~/Movies")  # noqa: PTH111
+        """Videos directory tied to the user, e.g. ``~/Movies``."""
+        return _expand_user("~/Movies")
 
     @property
     def user_music_dir(self) -> str:
-        """:return: music directory tied to the user, e.g. ``~/Music``"""
-        return os.path.expanduser("~/Music")  # noqa: PTH111
+        """Music directory tied to the user, e.g. ``~/Music``."""
+        return _expand_user("~/Music")
 
     @property
     def user_desktop_dir(self) -> str:
-        """:return: desktop directory tied to the user, e.g. ``~/Desktop``"""
-        return os.path.expanduser("~/Desktop")  # noqa: PTH111
+        """Desktop directory tied to the user, e.g. ``~/Desktop``."""
+        return _expand_user("~/Desktop")
+
+    @property
+    def user_projects_dir(self) -> str:
+        """Projects directory tied to the user, e.g. ``~/Projects``."""
+        return _expand_user("~/Projects")
+
+    @property
+    def user_publicshare_dir(self) -> str:
+        """Public share directory tied to the user, e.g. ``~/Public``."""
+        return _expand_user("~/Public")
+
+    @property
+    def user_templates_dir(self) -> str:
+        """Templates directory tied to the user, e.g. ``~/Templates``."""
+        return _expand_user("~/Templates")
+
+    @property
+    def user_fonts_dir(self) -> str:
+        """Fonts directory tied to the user, e.g. ``~/Library/Fonts``."""
+        return _expand_user("~/Library/Fonts")
+
+    @property
+    def user_preference_dir(self) -> str:
+        """Preference directory tied to the user, e.g. ``~/Library/Preferences/AppName``."""
+        return self._append_app_name_and_version(_expand_user("~/Library/Preferences"), private=True)
+
+    @property
+    def user_bin_dir(self) -> str:
+        """Bin directory tied to the user, e.g. ``~/.local/bin``."""
+        return _expand_user("~/.local/bin")
+
+    @property
+    def site_bin_dir(self) -> str:
+        """Bin directory shared by users, e.g. ``/usr/local/bin``."""
+        return "/usr/local/bin"
+
+    @property
+    def user_applications_dir(self) -> str:
+        """Applications directory tied to the user, e.g. ``~/Applications``."""
+        return _expand_user("~/Applications")
+
+    @property
+    def _site_applications_dirs(self) -> list[str]:
+        return ["/Applications"]
 
     @property
     def user_runtime_dir(self) -> str:
-        """:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``"""
-        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches/TemporaryItems"))  # noqa: PTH111
+        """Runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``."""
+        return self._append_app_name_and_version(_expand_user("~/Library/Caches/TemporaryItems"), private=True)
 
     @property
     def site_runtime_dir(self) -> str:
-        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        """Runtime directory shared by users, same as `user_runtime_dir`."""
         return self.user_runtime_dir
 
 
+class MacOS(XDGMixin, _MacOSDefaults):
+    """Platform directories for the macOS operating system.
+
+    Follows the guidance from `Apple documentation
+    `_.
+    Makes use of the `appname `, `version
+    `, `ensure_exists `.
+
+    XDG environment variables (e.g. ``$XDG_DATA_HOME``) are supported and take precedence over macOS defaults.
+
+    """
+
+
+# Homebrew links each Python formula as a framework build, and a virtual environment keeps it as sys.base_prefix.
+_HOMEBREW_PYTHON: Final = re.compile(
+    r"""
+    (?P.+)                 # $HOMEBREW_PREFIX, such as /opt/homebrew or /usr/local
+    /opt/python[^/]*               # formula link: python, python3 or python@3.13
+    /Frameworks/Python\.framework  # framework build
+    /Versions/[^/]+                # interpreter version, such as 3.13
+    """,
+    re.VERBOSE,
+)
+
+
+def _homebrew_prefix() -> str | None:
+    if match := _HOMEBREW_PYTHON.fullmatch(sys.base_prefix):
+        return match["prefix"]
+    return None
+
+
 __all__ = [
     "MacOS",
 ]
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/unix.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/unix.py
index fc75d8d..7130527 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/unix.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/unix.py
@@ -3,15 +3,17 @@
 from __future__ import annotations
 
 import os
+import re
+import stat
 import sys
-from configparser import ConfigParser
+import warnings
+from contextlib import suppress
 from pathlib import Path
-from typing import TYPE_CHECKING, NoReturn
+from tempfile import gettempdir
+from typing import Final, NoReturn
 
-from .api import PlatformDirsABC
-
-if TYPE_CHECKING:
-    from collections.abc import Iterator
+from ._xdg import XDGMixin, _expand_user, _xdg_dir
+from .api import PlatformDirsABC, RuntimeDirWarning
 
 if sys.platform == "win32":
 
@@ -23,10 +25,197 @@ else:
     from os import getuid
 
 
-class Unix(PlatformDirsABC):  # noqa: PLR0904
+class _UnixDefaults(PlatformDirsABC):  # ruff:ignore[too-many-public-methods]
+    """Default directories for Unix/Linux without XDG environment variable overrides.
+
+    The XDG env var handling is in :class:`~platformdirs._xdg.XDGMixin`.
+
     """
-    On Unix/Linux, we follow the `XDG Basedir Spec `_.
+
+    @property
+    def _use_site(self) -> bool:
+        return self.use_site_for_root and getuid() == 0
+
+    @property
+    def user_data_dir(self) -> str:
+        """Data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or ``$XDG_DATA_HOME/$appname/$version``."""
+        return self._append_app_name_and_version(_expand_user("~/.local/share"), private=True)
+
+    @property
+    def _site_data_dirs(self) -> list[str]:
+        return [self._join_app_name_and_version("/usr/local/share"), self._join_app_name_and_version("/usr/share")]
+
+    @property
+    def user_config_dir(self) -> str:
+        """Config directory tied to the user, e.g. ``~/.config/$appname/$version`` or ``$XDG_CONFIG_HOME/$appname/$version``."""
+        return self._append_app_name_and_version(_expand_user("~/.config"), private=True)
+
+    @property
+    def _site_config_dirs(self) -> list[str]:
+        return [self._join_app_name_and_version("/etc/xdg")]
+
+    @property
+    def user_cache_dir(self) -> str:
+        """Cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or ``$XDG_CACHE_HOME/$appname/$version``."""
+        return self._append_app_name_and_version(_expand_user("~/.cache"), private=True)
+
+    @property
+    def site_cache_dir(self) -> str:
+        """Cache directory shared by users, e.g. ``/var/cache/$appname/$version``."""
+        return self._append_app_name_and_version("/var/cache", private=False)
+
+    @property
+    def user_state_dir(self) -> str:
+        """State directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or ``$XDG_STATE_HOME/$appname/$version``."""
+        return self._append_app_name_and_version(_expand_user("~/.local/state"), private=True)
+
+    @property
+    def site_state_dir(self) -> str:
+        """State directory shared by users, e.g. ``/var/lib/$appname/$version``."""
+        return self._append_app_name_and_version("/var/lib", private=False)
+
+    @property
+    def user_log_dir(self) -> str:
+        """Log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it."""
+        path = self.user_state_dir
+        if self.opinion:
+            path = os.path.join(path, "log")  # ruff:ignore[os-path-join]
+            self._optionally_create_directory(path, private=True)
+        return path
+
+    @property
+    def site_log_dir(self) -> str:
+        """Log directory shared by users, e.g. ``/var/log/$appname/$version``.
+
+        Unlike `user_log_dir`, ``opinion`` has no effect since ``/var/log`` is inherently a log directory.
+
+        """
+        return self._append_app_name_and_version("/var/log", private=False)
+
+    @property
+    def user_documents_dir(self) -> str:
+        """Documents directory tied to the user, e.g. ``~/Documents``."""
+        return self._user_media_dir("XDG_DOCUMENTS_DIR", "~/Documents")
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """Downloads directory tied to the user, e.g. ``~/Downloads``."""
+        return self._user_media_dir("XDG_DOWNLOAD_DIR", "~/Downloads")
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """Pictures directory tied to the user, e.g. ``~/Pictures``."""
+        return self._user_media_dir("XDG_PICTURES_DIR", "~/Pictures")
+
+    @property
+    def user_videos_dir(self) -> str:
+        """Videos directory tied to the user, e.g. ``~/Videos``."""
+        return self._user_media_dir("XDG_VIDEOS_DIR", "~/Videos")
+
+    @property
+    def user_music_dir(self) -> str:
+        """Music directory tied to the user, e.g. ``~/Music``."""
+        return self._user_media_dir("XDG_MUSIC_DIR", "~/Music")
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """Desktop directory tied to the user, e.g. ``~/Desktop``."""
+        return self._user_media_dir("XDG_DESKTOP_DIR", "~/Desktop")
+
+    @property
+    def user_projects_dir(self) -> str:
+        """Projects directory tied to the user, e.g. ``~/Projects``."""
+        return self._user_media_dir("XDG_PROJECTS_DIR", "~/Projects")
+
+    @property
+    def user_publicshare_dir(self) -> str:
+        """Public share directory tied to the user, e.g. ``~/Public``."""
+        return self._user_media_dir("XDG_PUBLICSHARE_DIR", "~/Public")
+
+    @property
+    def user_templates_dir(self) -> str:
+        """Templates directory tied to the user, e.g. ``~/Templates``."""
+        return self._user_media_dir("XDG_TEMPLATES_DIR", "~/Templates")
+
+    def _user_media_dir(self, key: str, default: str) -> str:
+        if path := _get_user_dirs_folder(key):
+            self._optionally_create_media_directory(path)
+            return path
+        return _expand_user(default)
+
+    @property
+    def user_fonts_dir(self) -> str:
+        """Fonts directory tied to the user, e.g. ``~/.local/share/fonts``."""
+        return f"{_expand_user('~/.local/share')}/fonts"
+
+    @property
+    def user_preference_dir(self) -> str:
+        """Preference directory tied to the user, same as ``user_config_dir``."""
+        return self.user_config_dir
+
+    @property
+    def user_bin_dir(self) -> str:
+        """Bin directory tied to the user, e.g. ``~/.local/bin``."""
+        return _expand_user("~/.local/bin")
+
+    @property
+    def site_bin_dir(self) -> str:
+        """Bin directory shared by users, e.g. ``/usr/local/bin``."""
+        return "/usr/local/bin"
+
+    @property
+    def user_applications_dir(self) -> str:
+        """Applications directory tied to the user, e.g. ``~/.local/share/applications``."""
+        return f"{_expand_user('~/.local/share')}{os.sep}applications"
+
+    @property
+    def _site_applications_dirs(self) -> list[str]:
+        return [os.path.join(p, "applications") for p in ["/usr/local/share", "/usr/share"]]  # ruff:ignore[os-path-join]
+
+    def _default_runtime_dir(self) -> str:
+        if sys.platform.startswith("openbsd"):
+            path = f"/tmp/run/user/{getuid()}"  # ruff:ignore[hardcoded-temp-file]
+        elif sys.platform.startswith(("freebsd", "netbsd")):
+            path = f"/var/run/user/{getuid()}"
+        else:
+            path = f"/run/user/{getuid()}"
+        return path if os.path.lexists(path) and not _runtime_dir_problem(path) else self._temp_runtime_dir()
+
+    def _temp_runtime_dir(self) -> str:
+        # Another user can pre-create this predictable name, and XDG requires an owned runtime dir with mode 0700.
+        path = f"{gettempdir()}/runtime-{getuid()}"
+        with suppress(FileExistsError):
+            self._optionally_create_directory(path, private=True)
+        if problem := _runtime_dir_problem(path, check_mode=False):
+            msg = f"runtime directory {problem}; set XDG_RUNTIME_DIR instead"
+            raise PermissionError(msg)
+        # Earlier releases created this directory with the default 0755.
+        if self.ensure_exists:
+            Path(path).chmod(_RUNTIME_DIR_MODE)
+        return path
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """Runtime directory shared by users, e.g. ``/run/$appname/$version`` or ``$XDG_RUNTIME_DIR/$appname/$version``.
+
+        Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will fall back
+        to paths associated to the root user instead of a regular logged-in user if it's not set.
+
+        If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir`
+        instead.
+
+        For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set.
+
+        """
+        if sys.platform.startswith(("freebsd", "openbsd", "netbsd")):
+            path = "/var/run"
+        else:
+            path = "/run"
+        return self._append_app_name_and_version(path, private=False)
+
+
+class Unix(XDGMixin, _UnixDefaults):
+    """On Unix/Linux, we follow the `XDG Basedir Spec `_.
 
     The spec allows overriding directories with environment variables. The examples shown are the default values,
     alongside the name of the environment variable that overrides them. Makes use of the `appname
@@ -38,233 +227,164 @@ class Unix(PlatformDirsABC):  # noqa: PLR0904
 
     @property
     def user_data_dir(self) -> str:
-        """
-        :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or
-         ``$XDG_DATA_HOME/$appname/$version``
-        """
-        path = os.environ.get("XDG_DATA_HOME", "")
-        if not path.strip():
-            path = os.path.expanduser("~/.local/share")  # noqa: PTH111
-        return self._append_app_name_and_version(path)
-
-    @property
-    def _site_data_dirs(self) -> list[str]:
-        path = os.environ.get("XDG_DATA_DIRS", "")
-        if not path.strip():
-            path = f"/usr/local/share{os.pathsep}/usr/share"
-        return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)]
-
-    @property
-    def site_data_dir(self) -> str:
-        """
-        :return: data directories shared by users (if `multipath ` is
-         enabled and ``XDG_DATA_DIRS`` is set and a multi path the response is also a multi path separated by the
-         OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version``
-        """
-        # XDG default for $XDG_DATA_DIRS; only first, if multipath is False
-        dirs = self._site_data_dirs
-        if not self.multipath:
-            return dirs[0]
-        return os.pathsep.join(dirs)
+        """Data directory tied to the user, or site equivalent when root with ``use_site_for_root``."""
+        return self.site_data_dir if self._use_site else super().user_data_dir
 
     @property
     def user_config_dir(self) -> str:
-        """
-        :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or
-         ``$XDG_CONFIG_HOME/$appname/$version``
-        """
-        path = os.environ.get("XDG_CONFIG_HOME", "")
-        if not path.strip():
-            path = os.path.expanduser("~/.config")  # noqa: PTH111
-        return self._append_app_name_and_version(path)
-
-    @property
-    def _site_config_dirs(self) -> list[str]:
-        path = os.environ.get("XDG_CONFIG_DIRS", "")
-        if not path.strip():
-            path = "/etc/xdg"
-        return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)]
-
-    @property
-    def site_config_dir(self) -> str:
-        """
-        :return: config directories shared by users (if `multipath `
-         is enabled and ``XDG_CONFIG_DIRS`` is set and a multi path the response is also a multi path separated by
-         the OS path separator), e.g. ``/etc/xdg/$appname/$version``
-        """
-        # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False
-        dirs = self._site_config_dirs
-        if not self.multipath:
-            return dirs[0]
-        return os.pathsep.join(dirs)
+        """Config directory tied to the user, or site equivalent when root with ``use_site_for_root``."""
+        return self.site_config_dir if self._use_site else super().user_config_dir
 
     @property
     def user_cache_dir(self) -> str:
-        """
-        :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or
-         ``~/$XDG_CACHE_HOME/$appname/$version``
-        """
-        path = os.environ.get("XDG_CACHE_HOME", "")
-        if not path.strip():
-            path = os.path.expanduser("~/.cache")  # noqa: PTH111
-        return self._append_app_name_and_version(path)
-
-    @property
-    def site_cache_dir(self) -> str:
-        """:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``"""
-        return self._append_app_name_and_version("/var/cache")
+        """Cache directory tied to the user, or site equivalent when root with ``use_site_for_root``."""
+        return self.site_cache_dir if self._use_site else super().user_cache_dir
 
     @property
     def user_state_dir(self) -> str:
-        """
-        :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or
-         ``$XDG_STATE_HOME/$appname/$version``
-        """
-        path = os.environ.get("XDG_STATE_HOME", "")
-        if not path.strip():
-            path = os.path.expanduser("~/.local/state")  # noqa: PTH111
-        return self._append_app_name_and_version(path)
+        """State directory tied to the user, or site equivalent when root with ``use_site_for_root``."""
+        return self.site_state_dir if self._use_site else super().user_state_dir
 
     @property
     def user_log_dir(self) -> str:
-        """:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it"""
-        path = self.user_state_dir
-        if self.opinion:
-            path = os.path.join(path, "log")  # noqa: PTH118
-            self._optionally_create_directory(path)
-        return path
+        """Log directory tied to the user, or site equivalent when root with ``use_site_for_root``."""
+        return self.site_log_dir if self._use_site else super().user_log_dir
 
     @property
-    def user_documents_dir(self) -> str:
-        """:return: documents directory tied to the user, e.g. ``~/Documents``"""
-        return _get_user_media_dir("XDG_DOCUMENTS_DIR", "~/Documents")
-
-    @property
-    def user_downloads_dir(self) -> str:
-        """:return: downloads directory tied to the user, e.g. ``~/Downloads``"""
-        return _get_user_media_dir("XDG_DOWNLOAD_DIR", "~/Downloads")
-
-    @property
-    def user_pictures_dir(self) -> str:
-        """:return: pictures directory tied to the user, e.g. ``~/Pictures``"""
-        return _get_user_media_dir("XDG_PICTURES_DIR", "~/Pictures")
-
-    @property
-    def user_videos_dir(self) -> str:
-        """:return: videos directory tied to the user, e.g. ``~/Videos``"""
-        return _get_user_media_dir("XDG_VIDEOS_DIR", "~/Videos")
-
-    @property
-    def user_music_dir(self) -> str:
-        """:return: music directory tied to the user, e.g. ``~/Music``"""
-        return _get_user_media_dir("XDG_MUSIC_DIR", "~/Music")
-
-    @property
-    def user_desktop_dir(self) -> str:
-        """:return: desktop directory tied to the user, e.g. ``~/Desktop``"""
-        return _get_user_media_dir("XDG_DESKTOP_DIR", "~/Desktop")
+    def user_applications_dir(self) -> str:
+        """Applications directory tied to the user, or site equivalent when root with ``use_site_for_root``."""
+        return self.site_applications_dir if self._use_site else super().user_applications_dir
 
     @property
     def user_runtime_dir(self) -> str:
-        """
-        :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or
-         ``$XDG_RUNTIME_DIR/$appname/$version``.
+        """Runtime directory tied to the user, e.g. ``$XDG_RUNTIME_DIR/$appname/$version``.
+
+        Accepts ``$XDG_RUNTIME_DIR`` only as a directory, not a symlink, that the user owns with mode ``0700``, as the
+        XDG spec requires, and creates a missing one that way under ``ensure_exists``. When the variable is unset or
+        fails that check, emits one :class:`~platformdirs.RuntimeDirWarning` per cause and falls back to the platform
+        default (``/tmp/run/user/`` on OpenBSD, ``/var/run/user/`` on FreeBSD/NetBSD, ``/run/user/``
+        elsewhere) if it passes the same check, else to ``runtime-`` in the temporary directory. Root with
+        ``use_site_for_root`` gets the site equivalent.
+
+        :raises PermissionError: if the temporary fallback is a symlink, not a directory, or owned by another user.
 
-         For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if
-         exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR``
-         is not set.
         """
-        path = os.environ.get("XDG_RUNTIME_DIR", "")
-        if not path.strip():
-            if sys.platform.startswith(("freebsd", "openbsd", "netbsd")):
-                path = f"/var/run/user/{getuid()}"
-                if not Path(path).exists():
-                    path = f"/tmp/runtime-{getuid()}"  # noqa: S108
-            else:
-                path = f"/run/user/{getuid()}"
-        return self._append_app_name_and_version(path)
+        if self._use_site:
+            # XDGMixin.site_runtime_dir reads $XDG_RUNTIME_DIR, which belongs to the user who started the root process.
+            return super(XDGMixin, self).site_runtime_dir
+        if not (path := _xdg_dir("XDG_RUNTIME_DIR")):
+            reason = "XDG_RUNTIME_DIR is not set"
+        else:
+            with suppress(OSError):
+                self._optionally_create_directory(path, private=True)
+            if not (problem := _runtime_dir_problem(path)):
+                return self._append_app_name_and_version(path, private=True)
+            reason = f"XDG_RUNTIME_DIR {problem}"
+        _warn_once(f"{reason}, falling back to {(fallback := self._default_runtime_dir())}")
+        return self._append_app_name_and_version(fallback, private=True)
 
     @property
-    def site_runtime_dir(self) -> str:
-        """
-        :return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or \
-        ``$XDG_RUNTIME_DIR/$appname/$version``.
-
-        Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will
-        fall back to paths associated to the root user instead of a regular logged-in user if it's not set.
-
-        If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir`
-        instead.
-
-        For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set.
-        """
-        path = os.environ.get("XDG_RUNTIME_DIR", "")
-        if not path.strip():
-            if sys.platform.startswith(("freebsd", "openbsd", "netbsd")):
-                path = "/var/run"
-            else:
-                path = "/run"
-        return self._append_app_name_and_version(path)
+    def user_bin_dir(self) -> str:
+        """Bin directory tied to the user, or site equivalent when root with ``use_site_for_root``."""
+        return self.site_bin_dir if self._use_site else super().user_bin_dir
 
     @property
-    def site_data_path(self) -> Path:
-        """:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
-        return self._first_item_as_path_if_multipath(self.site_data_dir)
+    def user_data_path(self) -> Path:
+        """Data path tied to the user, or the first site entry when root with ``use_site_for_root``."""
+        return self.site_data_path if self._use_site else super().user_data_path
 
     @property
-    def site_config_path(self) -> Path:
-        """:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``"""
-        return self._first_item_as_path_if_multipath(self.site_config_dir)
+    def user_config_path(self) -> Path:
+        """Config path tied to the user, or the first site entry when root with ``use_site_for_root``."""
+        return self.site_config_path if self._use_site else super().user_config_path
 
     @property
-    def site_cache_path(self) -> Path:
-        """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
-        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+    def user_preference_path(self) -> Path:
+        """Preference path tied to the user, or the first site config entry when root with ``use_site_for_root``."""
+        return self.site_config_path if self._use_site else super().user_preference_path
 
-    def iter_config_dirs(self) -> Iterator[str]:
-        """:yield: all user and site configuration directories."""
-        yield self.user_config_dir
-        yield from self._site_config_dirs
-
-    def iter_data_dirs(self) -> Iterator[str]:
-        """:yield: all user and site data directories."""
-        yield self.user_data_dir
-        yield from self._site_data_dirs
+    @property
+    def user_applications_path(self) -> Path:
+        """Applications path tied to the user, or the first site entry when root with ``use_site_for_root``."""
+        return self.site_applications_path if self._use_site else super().user_applications_path
 
 
-def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str:
-    media_dir = _get_user_dirs_folder(env_var)
-    if media_dir is None:
-        media_dir = os.environ.get(env_var, "").strip()
-        if not media_dir:
-            media_dir = os.path.expanduser(fallback_tilde_path)  # noqa: PTH111
-
-    return media_dir
+_USER_DIRS_LINE: Final = re.compile(
+    r"""
+    [ \t]*(?P\w+)[ \t]*=[ \t]*  # KEY=, blanks allowed around the key and after the =
+    (?:
+        "(?P(?:[^"\\]|\\.)*)"  # a double-quoted value with backslash escapes, text after it ignored
+        |(?P[^"\s].*?)          # or an unquoted value, up to
+        (?:[ \t]+\#.*|[ \t]*)$         # a comment, which sh starts at a word-initial #, or the line end
+    )
+    """,
+    re.VERBOSE,
+)
 
 
 def _get_user_dirs_folder(key: str) -> str | None:
-    """
-    Return directory from user-dirs.dirs config file.
+    """Return directory from user-dirs.dirs config file.
+
+    ``xdg-user-dirs-update`` writes shell assignments, so match each line like ``xdg-user-dir`` does and keep the last
+    valid assignment to ``key``.
 
     See https://freedesktop.org/wiki/Software/xdg-user-dirs/.
 
     """
-    user_dirs_config_path = Path(Unix().user_config_dir) / "user-dirs.dirs"
-    if user_dirs_config_path.exists():
-        parser = ConfigParser()
+    config_home = _xdg_dir("XDG_CONFIG_HOME") or _expand_user("~/.config")
+    user_dirs_config_path = Path(config_home) / "user-dirs.dirs"
+    if not user_dirs_config_path.exists():
+        return None
+    folder = None
+    # the file holds raw path bytes, and surrogateescape round-trips undecodable ones like os.fsdecode
+    with user_dirs_config_path.open(encoding=sys.getfilesystemencoding(), errors="surrogateescape") as stream:
+        for line in stream:
+            if (entry := _USER_DIRS_LINE.match(line)) and entry["key"] == key:
+                folder = _resolve_user_dirs_value(entry) or folder
+    return folder
 
-        with user_dirs_config_path.open() as stream:
-            # Add fake section header, so ConfigParser doesn't complain
-            parser.read_string(f"[top]\n{stream.read()}")
 
-        if key not in parser["top"]:
-            return None
+def _resolve_user_dirs_value(entry: re.Match[str]) -> str | None:
+    value = entry["bare"] if entry["quoted"] is None else entry["quoted"]
+    if value == "$HOME" or value.startswith("$HOME/"):
+        prefix, value = _expand_user("~"), value.removeprefix("$HOME")
+    elif value.startswith("/"):
+        prefix = ""
+    else:
+        return None
+    if entry["quoted"] is not None:
+        # xdg-user-dirs-update backslash-escapes $, `, " and \ inside the quotes.
+        value = re.sub(r"\\(.)", r"\1", value)
+    return prefix + value
 
-        path = parser["top"][key].strip('"')
-        # Handle relative home paths
-        return path.replace("$HOME", os.path.expanduser("~"))  # noqa: PTH111
 
-    return None
+def _runtime_dir_problem(path: str, *, check_mode: bool = True) -> str | None:
+    """Return why ``path`` fails the checks of Qt's ``checkXdgRuntimeDir``, or ``None`` if it passes or is missing."""
+    try:
+        info = os.lstat(path)
+    except FileNotFoundError:
+        return None
+    except OSError as error:
+        return f"{path} cannot be checked: {error.strerror}"
+    mode = info.st_mode & 0o777
+    checks = (
+        (stat.S_ISLNK(info.st_mode), "is a symlink"),
+        (not stat.S_ISDIR(info.st_mode), "is not a directory"),
+        (info.st_uid != (uid := getuid()), f"is owned by uid {info.st_uid}, not {uid}"),
+        (check_mode and mode != _RUNTIME_DIR_MODE, f"has mode {mode:04o}, not {_RUNTIME_DIR_MODE:04o}"),
+    )
+    return next((f"{path} {problem}" for failed, problem in checks if failed), None)
+
+
+def _warn_once(message: str) -> None:
+    # Each read of user_runtime_dir repeats the check, so a warning per read would flood long-running programs.
+    if message not in _WARNED:
+        _WARNED.add(message)
+        warnings.warn(message, RuntimeDirWarning, stacklevel=3)
+
+
+_WARNED: Final[set[str]] = set()
+_RUNTIME_DIR_MODE: Final = 0o700
 
 
 __all__ = [
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/version.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/version.py
index fcf6f03..eb68087 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/version.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/version.py
@@ -1,5 +1,6 @@
-# file generated by setuptools-scm
+# file generated by vcs-versioning
 # don't change, don't track in version control
+from __future__ import annotations
 
 __all__ = [
     "__version__",
@@ -10,25 +11,14 @@ __all__ = [
     "commit_id",
 ]
 
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from typing import Tuple
-    from typing import Union
-
-    VERSION_TUPLE = Tuple[Union[int, str], ...]
-    COMMIT_ID = Union[str, None]
-else:
-    VERSION_TUPLE = object
-    COMMIT_ID = object
-
 version: str
 __version__: str
-__version_tuple__: VERSION_TUPLE
-version_tuple: VERSION_TUPLE
-commit_id: COMMIT_ID
-__commit_id__: COMMIT_ID
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
 
-__version__ = version = '4.5.1'
-__version_tuple__ = version_tuple = (4, 5, 1)
+__version__ = version = '4.12.4'
+__version_tuple__ = version_tuple = (4, 12, 4)
 
 __commit_id__ = commit_id = None
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/windows.py b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/windows.py
index 8d523a9..e587f94 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/windows.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/platformdirs/windows.py
@@ -2,20 +2,24 @@
 
 from __future__ import annotations
 
+import ntpath
 import os
 import sys
-from functools import lru_cache
-from typing import TYPE_CHECKING
+from functools import cache
+from pathlib import Path
+from typing import TYPE_CHECKING, Final
 
 from .api import PlatformDirsABC
 
 if TYPE_CHECKING:
     from collections.abc import Callable
 
+# Not exposed by CPython; defined in the Windows SDK (shlobj_core.h)
+_KF_FLAG_DONT_VERIFY: Final[int] = 0x00004000
 
-class Windows(PlatformDirsABC):
-    """
-    `MSDN on where to store app data files `_.
+
+class Windows(PlatformDirsABC):  # ruff:ignore[too-many-public-methods]
+    """`MSDN on where to store app data files `_.
 
     Makes use of the `appname `, `appauthor
     `, `version `, `roaming
@@ -26,11 +30,7 @@ class Windows(PlatformDirsABC):
 
     @property
     def user_data_dir(self) -> str:
-        """
-        :return: data directory tied to the user, e.g.
-         ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname`` (not roaming) or
-         ``%USERPROFILE%\\AppData\\Roaming\\$appauthor\\$appname`` (roaming)
-        """
+        r"""Data directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\$appauthor\$appname`` (not roaming) or ``%USERPROFILE%\AppData\Roaming\$appauthor\$appname`` (roaming)."""
         const = "CSIDL_APPDATA" if self.roaming else "CSIDL_LOCAL_APPDATA"
         path = os.path.normpath(get_win_folder(const))
         return self._append_parts(path)
@@ -46,97 +46,150 @@ class Windows(PlatformDirsABC):
                 params.append(opinion_value)
             if self.version:
                 params.append(self.version)
-        path = os.path.join(path, *params)  # noqa: PTH118
-        self._optionally_create_directory(path)
+        path = os.path.join(path, *params)  # ruff:ignore[os-path-join]
+        self._optionally_create_directory(path, private=False)
         return path
 
     @property
     def site_data_dir(self) -> str:
-        """:return: data directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname``"""
+        r"""Data directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname``."""
         path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA"))
         return self._append_parts(path)
 
     @property
     def user_config_dir(self) -> str:
-        """:return: config directory tied to the user, same as `user_data_dir`"""
+        """Config directory tied to the user, same as `user_data_dir`."""
         return self.user_data_dir
 
     @property
     def site_config_dir(self) -> str:
-        """:return: config directory shared by the users, same as `site_data_dir`"""
+        """Config directory shared by users, same as `site_data_dir`."""
         return self.site_data_dir
 
     @property
     def user_cache_dir(self) -> str:
-        """
-        :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g.
-         ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname\\Cache\\$version``
-        """
+        r"""Cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g. ``%USERPROFILE%\AppData\Local\$appauthor\$appname\Cache\$version``."""
         path = os.path.normpath(get_win_folder("CSIDL_LOCAL_APPDATA"))
         return self._append_parts(path, opinion_value="Cache")
 
     @property
     def site_cache_dir(self) -> str:
-        """:return: cache directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname\\Cache\\$version``"""
+        r"""Cache directory shared by users, e.g. ``C:\ProgramData\$appauthor\$appname\Cache\$version``."""
         path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA"))
         return self._append_parts(path, opinion_value="Cache")
 
     @property
     def user_state_dir(self) -> str:
-        """:return: state directory tied to the user, same as `user_data_dir`"""
+        """State directory tied to the user, same as `user_data_dir`."""
         return self.user_data_dir
 
+    @property
+    def site_state_dir(self) -> str:
+        """State directory shared by users, same as `site_data_dir`."""
+        return self.site_data_dir
+
     @property
     def user_log_dir(self) -> str:
-        """:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it"""
+        """Log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it."""
         path = self.user_data_dir
         if self.opinion:
-            path = os.path.join(path, "Logs")  # noqa: PTH118
-            self._optionally_create_directory(path)
+            path = os.path.join(path, "Logs")  # ruff:ignore[os-path-join]
+            self._optionally_create_directory(path, private=False)
+        return path
+
+    @property
+    def site_log_dir(self) -> str:
+        """Log directory shared by users, same as `site_data_dir` if not opinionated else ``Logs`` in it."""
+        path = self.site_data_dir
+        if self.opinion:
+            path = os.path.join(path, "Logs")  # ruff:ignore[os-path-join]
+            self._optionally_create_directory(path, private=False)
         return path
 
     @property
     def user_documents_dir(self) -> str:
-        """:return: documents directory tied to the user e.g. ``%USERPROFILE%\\Documents``"""
+        r"""Documents directory tied to the user e.g. ``%USERPROFILE%\Documents``."""
         return os.path.normpath(get_win_folder("CSIDL_PERSONAL"))
 
     @property
     def user_downloads_dir(self) -> str:
-        """:return: downloads directory tied to the user e.g. ``%USERPROFILE%\\Downloads``"""
+        r"""Downloads directory tied to the user e.g. ``%USERPROFILE%\Downloads``."""
         return os.path.normpath(get_win_folder("CSIDL_DOWNLOADS"))
 
     @property
     def user_pictures_dir(self) -> str:
-        """:return: pictures directory tied to the user e.g. ``%USERPROFILE%\\Pictures``"""
+        r"""Pictures directory tied to the user e.g. ``%USERPROFILE%\Pictures``."""
         return os.path.normpath(get_win_folder("CSIDL_MYPICTURES"))
 
     @property
     def user_videos_dir(self) -> str:
-        """:return: videos directory tied to the user e.g. ``%USERPROFILE%\\Videos``"""
+        r"""Videos directory tied to the user e.g. ``%USERPROFILE%\Videos``."""
         return os.path.normpath(get_win_folder("CSIDL_MYVIDEO"))
 
     @property
     def user_music_dir(self) -> str:
-        """:return: music directory tied to the user e.g. ``%USERPROFILE%\\Music``"""
+        r"""Music directory tied to the user e.g. ``%USERPROFILE%\Music``."""
         return os.path.normpath(get_win_folder("CSIDL_MYMUSIC"))
 
     @property
     def user_desktop_dir(self) -> str:
-        """:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\\Desktop``"""
+        r"""Desktop directory tied to the user, e.g. ``%USERPROFILE%\Desktop``."""
         return os.path.normpath(get_win_folder("CSIDL_DESKTOPDIRECTORY"))
 
+    @property
+    def user_projects_dir(self) -> str:
+        r"""Projects directory tied to the user, e.g. ``%USERPROFILE%\Projects``."""
+        return os.path.normpath(os.path.expanduser("~/Projects"))  # ruff:ignore[os-path-expanduser]
+
+    @property
+    def user_publicshare_dir(self) -> str:
+        r"""Public share directory e.g. ``C:\Users\Public``."""
+        return os.path.normpath(get_win_folder("CSIDL_PUBLIC"))
+
+    @property
+    def user_templates_dir(self) -> str:
+        r"""Templates directory tied to the user e.g. ``%APPDATA%\Microsoft\Windows\Templates``."""
+        return os.path.normpath(get_win_folder("CSIDL_TEMPLATES"))
+
+    @property
+    def user_fonts_dir(self) -> str:
+        r"""Fonts directory tied to the user e.g. ``%LOCALAPPDATA%\Microsoft\Windows\Fonts``."""
+        return os.path.normpath(str(Path(get_win_folder("CSIDL_LOCAL_APPDATA")) / "Microsoft" / "Windows" / "Fonts"))
+
+    @property
+    def user_preference_dir(self) -> str:
+        r"""Preference directory tied to the user, same as ``user_config_dir``."""
+        return self.user_config_dir
+
+    @property
+    def user_bin_dir(self) -> str:
+        r"""Bin directory tied to the user, e.g. ``%LOCALAPPDATA%\Programs``."""
+        return os.path.normpath(get_win_folder("CSIDL_USER_PROGRAM_FILES"))
+
+    @property
+    def site_bin_dir(self) -> str:
+        r"""Bin directory shared by users, e.g. ``C:\ProgramData\bin``."""
+        return os.path.normpath(os.path.join(get_win_folder("CSIDL_COMMON_APPDATA"), "bin"))  # ruff:ignore[os-path-join]
+
+    @property
+    def user_applications_dir(self) -> str:
+        r"""Applications directory tied to the user, e.g. ``Start Menu\Programs``."""
+        return os.path.normpath(get_win_folder("CSIDL_PROGRAMS"))
+
+    @property
+    def site_applications_dir(self) -> str:
+        r"""Applications directory shared by users, e.g. ``C:\ProgramData\Microsoft\Windows\Start Menu\Programs``."""
+        return os.path.normpath(get_win_folder("CSIDL_COMMON_PROGRAMS"))
+
     @property
     def user_runtime_dir(self) -> str:
-        """
-        :return: runtime directory tied to the user, e.g.
-         ``%USERPROFILE%\\AppData\\Local\\Temp\\$appauthor\\$appname``
-        """
-        path = os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Temp"))  # noqa: PTH118
+        r"""Runtime directory tied to the user, e.g. ``%USERPROFILE%\AppData\Local\Temp\$appauthor\$appname``."""
+        path = os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Temp"))  # ruff:ignore[os-path-join]
         return self._append_parts(path)
 
     @property
     def site_runtime_dir(self) -> str:
-        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        """Runtime directory shared by users, same as `user_runtime_dir`."""
         return self.user_runtime_dir
 
 
@@ -154,8 +207,7 @@ def get_win_folder_from_env_vars(csidl_name: str) -> str:
     if env_var_name is None:
         msg = f"Unknown CSIDL name: {csidl_name}"
         raise ValueError(msg)
-    result = os.environ.get(env_var_name)
-    if result is None:
+    if not (result := os.environ.get(env_var_name)):
         msg = f"Unset environment variable: {env_var_name}"
         raise ValueError(msg)
     return result
@@ -163,26 +215,45 @@ def get_win_folder_from_env_vars(csidl_name: str) -> str:
 
 def get_win_folder_if_csidl_name_not_env_var(csidl_name: str) -> str | None:
     """Get a folder for a CSIDL name that does not exist as an environment variable."""
-    if csidl_name == "CSIDL_PERSONAL":
-        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Documents")  # noqa: PTH118
+    if (env_var_and_parts := _ENV_VAR_SUBFOLDERS.get(csidl_name)) is not None:
+        env_var, *parts = env_var_and_parts
+        return os.path.join(os.path.normpath(_non_empty_env(env_var)), *parts)  # ruff:ignore[os-path-join]
 
-    if csidl_name == "CSIDL_DOWNLOADS":
-        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Downloads")  # noqa: PTH118
+    if csidl_name == "CSIDL_PUBLIC":
+        return os.environ.get("PUBLIC") or str(Path("~").expanduser().parent / "Public")
 
-    if csidl_name == "CSIDL_MYPICTURES":
-        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Pictures")  # noqa: PTH118
-
-    if csidl_name == "CSIDL_MYVIDEO":
-        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Videos")  # noqa: PTH118
-
-    if csidl_name == "CSIDL_MYMUSIC":
-        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Music")  # noqa: PTH118
+    if csidl_name == "CSIDL_COMMON_PROGRAMS":
+        return os.path.join(  # ruff:ignore[os-path-join]
+            os.path.normpath(os.environ.get("PROGRAMDATA") or os.environ.get("ALLUSERSPROFILE") or "C:\\ProgramData"),
+            "Microsoft",
+            "Windows",
+            "Start Menu",
+            "Programs",
+        )
     return None
 
 
+_ENV_VAR_SUBFOLDERS: Final[dict[str, tuple[str, ...]]] = {
+    "CSIDL_PERSONAL": ("USERPROFILE", "Documents"),
+    "CSIDL_DOWNLOADS": ("USERPROFILE", "Downloads"),
+    "CSIDL_MYPICTURES": ("USERPROFILE", "Pictures"),
+    "CSIDL_MYVIDEO": ("USERPROFILE", "Videos"),
+    "CSIDL_MYMUSIC": ("USERPROFILE", "Music"),
+    "CSIDL_DESKTOPDIRECTORY": ("USERPROFILE", "Desktop"),
+    "CSIDL_PROGRAMS": ("APPDATA", "Microsoft", "Windows", "Start Menu", "Programs"),
+    "CSIDL_TEMPLATES": ("APPDATA", "Microsoft", "Windows", "Templates"),
+    "CSIDL_USER_PROGRAM_FILES": ("LOCALAPPDATA", "Programs"),
+}
+
+
+def _non_empty_env(name: str) -> str:
+    if value := os.environ.get(name):
+        return value
+    raise KeyError(name)  # same error os.environ[name] gives for an unset variable
+
+
 def get_win_folder_from_registry(csidl_name: str) -> str:
-    """
-    Get folder from the registry.
+    """Get folder from the registry.
 
     This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer
     for all CSIDL_* names.
@@ -190,6 +261,7 @@ def get_win_folder_from_registry(csidl_name: str) -> str:
     """
     machine_names = {
         "CSIDL_COMMON_APPDATA",
+        "CSIDL_COMMON_PROGRAMS",
     }
     shell_folder_name = {
         "CSIDL_APPDATA": "AppData",
@@ -200,78 +272,147 @@ def get_win_folder_from_registry(csidl_name: str) -> str:
         "CSIDL_MYPICTURES": "My Pictures",
         "CSIDL_MYVIDEO": "My Video",
         "CSIDL_MYMUSIC": "My Music",
+        "CSIDL_DESKTOPDIRECTORY": "Desktop",
+        "CSIDL_PROGRAMS": "Programs",
+        "CSIDL_COMMON_PROGRAMS": "Common Programs",
+        "CSIDL_TEMPLATES": "Templates",
     }.get(csidl_name)
     if shell_folder_name is None:
-        msg = f"Unknown CSIDL name: {csidl_name}"
-        raise ValueError(msg)
+        return get_win_folder_from_env_vars(csidl_name)
     if sys.platform != "win32":  # only needed for mypy type checker to know that this code runs only on Windows
         raise NotImplementedError
-    import winreg  # noqa: PLC0415
+    import winreg  # ruff:ignore[import-outside-top-level]
 
     # Use HKEY_LOCAL_MACHINE for system-wide folders, HKEY_CURRENT_USER for user-specific folders
     hkey = winreg.HKEY_LOCAL_MACHINE if csidl_name in machine_names else winreg.HKEY_CURRENT_USER
 
-    key = winreg.OpenKey(hkey, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders")
-    directory, _ = winreg.QueryValueEx(key, shell_folder_name)
+    with winreg.OpenKey(hkey, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders") as key:
+        directory, _ = winreg.QueryValueEx(key, shell_folder_name)
     return str(directory)
 
 
+_KNOWN_FOLDER_GUIDS: dict[str, str] = {
+    "CSIDL_APPDATA": "{3EB685DB-65F9-4CF6-A03A-E3EF65729F3D}",
+    "CSIDL_COMMON_APPDATA": "{62AB5D82-FDC1-4DC3-A9DD-070D1D495D97}",
+    "CSIDL_LOCAL_APPDATA": "{F1B32785-6FBA-4FCF-9D55-7B8E7F157091}",
+    "CSIDL_PERSONAL": "{FDD39AD0-238F-46AF-ADB4-6C85480369C7}",
+    "CSIDL_MYPICTURES": "{33E28130-4E1E-4676-835A-98395C3BC3BB}",
+    "CSIDL_MYVIDEO": "{18989B1D-99B5-455B-841C-AB7C74E4DDFC}",
+    "CSIDL_MYMUSIC": "{4BD8D571-6D19-48D3-BE97-422220080E43}",
+    "CSIDL_DOWNLOADS": "{374DE290-123F-4565-9164-39C4925E467B}",
+    "CSIDL_DESKTOPDIRECTORY": "{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}",
+    "CSIDL_PROGRAMS": "{A77F5D77-2E2B-44C3-A6A2-ABA601054A51}",
+    "CSIDL_COMMON_PROGRAMS": "{0139D44E-6AFE-49F2-8690-3DAFCAE6FFB8}",
+    "CSIDL_TEMPLATES": "{A63293E8-664E-48DB-A079-DF759E0509F7}",
+    "CSIDL_PUBLIC": "{DFDF76A2-C82A-4D63-906A-5644AC457385}",
+    "CSIDL_USER_PROGRAM_FILES": "{5CD7AEE2-2219-4A67-B85D-6C9CE15660CB}",
+}
+
+
+@cache
+def _build_get_win_folder_via_ctypes() -> Callable[[str], str]:
+    """Build the resolver once; a fresh ``_GUID`` per call leaks ctypes pointer types.
+
+    See https://github.com/tox-dev/platformdirs/issues/501.
+
+    """
+    if sys.platform != "win32":  # only needed for type checker to know that this code runs only on Windows
+        raise NotImplementedError
+    from ctypes import (  # ruff:ignore[import-outside-top-level]
+        HRESULT,
+        POINTER,
+        Structure,
+        WinDLL,
+        byref,
+        wintypes,
+    )
+
+    class _GUID(Structure):
+        _fields_ = [
+            ("Data1", wintypes.DWORD),
+            ("Data2", wintypes.WORD),
+            ("Data3", wintypes.WORD),
+            ("Data4", wintypes.BYTE * 8),
+        ]
+
+    ole32 = WinDLL("ole32")
+    ole32.CLSIDFromString.restype = HRESULT
+    ole32.CLSIDFromString.argtypes = [wintypes.LPCOLESTR, POINTER(_GUID)]
+    ole32.CoTaskMemFree.restype = None
+    ole32.CoTaskMemFree.argtypes = [wintypes.LPVOID]
+
+    shell32 = WinDLL("shell32")
+    shell32.SHGetKnownFolderPath.restype = HRESULT
+    shell32.SHGetKnownFolderPath.argtypes = [POINTER(_GUID), wintypes.DWORD, wintypes.HANDLE, POINTER(wintypes.LPWSTR)]
+
+    def resolve(csidl_name: str) -> str:
+        folder_guid = _KNOWN_FOLDER_GUIDS.get(csidl_name)
+        if folder_guid is None:
+            msg = f"Unknown CSIDL name: {csidl_name}"
+            raise ValueError(msg)
+
+        guid = _GUID()
+        ole32.CLSIDFromString(folder_guid, byref(guid))
+
+        path_ptr = wintypes.LPWSTR()
+        shell32.SHGetKnownFolderPath(byref(guid), _KF_FLAG_DONT_VERIFY, None, byref(path_ptr))
+        result = path_ptr.value
+        ole32.CoTaskMemFree(path_ptr)
+
+        if result is None:
+            msg = f"SHGetKnownFolderPath returned NULL for {csidl_name}"
+            raise ValueError(msg)
+
+        return result
+
+    return resolve
+
+
 def get_win_folder_via_ctypes(csidl_name: str) -> str:
-    """Get folder with ctypes."""
-    # There is no 'CSIDL_DOWNLOADS'.
-    # Use 'CSIDL_PROFILE' (40) and append the default folder 'Downloads' instead.
-    # https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid
+    """Get folder via :func:`SHGetKnownFolderPath`.
 
-    import ctypes  # noqa: PLC0415
+    See https://learn.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetknownfolderpath.
 
-    csidl_const = {
-        "CSIDL_APPDATA": 26,
-        "CSIDL_COMMON_APPDATA": 35,
-        "CSIDL_LOCAL_APPDATA": 28,
-        "CSIDL_PERSONAL": 5,
-        "CSIDL_MYPICTURES": 39,
-        "CSIDL_MYVIDEO": 14,
-        "CSIDL_MYMUSIC": 13,
-        "CSIDL_DOWNLOADS": 40,
-        "CSIDL_DESKTOPDIRECTORY": 16,
-    }.get(csidl_name)
-    if csidl_const is None:
-        msg = f"Unknown CSIDL name: {csidl_name}"
-        raise ValueError(msg)
-
-    buf = ctypes.create_unicode_buffer(1024)
-    windll = getattr(ctypes, "windll")  # noqa: B009 # using getattr to avoid false positive with mypy type checker
-    windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)
-
-    # Downgrade to short path name if it has high-bit chars.
-    if any(ord(c) > 255 for c in buf):  # noqa: PLR2004
-        buf2 = ctypes.create_unicode_buffer(1024)
-        if windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
-            buf = buf2
-
-    if csidl_name == "CSIDL_DOWNLOADS":
-        return os.path.join(buf.value, "Downloads")  # noqa: PTH118
-
-    return buf.value
+    """
+    return _build_get_win_folder_via_ctypes()(csidl_name)
 
 
 def _pick_get_win_folder() -> Callable[[str], str]:
+    """Select the best method to resolve Windows folder paths: ctypes, then registry, then environment variables."""
     try:
-        import ctypes  # noqa: PLC0415
+        import ctypes  # ruff:ignore[import-outside-top-level, unused-import]
     except ImportError:
         pass
     else:
-        if hasattr(ctypes, "windll"):
-            return get_win_folder_via_ctypes
+        return get_win_folder_via_ctypes
     try:
-        import winreg  # noqa: PLC0415, F401
+        import winreg  # ruff:ignore[import-outside-top-level, unused-import]
     except ImportError:
         return get_win_folder_from_env_vars
     else:
         return get_win_folder_from_registry
 
 
-get_win_folder = lru_cache(maxsize=None)(_pick_get_win_folder())
+_resolve_win_folder = _pick_get_win_folder()
+
+
+def get_win_folder(csidl_name: str) -> str:
+    """Get a Windows folder path, checking for ``WIN_PD_OVERRIDE_*`` environment variable overrides first.
+
+    For example, ``CSIDL_LOCAL_APPDATA`` can be overridden by setting ``WIN_PD_OVERRIDE_LOCAL_APPDATA``.
+
+    """
+    env_var = f"WIN_PD_OVERRIDE_{csidl_name.removeprefix('CSIDL_')}"
+    if _is_fully_qualified(override := os.environ.get(env_var, "").strip()):
+        return override
+    return _resolve_win_folder(csidl_name)
+
+
+def _is_fully_qualified(path: str) -> bool:
+    # ntpath.isabs changed for rooted paths without a drive in 3.13 and for a bare UNC share in 3.11
+    drive, tail = ntpath.splitdrive(path)
+    return drive.startswith(("\\", "/")) or (bool(drive) and tail.startswith(("\\", "/")))
+
 
 __all__ = [
     "Windows",
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__init__.py
index cb229c9..6d919b0 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__init__.py
@@ -21,12 +21,12 @@
     .. _Pygments master branch:
        https://github.com/pygments/pygments/archive/master.zip#egg=Pygments-dev
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 from io import StringIO, BytesIO
 
-__version__ = '2.19.2'
+__version__ = '2.21.0'
 __docformat__ = 'restructuredtext'
 
 __all__ = ['lex', 'format', 'highlight']
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__main__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__main__.py
index a2e612f..bdafd1a 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__main__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/__main__.py
@@ -4,7 +4,7 @@
 
     Main entry point for ``python -m pygments``.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/console.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/console.py
index ee1ac27..d900916 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/console.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/console.py
@@ -4,7 +4,7 @@
 
     Format colored console output.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filter.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filter.py
index 5efff43..6c926c2 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filter.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filter.py
@@ -4,7 +4,7 @@
 
     Module that implements the default filter.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filters/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filters/__init__.py
index 97380c9..01e3207 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filters/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/filters/__init__.py
@@ -5,7 +5,7 @@
     Module containing filter lookup functions and default
     filters.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
@@ -95,8 +95,10 @@ class CodeTagFilter(Filter):
 
 
 class SymbolFilter(Filter):
-    """Convert mathematical symbols such as \\ in Isabelle
-    or \\longrightarrow in LaTeX into Unicode characters.
+    """Convert mathematical symbols into Unicode characters.
+
+    Examples are ``\\`` in Isabelle or
+    ``\\longrightarrow`` in LaTeX.
 
     This is mostly useful for HTML or console output when you want to
     approximate the source rendering you'd see in an IDE.
@@ -685,8 +687,9 @@ class SymbolFilter(Filter):
 
 
 class KeywordCaseFilter(Filter):
-    """Convert keywords to lowercase or uppercase or capitalize them, which
-    means first letter uppercase, rest lowercase.
+    """Convert keywords to lowercase or uppercase or capitalize them.
+
+    This means first letter uppercase, rest lowercase.
 
     This can be useful e.g. if you highlight Pascal code and want to adapt the
     code to your styleguide.
@@ -866,7 +869,7 @@ class VisibleWhitespaceFilter(Filter):
 
 
 class GobbleFilter(Filter):
-    """Gobbles source code lines (eats initial characters).
+    """Gobble source code lines (eats initial characters).
 
     This filter drops the first ``n`` characters off every line of code.  This
     may be useful when the source code fed to the lexer is indented by a fixed
@@ -905,8 +908,7 @@ class GobbleFilter(Filter):
 
 
 class TokenMergeFilter(Filter):
-    """Merges consecutive tokens with the same token type in the output
-    stream of a lexer.
+    """Merge consecutive tokens with the same token type in the output stream.
 
     .. versionadded:: 1.2
     """
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatter.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatter.py
index 0041e41..d869b6c 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatter.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatter.py
@@ -4,7 +4,7 @@
 
     Base formatter class.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatters/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatters/__init__.py
index 014f2ee..c7c153b 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatters/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/formatters/__init__.py
@@ -4,7 +4,7 @@
 
     Pygments formatters.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexer.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexer.py
index c05aa81..e9c5759 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexer.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexer.py
@@ -4,7 +4,7 @@
 
     Base lexer classes.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
@@ -336,7 +336,7 @@ class include(str):  # pylint: disable=invalid-name
 
 class _inherit:
     """
-    Indicates the a state should inherit from its superclass.
+    Indicates that a state should inherit from its superclass.
     """
     def __repr__(self):
         return 'inherit'
@@ -446,8 +446,9 @@ def using(_other, **kwargs):
             # function has to create a new lexer instance
             if kwargs:
                 # XXX: cache that somehow
-                kwargs.update(lexer.options)
-                lx = lexer.__class__(**kwargs)
+                d = dict(lexer.options)
+                d.update(kwargs)
+                lx = lexer.__class__(**d)
             else:
                 lx = lexer
             s = match.start()
@@ -458,8 +459,9 @@ def using(_other, **kwargs):
     else:
         def callback(lexer, match, ctx=None):
             # XXX: cache that somehow
-            kwargs.update(lexer.options)
-            lx = _other(**kwargs)
+            d = dict(lexer.options)
+            d.update(kwargs)
+            lx = _other(**d)
 
             s = match.start()
             for i, t, v in lx.get_tokens_unprocessed(match.group(), **gt_kwargs):
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/__init__.py
index 49184ec..7dcb103 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/__init__.py
@@ -4,7 +4,7 @@
 
     Pygments lexers.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/_mapping.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/_mapping.py
index c0d6a8a..db959da 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/_mapping.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/_mapping.py
@@ -53,6 +53,7 @@ LEXERS = {
     'BefungeLexer': ('pip._vendor.pygments.lexers.esoteric', 'Befunge', ('befunge',), ('*.befunge',), ('application/x-befunge',)),
     'BerryLexer': ('pip._vendor.pygments.lexers.berry', 'Berry', ('berry', 'be'), ('*.be',), ('text/x-berry', 'application/x-berry')),
     'BibTeXLexer': ('pip._vendor.pygments.lexers.bibtex', 'BibTeX', ('bibtex', 'bib'), ('*.bib',), ('text/x-bibtex',)),
+    'BitBakeLexer': ('pip._vendor.pygments.lexers.bitbake', 'BitBake', ('bitbake',), ('*.bbclass', '*.bbappend'), ('text/x-bitbake',)),
     'BlitzBasicLexer': ('pip._vendor.pygments.lexers.basic', 'BlitzBasic', ('blitzbasic', 'b3d', 'bplus'), ('*.bb', '*.decls'), ('text/x-bb',)),
     'BlitzMaxLexer': ('pip._vendor.pygments.lexers.basic', 'BlitzMax', ('blitzmax', 'bmax'), ('*.bmx',), ('text/x-bmx',)),
     'BlueprintLexer': ('pip._vendor.pygments.lexers.blueprint', 'Blueprint', ('blueprint',), ('*.blp',), ('text/x-blueprint',)),
@@ -63,6 +64,7 @@ LEXERS = {
     'BrainfuckLexer': ('pip._vendor.pygments.lexers.esoteric', 'Brainfuck', ('brainfuck', 'bf'), ('*.bf', '*.b'), ('application/x-brainfuck',)),
     'BugsLexer': ('pip._vendor.pygments.lexers.modeling', 'BUGS', ('bugs', 'winbugs', 'openbugs'), ('*.bug',), ()),
     'CAmkESLexer': ('pip._vendor.pygments.lexers.esoteric', 'CAmkES', ('camkes', 'idl4'), ('*.camkes', '*.idl4'), ()),
+    'CELLexer': ('pip._vendor.pygments.lexers.cel', 'CEL', ('cel',), ('*.cel',), ()),
     'CLexer': ('pip._vendor.pygments.lexers.c_cpp', 'C', ('c',), ('*.c', '*.h', '*.idc', '*.x[bp]m'), ('text/x-chdr', 'text/x-csrc', 'image/x-xbitmap', 'image/x-xpixmap')),
     'CMakeLexer': ('pip._vendor.pygments.lexers.make', 'CMake', ('cmake',), ('*.cmake', 'CMakeLists.txt'), ('text/x-cmake',)),
     'CObjdumpLexer': ('pip._vendor.pygments.lexers.asm', 'c-objdump', ('c-objdump',), ('*.c-objdump',), ('text/x-c-objdump',)),
@@ -71,6 +73,7 @@ LEXERS = {
     'CSharpAspxLexer': ('pip._vendor.pygments.lexers.dotnet', 'aspx-cs', ('aspx-cs',), ('*.aspx', '*.asax', '*.ascx', '*.ashx', '*.asmx', '*.axd'), ()),
     'CSharpLexer': ('pip._vendor.pygments.lexers.dotnet', 'C#', ('csharp', 'c#', 'cs'), ('*.cs',), ('text/x-csharp',)),
     'Ca65Lexer': ('pip._vendor.pygments.lexers.asm', 'ca65 assembler', ('ca65',), ('*.s',), ()),
+    'CaddyfileLexer': ('pip._vendor.pygments.lexers.configs', 'Caddyfile', ('caddyfile', 'caddy'), ('Caddyfile',), ()),
     'CadlLexer': ('pip._vendor.pygments.lexers.archetype', 'cADL', ('cadl',), ('*.cadl',), ()),
     'CapDLLexer': ('pip._vendor.pygments.lexers.esoteric', 'CapDL', ('capdl',), ('*.cdl',), ()),
     'CapnProtoLexer': ('pip._vendor.pygments.lexers.capnproto', "Cap'n Proto", ('capnp',), ('*.capnp',), ()),
@@ -101,9 +104,8 @@ LEXERS = {
     'Comal80Lexer': ('pip._vendor.pygments.lexers.comal', 'COMAL-80', ('comal', 'comal80'), ('*.cml', '*.comal'), ()),
     'CommonLispLexer': ('pip._vendor.pygments.lexers.lisp', 'Common Lisp', ('common-lisp', 'cl', 'lisp'), ('*.cl', '*.lisp'), ('text/x-common-lisp',)),
     'ComponentPascalLexer': ('pip._vendor.pygments.lexers.oberon', 'Component Pascal', ('componentpascal', 'cp'), ('*.cp', '*.cps'), ('text/x-component-pascal',)),
-    'CoqLexer': ('pip._vendor.pygments.lexers.theorem', 'Coq', ('coq',), ('*.v',), ('text/x-coq',)),
     'CplintLexer': ('pip._vendor.pygments.lexers.cplint', 'cplint', ('cplint',), ('*.ecl', '*.prolog', '*.pro', '*.pl', '*.P', '*.lpad', '*.cpl'), ('text/x-cplint',)),
-    'CppLexer': ('pip._vendor.pygments.lexers.c_cpp', 'C++', ('cpp', 'c++'), ('*.cpp', '*.hpp', '*.c++', '*.h++', '*.cc', '*.hh', '*.cxx', '*.hxx', '*.C', '*.H', '*.cp', '*.CPP', '*.tpp'), ('text/x-c++hdr', 'text/x-c++src')),
+    'CppLexer': ('pip._vendor.pygments.lexers.c_cpp', 'C++', ('cpp', 'c++'), ('*.cpp', '*.hpp', '*.c++', '*.h++', '*.cc', '*.hh', '*.cxx', '*.hxx', '*.C', '*.H', '*.cp', '*.CPP', '*.tpp', '*.cppm', '*.ixx', '*.mxx', '*.ipp'), ('text/x-c++hdr', 'text/x-c++src')),
     'CppObjdumpLexer': ('pip._vendor.pygments.lexers.asm', 'cpp-objdump', ('cpp-objdump', 'c++-objdumb', 'cxx-objdump'), ('*.cpp-objdump', '*.c++-objdump', '*.cxx-objdump'), ('text/x-cpp-objdump',)),
     'CrmshLexer': ('pip._vendor.pygments.lexers.dsls', 'Crmsh', ('crmsh', 'pcmk'), ('*.crmsh', '*.pcmk'), ()),
     'CrocLexer': ('pip._vendor.pygments.lexers.d', 'Croc', ('croc',), ('*.croc',), ('text/x-crocsrc',)),
@@ -168,7 +170,7 @@ LEXERS = {
     'FancyLexer': ('pip._vendor.pygments.lexers.ruby', 'Fancy', ('fancy', 'fy'), ('*.fy', '*.fancypack'), ('text/x-fancysrc',)),
     'FantomLexer': ('pip._vendor.pygments.lexers.fantom', 'Fantom', ('fan',), ('*.fan',), ('application/x-fantom',)),
     'FelixLexer': ('pip._vendor.pygments.lexers.felix', 'Felix', ('felix', 'flx'), ('*.flx', '*.flxh'), ('text/x-felix',)),
-    'FennelLexer': ('pip._vendor.pygments.lexers.lisp', 'Fennel', ('fennel', 'fnl'), ('*.fnl',), ()),
+    'FennelLexer': ('pip._vendor.pygments.lexers.lisp', 'Fennel', ('fennel', 'fnl'), ('*.fnl', '*.fnlm'), ('text/x-fennel',)),
     'FiftLexer': ('pip._vendor.pygments.lexers.fift', 'Fift', ('fift', 'fif'), ('*.fif',), ()),
     'FishShellLexer': ('pip._vendor.pygments.lexers.shell', 'Fish', ('fish', 'fishshell'), ('*.fish', '*.load'), ('application/x-fish',)),
     'FlatlineLexer': ('pip._vendor.pygments.lexers.dsls', 'Flatline', ('flatline',), (), ('text/x-flatline',)),
@@ -254,7 +256,7 @@ LEXERS = {
     'Json5Lexer': ('pip._vendor.pygments.lexers.json5', 'JSON5', ('json5',), ('*.json5',), ()),
     'JsonBareObjectLexer': ('pip._vendor.pygments.lexers.data', 'JSONBareObject', (), (), ()),
     'JsonLdLexer': ('pip._vendor.pygments.lexers.data', 'JSON-LD', ('jsonld', 'json-ld'), ('*.jsonld',), ('application/ld+json',)),
-    'JsonLexer': ('pip._vendor.pygments.lexers.data', 'JSON', ('json', 'json-object'), ('*.json', '*.jsonl', '*.ndjson', 'Pipfile.lock'), ('application/json', 'application/json-object', 'application/x-ndjson', 'application/jsonl', 'application/json-seq')),
+    'JsonLexer': ('pip._vendor.pygments.lexers.data', 'JSON', ('json', 'json-object'), ('*.json', '*.jsonl', '*.ndjson', 'Pipfile.lock', '*.module', '*.xc'), ('application/json', 'application/json-object', 'application/x-ndjson', 'application/jsonl', 'application/json-seq')),
     'JsonnetLexer': ('pip._vendor.pygments.lexers.jsonnet', 'Jsonnet', ('jsonnet',), ('*.jsonnet', '*.libsonnet'), ()),
     'JspLexer': ('pip._vendor.pygments.lexers.templates', 'Java Server Page', ('jsp',), ('*.jsp',), ('application/x-jsp',)),
     'JsxLexer': ('pip._vendor.pygments.lexers.jsx', 'JSX', ('jsx', 'react'), ('*.jsx', '*.react'), ('text/jsx', 'text/typescript-jsx')),
@@ -314,11 +316,11 @@ LEXERS = {
     'MarkdownLexer': ('pip._vendor.pygments.lexers.markup', 'Markdown', ('markdown', 'md'), ('*.md', '*.markdown'), ('text/x-markdown',)),
     'MaskLexer': ('pip._vendor.pygments.lexers.javascript', 'Mask', ('mask',), ('*.mask',), ('text/x-mask',)),
     'MasonLexer': ('pip._vendor.pygments.lexers.templates', 'Mason', ('mason',), ('*.m', '*.mhtml', '*.mc', '*.mi', 'autohandler', 'dhandler'), ('application/x-mason',)),
-    'MathematicaLexer': ('pip._vendor.pygments.lexers.algebra', 'Mathematica', ('mathematica', 'mma', 'nb'), ('*.nb', '*.cdf', '*.nbp', '*.ma'), ('application/mathematica', 'application/vnd.wolfram.mathematica', 'application/vnd.wolfram.mathematica.package', 'application/vnd.wolfram.cdf')),
+    'MathematicaLexer': ('pip._vendor.pygments.lexers.algebra', 'Mathematica', ('mathematica', 'mma', 'nb', 'wl', 'wolfram'), ('*.nb', '*.cdf', '*.nbp', '*.ma', '*.wl', '*.wls'), ('application/mathematica', 'application/vnd.wolfram.mathematica', 'application/vnd.wolfram.mathematica.package', 'application/vnd.wolfram.cdf', 'application/vnd.wolfram.wl')),
     'MatlabLexer': ('pip._vendor.pygments.lexers.matlab', 'Matlab', ('matlab',), ('*.m',), ('text/matlab',)),
     'MatlabSessionLexer': ('pip._vendor.pygments.lexers.matlab', 'Matlab session', ('matlabsession',), (), ()),
     'MaximaLexer': ('pip._vendor.pygments.lexers.maxima', 'Maxima', ('maxima', 'macsyma'), ('*.mac', '*.max'), ()),
-    'MesonLexer': ('pip._vendor.pygments.lexers.meson', 'Meson', ('meson', 'meson.build'), ('meson.build', 'meson_options.txt'), ('text/x-meson',)),
+    'MesonLexer': ('pip._vendor.pygments.lexers.meson', 'Meson', ('meson', 'meson.build'), ('meson.build', 'meson.options', 'meson_options.txt'), ('text/x-meson',)),
     'MiniDLexer': ('pip._vendor.pygments.lexers.d', 'MiniD', ('minid',), (), ('text/x-minidsrc',)),
     'MiniScriptLexer': ('pip._vendor.pygments.lexers.scripting', 'MiniScript', ('miniscript', 'ms'), ('*.ms',), ('text/x-minicript', 'application/x-miniscript')),
     'ModelicaLexer': ('pip._vendor.pygments.lexers.modeling', 'Modelica', ('modelica',), ('*.mo',), ('text/x-modelica',)),
@@ -412,11 +414,12 @@ LEXERS = {
     'PtxLexer': ('pip._vendor.pygments.lexers.ptx', 'PTX', ('ptx',), ('*.ptx',), ('text/x-ptx',)),
     'PugLexer': ('pip._vendor.pygments.lexers.html', 'Pug', ('pug', 'jade'), ('*.pug', '*.jade'), ('text/x-pug', 'text/x-jade')),
     'PuppetLexer': ('pip._vendor.pygments.lexers.dsls', 'Puppet', ('puppet',), ('*.pp',), ()),
+    'PureScriptLexer': ('pip._vendor.pygments.lexers.purescript', 'PureScript', ('purescript', 'purs'), ('*.purs',), ('text/x-purescript',)),
     'PyPyLogLexer': ('pip._vendor.pygments.lexers.console', 'PyPy Log', ('pypylog', 'pypy'), ('*.pypylog',), ('application/x-pypylog',)),
     'Python2Lexer': ('pip._vendor.pygments.lexers.python', 'Python 2.x', ('python2', 'py2'), (), ('text/x-python2', 'application/x-python2')),
     'Python2TracebackLexer': ('pip._vendor.pygments.lexers.python', 'Python 2.x Traceback', ('py2tb',), ('*.py2tb',), ('text/x-python2-traceback',)),
     'PythonConsoleLexer': ('pip._vendor.pygments.lexers.python', 'Python console session', ('pycon', 'python-console'), (), ('text/x-python-doctest',)),
-    'PythonLexer': ('pip._vendor.pygments.lexers.python', 'Python', ('python', 'py', 'sage', 'python3', 'py3', 'bazel', 'starlark', 'pyi'), ('*.py', '*.pyw', '*.pyi', '*.jy', '*.sage', '*.sc', 'SConstruct', 'SConscript', '*.bzl', 'BUCK', 'BUILD', 'BUILD.bazel', 'WORKSPACE', '*.tac'), ('text/x-python', 'application/x-python', 'text/x-python3', 'application/x-python3')),
+    'PythonLexer': ('pip._vendor.pygments.lexers.python', 'Python', ('python', 'py', 'sage', 'python3', 'py3', 'bazel', 'starlark', 'pyi'), ('*.py', '*.pyw', '*.pyi', '*.jy', '*.sage', '*.sc', 'SConstruct', 'SConscript', '*.bzl', 'BUCK', 'BUILD', 'BUILD.bazel', 'WORKSPACE', '*.tac', '*.pye'), ('text/x-python', 'application/x-python', 'text/x-python3', 'application/x-python3')),
     'PythonTracebackLexer': ('pip._vendor.pygments.lexers.python', 'Python Traceback', ('pytb', 'py3tb'), ('*.pytb', '*.py3tb'), ('text/x-python-traceback', 'text/x-python3-traceback')),
     'PythonUL4Lexer': ('pip._vendor.pygments.lexers.ul4', 'Python+UL4', ('py+ul4',), ('*.pyul4',), ()),
     'QBasicLexer': ('pip._vendor.pygments.lexers.basic', 'QBasic', ('qbasic', 'basic'), ('*.BAS', '*.bas'), ('text/basic',)),
@@ -444,6 +447,7 @@ LEXERS = {
     'RedcodeLexer': ('pip._vendor.pygments.lexers.esoteric', 'Redcode', ('redcode',), ('*.cw',), ()),
     'RegeditLexer': ('pip._vendor.pygments.lexers.configs', 'reg', ('registry',), ('*.reg',), ('text/x-windows-registry',)),
     'RegoLexer': ('pip._vendor.pygments.lexers.rego', 'Rego', ('rego',), ('*.rego',), ('text/x-rego',)),
+    'RellLexer': ('pip._vendor.pygments.lexers.rell', 'Rell', ('rell',), ('*.rell',), ('text/x-rell',)),
     'ResourceLexer': ('pip._vendor.pygments.lexers.resource', 'ResourceBundle', ('resourcebundle', 'resource'), (), ()),
     'RexxLexer': ('pip._vendor.pygments.lexers.scripting', 'Rexx', ('rexx', 'arexx'), ('*.rexx', '*.rex', '*.rx', '*.arexx'), ('text/x-rexx',)),
     'RhtmlLexer': ('pip._vendor.pygments.lexers.templates', 'RHTML', ('rhtml', 'html+erb', 'html+ruby'), ('*.rhtml',), ('text/html+ruby',)),
@@ -452,6 +456,7 @@ LEXERS = {
     'RoboconfGraphLexer': ('pip._vendor.pygments.lexers.roboconf', 'Roboconf Graph', ('roboconf-graph',), ('*.graph',), ()),
     'RoboconfInstancesLexer': ('pip._vendor.pygments.lexers.roboconf', 'Roboconf Instances', ('roboconf-instances',), ('*.instances',), ()),
     'RobotFrameworkLexer': ('pip._vendor.pygments.lexers.robotframework', 'RobotFramework', ('robotframework',), ('*.robot', '*.resource'), ('text/x-robotframework',)),
+    'RocqLexer': ('pip._vendor.pygments.lexers.theorem', 'Rocq Prover', ('coq', 'rocq', 'rocq-prover'), ('*.v',), ('text/x-coq', 'text/x-rocq')),
     'RqlLexer': ('pip._vendor.pygments.lexers.sql', 'RQL', ('rql',), ('*.rql',), ('text/x-rql',)),
     'RslLexer': ('pip._vendor.pygments.lexers.dsls', 'RSL', ('rsl',), ('*.rsl',), ('text/rsl',)),
     'RstLexer': ('pip._vendor.pygments.lexers.markup', 'reStructuredText', ('restructuredtext', 'rst', 'rest'), ('*.rst', '*.rest'), ('text/x-rst', 'text/prs.fallenstein.rst')),
@@ -583,7 +588,7 @@ LEXERS = {
     'XQueryLexer': ('pip._vendor.pygments.lexers.webmisc', 'XQuery', ('xquery', 'xqy', 'xq', 'xql', 'xqm'), ('*.xqy', '*.xquery', '*.xq', '*.xql', '*.xqm'), ('text/xquery', 'application/xquery')),
     'XmlDjangoLexer': ('pip._vendor.pygments.lexers.templates', 'XML+Django/Jinja', ('xml+django', 'xml+jinja'), ('*.xml.j2', '*.xml.jinja2'), ('application/xml+django', 'application/xml+jinja')),
     'XmlErbLexer': ('pip._vendor.pygments.lexers.templates', 'XML+Ruby', ('xml+ruby', 'xml+erb'), (), ('application/xml+ruby',)),
-    'XmlLexer': ('pip._vendor.pygments.lexers.html', 'XML', ('xml',), ('*.xml', '*.xsl', '*.rss', '*.xslt', '*.xsd', '*.wsdl', '*.wsf'), ('text/xml', 'application/xml', 'image/svg+xml', 'application/rss+xml', 'application/atom+xml')),
+    'XmlLexer': ('pip._vendor.pygments.lexers.html', 'XML', ('xml',), ('*.xml', '*.xsl', '*.rss', '*.xslt', '*.xsd', '*.wsdl', '*.wsf', '*.xbrl', '*.pom', '*.svg'), ('text/xml', 'application/xml', 'image/svg+xml', 'application/rss+xml', 'application/atom+xml')),
     'XmlPhpLexer': ('pip._vendor.pygments.lexers.templates', 'XML+PHP', ('xml+php',), (), ('application/xml+php',)),
     'XmlSmartyLexer': ('pip._vendor.pygments.lexers.templates', 'XML+Smarty', ('xml+smarty',), (), ('application/xml+smarty',)),
     'XorgLexer': ('pip._vendor.pygments.lexers.xorg', 'Xorg', ('xorg.conf',), ('xorg.conf',), ()),
@@ -592,7 +597,7 @@ LEXERS = {
     'XtendLexer': ('pip._vendor.pygments.lexers.jvm', 'Xtend', ('xtend',), ('*.xtend',), ('text/x-xtend',)),
     'XtlangLexer': ('pip._vendor.pygments.lexers.lisp', 'xtlang', ('extempore',), ('*.xtm',), ()),
     'YamlJinjaLexer': ('pip._vendor.pygments.lexers.templates', 'YAML+Jinja', ('yaml+jinja', 'salt', 'sls'), ('*.sls', '*.yaml.j2', '*.yml.j2', '*.yaml.jinja2', '*.yml.jinja2'), ('text/x-yaml+jinja', 'text/x-sls')),
-    'YamlLexer': ('pip._vendor.pygments.lexers.data', 'YAML', ('yaml',), ('*.yaml', '*.yml'), ('text/x-yaml',)),
+    'YamlLexer': ('pip._vendor.pygments.lexers.data', 'YAML', ('yaml', 'yml'), ('*.yaml', '*.yml'), ('text/x-yaml',)),
     'YangLexer': ('pip._vendor.pygments.lexers.yang', 'YANG', ('yang',), ('*.yang',), ('application/yang',)),
     'YaraLexer': ('pip._vendor.pygments.lexers.yara', 'YARA', ('yara', 'yar'), ('*.yar',), ('text/x-yara',)),
     'ZeekLexer': ('pip._vendor.pygments.lexers.dsls', 'Zeek', ('zeek', 'bro'), ('*.zeek', '*.bro'), ()),
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/python.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/python.py
index 1b78829..f718b96 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/python.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pygments/lexers/python.py
@@ -4,7 +4,7 @@
 
     Lexers for Python and related languages.
 
-    :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS.
+    :copyright: Copyright 2006-present by the Pygments team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 """
 
@@ -55,6 +55,8 @@ class PythonLexer(RegexLexer):
         'WORKSPACE',
         # Twisted Application infrastructure
         '*.tac',
+        # Execubot level format
+        '*.pye',
     ]
     mimetypes = ['text/x-python', 'application/x-python',
                  'text/x-python3', 'application/x-python3']
@@ -99,9 +101,9 @@ class PythonLexer(RegexLexer):
     tokens = {
         'root': [
             (r'\n', Whitespace),
-            (r'^(\s*)([rRuUbB]{,2})("""(?:.|\n)*?""")',
+            (r'^(\s*)([rRuUbB]{,2})("""[\s\S]*?""")',
              bygroups(Whitespace, String.Affix, String.Doc)),
-            (r"^(\s*)([rRuUbB]{,2})('''(?:.|\n)*?''')",
+            (r"^(\s*)([rRuUbB]{,2})('''[\s\S]*?''')",
              bygroups(Whitespace, String.Affix, String.Doc)),
             (r'\A#!.+$', Comment.Hashbang),
             (r'#.*$', Comment.Single),
@@ -111,6 +113,12 @@ class PythonLexer(RegexLexer):
             include('soft-keywords'),
             (r'(def)((?:\s|\\\s)+)', bygroups(Keyword, Whitespace), 'funcname'),
             (r'(class)((?:\s|\\\s)+)', bygroups(Keyword, Whitespace), 'classname'),
+            (r'^(lazy)((?:\s|\\\s)+)(from)((?:\s|\\\s)+)',
+             bygroups(Keyword.Namespace, Whitespace, Keyword.Namespace, Whitespace),
+             'fromimport'),
+            (r'^(lazy)((?:\s|\\\s)+)(import)((?:\s|\\\s)+)',
+             bygroups(Keyword.Namespace, Whitespace, Keyword.Namespace, Whitespace),
+             'import'),
             (r'(from)((?:\s|\\\s)+)', bygroups(Keyword.Namespace, Whitespace),
              'fromimport'),
             (r'(import)((?:\s|\\\s)+)', bygroups(Keyword.Namespace, Whitespace),
@@ -118,27 +126,27 @@ class PythonLexer(RegexLexer):
             include('expr'),
         ],
         'expr': [
-            # raw f-strings
-            ('(?i)(rf|fr)(""")',
+            # raw f-strings and t-strings
+            ('(?i)(r[ft]|[ft]r)(""")',
              bygroups(String.Affix, String.Double),
              combined('rfstringescape', 'tdqf')),
-            ("(?i)(rf|fr)(''')",
+            ("(?i)(r[ft]|[ft]r)(''')",
              bygroups(String.Affix, String.Single),
              combined('rfstringescape', 'tsqf')),
-            ('(?i)(rf|fr)(")',
+            ('(?i)(r[ft]|[ft]r)(")',
              bygroups(String.Affix, String.Double),
              combined('rfstringescape', 'dqf')),
-            ("(?i)(rf|fr)(')",
+            ("(?i)(r[ft]|[ft]r)(')",
              bygroups(String.Affix, String.Single),
              combined('rfstringescape', 'sqf')),
-            # non-raw f-strings
-            ('([fF])(""")', bygroups(String.Affix, String.Double),
+            # non-raw f-strings and t-strings
+            ('([fFtT])(""")', bygroups(String.Affix, String.Double),
              combined('fstringescape', 'tdqf')),
-            ("([fF])(''')", bygroups(String.Affix, String.Single),
+            ("([fFtT])(''')", bygroups(String.Affix, String.Single),
              combined('fstringescape', 'tsqf')),
-            ('([fF])(")', bygroups(String.Affix, String.Double),
+            ('([fFtT])(")', bygroups(String.Affix, String.Double),
              combined('fstringescape', 'dqf')),
-            ("([fF])(')", bygroups(String.Affix, String.Single),
+            ("([fFtT])(')", bygroups(String.Affix, String.Single),
              combined('fstringescape', 'sqf')),
             # raw bytes and strings
             ('(?i)(rb|br|r)(""")',
@@ -236,13 +244,14 @@ class PythonLexer(RegexLexer):
                 '__import__', 'abs', 'aiter', 'all', 'any', 'bin', 'bool', 'bytearray',
                 'breakpoint', 'bytes', 'callable', 'chr', 'classmethod', 'compile',
                 'complex', 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval',
-                'filter', 'float', 'format', 'frozenset', 'getattr', 'globals',
-                'hasattr', 'hash', 'hex', 'id', 'input', 'int', 'isinstance',
-                'issubclass', 'iter', 'len', 'list', 'locals', 'map', 'max',
-                'memoryview', 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow',
-                'print', 'property', 'range', 'repr', 'reversed', 'round', 'set',
-                'setattr', 'slice', 'sorted', 'staticmethod', 'str', 'sum', 'super',
-                'tuple', 'type', 'vars', 'zip'), prefix=r'(?]*>
 ''', re.DOTALL | re.MULTILINE | re.VERBOSE)
-tag_re = re.compile(r'<(.+?)(\s.*?)?>.*?',
+tag_re = re.compile(r'<([a-zA-Z][a-zA-Z0-9._:-]*)(\s[^>]*)?>.*?',
                     re.IGNORECASE | re.DOTALL | re.MULTILINE)
 xml_decl_re = re.compile(r'\s*<\?xml[^>]*\?>', re.I)
 
@@ -286,7 +287,7 @@ def guess_decode(text):
         try:
             import locale
             prefencoding = locale.getpreferredencoding()
-            text = text.decode()
+            text = text.decode(prefencoding)
             return text, prefencoding
         except (UnicodeDecodeError, LookupError):
             text = text.decode('latin1')
@@ -322,3 +323,22 @@ class UnclosingTextIOWrapper(TextIOWrapper):
     # Don't close underlying buffer on destruction.
     def close(self):
         self.flush()
+
+
+def html_escape(string, quote=True) -> str:
+    """Return a safe version of the passed `string`,
+    and an empty string if `None`.
+
+    `NoneType` is not supported by `html.escape`, as `html.escape`
+    uses the built-in `replace` function on `string`, so we need to
+    check for it first.
+
+    Optional flag quote is true by default, which also escapes
+    double and single quotes.
+    See https://docs.python.org/3/library/html.html#html.escape for more details.
+    """
+    if string is not None:
+        # TODO: Eventually, check that string is a str, and if not, print a
+        #       warning or error here.
+        return html.escape(str(string), quote=quote)
+    return ''
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/__init__.py
index 746b89f..abbbff7 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/__init__.py
@@ -4,6 +4,7 @@
 from typing import TYPE_CHECKING
 
 from ._impl import (
+    BuildBackendWarning,
     BackendUnavailable,
     BuildBackendHookCaller,
     HookMissing,
@@ -12,8 +13,9 @@ from ._impl import (
     quiet_subprocess_runner,
 )
 
-__version__ = "1.2.0"
+__version__ = "1.3.3"
 __all__ = [
+    "BuildBackendWarning",
     "BackendUnavailable",
     "BackendInvalid",
     "HookMissing",
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_impl.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_impl.py
index d1e9d7b..03e8d8a 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_impl.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_impl.py
@@ -2,11 +2,12 @@ import json
 import os
 import sys
 import tempfile
+import subprocess
 from contextlib import contextmanager
 from os.path import abspath
 from os.path import join as pjoin
-from subprocess import STDOUT, check_call, check_output
 from typing import TYPE_CHECKING, Any, Iterator, Mapping, Optional, Sequence
+import warnings
 
 from ._in_process import _in_proc_script_path
 
@@ -35,6 +36,10 @@ def read_json(path: str) -> Mapping[str, Any]:
         return json.load(f)
 
 
+class BuildBackendWarning(UserWarning):
+    """Will be emitted for every UserWarning emitted by the hook process."""
+
+
 class BackendUnavailable(Exception):
     """Will be raised if the backend cannot be imported in the hook process."""
 
@@ -48,8 +53,11 @@ class BackendUnavailable(Exception):
         # Preserving arg order for the sake of API backward compatibility.
         self.backend_name = backend_name
         self.backend_path = backend_path
-        self.traceback = traceback
-        super().__init__(message or "Error while importing backend")
+        self.traceback = traceback or ""
+        super().__init__(
+            f"{message or 'Error while importing backend'}"
+            + (f"\n\nTraceback:\n{self.traceback}" if self.traceback else "")
+        )
 
 
 class HookMissing(Exception):
@@ -74,13 +82,13 @@ def default_subprocess_runner(
 ) -> None:
     """The default method of calling the wrapper subprocess.
 
-    This uses :func:`subprocess.check_call` under the hood.
+    This uses :func:`subprocess.run` under the hood.
     """
     env = os.environ.copy()
     if extra_environ:
         env.update(extra_environ)
 
-    check_call(cmd, cwd=cwd, env=env)
+    subprocess.run(cmd, cwd=cwd, env=env, check=True)
 
 
 def quiet_subprocess_runner(
@@ -90,13 +98,21 @@ def quiet_subprocess_runner(
 ) -> None:
     """Call the subprocess while suppressing output.
 
-    This uses :func:`subprocess.check_output` under the hood.
+    This uses :func:`subprocess.run` with `stdout=PIPE, stderr=STDOUT` under the hood.
     """
     env = os.environ.copy()
     if extra_environ:
         env.update(extra_environ)
 
-    check_output(cmd, cwd=cwd, env=env, stderr=STDOUT)
+    # Capturing output in case it fails (available on the exception object)
+    subprocess.run(
+        cmd,
+        cwd=cwd,
+        env=env,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.STDOUT,
+        check=True,
+    )
 
 
 def norm_and_check(source_tree: str, requested: str) -> str:
@@ -112,12 +128,9 @@ def norm_and_check(source_tree: str, requested: str) -> str:
 
     abs_source = os.path.abspath(source_tree)
     abs_requested = os.path.normpath(os.path.join(abs_source, requested))
-    # We have to use commonprefix for Python 2.7 compatibility. So we
-    # normalise case to avoid problems because commonprefix is a character
-    # based comparison :-(
     norm_source = os.path.normcase(abs_source)
     norm_requested = os.path.normcase(abs_requested)
-    if os.path.commonprefix([norm_source, norm_requested]) != norm_source:
+    if os.path.commonpath([norm_source, norm_requested]) != norm_source:
         raise ValueError("paths must be inside source tree")
 
     return abs_requested
@@ -162,6 +175,13 @@ class BuildBackendHookCaller:
 
         :param runner: The new subprocess runner to use within the context.
 
+        .. warning::
+
+            This context manager temporarily mutates the hook caller instance and
+            is not thread-safe. Callers that need to run hooks concurrently
+            should create separate :class:`BuildBackendHookCaller` instances, or
+            provide the subprocess runner when constructing the caller.
+
         .. code-block:: python
 
             hook_caller = BuildBackendHookCaller(...)
@@ -285,7 +305,7 @@ class BuildBackendHookCaller:
         metadata_directory: str,
         config_settings: Optional[Mapping[str, Any]] = None,
         _allow_fallback: bool = True,
-    ) -> Optional[str]:
+    ) -> str:
         """Prepare a ``*.dist-info`` folder with metadata for this project.
 
         :param metadata_directory: The directory to write the metadata to
@@ -365,7 +385,7 @@ class BuildBackendHookCaller:
         """Build an sdist from this project.
 
         :returns:
-            The name of the newly created sdist within ``wheel_directory``.
+            The name of the newly created sdist within ``sdist_directory``.
         """
         return self._call_hook(
             "build_sdist",
@@ -379,8 +399,9 @@ class BuildBackendHookCaller:
         extra_environ = {"_PYPROJECT_HOOKS_BUILD_BACKEND": self.build_backend}
 
         if self.backend_path:
-            backend_path = os.pathsep.join(self.backend_path)
-            extra_environ["_PYPROJECT_HOOKS_BACKEND_PATH"] = backend_path
+            extra_environ["_PYPROJECT_HOOKS_BACKEND_PATH_JSON"] = json.dumps(
+                self.backend_path
+            )
 
         with tempfile.TemporaryDirectory() as td:
             hook_input = {"kwargs": kwargs}
@@ -407,4 +428,12 @@ class BuildBackendHookCaller:
                 )
             if data.get("hook_missing"):
                 raise HookMissing(data.get("missing_hook_name") or hook_name)
+
+            for w in data.get("warnings", []):
+                warnings.warn_explicit(
+                    message=w["message"],
+                    category=BuildBackendWarning,
+                    filename=w["filename"],
+                    lineno=w["lineno"],
+                )
             return data["return_val"]
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py b/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py
index d689bab..22d5588 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py
@@ -4,7 +4,7 @@ It expects:
 - Command line args: hook_name, control_dir
 - Environment variables:
       _PYPROJECT_HOOKS_BUILD_BACKEND=entry.point:spec
-      _PYPROJECT_HOOKS_BACKEND_PATH=paths (separated with os.pathsep)
+      _PYPROJECT_HOOKS_BACKEND_PATH_JSON=paths (JSON encoded)
 - control_dir/input.json:
   - {"kwargs": {...}}
 
@@ -23,6 +23,7 @@ from glob import glob
 from importlib import import_module
 from importlib.machinery import PathFinder
 from os.path import join as pjoin
+import warnings
 
 # This file is run as a script, and `import wrappers` is not zip-safe, so we
 # include write_json() and read_json() from wrappers.py.
@@ -57,13 +58,17 @@ class HookMissing(Exception):
 
 def _build_backend():
     """Find and load the build backend"""
-    backend_path = os.environ.get("_PYPROJECT_HOOKS_BACKEND_PATH")
+    backend_path_json = os.environ.get("_PYPROJECT_HOOKS_BACKEND_PATH_JSON")
     ep = os.environ["_PYPROJECT_HOOKS_BUILD_BACKEND"]
     mod_path, _, obj_path = ep.partition(":")
 
-    if backend_path:
+    if backend_path_json:
+        extra_pathitems = json.loads(backend_path_json)
+    else:
+        extra_pathitems = []
+
+    if extra_pathitems:
         # Ensure in-tree backend directories have the highest priority when importing.
-        extra_pathitems = backend_path.split(os.pathsep)
         sys.meta_path.insert(0, _BackendPathFinder(extra_pathitems, mod_path))
 
     try:
@@ -112,7 +117,8 @@ class _BackendPathFinder:
             # Delayed import: Python 3.7 does not contain importlib.metadata
             from importlib.metadata import DistributionFinder, MetadataPathFinder
 
-            context = DistributionFinder.Context(path=self.backend_path)
+            name = context.name if context else None
+            context = DistributionFinder.Context(name=name, path=self.backend_path)
             return MetadataPathFinder.find_distributions(context=context)
 
 
@@ -360,28 +366,39 @@ def main():
 
     # Remove the parent directory from sys.path to avoid polluting the backend
     # import namespace with this directory.
-    here = os.path.dirname(__file__)
-    if here in sys.path:
-        sys.path.remove(here)
+    here = os.path.normcase(os.path.realpath(os.path.dirname(__file__)))
+    sys.path[:] = [
+        path for path in sys.path if os.path.normcase(os.path.realpath(path)) != here
+    ]
 
     hook = globals()[hook_name]
 
     hook_input = read_json(pjoin(control_dir, "input.json"))
 
-    json_out = {"unsupported": False, "return_val": None}
-    try:
-        json_out["return_val"] = hook(**hook_input["kwargs"])
-    except BackendUnavailable as e:
-        json_out["no_backend"] = True
-        json_out["traceback"] = e.traceback
-        json_out["backend_error"] = e.message
-    except GotUnsupportedOperation as e:
-        json_out["unsupported"] = True
-        json_out["traceback"] = e.traceback
-    except HookMissing as e:
-        json_out["hook_missing"] = True
-        json_out["missing_hook_name"] = e.hook_name or hook_name
+    with warnings.catch_warnings(record=True) as captured_warnings:
+        json_out = {"unsupported": False, "return_val": None}
+        try:
+            json_out["return_val"] = hook(**hook_input["kwargs"])
+        except BackendUnavailable as e:
+            json_out["no_backend"] = True
+            json_out["traceback"] = e.traceback
+            json_out["backend_error"] = e.message
+        except GotUnsupportedOperation as e:
+            json_out["unsupported"] = True
+            json_out["traceback"] = e.traceback
+        except HookMissing as e:
+            json_out["hook_missing"] = True
+            json_out["missing_hook_name"] = e.hook_name or hook_name
 
+    json_out["warnings"] = [
+        {
+            "message": str(w.message),
+            "filename": w.filename,
+            "lineno": w.lineno,
+        }
+        for w in captured_warnings
+        if isinstance(w.category, type) and issubclass(w.category, UserWarning)
+    ]
     write_json(json_out, pjoin(control_dir, "output.json"), indent=2)
 
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__init__.py
index 04230fc..a268cae 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__init__.py
@@ -38,6 +38,8 @@ is at .
 :license: Apache 2.0, see LICENSE for more details.
 """
 
+from __future__ import annotations
+
 import warnings
 
 from pip._vendor import urllib3
@@ -48,16 +50,20 @@ charset_normalizer_version = None
 chardet_version = None
 
 
-def check_compatibility(urllib3_version, chardet_version, charset_normalizer_version):
-    urllib3_version = urllib3_version.split(".")
-    assert urllib3_version != ["dev"]  # Verify urllib3 isn't installed from git.
+def check_compatibility(
+    urllib3_version: str,
+    chardet_version: str | None,
+    charset_normalizer_version: str | None,
+) -> None:
+    urllib3_version_list = urllib3_version.split(".")[:3]
+    assert urllib3_version_list != ["dev"]  # Verify urllib3 isn't installed from git.
 
     # Sometimes, urllib3 only reports its version as 16.1.
-    if len(urllib3_version) == 2:
-        urllib3_version.append("0")
+    if len(urllib3_version_list) == 2:
+        urllib3_version_list.append("0")
 
     # Check urllib3 for compatibility.
-    major, minor, patch = urllib3_version  # noqa: F811
+    major, minor, patch = urllib3_version_list  # noqa: F811
     major, minor, patch = int(major), int(minor), int(patch)
     # urllib3 >= 1.21.1
     assert major >= 1
@@ -68,8 +74,8 @@ def check_compatibility(urllib3_version, chardet_version, charset_normalizer_ver
     if chardet_version:
         major, minor, patch = chardet_version.split(".")[:3]
         major, minor, patch = int(major), int(minor), int(patch)
-        # chardet_version >= 3.0.2, < 6.0.0
-        assert (3, 0, 2) <= (major, minor, patch) < (6, 0, 0)
+        # chardet_version >= 3.0.2, < 8.0.0
+        assert (3, 0, 2) <= (major, minor, patch) < (8, 0, 0)
     elif charset_normalizer_version:
         major, minor, patch = charset_normalizer_version.split(".")[:3]
         major, minor, patch = int(major), int(minor), int(patch)
@@ -80,31 +86,30 @@ def check_compatibility(urllib3_version, chardet_version, charset_normalizer_ver
         pass
 
 
-def _check_cryptography(cryptography_version):
+def _check_cryptography(cryptography_version: str) -> None:
     # cryptography < 1.3.4
     try:
-        cryptography_version = list(map(int, cryptography_version.split(".")))
+        cryptography_version_list = list(map(int, cryptography_version.split(".")))
     except ValueError:
         return
 
-    if cryptography_version < [1, 3, 4]:
-        warning = "Old version of cryptography ({}) may cause slowdown.".format(
-            cryptography_version
-        )
+    if cryptography_version_list < [1, 3, 4]:
+        warning = f"Old version of cryptography ({cryptography_version_list}) may cause slowdown."
         warnings.warn(warning, RequestsDependencyWarning)
 
 
 # Check imported dependencies for compatibility.
 try:
     check_compatibility(
-        urllib3.__version__, chardet_version, charset_normalizer_version
+        urllib3.__version__,  # type: ignore[reportPrivateImportUsage]
+        chardet_version,  # type: ignore[reportUnknownArgumentType]
+        charset_normalizer_version,
     )
 except (AssertionError, ValueError):
     warnings.warn(
-        "urllib3 ({}) or chardet ({})/charset_normalizer ({}) doesn't match a supported "
-        "version!".format(
-            urllib3.__version__, chardet_version, charset_normalizer_version
-        ),
+        f"urllib3 ({urllib3.__version__}) or chardet "  # type: ignore[reportPrivateImportUsage]
+        f"({chardet_version})/charset_normalizer ({charset_normalizer_version}) "
+        "doesn't match a supported version!",
         RequestsDependencyWarning,
     )
 
@@ -115,7 +120,7 @@ try:
     # Note: This logic prevents upgrading cryptography on Windows, if imported
     #       as part of pip.
     from pip._internal.utils.compat import WINDOWS
-    if not WINDOWS:
+    if WINDOWS:
         raise ImportError("pip internals: don't import cryptography on Windows")
     try:
         import ssl
@@ -128,9 +133,11 @@ try:
         pyopenssl.inject_into_urllib3()
 
         # Check cryptography version
-        from cryptography import __version__ as cryptography_version
+        from cryptography import (  # type: ignore[reportMissingImports]
+            __version__ as cryptography_version,  # type: ignore[reportUnknownVariableType]
+        )
 
-        _check_cryptography(cryptography_version)
+        _check_cryptography(cryptography_version)  # type: ignore[reportUnknownArgumentType]
 except ImportError:
     pass
 
@@ -173,6 +180,34 @@ from .models import PreparedRequest, Request, Response
 from .sessions import Session, session
 from .status_codes import codes
 
+__all__ = (
+    "ConnectionError",
+    "ConnectTimeout",
+    "HTTPError",
+    "JSONDecodeError",
+    "PreparedRequest",
+    "ReadTimeout",
+    "Request",
+    "RequestException",
+    "Response",
+    "Session",
+    "Timeout",
+    "TooManyRedirects",
+    "URLRequired",
+    "codes",
+    "delete",
+    "get",
+    "head",
+    "options",
+    "packages",
+    "patch",
+    "post",
+    "put",
+    "request",
+    "session",
+    "utils",
+)
+
 logging.getLogger(__name__).addHandler(NullHandler())
 
 # FileModeWarnings go off per the default.
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__version__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__version__.py
index effdd98..fea814e 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__version__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/__version__.py
@@ -5,8 +5,8 @@
 __title__ = "requests"
 __description__ = "Python HTTP for Humans."
 __url__ = "https://requests.readthedocs.io"
-__version__ = "2.32.5"
-__build__ = 0x023205
+__version__ = "2.34.2"
+__build__ = 0x023402
 __author__ = "Kenneth Reitz"
 __author_email__ = "me@kennethreitz.org"
 __license__ = "Apache-2.0"
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/_internal_utils.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/_internal_utils.py
index f2cf635..0466a7d 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/_internal_utils.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/_internal_utils.py
@@ -5,14 +5,15 @@ requests._internal_utils
 Provides utility functions that are consumed internally by Requests
 which depend on extremely few external helpers (such as compat)
 """
+
 import re
 
 from .compat import builtin_str
 
-_VALID_HEADER_NAME_RE_BYTE = re.compile(rb"^[^:\s][^:\r\n]*$")
-_VALID_HEADER_NAME_RE_STR = re.compile(r"^[^:\s][^:\r\n]*$")
-_VALID_HEADER_VALUE_RE_BYTE = re.compile(rb"^\S[^\r\n]*$|^$")
-_VALID_HEADER_VALUE_RE_STR = re.compile(r"^\S[^\r\n]*$|^$")
+_VALID_HEADER_NAME_RE_BYTE = re.compile(rb"^[^:\s][^:\r\n]*\Z")
+_VALID_HEADER_NAME_RE_STR = re.compile(r"^[^:\s][^:\r\n]*\Z")
+_VALID_HEADER_VALUE_RE_BYTE = re.compile(rb"^\S[^\r\n]*\Z|^\Z")
+_VALID_HEADER_VALUE_RE_STR = re.compile(r"^\S[^\r\n]*\Z|^\Z")
 
 _HEADER_VALIDATORS_STR = (_VALID_HEADER_NAME_RE_STR, _VALID_HEADER_VALUE_RE_STR)
 _HEADER_VALIDATORS_BYTE = (_VALID_HEADER_NAME_RE_BYTE, _VALID_HEADER_VALUE_RE_BYTE)
@@ -22,7 +23,7 @@ HEADER_VALIDATORS = {
 }
 
 
-def to_native_string(string, encoding="ascii"):
+def to_native_string(string: str | bytes, encoding: str = "ascii") -> str:
     """Given a string object, regardless of type, returns a representation of
     that string in the native string type, encoding and decoding where
     necessary. This assumes ASCII unless told otherwise.
@@ -35,7 +36,7 @@ def to_native_string(string, encoding="ascii"):
     return out
 
 
-def unicode_is_ascii(u_string):
+def unicode_is_ascii(u_string: str) -> bool:
     """Determine if unicode string only contains ASCII characters.
 
     :param str u_string: unicode string to check. Must be unicode
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/adapters.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/adapters.py
index 67ccebc..5bf54af 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/adapters.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/adapters.py
@@ -6,29 +6,34 @@ This module contains the transport adapters that Requests uses to define
 and maintain connections.
 """
 
+from __future__ import annotations
+
 import os.path
-import socket  # noqa: F401
+import socket  # noqa: F401  # type: ignore[reportUnusedImport]
 import typing
 import warnings
+from typing import Any
 
-from pip._vendor.urllib3.exceptions import ClosedPoolError, ConnectTimeoutError
-from pip._vendor.urllib3.exceptions import HTTPError as _HTTPError
-from pip._vendor.urllib3.exceptions import InvalidHeader as _InvalidHeader
 from pip._vendor.urllib3.exceptions import (
+    ClosedPoolError,
+    ConnectTimeoutError,
     LocationValueError,
     MaxRetryError,
     NewConnectionError,
     ProtocolError,
+    ReadTimeoutError,
+    ResponseError,
 )
+from pip._vendor.urllib3.exceptions import HTTPError as _HTTPError
+from pip._vendor.urllib3.exceptions import InvalidHeader as _InvalidHeader
 from pip._vendor.urllib3.exceptions import ProxyError as _ProxyError
-from pip._vendor.urllib3.exceptions import ReadTimeoutError, ResponseError
 from pip._vendor.urllib3.exceptions import SSLError as _SSLError
 from pip._vendor.urllib3.poolmanager import PoolManager, proxy_from_url
 from pip._vendor.urllib3.util import Timeout as TimeoutSauce
 from pip._vendor.urllib3.util import parse_url
 from pip._vendor.urllib3.util.retry import Retry
 
-from .auth import _basic_auth_str
+from .auth import _basic_auth_str  # type: ignore[reportPrivateUsage]
 from .compat import basestring, urlparse
 from .cookies import extract_cookies_to_jar
 from .exceptions import (
@@ -47,7 +52,6 @@ from .models import Response
 from .structures import CaseInsensitiveDict
 from .utils import (
     DEFAULT_CA_BUNDLE_PATH,
-    extract_zipped_paths,
     get_auth_from_url,
     get_encoding_from_headers,
     prepend_scheme_if_needed,
@@ -56,16 +60,21 @@ from .utils import (
 )
 
 try:
-    from pip._vendor.urllib3.contrib.socks import SOCKSProxyManager
+    from pip._vendor.urllib3.contrib.socks import SOCKSProxyManager  # type: ignore[assignment]
 except ImportError:
 
-    def SOCKSProxyManager(*args, **kwargs):
+    def SOCKSProxyManager(*args: Any, **kwargs: Any) -> None:
         raise InvalidSchema("Missing dependencies for SOCKS support.")
 
 
 if typing.TYPE_CHECKING:
+    from pip._vendor.urllib3.connectionpool import HTTPConnectionPool
+    from pip._vendor.urllib3.poolmanager import PoolManager as _PoolManager
+
+    from . import _types as _t
     from .models import PreparedRequest
 
+from ._types import is_prepared as _is_prepared
 
 DEFAULT_POOLBLOCK = False
 DEFAULT_POOLSIZE = 10
@@ -74,13 +83,13 @@ DEFAULT_POOL_TIMEOUT = None
 
 
 def _urllib3_request_context(
-    request: "PreparedRequest",
-    verify: "bool | str | None",
-    client_cert: "typing.Tuple[str, str] | str | None",
-    poolmanager: "PoolManager",
-) -> "(typing.Dict[str, typing.Any], typing.Dict[str, typing.Any])":
-    host_params = {}
-    pool_kwargs = {}
+    request: PreparedRequest,
+    verify: bool | str | None,
+    client_cert: tuple[str, str] | str | None,
+    poolmanager: PoolManager,
+) -> tuple[dict[str, Any], dict[str, Any]]:
+    host_params: dict[str, Any] = {}
+    pool_kwargs: dict[str, Any] = {}
     parsed_request_url = urlparse(request.url)
     scheme = parsed_request_url.scheme.lower()
     port = parsed_request_url.port
@@ -113,12 +122,18 @@ def _urllib3_request_context(
 class BaseAdapter:
     """The Base Transport Adapter"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
 
     def send(
-        self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None
-    ):
+        self,
+        request: PreparedRequest,
+        stream: bool = False,
+        timeout: _t.TimeoutType = None,
+        verify: _t.VerifyType = True,
+        cert: _t.CertType = None,
+        proxies: dict[str, str] | None = None,
+    ) -> Response:
         """Sends PreparedRequest object. Returns Response object.
 
         :param request: The :class:`PreparedRequest ` being sent.
@@ -135,7 +150,7 @@ class BaseAdapter:
         """
         raise NotImplementedError
 
-    def close(self):
+    def close(self) -> None:
         """Cleans up adapter specific items."""
         raise NotImplementedError
 
@@ -167,7 +182,7 @@ class HTTPAdapter(BaseAdapter):
       >>> s.mount('http://', a)
     """
 
-    __attrs__ = [
+    __attrs__: list[str] = [
         "max_retries",
         "config",
         "_pool_connections",
@@ -175,13 +190,21 @@ class HTTPAdapter(BaseAdapter):
         "_pool_block",
     ]
 
+    max_retries: Retry
+    config: dict[str, Any]
+    proxy_manager: dict[str, Any]
+    _pool_connections: int
+    _pool_maxsize: int
+    _pool_block: bool
+    poolmanager: _PoolManager
+
     def __init__(
         self,
-        pool_connections=DEFAULT_POOLSIZE,
-        pool_maxsize=DEFAULT_POOLSIZE,
-        max_retries=DEFAULT_RETRIES,
-        pool_block=DEFAULT_POOLBLOCK,
-    ):
+        pool_connections: int = DEFAULT_POOLSIZE,
+        pool_maxsize: int = DEFAULT_POOLSIZE,
+        max_retries: int | Retry = DEFAULT_RETRIES,
+        pool_block: bool = DEFAULT_POOLBLOCK,
+    ) -> None:
         if max_retries == DEFAULT_RETRIES:
             self.max_retries = Retry(0, read=False)
         else:
@@ -197,10 +220,10 @@ class HTTPAdapter(BaseAdapter):
 
         self.init_poolmanager(pool_connections, pool_maxsize, block=pool_block)
 
-    def __getstate__(self):
+    def __getstate__(self) -> dict[str, Any]:
         return {attr: getattr(self, attr, None) for attr in self.__attrs__}
 
-    def __setstate__(self, state):
+    def __setstate__(self, state: dict[str, Any]) -> None:
         # Can't handle by adding 'proxy_manager' to self.__attrs__ because
         # self.poolmanager uses a lambda function, which isn't pickleable.
         self.proxy_manager = {}
@@ -214,8 +237,12 @@ class HTTPAdapter(BaseAdapter):
         )
 
     def init_poolmanager(
-        self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs
-    ):
+        self,
+        connections: int,
+        maxsize: int,
+        block: bool = DEFAULT_POOLBLOCK,
+        **pool_kwargs: Any,
+    ) -> None:
         """Initializes a urllib3 PoolManager.
 
         This method should not be called from user code, and is only
@@ -239,7 +266,7 @@ class HTTPAdapter(BaseAdapter):
             **pool_kwargs,
         )
 
-    def proxy_manager_for(self, proxy, **proxy_kwargs):
+    def proxy_manager_for(self, proxy: str, **proxy_kwargs: Any) -> Any:
         """Return urllib3 ProxyManager for the given proxy.
 
         This method should not be called from user code, and is only
@@ -277,7 +304,9 @@ class HTTPAdapter(BaseAdapter):
 
         return manager
 
-    def cert_verify(self, conn, url, verify, cert):
+    def cert_verify(
+        self, conn: Any, url: str, verify: _t.VerifyType, cert: _t.CertType
+    ) -> None:
         """Verify a SSL certificate. This method should not be called from user
         code, and is only exposed for use when subclassing the
         :class:`HTTPAdapter `.
@@ -297,7 +326,7 @@ class HTTPAdapter(BaseAdapter):
                 cert_loc = verify
 
             if not cert_loc:
-                cert_loc = extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH)
+                cert_loc = DEFAULT_CA_BUNDLE_PATH
 
             if not cert_loc or not os.path.exists(cert_loc):
                 raise OSError(
@@ -333,7 +362,7 @@ class HTTPAdapter(BaseAdapter):
                     f"Could not find the TLS key file, invalid path: {conn.key_file}"
                 )
 
-    def build_response(self, req, resp):
+    def build_response(self, req: PreparedRequest, resp: Any) -> Response:
         """Builds a :class:`Response ` object from a urllib3
         response. This should not be called from user code, and is only exposed
         for use when subclassing the
@@ -343,10 +372,11 @@ class HTTPAdapter(BaseAdapter):
         :param resp: The urllib3 response object.
         :rtype: requests.Response
         """
+        assert _is_prepared(req)
         response = Response()
 
         # Fallback to None if there's no status_code, for whatever reason.
-        response.status_code = getattr(resp, "status", None)
+        response.status_code = getattr(resp, "status", None)  # type: ignore[assignment]
 
         # Make headers case-insensitive.
         response.headers = CaseInsensitiveDict(getattr(resp, "headers", {}))
@@ -370,7 +400,9 @@ class HTTPAdapter(BaseAdapter):
 
         return response
 
-    def build_connection_pool_key_attributes(self, request, verify, cert=None):
+    def build_connection_pool_key_attributes(
+        self, request: PreparedRequest, verify: _t.VerifyType, cert: _t.CertType = None
+    ) -> tuple[dict[str, Any], dict[str, Any]]:
         """Build the PoolKey attributes used by urllib3 to return a connection.
 
         This looks at the PreparedRequest, the user-specified verify value,
@@ -400,7 +432,7 @@ class HTTPAdapter(BaseAdapter):
         alter the other keys to ensure the desired behaviour.
 
         :param request:
-            The PreparedReqest being sent over the connection.
+            The PreparedRequest being sent over the connection.
         :type request:
             :class:`~requests.models.PreparedRequest`
         :param verify:
@@ -420,7 +452,13 @@ class HTTPAdapter(BaseAdapter):
         """
         return _urllib3_request_context(request, verify, cert, self.poolmanager)
 
-    def get_connection_with_tls_context(self, request, verify, proxies=None, cert=None):
+    def get_connection_with_tls_context(
+        self,
+        request: PreparedRequest,
+        verify: _t.VerifyType,
+        proxies: dict[str, str] | None = None,
+        cert: _t.CertType = None,
+    ) -> HTTPConnectionPool:
         """Returns a urllib3 connection for the given request and TLS settings.
         This should not be called from user code, and is only exposed for use
         when subclassing the :class:`HTTPAdapter `.
@@ -438,8 +476,10 @@ class HTTPAdapter(BaseAdapter):
             (optional) Any user-provided SSL certificate to be used for client
             authentication (a.k.a., mTLS).
         :rtype:
-            urllib3.ConnectionPool
+            urllib3.HTTPConnectionPool
         """
+        assert _is_prepared(request)
+
         proxy = select_proxy(request.url, proxies)
         try:
             host_params, pool_kwargs = self.build_connection_pool_key_attributes(
@@ -469,7 +509,9 @@ class HTTPAdapter(BaseAdapter):
 
         return conn
 
-    def get_connection(self, url, proxies=None):
+    def get_connection(
+        self, url: str, proxies: dict[str, str] | None = None
+    ) -> HTTPConnectionPool:
         """DEPRECATED: Users should move to `get_connection_with_tls_context`
         for all subclasses of HTTPAdapter using Requests>=2.32.2.
 
@@ -479,7 +521,7 @@ class HTTPAdapter(BaseAdapter):
 
         :param url: The URL to connect to.
         :param proxies: (optional) A Requests-style dictionary of proxies used on this request.
-        :rtype: urllib3.ConnectionPool
+        :rtype: urllib3.HTTPConnectionPool
         """
         warnings.warn(
             (
@@ -510,7 +552,7 @@ class HTTPAdapter(BaseAdapter):
 
         return conn
 
-    def close(self):
+    def close(self) -> None:
         """Disposes of any internal state.
 
         Currently, this closes the PoolManager and any active ProxyManager,
@@ -520,7 +562,9 @@ class HTTPAdapter(BaseAdapter):
         for proxy in self.proxy_manager.values():
             proxy.clear()
 
-    def request_url(self, request, proxies):
+    def request_url(
+        self, request: PreparedRequest, proxies: dict[str, str] | None
+    ) -> str:
         """Obtain the url to use when making the final request.
 
         If the message is being sent through a HTTP proxy, the full URL has to
@@ -534,6 +578,8 @@ class HTTPAdapter(BaseAdapter):
         :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs.
         :rtype: str
         """
+        assert _is_prepared(request)
+
         proxy = select_proxy(request.url, proxies)
         scheme = urlparse(request.url).scheme
 
@@ -544,15 +590,13 @@ class HTTPAdapter(BaseAdapter):
             using_socks_proxy = proxy_scheme.startswith("socks")
 
         url = request.path_url
-        if url.startswith("//"):  # Don't confuse urllib3
-            url = f"/{url.lstrip('/')}"
 
         if is_proxied_http_request and not using_socks_proxy:
             url = urldefragauth(request.url)
 
         return url
 
-    def add_headers(self, request, **kwargs):
+    def add_headers(self, request: PreparedRequest, **kwargs: Any) -> None:
         """Add any headers needed by the connection. As of v2.0 this does
         nothing by default, but is left for overriding by users that subclass
         the :class:`HTTPAdapter `.
@@ -566,7 +610,7 @@ class HTTPAdapter(BaseAdapter):
         """
         pass
 
-    def proxy_headers(self, proxy):
+    def proxy_headers(self, proxy: str) -> dict[str, str]:
         """Returns a dictionary of the headers to add to any request sent
         through a proxy. This works with urllib3 magic to ensure that they are
         correctly sent to the proxy, rather than in a tunnelled request if
@@ -579,7 +623,7 @@ class HTTPAdapter(BaseAdapter):
         :param proxy: The url of the proxy being used for this request.
         :rtype: dict
         """
-        headers = {}
+        headers: dict[str, str] = {}
         username, password = get_auth_from_url(proxy)
 
         if username:
@@ -588,8 +632,14 @@ class HTTPAdapter(BaseAdapter):
         return headers
 
     def send(
-        self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None
-    ):
+        self,
+        request: PreparedRequest,
+        stream: bool = False,
+        timeout: _t.TimeoutType = None,
+        verify: _t.VerifyType = True,
+        cert: _t.CertType = None,
+        proxies: dict[str, str] | None = None,
+    ) -> Response:
         """Sends PreparedRequest object. Returns Response object.
 
         :param request: The :class:`PreparedRequest ` being sent.
@@ -606,6 +656,8 @@ class HTTPAdapter(BaseAdapter):
         :rtype: requests.Response
         """
 
+        assert _is_prepared(request)
+
         try:
             conn = self.get_connection_with_tls_context(
                 request, verify, proxies=proxies, cert=cert
@@ -629,29 +681,29 @@ class HTTPAdapter(BaseAdapter):
         if isinstance(timeout, tuple):
             try:
                 connect, read = timeout
-                timeout = TimeoutSauce(connect=connect, read=read)
+                resolved_timeout = TimeoutSauce(connect=connect, read=read)
             except ValueError:
                 raise ValueError(
                     f"Invalid timeout {timeout}. Pass a (connect, read) timeout tuple, "
                     f"or a single float to set both timeouts to the same value."
                 )
         elif isinstance(timeout, TimeoutSauce):
-            pass
+            resolved_timeout = timeout
         else:
-            timeout = TimeoutSauce(connect=timeout, read=timeout)
+            resolved_timeout = TimeoutSauce(connect=timeout, read=timeout)
 
         try:
             resp = conn.urlopen(
                 method=request.method,
                 url=url,
-                body=request.body,
-                headers=request.headers,
+                body=request.body,  # type: ignore[arg-type]  # urllib3 stubs don't accept Iterable[bytes | str]
+                headers=request.headers,  # type: ignore[arg-type]  # urllib3#3072
                 redirect=False,
                 assert_same_host=False,
                 preload_content=False,
                 decode_content=False,
                 retries=self.max_retries,
-                timeout=timeout,
+                timeout=resolved_timeout,
                 chunked=chunked,
             )
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/api.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/api.py
index 5960744..eeb3b54 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/api.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/api.py
@@ -8,10 +8,22 @@ This module implements the Requests API.
 :license: Apache2, see LICENSE for more details.
 """
 
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
 from . import sessions
+from .models import Response
+
+if TYPE_CHECKING:
+    from typing_extensions import Unpack
+
+    from . import _types as _t
 
 
-def request(method, url, **kwargs):
+def request(
+    method: str, url: _t.UriType, **kwargs: Unpack[_t.RequestKwargs]
+) -> Response:
     """Constructs and sends a :class:`Request `.
 
     :param method: method for the new :class:`Request` object: ``GET``, ``OPTIONS``, ``HEAD``, ``POST``, ``PUT``, ``PATCH``, or ``DELETE``.
@@ -59,7 +71,9 @@ def request(method, url, **kwargs):
         return session.request(method=method, url=url, **kwargs)
 
 
-def get(url, params=None, **kwargs):
+def get(
+    url: _t.UriType, params: _t.ParamsType = None, **kwargs: Unpack[_t.GetKwargs]
+) -> Response:
     r"""Sends a GET request.
 
     :param url: URL for the new :class:`Request` object.
@@ -73,7 +87,7 @@ def get(url, params=None, **kwargs):
     return request("get", url, params=params, **kwargs)
 
 
-def options(url, **kwargs):
+def options(url: _t.UriType, **kwargs: Unpack[_t.RequestKwargs]) -> Response:
     r"""Sends an OPTIONS request.
 
     :param url: URL for the new :class:`Request` object.
@@ -85,7 +99,7 @@ def options(url, **kwargs):
     return request("options", url, **kwargs)
 
 
-def head(url, **kwargs):
+def head(url: _t.UriType, **kwargs: Unpack[_t.RequestKwargs]) -> Response:
     r"""Sends a HEAD request.
 
     :param url: URL for the new :class:`Request` object.
@@ -100,7 +114,12 @@ def head(url, **kwargs):
     return request("head", url, **kwargs)
 
 
-def post(url, data=None, json=None, **kwargs):
+def post(
+    url: _t.UriType,
+    data: _t.DataType = None,
+    json: _t.JsonType = None,
+    **kwargs: Unpack[_t.PostKwargs],
+) -> Response:
     r"""Sends a POST request.
 
     :param url: URL for the new :class:`Request` object.
@@ -115,7 +134,9 @@ def post(url, data=None, json=None, **kwargs):
     return request("post", url, data=data, json=json, **kwargs)
 
 
-def put(url, data=None, **kwargs):
+def put(
+    url: _t.UriType, data: _t.DataType = None, **kwargs: Unpack[_t.DataKwargs]
+) -> Response:
     r"""Sends a PUT request.
 
     :param url: URL for the new :class:`Request` object.
@@ -130,7 +151,9 @@ def put(url, data=None, **kwargs):
     return request("put", url, data=data, **kwargs)
 
 
-def patch(url, data=None, **kwargs):
+def patch(
+    url: _t.UriType, data: _t.DataType = None, **kwargs: Unpack[_t.DataKwargs]
+) -> Response:
     r"""Sends a PATCH request.
 
     :param url: URL for the new :class:`Request` object.
@@ -145,7 +168,7 @@ def patch(url, data=None, **kwargs):
     return request("patch", url, data=data, **kwargs)
 
 
-def delete(url, **kwargs):
+def delete(url: _t.UriType, **kwargs: Unpack[_t.RequestKwargs]) -> Response:
     r"""Sends a DELETE request.
 
     :param url: URL for the new :class:`Request` object.
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/auth.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/auth.py
index 4a7ce6d..2af481d 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/auth.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/auth.py
@@ -5,6 +5,8 @@ requests.auth
 This module contains the authentication handlers for Requests.
 """
 
+from __future__ import annotations
+
 import hashlib
 import os
 import re
@@ -12,17 +14,24 @@ import threading
 import time
 import warnings
 from base64 import b64encode
+from typing import TYPE_CHECKING, Any, Final, cast, overload
 
 from ._internal_utils import to_native_string
 from .compat import basestring, str, urlparse
 from .cookies import extract_cookies_to_jar
 from .utils import parse_dict_header
 
-CONTENT_TYPE_FORM_URLENCODED = "application/x-www-form-urlencoded"
-CONTENT_TYPE_MULTI_PART = "multipart/form-data"
+if TYPE_CHECKING:
+    from http.cookiejar import CookieJar
+    from typing import Any
+
+    from .models import PreparedRequest, Response
+
+CONTENT_TYPE_FORM_URLENCODED: Final = "application/x-www-form-urlencoded"
+CONTENT_TYPE_MULTI_PART: Final = "multipart/form-data"
 
 
-def _basic_auth_str(username, password):
+def _basic_auth_str(username: bytes | str, password: bytes | str) -> str:
     """Returns a Basic Auth string."""
 
     # "I want us to put a big-ol' comment on top of it that
@@ -32,22 +41,22 @@ def _basic_auth_str(username, password):
     #
     # These are here solely to maintain backwards compatibility
     # for things like ints. This will be removed in 3.0.0.
-    if not isinstance(username, basestring):
+    if not isinstance(username, basestring):  # type: ignore[reportUnnecessaryIsInstance]  # runtime guard for non-str/bytes
         warnings.warn(
             "Non-string usernames will no longer be supported in Requests "
-            "3.0.0. Please convert the object you've passed in ({!r}) to "
+            f"3.0.0. Please convert the object you've passed in ({username!r}) to "
             "a string or bytes object in the near future to avoid "
-            "problems.".format(username),
+            "problems.",
             category=DeprecationWarning,
         )
         username = str(username)
 
-    if not isinstance(password, basestring):
+    if not isinstance(password, basestring):  # type: ignore[reportUnnecessaryIsInstance]  # runtime guard for non-str/bytes
         warnings.warn(
             "Non-string passwords will no longer be supported in Requests "
-            "3.0.0. Please convert the object you've passed in ({!r}) to "
+            f"3.0.0. Please convert the object you've passed in ({type(password)!r}) to "
             "a string or bytes object in the near future to avoid "
-            "problems.".format(type(password)),
+            "problems.",
             category=DeprecationWarning,
         )
         password = str(password)
@@ -69,18 +78,26 @@ def _basic_auth_str(username, password):
 class AuthBase:
     """Base class that all auth implementations derive from"""
 
-    def __call__(self, r):
+    def __call__(self, r: PreparedRequest) -> PreparedRequest:
         raise NotImplementedError("Auth hooks must be callable.")
 
 
 class HTTPBasicAuth(AuthBase):
     """Attaches HTTP Basic Authentication to the given Request object."""
 
-    def __init__(self, username, password):
+    username: bytes | str
+    password: bytes | str
+
+    @overload
+    def __init__(self, username: str, password: str) -> None: ...
+    @overload
+    def __init__(self, username: bytes, password: bytes) -> None: ...
+
+    def __init__(self, username: bytes | str, password: bytes | str) -> None:
         self.username = username
         self.password = password
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         return all(
             [
                 self.username == getattr(other, "username", None),
@@ -88,10 +105,10 @@ class HTTPBasicAuth(AuthBase):
             ]
         )
 
-    def __ne__(self, other):
+    def __ne__(self, other: Any) -> bool:
         return not self == other
 
-    def __call__(self, r):
+    def __call__(self, r: PreparedRequest) -> PreparedRequest:
         r.headers["Authorization"] = _basic_auth_str(self.username, self.password)
         return r
 
@@ -99,7 +116,7 @@ class HTTPBasicAuth(AuthBase):
 class HTTPProxyAuth(HTTPBasicAuth):
     """Attaches HTTP Proxy Authentication to a given Request object."""
 
-    def __call__(self, r):
+    def __call__(self, r: PreparedRequest) -> PreparedRequest:
         r.headers["Proxy-Authorization"] = _basic_auth_str(self.username, self.password)
         return r
 
@@ -107,13 +124,27 @@ class HTTPProxyAuth(HTTPBasicAuth):
 class HTTPDigestAuth(AuthBase):
     """Attaches HTTP Digest Authentication to the given Request object."""
 
-    def __init__(self, username, password):
+    username: bytes | str
+    password: bytes | str
+    _thread_local: threading.local
+    last_nonce: str
+    nonce_count: int
+    chal: dict[str, str]
+    pos: int | None
+    num_401_calls: int | None
+
+    @overload
+    def __init__(self, username: str, password: str) -> None: ...
+    @overload
+    def __init__(self, username: bytes, password: bytes) -> None: ...
+
+    def __init__(self, username: bytes | str, password: bytes | str) -> None:
         self.username = username
         self.password = password
         # Keep state in per-thread local storage
         self._thread_local = threading.local()
 
-    def init_per_thread_state(self):
+    def init_per_thread_state(self) -> None:
         # Ensure state is initialized just once per-thread
         if not hasattr(self._thread_local, "init"):
             self._thread_local.init = True
@@ -123,7 +154,7 @@ class HTTPDigestAuth(AuthBase):
             self._thread_local.pos = None
             self._thread_local.num_401_calls = None
 
-    def build_digest_header(self, method, url):
+    def build_digest_header(self, method: str, url: str) -> str | None:
         """
         :rtype: str
         """
@@ -142,42 +173,43 @@ class HTTPDigestAuth(AuthBase):
         # lambdas assume digest modules are imported at the top level
         if _algorithm == "MD5" or _algorithm == "MD5-SESS":
 
-            def md5_utf8(x):
+            def md5_utf8(x: str | bytes) -> str:
                 if isinstance(x, str):
                     x = x.encode("utf-8")
-                return hashlib.md5(x).hexdigest()
+                return hashlib.md5(x, usedforsecurity=False).hexdigest()
 
             hash_utf8 = md5_utf8
         elif _algorithm == "SHA":
 
-            def sha_utf8(x):
+            def sha_utf8(x: str | bytes) -> str:
                 if isinstance(x, str):
                     x = x.encode("utf-8")
-                return hashlib.sha1(x).hexdigest()
+                return hashlib.sha1(x, usedforsecurity=False).hexdigest()
 
             hash_utf8 = sha_utf8
         elif _algorithm == "SHA-256":
 
-            def sha256_utf8(x):
+            def sha256_utf8(x: str | bytes) -> str:
                 if isinstance(x, str):
                     x = x.encode("utf-8")
-                return hashlib.sha256(x).hexdigest()
+                return hashlib.sha256(x, usedforsecurity=False).hexdigest()
 
             hash_utf8 = sha256_utf8
         elif _algorithm == "SHA-512":
 
-            def sha512_utf8(x):
+            def sha512_utf8(x: str | bytes) -> str:
                 if isinstance(x, str):
                     x = x.encode("utf-8")
-                return hashlib.sha512(x).hexdigest()
+                return hashlib.sha512(x, usedforsecurity=False).hexdigest()
 
             hash_utf8 = sha512_utf8
 
-        KD = lambda s, d: hash_utf8(f"{s}:{d}")  # noqa:E731
-
         if hash_utf8 is None:
             return None
 
+        def KD(s: str, d: str) -> str:
+            return hash_utf8(f"{s}:{d}")
+
         # XXX not implemented yet
         entdig = None
         p_parsed = urlparse(url)
@@ -202,9 +234,9 @@ class HTTPDigestAuth(AuthBase):
         s += time.ctime().encode("utf-8")
         s += os.urandom(8)
 
-        cnonce = hashlib.sha1(s).hexdigest()[:16]
+        cnonce = hashlib.sha1(s, usedforsecurity=False).hexdigest()[:16]
         if _algorithm == "MD5-SESS":
-            HA1 = hash_utf8(f"{HA1}:{nonce}:{cnonce}")
+            HA1 = hash_utf8(f"{HA1}:{nonce}:{cnonce}")  # type: ignore[reportConstantRedefinition]  # RFC 2617 terminology
 
         if not qop:
             respdig = KD(HA1, f"{nonce}:{HA2}")
@@ -233,12 +265,12 @@ class HTTPDigestAuth(AuthBase):
 
         return f"Digest {base}"
 
-    def handle_redirect(self, r, **kwargs):
+    def handle_redirect(self, r: Response, **kwargs: Any) -> None:
         """Reset num_401_calls counter on redirects."""
         if r.is_redirect:
             self._thread_local.num_401_calls = 1
 
-    def handle_401(self, r, **kwargs):
+    def handle_401(self, r: Response, **kwargs: Any) -> Response:
         """
         Takes the given response and tries digest-auth, if needed.
 
@@ -254,7 +286,8 @@ class HTTPDigestAuth(AuthBase):
         if self._thread_local.pos is not None:
             # Rewind the file position indicator of the body to where
             # it was to resend the request.
-            r.request.body.seek(self._thread_local.pos)
+            if (seek := getattr(r.request.body, "seek", None)) is not None:
+                seek(self._thread_local.pos)
         s_auth = r.headers.get("www-authenticate", "")
 
         if "digest" in s_auth.lower() and self._thread_local.num_401_calls < 2:
@@ -267,12 +300,15 @@ class HTTPDigestAuth(AuthBase):
             r.content
             r.close()
             prep = r.request.copy()
-            extract_cookies_to_jar(prep._cookies, r.request, r.raw)
-            prep.prepare_cookies(prep._cookies)
+            cookie_jar = cast("CookieJar", prep._cookies)  # type: ignore[reportPrivateUsage]
+            extract_cookies_to_jar(cookie_jar, r.request, r.raw)
+            prep.prepare_cookies(cookie_jar)
 
-            prep.headers["Authorization"] = self.build_digest_header(
-                prep.method, prep.url
+            _digest_auth = self.build_digest_header(
+                cast(str, prep.method), cast(str, prep.url)
             )
+            if _digest_auth:
+                prep.headers["Authorization"] = _digest_auth
             _r = r.connection.send(prep, **kwargs)
             _r.history.append(r)
             _r.request = prep
@@ -282,15 +318,19 @@ class HTTPDigestAuth(AuthBase):
         self._thread_local.num_401_calls = 1
         return r
 
-    def __call__(self, r):
+    def __call__(self, r: PreparedRequest) -> PreparedRequest:
         # Initialize per-thread state, if needed
         self.init_per_thread_state()
         # If we have a saved nonce, skip the 401
         if self._thread_local.last_nonce:
-            r.headers["Authorization"] = self.build_digest_header(r.method, r.url)
-        try:
-            self._thread_local.pos = r.body.tell()
-        except AttributeError:
+            _digest_auth = self.build_digest_header(
+                cast(str, r.method), cast(str, r.url)
+            )
+            if _digest_auth:
+                r.headers["Authorization"] = _digest_auth
+        if (tell := getattr(r.body, "tell", None)) is not None:
+            self._thread_local.pos = tell()
+        else:
             # In the case of HTTPDigestAuth being reused and the body of
             # the previous request was a file-like object, pos has the
             # file position of the previous body. Ensure it's set to
@@ -302,7 +342,7 @@ class HTTPDigestAuth(AuthBase):
 
         return r
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         return all(
             [
                 self.username == getattr(other, "username", None),
@@ -310,5 +350,5 @@ class HTTPDigestAuth(AuthBase):
             ]
         )
 
-    def __ne__(self, other):
+    def __ne__(self, other: Any) -> bool:
         return not self == other
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/certs.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/certs.py
index 2743144..c595348 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/certs.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/certs.py
@@ -11,6 +11,7 @@ If you are packaging Requests, e.g., for a Linux distribution or a managed
 environment, you can change the definition of where() to return a separately
 packaged CA bundle.
 """
+
 from pip._vendor.certifi import where
 
 if __name__ == "__main__":
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/compat.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/compat.py
index b95a921..0cbeae6 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/compat.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/compat.py
@@ -7,12 +7,18 @@ between Python 2 and Python 3. It remains for backwards
 compatibility until the next major version.
 """
 
+# pyright: reportUnusedImport=false
+
+from __future__ import annotations
+
 import sys
 
 # -------
 # urllib3
 # -------
-from pip._vendor.urllib3 import __version__ as urllib3_version
+from pip._vendor.urllib3 import (
+    __version__ as urllib3_version,  # type: ignore[reportPrivateImportUsage]
+)
 
 # Detect which major version of urllib3 is being used.
 try:
@@ -26,7 +32,7 @@ except (TypeError, AttributeError):
 # -------------------
 
 
-def _resolve_char_detection():
+def _resolve_char_detection() -> None:
     """Find supported character detection libraries."""
     chardet = None
     return chardet
@@ -79,7 +85,7 @@ from urllib.request import (
     getproxies_environment,
     parse_http_list,
     proxy_bypass,
-    proxy_bypass_environment,
+    proxy_bypass_environment,  # type: ignore[attr-defined]  # https://github.com/python/cpython/issues/145331
 )
 
 builtin_str = str
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/cookies.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/cookies.py
index f69d0cd..2e3fc21 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/cookies.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/cookies.py
@@ -7,21 +7,29 @@ Compatibility code to be able to use `http.cookiejar.CookieJar` with requests.
 requests.utils imports from here, so be careful with imports.
 """
 
+from __future__ import annotations
+
 import calendar
 import copy
 import time
+from collections.abc import Iterator, MutableMapping
+from http.cookiejar import Cookie, CookieJar, CookiePolicy
+from typing import TYPE_CHECKING, Any, TypeVar, overload
 
 from ._internal_utils import to_native_string
-from .compat import Morsel, MutableMapping, cookielib, urlparse, urlunparse
+from ._types import is_prepared as _is_prepared
+from .compat import Morsel, cookielib, urlparse, urlunparse
 
-try:
-    import threading
-except ImportError:
-    import dummy_threading as threading
+if TYPE_CHECKING:
+    from _typeshed import SupportsKeysAndGetItem
+
+    from .models import PreparedRequest
+
+import threading
 
 
 class MockRequest:
-    """Wraps a `requests.Request` to mimic a `urllib2.Request`.
+    """Wraps a `requests.PreparedRequest` to mimic a `urllib2.Request`.
 
     The code in `http.cookiejar.CookieJar` expects this interface in order to correctly
     manage cookie policies, i.e., determine whether a cookie can be set, given the
@@ -32,21 +40,24 @@ class MockRequest:
     probably want `get_cookie_header`, defined below.
     """
 
-    def __init__(self, request):
+    type: str
+
+    def __init__(self, request: PreparedRequest) -> None:
+        assert _is_prepared(request)
         self._r = request
-        self._new_headers = {}
+        self._new_headers: dict[str, str] = {}
         self.type = urlparse(self._r.url).scheme
 
-    def get_type(self):
+    def get_type(self) -> str:
         return self.type
 
-    def get_host(self):
+    def get_host(self) -> str:
         return urlparse(self._r.url).netloc
 
-    def get_origin_req_host(self):
+    def get_origin_req_host(self) -> str:
         return self.get_host()
 
-    def get_full_url(self):
+    def get_full_url(self) -> str:
         # Only return the response's URL if the user hadn't set the Host
         # header
         if not self._r.headers.get("Host"):
@@ -66,37 +77,37 @@ class MockRequest:
             ]
         )
 
-    def is_unverifiable(self):
+    def is_unverifiable(self) -> bool:
         return True
 
-    def has_header(self, name):
+    def has_header(self, name: str) -> bool:
         return name in self._r.headers or name in self._new_headers
 
-    def get_header(self, name, default=None):
-        return self._r.headers.get(name, self._new_headers.get(name, default))
+    def get_header(self, name: str, default: str | None = None) -> str | None:
+        return self._r.headers.get(name, self._new_headers.get(name, default))  # type: ignore[return-value]
 
-    def add_header(self, key, val):
+    def add_header(self, key: str, val: str) -> None:
         """cookiejar has no legitimate use for this method; add it back if you find one."""
         raise NotImplementedError(
             "Cookie headers should be added with add_unredirected_header()"
         )
 
-    def add_unredirected_header(self, name, value):
+    def add_unredirected_header(self, name: str, value: str) -> None:
         self._new_headers[name] = value
 
-    def get_new_headers(self):
+    def get_new_headers(self) -> dict[str, str]:
         return self._new_headers
 
     @property
-    def unverifiable(self):
+    def unverifiable(self) -> bool:
         return self.is_unverifiable()
 
     @property
-    def origin_req_host(self):
+    def origin_req_host(self) -> str:
         return self.get_origin_req_host()
 
     @property
-    def host(self):
+    def host(self) -> str:
         return self.get_host()
 
 
@@ -107,21 +118,23 @@ class MockResponse:
     the way `http.cookiejar` expects to see them.
     """
 
-    def __init__(self, headers):
+    def __init__(self, headers: Any) -> None:
         """Make a MockResponse for `cookiejar` to read.
 
         :param headers: a httplib.HTTPMessage or analogous carrying the headers
         """
         self._headers = headers
 
-    def info(self):
+    def info(self) -> Any:
         return self._headers
 
-    def getheaders(self, name):
+    def getheaders(self, name: str) -> Any:
         self._headers.getheaders(name)
 
 
-def extract_cookies_to_jar(jar, request, response):
+def extract_cookies_to_jar(
+    jar: CookieJar, request: PreparedRequest, response: Any
+) -> None:
     """Extract the cookies from the response into a CookieJar.
 
     :param jar: http.cookiejar.CookieJar (not necessarily a RequestsCookieJar)
@@ -134,26 +147,28 @@ def extract_cookies_to_jar(jar, request, response):
     req = MockRequest(request)
     # pull out the HTTPMessage with the headers and put it in the mock:
     res = MockResponse(response._original_response.msg)
-    jar.extract_cookies(res, req)
+    jar.extract_cookies(res, req)  # type: ignore[arg-type]
 
 
-def get_cookie_header(jar, request):
+def get_cookie_header(jar: CookieJar, request: PreparedRequest) -> str | None:
     """
     Produce an appropriate Cookie header string to be sent with `request`, or None.
 
     :rtype: str
     """
     r = MockRequest(request)
-    jar.add_cookie_header(r)
+    jar.add_cookie_header(r)  # type: ignore[arg-type]
     return r.get_new_headers().get("Cookie")
 
 
-def remove_cookie_by_name(cookiejar, name, domain=None, path=None):
+def remove_cookie_by_name(
+    cookiejar: CookieJar, name: str, domain: str | None = None, path: str | None = None
+) -> None:
     """Unsets a cookie by name, by default over all domains and paths.
 
     Wraps CookieJar.clear(), is O(n).
     """
-    clearables = []
+    clearables: list[tuple[str, str, str]] = []
     for cookie in cookiejar:
         if cookie.name != name:
             continue
@@ -173,7 +188,7 @@ class CookieConflictError(RuntimeError):
     """
 
 
-class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
+class RequestsCookieJar(CookieJar, MutableMapping[str, str | None]):  # type: ignore[misc]
     """Compatibility class; is a http.cookiejar.CookieJar, but exposes a dict
     interface.
 
@@ -191,7 +206,15 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
     .. warning:: dictionary operations that are normally O(1) may be O(n).
     """
 
-    def get(self, name, default=None, domain=None, path=None):
+    _policy: CookiePolicy
+
+    def get(  # type: ignore[override]
+        self,
+        name: str,
+        default: str | None = None,
+        domain: str | None = None,
+        path: str | None = None,
+    ) -> str | None:
         """Dict-like get() that also supports optional domain and path args in
         order to resolve naming collisions from using one cookie jar over
         multiple domains.
@@ -203,7 +226,9 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         except KeyError:
             return default
 
-    def set(self, name, value, **kwargs):
+    def set(
+        self, name: str, value: str | Morsel[dict[str, str]] | None, **kwargs: Any
+    ) -> Cookie | None:
         """Dict-like set() that also supports optional domain and path args in
         order to resolve naming collisions from using one cookie jar over
         multiple domains.
@@ -222,7 +247,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         self.set_cookie(c)
         return c
 
-    def iterkeys(self):
+    def iterkeys(self) -> Iterator[str]:
         """Dict-like iterkeys() that returns an iterator of names of cookies
         from the jar.
 
@@ -231,7 +256,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         for cookie in iter(self):
             yield cookie.name
 
-    def keys(self):
+    def keys(self) -> list[str]:  # type: ignore[override]
         """Dict-like keys() that returns a list of names of cookies from the
         jar.
 
@@ -239,7 +264,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         """
         return list(self.iterkeys())
 
-    def itervalues(self):
+    def itervalues(self) -> Iterator[str | None]:
         """Dict-like itervalues() that returns an iterator of values of cookies
         from the jar.
 
@@ -248,7 +273,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         for cookie in iter(self):
             yield cookie.value
 
-    def values(self):
+    def values(self) -> list[str | None]:  # type: ignore[override]
         """Dict-like values() that returns a list of values of cookies from the
         jar.
 
@@ -256,7 +281,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         """
         return list(self.itervalues())
 
-    def iteritems(self):
+    def iteritems(self) -> Iterator[tuple[str, str | None]]:
         """Dict-like iteritems() that returns an iterator of name-value tuples
         from the jar.
 
@@ -265,7 +290,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         for cookie in iter(self):
             yield cookie.name, cookie.value
 
-    def items(self):
+    def items(self) -> list[tuple[str, str | None]]:  # type: ignore[override]
         """Dict-like items() that returns a list of name-value tuples from the
         jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a
         vanilla python dict of key value pairs.
@@ -274,43 +299,45 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         """
         return list(self.iteritems())
 
-    def list_domains(self):
+    def list_domains(self) -> list[str]:
         """Utility method to list all the domains in the jar."""
-        domains = []
+        domains: list[str] = []
         for cookie in iter(self):
             if cookie.domain not in domains:
                 domains.append(cookie.domain)
         return domains
 
-    def list_paths(self):
+    def list_paths(self) -> list[str]:
         """Utility method to list all the paths in the jar."""
-        paths = []
+        paths: list[str] = []
         for cookie in iter(self):
             if cookie.path not in paths:
                 paths.append(cookie.path)
         return paths
 
-    def multiple_domains(self):
+    def multiple_domains(self) -> bool:
         """Returns True if there are multiple domains in the jar.
         Returns False otherwise.
 
         :rtype: bool
         """
-        domains = []
+        domains: list[str] = []
         for cookie in iter(self):
-            if cookie.domain is not None and cookie.domain in domains:
+            if cookie.domain is not None and cookie.domain in domains:  # type: ignore[reportUnnecessaryComparison]  # defensive check
                 return True
             domains.append(cookie.domain)
         return False  # there is only one domain in jar
 
-    def get_dict(self, domain=None, path=None):
+    def get_dict(
+        self, domain: str | None = None, path: str | None = None
+    ) -> dict[str, str | None]:
         """Takes as an argument an optional domain and path and returns a plain
         old Python dict of name-value pairs of cookies that meet the
         requirements.
 
         :rtype: dict
         """
-        dictionary = {}
+        dictionary: dict[str, str | None] = {}
         for cookie in iter(self):
             if (domain is None or cookie.domain == domain) and (
                 path is None or cookie.path == path
@@ -318,13 +345,17 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
                 dictionary[cookie.name] = cookie.value
         return dictionary
 
-    def __contains__(self, name):
+    def __iter__(self) -> Iterator[Cookie]:  # type: ignore[override]
+        """RequestCookieJar's __iter__ comes from CookieJar not MutableMapping."""
+        return super().__iter__()
+
+    def __contains__(self, name: object) -> bool:
         try:
             return super().__contains__(name)
         except CookieConflictError:
             return True
 
-    def __getitem__(self, name):
+    def __getitem__(self, name: str) -> str | None:
         """Dict-like __getitem__() for compatibility with client code. Throws
         exception if there are more than one cookie with name. In that case,
         use the more explicit get() method instead.
@@ -333,29 +364,33 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         """
         return self._find_no_duplicates(name)
 
-    def __setitem__(self, name, value):
+    def __setitem__(
+        self, name: str, value: str | Morsel[dict[str, str]] | None
+    ) -> None:
         """Dict-like __setitem__ for compatibility with client code. Throws
         exception if there is already a cookie of that name in the jar. In that
         case, use the more explicit set() method instead.
         """
         self.set(name, value)
 
-    def __delitem__(self, name):
+    def __delitem__(self, name: str) -> None:
         """Deletes a cookie given a name. Wraps ``http.cookiejar.CookieJar``'s
         ``remove_cookie_by_name()``.
         """
         remove_cookie_by_name(self, name)
 
-    def set_cookie(self, cookie, *args, **kwargs):
+    def set_cookie(self, cookie: Cookie, *args: Any, **kwargs: Any) -> None:
         if (
-            hasattr(cookie.value, "startswith")
-            and cookie.value.startswith('"')
-            and cookie.value.endswith('"')
+            (value := cookie.value) is not None
+            and value.startswith('"')
+            and value.endswith('"')
         ):
-            cookie.value = cookie.value.replace('\\"', "")
+            cookie.value = value.replace('\\"', "")
         return super().set_cookie(cookie, *args, **kwargs)
 
-    def update(self, other):
+    def update(  # type: ignore[override]
+        self, other: CookieJar | SupportsKeysAndGetItem[str, str]
+    ) -> None:
         """Updates this jar with cookies from another CookieJar or dict-like"""
         if isinstance(other, cookielib.CookieJar):
             for cookie in other:
@@ -363,7 +398,9 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         else:
             super().update(other)
 
-    def _find(self, name, domain=None, path=None):
+    def _find(
+        self, name: str, domain: str | None = None, path: str | None = None
+    ) -> str | None:
         """Requests uses this method internally to get cookie values.
 
         If there are conflicting cookies, _find arbitrarily chooses one.
@@ -383,7 +420,9 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
 
         raise KeyError(f"name={name!r}, domain={domain!r}, path={path!r}")
 
-    def _find_no_duplicates(self, name, domain=None, path=None):
+    def _find_no_duplicates(
+        self, name: str, domain: str | None = None, path: str | None = None
+    ) -> str:
         """Both ``__get_item__`` and ``get`` call this function: it's never
         used elsewhere in Requests.
 
@@ -408,42 +447,42 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
                         # we will eventually return this as long as no cookie conflict
                         toReturn = cookie.value
 
-        if toReturn:
+        if toReturn is not None:
             return toReturn
         raise KeyError(f"name={name!r}, domain={domain!r}, path={path!r}")
 
-    def __getstate__(self):
+    def __getstate__(self) -> dict[str, Any]:
         """Unlike a normal CookieJar, this class is pickleable."""
         state = self.__dict__.copy()
         # remove the unpickleable RLock object
         state.pop("_cookies_lock")
         return state
 
-    def __setstate__(self, state):
+    def __setstate__(self, state: dict[str, Any]) -> None:
         """Unlike a normal CookieJar, this class is pickleable."""
         self.__dict__.update(state)
         if "_cookies_lock" not in self.__dict__:
             self._cookies_lock = threading.RLock()
 
-    def copy(self):
+    def copy(self) -> RequestsCookieJar:
         """Return a copy of this RequestsCookieJar."""
         new_cj = RequestsCookieJar()
         new_cj.set_policy(self.get_policy())
         new_cj.update(self)
         return new_cj
 
-    def get_policy(self):
+    def get_policy(self) -> CookiePolicy:
         """Return the CookiePolicy instance used."""
         return self._policy
 
 
-def _copy_cookie_jar(jar):
+def _copy_cookie_jar(jar: CookieJar | None) -> CookieJar | None:  # type: ignore[reportUnusedFunction]  # cross-module usage in models.py
     if jar is None:
         return None
 
-    if hasattr(jar, "copy"):
+    if copy_method := getattr(jar, "copy", None):
         # We're dealing with an instance of RequestsCookieJar
-        return jar.copy()
+        return copy_method()
     # We're dealing with a generic CookieJar instance
     new_jar = copy.copy(jar)
     new_jar.clear()
@@ -452,13 +491,13 @@ def _copy_cookie_jar(jar):
     return new_jar
 
 
-def create_cookie(name, value, **kwargs):
+def create_cookie(name: str, value: str, **kwargs: Any) -> Cookie:
     """Make a cookie from underspecified parameters.
 
     By default, the pair of `name` and `value` will be set for the domain ''
     and sent on every request (this is sometimes called a "supercookie").
     """
-    result = {
+    result: dict[str, Any] = {
         "version": 0,
         "name": name,
         "value": value,
@@ -489,10 +528,10 @@ def create_cookie(name, value, **kwargs):
     return cookielib.Cookie(**result)
 
 
-def morsel_to_cookie(morsel):
+def morsel_to_cookie(morsel: Morsel[Any]) -> Cookie:
     """Convert a Morsel object into a Cookie containing the one k/v pair."""
 
-    expires = None
+    expires: int | None = None
     if morsel["max-age"]:
         try:
             expires = int(time.time() + int(morsel["max-age"]))
@@ -518,7 +557,30 @@ def morsel_to_cookie(morsel):
     )
 
 
-def cookiejar_from_dict(cookie_dict, cookiejar=None, overwrite=True):
+_CookieJarT = TypeVar("_CookieJarT", bound=CookieJar)
+
+
+@overload
+def cookiejar_from_dict(
+    cookie_dict: dict[str, str] | None,
+    cookiejar: None = None,
+    overwrite: bool = True,
+) -> RequestsCookieJar: ...
+
+
+@overload
+def cookiejar_from_dict(
+    cookie_dict: dict[str, str] | None,
+    cookiejar: _CookieJarT,
+    overwrite: bool = True,
+) -> _CookieJarT: ...
+
+
+def cookiejar_from_dict(
+    cookie_dict: dict[str, str] | None,
+    cookiejar: CookieJar | None = None,
+    overwrite: bool = True,
+) -> CookieJar:
     """Returns a CookieJar from a key/value dictionary.
 
     :param cookie_dict: Dict of key/values to insert into CookieJar.
@@ -539,22 +601,24 @@ def cookiejar_from_dict(cookie_dict, cookiejar=None, overwrite=True):
     return cookiejar
 
 
-def merge_cookies(cookiejar, cookies):
+def merge_cookies(
+    cookiejar: CookieJar, cookies: dict[str, str] | CookieJar | None
+) -> CookieJar:
     """Add cookies to cookiejar and returns a merged CookieJar.
 
     :param cookiejar: CookieJar object to add the cookies to.
     :param cookies: Dictionary or CookieJar object to be added.
     :rtype: CookieJar
     """
-    if not isinstance(cookiejar, cookielib.CookieJar):
+    if not isinstance(cookiejar, cookielib.CookieJar):  # type: ignore[reportUnnecessaryIsInstance]  # runtime guard
         raise ValueError("You can only merge into CookieJar")
 
     if isinstance(cookies, dict):
         cookiejar = cookiejar_from_dict(cookies, cookiejar=cookiejar, overwrite=False)
     elif isinstance(cookies, cookielib.CookieJar):
-        try:
-            cookiejar.update(cookies)
-        except AttributeError:
+        if update_method := getattr(cookiejar, "update", None):
+            update_method(cookies)
+        else:
             for cookie_in_jar in cookies:
                 cookiejar.set_cookie(cookie_in_jar)
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/exceptions.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/exceptions.py
index 7f3660f..3de8f0d 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/exceptions.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/exceptions.py
@@ -4,23 +4,34 @@ requests.exceptions
 
 This module contains the set of Requests' exceptions.
 """
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
 from pip._vendor.urllib3.exceptions import HTTPError as BaseHTTPError
 
 from .compat import JSONDecodeError as CompatJSONDecodeError
 
+if TYPE_CHECKING:
+    from .models import PreparedRequest, Request, Response
+
 
 class RequestException(IOError):
     """There was an ambiguous exception that occurred while handling your
     request.
     """
 
-    def __init__(self, *args, **kwargs):
+    response: Response | None
+    request: Request | PreparedRequest | None
+
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
         """Initialize RequestException with `request` and `response` objects."""
-        response = kwargs.pop("response", None)
+        response: Response | None = kwargs.pop("response", None)
         self.response = response
         self.request = kwargs.pop("request", None)
         if response is not None and not self.request and hasattr(response, "request"):
-            self.request = self.response.request
+            self.request = response.request
         super().__init__(*args, **kwargs)
 
 
@@ -31,7 +42,7 @@ class InvalidJSONError(RequestException):
 class JSONDecodeError(InvalidJSONError, CompatJSONDecodeError):
     """Couldn't decode the text into json"""
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
         """
         Construct the JSONDecodeError instance first with all
         args. Then use it's args to construct the IOError so that
@@ -41,7 +52,7 @@ class JSONDecodeError(InvalidJSONError, CompatJSONDecodeError):
         CompatJSONDecodeError.__init__(self, *args)
         InvalidJSONError.__init__(self, *self.args, **kwargs)
 
-    def __reduce__(self):
+    def __reduce__(self) -> tuple[Any, ...] | str:
         """
         The __reduce__ method called when pickling the object must
         be the one from the JSONDecodeError (be it json/simplejson)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/help.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/help.py
index ddbb615..33f2d57 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/help.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/help.py
@@ -1,9 +1,12 @@
 """Module containing bug report helper(s)."""
 
+# pyright: reportUnknownMemberType=false
+
 import json
 import platform
 import ssl
 import sys
+from typing import Any
 
 from pip._vendor import idna
 from pip._vendor import urllib3
@@ -20,8 +23,8 @@ except ImportError:
     OpenSSL = None
     cryptography = None
 else:
-    import cryptography
-    import OpenSSL
+    import cryptography  # type: ignore[import-not-found]
+    import OpenSSL  # type: ignore[import-not-found]
 
 
 def _implementation():
@@ -40,14 +43,11 @@ def _implementation():
     if implementation == "CPython":
         implementation_version = platform.python_version()
     elif implementation == "PyPy":
-        implementation_version = "{}.{}.{}".format(
-            sys.pypy_version_info.major,
-            sys.pypy_version_info.minor,
-            sys.pypy_version_info.micro,
-        )
-        if sys.pypy_version_info.releaselevel != "final":
+        pypy = sys.pypy_version_info  # type: ignore[attr-defined]
+        implementation_version = f"{pypy.major}.{pypy.minor}.{pypy.micro}"
+        if sys.pypy_version_info.releaselevel != "final":  # type: ignore[attr-defined]
             implementation_version = "".join(
-                [implementation_version, sys.pypy_version_info.releaselevel]
+                [implementation_version, sys.pypy_version_info.releaselevel]  # type: ignore[attr-defined]
             )
     elif implementation == "Jython":
         implementation_version = platform.python_version()  # Complete Guess
@@ -59,7 +59,7 @@ def _implementation():
     return {"name": implementation, "version": implementation_version}
 
 
-def info():
+def info() -> dict[str, Any]:
     """Generate information for a bug report."""
     try:
         platform_info = {
@@ -73,15 +73,15 @@ def info():
         }
 
     implementation_info = _implementation()
-    urllib3_info = {"version": urllib3.__version__}
+    urllib3_info = {"version": urllib3.__version__}  # type: ignore[reportPrivateImportUsage]
     charset_normalizer_info = {"version": None}
-    chardet_info = {"version": None}
+    chardet_info: dict[str, str | None] = {"version": None}
     if charset_normalizer:
         charset_normalizer_info = {"version": charset_normalizer.__version__}
     if chardet:
         chardet_info = {"version": chardet.__version__}
 
-    pyopenssl_info = {
+    pyopenssl_info: dict[str, str | None] = {
         "version": None,
         "openssl_version": "",
     }
@@ -98,7 +98,7 @@ def info():
     }
 
     system_ssl = ssl.OPENSSL_VERSION_NUMBER
-    system_ssl_info = {"version": f"{system_ssl:x}" if system_ssl is not None else ""}
+    system_ssl_info = {"version": f"{system_ssl:x}" if system_ssl is not None else ""}  # type: ignore[reportUnnecessaryComparison]
 
     return {
         "platform": platform_info,
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/hooks.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/hooks.py
index d181ba2..11ff9e9 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/hooks.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/hooks.py
@@ -9,24 +9,39 @@ Available hooks:
 ``response``:
     The response generated from a Request.
 """
-HOOKS = ["response"]
+
+from __future__ import annotations
+
+from collections.abc import Callable, Iterable
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from . import _types as _t
+    from .models import Response
+
+HOOKS: list[str] = ["response"]
 
 
-def default_hooks():
+def default_hooks() -> dict[str, list[_t.HookType]]:
     return {event: [] for event in HOOKS}
 
 
 # TODO: response is the only one
 
 
-def dispatch_hook(key, hooks, hook_data, **kwargs):
+def dispatch_hook(
+    key: str,
+    hooks: _t.HooksInputType | None,
+    hook_data: Response,
+    **kwargs: Any,
+) -> Response:
     """Dispatches a hook dictionary on a given piece of data."""
-    hooks = hooks or {}
-    hooks = hooks.get(key)
-    if hooks:
-        if hasattr(hooks, "__call__"):
-            hooks = [hooks]
-        for hook in hooks:
+    hooks_dict = hooks or {}
+    hook_list: Iterable[_t.HookType] | _t.HookType | None = hooks_dict.get(key)
+    if hook_list:
+        if isinstance(hook_list, Callable):
+            hook_list = [hook_list]
+        for hook in hook_list:
             _hook_data = hook(hook_data, **kwargs)
             if _hook_data is not None:
                 hook_data = _hook_data
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/models.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/models.py
index 22de95c..3a70ae5 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/models.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/models.py
@@ -5,13 +5,24 @@ requests.models
 This module contains the primary objects that power Requests.
 """
 
+from __future__ import annotations
+
 import datetime
 
 # Import encoding now, to avoid implicit import later.
 # Implicit import within threads may cause LookupError when standard library is in a ZIP,
 # such as in Embedded Python. See https://github.com/psf/requests/issues/3578.
-import encodings.idna  # noqa: F401
+import encodings.idna  # noqa: F401  # type: ignore[reportUnusedImport]
+from collections.abc import Callable, Generator, Iterable, Iterator, Mapping
 from io import UnsupportedOperation
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Final,
+    Literal,
+    cast,
+    overload,
+)
 
 from pip._vendor.urllib3.exceptions import (
     DecodeError,
@@ -25,19 +36,24 @@ from pip._vendor.urllib3.filepost import encode_multipart_formdata
 from pip._vendor.urllib3.util import parse_url
 
 from ._internal_utils import to_native_string, unicode_is_ascii
+from ._types import SupportsRead as _SupportsRead
 from .auth import HTTPBasicAuth
 from .compat import (
-    Callable,
     JSONDecodeError,
-    Mapping,
     basestring,
     builtin_str,
     chardet,
     cookielib,
+    urlencode,
+    urlsplit,
+    urlunparse,
 )
 from .compat import json as complexjson
-from .compat import urlencode, urlsplit, urlunparse
-from .cookies import _copy_cookie_jar, cookiejar_from_dict, get_cookie_header
+from .cookies import (
+    _copy_cookie_jar,  # type: ignore[reportPrivateUsage]
+    cookiejar_from_dict,
+    get_cookie_header,
+)
 from .exceptions import (
     ChunkedEncodingError,
     ConnectionError,
@@ -45,11 +61,11 @@ from .exceptions import (
     HTTPError,
     InvalidJSONError,
     InvalidURL,
+    MissingSchema,
+    StreamConsumedError,
 )
 from .exceptions import JSONDecodeError as RequestsJSONDecodeError
-from .exceptions import MissingSchema
 from .exceptions import SSLError as RequestsSSLError
-from .exceptions import StreamConsumedError
 from .hooks import default_hooks
 from .status_codes import codes
 from .structures import CaseInsensitiveDict
@@ -66,9 +82,18 @@ from .utils import (
     to_key_val_list,
 )
 
+if TYPE_CHECKING:
+    from http.cookiejar import CookieJar
+
+    from typing_extensions import Self
+
+    from . import _types as _t
+    from .adapters import HTTPAdapter
+    from .cookies import RequestsCookieJar
+
 #: The set of HTTP status codes that indicate an automatically
 #: processable redirect.
-REDIRECT_STATI = (
+REDIRECT_STATI: Final[tuple[int, ...]] = (  # type: ignore[assignment]
     codes.moved,  # 301
     codes.found,  # 302
     codes.other,  # 303
@@ -76,19 +101,21 @@ REDIRECT_STATI = (
     codes.permanent_redirect,  # 308
 )
 
-DEFAULT_REDIRECT_LIMIT = 30
-CONTENT_CHUNK_SIZE = 10 * 1024
-ITER_CHUNK_SIZE = 512
+DEFAULT_REDIRECT_LIMIT: int = 30
+CONTENT_CHUNK_SIZE: int = 10 * 1024
+ITER_CHUNK_SIZE: int = 512
 
 
 class RequestEncodingMixin:
+    url: str | None
+
     @property
-    def path_url(self):
+    def path_url(self) -> str:
         """Build the path URL to use."""
 
-        url = []
+        url: list[str] = []
 
-        p = urlsplit(self.url)
+        p = urlsplit(cast(str, self.url))
 
         path = p.path
         if not path:
@@ -103,8 +130,28 @@ class RequestEncodingMixin:
 
         return "".join(url)
 
+    @overload
     @staticmethod
-    def _encode_params(data):
+    def _encode_params(data: str) -> str: ...
+
+    @overload
+    @staticmethod
+    def _encode_params(data: bytes) -> bytes: ...
+
+    @overload
+    @staticmethod
+    def _encode_params(
+        data: _t.SupportsRead[str | bytes],
+    ) -> _t.SupportsRead[str | bytes]: ...
+
+    @overload
+    @staticmethod
+    def _encode_params(data: _t.KVDataType) -> str: ...
+
+    @staticmethod
+    def _encode_params(
+        data: _t.EncodableDataType,
+    ) -> str | bytes | _t.SupportsRead[str | bytes]:
         """Encode parameters in a piece of data.
 
         Will successfully encode parameters when passed as a dict or a list of
@@ -114,10 +161,10 @@ class RequestEncodingMixin:
 
         if isinstance(data, (str, bytes)):
             return data
-        elif hasattr(data, "read"):
+        elif isinstance(data, _SupportsRead):
             return data
         elif hasattr(data, "__iter__"):
-            result = []
+            result: list[tuple[bytes, bytes]] = []
             for k, vs in to_key_val_list(data):
                 if isinstance(vs, basestring) or not hasattr(vs, "__iter__"):
                     vs = [vs]
@@ -131,10 +178,12 @@ class RequestEncodingMixin:
                         )
             return urlencode(result, doseq=True)
         else:
-            return data
+            return data  # type: ignore[return-value]  # unreachable for valid _t.DataType
 
     @staticmethod
-    def _encode_files(files, data):
+    def _encode_files(
+        files: _t.FilesType, data: _t.RawDataType | None
+    ) -> tuple[bytes, str]:
         """Build the body for a multipart/form-data request.
 
         Will successfully encode files when passed as a dict or a list of
@@ -148,7 +197,7 @@ class RequestEncodingMixin:
         elif isinstance(data, basestring):
             raise ValueError("Data must not be a string.")
 
-        new_fields = []
+        new_fields: list[RequestField | tuple[str, bytes]] = []
         fields = to_key_val_list(data or {})
         files = to_key_val_list(files or {})
 
@@ -187,9 +236,9 @@ class RequestEncodingMixin:
 
             if isinstance(fp, (str, bytes, bytearray)):
                 fdata = fp
-            elif hasattr(fp, "read"):
+            elif isinstance(fp, _SupportsRead):  # type: ignore[reportUnnecessaryIsInstance]  # defensive check for untyped callers
                 fdata = fp.read()
-            elif fp is None:
+            elif fp is None:  # type: ignore[reportUnnecessaryComparison]  # defensive check for untyped callers
                 continue
             else:
                 fdata = fp
@@ -204,7 +253,11 @@ class RequestEncodingMixin:
 
 
 class RequestHooksMixin:
-    def register_hook(self, event, hook):
+    hooks: dict[str, list[_t.HookType]]
+
+    def register_hook(
+        self, event: str, hook: Iterable[_t.HookType] | _t.HookType
+    ) -> None:
         """Properly register a hook."""
 
         if event not in self.hooks:
@@ -213,9 +266,9 @@ class RequestHooksMixin:
         if isinstance(hook, Callable):
             self.hooks[event].append(hook)
         elif hasattr(hook, "__iter__"):
-            self.hooks[event].extend(h for h in hook if isinstance(h, Callable))
+            self.hooks[event].extend(h for h in hook if isinstance(h, Callable))  # type: ignore[reportUnnecessaryIsInstance]  # defensive runtime filter
 
-    def deregister_hook(self, event, hook):
+    def deregister_hook(self, event: str, hook: _t.HookType) -> bool:
         """Deregister a previously registered hook.
         Returns True if the hook existed, False if not.
         """
@@ -255,19 +308,29 @@ class Request(RequestHooksMixin):
       
     """
 
+    method: str | None
+    url: _t.UriType | None
+    headers: Mapping[str, str | bytes]
+    files: _t.FilesType
+    data: _t.DataType
+    json: _t.JsonType
+    params: _t.ParamsType
+    auth: _t.AuthType
+    cookies: RequestsCookieJar | CookieJar | dict[str, str] | None
+
     def __init__(
         self,
-        method=None,
-        url=None,
-        headers=None,
-        files=None,
-        data=None,
-        params=None,
-        auth=None,
-        cookies=None,
-        hooks=None,
-        json=None,
-    ):
+        method: str | None = None,
+        url: _t.UriType | None = None,
+        headers: _t.HeadersType = None,
+        files: _t.FilesType = None,
+        data: _t.DataType = None,
+        params: _t.ParamsType = None,
+        auth: _t.AuthType = None,
+        cookies: RequestsCookieJar | CookieJar | dict[str, str] | None = None,
+        hooks: _t.HooksInputType | None = None,
+        json: _t.JsonType = None,
+    ) -> None:
         # Default empty dicts for dict params.
         data = [] if data is None else data
         files = [] if files is None else files
@@ -289,10 +352,10 @@ class Request(RequestHooksMixin):
         self.auth = auth
         self.cookies = cookies
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f""
 
-    def prepare(self):
+    def prepare(self) -> PreparedRequest:
         """Constructs a :class:`PreparedRequest ` for transmission and returns it."""
         p = PreparedRequest()
         p.prepare(
@@ -331,13 +394,21 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
       
     """
 
-    def __init__(self):
+    method: str | None
+    url: str | None
+    headers: CaseInsensitiveDict[str | bytes]
+    _cookies: RequestsCookieJar | CookieJar | None
+    body: _t.BodyType
+    hooks: dict[str, list[_t.HookType]]
+    _body_position: int | object | None
+
+    def __init__(self) -> None:
         #: HTTP verb to send to the server.
         self.method = None
         #: HTTP URL to send the request to.
         self.url = None
         #: dictionary of HTTP headers.
-        self.headers = None
+        self.headers = None  # type: ignore[assignment]
         # The `CookieJar` used to create the Cookie header will be stored here
         # after prepare_cookies is called
         self._cookies = None
@@ -350,19 +421,20 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
 
     def prepare(
         self,
-        method=None,
-        url=None,
-        headers=None,
-        files=None,
-        data=None,
-        params=None,
-        auth=None,
-        cookies=None,
-        hooks=None,
-        json=None,
-    ):
+        method: str | None = None,
+        url: _t.UriType | None = None,
+        headers: Mapping[str, str | bytes] | None = None,
+        files: _t.FilesType = None,
+        data: _t.DataType = None,
+        params: _t.ParamsType = None,
+        auth: _t.AuthType = None,
+        cookies: RequestsCookieJar | CookieJar | dict[str, str] | None = None,
+        hooks: _t.HooksInputType | None = None,
+        json: _t.JsonType = None,
+    ) -> None:
         """Prepares the entire request with the given parameters."""
 
+        url = cast("_t.UriType", url)
         self.prepare_method(method)
         self.prepare_url(url, params)
         self.prepare_headers(headers)
@@ -376,28 +448,28 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         # This MUST go after prepare_auth. Authenticators could add a hook
         self.prepare_hooks(hooks)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f""
 
-    def copy(self):
+    def copy(self) -> PreparedRequest:
         p = PreparedRequest()
         p.method = self.method
         p.url = self.url
-        p.headers = self.headers.copy() if self.headers is not None else None
+        p.headers = self.headers.copy() if self.headers is not None else None  # type: ignore[assignment]
         p._cookies = _copy_cookie_jar(self._cookies)
         p.body = self.body
         p.hooks = self.hooks
         p._body_position = self._body_position
         return p
 
-    def prepare_method(self, method):
+    def prepare_method(self, method: str | None) -> None:
         """Prepares the given HTTP method."""
         self.method = method
         if self.method is not None:
             self.method = to_native_string(self.method.upper())
 
     @staticmethod
-    def _get_idna_encoded_host(host):
+    def _get_idna_encoded_host(host: str) -> str:
         from pip._vendor import idna
 
         try:
@@ -406,7 +478,11 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             raise UnicodeError
         return host
 
-    def prepare_url(self, url, params):
+    def prepare_url(
+        self,
+        url: _t.UriType,
+        params: _t.ParamsType,
+    ) -> None:
         """Prepares the given HTTP URL."""
         #: Accept objects that have string representations.
         #: We're unable to blindly call unicode/str functions
@@ -470,17 +546,21 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         if isinstance(params, (str, bytes)):
             params = to_native_string(params)
 
-        enc_params = self._encode_params(params)
+        if params is not None:
+            enc_params = self._encode_params(params)
+        else:
+            enc_params = ""
+
         if enc_params:
             if query:
                 query = f"{query}&{enc_params}"
             else:
                 query = enc_params
 
-        url = requote_uri(urlunparse([scheme, netloc, path, None, query, fragment]))
+        url = requote_uri(urlunparse((scheme, netloc, path, "", query, fragment)))
         self.url = url
 
-    def prepare_headers(self, headers):
+    def prepare_headers(self, headers: Mapping[str, str | bytes] | None) -> None:
         """Prepares the given HTTP headers."""
 
         self.headers = CaseInsensitiveDict()
@@ -491,7 +571,9 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
                 name, value = header
                 self.headers[to_native_string(name)] = value
 
-    def prepare_body(self, data, files, json=None):
+    def prepare_body(
+        self, data: _t.DataType, files: _t.FilesType, json: _t.JsonType = None
+    ) -> None:
         """Prepares the given HTTP body data."""
 
         # Check if file, fo, generator, iterator.
@@ -514,14 +596,9 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             if not isinstance(body, bytes):
                 body = body.encode("utf-8")
 
-        is_stream = all(
-            [
-                hasattr(data, "__iter__"),
-                not isinstance(data, (basestring, list, tuple, Mapping)),
-            ]
-        )
-
-        if is_stream:
+        # data that proxies attributes to underlying objects needs hasattr
+        is_iterable = isinstance(data, Iterable) or hasattr(data, "__iter__")
+        if is_iterable and not isinstance(data, (str, bytes, list, tuple, Mapping)):
             try:
                 length = super_len(data)
             except (TypeError, AttributeError, UnsupportedOperation):
@@ -534,7 +611,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
                 # This will allow us to rewind a file in the event
                 # of a redirect.
                 try:
-                    self._body_position = body.tell()
+                    self._body_position = body.tell()  # type: ignore[union-attr]  # guarded by getattr check
                 except OSError:
                     # This differentiates from None, allowing us to catch
                     # a failed `tell()` later when trying to rewind the body
@@ -550,13 +627,16 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             else:
                 self.headers["Transfer-Encoding"] = "chunked"
         else:
+            # After is_stream filtering, remaining data is raw (not streamed)
+            raw_data = cast("_t.RawDataType | None", data)
+
             # Multi-part file uploads.
             if files:
-                (body, content_type) = self._encode_files(files, data)
+                (body, content_type) = self._encode_files(files, raw_data)
             else:
-                if data:
-                    body = self._encode_params(data)
-                    if isinstance(data, basestring) or hasattr(data, "read"):
+                if raw_data:
+                    body = self._encode_params(raw_data)
+                    if isinstance(data, basestring) or isinstance(data, _SupportsRead):
                         content_type = None
                     else:
                         content_type = "application/x-www-form-urlencoded"
@@ -567,9 +647,9 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             if content_type and ("content-type" not in self.headers):
                 self.headers["Content-Type"] = content_type
 
-        self.body = body
+        self.body = body  # type: ignore[assignment]  # body transforms from DataType to BodyType
 
-    def prepare_content_length(self, body):
+    def prepare_content_length(self, body: _t.BodyType) -> None:
         """Prepare Content-Length header based on request method and body"""
         if body is not None:
             length = super_len(body)
@@ -585,21 +665,28 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             # but don't provide one. (i.e. not GET or HEAD)
             self.headers["Content-Length"] = "0"
 
-    def prepare_auth(self, auth, url=""):
+    def prepare_auth(
+        self,
+        auth: _t.AuthType,
+        url: _t.UriType = "",
+    ) -> None:
         """Prepares the given HTTP auth data."""
 
         # If no Auth is explicitly provided, extract it from the URL first.
         if auth is None:
-            url_auth = get_auth_from_url(self.url)
+            url_auth = get_auth_from_url(cast(str, self.url))
             auth = url_auth if any(url_auth) else None
 
         if auth:
-            if isinstance(auth, tuple) and len(auth) == 2:
+            if isinstance(auth, tuple) and len(auth) == 2:  # type: ignore[arg-type]  # pyright widens tuple from Callable in AuthType
                 # special-case basic HTTP auth
-                auth = HTTPBasicAuth(*auth)
+                auth_handler = HTTPBasicAuth(*auth)  # type: ignore[arg-type]  # pyright widens tuple from Callable in AuthType
+            else:
+                # TODO: can be fixed by flipping the conditionals
+                auth_handler = cast("Callable[..., PreparedRequest]", auth)
 
             # Allow auth to make its changes.
-            r = auth(self)
+            r = auth_handler(self)
 
             # Update self to reflect the auth changes.
             self.__dict__.update(r.__dict__)
@@ -607,7 +694,9 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             # Recompute Content-Length
             self.prepare_content_length(self.body)
 
-    def prepare_cookies(self, cookies):
+    def prepare_cookies(
+        self, cookies: RequestsCookieJar | CookieJar | dict[str, str] | None
+    ) -> None:
         """Prepares the given HTTP cookie data.
 
         This function eventually generates a ``Cookie`` header from the
@@ -623,16 +712,17 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         else:
             self._cookies = cookiejar_from_dict(cookies)
 
-        cookie_header = get_cookie_header(self._cookies, self)
+        cookies_jar = cast("CookieJar", self._cookies)
+        cookie_header = get_cookie_header(cookies_jar, self)
         if cookie_header is not None:
             self.headers["Cookie"] = cookie_header
 
-    def prepare_hooks(self, hooks):
+    def prepare_hooks(self, hooks: _t.HooksInputType | None) -> None:
         """Prepares the given hooks."""
         # hooks can be passed as None to the prepare method and to this
         # method. To prevent iterating over None, simply use an empty list
         # if hooks is False-y
-        hooks = hooks or []
+        hooks = hooks or {}
         for event in hooks:
             self.register_hook(event, hooks[event])
 
@@ -642,7 +732,22 @@ class Response:
     server's response to an HTTP request.
     """
 
-    __attrs__ = [
+    _content: bytes | Literal[False] | None
+    _content_consumed: bool
+    _next: PreparedRequest | None
+    status_code: int
+    headers: CaseInsensitiveDict[str]
+    raw: Any
+    url: str
+    encoding: str | None
+    history: list[Response]
+    reason: str
+    cookies: RequestsCookieJar
+    elapsed: datetime.timedelta
+    request: PreparedRequest
+    connection: HTTPAdapter
+
+    __attrs__: list[str] = [
         "_content",
         "status_code",
         "headers",
@@ -655,13 +760,13 @@ class Response:
         "request",
     ]
 
-    def __init__(self):
+    def __init__(self) -> None:
         self._content = False
         self._content_consumed = False
         self._next = None
 
         #: Integer Code of responded HTTP Status, e.g. 404 or 200.
-        self.status_code = None
+        self.status_code = None  # type: ignore[assignment]
 
         #: Case-insensitive Dictionary of Response Headers.
         #: For example, ``headers['content-encoding']`` will return the
@@ -674,7 +779,7 @@ class Response:
         self.raw = None
 
         #: Final URL location of Response.
-        self.url = None
+        self.url = None  # type: ignore[assignment]
 
         #: Encoding to decode with when accessing r.text.
         self.encoding = None
@@ -685,7 +790,7 @@ class Response:
         self.history = []
 
         #: Textual reason of responded HTTP Status, e.g. "Not Found" or "OK".
-        self.reason = None
+        self.reason = None  # type: ignore[assignment]
 
         #: A CookieJar of Cookies the server sent back.
         self.cookies = cookiejar_from_dict({})
@@ -700,15 +805,15 @@ class Response:
 
         #: The :class:`PreparedRequest ` object to which this
         #: is a response.
-        self.request = None
+        self.request = None  # type: ignore[assignment]
 
-    def __enter__(self):
+    def __enter__(self) -> Self:
         return self
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: Any) -> None:
         self.close()
 
-    def __getstate__(self):
+    def __getstate__(self) -> dict[str, Any]:
         # Consume everything; accessing the content attribute makes
         # sure the content has been fully read.
         if not self._content_consumed:
@@ -716,7 +821,7 @@ class Response:
 
         return {attr: getattr(self, attr, None) for attr in self.__attrs__}
 
-    def __setstate__(self, state):
+    def __setstate__(self, state: dict[str, Any]) -> None:
         for name, value in state.items():
             setattr(self, name, value)
 
@@ -724,10 +829,10 @@ class Response:
         setattr(self, "_content_consumed", True)
         setattr(self, "raw", None)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f""
 
-    def __bool__(self):
+    def __bool__(self) -> bool:
         """Returns True if :attr:`status_code` is less than 400.
 
         This attribute checks if the status code of the response is between
@@ -737,7 +842,7 @@ class Response:
         """
         return self.ok
 
-    def __nonzero__(self):
+    def __nonzero__(self) -> bool:
         """Returns True if :attr:`status_code` is less than 400.
 
         This attribute checks if the status code of the response is between
@@ -747,12 +852,12 @@ class Response:
         """
         return self.ok
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[bytes]:
         """Allows you to use a response as an iterator."""
         return self.iter_content(128)
 
     @property
-    def ok(self):
+    def ok(self) -> bool:
         """Returns True if :attr:`status_code` is less than 400, False if not.
 
         This attribute checks if the status code of the response is between
@@ -767,14 +872,14 @@ class Response:
         return True
 
     @property
-    def is_redirect(self):
+    def is_redirect(self) -> bool:
         """True if this Response is a well-formed HTTP redirect that could have
         been processed automatically (by :meth:`Session.resolve_redirects`).
         """
         return "location" in self.headers and self.status_code in REDIRECT_STATI
 
     @property
-    def is_permanent_redirect(self):
+    def is_permanent_redirect(self) -> bool:
         """True if this Response one of the permanent versions of redirect."""
         return "location" in self.headers and self.status_code in (
             codes.moved_permanently,
@@ -782,12 +887,12 @@ class Response:
         )
 
     @property
-    def next(self):
+    def next(self) -> PreparedRequest | None:
         """Returns a PreparedRequest for the next request in a redirect chain, if there is one."""
         return self._next
 
     @property
-    def apparent_encoding(self):
+    def apparent_encoding(self) -> str | None:
         """The apparent encoding, provided by the charset_normalizer or chardet libraries."""
         if chardet is not None:
             return chardet.detect(self.content)["encoding"]
@@ -796,7 +901,17 @@ class Response:
             # to a standard Python utf-8 str.
             return "utf-8"
 
-    def iter_content(self, chunk_size=1, decode_unicode=False):
+    @overload
+    def iter_content(
+        self, chunk_size: int | None = 1, decode_unicode: Literal[False] = False
+    ) -> Iterator[bytes]: ...
+    @overload
+    def iter_content(
+        self, chunk_size: int | None = 1, *, decode_unicode: Literal[True]
+    ) -> Iterator[str | bytes]: ...
+    def iter_content(
+        self, chunk_size: int | None = 1, decode_unicode: bool = False
+    ) -> Iterator[str | bytes]:
         """Iterates over the response data.  When stream=True is set on the
         request, this avoids reading the content at once into memory for
         large responses.  The chunk size is the number of bytes it should
@@ -809,11 +924,13 @@ class Response:
         chunks are received. If stream=False, data is returned as
         a single chunk.
 
-        If decode_unicode is True, content will be decoded using the best
-        available encoding based on the response.
+        If decode_unicode is True, content will be decoded using encoding
+        information from the response. If no encoding information is available,
+        bytes will be returned. This can be bypassed by manually setting
+        `encoding` on the response.
         """
 
-        def generate():
+        def generate() -> Generator[bytes, None, None]:
             # Special case for urllib3.
             if hasattr(self.raw, "stream"):
                 try:
@@ -838,42 +955,65 @@ class Response:
 
         if self._content_consumed and isinstance(self._content, bool):
             raise StreamConsumedError()
-        elif chunk_size is not None and not isinstance(chunk_size, int):
+        elif chunk_size is not None and not isinstance(chunk_size, int):  # type: ignore[reportUnnecessaryIsInstance]  # runtime guard for untyped callers
             raise TypeError(
                 f"chunk_size must be an int, it is instead a {type(chunk_size)}."
             )
-        # simulate reading small chunks of the content
-        reused_chunks = iter_slices(self._content, chunk_size)
 
-        stream_chunks = generate()
-
-        chunks = reused_chunks if self._content_consumed else stream_chunks
+        if self._content_consumed:
+            # simulate reading small chunks of the content
+            content = cast(bytes, self._content)
+            chunks = iter_slices(content, chunk_size)
+        else:
+            chunks = generate()
 
         if decode_unicode:
             chunks = stream_decode_response_unicode(chunks, self)
 
         return chunks
 
+    @overload
     def iter_lines(
-        self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=False, delimiter=None
-    ):
+        self,
+        chunk_size: int = ITER_CHUNK_SIZE,
+        decode_unicode: Literal[False] = False,
+        delimiter: bytes | None = None,
+    ) -> Iterator[bytes]: ...
+    @overload
+    def iter_lines(
+        self,
+        chunk_size: int = ITER_CHUNK_SIZE,
+        *,
+        decode_unicode: Literal[True],
+        delimiter: str | bytes | None = None,
+    ) -> Iterator[str | bytes]: ...
+    def iter_lines(
+        self,
+        chunk_size: int = ITER_CHUNK_SIZE,
+        decode_unicode: bool = False,
+        delimiter: str | bytes | None = None,
+    ) -> Iterator[str | bytes]:
         """Iterates over the response data, one line at a time.  When
         stream=True is set on the request, this avoids reading the
         content at once into memory for large responses.
 
+        The decode_unicode param works the same as in `iter_content`, with the
+        same caveats.
+
         .. note:: This method is not reentrant safe.
         """
 
-        pending = None
+        pending: str | bytes | None = None
 
         for chunk in self.iter_content(
             chunk_size=chunk_size, decode_unicode=decode_unicode
         ):
             if pending is not None:
-                chunk = pending + chunk
+                # TODO: remove cast after iter_lines rewrite
+                chunk = cast("str | bytes", pending + chunk)  # type: ignore[operator]
 
             if delimiter:
-                lines = chunk.split(delimiter)
+                lines = chunk.split(delimiter)  # type: ignore[arg-type]
             else:
                 lines = chunk.splitlines()
 
@@ -888,7 +1028,7 @@ class Response:
             yield pending
 
     @property
-    def content(self):
+    def content(self) -> bytes:
         """Content of the response, in bytes."""
 
         if self._content is False:
@@ -904,10 +1044,10 @@ class Response:
         self._content_consumed = True
         # don't need to release the connection; that's been handled by urllib3
         # since we exhausted the data.
-        return self._content
+        return self._content  # type: ignore[return-value]
 
     @property
-    def text(self):
+    def text(self) -> str:
         """Content of the response, in unicode.
 
         If Response.encoding is None, encoding will be guessed using
@@ -932,7 +1072,7 @@ class Response:
 
         # Decode unicode from given encoding.
         try:
-            content = str(self.content, encoding, errors="replace")
+            content = str(self.content, encoding or "utf-8", errors="replace")
         except (LookupError, TypeError):
             # A LookupError is raised if the encoding was not found which could
             # indicate a misspelling or similar mistake.
@@ -944,7 +1084,7 @@ class Response:
 
         return content
 
-    def json(self, **kwargs):
+    def json(self, **kwargs: Any) -> Any:
         r"""Decodes the JSON response body (if any) as a Python object.
 
         This may return a dictionary, list, etc. depending on what is in the response.
@@ -980,23 +1120,24 @@ class Response:
             raise RequestsJSONDecodeError(e.msg, e.doc, e.pos)
 
     @property
-    def links(self):
+    def links(self) -> dict[str, dict[str, str]]:
         """Returns the parsed header links of the response, if any."""
 
         header = self.headers.get("link")
 
-        resolved_links = {}
+        resolved_links: dict[str, dict[str, str]] = {}
 
         if header:
             links = parse_header_links(header)
 
             for link in links:
                 key = link.get("rel") or link.get("url")
-                resolved_links[key] = link
+                if key is not None:
+                    resolved_links[key] = link
 
         return resolved_links
 
-    def raise_for_status(self):
+    def raise_for_status(self) -> None:
         """Raises :class:`HTTPError`, if one occurred."""
 
         http_error_msg = ""
@@ -1025,7 +1166,7 @@ class Response:
         if http_error_msg:
             raise HTTPError(http_error_msg, response=self)
 
-    def close(self):
+    def close(self) -> None:
         """Releases the connection back to the pool. Once this method has been
         called the underlying ``raw`` object must not be accessed again.
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/sessions.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/sessions.py
index 731550d..feaf340 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/sessions.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/sessions.py
@@ -5,16 +5,22 @@ requests.sessions
 This module provides a Session object to manage and persist settings across
 requests (cookies, auth, proxies).
 """
+
+from __future__ import annotations
+
 import os
 import sys
 import time
 from collections import OrderedDict
+from collections.abc import Generator, Mapping, MutableMapping
 from datetime import timedelta
+from typing import TYPE_CHECKING, Any, cast
 
 from ._internal_utils import to_native_string
+from ._types import is_prepared as _is_prepared
 from .adapters import HTTPAdapter
-from .auth import _basic_auth_str
-from .compat import Mapping, cookielib, urljoin, urlparse
+from .auth import _basic_auth_str  # type: ignore[reportPrivateUsage]
+from .compat import cookielib, urljoin, urlparse
 from .cookies import (
     RequestsCookieJar,
     cookiejar_from_dict,
@@ -32,9 +38,10 @@ from .hooks import default_hooks, dispatch_hook
 # formerly defined here, reexposed here for backward compatibility
 from .models import (  # noqa: F401
     DEFAULT_REDIRECT_LIMIT,
-    REDIRECT_STATI,
+    REDIRECT_STATI,  # type: ignore[reportUnusedImport]
     PreparedRequest,
     Request,
+    Response,
 )
 from .status_codes import codes
 from .structures import CaseInsensitiveDict
@@ -47,10 +54,18 @@ from .utils import (  # noqa: F401
     requote_uri,
     resolve_proxies,
     rewind_body,
-    should_bypass_proxies,
+    should_bypass_proxies,  # type: ignore[reportUnusedImport]  # re-export for external consumers
     to_key_val_list,
 )
 
+if TYPE_CHECKING:
+    from http.cookiejar import CookieJar
+
+    from typing_extensions import Self, Unpack
+
+    from . import _types as _t
+    from .adapters import BaseAdapter
+
 # Preferred clock, based on which one is more accurate on a given system.
 if sys.platform == "win32":
     preferred_clock = time.perf_counter
@@ -58,7 +73,9 @@ else:
     preferred_clock = time.time
 
 
-def merge_setting(request_setting, session_setting, dict_class=OrderedDict):
+def merge_setting(
+    request_setting: Any, session_setting: Any, dict_class: type = OrderedDict
+) -> Any:
     """Determines appropriate setting for a given request, taking into account
     the explicit setting on that request, and the setting in the session. If a
     setting is a dictionary, they will be merged together using `dict_class`
@@ -76,8 +93,8 @@ def merge_setting(request_setting, session_setting, dict_class=OrderedDict):
     ):
         return request_setting
 
-    merged_setting = dict_class(to_key_val_list(session_setting))
-    merged_setting.update(to_key_val_list(request_setting))
+    merged_setting = dict_class(to_key_val_list(session_setting))  # type: ignore[arg-type]  # isinstance narrows Any to Mapping[Unknown]
+    merged_setting.update(to_key_val_list(request_setting))  # type: ignore[arg-type]
 
     # Remove keys that are set to None. Extract keys first to avoid altering
     # the dictionary during iteration.
@@ -88,7 +105,11 @@ def merge_setting(request_setting, session_setting, dict_class=OrderedDict):
     return merged_setting
 
 
-def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict):
+def merge_hooks(
+    request_hooks: _t.HooksType,
+    session_hooks: _t.HooksType,
+    dict_class: type = OrderedDict,
+) -> _t.HooksType:
     """Properly merges both requests and session hooks.
 
     This is necessary because when request_hooks == {'response': []}, the
@@ -104,7 +125,13 @@ def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict):
 
 
 class SessionRedirectMixin:
-    def get_redirect_target(self, resp):
+    max_redirects: int
+    trust_env: bool
+    cookies: RequestsCookieJar
+
+    def send(self, request: PreparedRequest, **kwargs: Any) -> Response: ...
+
+    def get_redirect_target(self, resp: Response) -> str | None:
         """Receives a Response. Returns a redirect URI or ``None``"""
         # Due to the nature of how requests processes redirects this method will
         # be called at least once upon the original response and at least twice
@@ -124,7 +151,7 @@ class SessionRedirectMixin:
             return to_native_string(location, "utf8")
         return None
 
-    def should_strip_auth(self, old_url, new_url):
+    def should_strip_auth(self, old_url: str, new_url: str) -> bool:
         """Decide whether Authorization header should be removed when redirecting"""
         old_parsed = urlparse(old_url)
         new_parsed = urlparse(new_url)
@@ -158,19 +185,19 @@ class SessionRedirectMixin:
 
     def resolve_redirects(
         self,
-        resp,
-        req,
-        stream=False,
-        timeout=None,
-        verify=True,
-        cert=None,
-        proxies=None,
-        yield_requests=False,
-        **adapter_kwargs,
-    ):
+        resp: Response,
+        req: PreparedRequest,
+        stream: bool = False,
+        timeout: _t.TimeoutType = None,
+        verify: _t.VerifyType = True,
+        cert: _t.CertType = None,
+        proxies: dict[str, str] | None = None,
+        yield_requests: bool = False,
+        **adapter_kwargs: Any,
+    ) -> Generator[Response, None, None]:
         """Receives a Response. Returns a generator of Responses or Requests."""
 
-        hist = []  # keep track of history
+        hist: list[Response] = []  # keep track of history
 
         url = self.get_redirect_target(resp)
         previous_fragment = urlparse(req.url).fragment
@@ -178,9 +205,8 @@ class SessionRedirectMixin:
             prepared_request = req.copy()
 
             # Update history and keep track of redirects.
-            # resp.history must ignore the original request in this loop
+            resp.history = hist[:]
             hist.append(resp)
-            resp.history = hist[1:]
 
             try:
                 resp.content  # Consume socket so it can be released
@@ -237,9 +263,10 @@ class SessionRedirectMixin:
             # Extract any cookies sent on the response to the cookiejar
             # in the new request. Because we've mutated our copied prepared
             # request, use the old one that we haven't yet touched.
-            extract_cookies_to_jar(prepared_request._cookies, req, resp.raw)
-            merge_cookies(prepared_request._cookies, self.cookies)
-            prepared_request.prepare_cookies(prepared_request._cookies)
+            cookie_jar = cast("CookieJar", prepared_request._cookies)  # type: ignore[reportPrivateUsage]
+            extract_cookies_to_jar(cookie_jar, req, resp.raw)
+            merge_cookies(cookie_jar, self.cookies)
+            prepared_request.prepare_cookies(cookie_jar)
 
             # Rebuild auth and proxy information.
             proxies = self.rebuild_proxies(prepared_request, proxies)
@@ -248,7 +275,7 @@ class SessionRedirectMixin:
             # A failed tell() sets `_body_position` to `object()`. This non-None
             # value ensures `rewindable` will be True, allowing us to raise an
             # UnrewindableBodyError, instead of hanging the connection.
-            rewindable = prepared_request._body_position is not None and (
+            rewindable = prepared_request._body_position is not None and (  # type: ignore[reportPrivateUsage]
                 "Content-Length" in headers or "Transfer-Encoding" in headers
             )
 
@@ -260,7 +287,7 @@ class SessionRedirectMixin:
             req = prepared_request
 
             if yield_requests:
-                yield req
+                yield req  # type: ignore[misc]  # Internal use only, returns PreparedRequest
             else:
                 resp = self.send(
                     req,
@@ -279,17 +306,22 @@ class SessionRedirectMixin:
                 url = self.get_redirect_target(resp)
                 yield resp
 
-    def rebuild_auth(self, prepared_request, response):
+    def rebuild_auth(
+        self, prepared_request: PreparedRequest, response: Response
+    ) -> None:
         """When being redirected we may want to strip authentication from the
         request to avoid leaking credentials. This method intelligently removes
         and reapplies authentication where possible to avoid credential loss.
         """
+        original_request = response.request
+        assert _is_prepared(original_request)
+        assert _is_prepared(prepared_request)
+
         headers = prepared_request.headers
+        original_url = original_request.url
         url = prepared_request.url
 
-        if "Authorization" in headers and self.should_strip_auth(
-            response.request.url, url
-        ):
+        if "Authorization" in headers and self.should_strip_auth(original_url, url):
             # If we get redirected to a new host, we should strip out any
             # authentication headers.
             del headers["Authorization"]
@@ -299,7 +331,11 @@ class SessionRedirectMixin:
         if new_auth is not None:
             prepared_request.prepare_auth(new_auth)
 
-    def rebuild_proxies(self, prepared_request, proxies):
+    def rebuild_proxies(
+        self,
+        prepared_request: PreparedRequest,
+        proxies: dict[str, str] | None,
+    ) -> dict[str, str]:
         """This method re-evaluates the proxy configuration by considering the
         environment variables. If we are redirected to a URL covered by
         NO_PROXY, we strip the proxy configuration. Otherwise, we set missing
@@ -311,6 +347,7 @@ class SessionRedirectMixin:
 
         :rtype: dict
         """
+        assert _is_prepared(prepared_request)
         headers = prepared_request.headers
         scheme = urlparse(prepared_request.url).scheme
         new_proxies = resolve_proxies(prepared_request, proxies, self.trust_env)
@@ -330,7 +367,9 @@ class SessionRedirectMixin:
 
         return new_proxies
 
-    def rebuild_method(self, prepared_request, response):
+    def rebuild_method(
+        self, prepared_request: PreparedRequest, response: Response
+    ) -> None:
         """When being redirected we may want to change the method of the request
         based on certain specs or browser behavior.
         """
@@ -372,7 +411,20 @@ class Session(SessionRedirectMixin):
       
     """
 
-    __attrs__ = [
+    headers: CaseInsensitiveDict[str]
+    auth: _t.AuthType
+    proxies: dict[str, str]
+    hooks: dict[str, list[_t.HookType]]
+    params: MutableMapping[str, Any]
+    stream: bool
+    verify: _t.VerifyType
+    cert: _t.CertType
+    max_redirects: int
+    trust_env: bool
+    cookies: RequestsCookieJar
+    adapters: MutableMapping[str, BaseAdapter]
+
+    __attrs__: list[str] = [
         "headers",
         "cookies",
         "auth",
@@ -387,7 +439,7 @@ class Session(SessionRedirectMixin):
         "max_redirects",
     ]
 
-    def __init__(self):
+    def __init__(self) -> None:
         #: A case-insensitive dictionary of headers to be sent on each
         #: :class:`Request ` sent from this
         #: :class:`Session `.
@@ -421,6 +473,8 @@ class Session(SessionRedirectMixin):
         #: expired certificates, which will make your application vulnerable to
         #: man-in-the-middle (MitM) attacks.
         #: Only set this to `False` for testing.
+        #: If verify is set to a string, it must be the path to a CA bundle file
+        #: that will be used to verify the TLS certificate.
         self.verify = True
 
         #: SSL client certificate default, if String, path to ssl client
@@ -448,13 +502,13 @@ class Session(SessionRedirectMixin):
         self.mount("https://", HTTPAdapter())
         self.mount("http://", HTTPAdapter())
 
-    def __enter__(self):
+    def __enter__(self) -> Self:
         return self
 
-    def __exit__(self, *args):
+    def __exit__(self, *args: Any) -> None:
         self.close()
 
-    def prepare_request(self, request):
+    def prepare_request(self, request: Request) -> PreparedRequest:
         """Constructs a :class:`PreparedRequest ` for
         transmission and returns it. The :class:`PreparedRequest` has settings
         merged from the :class:`Request ` instance and those of the
@@ -464,6 +518,9 @@ class Session(SessionRedirectMixin):
             session's settings.
         :rtype: requests.PreparedRequest
         """
+        url = cast("_t.UriType", request.url)
+        method = cast(str, request.method)
+
         cookies = request.cookies or {}
 
         # Bootstrap CookieJar.
@@ -478,12 +535,12 @@ class Session(SessionRedirectMixin):
         # Set environment's basic authentication if not explicitly set.
         auth = request.auth
         if self.trust_env and not auth and not self.auth:
-            auth = get_netrc_auth(request.url)
+            auth = get_netrc_auth(url)
 
         p = PreparedRequest()
         p.prepare(
-            method=request.method.upper(),
-            url=request.url,
+            method=method.upper(),
+            url=url,
             files=request.files,
             data=request.data,
             json=request.json,
@@ -499,23 +556,23 @@ class Session(SessionRedirectMixin):
 
     def request(
         self,
-        method,
-        url,
-        params=None,
-        data=None,
-        headers=None,
-        cookies=None,
-        files=None,
-        auth=None,
-        timeout=None,
-        allow_redirects=True,
-        proxies=None,
-        hooks=None,
-        stream=None,
-        verify=None,
-        cert=None,
-        json=None,
-    ):
+        method: str,
+        url: _t.UriType,
+        params: _t.ParamsType = None,
+        data: _t.DataType = None,
+        headers: _t.HeadersType = None,
+        cookies: RequestsCookieJar | CookieJar | dict[str, str] | None = None,
+        files: _t.FilesType = None,
+        auth: _t.AuthType = None,
+        timeout: _t.TimeoutType = None,
+        allow_redirects: bool = True,
+        proxies: dict[str, str] | None = None,
+        hooks: _t.HooksInputType | None = None,
+        stream: bool | None = None,
+        verify: _t.VerifyType | None = None,
+        cert: _t.CertType = None,
+        json: _t.JsonType = None,
+    ) -> Response:
         """Constructs a :class:`Request `, prepares it and sends it.
         Returns :class:`Response ` object.
 
@@ -559,6 +616,9 @@ class Session(SessionRedirectMixin):
             If Tuple, ('cert', 'key') pair.
         :rtype: requests.Response
         """
+        if isinstance(url, bytes):
+            url = url.decode("utf-8")
+
         # Create the Request.
         req = Request(
             method=method.upper(),
@@ -574,6 +634,8 @@ class Session(SessionRedirectMixin):
         )
         prep = self.prepare_request(req)
 
+        assert _is_prepared(prep)
+
         proxies = proxies or {}
 
         settings = self.merge_environment_settings(
@@ -590,18 +652,25 @@ class Session(SessionRedirectMixin):
 
         return resp
 
-    def get(self, url, **kwargs):
+    def get(
+        self,
+        url: _t.UriType,
+        params: _t.ParamsType = None,
+        **kwargs: Unpack[_t.GetKwargs],
+    ) -> Response:
         r"""Sends a GET request. Returns :class:`Response` object.
 
         :param url: URL for the new :class:`Request` object.
+        :param params: (optional) Dictionary, list of tuples or bytes to send
+        in the query string for the :class:`Request`.
         :param \*\*kwargs: Optional arguments that ``request`` takes.
         :rtype: requests.Response
         """
 
         kwargs.setdefault("allow_redirects", True)
-        return self.request("GET", url, **kwargs)
+        return self.request("GET", url, params=params, **kwargs)
 
-    def options(self, url, **kwargs):
+    def options(self, url: _t.UriType, **kwargs: Unpack[_t.RequestKwargs]) -> Response:
         r"""Sends a OPTIONS request. Returns :class:`Response` object.
 
         :param url: URL for the new :class:`Request` object.
@@ -612,7 +681,7 @@ class Session(SessionRedirectMixin):
         kwargs.setdefault("allow_redirects", True)
         return self.request("OPTIONS", url, **kwargs)
 
-    def head(self, url, **kwargs):
+    def head(self, url: _t.UriType, **kwargs: Unpack[_t.RequestKwargs]) -> Response:
         r"""Sends a HEAD request. Returns :class:`Response` object.
 
         :param url: URL for the new :class:`Request` object.
@@ -623,7 +692,13 @@ class Session(SessionRedirectMixin):
         kwargs.setdefault("allow_redirects", False)
         return self.request("HEAD", url, **kwargs)
 
-    def post(self, url, data=None, json=None, **kwargs):
+    def post(
+        self,
+        url: _t.UriType,
+        data: _t.DataType = None,
+        json: _t.JsonType = None,
+        **kwargs: Unpack[_t.PostKwargs],
+    ) -> Response:
         r"""Sends a POST request. Returns :class:`Response` object.
 
         :param url: URL for the new :class:`Request` object.
@@ -636,7 +711,9 @@ class Session(SessionRedirectMixin):
 
         return self.request("POST", url, data=data, json=json, **kwargs)
 
-    def put(self, url, data=None, **kwargs):
+    def put(
+        self, url: _t.UriType, data: _t.DataType = None, **kwargs: Unpack[_t.DataKwargs]
+    ) -> Response:
         r"""Sends a PUT request. Returns :class:`Response` object.
 
         :param url: URL for the new :class:`Request` object.
@@ -648,7 +725,9 @@ class Session(SessionRedirectMixin):
 
         return self.request("PUT", url, data=data, **kwargs)
 
-    def patch(self, url, data=None, **kwargs):
+    def patch(
+        self, url: _t.UriType, data: _t.DataType = None, **kwargs: Unpack[_t.DataKwargs]
+    ) -> Response:
         r"""Sends a PATCH request. Returns :class:`Response` object.
 
         :param url: URL for the new :class:`Request` object.
@@ -660,7 +739,7 @@ class Session(SessionRedirectMixin):
 
         return self.request("PATCH", url, data=data, **kwargs)
 
-    def delete(self, url, **kwargs):
+    def delete(self, url: _t.UriType, **kwargs: Unpack[_t.RequestKwargs]) -> Response:
         r"""Sends a DELETE request. Returns :class:`Response` object.
 
         :param url: URL for the new :class:`Request` object.
@@ -670,7 +749,7 @@ class Session(SessionRedirectMixin):
 
         return self.request("DELETE", url, **kwargs)
 
-    def send(self, request, **kwargs):
+    def send(self, request: PreparedRequest, **kwargs: Any) -> Response:
         """Send a given PreparedRequest.
 
         :rtype: requests.Response
@@ -688,6 +767,8 @@ class Session(SessionRedirectMixin):
         if isinstance(request, Request):
             raise ValueError("You can only send PreparedRequests.")
 
+        assert _is_prepared(request)
+
         # Set up variables needed for resolve_redirects and dispatching of hooks
         allow_redirects = kwargs.pop("allow_redirects", True)
         stream = kwargs.get("stream")
@@ -736,7 +817,7 @@ class Session(SessionRedirectMixin):
         # If redirects aren't being followed, store the response on the Request for Response.next().
         if not allow_redirects:
             try:
-                r._next = next(
+                r._next = next(  # type: ignore[assignment]  # yield_requests=True returns PreparedRequest
                     self.resolve_redirects(r, request, yield_requests=True, **kwargs)
                 )
             except StopIteration:
@@ -747,7 +828,14 @@ class Session(SessionRedirectMixin):
 
         return r
 
-    def merge_environment_settings(self, url, proxies, stream, verify, cert):
+    def merge_environment_settings(
+        self,
+        url: str,
+        proxies: dict[str, str] | None,
+        stream: bool | None,
+        verify: _t.VerifyType | None,
+        cert: _t.CertType,
+    ) -> dict[str, Any]:
         """
         Check the environment and merge it with some settings.
 
@@ -758,8 +846,9 @@ class Session(SessionRedirectMixin):
             # Set environment's proxies.
             no_proxy = proxies.get("no_proxy") if proxies is not None else None
             env_proxies = get_environ_proxies(url, no_proxy=no_proxy)
-            for k, v in env_proxies.items():
-                proxies.setdefault(k, v)
+            if proxies is not None:
+                for k, v in env_proxies.items():
+                    proxies.setdefault(k, v)
 
             # Look for requests environment configuration
             # and be compatible with cURL.
@@ -778,7 +867,7 @@ class Session(SessionRedirectMixin):
 
         return {"proxies": proxies, "stream": stream, "verify": verify, "cert": cert}
 
-    def get_adapter(self, url):
+    def get_adapter(self, url: str) -> BaseAdapter:
         """
         Returns the appropriate connection adapter for the given URL.
 
@@ -791,12 +880,12 @@ class Session(SessionRedirectMixin):
         # Nothing matches :-/
         raise InvalidSchema(f"No connection adapters were found for {url!r}")
 
-    def close(self):
+    def close(self) -> None:
         """Closes all adapters and as such the session"""
         for v in self.adapters.values():
             v.close()
 
-    def mount(self, prefix, adapter):
+    def mount(self, prefix: str, adapter: BaseAdapter) -> None:
         """Registers a connection adapter to a prefix.
 
         Adapters are sorted in descending order by prefix length.
@@ -807,16 +896,16 @@ class Session(SessionRedirectMixin):
         for key in keys_to_move:
             self.adapters[key] = self.adapters.pop(key)
 
-    def __getstate__(self):
+    def __getstate__(self) -> dict[str, Any]:
         state = {attr: getattr(self, attr, None) for attr in self.__attrs__}
         return state
 
-    def __setstate__(self, state):
+    def __setstate__(self, state: dict[str, Any]) -> None:
         for attr, value in state.items():
             setattr(self, attr, value)
 
 
-def session():
+def session() -> Session:
     """
     Returns a :class:`Session` for context-management.
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/status_codes.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/status_codes.py
index c7945a2..6c59d6b 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/status_codes.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/status_codes.py
@@ -103,7 +103,7 @@ _codes = {
     511: ("network_authentication_required", "network_auth", "network_authentication"),
 }
 
-codes = LookupDict(name="status_codes")
+codes: LookupDict[int] = LookupDict(name="status_codes")
 
 
 def _init():
@@ -113,7 +113,7 @@ def _init():
             if not title.startswith(("\\", "/")):
                 setattr(codes, title.upper(), code)
 
-    def doc(code):
+    def doc(code: int) -> str:
         names = ", ".join(f"``{n}``" for n in _codes[code])
         return "* %d: %s" % (code, names)
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/structures.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/structures.py
index 188e13e..7675eaf 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/structures.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/structures.py
@@ -5,12 +5,19 @@ requests.structures
 Data structures that power Requests.
 """
 
+from __future__ import annotations
+
 from collections import OrderedDict
+from collections.abc import Iterable, Iterator, Mapping
+from typing import Any, Generic, TypeVar, overload
 
-from .compat import Mapping, MutableMapping
+from .compat import MutableMapping
+
+_VT = TypeVar("_VT")
+_D = TypeVar("_D")
 
 
-class CaseInsensitiveDict(MutableMapping):
+class CaseInsensitiveDict(MutableMapping[str, _VT], Generic[_VT]):
     """A case-insensitive ``dict``-like object.
 
     Implements all methods and operations of
@@ -37,63 +44,87 @@ class CaseInsensitiveDict(MutableMapping):
     behavior is undefined.
     """
 
-    def __init__(self, data=None, **kwargs):
+    _store: OrderedDict[str, tuple[str, _VT]]
+
+    def __init__(
+        self,
+        data: Mapping[str, _VT] | Iterable[tuple[str, _VT]] | None = None,
+        **kwargs: _VT,
+    ) -> None:
         self._store = OrderedDict()
         if data is None:
             data = {}
         self.update(data, **kwargs)
 
-    def __setitem__(self, key, value):
+    def __setitem__(self, key: str, value: _VT) -> None:
         # Use the lowercased key for lookups, but store the actual
         # key alongside the value.
         self._store[key.lower()] = (key, value)
 
-    def __getitem__(self, key):
+    def __getitem__(self, key: str) -> _VT:
         return self._store[key.lower()][1]
 
-    def __delitem__(self, key):
+    def __delitem__(self, key: str) -> None:
         del self._store[key.lower()]
 
-    def __iter__(self):
-        return (casedkey for casedkey, mappedvalue in self._store.values())
+    def __iter__(self) -> Iterator[str]:
+        return (casedkey for casedkey, _ in self._store.values())
 
-    def __len__(self):
+    def __len__(self) -> int:
         return len(self._store)
 
-    def lower_items(self):
+    def lower_items(self) -> Iterator[tuple[str, _VT]]:
         """Like iteritems(), but with all lowercase keys."""
         return ((lowerkey, keyval[1]) for (lowerkey, keyval) in self._store.items())
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         if isinstance(other, Mapping):
-            other = CaseInsensitiveDict(other)
+            other_dict: CaseInsensitiveDict[Any] = CaseInsensitiveDict(other)  # type: ignore[reportUnknownArgumentType]
         else:
             return NotImplemented
         # Compare insensitively
-        return dict(self.lower_items()) == dict(other.lower_items())
+        return dict(self.lower_items()) == dict(other_dict.lower_items())
 
     # Copy is required
-    def copy(self):
+    def copy(self) -> CaseInsensitiveDict[_VT]:
         return CaseInsensitiveDict(self._store.values())
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return str(dict(self.items()))
 
 
-class LookupDict(dict):
+class LookupDict(dict[str, _VT]):
     """Dictionary lookup object."""
 
-    def __init__(self, name=None):
+    name: Any
+
+    def __init__(self, name: Any = None) -> None:
         self.name = name
         super().__init__()
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f""
 
-    def __getitem__(self, key):
+    def __getattr__(self, key: str) -> _VT | None:
+        # We need this for type checkers to infer typing
+        # on attribute access with status_codes.py
+        if key in self.__dict__:
+            return self.__dict__[key]
+        else:
+            raise AttributeError(
+                f"'{type(self).__name__}' object has no attribute '{key}'"
+            )
+
+    def __getitem__(self, key: str) -> _VT | None:  # type: ignore[override]
         # We allow fall-through here, so values default to None
 
         return self.__dict__.get(key, None)
 
-    def get(self, key, default=None):
+    @overload
+    def get(self, key: str, default: None = None) -> _VT | None: ...
+
+    @overload
+    def get(self, key: str, default: _D | _VT) -> _D | _VT: ...
+
+    def get(self, key: str, default: _D | None = None) -> _VT | _D | None:
         return self.__dict__.get(key, default)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/utils.py b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/utils.py
index e8ea5ad..e2a2a32 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/requests/utils.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/requests/utils.py
@@ -6,6 +6,8 @@ This module provides utility functions that are used within Requests
 that are also useful for external consumption.
 """
 
+from __future__ import annotations
+
 import codecs
 import contextlib
 import io
@@ -18,6 +20,15 @@ import tempfile
 import warnings
 import zipfile
 from collections import OrderedDict
+from collections.abc import Generator, Iterable
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Final,
+    TypeVar,
+    cast,
+    overload,
+)
 
 from pip._vendor.urllib3.util import make_headers, parse_url
 
@@ -26,30 +37,28 @@ from .__version__ import __version__
 
 # to_native_string is unused here, but imported here for backwards compatibility
 from ._internal_utils import (  # noqa: F401
-    _HEADER_VALIDATORS_BYTE,
-    _HEADER_VALIDATORS_STR,
-    HEADER_VALIDATORS,
-    to_native_string,
+    _HEADER_VALIDATORS_BYTE,  # type: ignore[reportPrivateUsage]
+    _HEADER_VALIDATORS_STR,  # type: ignore[reportPrivateUsage]
+    HEADER_VALIDATORS,  # type: ignore[reportUnusedImport]
+    to_native_string,  # type: ignore[reportUnusedImport]
 )
+from ._types import SupportsItems as _SupportsItems
 from .compat import (
     Mapping,
-    basestring,
     bytes,
     getproxies,
     getproxies_environment,
     integer_types,
     is_urllib3_1,
-)
-from .compat import parse_http_list as _parse_list_header
-from .compat import (
     proxy_bypass,
-    proxy_bypass_environment,
+    proxy_bypass_environment,  # type: ignore[attr-defined]  # https://github.com/python/cpython/issues/145331
     quote,
     str,
     unquote,
     urlparse,
     urlunparse,
 )
+from .compat import parse_http_list as _parse_list_header
 from .cookies import cookiejar_from_dict
 from .exceptions import (
     FileModeWarning,
@@ -59,14 +68,27 @@ from .exceptions import (
 )
 from .structures import CaseInsensitiveDict
 
-NETRC_FILES = (".netrc", "_netrc")
+if TYPE_CHECKING:
+    from http.cookiejar import CookieJar
+    from io import BufferedWriter
 
-DEFAULT_CA_BUNDLE_PATH = certs.where()
+    from . import _types as _t
+    from .models import PreparedRequest, Request, Response
 
-DEFAULT_PORTS = {"http": 80, "https": 443}
+NETRC_FILES: Final = (".netrc", "_netrc")
+
+
+# Certificate is extracted by certifi when needed.
+DEFAULT_CA_BUNDLE_PATH: str = certs.where()
+
+
+DEFAULT_PORTS: Final = {"http": 80, "https": 443}
+
+_KT = TypeVar("_KT")
+_VT = TypeVar("_VT")
 
 # Ensure that ', ' is used to preserve previous delimiter behavior.
-DEFAULT_ACCEPT_ENCODING = ", ".join(
+DEFAULT_ACCEPT_ENCODING: Final = ", ".join(
     re.split(r",\s*", make_headers(accept_encoding=True)["accept-encoding"])
 )
 
@@ -74,7 +96,7 @@ DEFAULT_ACCEPT_ENCODING = ", ".join(
 if sys.platform == "win32":
     # provide a proxy_bypass version on Windows without DNS lookups
 
-    def proxy_bypass_registry(host):
+    def proxy_bypass_registry(host: str) -> bool:
         try:
             import winreg
         except ImportError:
@@ -112,7 +134,7 @@ if sys.platform == "win32":
                 return True
         return False
 
-    def proxy_bypass(host):  # noqa
+    def proxy_bypass(host: str) -> bool:  # noqa
         """Return True, if the host should be bypassed.
 
         Checks proxy settings gathered from the environment, if specified,
@@ -124,16 +146,18 @@ if sys.platform == "win32":
             return proxy_bypass_registry(host)
 
 
-def dict_to_sequence(d):
+def dict_to_sequence(
+    d: _t.SupportsItems[Any, Any] | Iterable[tuple[Any, Any]],
+) -> Iterable[tuple[Any, Any]]:
     """Returns an internal sequence dictionary update."""
 
-    if hasattr(d, "items"):
-        d = d.items()
+    if isinstance(d, _SupportsItems):
+        return d.items()
 
     return d
 
 
-def super_len(o):
+def super_len(o: Any) -> int:
     total_length = None
     current_position = 0
 
@@ -204,9 +228,14 @@ def super_len(o):
     return max(0, total_length - current_position)
 
 
-def get_netrc_auth(url, raise_errors=False):
+def get_netrc_auth(
+    url: _t.UriType, raise_errors: bool = False
+) -> tuple[str, str] | None:
     """Returns the Requests tuple auth for a given url from netrc."""
 
+    if isinstance(url, bytes):
+        url = url.decode("utf-8")
+
     netrc_file = os.environ.get("NETRC")
     if netrc_file is not None:
         netrc_locations = (netrc_file,)
@@ -231,12 +260,15 @@ def get_netrc_auth(url, raise_errors=False):
         ri = urlparse(url)
         host = ri.hostname
 
+        if host is None:
+            return
+
         try:
             _netrc = netrc(netrc_path).authenticators(host)
-            if _netrc:
+            if _netrc and any(_netrc):
                 # Return with login / password
                 login_i = 0 if _netrc[0] else 1
-                return (_netrc[login_i], _netrc[2])
+                return (_netrc[login_i] or "", _netrc[2] or "")
         except (NetrcParseError, OSError):
             # If there was a parsing error or a permissions issue reading the file,
             # we'll just skip netrc auth unless explicitly asked to raise errors.
@@ -248,14 +280,14 @@ def get_netrc_auth(url, raise_errors=False):
         pass
 
 
-def guess_filename(obj):
+def guess_filename(obj: Any) -> str | None:
     """Tries to guess the filename of the given object."""
     name = getattr(obj, "name", None)
-    if name and isinstance(name, basestring) and name[0] != "<" and name[-1] != ">":
-        return os.path.basename(name)
+    if name and isinstance(name, (str, bytes)) and name[0] != "<" and name[-1] != ">":
+        return os.path.basename(name)  # type: ignore[return-value]  # urllib3 accepts bytes but types str only
 
 
-def extract_zipped_paths(path):
+def extract_zipped_paths(path: str) -> str:
     """Replace nonexistent paths that look like they refer to a member of a zip
     archive with the location of an extracted copy of the target, or else
     just return the provided path unchanged.
@@ -283,17 +315,18 @@ def extract_zipped_paths(path):
         return path
 
     # we have a valid zip archive and a valid member of that archive
-    tmp = tempfile.gettempdir()
-    extracted_path = os.path.join(tmp, member.split("/")[-1])
-    if not os.path.exists(extracted_path):
-        # use read + write to avoid the creating nested folders, we only want the file, avoids mkdir racing condition
-        with atomic_open(extracted_path) as file_handler:
-            file_handler.write(zip_file.read(member))
+    suffix = os.path.splitext(member.split("/")[-1])[-1]
+    fd, extracted_path = tempfile.mkstemp(suffix=suffix)
+    try:
+        os.write(fd, zip_file.read(member))
+    finally:
+        os.close(fd)
+
     return extracted_path
 
 
 @contextlib.contextmanager
-def atomic_open(filename):
+def atomic_open(filename: str) -> Generator[BufferedWriter, None, None]:
     """Write a file to the disk in an atomic fashion"""
     tmp_descriptor, tmp_name = tempfile.mkstemp(dir=os.path.dirname(filename))
     try:
@@ -305,7 +338,9 @@ def atomic_open(filename):
         raise
 
 
-def from_key_val_list(value):
+def from_key_val_list(
+    value: Mapping[Any, Any] | Iterable[tuple[Any, Any]] | None,
+) -> dict[Any, Any] | None:
     """Take an object and test to see if it can be represented as a
     dictionary. Unless it can not be represented as such, return an
     OrderedDict, e.g.,
@@ -332,7 +367,15 @@ def from_key_val_list(value):
     return OrderedDict(value)
 
 
-def to_key_val_list(value):
+@overload
+def to_key_val_list(value: None) -> None: ...
+@overload
+def to_key_val_list(
+    value: _t.SupportsItems[_KT, _VT] | Iterable[tuple[_KT, _VT]],
+) -> list[tuple[_KT, _VT]]: ...
+def to_key_val_list(
+    value: _t.SupportsItems[_KT, _VT] | Iterable[tuple[_KT, _VT]] | None,
+) -> list[tuple[_KT, _VT]] | None:
     """Take an object and test to see if it can be represented as a
     dictionary. If it can be, return a list of tuples, e.g.,
 
@@ -355,14 +398,14 @@ def to_key_val_list(value):
     if isinstance(value, (str, bytes, bool, int)):
         raise ValueError("cannot encode objects that are not 2-tuples")
 
-    if isinstance(value, Mapping):
-        value = value.items()
+    if isinstance(value, _SupportsItems):
+        return list(value.items())
 
     return list(value)
 
 
 # From mitsuhiko/werkzeug (used with permission).
-def parse_list_header(value):
+def parse_list_header(value: str) -> list[str]:
     """Parse lists as described by RFC 2068 Section 2.
 
     In particular, parse comma-separated lists where the elements of
@@ -385,7 +428,7 @@ def parse_list_header(value):
     :return: :class:`list`
     :rtype: list
     """
-    result = []
+    result: list[str] = []
     for item in _parse_list_header(value):
         if item[:1] == item[-1:] == '"':
             item = unquote_header_value(item[1:-1])
@@ -394,7 +437,7 @@ def parse_list_header(value):
 
 
 # From mitsuhiko/werkzeug (used with permission).
-def parse_dict_header(value):
+def parse_dict_header(value: str) -> dict[str, str | None]:
     """Parse lists of key, value pairs as described by RFC 2068 Section 2 and
     convert them into a python dict:
 
@@ -416,7 +459,7 @@ def parse_dict_header(value):
     :return: :class:`dict`
     :rtype: dict
     """
-    result = {}
+    result: dict[str, str | None] = {}
     for item in _parse_list_header(value):
         if "=" not in item:
             result[item] = None
@@ -429,7 +472,7 @@ def parse_dict_header(value):
 
 
 # From mitsuhiko/werkzeug (used with permission).
-def unquote_header_value(value, is_filename=False):
+def unquote_header_value(value: str, is_filename: bool = False) -> str:
     r"""Unquotes a header value.  (Reversal of :func:`quote_header_value`).
     This does not use the real unquoting but what browsers are actually
     using for quoting.
@@ -454,7 +497,7 @@ def unquote_header_value(value, is_filename=False):
     return value
 
 
-def dict_from_cookiejar(cj):
+def dict_from_cookiejar(cj: CookieJar) -> dict[str, str | None]:
     """Returns a key/value dictionary from a CookieJar.
 
     :param cj: CookieJar object to extract cookies from.
@@ -465,7 +508,7 @@ def dict_from_cookiejar(cj):
     return cookie_dict
 
 
-def add_dict_to_cookiejar(cj, cookie_dict):
+def add_dict_to_cookiejar(cj: CookieJar, cookie_dict: dict[str, str]) -> CookieJar:
     """Returns a CookieJar from a key/value dictionary.
 
     :param cj: CookieJar to insert cookies into.
@@ -476,7 +519,7 @@ def add_dict_to_cookiejar(cj, cookie_dict):
     return cookiejar_from_dict(cookie_dict, cj)
 
 
-def get_encodings_from_content(content):
+def get_encodings_from_content(content: str) -> list[str]:
     """Returns encodings from given content string.
 
     :param content: bytestring to extract encodings from.
@@ -501,32 +544,29 @@ def get_encodings_from_content(content):
     )
 
 
-def _parse_content_type_header(header):
-    """Returns content type and parameters from given header
+def _parse_content_type_header(header: str) -> tuple[str, dict[str, Any]]:
+    """Returns content type and parameters from given header.
 
     :param header: string
     :return: tuple containing content type and dictionary of
-         parameters
+         parameters.
     """
 
     tokens = header.split(";")
     content_type, params = tokens[0].strip(), tokens[1:]
-    params_dict = {}
-    items_to_strip = "\"' "
+    params_dict: dict[str, str | bool] = {}
+    strip_chars = "\"' "
 
     for param in params:
         param = param.strip()
-        if param:
-            key, value = param, True
-            index_of_equals = param.find("=")
-            if index_of_equals != -1:
-                key = param[:index_of_equals].strip(items_to_strip)
-                value = param[index_of_equals + 1 :].strip(items_to_strip)
+        if param and (idx := param.find("=")) != -1:
+            key = param[:idx].strip(strip_chars)
+            value = param[idx + 1 :].strip(strip_chars)
             params_dict[key.lower()] = value
     return content_type, params_dict
 
 
-def get_encoding_from_headers(headers):
+def get_encoding_from_headers(headers: CaseInsensitiveDict[str]) -> str | None:
     """Returns encodings from given HTTP Header Dict.
 
     :param headers: dictionary to extract encoding from.
@@ -551,7 +591,9 @@ def get_encoding_from_headers(headers):
         return "utf-8"
 
 
-def stream_decode_response_unicode(iterator, r):
+def stream_decode_response_unicode(
+    iterator: Iterable[bytes], r: Response
+) -> Generator[str | bytes, None, None]:
     """Stream decodes an iterator."""
 
     if r.encoding is None:
@@ -568,7 +610,17 @@ def stream_decode_response_unicode(iterator, r):
         yield rv
 
 
-def iter_slices(string, slice_length):
+@overload
+def iter_slices(
+    string: bytes, slice_length: int | None
+) -> Generator[bytes, None, None]: ...
+@overload
+def iter_slices(
+    string: str, slice_length: int | None
+) -> Generator[str, None, None]: ...
+def iter_slices(
+    string: bytes | str, slice_length: int | None
+) -> Generator[bytes | str, None, None]:
     """Iterate over slices of a string."""
     pos = 0
     if slice_length is None or slice_length <= 0:
@@ -578,7 +630,7 @@ def iter_slices(string, slice_length):
         pos += slice_length
 
 
-def get_unicode_from_response(r):
+def get_unicode_from_response(r: Response) -> str | bytes | None:
     """Returns the requested content back in unicode.
 
     :param r: Response object to get unicode content from.
@@ -598,8 +650,10 @@ def get_unicode_from_response(r):
         ),
         DeprecationWarning,
     )
+    if r.content is None:  # type: ignore[reportUnnecessaryComparison]
+        return None
 
-    tried_encodings = []
+    tried_encodings: list[str] = []
 
     # Try charset from content-type
     encoding = get_encoding_from_headers(r.headers)
@@ -612,18 +666,18 @@ def get_unicode_from_response(r):
 
     # Fall back:
     try:
-        return str(r.content, encoding, errors="replace")
+        return str(r.content, encoding or "utf-8", errors="replace")
     except TypeError:
         return r.content
 
 
 # The unreserved URI characters (RFC 3986)
-UNRESERVED_SET = frozenset(
+UNRESERVED_SET: Final = frozenset(
     "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~"
 )
 
 
-def unquote_unreserved(uri):
+def unquote_unreserved(uri: str) -> str:
     """Un-escape any percent-escape sequences in a URI that are unreserved
     characters. This leaves all reserved, illegal and non-ASCII bytes encoded.
 
@@ -647,7 +701,7 @@ def unquote_unreserved(uri):
     return "".join(parts)
 
 
-def requote_uri(uri):
+def requote_uri(uri: str) -> str:
     """Re-quote the given URI.
 
     This function passes the given URI through an unquote/quote cycle to
@@ -669,7 +723,7 @@ def requote_uri(uri):
         return quote(uri, safe=safe_without_percent)
 
 
-def address_in_network(ip, net):
+def address_in_network(ip: str, net: str) -> bool:
     """This function allows you to check if an IP belongs to a network subnet
 
     Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
@@ -684,7 +738,7 @@ def address_in_network(ip, net):
     return (ipaddr & netmask) == (network & netmask)
 
 
-def dotted_netmask(mask):
+def dotted_netmask(mask: int) -> str:
     """Converts mask from /xx format to xxx.xxx.xxx.xxx
 
     Example: if mask is 24 function returns 255.255.255.0
@@ -695,7 +749,7 @@ def dotted_netmask(mask):
     return socket.inet_ntoa(struct.pack(">I", bits))
 
 
-def is_ipv4_address(string_ip):
+def is_ipv4_address(string_ip: str) -> bool:
     """
     :rtype: bool
     """
@@ -706,7 +760,7 @@ def is_ipv4_address(string_ip):
     return True
 
 
-def is_valid_cidr(string_network):
+def is_valid_cidr(string_network: str) -> bool:
     """
     Very simple check of the cidr format in no_proxy variable.
 
@@ -731,7 +785,7 @@ def is_valid_cidr(string_network):
 
 
 @contextlib.contextmanager
-def set_environ(env_name, value):
+def set_environ(env_name: str, value: str | None) -> Generator[None, None, None]:
     """Set the environment variable 'env_name' to 'value'
 
     Save previous value, yield, and then restore the previous value stored in
@@ -739,6 +793,7 @@ def set_environ(env_name, value):
 
     If 'value' is None, do nothing"""
     value_changed = value is not None
+    old_value: str | None = None
     if value_changed:
         old_value = os.environ.get(env_name)
         os.environ[env_name] = value
@@ -752,7 +807,7 @@ def set_environ(env_name, value):
                 os.environ[env_name] = old_value
 
 
-def should_bypass_proxies(url, no_proxy):
+def should_bypass_proxies(url: str, no_proxy: str | None) -> bool:
     """
     Returns whether we should bypass proxies or not.
 
@@ -761,7 +816,7 @@ def should_bypass_proxies(url, no_proxy):
 
     # Prioritize lowercase environment variables over uppercase
     # to keep a consistent behaviour with other http projects (curl, wget).
-    def get_proxy(key):
+    def get_proxy(key: str) -> str | None:
         return os.environ.get(key) or os.environ.get(key.upper())
 
     # First check whether no_proxy is defined. If it is, check that the URL
@@ -770,40 +825,42 @@ def should_bypass_proxies(url, no_proxy):
     if no_proxy is None:
         no_proxy = get_proxy("no_proxy")
     parsed = urlparse(url)
+    hostname = parsed.hostname
 
-    if parsed.hostname is None:
+    if hostname is None:
         # URLs don't always have hostnames, e.g. file:/// urls.
         return True
 
     if no_proxy:
         # We need to check whether we match here. We need to see if we match
         # the end of the hostname, both with and without the port.
-        no_proxy = (host for host in no_proxy.replace(" ", "").split(",") if host)
+        no_proxy_hosts = (host for host in no_proxy.replace(" ", "").split(",") if host)
 
-        if is_ipv4_address(parsed.hostname):
-            for proxy_ip in no_proxy:
+        if is_ipv4_address(hostname):
+            for proxy_ip in no_proxy_hosts:
                 if is_valid_cidr(proxy_ip):
-                    if address_in_network(parsed.hostname, proxy_ip):
+                    if address_in_network(hostname, proxy_ip):
                         return True
-                elif parsed.hostname == proxy_ip:
+                elif hostname == proxy_ip:
                     # If no_proxy ip was defined in plain IP notation instead of cidr notation &
                     # matches the IP of the index
                     return True
         else:
-            host_with_port = parsed.hostname
+            host_with_port = hostname
             if parsed.port:
                 host_with_port += f":{parsed.port}"
 
-            for host in no_proxy:
-                if parsed.hostname.endswith(host) or host_with_port.endswith(host):
-                    # The URL does match something in no_proxy, so we don't want
-                    # to apply the proxies on this URL.
+            for host in no_proxy_hosts:
+                host = host.lstrip(".")
+                if hostname == host or host_with_port == host:
+                    return True
+                host = "." + host
+                if hostname.endswith(host) or host_with_port.endswith(host):
                     return True
 
     with set_environ("no_proxy", no_proxy_arg):
-        # parsed.hostname can be `None` in cases such as a file URI.
         try:
-            bypass = proxy_bypass(parsed.hostname)
+            bypass = proxy_bypass(hostname)
         except (TypeError, socket.gaierror):
             bypass = False
 
@@ -813,7 +870,7 @@ def should_bypass_proxies(url, no_proxy):
     return False
 
 
-def get_environ_proxies(url, no_proxy=None):
+def get_environ_proxies(url: str, no_proxy: str | None = None) -> dict[str, str]:
     """
     Return a dict of environment proxies.
 
@@ -825,7 +882,7 @@ def get_environ_proxies(url, no_proxy=None):
         return getproxies()
 
 
-def select_proxy(url, proxies):
+def select_proxy(url: str, proxies: dict[str, str] | None) -> str | None:
     """Select a proxy for the url, if applicable.
 
     :param url: The url being for the request
@@ -851,7 +908,11 @@ def select_proxy(url, proxies):
     return proxy
 
 
-def resolve_proxies(request, proxies, trust_env=True):
+def resolve_proxies(
+    request: Request | PreparedRequest,
+    proxies: dict[str, str] | None,
+    trust_env: bool = True,
+) -> dict[str, str]:
     """This method takes proxy information from a request and configuration
     input to resolve a mapping of target proxies. This will consider settings
     such as NO_PROXY to strip proxy configurations.
@@ -863,7 +924,7 @@ def resolve_proxies(request, proxies, trust_env=True):
     :rtype: dict
     """
     proxies = proxies if proxies is not None else {}
-    url = request.url
+    url = cast(str, request.url)
     scheme = urlparse(url).scheme
     no_proxy = proxies.get("no_proxy")
     new_proxies = proxies.copy()
@@ -878,7 +939,7 @@ def resolve_proxies(request, proxies, trust_env=True):
     return new_proxies
 
 
-def default_user_agent(name="python-requests"):
+def default_user_agent(name: str = "python-requests") -> str:
     """
     Return a string representing the default user agent.
 
@@ -887,7 +948,7 @@ def default_user_agent(name="python-requests"):
     return f"{name}/{__version__}"
 
 
-def default_headers():
+def default_headers() -> CaseInsensitiveDict[str]:
     """
     :rtype: requests.structures.CaseInsensitiveDict
     """
@@ -901,7 +962,7 @@ def default_headers():
     )
 
 
-def parse_header_links(value):
+def parse_header_links(value: str) -> list[dict[str, str]]:
     """Return a list of parsed link headers proxies.
 
     i.e. Link: ; rel=front; type="image/jpeg",; rel=back;type="image/jpeg"
@@ -909,7 +970,7 @@ def parse_header_links(value):
     :rtype: list
     """
 
-    links = []
+    links: list[dict[str, str]] = []
 
     replace_chars = " '\""
 
@@ -923,7 +984,7 @@ def parse_header_links(value):
         except ValueError:
             url, params = val, ""
 
-        link = {"url": url.strip("<> '\"")}
+        link: dict[str, str] = {"url": url.strip("<> '\"")}
 
         for param in params.split(";"):
             try:
@@ -944,7 +1005,7 @@ _null2 = _null * 2
 _null3 = _null * 3
 
 
-def guess_json_utf(data):
+def guess_json_utf(data: bytes) -> str | None:
     """
     :rtype: str
     """
@@ -976,14 +1037,14 @@ def guess_json_utf(data):
     return None
 
 
-def prepend_scheme_if_needed(url, new_scheme):
+def prepend_scheme_if_needed(url: str, new_scheme: str) -> str:
     """Given a URL that may or may not have a scheme, prepend the given scheme.
     Does not replace a present scheme with the one provided as an argument.
 
     :rtype: str
     """
     parsed = parse_url(url)
-    scheme, auth, host, port, path, query, fragment = parsed
+    scheme, auth, _host, _port, path, query, fragment = parsed
 
     # A defect in urlparse determines that there isn't a netloc present in some
     # urls. We previously assumed parsing was overly cautious, and swapped the
@@ -996,6 +1057,7 @@ def prepend_scheme_if_needed(url, new_scheme):
     if auth:
         # parse_url doesn't provide the netloc with auth
         # so we'll add it ourselves.
+        netloc = cast(str, netloc)
         netloc = "@".join([auth, netloc])
     if scheme is None:
         scheme = new_scheme
@@ -1005,7 +1067,7 @@ def prepend_scheme_if_needed(url, new_scheme):
     return urlunparse((scheme, netloc, path, "", query, fragment))
 
 
-def get_auth_from_url(url):
+def get_auth_from_url(url: str) -> tuple[str, str]:
     """Given a url with authentication components, extract them into a tuple of
     username,password.
 
@@ -1014,14 +1076,15 @@ def get_auth_from_url(url):
     parsed = urlparse(url)
 
     try:
-        auth = (unquote(parsed.username), unquote(parsed.password))
+        # except handles parsed.username/password being None
+        auth = (unquote(parsed.username), unquote(parsed.password))  # type: ignore[arg-type]
     except (AttributeError, TypeError):
         auth = ("", "")
 
     return auth
 
 
-def check_header_validity(header):
+def check_header_validity(header: tuple[str | bytes, str | bytes]) -> None:
     """Verifies that header parts don't contain leading whitespace
     reserved characters, or return characters.
 
@@ -1032,10 +1095,15 @@ def check_header_validity(header):
     _validate_header_part(header, value, 1)
 
 
-def _validate_header_part(header, header_part, header_validator_index):
+def _validate_header_part(
+    header: tuple[str | bytes, str | bytes],
+    header_part: str | bytes,
+    header_validator_index: int,
+) -> None:
     if isinstance(header_part, str):
         validator = _HEADER_VALIDATORS_STR[header_validator_index]
-    elif isinstance(header_part, bytes):
+    elif isinstance(header_part, bytes):  # type: ignore[reportUnnecessaryIsInstance]
+        # runtime guard for non-str/bytes input
         validator = _HEADER_VALIDATORS_BYTE[header_validator_index]
     else:
         raise InvalidHeader(
@@ -1043,7 +1111,7 @@ def _validate_header_part(header, header_part, header_validator_index):
             f"must be of type str or bytes, not {type(header_part)}"
         )
 
-    if not validator.match(header_part):
+    if not validator.match(header_part):  # type: ignore[arg-type]
         header_kind = "name" if header_validator_index == 0 else "value"
         raise InvalidHeader(
             f"Invalid leading whitespace, reserved character(s), or return "
@@ -1051,13 +1119,13 @@ def _validate_header_part(header, header_part, header_validator_index):
         )
 
 
-def urldefragauth(url):
+def urldefragauth(url: str) -> str:
     """
     Given a url remove the fragment and the authentication part.
 
     :rtype: str
     """
-    scheme, netloc, path, params, query, fragment = urlparse(url)
+    scheme, netloc, path, params, query, _fragment = urlparse(url)
 
     # see func:`prepend_scheme_if_needed`
     if not netloc:
@@ -1068,16 +1136,17 @@ def urldefragauth(url):
     return urlunparse((scheme, netloc, path, params, query, ""))
 
 
-def rewind_body(prepared_request):
+def rewind_body(prepared_request: PreparedRequest) -> None:
     """Move file pointer back to its recorded starting position
     so it can be read again on redirect.
     """
     body_seek = getattr(prepared_request.body, "seek", None)
     if body_seek is not None and isinstance(
-        prepared_request._body_position, integer_types
+        prepared_request._body_position,  # type: ignore[reportPrivateUsage]
+        integer_types,
     ):
         try:
-            body_seek(prepared_request._body_position)
+            body_seek(prepared_request._body_position)  # type: ignore[reportPrivateUsage]
         except OSError:
             raise UnrewindableBodyError(
                 "An error occurred when rewinding request body for redirect."
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__init__.py
index 73f58d7..f60d5d6 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__init__.py
@@ -148,7 +148,7 @@ def inspect(
         docs (bool, optional): Also render doc strings. Defaults to True.
         private (bool, optional): Show private attributes (beginning with underscore). Defaults to False.
         dunder (bool, optional): Show attributes starting with double underscore. Defaults to False.
-        sort (bool, optional): Sort attributes alphabetically. Defaults to True.
+        sort (bool, optional):  Sort attributes alphabetically, callables at the top, leading and trailing underscores ignored. Defaults to True.
         all (bool, optional): Show all attributes. Defaults to False.
         value (bool, optional): Pretty print value. Defaults to True.
     """
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__main__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__main__.py
index a583f1e..248165b 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__main__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/__main__.py
@@ -234,12 +234,12 @@ if __name__ == "__main__":  # pragma: no cover
     console.print(f"[dim]rendered in [not dim]{taken}ms[/] (warm cache)")
     console.print()
     console.print(
-        Panel.fit(
+        Panel(
             "[b magenta]Hope you enjoy using Rich![/]\n\n"
-            "Please consider sponsoring me if you get value from my work.\n\n"
-            "Even the price of a ☕ can brighten my day!\n\n"
-            "https://github.com/sponsors/willmcgugan",
-            border_style="red",
+            "Consider sponsoring to ensure this project is maintained.\n\n"
+            "[cyan]https://github.com/sponsors/willmcgugan[/cyan]",
+            border_style="green",
             title="Help ensure Rich is maintained",
+            padding=(1, 2),
         )
     )
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_cell_widths.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_cell_widths.py
deleted file mode 100644
index 608ae3a..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_cell_widths.py
+++ /dev/null
@@ -1,454 +0,0 @@
-# Auto generated by make_terminal_widths.py
-
-CELL_WIDTHS = [
-    (0, 0, 0),
-    (1, 31, -1),
-    (127, 159, -1),
-    (173, 173, 0),
-    (768, 879, 0),
-    (1155, 1161, 0),
-    (1425, 1469, 0),
-    (1471, 1471, 0),
-    (1473, 1474, 0),
-    (1476, 1477, 0),
-    (1479, 1479, 0),
-    (1536, 1541, 0),
-    (1552, 1562, 0),
-    (1564, 1564, 0),
-    (1611, 1631, 0),
-    (1648, 1648, 0),
-    (1750, 1757, 0),
-    (1759, 1764, 0),
-    (1767, 1768, 0),
-    (1770, 1773, 0),
-    (1807, 1807, 0),
-    (1809, 1809, 0),
-    (1840, 1866, 0),
-    (1958, 1968, 0),
-    (2027, 2035, 0),
-    (2045, 2045, 0),
-    (2070, 2073, 0),
-    (2075, 2083, 0),
-    (2085, 2087, 0),
-    (2089, 2093, 0),
-    (2137, 2139, 0),
-    (2192, 2193, 0),
-    (2200, 2207, 0),
-    (2250, 2307, 0),
-    (2362, 2364, 0),
-    (2366, 2383, 0),
-    (2385, 2391, 0),
-    (2402, 2403, 0),
-    (2433, 2435, 0),
-    (2492, 2492, 0),
-    (2494, 2500, 0),
-    (2503, 2504, 0),
-    (2507, 2509, 0),
-    (2519, 2519, 0),
-    (2530, 2531, 0),
-    (2558, 2558, 0),
-    (2561, 2563, 0),
-    (2620, 2620, 0),
-    (2622, 2626, 0),
-    (2631, 2632, 0),
-    (2635, 2637, 0),
-    (2641, 2641, 0),
-    (2672, 2673, 0),
-    (2677, 2677, 0),
-    (2689, 2691, 0),
-    (2748, 2748, 0),
-    (2750, 2757, 0),
-    (2759, 2761, 0),
-    (2763, 2765, 0),
-    (2786, 2787, 0),
-    (2810, 2815, 0),
-    (2817, 2819, 0),
-    (2876, 2876, 0),
-    (2878, 2884, 0),
-    (2887, 2888, 0),
-    (2891, 2893, 0),
-    (2901, 2903, 0),
-    (2914, 2915, 0),
-    (2946, 2946, 0),
-    (3006, 3010, 0),
-    (3014, 3016, 0),
-    (3018, 3021, 0),
-    (3031, 3031, 0),
-    (3072, 3076, 0),
-    (3132, 3132, 0),
-    (3134, 3140, 0),
-    (3142, 3144, 0),
-    (3146, 3149, 0),
-    (3157, 3158, 0),
-    (3170, 3171, 0),
-    (3201, 3203, 0),
-    (3260, 3260, 0),
-    (3262, 3268, 0),
-    (3270, 3272, 0),
-    (3274, 3277, 0),
-    (3285, 3286, 0),
-    (3298, 3299, 0),
-    (3315, 3315, 0),
-    (3328, 3331, 0),
-    (3387, 3388, 0),
-    (3390, 3396, 0),
-    (3398, 3400, 0),
-    (3402, 3405, 0),
-    (3415, 3415, 0),
-    (3426, 3427, 0),
-    (3457, 3459, 0),
-    (3530, 3530, 0),
-    (3535, 3540, 0),
-    (3542, 3542, 0),
-    (3544, 3551, 0),
-    (3570, 3571, 0),
-    (3633, 3633, 0),
-    (3636, 3642, 0),
-    (3655, 3662, 0),
-    (3761, 3761, 0),
-    (3764, 3772, 0),
-    (3784, 3790, 0),
-    (3864, 3865, 0),
-    (3893, 3893, 0),
-    (3895, 3895, 0),
-    (3897, 3897, 0),
-    (3902, 3903, 0),
-    (3953, 3972, 0),
-    (3974, 3975, 0),
-    (3981, 3991, 0),
-    (3993, 4028, 0),
-    (4038, 4038, 0),
-    (4139, 4158, 0),
-    (4182, 4185, 0),
-    (4190, 4192, 0),
-    (4194, 4196, 0),
-    (4199, 4205, 0),
-    (4209, 4212, 0),
-    (4226, 4237, 0),
-    (4239, 4239, 0),
-    (4250, 4253, 0),
-    (4352, 4447, 2),
-    (4448, 4607, 0),
-    (4957, 4959, 0),
-    (5906, 5909, 0),
-    (5938, 5940, 0),
-    (5970, 5971, 0),
-    (6002, 6003, 0),
-    (6068, 6099, 0),
-    (6109, 6109, 0),
-    (6155, 6159, 0),
-    (6277, 6278, 0),
-    (6313, 6313, 0),
-    (6432, 6443, 0),
-    (6448, 6459, 0),
-    (6679, 6683, 0),
-    (6741, 6750, 0),
-    (6752, 6780, 0),
-    (6783, 6783, 0),
-    (6832, 6862, 0),
-    (6912, 6916, 0),
-    (6964, 6980, 0),
-    (7019, 7027, 0),
-    (7040, 7042, 0),
-    (7073, 7085, 0),
-    (7142, 7155, 0),
-    (7204, 7223, 0),
-    (7376, 7378, 0),
-    (7380, 7400, 0),
-    (7405, 7405, 0),
-    (7412, 7412, 0),
-    (7415, 7417, 0),
-    (7616, 7679, 0),
-    (8203, 8207, 0),
-    (8232, 8238, 0),
-    (8288, 8292, 0),
-    (8294, 8303, 0),
-    (8400, 8432, 0),
-    (8986, 8987, 2),
-    (9001, 9002, 2),
-    (9193, 9196, 2),
-    (9200, 9200, 2),
-    (9203, 9203, 2),
-    (9725, 9726, 2),
-    (9748, 9749, 2),
-    (9800, 9811, 2),
-    (9855, 9855, 2),
-    (9875, 9875, 2),
-    (9889, 9889, 2),
-    (9898, 9899, 2),
-    (9917, 9918, 2),
-    (9924, 9925, 2),
-    (9934, 9934, 2),
-    (9940, 9940, 2),
-    (9962, 9962, 2),
-    (9970, 9971, 2),
-    (9973, 9973, 2),
-    (9978, 9978, 2),
-    (9981, 9981, 2),
-    (9989, 9989, 2),
-    (9994, 9995, 2),
-    (10024, 10024, 2),
-    (10060, 10060, 2),
-    (10062, 10062, 2),
-    (10067, 10069, 2),
-    (10071, 10071, 2),
-    (10133, 10135, 2),
-    (10160, 10160, 2),
-    (10175, 10175, 2),
-    (11035, 11036, 2),
-    (11088, 11088, 2),
-    (11093, 11093, 2),
-    (11503, 11505, 0),
-    (11647, 11647, 0),
-    (11744, 11775, 0),
-    (11904, 11929, 2),
-    (11931, 12019, 2),
-    (12032, 12245, 2),
-    (12272, 12329, 2),
-    (12330, 12335, 0),
-    (12336, 12350, 2),
-    (12353, 12438, 2),
-    (12441, 12442, 0),
-    (12443, 12543, 2),
-    (12549, 12591, 2),
-    (12593, 12686, 2),
-    (12688, 12771, 2),
-    (12783, 12830, 2),
-    (12832, 12871, 2),
-    (12880, 19903, 2),
-    (19968, 42124, 2),
-    (42128, 42182, 2),
-    (42607, 42610, 0),
-    (42612, 42621, 0),
-    (42654, 42655, 0),
-    (42736, 42737, 0),
-    (43010, 43010, 0),
-    (43014, 43014, 0),
-    (43019, 43019, 0),
-    (43043, 43047, 0),
-    (43052, 43052, 0),
-    (43136, 43137, 0),
-    (43188, 43205, 0),
-    (43232, 43249, 0),
-    (43263, 43263, 0),
-    (43302, 43309, 0),
-    (43335, 43347, 0),
-    (43360, 43388, 2),
-    (43392, 43395, 0),
-    (43443, 43456, 0),
-    (43493, 43493, 0),
-    (43561, 43574, 0),
-    (43587, 43587, 0),
-    (43596, 43597, 0),
-    (43643, 43645, 0),
-    (43696, 43696, 0),
-    (43698, 43700, 0),
-    (43703, 43704, 0),
-    (43710, 43711, 0),
-    (43713, 43713, 0),
-    (43755, 43759, 0),
-    (43765, 43766, 0),
-    (44003, 44010, 0),
-    (44012, 44013, 0),
-    (44032, 55203, 2),
-    (55216, 55295, 0),
-    (63744, 64255, 2),
-    (64286, 64286, 0),
-    (65024, 65039, 0),
-    (65040, 65049, 2),
-    (65056, 65071, 0),
-    (65072, 65106, 2),
-    (65108, 65126, 2),
-    (65128, 65131, 2),
-    (65279, 65279, 0),
-    (65281, 65376, 2),
-    (65504, 65510, 2),
-    (65529, 65531, 0),
-    (66045, 66045, 0),
-    (66272, 66272, 0),
-    (66422, 66426, 0),
-    (68097, 68099, 0),
-    (68101, 68102, 0),
-    (68108, 68111, 0),
-    (68152, 68154, 0),
-    (68159, 68159, 0),
-    (68325, 68326, 0),
-    (68900, 68903, 0),
-    (69291, 69292, 0),
-    (69373, 69375, 0),
-    (69446, 69456, 0),
-    (69506, 69509, 0),
-    (69632, 69634, 0),
-    (69688, 69702, 0),
-    (69744, 69744, 0),
-    (69747, 69748, 0),
-    (69759, 69762, 0),
-    (69808, 69818, 0),
-    (69821, 69821, 0),
-    (69826, 69826, 0),
-    (69837, 69837, 0),
-    (69888, 69890, 0),
-    (69927, 69940, 0),
-    (69957, 69958, 0),
-    (70003, 70003, 0),
-    (70016, 70018, 0),
-    (70067, 70080, 0),
-    (70089, 70092, 0),
-    (70094, 70095, 0),
-    (70188, 70199, 0),
-    (70206, 70206, 0),
-    (70209, 70209, 0),
-    (70367, 70378, 0),
-    (70400, 70403, 0),
-    (70459, 70460, 0),
-    (70462, 70468, 0),
-    (70471, 70472, 0),
-    (70475, 70477, 0),
-    (70487, 70487, 0),
-    (70498, 70499, 0),
-    (70502, 70508, 0),
-    (70512, 70516, 0),
-    (70709, 70726, 0),
-    (70750, 70750, 0),
-    (70832, 70851, 0),
-    (71087, 71093, 0),
-    (71096, 71104, 0),
-    (71132, 71133, 0),
-    (71216, 71232, 0),
-    (71339, 71351, 0),
-    (71453, 71467, 0),
-    (71724, 71738, 0),
-    (71984, 71989, 0),
-    (71991, 71992, 0),
-    (71995, 71998, 0),
-    (72000, 72000, 0),
-    (72002, 72003, 0),
-    (72145, 72151, 0),
-    (72154, 72160, 0),
-    (72164, 72164, 0),
-    (72193, 72202, 0),
-    (72243, 72249, 0),
-    (72251, 72254, 0),
-    (72263, 72263, 0),
-    (72273, 72283, 0),
-    (72330, 72345, 0),
-    (72751, 72758, 0),
-    (72760, 72767, 0),
-    (72850, 72871, 0),
-    (72873, 72886, 0),
-    (73009, 73014, 0),
-    (73018, 73018, 0),
-    (73020, 73021, 0),
-    (73023, 73029, 0),
-    (73031, 73031, 0),
-    (73098, 73102, 0),
-    (73104, 73105, 0),
-    (73107, 73111, 0),
-    (73459, 73462, 0),
-    (73472, 73473, 0),
-    (73475, 73475, 0),
-    (73524, 73530, 0),
-    (73534, 73538, 0),
-    (78896, 78912, 0),
-    (78919, 78933, 0),
-    (92912, 92916, 0),
-    (92976, 92982, 0),
-    (94031, 94031, 0),
-    (94033, 94087, 0),
-    (94095, 94098, 0),
-    (94176, 94179, 2),
-    (94180, 94180, 0),
-    (94192, 94193, 0),
-    (94208, 100343, 2),
-    (100352, 101589, 2),
-    (101632, 101640, 2),
-    (110576, 110579, 2),
-    (110581, 110587, 2),
-    (110589, 110590, 2),
-    (110592, 110882, 2),
-    (110898, 110898, 2),
-    (110928, 110930, 2),
-    (110933, 110933, 2),
-    (110948, 110951, 2),
-    (110960, 111355, 2),
-    (113821, 113822, 0),
-    (113824, 113827, 0),
-    (118528, 118573, 0),
-    (118576, 118598, 0),
-    (119141, 119145, 0),
-    (119149, 119170, 0),
-    (119173, 119179, 0),
-    (119210, 119213, 0),
-    (119362, 119364, 0),
-    (121344, 121398, 0),
-    (121403, 121452, 0),
-    (121461, 121461, 0),
-    (121476, 121476, 0),
-    (121499, 121503, 0),
-    (121505, 121519, 0),
-    (122880, 122886, 0),
-    (122888, 122904, 0),
-    (122907, 122913, 0),
-    (122915, 122916, 0),
-    (122918, 122922, 0),
-    (123023, 123023, 0),
-    (123184, 123190, 0),
-    (123566, 123566, 0),
-    (123628, 123631, 0),
-    (124140, 124143, 0),
-    (125136, 125142, 0),
-    (125252, 125258, 0),
-    (126980, 126980, 2),
-    (127183, 127183, 2),
-    (127374, 127374, 2),
-    (127377, 127386, 2),
-    (127488, 127490, 2),
-    (127504, 127547, 2),
-    (127552, 127560, 2),
-    (127568, 127569, 2),
-    (127584, 127589, 2),
-    (127744, 127776, 2),
-    (127789, 127797, 2),
-    (127799, 127868, 2),
-    (127870, 127891, 2),
-    (127904, 127946, 2),
-    (127951, 127955, 2),
-    (127968, 127984, 2),
-    (127988, 127988, 2),
-    (127992, 127994, 2),
-    (127995, 127999, 0),
-    (128000, 128062, 2),
-    (128064, 128064, 2),
-    (128066, 128252, 2),
-    (128255, 128317, 2),
-    (128331, 128334, 2),
-    (128336, 128359, 2),
-    (128378, 128378, 2),
-    (128405, 128406, 2),
-    (128420, 128420, 2),
-    (128507, 128591, 2),
-    (128640, 128709, 2),
-    (128716, 128716, 2),
-    (128720, 128722, 2),
-    (128725, 128727, 2),
-    (128732, 128735, 2),
-    (128747, 128748, 2),
-    (128756, 128764, 2),
-    (128992, 129003, 2),
-    (129008, 129008, 2),
-    (129292, 129338, 2),
-    (129340, 129349, 2),
-    (129351, 129535, 2),
-    (129648, 129660, 2),
-    (129664, 129672, 2),
-    (129680, 129725, 2),
-    (129727, 129733, 2),
-    (129742, 129755, 2),
-    (129760, 129768, 2),
-    (129776, 129784, 2),
-    (131072, 196605, 2),
-    (196608, 262141, 2),
-    (917505, 917505, 0),
-    (917536, 917631, 0),
-    (917760, 917999, 0),
-]
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_emoji_replace.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_emoji_replace.py
index bb2cafa..fdaff32 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_emoji_replace.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_emoji_replace.py
@@ -1,8 +1,5 @@
-from typing import Callable, Match, Optional
 import re
-
-from ._emoji_codes import EMOJI
-
+from typing import Callable, Match, Optional
 
 _ReStringMatch = Match[str]  # regex match object
 _ReSubCallable = Callable[[_ReStringMatch], str]  # Callable invoked by re.sub
@@ -15,8 +12,10 @@ def _emoji_replace(
     _emoji_sub: _EmojiSubMethod = re.compile(r"(:(\S*?)(?:(?:\-)(emoji|text))?:)").sub,
 ) -> str:
     """Replace emoji code in text."""
+    from ._emoji_codes import EMOJI
+
     get_emoji = EMOJI.__getitem__
-    variants = {"text": "\uFE0E", "emoji": "\uFE0F"}
+    variants = {"text": "\ufe0e", "emoji": "\ufe0f"}
     get_variant = variants.get
     default_variant_code = variants.get(default_variant, "") if default_variant else ""
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_inspect.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_inspect.py
index 27d65ce..ac78ffe 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_inspect.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/_inspect.py
@@ -29,7 +29,7 @@ class Inspect(JupyterMixin):
         docs (bool, optional): Also render doc strings. Defaults to True.
         private (bool, optional): Show private attributes (beginning with underscore). Defaults to False.
         dunder (bool, optional): Show attributes starting with double underscore. Defaults to False.
-        sort (bool, optional): Sort attributes alphabetically. Defaults to True.
+        sort (bool, optional): Sort attributes alphabetically, callables at the top, leading and trailing underscores ignored. Defaults to True.
         all (bool, optional): Show all attributes. Defaults to False.
         value (bool, optional): Pretty print value of object. Defaults to True.
     """
@@ -101,6 +101,10 @@ class Inspect(JupyterMixin):
         signature_text = self.highlighter(_signature)
 
         qualname = name or getattr(obj, "__qualname__", name)
+        if not isinstance(qualname, str):
+            qualname = getattr(obj, "__name__", name)
+            if not isinstance(qualname, str):
+                qualname = name
 
         # If obj is a module, there may be classes (which are callable) to display
         if inspect.isclass(obj):
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/align.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/align.py
index e65dc5b..81b6935 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/align.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/align.py
@@ -28,6 +28,20 @@ class Align(JupyterMixin):
 
     Raises:
         ValueError: if ``align`` is not one of the expected values.
+
+    Example:
+        .. code-block:: python
+
+            from pip._vendor.rich.console import Console
+            from pip._vendor.rich.align import Align
+            from pip._vendor.rich.panel import Panel
+
+            console = Console()
+            # Create a panel 20 characters wide
+            p = Panel("Hello, [b]World[/b]!", style="on green", width=20)
+
+            # Renders the panel centered in the terminal
+            console.print(Align(p, align="center"))
     """
 
     def __init__(
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/ansi.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/ansi.py
index 7de86ce..7bbcb0b 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/ansi.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/ansi.py
@@ -127,13 +127,13 @@ class AnsiDecoder:
         """Decode ANSI codes in an iterable of lines.
 
         Args:
-            lines (Iterable[str]): An iterable of lines of terminal output.
+            terminal_text: Output potentially containing ANSI escape sequences.
 
         Yields:
             Text: Marked up Text.
         """
-        for line in terminal_text.splitlines():
-            yield self.decode_line(line)
+        for line in re.split(r"(?<=\n)", terminal_text):
+            yield self.decode_line(line.rstrip("\n"))
 
     def decode_line(self, line: str) -> Text:
         """Decode a line containing ansi codes.
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/cells.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/cells.py
index a854622..1553be2 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/cells.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/cells.py
@@ -1,9 +1,14 @@
 from __future__ import annotations
 
 from functools import lru_cache
-from typing import Callable
+from operator import itemgetter
+from typing import Callable, NamedTuple, Sequence, Tuple
 
-from ._cell_widths import CELL_WIDTHS
+from pip._vendor.rich._unicode_data import load as load_cell_table
+
+CellSpan = Tuple[int, int, int]
+
+_span_get_cell_len = itemgetter(2)
 
 # Ranges of unicode ordinals that produce a 1-cell wide character
 # This is non-exhaustive, but covers most common Western characters
@@ -16,7 +21,7 @@ _SINGLE_CELL_UNICODE_RANGES: list[tuple[int, int]] = [
     (0x02800, 0x028FF),  # Braille
 ]
 
-# A set of characters that are a single cell wide
+# A frozen set of characters that are a single cell wide
 _SINGLE_CELLS = frozenset(
     [
         character
@@ -30,8 +35,51 @@ _SINGLE_CELLS = frozenset(
 _is_single_cell_widths: Callable[[str], bool] = _SINGLE_CELLS.issuperset
 
 
+class CellTable(NamedTuple):
+    """Contains unicode data required to measure the cell widths of glyphs."""
+
+    unicode_version: str
+    widths: Sequence[tuple[int, int, int]]
+    narrow_to_wide: frozenset[str]
+
+
+@lru_cache(maxsize=4096)
+def get_character_cell_size(character: str, unicode_version: str = "auto") -> int:
+    """Get the cell size of a character.
+
+    Args:
+        character (str): A single character.
+        unicode_version: Unicode version, `"auto"` to auto detect, `"latest"` for the latest unicode version.
+
+    Returns:
+        int: Number of cells (0, 1 or 2) occupied by that character.
+    """
+    codepoint = ord(character)
+    if codepoint and codepoint < 32 or 0x07F <= codepoint < 0x0A0:
+        return 0
+    table = load_cell_table(unicode_version).widths
+
+    last_entry = table[-1]
+    if codepoint > last_entry[1]:
+        return 1
+
+    lower_bound = 0
+    upper_bound = len(table) - 1
+
+    while lower_bound <= upper_bound:
+        index = (lower_bound + upper_bound) >> 1
+        start, end, width = table[index]
+        if codepoint < start:
+            upper_bound = index - 1
+        elif codepoint > end:
+            lower_bound = index + 1
+        else:
+            return width
+    return 1
+
+
 @lru_cache(4096)
-def cached_cell_len(text: str) -> int:
+def cached_cell_len(text: str, unicode_version: str = "auto") -> int:
     """Get the number of cells required to display text.
 
     This method always caches, which may use up a lot of memory. It is recommended to use
@@ -39,69 +87,231 @@ def cached_cell_len(text: str) -> int:
 
     Args:
         text (str): Text to display.
+        unicode_version: Unicode version, `"auto"` to auto detect, `"latest"` for the latest unicode version.
 
     Returns:
         int: Get the number of cells required to display text.
     """
-    if _is_single_cell_widths(text):
-        return len(text)
-    return sum(map(get_character_cell_size, text))
+    return _cell_len(text, unicode_version)
 
 
-def cell_len(text: str, _cell_len: Callable[[str], int] = cached_cell_len) -> int:
-    """Get the number of cells required to display text.
+def cell_len(text: str, unicode_version: str = "auto") -> int:
+    """Get the cell length of a string (length as it appears in the terminal).
 
     Args:
-        text (str): Text to display.
+        text: String to measure.
+        unicode_version: Unicode version, `"auto"` to auto detect, `"latest"` for the latest unicode version.
 
     Returns:
-        int: Get the number of cells required to display text.
+        Length of string in terminal cells.
     """
     if len(text) < 512:
-        return _cell_len(text)
-    if _is_single_cell_widths(text):
-        return len(text)
-    return sum(map(get_character_cell_size, text))
+        return cached_cell_len(text, unicode_version)
+    return _cell_len(text, unicode_version)
 
 
-@lru_cache(maxsize=4096)
-def get_character_cell_size(character: str) -> int:
-    """Get the cell size of a character.
+def _cell_len(text: str, unicode_version: str) -> int:
+    """Get the cell length of a string (length as it appears in the terminal).
 
     Args:
-        character (str): A single character.
+        text: String to measure.
+        unicode_version: Unicode version, `"auto"` to auto detect, `"latest"` for the latest unicode version.
 
     Returns:
-        int: Number of cells (0, 1 or 2) occupied by that character.
+        Length of string in terminal cells.
     """
-    codepoint = ord(character)
-    _table = CELL_WIDTHS
-    lower_bound = 0
-    upper_bound = len(_table) - 1
-    index = (lower_bound + upper_bound) // 2
-    while True:
-        start, end, width = _table[index]
-        if codepoint < start:
-            upper_bound = index - 1
-        elif codepoint > end:
-            lower_bound = index + 1
+
+    if _is_single_cell_widths(text):
+        return len(text)
+
+    # "\u200d" is zero width joiner
+    # "\ufe0f" is variation selector 16
+    if "\u200d" not in text and "\ufe0f" not in text:
+        # Simplest case with no unicode stuff that changes the size
+        return sum(
+            get_character_cell_size(character, unicode_version) for character in text
+        )
+
+    cell_table = load_cell_table(unicode_version)
+    total_width = 0
+    last_measured_character: str | None = None
+
+    SPECIAL = {"\u200d", "\ufe0f"}
+
+    index = 0
+    character_count = len(text)
+
+    while index < character_count:
+        character = text[index]
+        if character in SPECIAL:
+            if character == "\u200d":
+                index += 1
+            elif last_measured_character:
+                total_width += last_measured_character in cell_table.narrow_to_wide
+                last_measured_character = None
         else:
-            return 0 if width == -1 else width
-        if upper_bound < lower_bound:
-            break
-        index = (lower_bound + upper_bound) // 2
-    return 1
+            if character_width := get_character_cell_size(character, unicode_version):
+                last_measured_character = character
+                total_width += character_width
+        index += 1
+
+    return total_width
 
 
-def set_cell_size(text: str, total: int) -> str:
-    """Set the length of a string to fit within given number of cells."""
+def split_graphemes(
+    text: str, unicode_version: str = "auto"
+) -> "tuple[list[CellSpan], int]":
+    """Divide text into spans that define a single grapheme, and additionally return the cell length of the whole string.
 
+    The returned spans will cover every index in the string, with no gaps. It is possible for some graphemes to have a cell length of zero.
+    This can occur for nonsense strings like two zero width joiners, or for control codes that don't contribute to the grapheme size.
+
+    Args:
+        text: String to split.
+        unicode_version: Unicode version, `"auto"` to auto detect, `"latest"` for the latest unicode version.
+
+    Returns:
+        A tuple of a list of *spans* and the cell length of the entire string. A span is a list of tuples
+            of three values consisting of (, , ), where START and END are string indices,
+            and CELL LENGTH is the cell length of the single grapheme.
+    """
+
+    cell_table = load_cell_table(unicode_version)
+    codepoint_count = len(text)
+    index = 0
+    last_measured_character: str | None = None
+
+    total_width = 0
+    spans: list[tuple[int, int, int]] = []
+    SPECIAL = {"\u200d", "\ufe0f"}
+    while index < codepoint_count:
+        if (character := text[index]) in SPECIAL:
+            if not spans:
+                # ZWJ or variation selector at the beginning of the string doesn't really make sense.
+                # But handle it, we must.
+                spans.append((index, index := index + 1, 0))
+                continue
+            if character == "\u200d":
+                # zero width joiner
+                # The condition handles the case where a ZWJ is at the end of the string, and has nothing to join
+                index += 2 if index < (codepoint_count - 1) else 1
+                start, _end, cell_length = spans[-1]
+                spans[-1] = (start, index, cell_length)
+            else:
+                # variation selector 16
+                index += 1
+                if last_measured_character:
+                    start, _end, cell_length = spans[-1]
+                    if last_measured_character in cell_table.narrow_to_wide:
+                        last_measured_character = None
+                        cell_length += 1
+                        total_width += 1
+                    spans[-1] = (start, index, cell_length)
+                else:
+                    # No previous character to change the size of.
+                    # Shouldn't occur in practice.
+                    # But handle it, we must.
+                    start, _end, cell_length = spans[-1]
+                    spans[-1] = (start, index, cell_length)
+            continue
+
+        if character_width := get_character_cell_size(character, unicode_version):
+            last_measured_character = character
+            spans.append((index, index := index + 1, character_width))
+            total_width += character_width
+        else:
+            # Character has zero width
+            if spans:
+                # zero width characters are associated with the previous character
+                start, _end, cell_length = spans[-1]
+                spans[-1] = (start, index := index + 1, cell_length)
+            else:
+                # A zero width character with no prior spans
+                spans.append((index, index := index + 1, 0))
+
+    return (spans, total_width)
+
+
+def _split_text(
+    text: str, cell_position: int, unicode_version: str = "auto"
+) -> tuple[str, str]:
+    """Split text by cell position.
+
+    If the cell position falls within a double width character, it is converted to two spaces.
+
+    Args:
+        text: Text to split.
+        cell_position Offset in cells.
+        unicode_version: Unicode version, `"auto"` to auto detect, `"latest"` for the latest unicode version.
+
+    Returns:
+        Tuple to two split strings.
+    """
+    if cell_position <= 0:
+        return "", text
+
+    spans, cell_length = split_graphemes(text, unicode_version)
+
+    # Guess initial offset
+    offset = int((cell_position / cell_length) * len(spans))
+    left_size = sum(map(_span_get_cell_len, spans[:offset]))
+
+    while True:
+        if left_size == cell_position:
+            if offset >= len(spans):
+                return text, ""
+            split_index = spans[offset][0]
+            return text[:split_index], text[split_index:]
+        if left_size < cell_position:
+            start, end, cell_size = spans[offset]
+            if left_size + cell_size > cell_position:
+                return text[:start] + " ", " " + text[end:]
+            offset += 1
+            left_size += cell_size
+        else:  # left_size > cell_position
+            start, end, cell_size = spans[offset - 1]
+            if left_size - cell_size < cell_position:
+                return text[:start] + " ", " " + text[end:]
+            offset -= 1
+            left_size -= cell_size
+
+
+def split_text(
+    text: str, cell_position: int, unicode_version: str = "auto"
+) -> tuple[str, str]:
+    """Split text by cell position.
+
+    If the cell position falls within a double width character, it is converted to two spaces.
+
+    Args:
+        text: Text to split.
+        cell_position Offset in cells.
+        unicode_version: Unicode version, `"auto"` to auto detect, `"latest"` for the latest unicode version.
+
+    Returns:
+        Tuple to two split strings.
+    """
+    if _is_single_cell_widths(text):
+        return text[:cell_position], text[cell_position:]
+    return _split_text(text, cell_position, unicode_version)
+
+
+def set_cell_size(text: str, total: int, unicode_version: str = "auto") -> str:
+    """Adjust a string by cropping or padding with spaces such that it fits within the given number of cells.
+
+    Args:
+        text: String to adjust.
+        total: Desired size in cells.
+        unicode_version: Unicode version.
+
+    Returns:
+        A string with cell size equal to total.
+    """
     if _is_single_cell_widths(text):
         size = len(text)
         if size < total:
             return text + " " * (total - size)
         return text[:total]
-
     if total <= 0:
         return ""
     cell_size = cell_len(text)
@@ -109,29 +319,11 @@ def set_cell_size(text: str, total: int) -> str:
         return text
     if cell_size < total:
         return text + " " * (total - cell_size)
-
-    start = 0
-    end = len(text)
-
-    # Binary search until we find the right size
-    while True:
-        pos = (start + end) // 2
-        before = text[: pos + 1]
-        before_len = cell_len(before)
-        if before_len == total + 1 and cell_len(before[-1]) == 2:
-            return before[:-1] + " "
-        if before_len == total:
-            return before
-        if before_len > total:
-            end = pos
-        else:
-            start = pos
+    text, _ = _split_text(text, total, unicode_version)
+    return text
 
 
-def chop_cells(
-    text: str,
-    width: int,
-) -> list[str]:
+def chop_cells(text: str, width: int, unicode_version: str = "auto") -> list[str]:
     """Split text into lines such that each line fits within the available (cell) width.
 
     Args:
@@ -142,33 +334,19 @@ def chop_cells(
         A list of strings such that each string in the list has cell width
         less than or equal to the available width.
     """
-    _get_character_cell_size = get_character_cell_size
-    lines: list[list[str]] = [[]]
+    if _is_single_cell_widths(text):
+        return [text[index : index + width] for index in range(0, len(text), width)]
+    spans, _ = split_graphemes(text, unicode_version)
+    line_size = 0  # Size of line in cells
+    lines: list[str] = []
+    line_offset = 0  # Offset (in codepoints) of start of line
+    for start, end, cell_size in spans:
+        if line_size + cell_size > width:
+            lines.append(text[line_offset:start])
+            line_offset = start
+            line_size = 0
+        line_size += cell_size
+    if line_size:
+        lines.append(text[line_offset:])
 
-    append_new_line = lines.append
-    append_to_last_line = lines[-1].append
-
-    total_width = 0
-
-    for character in text:
-        cell_width = _get_character_cell_size(character)
-        char_doesnt_fit = total_width + cell_width > width
-
-        if char_doesnt_fit:
-            append_new_line([character])
-            append_to_last_line = lines[-1].append
-            total_width = cell_width
-        else:
-            append_to_last_line(character)
-            total_width += cell_width
-
-    return ["".join(line) for line in lines]
-
-
-if __name__ == "__main__":  # pragma: no cover
-    print(get_character_cell_size("😽"))
-    for line in chop_cells("""这是对亚洲语言支持的测试。面对模棱两可的想法,拒绝猜测的诱惑。""", 8):
-        print(line)
-    for n in range(80, 1, -1):
-        print(set_cell_size("""这是对亚洲语言支持的测试。面对模棱两可的想法,拒绝猜测的诱惑。""", n) + "|")
-        print("x" * n)
+    return lines
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/console.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/console.py
index db2ba55..033fbdb 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/console.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/console.py
@@ -1,17 +1,13 @@
-import inspect
 import os
 import sys
 import threading
-import zlib
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from datetime import datetime
 from functools import wraps
-from getpass import getpass
-from html import escape
-from inspect import isclass
 from itertools import islice
 from math import ceil
+from os import PathLike
 from time import monotonic
 from types import FrameType, ModuleType, TracebackType
 from typing import (
@@ -50,10 +46,8 @@ from .highlighter import NullHighlighter, ReprHighlighter
 from .markup import render as render_markup
 from .measure import Measurement, measure_renderables
 from .pager import Pager, SystemPager
-from .pretty import Pretty, is_expandable
 from .protocol import rich_cast
 from .region import Region
-from .scope import render_scope
 from .screen import Screen
 from .segment import Segment
 from .style import Style, StyleType
@@ -1321,7 +1315,7 @@ class Console:
         render_iterable: RenderResult
 
         renderable = rich_cast(renderable)
-        if hasattr(renderable, "__rich_console__") and not isclass(renderable):
+        if hasattr(renderable, "__rich_console__") and not isinstance(renderable, type):
             render_iterable = renderable.__rich_console__(self, _options)
         elif isinstance(renderable, str):
             text_renderable = self.render_str(
@@ -1528,6 +1522,14 @@ class Console:
         Returns:
             List[ConsoleRenderable]: A list of things to render.
         """
+
+        def is_expandable(obj: object) -> bool:
+            """Check if an object is expandable by pretty printer."""
+            # Permit lazy loading
+            from .pretty import is_expandable as _is_expandable
+
+            return _is_expandable(obj)
+
         renderables: List[ConsoleRenderable] = []
         _append = renderables.append
         text: List[Text] = []
@@ -1570,6 +1572,8 @@ class Console:
                 append(renderable)
             elif is_expandable(renderable):
                 check_text()
+                from .pretty import Pretty
+
                 append(Pretty(renderable, highlighter=_highlighter))
             else:
                 append_text(_highlighter(str(renderable)))
@@ -1683,7 +1687,10 @@ class Console:
             new_line_start (bool, False): Insert a new line at the start if the output contains more than one line. Defaults to ``False``.
         """
         if not objects:
-            objects = (NewLine(),)
+            if end == "\n":
+                objects = (NewLine(),)
+            else:
+                objects = ("",)
 
         if soft_wrap is None:
             soft_wrap = self.soft_wrap
@@ -1723,12 +1730,16 @@ class Console:
                 for renderable in renderables:
                     extend(render(renderable, render_options))
             else:
+                render_style = self.get_style(style)
+                new_line = Segment.line()
                 for renderable in renderables:
-                    extend(
-                        Segment.apply_style(
-                            render(renderable, render_options), self.get_style(style)
-                        )
-                    )
+                    for line, add_new_line in Segment.split_lines_terminator(
+                        render(renderable, render_options)
+                    ):
+                        extend(Segment.apply_style(line, render_style))
+                        if add_new_line:
+                            new_segments.append(new_line)
+
             if new_line_start:
                 if (
                     len("".join(segment.text for segment in new_segments).splitlines())
@@ -1896,15 +1907,14 @@ class Console:
 
     @staticmethod
     def _caller_frame_info(
-        offset: int,
-        currentframe: Callable[[], Optional[FrameType]] = inspect.currentframe,
+        offset: int, currentframe: Optional[Callable[[], Optional[FrameType]]] = None
     ) -> Tuple[str, int, Dict[str, Any]]:
         """Get caller frame information.
 
         Args:
             offset (int): the caller offset within the current frame stack.
             currentframe (Callable[[], Optional[FrameType]], optional): the callable to use to
-                retrieve the current frame. Defaults to ``inspect.currentframe``.
+                retrieve the current frame. Defaults to None, which will use ``inspect.currentframe()``.
 
         Returns:
             Tuple[str, int, Dict[str, Any]]: A tuple containing the filename, the line number and
@@ -1916,17 +1926,22 @@ class Console:
         # Ignore the frame of this local helper
         offset += 1
 
-        frame = currentframe()
+        if currentframe is None:
+            import inspect
+
+            frame = inspect.currentframe()
+        else:
+            frame = currentframe()
         if frame is not None:
-            # Use the faster currentframe where implemented
             while offset and frame is not None:
                 frame = frame.f_back
                 offset -= 1
             assert frame is not None
             return frame.f_code.co_filename, frame.f_lineno, frame.f_locals
         else:
-            # Fallback to the slower stack
-            frame_info = inspect.stack()[offset]
+            from inspect import stack
+
+            frame_info = stack()[offset]
             return frame_info.filename, frame_info.lineno, frame_info.frame.f_locals
 
     def log(
@@ -1979,6 +1994,8 @@ class Console:
             link_path = None if filename.startswith("<") else os.path.abspath(filename)
             path = filename.rpartition(os.sep)[-1]
             if log_locals:
+                from .scope import render_scope
+
                 locals_map = {
                     key: value
                     for key, value in locals.items()
@@ -2162,7 +2179,9 @@ class Console:
         if prompt:
             self.print(prompt, markup=markup, emoji=emoji, end="")
         if password:
-            result = getpass("", stream=stream)
+            import getpass as _getpass_mod
+
+            result = _getpass_mod.getpass("", stream=stream)
         else:
             if stream:
                 result = stream.readline()
@@ -2202,11 +2221,17 @@ class Console:
                 del self._record_buffer[:]
         return text
 
-    def save_text(self, path: str, *, clear: bool = True, styles: bool = False) -> None:
+    def save_text(
+        self,
+        path: Union[str, PathLike[str]],
+        *,
+        clear: bool = True,
+        styles: bool = False,
+    ) -> None:
         """Generate text from console and save to a given location (requires record=True argument in constructor).
 
         Args:
-            path (str): Path to write text files.
+            path (Union[str, PathLike[str]]): Path to write text files.
             clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
             styles (bool, optional): If ``True``, ansi style codes will be included. ``False`` for plain text.
                 Defaults to ``False``.
@@ -2238,6 +2263,8 @@ class Console:
         Returns:
             str: String containing console contents as HTML.
         """
+        from html import escape
+
         assert (
             self.record
         ), "To export console contents set record=True in the constructor or instance"
@@ -2293,7 +2320,7 @@ class Console:
 
     def save_html(
         self,
-        path: str,
+        path: Union[str, PathLike[str]],
         *,
         theme: Optional[TerminalTheme] = None,
         clear: bool = True,
@@ -2303,7 +2330,7 @@ class Console:
         """Generate HTML from console contents and write to a file (requires record=True argument in constructor).
 
         Args:
-            path (str): Path to write html file.
+            path (Union[str, PathLike[str]]): Path to write html file.
             theme (TerminalTheme, optional): TerminalTheme object containing console colors.
             clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``.
             code_format (str, optional): Format string to render HTML. In addition to '{foreground}',
@@ -2349,6 +2376,9 @@ class Console:
                 ids). If not set, this defaults to a computed value based on the recorded content.
         """
 
+        import zlib
+        from html import escape
+
         from pip._vendor.rich.cells import cell_len
 
         style_cache: Dict[Style, str] = {}
@@ -2575,7 +2605,7 @@ class Console:
 
     def save_svg(
         self,
-        path: str,
+        path: Union[str, PathLike[str]],
         *,
         title: str = "Rich",
         theme: Optional[TerminalTheme] = None,
@@ -2587,7 +2617,7 @@ class Console:
         """Generate an SVG file from the console contents (requires record=True in Console constructor).
 
         Args:
-            path (str): The path to write the SVG to.
+            path (Union[str, PathLike[str]]): The path to write the SVG to.
             title (str, optional): The title of the tab in the output image
             theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal
             clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``
@@ -2612,18 +2642,6 @@ class Console:
             write_file.write(svg)
 
 
-def _svg_hash(svg_main_code: str) -> str:
-    """Returns a unique hash for the given SVG main code.
-
-    Args:
-        svg_main_code (str): The content we're going to inject in the SVG envelope.
-
-    Returns:
-        str: a hash of the given content
-    """
-    return str(zlib.adler32(svg_main_code.encode()))
-
-
 if __name__ == "__main__":  # pragma: no cover
     console = Console(record=True)
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/default_styles.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/default_styles.py
index 61797bf..b117f6c 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/default_styles.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/default_styles.py
@@ -149,20 +149,23 @@ DEFAULT_STYLES: Dict[str, Style] = {
     "markdown.block_quote": Style(color="magenta"),
     "markdown.list": Style(color="cyan"),
     "markdown.item": Style(),
-    "markdown.item.bullet": Style(color="yellow", bold=True),
-    "markdown.item.number": Style(color="yellow", bold=True),
-    "markdown.hr": Style(color="yellow"),
+    "markdown.item.bullet": Style(bold=True),
+    "markdown.item.number": Style(color="cyan"),
+    "markdown.hr": Style(dim=True),
     "markdown.h1.border": Style(),
-    "markdown.h1": Style(bold=True),
-    "markdown.h2": Style(bold=True, underline=True),
-    "markdown.h3": Style(bold=True),
-    "markdown.h4": Style(bold=True, dim=True),
-    "markdown.h5": Style(underline=True),
-    "markdown.h6": Style(italic=True),
+    "markdown.h1": Style(bold=True, underline=True),
+    "markdown.h2": Style(color="magenta", underline=True),
+    "markdown.h3": Style(color="magenta", bold=True),
+    "markdown.h4": Style(color="magenta", italic=True),
+    "markdown.h5": Style(italic=True),
+    "markdown.h6": Style(dim=True),
     "markdown.h7": Style(italic=True, dim=True),
     "markdown.link": Style(color="bright_blue"),
     "markdown.link_url": Style(color="blue", underline=True),
     "markdown.s": Style(strike=True),
+    "markdown.table.border": Style(color="cyan"),
+    "markdown.table.header": Style(color="cyan", bold=False),
+    "markdown.kbd": Style(bold=True, color="bright_yellow"),
     "iso8601.date": Style(color="blue"),
     "iso8601.time": Style(color="magenta"),
     "iso8601.timezone": Style(color="yellow"),
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/emoji.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/emoji.py
index 4a667ed..ec8fdc3 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/emoji.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/emoji.py
@@ -1,12 +1,10 @@
 import sys
-from typing import TYPE_CHECKING, Optional, Union, Literal
+from typing import TYPE_CHECKING, Literal, Optional, Union
 
+from ._emoji_replace import _emoji_replace
 from .jupyter import JupyterMixin
 from .segment import Segment
 from .style import Style
-from ._emoji_codes import EMOJI
-from ._emoji_replace import _emoji_replace
-
 
 if TYPE_CHECKING:
     from .console import Console, ConsoleOptions, RenderResult
@@ -22,7 +20,7 @@ class NoEmoji(Exception):
 class Emoji(JupyterMixin):
     __slots__ = ["name", "style", "_char", "variant"]
 
-    VARIANTS = {"text": "\uFE0E", "emoji": "\uFE0F"}
+    VARIANTS = {"text": "\ufe0e", "emoji": "\ufe0f"}
 
     def __init__(
         self,
@@ -39,6 +37,8 @@ class Emoji(JupyterMixin):
         Raises:
             NoEmoji: If the emoji doesn't exist.
         """
+        from ._emoji_codes import EMOJI
+
         self.name = name
         self.style = style
         self.variant = variant
@@ -81,8 +81,10 @@ if __name__ == "__main__":  # pragma: no cover
 
     console = Console(record=True)
 
+    from ._emoji_codes import EMOJI
+
     columns = Columns(
-        (f":{name}: {name}" for name in sorted(EMOJI.keys()) if "\u200D" not in name),
+        (f":{name}: {name}" for name in sorted(EMOJI.keys()) if "\u200d" not in name),
         column_first=True,
     )
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/file_proxy.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/file_proxy.py
index 4b0b0da..e32523b 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/file_proxy.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/file_proxy.py
@@ -55,3 +55,6 @@ class FileProxy(io.TextIOBase):
 
     def fileno(self) -> int:
         return self.__file.fileno()
+
+    def isatty(self) -> bool:
+        return self.__file.isatty()
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/highlighter.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/highlighter.py
index e4c462e..df28048 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/highlighter.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/highlighter.py
@@ -1,6 +1,6 @@
 import re
 from abc import ABC, abstractmethod
-from typing import List, Union
+from typing import ClassVar, Sequence, Union
 
 from .text import Span, Text
 
@@ -61,8 +61,8 @@ class NullHighlighter(Highlighter):
 class RegexHighlighter(Highlighter):
     """Applies highlighting from a list of regular expressions."""
 
-    highlights: List[str] = []
-    base_style: str = ""
+    highlights: ClassVar[Sequence[str]] = []
+    base_style: ClassVar[str] = ""
 
     def highlight(self, text: Text) -> None:
         """Highlight :class:`rich.text.Text` using regular expressions.
@@ -81,7 +81,7 @@ class ReprHighlighter(RegexHighlighter):
     """Highlights the text typically produced from ``__repr__`` methods."""
 
     base_style = "repr."
-    highlights = [
+    highlights: ClassVar[Sequence[str]] = [
         r"(?P<)(?P[-\w.:|]*)(?P[\w\W]*)(?P>)",
         r'(?P[\w_]{1,50})=(?P"?[\w_]+"?)?',
         r"(?P[][{}()])",
@@ -110,8 +110,8 @@ class JSONHighlighter(RegexHighlighter):
     JSON_STR = r"(?b?\".*?(?[\{\[\(\)\]\}])",
             r"\b(?Ptrue)\b|\b(?Pfalse)\b|\b(?Pnull)\b",
@@ -145,8 +145,8 @@ class ISO8601Highlighter(RegexHighlighter):
     Regex reference: https://www.oreilly.com/library/view/regular-expressions-cookbook/9781449327453/ch04s07.html
     """
 
-    base_style = "iso8601."
-    highlights = [
+    base_style: ClassVar[str] = "iso8601."
+    highlights: ClassVar[Sequence[str]] = [
         #
         # Dates
         #
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live.py
index cc3a39b..2fd893b 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live.py
@@ -166,7 +166,11 @@ class Live(JupyterMixin, RenderHook):
                 finally:
                     self._disable_redirect_io()
                     self.console.pop_render_hook()
-                    if not self._alt_screen and self.console.is_terminal:
+                    if (
+                        not self._alt_screen
+                        and self.console.is_terminal
+                        and self._live_render.last_render_height
+                    ):
                         self.console.line()
                     self.console.show_cursor(True)
                     if self._alt_screen:
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live_render.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live_render.py
index d3da511..e7ec970 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live_render.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/live_render.py
@@ -1,5 +1,4 @@
-from typing import Optional, Tuple, Literal
-
+from typing import Literal, Optional, Tuple
 
 from ._loop import loop_last
 from .console import Console, ConsoleOptions, RenderableType, RenderResult
@@ -30,6 +29,17 @@ class LiveRender:
         self.vertical_overflow = vertical_overflow
         self._shape: Optional[Tuple[int, int]] = None
 
+    @property
+    def last_render_height(self) -> int:
+        """The number of lines in the last render (may be 0 if nothing was rendered).
+
+        Returns:
+            Height in lines
+        """
+        if self._shape is None:
+            return 0
+        return self._shape[1]
+
     def set_renderable(self, renderable: RenderableType) -> None:
         """Set a new renderable.
 
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/logging.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/logging.py
index 08f34c7..7b776f3 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/logging.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/logging.py
@@ -1,18 +1,24 @@
+from __future__ import annotations
+
 import logging
+import os
 from datetime import datetime
 from logging import Handler, LogRecord
-from pathlib import Path
 from types import ModuleType
-from typing import ClassVar, Iterable, List, Optional, Type, Union
+from typing import TYPE_CHECKING, ClassVar, Iterable, List, Optional, Type, Union
+
+if TYPE_CHECKING:
+    from ._log_render import FormatTimeCallable
+    from .console import Console, ConsoleRenderable
+    from .highlighter import Highlighter
+    from .traceback import Traceback
 
 from pip._vendor.rich._null_file import NullFile
 
 from . import get_console
-from ._log_render import FormatTimeCallable, LogRender
-from .console import Console, ConsoleRenderable
-from .highlighter import Highlighter, ReprHighlighter
+from ._log_render import LogRender
+from .highlighter import ReprHighlighter
 from .text import Text
-from .traceback import Traceback
 
 
 class RichHandler(Handler):
@@ -141,6 +147,8 @@ class RichHandler(Handler):
             exc_type, exc_value, exc_traceback = record.exc_info
             assert exc_type is not None
             assert exc_value is not None
+            from .traceback import Traceback
+
             traceback = Traceback.from_exception(
                 exc_type,
                 exc_value,
@@ -179,7 +187,7 @@ class RichHandler(Handler):
             except Exception:
                 self.handleError(record)
 
-    def render_message(self, record: LogRecord, message: str) -> "ConsoleRenderable":
+    def render_message(self, record: LogRecord, message: str) -> ConsoleRenderable:
         """Render message text in to Text.
 
         Args:
@@ -209,8 +217,8 @@ class RichHandler(Handler):
         *,
         record: LogRecord,
         traceback: Optional[Traceback],
-        message_renderable: "ConsoleRenderable",
-    ) -> "ConsoleRenderable":
+        message_renderable: ConsoleRenderable,
+    ) -> ConsoleRenderable:
         """Render log for display.
 
         Args:
@@ -221,7 +229,7 @@ class RichHandler(Handler):
         Returns:
             ConsoleRenderable: Renderable to display log.
         """
-        path = Path(record.pathname).name
+        path = os.path.basename(record.pathname)
         level = self.get_level_text(record)
         time_format = None if self.formatter is None else self.formatter.datefmt
         log_time = datetime.fromtimestamp(record.created)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/pretty.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/pretty.py
index c4a274f..f0f1e32 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/pretty.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/pretty.py
@@ -234,7 +234,7 @@ def install(
                 if self.pprint:
                     return _ipy_display_hook(
                         value,
-                        console=get_console(),
+                        console=console,
                         overflow=overflow,
                         indent_guides=indent_guides,
                         max_length=max_length,
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/progress.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/progress.py
index ef6ad60..c2de125 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/progress.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/progress.py
@@ -1064,7 +1064,7 @@ class Progress(JupyterMixin):
     Args:
         console (Console, optional): Optional Console instance. Defaults to an internal Console instance writing to stdout.
         auto_refresh (bool, optional): Enable auto refresh. If disabled, you will need to call `refresh()`.
-        refresh_per_second (Optional[float], optional): Number of times per second to refresh the progress information or None to use default (10). Defaults to None.
+        refresh_per_second (float, optional): Number of times per second to refresh the progress information. Defaults to 10.
         speed_estimate_period: (float, optional): Period (in seconds) used to calculate the speed estimate. Defaults to 30.
         transient: (bool, optional): Clear the progress on exit. Defaults to False.
         redirect_stdout: (bool, optional): Enable redirection of stdout, so ``print`` may be used. Defaults to True.
@@ -1172,9 +1172,10 @@ class Progress(JupyterMixin):
 
     def stop(self) -> None:
         """Stop the progress display."""
-        self.live.stop()
-        if not self.console.is_interactive and not self.console.is_jupyter:
-            self.console.print()
+        if not self.disable:
+            self.live.stop()
+            if not self.console.is_interactive and not self.console.is_jupyter:
+                self.console.print()
 
     def __enter__(self) -> Self:
         self.start()
@@ -1492,7 +1493,7 @@ class Progress(JupyterMixin):
             start (bool, optional): Start the task after reset. Defaults to True.
             total (float, optional): New total steps in task, or None to use current total. Defaults to None.
             completed (int, optional): Number of steps completed. Defaults to 0.
-            visible (bool, optional): Enable display of the task. Defaults to True.
+            visible (bool, optional): Set visible flag if not None.
             description (str, optional): Change task description if not None. Defaults to None.
             **fields (str): Additional data fields required for rendering.
         """
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/prompt.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/prompt.py
index fccb70d..025f1d5 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/prompt.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/prompt.py
@@ -262,7 +262,7 @@ class PromptBase(Generic[PromptType]):
             value (str): String entered by user.
             error (InvalidResponse): Exception instance the initiated the error.
         """
-        self.console.print(error)
+        self.console.print(error, markup=True)
 
     def pre_prompt(self) -> None:
         """Hook to display something before the prompt."""
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/protocol.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/protocol.py
index 12ab237..e881518 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/protocol.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/protocol.py
@@ -1,5 +1,4 @@
 from typing import Any, cast, Set, TYPE_CHECKING
-from inspect import isclass
 
 if TYPE_CHECKING:
     from pip._vendor.rich.console import RenderableType
@@ -28,7 +27,7 @@ def rich_cast(renderable: object) -> "RenderableType":
     from pip._vendor.rich.console import RenderableType
 
     rich_visited_set: Set[type] = set()  # Prevent potential infinite loop
-    while hasattr(renderable, "__rich__") and not isclass(renderable):
+    while hasattr(renderable, "__rich__") and not isinstance(renderable, type):
         # Detect object which claim to have all the attributes
         if hasattr(renderable, _GIBBERISH):
             return repr(renderable)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/repr.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/repr.py
index 10efc42..3b33f26 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/repr.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/repr.py
@@ -1,4 +1,3 @@
-import inspect
 from functools import partial
 from typing import (
     Any,
@@ -68,6 +67,8 @@ def auto(
         def auto_rich_repr(self: Type[T]) -> Result:
             """Auto generate __rich_rep__ from signature of __init__"""
             try:
+                import inspect
+
                 signature = inspect.signature(self.__init__)
                 for name, param in signature.parameters.items():
                     if param.kind == param.POSITIONAL_ONLY:
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/scope.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/scope.py
index c9d134c..0d7eb02 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/scope.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/scope.py
@@ -8,7 +8,7 @@ from .table import Table
 from .text import Text, TextType
 
 if TYPE_CHECKING:
-    from .console import ConsoleRenderable
+    from .console import ConsoleRenderable, OverflowMethod
 
 
 def render_scope(
@@ -19,6 +19,8 @@ def render_scope(
     indent_guides: bool = False,
     max_length: Optional[int] = None,
     max_string: Optional[int] = None,
+    max_depth: Optional[int] = None,
+    overflow: Optional["OverflowMethod"] = None,
 ) -> "ConsoleRenderable":
     """Render python variables in a given scope.
 
@@ -30,6 +32,8 @@ def render_scope(
         max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
             Defaults to None.
         max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depths of locals before truncating, or None to disable. Defaults to None.
+        overflow (OverflowMethod, optional): How to handle overflowing locals, or None to disable. Defaults to None.
 
     Returns:
         ConsoleRenderable: A renderable object.
@@ -57,6 +61,8 @@ def render_scope(
                 indent_guides=indent_guides,
                 max_length=max_length,
                 max_string=max_string,
+                max_depth=max_depth,
+                overflow=overflow,
             ),
         )
     return Panel.fit(
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/segment.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/segment.py
index 4b5f997..92909bb 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/segment.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/segment.py
@@ -1,7 +1,6 @@
 from enum import IntEnum
 from functools import lru_cache
 from itertools import filterfalse
-from logging import getLogger
 from operator import attrgetter
 from typing import (
     TYPE_CHECKING,
@@ -29,8 +28,6 @@ from .style import Style
 if TYPE_CHECKING:
     from .console import Console, ConsoleOptions, RenderResult
 
-log = getLogger("rich")
-
 
 class ControlType(IntEnum):
     """Non-printable control codes which typically translate to ANSI codes."""
@@ -275,6 +272,37 @@ class Segment(NamedTuple):
         if line:
             yield line
 
+    @classmethod
+    def split_lines_terminator(
+        cls, segments: Iterable["Segment"]
+    ) -> Iterable[Tuple[List["Segment"], bool]]:
+        """Split a sequence of segments in to a list of lines and a boolean to indicate if there was a new line.
+
+        Args:
+            segments (Iterable[Segment]): Segments potentially containing line feeds.
+
+        Yields:
+            Iterable[List[Segment]]: Iterable of segment lists, one per line.
+        """
+        line: List[Segment] = []
+        append = line.append
+
+        for segment in segments:
+            if "\n" in segment.text and not segment.control:
+                text, style, _ = segment
+                while text:
+                    _text, new_line, text = text.partition("\n")
+                    if _text:
+                        append(cls(_text, style))
+                    if new_line:
+                        yield (line, True)
+                        line = []
+                        append = line.append
+            else:
+                append(segment)
+        if line:
+            yield (line, False)
+
     @classmethod
     def split_and_crop_lines(
         cls,
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/style.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/style.py
index 5294241..3806a8c 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/style.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/style.py
@@ -1,8 +1,9 @@
 import sys
 from functools import lru_cache
+from itertools import count
 from operator import attrgetter
 from pickle import dumps, loads
-from random import randint
+from random import getrandbits
 from typing import Any, Dict, Iterable, List, Optional, Type, Union, cast
 
 from . import errors
@@ -18,6 +19,9 @@ _hash_getter = attrgetter(
 StyleType = Union[str, "Style"]
 
 
+_id_generator = count(getrandbits(24))
+
+
 class _Bit:
     """A descriptor to get/set a style attribute bit."""
 
@@ -195,7 +199,7 @@ class Style:
         self._link = link
         self._meta = None if meta is None else dumps(meta)
         self._link_id = (
-            f"{randint(0, 999999)}{hash(self._meta)}" if (link or meta) else ""
+            f"{next(_id_generator)}{hash(self._meta)}" if (link or meta) else ""
         )
         self._hash: Optional[int] = None
         self._null = not (self._set_attributes or color or bgcolor or link or meta)
@@ -245,7 +249,7 @@ class Style:
         style._attributes = 0
         style._link = None
         style._meta = dumps(meta)
-        style._link_id = f"{randint(0, 999999)}{hash(style._meta)}"
+        style._link_id = f"{next(_id_generator)}{hash(style._meta)}"
         style._hash = None
         style._null = not (meta)
         return style
@@ -483,7 +487,7 @@ class Style:
         style._attributes = self._attributes
         style._set_attributes = self._set_attributes
         style._link = self._link
-        style._link_id = f"{randint(0, 999999)}" if self._link else ""
+        style._link_id = f"{next(_id_generator)}" if self._link else ""
         style._null = False
         style._meta = None
         style._hash = None
@@ -635,7 +639,7 @@ class Style:
         style._attributes = self._attributes
         style._set_attributes = self._set_attributes
         style._link = self._link
-        style._link_id = f"{randint(0, 999999)}" if self._link else ""
+        style._link_id = f"{next(_id_generator)}" if self._link else ""
         style._hash = self._hash
         style._null = False
         style._meta = self._meta
@@ -681,7 +685,7 @@ class Style:
         style._attributes = self._attributes
         style._set_attributes = self._set_attributes
         style._link = link
-        style._link_id = f"{randint(0, 999999)}" if link else ""
+        style._link_id = f"{next(_id_generator)}" if link else ""
         style._hash = None
         style._null = False
         style._meta = self._meta
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/syntax.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/syntax.py
index ec0d903..b305384 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/syntax.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/syntax.py
@@ -7,6 +7,7 @@ import textwrap
 from abc import ABC, abstractmethod
 from pathlib import Path
 from typing import (
+    TYPE_CHECKING,
     Any,
     Dict,
     Iterable,
@@ -38,13 +39,15 @@ from pip._vendor.pygments.token import (
 )
 from pip._vendor.pygments.util import ClassNotFound
 
+if TYPE_CHECKING:
+    from .console import Console, ConsoleOptions, JustifyMethod, RenderResult
+
 from pip._vendor.rich.containers import Lines
 from pip._vendor.rich.padding import Padding, PaddingDimensions
 
 from ._loop import loop_first
 from .cells import cell_len
 from .color import Color, blend_rgb
-from .console import Console, ConsoleOptions, JustifyMethod, RenderResult
 from .jupyter import JupyterMixin
 from .measure import Measurement
 from .segment import Segment, Segments
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/table.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/table.py
index 2b9e3b5..caff940 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/table.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/table.py
@@ -49,7 +49,6 @@ class Column:
         padding (PaddingDimensions, optional): Padding for cells (top, right, bottom, left). Defaults to (0, 1).
         collapse_padding (bool, optional): Enable collapsing of padding around cells. Defaults to False.
         pad_edge (bool, optional): Enable padding of edge cells. Defaults to True.
-        expand (bool, optional): Expand the table to fit the available space if ``True``, otherwise the table width will be auto-calculated. Defaults to False.
         show_header (bool, optional): Show a header row. Defaults to True.
         show_footer (bool, optional): Show a footer row. Defaults to False.
         show_edge (bool, optional): Draw a box around the outside of the table. Defaults to True.
@@ -485,6 +484,7 @@ class Table(JupyterMixin):
             max_width = self.width
 
         extra_width = self._extra_width
+
         widths = self._calculate_column_widths(
             console, options.update_width(max_width - extra_width)
         )
@@ -530,6 +530,7 @@ class Table(JupyterMixin):
             self._measure_column(console, options, column) for column in columns
         ]
         widths = [_range.maximum or 1 for _range in width_ranges]
+
         get_padding_width = self._get_padding_width
         extra_width = self._extra_width
         if self.expand:
@@ -699,9 +700,17 @@ class Table(JupyterMixin):
     def _get_padding_width(self, column_index: int) -> int:
         """Get extra width from padding."""
         _, pad_right, _, pad_left = self.padding
+
         if self.collapse_padding:
-            if column_index > 0:
-                pad_left = max(0, pad_left - pad_right)
+            pad_left = 0
+            pad_right = abs(pad_left - pad_right)
+
+        if not self.pad_edge:
+            if column_index == 0:
+                pad_left = 0
+            if column_index == len(self.columns) - 1:
+                pad_right = 0
+
         return pad_left + pad_right
 
     def _measure_column(
@@ -717,7 +726,6 @@ class Table(JupyterMixin):
             return Measurement(0, 0)
 
         padding_width = self._get_padding_width(column._index)
-
         if column.width is not None:
             # Fixed width column
             return Measurement(
@@ -754,6 +762,7 @@ class Table(JupyterMixin):
             self._get_cells(console, column_index, column)
             for column_index, column in enumerate(self.columns)
         )
+
         row_cells: List[Tuple[_Cell, ...]] = list(zip(*_column_cells))
         _box = (
             self.box.substitute(
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/text.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/text.py
index 5a0c6b1..1ca54c3 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/text.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/text.py
@@ -691,7 +691,6 @@ class Text(JupyterMixin):
     ) -> Iterable[Segment]:
         tab_size: int = console.tab_size if self.tab_size is None else self.tab_size
         justify = self.justify or options.justify or DEFAULT_JUSTIFY
-
         overflow = self.overflow or options.overflow or DEFAULT_OVERFLOW
 
         lines = self.wrap(
@@ -1007,7 +1006,7 @@ class Text(JupyterMixin):
         return self
 
     def append_text(self, text: "Text") -> "Text":
-        """Append another Text instance. This method is more performant that Text.append, but
+        """Append another Text instance. This method is more performant than Text.append, but
         only works for Text.
 
         Args:
@@ -1105,7 +1104,7 @@ class Text(JupyterMixin):
         return lines
 
     def divide(self, offsets: Iterable[int]) -> Lines:
-        """Divide text in to a number of lines at given offsets.
+        """Divide text into a number of lines at given offsets.
 
         Args:
             offsets (Iterable[int]): Offsets used to divide text.
@@ -1232,12 +1231,15 @@ class Text(JupyterMixin):
             if "\t" in line:
                 line.expand_tabs(tab_size)
             if no_wrap:
+                if overflow == "ignore":
+                    lines.append(line)
+                    continue
                 new_lines = Lines([line])
             else:
                 offsets = divide_line(str(line), width, fold=wrap_overflow == "fold")
                 new_lines = line.divide(offsets)
-            for line in new_lines:
-                line.rstrip_end(width)
+                for line in new_lines:
+                    line.rstrip_end(width)
             if wrap_justify:
                 new_lines.justify(
                     console, width, justify=wrap_justify, overflow=wrap_overflow
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/theme.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/theme.py
index 227f1d8..6b3c8c0 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/theme.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/theme.py
@@ -1,4 +1,3 @@
-import configparser
 from typing import IO, Dict, List, Mapping, Optional
 
 from .default_styles import DEFAULT_STYLES
@@ -49,6 +48,8 @@ class Theme:
         Returns:
             Theme: A New theme instance.
         """
+        import configparser
+
         config = configparser.ConfigParser()
         config.read_file(config_file, source=source)
         styles = {name: Style.parse(value) for name, value in config.items("styles")}
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/traceback.py b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/traceback.py
index 01b2f50..8f254c2 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/rich/traceback.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/rich/traceback.py
@@ -33,6 +33,7 @@ from .console import (
     Console,
     ConsoleOptions,
     ConsoleRenderable,
+    OverflowMethod,
     Group,
     RenderResult,
     group,
@@ -91,8 +92,10 @@ def install(
     show_locals: bool = False,
     locals_max_length: int = LOCALS_MAX_LENGTH,
     locals_max_string: int = LOCALS_MAX_STRING,
+    locals_max_depth: Optional[int] = None,
     locals_hide_dunder: bool = True,
     locals_hide_sunder: Optional[bool] = None,
+    locals_overflow: Optional[OverflowMethod] = None,
     indent_guides: bool = True,
     suppress: Iterable[Union[str, ModuleType]] = (),
     max_frames: int = 100,
@@ -114,8 +117,10 @@ def install(
         locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
             Defaults to 10.
         locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_max_depth (int, optional): Maximum depths of locals before truncating, or None to disable. Defaults to None.
         locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
         locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+        locals_overflow (OverflowMethod, optional): How to handle overflowing locals, or None to disable. Defaults to None.
         indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
         suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
 
@@ -148,8 +153,10 @@ def install(
             show_locals=show_locals,
             locals_max_length=locals_max_length,
             locals_max_string=locals_max_string,
+            locals_max_depth=locals_max_depth,
             locals_hide_dunder=locals_hide_dunder,
             locals_hide_sunder=bool(locals_hide_sunder),
+            locals_overflow=locals_overflow,
             indent_guides=indent_guides,
             suppress=suppress,
             max_frames=max_frames,
@@ -268,8 +275,10 @@ class Traceback:
         locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
             Defaults to 10.
         locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_max_depth (int, optional): Maximum depths of locals before truncating, or None to disable. Defaults to None.
         locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
         locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+        locals_overflow (OverflowMethod, optional): How to handle overflowing locals, or None to disable. Defaults to None.
         suppress (Sequence[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
         max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
 
@@ -295,8 +304,10 @@ class Traceback:
         show_locals: bool = False,
         locals_max_length: int = LOCALS_MAX_LENGTH,
         locals_max_string: int = LOCALS_MAX_STRING,
+        locals_max_depth: Optional[int] = None,
         locals_hide_dunder: bool = True,
         locals_hide_sunder: bool = False,
+        locals_overlow: Optional[OverflowMethod] = None,
         indent_guides: bool = True,
         suppress: Iterable[Union[str, ModuleType]] = (),
         max_frames: int = 100,
@@ -320,8 +331,10 @@ class Traceback:
         self.indent_guides = indent_guides
         self.locals_max_length = locals_max_length
         self.locals_max_string = locals_max_string
+        self.locals_max_depth = locals_max_depth
         self.locals_hide_dunder = locals_hide_dunder
         self.locals_hide_sunder = locals_hide_sunder
+        self.locals_overflow = locals_overlow
 
         self.suppress: Sequence[str] = []
         for suppress_entity in suppress:
@@ -351,8 +364,10 @@ class Traceback:
         show_locals: bool = False,
         locals_max_length: int = LOCALS_MAX_LENGTH,
         locals_max_string: int = LOCALS_MAX_STRING,
+        locals_max_depth: Optional[int] = None,
         locals_hide_dunder: bool = True,
         locals_hide_sunder: bool = False,
+        locals_overflow: Optional[OverflowMethod] = None,
         indent_guides: bool = True,
         suppress: Iterable[Union[str, ModuleType]] = (),
         max_frames: int = 100,
@@ -372,9 +387,11 @@ class Traceback:
             indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
             locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
                 Defaults to 10.
+            locals_max_depth (int, optional): Maximum depths of locals before truncating, or None to disable. Defaults to None.
             locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
             locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
             locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
+            locals_overflow (OverflowMethod, optional): How to handle overflowing locals, or None to disable. Defaults to None.
             suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback.
             max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
 
@@ -388,6 +405,7 @@ class Traceback:
             show_locals=show_locals,
             locals_max_length=locals_max_length,
             locals_max_string=locals_max_string,
+            locals_max_depth=locals_max_depth,
             locals_hide_dunder=locals_hide_dunder,
             locals_hide_sunder=locals_hide_sunder,
         )
@@ -403,8 +421,10 @@ class Traceback:
             indent_guides=indent_guides,
             locals_max_length=locals_max_length,
             locals_max_string=locals_max_string,
+            locals_max_depth=locals_max_depth,
             locals_hide_dunder=locals_hide_dunder,
             locals_hide_sunder=locals_hide_sunder,
+            locals_overlow=locals_overflow,
             suppress=suppress,
             max_frames=max_frames,
         )
@@ -419,6 +439,7 @@ class Traceback:
         show_locals: bool = False,
         locals_max_length: int = LOCALS_MAX_LENGTH,
         locals_max_string: int = LOCALS_MAX_STRING,
+        locals_max_depth: Optional[int] = None,
         locals_hide_dunder: bool = True,
         locals_hide_sunder: bool = False,
         _visited_exceptions: Optional[Set[BaseException]] = None,
@@ -433,6 +454,7 @@ class Traceback:
             locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
                 Defaults to 10.
             locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+            locals_max_depth (int, optional): Maximum depths of locals before truncating, or None to disable. Defaults to None.
             locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
             locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
 
@@ -560,6 +582,7 @@ class Traceback:
                                 value,
                                 max_length=locals_max_length,
                                 max_string=locals_max_string,
+                                max_depth=locals_max_depth,
                             )
                             for key, value in get_locals(frame_summary.f_locals.items())
                             if not (inspect.isfunction(value) or inspect.isclass(value))
@@ -754,6 +777,8 @@ class Traceback:
                     indent_guides=self.indent_guides,
                     max_length=self.locals_max_length,
                     max_string=self.locals_max_string,
+                    max_depth=self.locals_max_depth,
+                    overflow=self.locals_overflow,
                 )
 
         exclude_frames: Optional[range] = None
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/__init__.py
index 9395b04..21bacf9 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/__init__.py
@@ -3,6 +3,6 @@
 # Licensed to PSF under a Contributor Agreement.
 
 __all__ = ("loads", "load", "TOMLDecodeError")
-__version__ = "2.3.0"  # DO NOT EDIT THIS LINE MANUALLY. LET bump2version UTILITY DO IT
+__version__ = "2.3.2"  # DO NOT EDIT THIS LINE MANUALLY. LET bump2version UTILITY DO IT
 
 from ._parser import TOMLDecodeError, load, loads
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/_parser.py b/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/_parser.py
index 26170e8..97c167a 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/_parser.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/tomli/_parser.py
@@ -4,8 +4,11 @@
 
 from __future__ import annotations
 
+# Defer loading regular expressions until we actually need them in
+# parse_value().
+__lazy_modules__ = ["tomli._re", "tomllib._re"]
+
 import sys
-from types import MappingProxyType
 
 from ._re import (
     RE_DATETIME,
@@ -16,6 +19,9 @@ from ._re import (
     match_to_number,
 )
 
+if sys.version_info < (3, 15):  # pragma: no cover
+    from types import MappingProxyType as frozendict
+
 TYPE_CHECKING = False
 if TYPE_CHECKING:
     from collections.abc import Iterable
@@ -29,10 +35,19 @@ if TYPE_CHECKING:
 # mypyc docs this will be fixed in the future:
 # https://mypyc.readthedocs.io/en/latest/differences_from_python.html#stack-overflows
 # Before mypyc's fix is in, recursion needs to be limited by this library.
-# Choosing `sys.getrecursionlimit()` as maximum inline table/array nesting
-# level, as it allows more nesting than pure Python, but still seems a far
-# lower number than where mypyc binaries crash.
-MAX_INLINE_NESTING: Final = sys.getrecursionlimit()
+# Choosing 400 as maximum inline table/array nesting level, as it's 4x the
+# spec recommended minimum (https://github.com/toml-lang/toml/pull/1087)
+# (unreleased at the time of writing) and less than half of what causes an
+# unrecoverable crash in a worker (not main) thread on a python:3.13-alpine
+# image.
+MAX_INLINE_NESTING: Final = 400
+
+# Pathologically excessive number of parts in a key runs into quadratic
+# behavior (e.g. in Flags.is_).
+# Even if keys aren't currently parsed using recursion, they name a
+# recursive structure, so it makes sense to limit it using getrecursionlimit()
+# and RecursionError.
+MAX_KEY_PARTS: Final = sys.getrecursionlimit()
 
 ASCII_CTRL: Final = frozenset(chr(i) for i in range(32)) | frozenset(chr(127))
 
@@ -54,7 +69,7 @@ BARE_KEY_CHARS: Final = frozenset(
 KEY_INITIAL_CHARS: Final = BARE_KEY_CHARS | frozenset("\"'")
 HEXDIGIT_CHARS: Final = frozenset("abcdef" "ABCDEF" "0123456789")
 
-BASIC_STR_ESCAPE_REPLACEMENTS: Final = MappingProxyType(
+BASIC_STR_ESCAPE_REPLACEMENTS: Final = frozendict(
     {
         "\\b": "\u0008",  # backspace
         "\\t": "\u0009",  # tab
@@ -145,7 +160,7 @@ def load(__fp: IO[bytes], *, parse_float: ParseFloat = float) -> dict[str, Any]:
     return loads(s, parse_float=parse_float)
 
 
-def loads(__s: str, *, parse_float: ParseFloat = float) -> dict[str, Any]:  # noqa: C901
+def loads(__s: str, *, parse_float: ParseFloat = float) -> dict[str, Any]:
     """Parse TOML from a string."""
 
     # The spec allows converting "\r\n" to "\n", even in string
@@ -474,6 +489,10 @@ def parse_key(src: str, pos: Pos) -> tuple[Pos, Key]:
         pos = skip_chars(src, pos, TOML_WS)
         pos, key_part = parse_key_part(src, pos)
         key += (key_part,)
+        if len(key) > MAX_KEY_PARTS:
+            raise RecursionError(
+                f"TOML key has more than the allowed {MAX_KEY_PARTS} parts"
+            )
         pos = skip_chars(src, pos, TOML_WS)
 
 
@@ -676,7 +695,7 @@ def parse_basic_str(src: str, pos: Pos, *, multiline: bool) -> tuple[Pos, str]:
         pos += 1
 
 
-def parse_value(  # noqa: C901
+def parse_value(
     src: str, pos: Pos, parse_float: ParseFloat, nest_lvl: int
 ) -> tuple[Pos, Any]:
     if nest_lvl > MAX_INLINE_NESTING:
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/__init__.py
index 0166459..2358903 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/__init__.py
@@ -2,7 +2,7 @@
 
 import sys as _sys
 
-if _sys.version_info < (3, 10):
+if _sys.version_info < (3, 10):  # noqa: UP036
     raise ImportError("truststore requires Python 3.10 or later")
 
 # Detect Python runtimes which don't implement SSLObject.get_unverified_chain() API
@@ -26,11 +26,11 @@ if _sys.version_info < (3, 13) and _sys.implementation.name not in ("cpython", "
                 "truststore requires peer certificate chain APIs to be available"
             ) from None
 
-        del _ssl, _sslobj, _sslmem  # noqa: F821
+        del _ssl, _sslobj, _sslmem
 
-from ._api import SSLContext, extract_from_ssl, inject_into_ssl  # noqa: E402
+from ._api import SSLContext, extract_from_ssl, inject_into_ssl
 
 del _api, _sys  # type: ignore[name-defined] # noqa: F821
 
 __all__ = ["SSLContext", "inject_into_ssl", "extract_from_ssl"]
-__version__ = "0.10.4"
+__version__ = "0.10.5"
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_api.py b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_api.py
index a54ff9f..7f6fead 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_api.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_api.py
@@ -1,4 +1,4 @@
-import contextlib
+import _ssl
 import os
 import platform
 import socket
@@ -7,8 +7,6 @@ import sys
 import threading
 import typing
 
-import _ssl
-
 from ._ssl_constants import (
     _original_SSLContext,
     _original_super_SSLContext,
@@ -86,7 +84,9 @@ class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
 
     def __init__(self, protocol: int = None) -> None:  # type: ignore[assignment]
         self._ctx = _original_SSLContext(protocol)
-        self._ctx_lock = threading.Lock()
+        self._ctx_lock = threading.RLock()
+
+        ctx_lock = self._ctx_lock  # Reference used by sslobject/sslsocket classes.
 
         class TruststoreSSLObject(ssl.SSLObject):
             # This object exists because wrap_bio() doesn't
@@ -94,10 +94,27 @@ class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
             # certificate verifications after SSLObject.do_handshake()
 
             def do_handshake(self) -> None:
-                ret = super().do_handshake()
-                _verify_peercerts(self, server_hostname=self.server_hostname)
+                with ctx_lock:
+                    ret = super().do_handshake()
+                    _verify_peercerts(self, server_hostname=self.server_hostname)
+                    return ret
+
+        class TruststoreSSLSocket(ssl.SSLSocket):
+            # Handles do_handshake_on_connect=False, explicit do_handshake()
+            # calls, and the handshake that SSLSocket.connect() triggers.
+            # Must never be called inside _configure_context(). wrap_socket()
+            # guarantees this by always wrapping with do_handshake_on_connect=False.
+            def do_handshake(self, block: bool = False) -> None:
+                with ctx_lock:
+                    ret = super().do_handshake(block)
+                    try:
+                        _verify_peercerts(self, server_hostname=self.server_hostname)
+                    except Exception:
+                        self.close()
+                        raise
                 return ret
 
+        self._ctx.sslsocket_class = TruststoreSSLSocket
         self._ctx.sslobject_class = TruststoreSSLObject
 
     def wrap_socket(
@@ -109,28 +126,33 @@ class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
         server_hostname: str | None = None,
         session: ssl.SSLSession | None = None,
     ) -> ssl.SSLSocket:
+        if self.check_hostname and not server_hostname:
+            raise ValueError("check_hostname requires server_hostname")
 
-        # We need to lock around the .__enter__()
-        # but we don't need to lock within the
-        # context manager, so we need to expand the
-        # syntactic sugar of the `with` statement.
-        with contextlib.ExitStack() as stack:
-            with self._ctx_lock:
-                stack.enter_context(_configure_context(self._ctx))
+        with self._ctx_lock:
+            with _configure_context(self._ctx):
+                ssl_sock = self._ctx.wrap_socket(
+                    sock,
+                    server_side=server_side,
+                    server_hostname=server_hostname,
+                    do_handshake_on_connect=do_handshake_on_connect,
+                    suppress_ragged_eofs=suppress_ragged_eofs,
+                    session=session,
+                )
+
+            # NOTE: Below is still inside ctx_lock but not
+            # inside the _configure_context().
+
+            # Indicates that a handshake completed and
+            # we can verify now, otherwise verification
+            # will happen in TruststoreSSLSocket.do_handshake()
+            if ssl_sock.version() is not None:
+                try:
+                    _verify_peercerts(ssl_sock, server_hostname=server_hostname)
+                except Exception:
+                    ssl_sock.close()
+                    raise
 
-            ssl_sock = self._ctx.wrap_socket(
-                sock,
-                server_side=server_side,
-                server_hostname=server_hostname,
-                do_handshake_on_connect=do_handshake_on_connect,
-                suppress_ragged_eofs=suppress_ragged_eofs,
-                session=session,
-            )
-        try:
-            _verify_peercerts(ssl_sock, server_hostname=server_hostname)
-        except Exception:
-            ssl_sock.close()
-            raise
         return ssl_sock
 
     def wrap_bio(
@@ -141,7 +163,14 @@ class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
         server_hostname: str | None = None,
         session: ssl.SSLSession | None = None,
     ) -> ssl.SSLObject:
-        with _configure_context(self._ctx):
+        if self.check_hostname and not server_hostname:
+            raise ValueError("check_hostname requires server_hostname")
+
+        # We need to lock around the .__enter__()
+        # but we don't need to lock within the
+        # context manager, so we need to expand the
+        # syntactic sugar of the `with` statement.
+        with self._ctx_lock, _configure_context(self._ctx):
             ssl_obj = self._ctx.wrap_bio(
                 incoming,
                 outgoing,
@@ -213,11 +242,13 @@ class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
 
     @property
     def check_hostname(self) -> bool:
-        return self._ctx.check_hostname
+        with self._ctx_lock:
+            return self._ctx.check_hostname
 
     @check_hostname.setter
     def check_hostname(self, value: bool) -> None:
-        self._ctx.check_hostname = value
+        with self._ctx_lock:
+            self._ctx.check_hostname = value
 
     @property
     def hostname_checks_common_name(self) -> bool:
@@ -293,13 +324,15 @@ class SSLContext(_truststore_SSLContext_super_class):  # type: ignore[misc]
 
     @property
     def verify_mode(self) -> ssl.VerifyMode:
-        return self._ctx.verify_mode
+        with self._ctx_lock:
+            return self._ctx.verify_mode
 
     @verify_mode.setter
     def verify_mode(self, value: ssl.VerifyMode) -> None:
-        _original_super_SSLContext.verify_mode.__set__(  # type: ignore[attr-defined]
-            self._ctx, value
-        )
+        with self._ctx_lock:
+            _original_super_SSLContext.verify_mode.__set__(  # type: ignore[attr-defined]
+                self._ctx, value
+            )
 
 
 # Python 3.13+ makes get_unverified_chain() a public API that only returns DER
@@ -328,6 +361,9 @@ def _verify_peercerts(
     Verifies the peer certificates from an SSLSocket or SSLObject
     against the certificates in the OS trust store.
     """
+    if sock_or_sslobj.context.check_hostname and not server_hostname:
+        raise ValueError("check_hostname requires server_hostname")
+
     sslobj: ssl.SSLObject = sock_or_sslobj  # type: ignore[assignment]
     try:
         while not hasattr(sslobj, "get_unverified_chain"):
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_openssl.py b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_openssl.py
index 3e25a56..8a595dd 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_openssl.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_openssl.py
@@ -6,9 +6,9 @@ import typing
 
 # candidates based on https://github.com/tiran/certifi-system-store by Christian Heimes
 _CA_FILE_CANDIDATES = [
-    # Alpine, Arch, Fedora 34-42, OpenWRT, RHEL 9-10, BSD
+    # Alpine, Arch, Fedora 34-43, OpenWRT, RHEL 9-10, BSD
     "/etc/ssl/cert.pem",
-    # Fedora 43+, RHEL 11+
+    # Fedora 44+, RHEL 11+
     "/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem",
     # Fedora <= 34, RHEL <= 9, CentOS <= 9
     "/etc/pki/tls/cert.pem",
@@ -52,10 +52,7 @@ def _capath_contains_certs(capath: str) -> bool:
     """Check whether capath exists and contains certs in the expected format."""
     if not os.path.isdir(capath):
         return False
-    for name in os.listdir(capath):
-        if _HASHED_CERT_FILENAME_RE.match(name):
-            return True
-    return False
+    return any(_HASHED_CERT_FILENAME_RE.match(name) for name in os.listdir(capath))
 
 
 def _verify_peercerts_impl(
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_ssl_constants.py b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_ssl_constants.py
index b1ee7a3..f164f62 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_ssl_constants.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_ssl_constants.py
@@ -1,6 +1,5 @@
 import ssl
 import sys
-import typing
 
 # Hold on to the original class so we can create it consistently
 # even if we inject our own SSLContext into the ssl module.
@@ -12,7 +11,7 @@ _original_super_SSLContext = super(_original_SSLContext, _original_SSLContext)
 # subclass the SSLContext.
 
 # This is returned by truststore.SSLContext.__class__()
-_truststore_SSLContext_dunder_class: typing.Optional[type]
+_truststore_SSLContext_dunder_class: type | None
 
 # This value is the superclass of truststore.SSLContext.
 _truststore_SSLContext_super_class: type
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_windows.py b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_windows.py
index a9bf9ab..e048203 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_windows.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/truststore/_windows.py
@@ -1,8 +1,8 @@
-import contextlib
+import contextlib  # noqa: I001
 import ssl
 import typing
-from ctypes import WinDLL  # type: ignore
-from ctypes import WinError  # type: ignore
+from ctypes import WinDLL  # type: ignore[attr-defined]
+from ctypes import WinError  # type: ignore[attr-defined]
 from ctypes import (
     POINTER,
     Structure,
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/LICENSE.txt b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/LICENSE.txt
index 429a176..e6183d0 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/LICENSE.txt
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/LICENSE.txt
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2008-2020 Andrey Petrov and contributors (see CONTRIBUTORS.txt)
+Copyright (c) 2008-2020 Andrey Petrov 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
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/__init__.py
index c6fa382..3fe782c 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/__init__.py
@@ -1,40 +1,49 @@
 """
 Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more
 """
-from __future__ import absolute_import
+
+from __future__ import annotations
 
 # Set default logging handler to avoid "No handler found" warnings.
 import logging
+import sys
+import typing
 import warnings
 from logging import NullHandler
 
 from . import exceptions
+from ._base_connection import _TYPE_BODY
+from ._collections import HTTPHeaderDict
 from ._version import __version__
 from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url
-from .filepost import encode_multipart_formdata
+from .filepost import _TYPE_FIELDS, encode_multipart_formdata
 from .poolmanager import PoolManager, ProxyManager, proxy_from_url
-from .response import HTTPResponse
+from .response import BaseHTTPResponse, HTTPResponse
 from .util.request import make_headers
 from .util.retry import Retry
 from .util.timeout import Timeout
-from .util.url import get_host
 
-# === NOTE TO REPACKAGERS AND VENDORS ===
-# Please delete this block, this logic is only
-# for urllib3 being distributed via PyPI.
-# See: https://github.com/urllib3/urllib3/issues/2680
+# Ensure that Python is compiled with OpenSSL 1.1.1+
+# If the 'ssl' module isn't available at all that's
+# fine, we only care if the module is available.
 try:
-    import urllib3_secure_extra  # type: ignore # noqa: F401
+    import ssl
 except ImportError:
     pass
 else:
-    warnings.warn(
-        "'urllib3[secure]' extra is deprecated and will be removed "
-        "in a future release of urllib3 2.x. Read more in this issue: "
-        "https://github.com/urllib3/urllib3/issues/2680",
-        category=DeprecationWarning,
-        stacklevel=2,
-    )
+    if not ssl.OPENSSL_VERSION.startswith("OpenSSL "):  # Defensive:
+        warnings.warn(
+            "urllib3 v2 only supports OpenSSL 1.1.1+, currently "
+            f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. "
+            "See: https://github.com/urllib3/urllib3/issues/3020",
+            exceptions.NotOpenSSLWarning,
+        )
+    elif ssl.OPENSSL_VERSION_INFO < (1, 1, 1):  # Defensive:
+        raise ImportError(
+            "urllib3 v2 only supports OpenSSL 1.1.1+, currently "
+            f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. "
+            "See: https://github.com/urllib3/urllib3/issues/2168"
+        )
 
 __author__ = "Andrey Petrov (andrey.petrov@shazow.net)"
 __license__ = "MIT"
@@ -42,6 +51,7 @@ __version__ = __version__
 
 __all__ = (
     "HTTPConnectionPool",
+    "HTTPHeaderDict",
     "HTTPSConnectionPool",
     "PoolManager",
     "ProxyManager",
@@ -52,15 +62,18 @@ __all__ = (
     "connection_from_url",
     "disable_warnings",
     "encode_multipart_formdata",
-    "get_host",
     "make_headers",
     "proxy_from_url",
+    "request",
+    "BaseHTTPResponse",
 )
 
 logging.getLogger(__name__).addHandler(NullHandler())
 
 
-def add_stderr_logger(level=logging.DEBUG):
+def add_stderr_logger(
+    level: int = logging.DEBUG,
+) -> logging.StreamHandler[typing.TextIO]:
     """
     Helper for quickly adding a StreamHandler to the logger. Useful for
     debugging.
@@ -87,16 +100,112 @@ del NullHandler
 # mechanisms to silence them.
 # SecurityWarning's always go off by default.
 warnings.simplefilter("always", exceptions.SecurityWarning, append=True)
-# SubjectAltNameWarning's should go off once per host
-warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True)
 # InsecurePlatformWarning's don't vary between requests, so we keep it default.
 warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True)
-# SNIMissingWarnings should go off only once.
-warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True)
 
 
-def disable_warnings(category=exceptions.HTTPWarning):
+def disable_warnings(category: type[Warning] = exceptions.HTTPWarning) -> None:
     """
     Helper for quickly disabling all urllib3 warnings.
     """
     warnings.simplefilter("ignore", category)
+
+
+_DEFAULT_POOL = PoolManager()
+
+
+def request(
+    method: str,
+    url: str,
+    *,
+    body: _TYPE_BODY | None = None,
+    fields: _TYPE_FIELDS | None = None,
+    headers: typing.Mapping[str, str] | None = None,
+    preload_content: bool | None = True,
+    decode_content: bool | None = True,
+    redirect: bool | None = True,
+    retries: Retry | bool | int | None = None,
+    timeout: Timeout | float | int | None = 3,
+    json: typing.Any | None = None,
+) -> BaseHTTPResponse:
+    """
+    A convenience, top-level request method. It uses a module-global ``PoolManager`` instance.
+    Therefore, its side effects could be shared across dependencies relying on it.
+    To avoid side effects create a new ``PoolManager`` instance and use it instead.
+    The method does not accept low-level ``**urlopen_kw`` keyword arguments.
+
+    :param method:
+        HTTP request method (such as GET, POST, PUT, etc.)
+
+    :param url:
+        The URL to perform the request on.
+
+    :param body:
+        Data to send in the request body, either :class:`str`, :class:`bytes`,
+        an iterable of :class:`str`/:class:`bytes`, or a file-like object.
+
+    :param fields:
+        Data to encode and send in the request body.
+
+    :param headers:
+        Dictionary of custom headers to send, such as User-Agent,
+        If-None-Match, etc.
+
+    :param bool preload_content:
+        If True, the response's body will be preloaded into memory.
+
+    :param bool decode_content:
+        If True, will attempt to decode the body based on the
+        'content-encoding' header.
+
+    :param redirect:
+        If True, automatically handle redirects (status codes 301, 302,
+        303, 307, 308). Each redirect counts as a retry. Disabling retries
+        will disable redirect, too.
+
+    :param retries:
+        Configure the number of retries to allow before raising a
+        :class:`~urllib3.exceptions.MaxRetryError` exception.
+
+        If ``None`` (default) will retry 3 times, see ``Retry.DEFAULT``. Pass a
+        :class:`~urllib3.util.retry.Retry` object for fine-grained control
+        over different types of retries.
+        Pass an integer number to retry connection errors that many times,
+        but no other types of errors. Pass zero to never retry.
+
+        If ``False``, then retries are disabled and any exception is raised
+        immediately. Also, instead of raising a MaxRetryError on redirects,
+        the redirect response will be returned.
+
+    :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
+
+    :param timeout:
+        If specified, overrides the default timeout for this one
+        request. It may be a float (in seconds) or an instance of
+        :class:`urllib3.util.Timeout`.
+
+    :param json:
+        Data to encode and send as JSON with UTF-encoded in the request body.
+        The ``"Content-Type"`` header will be set to ``"application/json"``
+        unless specified otherwise.
+    """
+
+    return _DEFAULT_POOL.request(
+        method,
+        url,
+        body=body,
+        fields=fields,
+        headers=headers,
+        preload_content=preload_content,
+        decode_content=decode_content,
+        redirect=redirect,
+        retries=retries,
+        timeout=timeout,
+        json=json,
+    )
+
+
+if sys.platform == "emscripten":
+    from .contrib.emscripten import inject_into_urllib3  # noqa: 401
+
+    inject_into_urllib3()
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_collections.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_collections.py
index bceb845..bc72773 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_collections.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_collections.py
@@ -1,34 +1,66 @@
-from __future__ import absolute_import
-
-try:
-    from collections.abc import Mapping, MutableMapping
-except ImportError:
-    from collections import Mapping, MutableMapping
-try:
-    from threading import RLock
-except ImportError:  # Platform-specific: No threads available
-
-    class RLock:
-        def __enter__(self):
-            pass
-
-        def __exit__(self, exc_type, exc_value, traceback):
-            pass
-
+from __future__ import annotations
 
+import typing
 from collections import OrderedDict
+from enum import Enum, auto
+from threading import RLock
+
+if typing.TYPE_CHECKING:
+    # We can only import Protocol if TYPE_CHECKING because it's a development
+    # dependency, and is not available at runtime.
+    from typing import Protocol
+
+    from typing_extensions import Self
+
+    class HasGettableStringKeys(Protocol):
+        def keys(self) -> typing.Iterator[str]: ...
+
+        def __getitem__(self, key: str) -> str: ...
 
-from .exceptions import InvalidHeader
-from .packages import six
-from .packages.six import iterkeys, itervalues
 
 __all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]
 
 
-_Null = object()
+# Key type
+_KT = typing.TypeVar("_KT")
+# Value type
+_VT = typing.TypeVar("_VT")
+# Default type
+_DT = typing.TypeVar("_DT")
+
+ValidHTTPHeaderSource = typing.Union[
+    "HTTPHeaderDict",
+    typing.Mapping[str, str],
+    typing.Iterable[tuple[str, str]],
+    "HasGettableStringKeys",
+]
 
 
-class RecentlyUsedContainer(MutableMapping):
+class _Sentinel(Enum):
+    not_passed = auto()
+
+
+def ensure_can_construct_http_header_dict(
+    potential: object,
+) -> ValidHTTPHeaderSource | None:
+    if isinstance(potential, HTTPHeaderDict):
+        return potential
+    elif isinstance(potential, typing.Mapping):
+        # Full runtime checking of the contents of a Mapping is expensive, so for the
+        # purposes of typechecking, we assume that any Mapping is the right shape.
+        return typing.cast(typing.Mapping[str, str], potential)
+    elif isinstance(potential, typing.Iterable):
+        # Similarly to Mapping, full runtime checking of the contents of an Iterable is
+        # expensive, so for the purposes of typechecking, we assume that any Iterable
+        # is the right shape.
+        return typing.cast(typing.Iterable[tuple[str, str]], potential)
+    elif hasattr(potential, "keys") and hasattr(potential, "__getitem__"):
+        return typing.cast("HasGettableStringKeys", potential)
+    else:
+        return None
+
+
+class RecentlyUsedContainer(typing.Generic[_KT, _VT], typing.MutableMapping[_KT, _VT]):
     """
     Provides a thread-safe dict-like container which maintains up to
     ``maxsize`` keys while throwing away the least-recently-used keys beyond
@@ -42,69 +74,134 @@ class RecentlyUsedContainer(MutableMapping):
         ``dispose_func(value)`` is called.  Callback which will get called
     """
 
-    ContainerCls = OrderedDict
+    _container: typing.OrderedDict[_KT, _VT]
+    _maxsize: int
+    dispose_func: typing.Callable[[_VT], None] | None
+    lock: RLock
 
-    def __init__(self, maxsize=10, dispose_func=None):
+    def __init__(
+        self,
+        maxsize: int = 10,
+        dispose_func: typing.Callable[[_VT], None] | None = None,
+    ) -> None:
+        super().__init__()
         self._maxsize = maxsize
         self.dispose_func = dispose_func
-
-        self._container = self.ContainerCls()
+        self._container = OrderedDict()
         self.lock = RLock()
 
-    def __getitem__(self, key):
+    def __getitem__(self, key: _KT) -> _VT:
         # Re-insert the item, moving it to the end of the eviction line.
         with self.lock:
             item = self._container.pop(key)
             self._container[key] = item
             return item
 
-    def __setitem__(self, key, value):
-        evicted_value = _Null
+    def __setitem__(self, key: _KT, value: _VT) -> None:
+        evicted_item = None
         with self.lock:
             # Possibly evict the existing value of 'key'
-            evicted_value = self._container.get(key, _Null)
-            self._container[key] = value
+            try:
+                # If the key exists, we'll overwrite it, which won't change the
+                # size of the pool. Because accessing a key should move it to
+                # the end of the eviction line, we pop it out first.
+                evicted_item = key, self._container.pop(key)
+                self._container[key] = value
+            except KeyError:
+                # When the key does not exist, we insert the value first so that
+                # evicting works in all cases, including when self._maxsize is 0
+                self._container[key] = value
+                if len(self._container) > self._maxsize:
+                    # If we didn't evict an existing value, and we've hit our maximum
+                    # size, then we have to evict the least recently used item from
+                    # the beginning of the container.
+                    evicted_item = self._container.popitem(last=False)
 
-            # If we didn't evict an existing value, we might have to evict the
-            # least recently used item from the beginning of the container.
-            if len(self._container) > self._maxsize:
-                _key, evicted_value = self._container.popitem(last=False)
-
-        if self.dispose_func and evicted_value is not _Null:
+        # After releasing the lock on the pool, dispose of any evicted value.
+        if evicted_item is not None and self.dispose_func:
+            _, evicted_value = evicted_item
             self.dispose_func(evicted_value)
 
-    def __delitem__(self, key):
+    def __delitem__(self, key: _KT) -> None:
         with self.lock:
             value = self._container.pop(key)
 
         if self.dispose_func:
             self.dispose_func(value)
 
-    def __len__(self):
+    def __len__(self) -> int:
         with self.lock:
             return len(self._container)
 
-    def __iter__(self):
+    def __iter__(self) -> typing.NoReturn:
         raise NotImplementedError(
             "Iteration over this class is unlikely to be threadsafe."
         )
 
-    def clear(self):
+    def clear(self) -> None:
         with self.lock:
             # Copy pointers to all values, then wipe the mapping
-            values = list(itervalues(self._container))
+            values = list(self._container.values())
             self._container.clear()
 
         if self.dispose_func:
             for value in values:
                 self.dispose_func(value)
 
-    def keys(self):
+    def keys(self) -> set[_KT]:  # type: ignore[override]
         with self.lock:
-            return list(iterkeys(self._container))
+            return set(self._container.keys())
 
 
-class HTTPHeaderDict(MutableMapping):
+class HTTPHeaderDictItemView(set[tuple[str, str]]):
+    """
+    HTTPHeaderDict is unusual for a Mapping[str, str] in that it has two modes of
+    address.
+
+    If we directly try to get an item with a particular name, we will get a string
+    back that is the concatenated version of all the values:
+
+    >>> d['X-Header-Name']
+    'Value1, Value2, Value3'
+
+    However, if we iterate over an HTTPHeaderDict's items, we will optionally combine
+    these values based on whether combine=True was called when building up the dictionary
+
+    >>> d = HTTPHeaderDict({"A": "1", "B": "foo"})
+    >>> d.add("A", "2", combine=True)
+    >>> d.add("B", "bar")
+    >>> list(d.items())
+    [
+        ('A', '1, 2'),
+        ('B', 'foo'),
+        ('B', 'bar'),
+    ]
+
+    This class conforms to the interface required by the MutableMapping ABC while
+    also giving us the nonstandard iteration behavior we want; items with duplicate
+    keys, ordered by time of first insertion.
+    """
+
+    _headers: HTTPHeaderDict
+
+    def __init__(self, headers: HTTPHeaderDict) -> None:
+        self._headers = headers
+
+    def __len__(self) -> int:
+        return len(list(self._headers.iteritems()))
+
+    def __iter__(self) -> typing.Iterator[tuple[str, str]]:
+        return self._headers.iteritems()
+
+    def __contains__(self, item: object) -> bool:
+        if isinstance(item, tuple) and len(item) == 2:
+            passed_key, passed_val = item
+            if isinstance(passed_key, str) and isinstance(passed_val, str):
+                return self._headers._has_value_for_header(passed_key, passed_val)
+        return False
+
+
+class HTTPHeaderDict(typing.MutableMapping[str, str]):
     """
     :param headers:
         An iterable of field-value pairs. Must not contain multiple field names
@@ -138,9 +235,11 @@ class HTTPHeaderDict(MutableMapping):
     '7'
     """
 
-    def __init__(self, headers=None, **kwargs):
-        super(HTTPHeaderDict, self).__init__()
-        self._container = OrderedDict()
+    _container: typing.MutableMapping[str, list[str]]
+
+    def __init__(self, headers: ValidHTTPHeaderSource | None = None, **kwargs: str):
+        super().__init__()
+        self._container = {}  # 'dict' is insert-ordered
         if headers is not None:
             if isinstance(headers, HTTPHeaderDict):
                 self._copy_from(headers)
@@ -149,129 +248,161 @@ class HTTPHeaderDict(MutableMapping):
         if kwargs:
             self.extend(kwargs)
 
-    def __setitem__(self, key, val):
+    def __setitem__(self, key: str, val: str) -> None:
+        # avoid a bytes/str comparison by decoding before httplib
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
         self._container[key.lower()] = [key, val]
-        return self._container[key.lower()]
 
-    def __getitem__(self, key):
+    def __getitem__(self, key: str) -> str:
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
         val = self._container[key.lower()]
         return ", ".join(val[1:])
 
-    def __delitem__(self, key):
+    def __delitem__(self, key: str) -> None:
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
         del self._container[key.lower()]
 
-    def __contains__(self, key):
-        return key.lower() in self._container
+    def __contains__(self, key: object) -> bool:
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
+        if isinstance(key, str):
+            return key.lower() in self._container
+        return False
 
-    def __eq__(self, other):
-        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
+    def setdefault(self, key: str, default: str = "") -> str:
+        return super().setdefault(key, default)
+
+    def __eq__(self, other: object) -> bool:
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
             return False
-        if not isinstance(other, type(self)):
-            other = type(self)(other)
-        return dict((k.lower(), v) for k, v in self.itermerged()) == dict(
-            (k.lower(), v) for k, v in other.itermerged()
-        )
+        else:
+            other_as_http_header_dict = type(self)(maybe_constructable)
 
-    def __ne__(self, other):
+        return {k.lower(): v for k, v in self.itermerged()} == {
+            k.lower(): v for k, v in other_as_http_header_dict.itermerged()
+        }
+
+    def __ne__(self, other: object) -> bool:
         return not self.__eq__(other)
 
-    if six.PY2:  # Python 2
-        iterkeys = MutableMapping.iterkeys
-        itervalues = MutableMapping.itervalues
-
-    __marker = object()
-
-    def __len__(self):
+    def __len__(self) -> int:
         return len(self._container)
 
-    def __iter__(self):
+    def __iter__(self) -> typing.Iterator[str]:
         # Only provide the originally cased names
         for vals in self._container.values():
             yield vals[0]
 
-    def pop(self, key, default=__marker):
-        """D.pop(k[,d]) -> v, remove specified key and return the corresponding value.
-        If key is not found, d is returned if given, otherwise KeyError is raised.
-        """
-        # Using the MutableMapping function directly fails due to the private marker.
-        # Using ordinary dict.pop would expose the internal structures.
-        # So let's reinvent the wheel.
-        try:
-            value = self[key]
-        except KeyError:
-            if default is self.__marker:
-                raise
-            return default
-        else:
-            del self[key]
-            return value
-
-    def discard(self, key):
+    def discard(self, key: str) -> None:
         try:
             del self[key]
         except KeyError:
             pass
 
-    def add(self, key, val):
+    def add(self, key: str, val: str, *, combine: bool = False) -> None:
         """Adds a (name, value) pair, doesn't overwrite the value if it already
         exists.
 
+        If this is called with combine=True, instead of adding a new header value
+        as a distinct item during iteration, this will instead append the value to
+        any existing header value with a comma. If no existing header value exists
+        for the key, then the value will simply be added, ignoring the combine parameter.
+
         >>> headers = HTTPHeaderDict(foo='bar')
         >>> headers.add('Foo', 'baz')
         >>> headers['foo']
         'bar, baz'
+        >>> list(headers.items())
+        [('foo', 'bar'), ('foo', 'baz')]
+        >>> headers.add('foo', 'quz', combine=True)
+        >>> list(headers.items())
+        [('foo', 'bar, baz, quz')]
         """
+        # avoid a bytes/str comparison by decoding before httplib
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
         key_lower = key.lower()
         new_vals = [key, val]
         # Keep the common case aka no item present as fast as possible
         vals = self._container.setdefault(key_lower, new_vals)
         if new_vals is not vals:
-            vals.append(val)
+            # if there are values here, then there is at least the initial
+            # key/value pair
+            assert len(vals) >= 2
+            if combine:
+                vals[-1] = vals[-1] + ", " + val
+            else:
+                vals.append(val)
 
-    def extend(self, *args, **kwargs):
+    def extend(self, *args: ValidHTTPHeaderSource, **kwargs: str) -> None:
         """Generic import function for any type of header-like object.
         Adapted version of MutableMapping.update in order to insert items
         with self.add instead of self.__setitem__
         """
         if len(args) > 1:
             raise TypeError(
-                "extend() takes at most 1 positional "
-                "arguments ({0} given)".format(len(args))
+                f"extend() takes at most 1 positional arguments ({len(args)} given)"
             )
         other = args[0] if len(args) >= 1 else ()
 
         if isinstance(other, HTTPHeaderDict):
             for key, val in other.iteritems():
                 self.add(key, val)
-        elif isinstance(other, Mapping):
-            for key in other:
-                self.add(key, other[key])
-        elif hasattr(other, "keys"):
-            for key in other.keys():
-                self.add(key, other[key])
-        else:
+        elif isinstance(other, typing.Mapping):
+            for key, val in other.items():
+                self.add(key, val)
+        elif isinstance(other, typing.Iterable):
             for key, value in other:
                 self.add(key, value)
+        elif hasattr(other, "keys") and hasattr(other, "__getitem__"):
+            # THIS IS NOT A TYPESAFE BRANCH
+            # In this branch, the object has a `keys` attr but is not a Mapping or any of
+            # the other types indicated in the method signature. We do some stuff with
+            # it as though it partially implements the Mapping interface, but we're not
+            # doing that stuff safely AT ALL.
+            for key in other.keys():
+                self.add(key, other[key])
 
         for key, value in kwargs.items():
             self.add(key, value)
 
-    def getlist(self, key, default=__marker):
+    @typing.overload
+    def getlist(self, key: str) -> list[str]: ...
+
+    @typing.overload
+    def getlist(self, key: str, default: _DT) -> list[str] | _DT: ...
+
+    def getlist(
+        self, key: str, default: _Sentinel | _DT = _Sentinel.not_passed
+    ) -> list[str] | _DT:
         """Returns a list of all the values for the named field. Returns an
         empty list if the key doesn't exist."""
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
         try:
             vals = self._container[key.lower()]
         except KeyError:
-            if default is self.__marker:
+            if default is _Sentinel.not_passed:
+                # _DT is unbound; empty list is instance of List[str]
                 return []
+            # _DT is bound; default is instance of _DT
             return default
         else:
+            # _DT may or may not be bound; vals[1:] is instance of List[str], which
+            # meets our external interface requirement of `Union[List[str], _DT]`.
             return vals[1:]
 
-    def _prepare_for_method_change(self):
+    def _prepare_for_method_change(self) -> Self:
         """
         Remove content-specific header fields before changing the request
         method to GET or HEAD according to RFC 9110, Section 15.4.
+
+        ``Transfer-Encoding`` goes as well: it frames a request body that is
+        no longer going to be sent.
         """
         content_specific_headers = [
             "Content-Encoding",
@@ -281,6 +412,7 @@ class HTTPHeaderDict(MutableMapping):
             "Content-Length",
             "Digest",
             "Last-Modified",
+            "Transfer-Encoding",
         ]
         for header in content_specific_headers:
             self.discard(header)
@@ -294,62 +426,65 @@ class HTTPHeaderDict(MutableMapping):
     # Backwards compatibility for http.cookiejar
     get_all = getlist
 
-    def __repr__(self):
-        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
+    def __repr__(self) -> str:
+        return f"{type(self).__name__}({dict(self.itermerged())})"
 
-    def _copy_from(self, other):
+    def _copy_from(self, other: HTTPHeaderDict) -> None:
         for key in other:
             val = other.getlist(key)
-            if isinstance(val, list):
-                # Don't need to convert tuples
-                val = list(val)
-            self._container[key.lower()] = [key] + val
+            self._container[key.lower()] = [key, *val]
 
-    def copy(self):
+    def copy(self) -> Self:
         clone = type(self)()
         clone._copy_from(self)
         return clone
 
-    def iteritems(self):
+    def iteritems(self) -> typing.Iterator[tuple[str, str]]:
         """Iterate over all header lines, including duplicate ones."""
         for key in self:
             vals = self._container[key.lower()]
             for val in vals[1:]:
                 yield vals[0], val
 
-    def itermerged(self):
+    def itermerged(self) -> typing.Iterator[tuple[str, str]]:
         """Iterate over all headers, merging duplicate ones together."""
         for key in self:
             val = self._container[key.lower()]
             yield val[0], ", ".join(val[1:])
 
-    def items(self):
-        return list(self.iteritems())
+    def items(self) -> HTTPHeaderDictItemView:  # type: ignore[override]
+        return HTTPHeaderDictItemView(self)
 
-    @classmethod
-    def from_httplib(cls, message):  # Python 2
-        """Read headers from a Python 2 httplib message object."""
-        # python2.7 does not expose a proper API for exporting multiheaders
-        # efficiently. This function re-reads raw lines from the message
-        # object and extracts the multiheaders properly.
-        obs_fold_continued_leaders = (" ", "\t")
-        headers = []
+    def _has_value_for_header(self, header_name: str, potential_value: str) -> bool:
+        if header_name in self:
+            return potential_value in self._container[header_name.lower()][1:]
+        return False
 
-        for line in message.headers:
-            if line.startswith(obs_fold_continued_leaders):
-                if not headers:
-                    # We received a header line that starts with OWS as described
-                    # in RFC-7230 S3.2.4. This indicates a multiline header, but
-                    # there exists no previous header to which we can attach it.
-                    raise InvalidHeader(
-                        "Header continuation with no previous header: %s" % line
-                    )
-                else:
-                    key, value = headers[-1]
-                    headers[-1] = (key, value + " " + line.strip())
-                    continue
+    def __ior__(self, other: object) -> HTTPHeaderDict:
+        # Supports extending a header dict in-place using operator |=
+        # combining items with add instead of __setitem__
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
+            return NotImplemented
+        self.extend(maybe_constructable)
+        return self
 
-            key, value = line.split(":", 1)
-            headers.append((key, value.strip()))
+    def __or__(self, other: object) -> Self:
+        # Supports merging header dicts using operator |
+        # combining items with add instead of __setitem__
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
+            return NotImplemented
+        result = self.copy()
+        result.extend(maybe_constructable)
+        return result
 
-        return cls(headers)
+    def __ror__(self, other: object) -> Self:
+        # Supports merging header dicts using operator | when other is on left side
+        # combining items with add instead of __setitem__
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
+            return NotImplemented
+        result = type(self)(maybe_constructable)
+        result.extend(self)
+        return result
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_version.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_version.py
index d49df2a..319b966 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_version.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/_version.py
@@ -1,2 +1,24 @@
-# This file is protected via CODEOWNERS
-__version__ = "1.26.20"
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '2.8.0'
+__version_tuple__ = version_tuple = (2, 8, 0)
+
+__commit_id__ = commit_id = None
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connection.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connection.py
index de35b63..3bf3f57 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connection.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connection.py
@@ -1,59 +1,59 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import datetime
+import http.client
 import logging
 import os
 import re
 import socket
+import sys
+import threading
+import typing
 import warnings
-from socket import error as SocketError
+from http.client import HTTPConnection as _HTTPConnection
+from http.client import HTTPException as HTTPException  # noqa: F401
+from http.client import ResponseNotReady
 from socket import timeout as SocketTimeout
 
-from .packages import six
-from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection
-from .packages.six.moves.http_client import HTTPException  # noqa: F401
-from .util.proxy import create_proxy_ssl_context
+if typing.TYPE_CHECKING:
+    from .response import HTTPResponse
+    from .util.ssl_ import _TYPE_PEER_CERT_RET_DICT
+    from .util.ssltransport import SSLTransport
+
+from ._collections import HTTPHeaderDict
+from .http2 import probe as http2_probe
+from .util.response import assert_header_parsing
+from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT, Timeout
+from .util.util import to_str
+from .util.wait import wait_for_read
 
 try:  # Compiled with SSL?
     import ssl
 
     BaseSSLError = ssl.SSLError
-except (ImportError, AttributeError):  # Platform-specific: No SSL.
-    ssl = None
+except (ImportError, AttributeError):
+    ssl = None  # type: ignore[assignment]
 
-    class BaseSSLError(BaseException):
+    class BaseSSLError(BaseException):  # type: ignore[no-redef]
         pass
 
 
-try:
-    # Python 3: not a no-op, we're adding this to the namespace so it can be imported.
-    ConnectionError = ConnectionError
-except NameError:
-    # Python 2
-    class ConnectionError(Exception):
-        pass
-
-
-try:  # Python 3:
-    # Not a no-op, we're adding this to the namespace so it can be imported.
-    BrokenPipeError = BrokenPipeError
-except NameError:  # Python 2:
-
-    class BrokenPipeError(Exception):
-        pass
-
-
-from ._collections import HTTPHeaderDict  # noqa (historical, removed in v2)
+from ._base_connection import _TYPE_BODY
+from ._base_connection import ProxyConfig as ProxyConfig
+from ._base_connection import _ResponseOptions as _ResponseOptions
 from ._version import __version__
 from .exceptions import (
     ConnectTimeoutError,
+    HeaderParsingError,
+    NameResolutionError,
     NewConnectionError,
-    SubjectAltNameWarning,
+    ProxyError,
     SystemTimeWarning,
 )
-from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection
+from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection, ssl_
+from .util.request import body_to_chunks
+from .util.ssl_ import assert_fingerprint as _assert_fingerprint
 from .util.ssl_ import (
-    assert_fingerprint,
     create_urllib3_context,
     is_ipaddress,
     resolve_cert_reqs,
@@ -61,6 +61,12 @@ from .util.ssl_ import (
     ssl_wrap_socket,
 )
 from .util.ssl_match_hostname import CertificateError, match_hostname
+from .util.url import Url
+
+# Not a no-op, we're adding this to the namespace so it can be imported.
+ConnectionError = ConnectionError
+BrokenPipeError = BrokenPipeError
+
 
 log = logging.getLogger(__name__)
 
@@ -68,12 +74,43 @@ port_by_scheme = {"http": 80, "https": 443}
 
 # When it comes time to update this value as a part of regular maintenance
 # (ie test_recent_date is failing) update it to ~6 months before the current date.
-RECENT_DATE = datetime.date(2024, 1, 1)
+RECENT_DATE = datetime.date(2025, 1, 1)
 
 _CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
+# Starting the optional OWS match at the beginning of a whitespace run avoids
+# quadratic backtracking for long header values.
+_OBSOLETE_FOLD_RE = re.compile(r"(?:(? str:
+    if "\r\n" not in value:
+        return value
+    return _OBSOLETE_FOLD_RE.sub(" ", value)
+
+
+def _normalize_header_values(
+    message: http.client.HTTPMessage,
+) -> list[tuple[str, str]]:
+    header_items = message.items()
+    headers_changed = False
+    for index, (name, value) in enumerate(header_items):
+        normalized_value = _normalize_header_value(value)
+        if normalized_value != value:
+            header_items[index] = (name, normalized_value)
+            headers_changed = True
+
+    if headers_changed:
+        # Keep the original message in sync for downstream consumers such as
+        # cookie jars while preserving its identity and header ordering.
+        for name, _ in header_items:
+            del message[name]
+        for name, value in header_items:
+            message[name] = value
+
+    return header_items
+
+
+class HTTPConnection(_HTTPConnection):
     """
     Based on :class:`http.client.HTTPConnection` but provides an extra constructor
     backwards-compatibility layer between older and newer Pythons.
@@ -81,7 +118,6 @@ class HTTPConnection(_HTTPConnection, object):
     Additional keyword parameters are used to configure attributes of the connection.
     Accepted parameters include:
 
-    - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
     - ``source_address``: Set the source address for the current connection.
     - ``socket_options``: Set specific options on the underlying socket. If not specified, then
       defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
@@ -99,38 +135,74 @@ class HTTPConnection(_HTTPConnection, object):
       Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
     """
 
-    default_port = port_by_scheme["http"]
+    default_port: typing.ClassVar[int] = port_by_scheme["http"]  # type: ignore[misc]
 
     #: Disable Nagle's algorithm by default.
     #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
-    default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
+    #:
+    #: Use the ``socket_options`` parameter of :class:`~urllib3.PoolManager`,
+    #: :class:`~urllib3.ProxyManager`, or :class:`~urllib3.HTTPConnectionPool`
+    #: to change this behavior.
+    default_socket_options: typing.ClassVar[
+        typing.Final[connection._TYPE_SOCKET_OPTIONS]
+    ] = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
 
     #: Whether this connection verifies the host's certificate.
-    is_verified = False
+    is_verified: bool = False
 
-    #: Whether this proxy connection (if used) verifies the proxy host's
-    #: certificate.
-    proxy_is_verified = None
+    #: Whether this proxy connection verified the proxy host's certificate.
+    # If no proxy is currently connected to the value will be ``None``.
+    proxy_is_verified: bool | None = None
 
-    def __init__(self, *args, **kw):
-        if not six.PY2:
-            kw.pop("strict", None)
+    blocksize: int
+    source_address: tuple[str, int] | None
+    socket_options: connection._TYPE_SOCKET_OPTIONS | None
 
-        # Pre-set source_address.
-        self.source_address = kw.get("source_address")
+    _has_connected_to_proxy: bool
+    _response_options: _ResponseOptions | None
+    _tunnel_host: str | None
+    _tunnel_port: int | None
+    _tunnel_scheme: str | None
 
-        #: The socket options provided by the user. If no options are
-        #: provided, we use the default options.
-        self.socket_options = kw.pop("socket_options", self.default_socket_options)
+    def __init__(
+        self,
+        host: str,
+        port: int | None = None,
+        *,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        source_address: tuple[str, int] | None = None,
+        blocksize: int = 16384,
+        socket_options: None | (
+            connection._TYPE_SOCKET_OPTIONS
+        ) = default_socket_options,
+        proxy: Url | None = None,
+        proxy_config: ProxyConfig | None = None,
+    ) -> None:
+        super().__init__(
+            host=host,
+            port=port,
+            timeout=Timeout.resolve_default_timeout(timeout),
+            source_address=source_address,
+            blocksize=blocksize,
+        )
+        self.socket_options = socket_options
+        self.proxy = proxy
+        self.proxy_config = proxy_config
 
-        # Proxy options provided by the user.
-        self.proxy = kw.pop("proxy", None)
-        self.proxy_config = kw.pop("proxy_config", None)
+        self._has_connected_to_proxy = False
+        self._response_options = None
+        self._tunnel_host: str | None = None
+        self._tunnel_port: int | None = None
+        self._tunnel_scheme: str | None = None
 
-        _HTTPConnection.__init__(self, *args, **kw)
+    def __str__(self) -> str:
+        return f"{type(self).__name__}(host={self.host!r}, port={self.port!r})"
+
+    def __repr__(self) -> str:
+        return f"<{self} at {id(self):#x}>"
 
     @property
-    def host(self):
+    def host(self) -> str:
         """
         Getter method to remove any trailing dots that indicate the hostname is an FQDN.
 
@@ -149,7 +221,7 @@ class HTTPConnection(_HTTPConnection, object):
         return self._dns_host.rstrip(".")
 
     @host.setter
-    def host(self, value):
+    def host(self, value: str) -> None:
         """
         Setter for the `host` property.
 
@@ -158,129 +230,442 @@ class HTTPConnection(_HTTPConnection, object):
         """
         self._dns_host = value
 
-    def _new_conn(self):
+    def _new_conn(self) -> socket.socket:
         """Establish a socket connection and set nodelay settings on it.
 
         :return: New socket connection.
         """
-        extra_kw = {}
-        if self.source_address:
-            extra_kw["source_address"] = self.source_address
-
-        if self.socket_options:
-            extra_kw["socket_options"] = self.socket_options
-
         try:
-            conn = connection.create_connection(
-                (self._dns_host, self.port), self.timeout, **extra_kw
+            sock = connection.create_connection(
+                (self._dns_host, self.port),
+                self.timeout,
+                source_address=self.source_address,
+                socket_options=self.socket_options,
             )
-
-        except SocketTimeout:
+        except socket.gaierror as e:
+            raise NameResolutionError(self.host, self, e) from e
+        except SocketTimeout as e:
             raise ConnectTimeoutError(
                 self,
-                "Connection to %s timed out. (connect timeout=%s)"
-                % (self.host, self.timeout),
-            )
+                f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
+            ) from e
 
-        except SocketError as e:
+        except OSError as e:
             raise NewConnectionError(
-                self, "Failed to establish a new connection: %s" % e
+                self, f"Failed to establish a new connection: {e}"
+            ) from e
+
+        sys.audit("http.client.connect", self, self.host, self.port)
+
+        return sock
+
+    def set_tunnel(
+        self,
+        host: str,
+        port: int | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        scheme: str = "http",
+    ) -> None:
+        if scheme not in ("http", "https"):
+            raise ValueError(
+                f"Invalid proxy scheme for tunneling: {scheme!r}, must be either 'http' or 'https'"
             )
+        super().set_tunnel(host, port=port, headers=headers)
+        self._tunnel_scheme = scheme
 
-        return conn
+    if sys.version_info < (3, 11, 16) or ((3, 12) <= sys.version_info < (3, 12, 14)):
+        # Taken from python/cpython#100986 which was backported in 3.11.9 and 3.12.3.
+        # When using connection_from_host, host will come without brackets.
+        # With a security patch from python/cpython#146211.
+        def _wrap_ipv6(self, ip: bytes) -> bytes:
+            if b":" in ip and ip[0] != b"["[0]:
+                return b"[" + ip + b"]"
+            return ip
 
-    def _is_using_tunnel(self):
-        # Google App Engine's httplib does not define _tunnel_host
-        return getattr(self, "_tunnel_host", None)
+        # Copied from CPython 3.12.13 Lib/http/client.py
+        _is_legal_header_name = staticmethod(re.compile(rb"[^:\s][^:\r\n]*").fullmatch)
+        _is_illegal_header_value = staticmethod(
+            re.compile(rb"\n(?![ \t])|\r(?![ \t\n])").search
+        )
+        _contains_disallowed_url_pchar_re = re.compile("[\x00-\x20\x7f]")
+
+        if sys.version_info < (3, 11, 16):
+            # `_tunnel` copied from 3.11.15 backporting
+            # https://github.com/python/cpython/commit/0d4026432591d43185568dd31cef6a034c4b9261
+            # and https://github.com/python/cpython/commit/6fbc61070fda2ffb8889e77e3b24bca4249ab4d1
+            # plus a fix from https://github.com/python/cpython/commit/56b7100b04e44ea27989242b176beb8f016b2c53
+            def _tunnel(self) -> None:
+                if self._contains_disallowed_url_pchar_re.search(self._tunnel_host):  # type: ignore[arg-type]
+                    raise ValueError(
+                        "Tunnel host can't contain control characters %r"
+                        % (self._tunnel_host,)
+                    )
+                _MAXLINE = http.client._MAXLINE  # type: ignore[attr-defined]
+                connect = b"CONNECT %s:%d HTTP/1.0\r\n" % (  # type: ignore[str-format]
+                    self._wrap_ipv6(self._tunnel_host.encode("ascii")),  # type: ignore[union-attr]
+                    self._tunnel_port,
+                )
+                headers = [connect]
+                for header, value in self._tunnel_headers.items():  # type: ignore[attr-defined]
+                    header_bytes = header.encode("latin-1")
+                    value_bytes = value.encode("latin-1")
+                    if not self._is_legal_header_name(header_bytes):
+                        raise ValueError(f"Invalid header name {header_bytes!r}")
+                    if self._is_illegal_header_value(value_bytes):
+                        raise ValueError(f"Invalid header value {value_bytes!r}")
+                    headers.append(b"%s: %s\r\n" % (header_bytes, value_bytes))
+                headers.append(b"\r\n")
+                # Making a single send() call instead of one per line encourages
+                # the host OS to use a more optimal packet size instead of
+                # potentially emitting a series of small packets.
+                self.send(b"".join(headers))
+                del headers
+
+                response = self.response_class(self.sock, method=self._method)  # type: ignore[attr-defined]
+                try:
+                    version, code, message = response._read_status()  # type: ignore[attr-defined]
+
+                    if code != http.HTTPStatus.OK:
+                        self.close()
+                        raise OSError(
+                            f"Tunnel connection failed: {code} {message.strip()}"
+                        )
+                    while True:
+                        line = response.fp.readline(_MAXLINE + 1)
+                        if len(line) > _MAXLINE:
+                            raise http.client.LineTooLong("header line")
+                        if not line:
+                            # for sites which EOF without sending a trailer
+                            break
+                        if line in (b"\r\n", b"\n", b""):
+                            break
+
+                        if self.debuglevel > 0:
+                            print("header:", line.decode())
+                finally:
+                    response.close()
+
+        elif (3, 12) <= sys.version_info < (3, 12, 14):
+            # `_tunnel` copied from 3.12.13 backporting
+            # https://github.com/python/cpython/commit/23aef575c7629abcd4aaf028ebd226fb41a4b3c8
+            # plus a fix from https://github.com/python/cpython/commit/c00c386faa579ad71196d33408644478488e43ec
+            def _tunnel(self) -> None:  # noqa: F811
+                if self._contains_disallowed_url_pchar_re.search(self._tunnel_host):  # type: ignore[arg-type]
+                    raise ValueError(
+                        "Tunnel host can't contain control characters %r"
+                        % (self._tunnel_host,)
+                    )
+                connect = b"CONNECT %s:%d HTTP/1.1\r\n" % (  # type: ignore[str-format]
+                    self._wrap_ipv6(self._tunnel_host.encode("idna")),  # type: ignore[union-attr]
+                    self._tunnel_port,
+                )
+                headers = [connect]
+                for header, value in self._tunnel_headers.items():  # type: ignore[attr-defined]
+                    header_bytes = header.encode("latin-1")
+                    value_bytes = value.encode("latin-1")
+                    if not self._is_legal_header_name(header_bytes):
+                        raise ValueError(f"Invalid header name {header_bytes!r}")
+                    if self._is_illegal_header_value(value_bytes):
+                        raise ValueError(f"Invalid header value {value_bytes!r}")
+                    headers.append(b"%s: %s\r\n" % (header_bytes, value_bytes))
+                headers.append(b"\r\n")
+                # Making a single send() call instead of one per line encourages
+                # the host OS to use a more optimal packet size instead of
+                # potentially emitting a series of small packets.
+                self.send(b"".join(headers))
+                del headers
+
+                response = self.response_class(self.sock, method=self._method)  # type: ignore[attr-defined]
+                try:
+                    version, code, message = response._read_status()  # type: ignore[attr-defined]
+
+                    self._raw_proxy_headers = http.client._read_headers(response.fp)  # type: ignore[attr-defined]
+
+                    if self.debuglevel > 0:
+                        for header in self._raw_proxy_headers:
+                            print("header:", header.decode())
+
+                    if code != http.HTTPStatus.OK:
+                        self.close()
+                        raise OSError(
+                            f"Tunnel connection failed: {code} {message.strip()}"
+                        )
+
+                finally:
+                    response.close()
+
+    def connect(self) -> None:
+        self.sock = self._new_conn()
+        if self._tunnel_host:
+            # If we're tunneling it means we're connected to our proxy.
+            self._has_connected_to_proxy = True
 
-    def _prepare_conn(self, conn):
-        self.sock = conn
-        if self._is_using_tunnel():
             # TODO: Fix tunnel so it doesn't depend on self.sock state.
             self._tunnel()
-            # Mark this connection as not reusable
-            self.auto_open = 0
 
-    def connect(self):
-        conn = self._new_conn()
-        self._prepare_conn(conn)
+        # If there's a proxy to be connected to we are fully connected.
+        # This is set twice (once above and here) due to forwarding proxies
+        # not using tunnelling.
+        self._has_connected_to_proxy = bool(self.proxy)
 
-    def putrequest(self, method, url, *args, **kwargs):
-        """ """
+        if self._has_connected_to_proxy:
+            self.proxy_is_verified = False
+
+    @property
+    def is_closed(self) -> bool:
+        return self.sock is None
+
+    @property
+    def is_connected(self) -> bool:
+        if self.sock is None:
+            return False
+        return not wait_for_read(self.sock, timeout=0.0)
+
+    @property
+    def has_connected_to_proxy(self) -> bool:
+        return self._has_connected_to_proxy
+
+    @property
+    def proxy_is_forwarding(self) -> bool:
+        """
+        Return True if a forwarding proxy is configured, else return False
+        """
+        return bool(self.proxy) and self._tunnel_host is None
+
+    @property
+    def proxy_is_tunneling(self) -> bool:
+        """
+        Return True if a tunneling proxy is configured, else return False
+        """
+        return self._tunnel_host is not None
+
+    def close(self) -> None:
+        try:
+            super().close()
+        finally:
+            # Reset all stateful properties so connection
+            # can be re-used without leaking prior configs.
+            self.sock = None
+            self.is_verified = False
+            self.proxy_is_verified = None
+            self._has_connected_to_proxy = False
+            self._response_options = None
+            self._tunnel_host = None
+            self._tunnel_port = None
+            self._tunnel_scheme = None
+
+    def putrequest(
+        self,
+        method: str,
+        url: str,
+        skip_host: bool = False,
+        skip_accept_encoding: bool = False,
+    ) -> None:
+        """"""
         # Empty docstring because the indentation of CPython's implementation
         # is broken but we don't want this method in our documentation.
         match = _CONTAINS_CONTROL_CHAR_RE.search(method)
         if match:
             raise ValueError(
-                "Method cannot contain non-token characters %r (found at least %r)"
-                % (method, match.group())
+                f"Method cannot contain non-token characters {method!r} (found at least {match.group()!r})"
             )
 
-        return _HTTPConnection.putrequest(self, method, url, *args, **kwargs)
+        return super().putrequest(
+            method, url, skip_host=skip_host, skip_accept_encoding=skip_accept_encoding
+        )
 
-    def putheader(self, header, *values):
-        """ """
+    def putheader(self, header: str, *values: str) -> None:  # type: ignore[override]
+        """"""
         if not any(isinstance(v, str) and v == SKIP_HEADER for v in values):
-            _HTTPConnection.putheader(self, header, *values)
-        elif six.ensure_str(header.lower()) not in SKIPPABLE_HEADERS:
+            super().putheader(header, *values)
+        elif to_str(header.lower()) not in SKIPPABLE_HEADERS:
+            skippable_headers = "', '".join(
+                [str.title(header) for header in sorted(SKIPPABLE_HEADERS)]
+            )
             raise ValueError(
-                "urllib3.util.SKIP_HEADER only supports '%s'"
-                % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),)
+                f"urllib3.util.SKIP_HEADER only supports '{skippable_headers}'"
             )
 
-    def request(self, method, url, body=None, headers=None):
+    # `request` method's signature intentionally violates LSP.
+    # urllib3's API is different from `http.client.HTTPConnection` and the subclassing is only incidental.
+    def request(  # type: ignore[override]
+        self,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        *,
+        chunked: bool = False,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        enforce_content_length: bool = True,
+    ) -> None:
         # Update the inner socket's timeout value to send the request.
         # This only triggers if the connection is re-used.
-        if getattr(self, "sock", None) is not None:
+        if self.sock is not None:
             self.sock.settimeout(self.timeout)
 
+        # Store these values to be fed into the HTTPResponse
+        # object later. TODO: Remove this in favor of a real
+        # HTTP lifecycle mechanism.
+
+        # We have to store these before we call .request()
+        # because sometimes we can still salvage a response
+        # off the wire even if we aren't able to completely
+        # send the request body.
+        self._response_options = _ResponseOptions(
+            request_method=method,
+            request_url=url,
+            preload_content=preload_content,
+            decode_content=decode_content,
+            enforce_content_length=enforce_content_length,
+        )
+
         if headers is None:
             headers = {}
-        else:
-            # Avoid modifying the headers passed into .request()
-            headers = headers.copy()
-        if "user-agent" not in (six.ensure_str(k.lower()) for k in headers):
-            headers["User-Agent"] = _get_default_user_agent()
-        super(HTTPConnection, self).request(method, url, body=body, headers=headers)
-
-    def request_chunked(self, method, url, body=None, headers=None):
-        """
-        Alternative to the common request method, which sends the
-        body with chunked encoding and not as one block
-        """
-        headers = headers or {}
-        header_keys = set([six.ensure_str(k.lower()) for k in headers])
+        header_keys = frozenset(to_str(k.lower()) for k in headers)
         skip_accept_encoding = "accept-encoding" in header_keys
         skip_host = "host" in header_keys
         self.putrequest(
             method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host
         )
+
+        # Transform the body into an iterable of sendall()-able chunks
+        # and detect if an explicit Content-Length is doable.
+        chunks_and_cl = body_to_chunks(body, method=method, blocksize=self.blocksize)
+        chunks = chunks_and_cl.chunks
+        content_length = chunks_and_cl.content_length
+
+        # When chunked is explicit set to 'True' we respect that.
+        if chunked:
+            if "transfer-encoding" not in header_keys:
+                self.putheader("Transfer-Encoding", "chunked")
+        else:
+            # Detect whether a framing mechanism is already in use. If so
+            # we respect that value, otherwise we pick chunked vs content-length
+            # depending on the type of 'body'.
+            if "content-length" in header_keys:
+                chunked = False
+            elif "transfer-encoding" in header_keys:
+                chunked = True
+
+            # Otherwise we go off the recommendation of 'body_to_chunks()'.
+            else:
+                chunked = False
+                if content_length is None:
+                    if chunks is not None:
+                        chunked = True
+                        self.putheader("Transfer-Encoding", "chunked")
+                else:
+                    self.putheader("Content-Length", str(content_length))
+
+        # Now that framing headers are out of the way we send all the other headers.
         if "user-agent" not in header_keys:
             self.putheader("User-Agent", _get_default_user_agent())
         for header, value in headers.items():
             self.putheader(header, value)
-        if "transfer-encoding" not in header_keys:
-            self.putheader("Transfer-Encoding", "chunked")
         self.endheaders()
 
-        if body is not None:
-            stringish_types = six.string_types + (bytes,)
-            if isinstance(body, stringish_types):
-                body = (body,)
-            for chunk in body:
+        # If we're given a body we start sending that in chunks.
+        if chunks is not None:
+            for chunk in chunks:
+                # Sending empty chunks isn't allowed for TE: chunked
+                # as it indicates the end of the body.
                 if not chunk:
                     continue
-                if not isinstance(chunk, bytes):
-                    chunk = chunk.encode("utf8")
-                len_str = hex(len(chunk))[2:]
-                to_send = bytearray(len_str.encode())
-                to_send += b"\r\n"
-                to_send += chunk
-                to_send += b"\r\n"
-                self.send(to_send)
+                if isinstance(chunk, str):
+                    chunk = chunk.encode("utf-8")
+                if chunked:
+                    self.send(b"%x\r\n%b\r\n" % (len(chunk), chunk))
+                else:
+                    self.send(chunk)
 
-        # After the if clause, to always have a closed body
-        self.send(b"0\r\n\r\n")
+        # Regardless of whether we have a body or not, if we're in
+        # chunked mode we want to send an explicit empty chunk.
+        if chunked:
+            self.send(b"0\r\n\r\n")
+
+    def request_chunked(
+        self,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+    ) -> None:
+        """
+        Alternative to the common request method, which sends the
+        body with chunked encoding and not as one block
+        """
+        warnings.warn(
+            "HTTPConnection.request_chunked() is deprecated and will be removed "
+            "in urllib3 v3.0. Instead use HTTPConnection.request(..., chunked=True).",
+            category=FutureWarning,
+            stacklevel=2,
+        )
+        self.request(method, url, body=body, headers=headers, chunked=True)
+
+    def getresponse(  # type: ignore[override]
+        self,
+    ) -> HTTPResponse:
+        """
+        Get the response from the server.
+
+        If the HTTPConnection is in the correct state, returns an instance of HTTPResponse or of whatever object is returned by the response_class variable.
+
+        If a request has not been sent or if a previous response has not be handled, ResponseNotReady is raised. If the HTTP response indicates that the connection should be closed, then it will be closed before the response is returned. When the connection is closed, the underlying socket is closed.
+        """
+        # Raise the same error as http.client.HTTPConnection
+        if self._response_options is None:
+            raise ResponseNotReady()
+
+        # Reset this attribute for being used again.
+        resp_options = self._response_options
+        self._response_options = None
+
+        # Since the connection's timeout value may have been updated
+        # we need to set the timeout on the socket.
+        self.sock.settimeout(self.timeout)
+
+        # This is needed here to avoid circular import errors
+        from .response import HTTPResponse
+
+        # Save a reference to the shutdown function before ownership is passed
+        # to httplib_response
+        # TODO should we implement it everywhere?
+        _shutdown = getattr(self.sock, "shutdown", None)
+
+        # Get the response from http.client.HTTPConnection
+        httplib_response = super().getresponse()
+
+        try:
+            assert_header_parsing(httplib_response.msg)
+        except (HeaderParsingError, TypeError) as hpe:
+            log.warning(
+                "Failed to parse headers (url=%s): %s",
+                _url_from_connection(self, resp_options.request_url),
+                hpe,
+                exc_info=True,
+            )
+
+        header_items = _normalize_header_values(httplib_response.msg)
+        headers = HTTPHeaderDict(header_items)
+
+        response = HTTPResponse(
+            body=httplib_response,
+            headers=headers,
+            status=httplib_response.status,
+            version=httplib_response.version,
+            version_string=getattr(self, "_http_vsn_str", "HTTP/?"),
+            reason=httplib_response.reason,
+            preload_content=resp_options.preload_content,
+            decode_content=resp_options.decode_content,
+            original_response=httplib_response,
+            enforce_content_length=resp_options.enforce_content_length,
+            request_method=resp_options.request_method,
+            request_url=resp_options.request_url,
+            sock_shutdown=_shutdown,
+        )
+        return response
 
 
 class HTTPSConnection(HTTPConnection):
@@ -289,57 +674,103 @@ class HTTPSConnection(HTTPConnection):
     socket by means of :py:func:`urllib3.util.ssl_wrap_socket`.
     """
 
-    default_port = port_by_scheme["https"]
+    default_port = port_by_scheme["https"]  # type: ignore[misc]
 
-    cert_reqs = None
-    ca_certs = None
-    ca_cert_dir = None
-    ca_cert_data = None
-    ssl_version = None
-    assert_fingerprint = None
-    tls_in_tls_required = False
+    cert_reqs: int | str | None = None
+    ca_certs: str | None = None
+    ca_cert_dir: str | None = None
+    ca_cert_data: None | str | bytes = None
+    ssl_version: int | str | None = None
+    ssl_minimum_version: int | None = None
+    ssl_maximum_version: int | None = None
+    assert_fingerprint: str | None = None
+    _connect_callback: typing.Callable[..., None] | None = None
 
     def __init__(
         self,
-        host,
-        port=None,
-        key_file=None,
-        cert_file=None,
-        key_password=None,
-        strict=None,
-        timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
-        ssl_context=None,
-        server_hostname=None,
-        **kw
-    ):
-
-        HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw)
+        host: str,
+        port: int | None = None,
+        *,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        source_address: tuple[str, int] | None = None,
+        blocksize: int = 16384,
+        socket_options: None | (
+            connection._TYPE_SOCKET_OPTIONS
+        ) = HTTPConnection.default_socket_options,
+        proxy: Url | None = None,
+        proxy_config: ProxyConfig | None = None,
+        cert_reqs: int | str | None = None,
+        assert_hostname: None | str | typing.Literal[False] = None,
+        assert_fingerprint: str | None = None,
+        server_hostname: str | None = None,
+        ssl_context: ssl.SSLContext | None = None,
+        ca_certs: str | None = None,
+        ca_cert_dir: str | None = None,
+        ca_cert_data: None | str | bytes = None,
+        ssl_minimum_version: int | None = None,
+        ssl_maximum_version: int | None = None,
+        ssl_version: int | str | None = None,  # Deprecated
+        cert_file: str | None = None,
+        key_file: str | None = None,
+        key_password: str | None = None,
+    ) -> None:
+        super().__init__(
+            host,
+            port=port,
+            timeout=timeout,
+            source_address=source_address,
+            blocksize=blocksize,
+            socket_options=socket_options,
+            proxy=proxy,
+            proxy_config=proxy_config,
+        )
 
         self.key_file = key_file
         self.cert_file = cert_file
         self.key_password = key_password
         self.ssl_context = ssl_context
         self.server_hostname = server_hostname
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+        self.ssl_version = ssl_version
+        self.ssl_minimum_version = ssl_minimum_version
+        self.ssl_maximum_version = ssl_maximum_version
+        self.ca_certs = ca_certs and os.path.expanduser(ca_certs)
+        self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
+        self.ca_cert_data = ca_cert_data
 
-        # Required property for Google AppEngine 1.9.0 which otherwise causes
-        # HTTPS requests to go out as HTTP. (See Issue #356)
-        self._protocol = "https"
+        # cert_reqs depends on ssl_context so calculate last.
+        if cert_reqs is None:
+            if self.ssl_context is not None:
+                cert_reqs = self.ssl_context.verify_mode
+            else:
+                cert_reqs = resolve_cert_reqs(None)
+        self.cert_reqs = cert_reqs
+        self._connect_callback = None
 
     def set_cert(
         self,
-        key_file=None,
-        cert_file=None,
-        cert_reqs=None,
-        key_password=None,
-        ca_certs=None,
-        assert_hostname=None,
-        assert_fingerprint=None,
-        ca_cert_dir=None,
-        ca_cert_data=None,
-    ):
+        key_file: str | None = None,
+        cert_file: str | None = None,
+        cert_reqs: int | str | None = None,
+        key_password: str | None = None,
+        ca_certs: str | None = None,
+        assert_hostname: None | str | typing.Literal[False] = None,
+        assert_fingerprint: str | None = None,
+        ca_cert_dir: str | None = None,
+        ca_cert_data: None | str | bytes = None,
+    ) -> None:
         """
         This method should only be called once, before the connection is used.
         """
+        warnings.warn(
+            "HTTPSConnection.set_cert() is deprecated and will be removed "
+            "in urllib3 v3.0. Instead provide the parameters to the "
+            "HTTPSConnection constructor.",
+            category=FutureWarning,
+            stacklevel=2,
+        )
+
         # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also
         # have an SSLContext object in which case we'll use its verify_mode.
         if cert_reqs is None:
@@ -358,191 +789,359 @@ class HTTPSConnection(HTTPConnection):
         self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
         self.ca_cert_data = ca_cert_data
 
-    def connect(self):
-        # Add certificate verification
-        self.sock = conn = self._new_conn()
-        hostname = self.host
-        tls_in_tls = False
+    def connect(self) -> None:
+        # Today we don't need to be doing this step before the /actual/ socket
+        # connection, however in the future we'll need to decide whether to
+        # create a new socket or re-use an existing "shared" socket as a part
+        # of the HTTP/2 handshake dance.
+        if self._tunnel_host is not None and self._tunnel_port is not None:
+            probe_http2_host = self._tunnel_host
+            probe_http2_port = self._tunnel_port
+        else:
+            probe_http2_host = self.host
+            probe_http2_port = self.port
 
-        if self._is_using_tunnel():
-            if self.tls_in_tls_required:
-                self.sock = conn = self._connect_tls_proxy(hostname, conn)
-                tls_in_tls = True
+        # Check if the target origin supports HTTP/2.
+        # If the value comes back as 'None' it means that the current thread
+        # is probing for HTTP/2 support. Otherwise, we're waiting for another
+        # probe to complete, or we get a value right away.
+        target_supports_http2: bool | None
+        if "h2" in ssl_.ALPN_PROTOCOLS:
+            target_supports_http2 = http2_probe.acquire_and_get(
+                host=probe_http2_host, port=probe_http2_port
+            )
+        else:
+            # If HTTP/2 isn't going to be offered it doesn't matter if
+            # the target supports HTTP/2. Don't want to make a probe.
+            target_supports_http2 = False
 
-            # Calls self._set_hostport(), so self.host is
-            # self._tunnel_host below.
-            self._tunnel()
-            # Mark this connection as not reusable
-            self.auto_open = 0
-
-            # Override the host with the one we're requesting data from.
-            hostname = self._tunnel_host
-
-        server_hostname = hostname
-        if self.server_hostname is not None:
-            server_hostname = self.server_hostname
-
-        is_time_off = datetime.date.today() < RECENT_DATE
-        if is_time_off:
-            warnings.warn(
-                (
-                    "System time is way off (before {0}). This will probably "
-                    "lead to SSL verification errors"
-                ).format(RECENT_DATE),
-                SystemTimeWarning,
+        if self._connect_callback is not None:
+            self._connect_callback(
+                "before connect",
+                thread_id=threading.get_ident(),
+                target_supports_http2=target_supports_http2,
             )
 
-        # Wrap socket using verification with the root certs in
-        # trusted_root_certs
-        default_ssl_context = False
-        if self.ssl_context is None:
-            default_ssl_context = True
-            self.ssl_context = create_urllib3_context(
-                ssl_version=resolve_ssl_version(self.ssl_version),
-                cert_reqs=resolve_cert_reqs(self.cert_reqs),
+        try:
+            sock: socket.socket | ssl.SSLSocket
+            self.sock = sock = self._new_conn()
+            server_hostname: str = self.host
+            tls_in_tls = False
+
+            # Do we need to establish a tunnel?
+            if self.proxy_is_tunneling:
+                # We're tunneling to an HTTPS origin so need to do TLS-in-TLS.
+                if self._tunnel_scheme == "https":
+                    # _connect_tls_proxy will verify and assign proxy_is_verified
+                    self.sock = sock = self._connect_tls_proxy(self.host, sock)
+                    tls_in_tls = True
+                elif self._tunnel_scheme == "http":
+                    self.proxy_is_verified = False
+
+                # If we're tunneling it means we're connected to our proxy.
+                self._has_connected_to_proxy = True
+
+                self._tunnel()
+                # Override the host with the one we're requesting data from.
+                server_hostname = typing.cast(str, self._tunnel_host)
+
+            if self.server_hostname is not None:
+                server_hostname = self.server_hostname
+
+            is_time_off = datetime.date.today() < RECENT_DATE
+            if is_time_off:
+                warnings.warn(
+                    (
+                        f"System time is way off (before {RECENT_DATE}). This will probably "
+                        "lead to SSL verification errors"
+                    ),
+                    SystemTimeWarning,
+                )
+
+            # Remove trailing '.' from fqdn hostnames to allow certificate validation
+            server_hostname_rm_dot = server_hostname.rstrip(".")
+
+            # Forwarding proxies should use proxy SSL context for
+            # wrapping since that's the connection being established,
+            # whereas tunneling proxies should use the connection's SSL
+            # context.
+            # However, for backwards compatibility reasons, if the proxy
+            # is forwarding but no proxy SSL context is provided, we
+            # fall back to using the connection's SSL context until
+            # urllib3 v3.0. Appropriate warning is emitted in
+            # ``ProxyManager.__init__``.
+            wrapped_socket: ssl.SSLSocket | SSLTransport
+            if self.proxy_is_forwarding and self.proxy_config is not None:
+                wrapped_socket = self._connect_tls_proxy(self.host, sock)
+                is_verified = self.proxy_is_verified is True
+            else:
+                wrapped_socket, is_verified = _ssl_wrap_socket_and_match_hostname(
+                    sock=sock,
+                    cert_reqs=self.cert_reqs,
+                    ssl_version=self.ssl_version,
+                    ssl_minimum_version=self.ssl_minimum_version,
+                    ssl_maximum_version=self.ssl_maximum_version,
+                    ca_certs=self.ca_certs,
+                    ca_cert_dir=self.ca_cert_dir,
+                    ca_cert_data=self.ca_cert_data,
+                    cert_file=self.cert_file,
+                    key_file=self.key_file,
+                    key_password=self.key_password,
+                    server_hostname=server_hostname_rm_dot,
+                    ssl_context=self.ssl_context,
+                    tls_in_tls=tls_in_tls,
+                    assert_hostname=self.assert_hostname,
+                    assert_fingerprint=self.assert_fingerprint,
+                )
+            self.sock = wrapped_socket
+
+        # If an error occurs during connection/handshake we may need to release
+        # our lock so another connection can probe the origin.
+        except BaseException:
+            if self._connect_callback is not None:
+                self._connect_callback(
+                    "after connect failure",
+                    thread_id=threading.get_ident(),
+                    target_supports_http2=target_supports_http2,
+                )
+
+            if target_supports_http2 is None:
+                http2_probe.set_and_release(
+                    host=probe_http2_host, port=probe_http2_port, supports_http2=None
+                )
+            raise
+
+        # If this connection doesn't know if the origin supports HTTP/2
+        # we report back to the HTTP/2 probe our result.
+        if target_supports_http2 is None:
+            supports_http2 = wrapped_socket.selected_alpn_protocol() == "h2"
+            http2_probe.set_and_release(
+                host=probe_http2_host,
+                port=probe_http2_port,
+                supports_http2=supports_http2,
             )
 
-        context = self.ssl_context
-        context.verify_mode = resolve_cert_reqs(self.cert_reqs)
+        # Forwarding proxies can never have a verified target since
+        # the proxy is the one doing the verification. Should instead
+        # use a CONNECT tunnel in order to verify the target.
+        # See: https://github.com/urllib3/urllib3/issues/3267.
+        if self.proxy_is_forwarding:
+            self.is_verified = False
+        else:
+            self.is_verified = is_verified
 
-        # Try to load OS default certs if none are given.
-        # Works well on Windows (requires Python3.4+)
-        if (
-            not self.ca_certs
-            and not self.ca_cert_dir
-            and not self.ca_cert_data
-            and default_ssl_context
-            and hasattr(context, "load_default_certs")
-        ):
-            context.load_default_certs()
+        # If there's a proxy to be connected to we are fully connected.
+        # This is set twice (once above and here) due to forwarding proxies
+        # not using tunnelling.
+        self._has_connected_to_proxy = bool(self.proxy)
 
-        self.sock = ssl_wrap_socket(
-            sock=conn,
-            keyfile=self.key_file,
-            certfile=self.cert_file,
-            key_password=self.key_password,
-            ca_certs=self.ca_certs,
-            ca_cert_dir=self.ca_cert_dir,
-            ca_cert_data=self.ca_cert_data,
-            server_hostname=server_hostname,
-            ssl_context=context,
-            tls_in_tls=tls_in_tls,
+        # Set `self.proxy_is_verified` unless it's already set while
+        # establishing a tunnel.
+        if self._has_connected_to_proxy and self.proxy_is_verified is None:
+            self.proxy_is_verified = is_verified
+
+    def _connect_tls_proxy(self, hostname: str, sock: socket.socket) -> ssl.SSLSocket:
+        """
+        Establish a TLS connection to the proxy using proxy-specific policy.
+        """
+        proxy_config = typing.cast(ProxyConfig, self.proxy_config)
+        proxy_ssl_context = proxy_config.ssl_context
+
+        ssl_context: ssl.SSLContext | None
+        cert_reqs: int | str | None
+        if proxy_ssl_context is not None:
+            # Prefer the proxy's cert policy for the proxy connection
+            ssl_context = proxy_ssl_context
+            cert_reqs = proxy_ssl_context.verify_mode
+            ca_certs = None
+            ca_cert_dir = None
+            ca_cert_data = None
+            ssl_version = None
+            ssl_minimum_version = None
+            ssl_maximum_version = None
+        else:
+            # Otherwise we inherit the pool's cert policies
+            ssl_context = self.ssl_context if self.proxy_is_forwarding else None
+            cert_reqs = self.cert_reqs
+            ca_certs = self.ca_certs
+            ca_cert_dir = self.ca_cert_dir
+            ca_cert_data = self.ca_cert_data
+            ssl_version = self.ssl_version
+            ssl_minimum_version = self.ssl_minimum_version
+            ssl_maximum_version = self.ssl_maximum_version
+
+        sock_and_verified = _ssl_wrap_socket_and_match_hostname(
+            sock,
+            cert_reqs=cert_reqs,
+            ssl_version=ssl_version,
+            ssl_minimum_version=ssl_minimum_version,
+            ssl_maximum_version=ssl_maximum_version,
+            ca_certs=ca_certs,
+            ca_cert_dir=ca_cert_dir,
+            ca_cert_data=ca_cert_data,
+            server_hostname=hostname,
+            ssl_context=ssl_context,
+            assert_hostname=proxy_config.assert_hostname,
+            assert_fingerprint=proxy_config.assert_fingerprint,
+            # Features that aren't implemented for proxies yet:
+            cert_file=None,
+            key_file=None,
+            key_password=None,
+            tls_in_tls=False,
         )
+        self.proxy_is_verified = sock_and_verified.is_verified
+        return sock_and_verified.socket  # type: ignore[return-value]
 
-        # If we're using all defaults and the connection
-        # is TLSv1 or TLSv1.1 we throw a DeprecationWarning
-        # for the host.
-        if (
-            default_ssl_context
-            and self.ssl_version is None
-            and hasattr(self.sock, "version")
-            and self.sock.version() in {"TLSv1", "TLSv1.1"}
-        ):  # Defensive:
-            warnings.warn(
-                "Negotiating TLSv1/TLSv1.1 by default is deprecated "
-                "and will be disabled in urllib3 v2.0.0. Connecting to "
-                "'%s' with '%s' can be enabled by explicitly opting-in "
-                "with 'ssl_version'" % (self.host, self.sock.version()),
-                DeprecationWarning,
-            )
 
-        if self.assert_fingerprint:
-            assert_fingerprint(
-                self.sock.getpeercert(binary_form=True), self.assert_fingerprint
+class _WrappedAndVerifiedSocket(typing.NamedTuple):
+    """
+    Wrapped socket and whether the connection is
+    verified after the TLS handshake
+    """
+
+    socket: ssl.SSLSocket | SSLTransport
+    is_verified: bool
+
+
+def _ssl_wrap_socket_and_match_hostname(
+    sock: socket.socket,
+    *,
+    cert_reqs: None | str | int,
+    ssl_version: None | str | int,
+    ssl_minimum_version: int | None,
+    ssl_maximum_version: int | None,
+    cert_file: str | None,
+    key_file: str | None,
+    key_password: str | None,
+    ca_certs: str | None,
+    ca_cert_dir: str | None,
+    ca_cert_data: None | str | bytes,
+    assert_hostname: None | str | typing.Literal[False],
+    assert_fingerprint: str | None,
+    server_hostname: str | None,
+    ssl_context: ssl.SSLContext | None,
+    tls_in_tls: bool = False,
+) -> _WrappedAndVerifiedSocket:
+    """Logic for constructing an SSLContext from all TLS parameters, passing
+    that down into ssl_wrap_socket, and then doing certificate verification
+    either via hostname or fingerprint. This function exists to guarantee
+    that both proxies and targets have the same behavior when connecting via TLS.
+    """
+    default_ssl_context = False
+    if ssl_context is None:
+        default_ssl_context = True
+        context = create_urllib3_context(
+            ssl_version=resolve_ssl_version(ssl_version),
+            ssl_minimum_version=ssl_minimum_version,
+            ssl_maximum_version=ssl_maximum_version,
+            cert_reqs=resolve_cert_reqs(cert_reqs),
+        )
+    else:
+        context = ssl_context
+
+    context.verify_mode = resolve_cert_reqs(cert_reqs)
+
+    # In some cases, we want to verify hostnames ourselves
+    if (
+        # `ssl` can't verify fingerprints or alternate hostnames
+        assert_fingerprint
+        or assert_hostname
+        # assert_hostname can be set to False to disable hostname checking
+        or assert_hostname is False
+        # We still support OpenSSL 1.0.2, which prevents us from verifying
+        # hostnames easily: https://github.com/pyca/pyopenssl/pull/933
+        or ssl_.IS_PYOPENSSL
+        or not ssl_.HAS_NEVER_CHECK_COMMON_NAME
+    ):
+        context.check_hostname = False
+
+    # Try to load OS default certs if none are given. We need to do the hasattr() check
+    # for custom pyOpenSSL SSLContext objects because they don't support
+    # load_default_certs().
+    if (
+        not ca_certs
+        and not ca_cert_dir
+        and not ca_cert_data
+        and default_ssl_context
+        and hasattr(context, "load_default_certs")
+    ):
+        context.load_default_certs()
+
+    # Ensure that IPv6 addresses are in the proper format and don't have a
+    # scope ID. Python's SSL module fails to recognize scoped IPv6 addresses
+    # and interprets them as DNS hostnames.
+    if server_hostname is not None:
+        normalized = server_hostname.strip("[]")
+        if "%" in normalized:
+            normalized = normalized[: normalized.rfind("%")]
+        if is_ipaddress(normalized):
+            server_hostname = normalized
+
+    ssl_sock = ssl_wrap_socket(
+        sock=sock,
+        keyfile=key_file,
+        certfile=cert_file,
+        key_password=key_password,
+        ca_certs=ca_certs,
+        ca_cert_dir=ca_cert_dir,
+        ca_cert_data=ca_cert_data,
+        server_hostname=server_hostname,
+        ssl_context=context,
+        tls_in_tls=tls_in_tls,
+    )
+
+    try:
+        if assert_fingerprint:
+            _assert_fingerprint(
+                ssl_sock.getpeercert(binary_form=True), assert_fingerprint
             )
         elif (
             context.verify_mode != ssl.CERT_NONE
-            and not getattr(context, "check_hostname", False)
-            and self.assert_hostname is not False
+            and not context.check_hostname
+            and assert_hostname is not False
         ):
-            # While urllib3 attempts to always turn off hostname matching from
-            # the TLS library, this cannot always be done. So we check whether
-            # the TLS Library still thinks it's matching hostnames.
-            cert = self.sock.getpeercert()
-            if not cert.get("subjectAltName", ()):
-                warnings.warn(
-                    (
-                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
-                        "`commonName` for now. This feature is being removed by major browsers and "
-                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
-                        "for details.)".format(hostname)
-                    ),
-                    SubjectAltNameWarning,
+            cert: _TYPE_PEER_CERT_RET_DICT = ssl_sock.getpeercert()  # type: ignore[assignment]
+
+            # Need to signal to our match_hostname whether to use 'commonName' or not.
+            # If we're using our own constructed SSLContext we explicitly set 'False'
+            # because PyPy hard-codes 'True' from SSLContext.hostname_checks_common_name.
+            if default_ssl_context:
+                hostname_checks_common_name = False
+            else:
+                hostname_checks_common_name = (
+                    getattr(context, "hostname_checks_common_name", False) or False
                 )
-            _match_hostname(cert, self.assert_hostname or server_hostname)
 
-        self.is_verified = (
-            context.verify_mode == ssl.CERT_REQUIRED
-            or self.assert_fingerprint is not None
-        )
-
-    def _connect_tls_proxy(self, hostname, conn):
-        """
-        Establish a TLS connection to the proxy using the provided SSL context.
-        """
-        proxy_config = self.proxy_config
-        ssl_context = proxy_config.ssl_context
-        if ssl_context:
-            # If the user provided a proxy context, we assume CA and client
-            # certificates have already been set
-            return ssl_wrap_socket(
-                sock=conn,
-                server_hostname=hostname,
-                ssl_context=ssl_context,
+            _match_hostname(
+                cert,
+                assert_hostname or server_hostname,  # type: ignore[arg-type]
+                hostname_checks_common_name,
             )
 
-        ssl_context = create_proxy_ssl_context(
-            self.ssl_version,
-            self.cert_reqs,
-            self.ca_certs,
-            self.ca_cert_dir,
-            self.ca_cert_data,
+        return _WrappedAndVerifiedSocket(
+            socket=ssl_sock,
+            is_verified=context.verify_mode == ssl.CERT_REQUIRED
+            or bool(assert_fingerprint),
         )
-
-        # If no cert was provided, use only the default options for server
-        # certificate validation
-        socket = ssl_wrap_socket(
-            sock=conn,
-            ca_certs=self.ca_certs,
-            ca_cert_dir=self.ca_cert_dir,
-            ca_cert_data=self.ca_cert_data,
-            server_hostname=hostname,
-            ssl_context=ssl_context,
-        )
-
-        if ssl_context.verify_mode != ssl.CERT_NONE and not getattr(
-            ssl_context, "check_hostname", False
-        ):
-            # While urllib3 attempts to always turn off hostname matching from
-            # the TLS library, this cannot always be done. So we check whether
-            # the TLS Library still thinks it's matching hostnames.
-            cert = socket.getpeercert()
-            if not cert.get("subjectAltName", ()):
-                warnings.warn(
-                    (
-                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
-                        "`commonName` for now. This feature is being removed by major browsers and "
-                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
-                        "for details.)".format(hostname)
-                    ),
-                    SubjectAltNameWarning,
-                )
-            _match_hostname(cert, hostname)
-
-        self.proxy_is_verified = ssl_context.verify_mode == ssl.CERT_REQUIRED
-        return socket
+    except BaseException:
+        ssl_sock.close()
+        raise
 
 
-def _match_hostname(cert, asserted_hostname):
+def _match_hostname(
+    cert: _TYPE_PEER_CERT_RET_DICT | None,
+    asserted_hostname: str,
+    hostname_checks_common_name: bool = False,
+) -> None:
     # Our upstream implementation of ssl.match_hostname()
     # only applies this normalization to IP addresses so it doesn't
     # match DNS SANs so we do the same thing!
-    stripped_hostname = asserted_hostname.strip("u[]")
+    stripped_hostname = asserted_hostname.strip("[]")
     if is_ipaddress(stripped_hostname):
         asserted_hostname = stripped_hostname
 
     try:
-        match_hostname(cert, asserted_hostname)
+        match_hostname(cert, asserted_hostname, hostname_checks_common_name)
     except CertificateError as e:
         log.warning(
             "Certificate did not match expected hostname: %s. Certificate: %s",
@@ -551,22 +1150,55 @@ def _match_hostname(cert, asserted_hostname):
         )
         # Add cert to exception and reraise so client code can inspect
         # the cert when catching the exception, if they want to
-        e._peer_cert = cert
+        e._peer_cert = cert  # type: ignore[attr-defined]
         raise
 
 
-def _get_default_user_agent():
-    return "python-urllib3/%s" % __version__
+def _wrap_proxy_error(err: Exception, proxy_scheme: str | None) -> ProxyError:
+    # Look for the phrase 'wrong version number', if found
+    # then we should warn the user that we're very sure that
+    # this proxy is HTTP-only and they have a configuration issue.
+    error_normalized = " ".join(re.split("[^a-z]", str(err).lower()))
+    is_likely_http_proxy = (
+        "wrong version number" in error_normalized
+        or "unknown protocol" in error_normalized
+        or "record layer failure" in error_normalized
+    )
+    http_proxy_warning = (
+        ". Your proxy appears to only use HTTP and not HTTPS, "
+        "try changing your proxy URL to be HTTP. See: "
+        "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
+        "#https-proxy-error-http-proxy"
+    )
+    new_err = ProxyError(
+        f"Unable to connect to proxy"
+        f"{http_proxy_warning if is_likely_http_proxy and proxy_scheme == 'https' else ''}",
+        err,
+    )
+    new_err.__cause__ = err
+    return new_err
 
 
-class DummyConnection(object):
+def _get_default_user_agent() -> str:
+    return f"python-urllib3/{__version__}"
+
+
+class DummyConnection:
     """Used to detect a failed ConnectionCls import."""
 
-    pass
-
 
 if not ssl:
-    HTTPSConnection = DummyConnection  # noqa: F811
+    HTTPSConnection = DummyConnection  # type: ignore[misc, assignment] # noqa: F811
 
 
 VerifiedHTTPSConnection = HTTPSConnection
+
+
+def _url_from_connection(
+    conn: HTTPConnection | HTTPSConnection, path: str | None = None
+) -> str:
+    """Returns the URL from a given connection. This is mainly used for testing and logging."""
+
+    scheme = "https" if isinstance(conn, HTTPSConnection) else "http"
+
+    return Url(scheme=scheme, host=conn.host, port=conn.port, path=path).url
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connectionpool.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connectionpool.py
index 0872ed7..5ed9444 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connectionpool.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/connectionpool.py
@@ -1,15 +1,18 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import errno
 import logging
-import re
-import socket
+import queue
 import sys
+import typing
 import warnings
-from socket import error as SocketError
+import weakref
 from socket import timeout as SocketTimeout
+from types import TracebackType
 
+from ._base_connection import _TYPE_BODY
 from ._collections import HTTPHeaderDict
+from ._request_methods import RequestMethods
 from .connection import (
     BaseSSLError,
     BrokenPipeError,
@@ -17,13 +20,14 @@ from .connection import (
     HTTPConnection,
     HTTPException,
     HTTPSConnection,
-    VerifiedHTTPSConnection,
-    port_by_scheme,
+    ProxyConfig,
+    _wrap_proxy_error,
 )
+from .connection import port_by_scheme as port_by_scheme
 from .exceptions import (
     ClosedPoolError,
     EmptyPoolError,
-    HeaderParsingError,
+    FullPoolError,
     HostChangedError,
     InsecureRequestWarning,
     LocationValueError,
@@ -35,38 +39,33 @@ from .exceptions import (
     SSLError,
     TimeoutError,
 )
-from .packages import six
-from .packages.six.moves import queue
-from .request import RequestMethods
-from .response import HTTPResponse
+from .response import BaseHTTPResponse
 from .util.connection import is_connection_dropped
 from .util.proxy import connection_requires_http_tunnel
-from .util.queue import LifoQueue
-from .util.request import set_file_position
-from .util.response import assert_header_parsing
+from .util.request import _TYPE_BODY_POSITION, set_file_position
 from .util.retry import Retry
 from .util.ssl_match_hostname import CertificateError
-from .util.timeout import Timeout
+from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_DEFAULT, Timeout
 from .util.url import Url, _encode_target
 from .util.url import _normalize_host as normalize_host
-from .util.url import get_host, parse_url
+from .util.url import parse_url
+from .util.util import to_str
 
-try:  # Platform-specific: Python 3
-    import weakref
+if typing.TYPE_CHECKING:
+    import ssl
 
-    weakref_finalize = weakref.finalize
-except AttributeError:  # Platform-specific: Python 2
-    from .packages.backports.weakref_finalize import weakref_finalize
+    from typing_extensions import Self
 
-xrange = six.moves.xrange
+    from ._base_connection import BaseHTTPConnection, BaseHTTPSConnection
 
 log = logging.getLogger(__name__)
 
-_Default = object()
+_TYPE_TIMEOUT = typing.Union[Timeout, float, _TYPE_DEFAULT, None]
+_DEFAULT_QUEUE_CLASS = queue.LifoQueue
 
 
 # Pool objects
-class ConnectionPool(object):
+class ConnectionPool:
     """
     Base class for all connection pools, such as
     :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
@@ -77,33 +76,47 @@ class ConnectionPool(object):
        target URIs.
     """
 
-    scheme = None
-    QueueCls = LifoQueue
+    scheme: str | None = None
+    QueueCls = _DEFAULT_QUEUE_CLASS
 
-    def __init__(self, host, port=None):
+    def __init__(self, host: str, port: int | None = None) -> None:
         if not host:
             raise LocationValueError("No host specified.")
 
         self.host = _normalize_host(host, scheme=self.scheme)
-        self._proxy_host = host.lower()
         self.port = port
 
-    def __str__(self):
-        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)
+        # This property uses 'normalize_host()' (not '_normalize_host()')
+        # to avoid removing square braces around IPv6 addresses.
+        # This value is sent to `HTTPConnection.set_tunnel()` if called
+        # because square braces are required for HTTP CONNECT tunneling.
+        self._tunnel_host = normalize_host(host, scheme=self.scheme).lower()
 
-    def __enter__(self):
+    def __str__(self) -> str:
+        return f"{type(self).__name__}(host={self.host!r}, port={self.port!r})"
+
+    def __enter__(self) -> Self:
         return self
 
-    def __exit__(self, exc_type, exc_val, exc_tb):
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> typing.Literal[False]:
         self.close()
         # Return False to re-raise any potential exceptions
         return False
 
-    def close(self):
+    def close(self) -> None:
         """
         Close all pooled connections and disable the pool.
         """
-        pass
+
+    def _new_pool_queue(self, maxsize: int) -> queue.LifoQueue[typing.Any]:
+        if self.QueueCls is _DEFAULT_QUEUE_CLASS:
+            return queue.LifoQueue(maxsize)
+        return self.QueueCls(maxsize)
 
 
 # This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252
@@ -122,14 +135,6 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         Port used for this HTTP Connection (None is equivalent to 80), passed
         into :class:`http.client.HTTPConnection`.
 
-    :param strict:
-        Causes BadStatusLine to be raised if the status line can't be parsed
-        as a valid HTTP/1.0 or 1.1 status line, passed into
-        :class:`http.client.HTTPConnection`.
-
-        .. note::
-           Only works in Python 2. This parameter is ignored in Python 3.
-
     :param timeout:
         Socket timeout in seconds for each individual connection. This can
         be a float or integer, which sets the timeout for the HTTP request,
@@ -171,29 +176,25 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
     """
 
     scheme = "http"
-    ConnectionCls = HTTPConnection
-    ResponseCls = HTTPResponse
+    ConnectionCls: type[BaseHTTPConnection] | type[BaseHTTPSConnection] = HTTPConnection
 
     def __init__(
         self,
-        host,
-        port=None,
-        strict=False,
-        timeout=Timeout.DEFAULT_TIMEOUT,
-        maxsize=1,
-        block=False,
-        headers=None,
-        retries=None,
-        _proxy=None,
-        _proxy_headers=None,
-        _proxy_config=None,
-        **conn_kw
+        host: str,
+        port: int | None = None,
+        timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT,
+        maxsize: int = 1,
+        block: bool = False,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | bool | int | None = None,
+        _proxy: Url | None = None,
+        _proxy_headers: typing.Mapping[str, str] | None = None,
+        _proxy_config: ProxyConfig | None = None,
+        **conn_kw: typing.Any,
     ):
         ConnectionPool.__init__(self, host, port)
         RequestMethods.__init__(self, headers)
 
-        self.strict = strict
-
         if not isinstance(timeout, Timeout):
             timeout = Timeout.from_float(timeout)
 
@@ -203,7 +204,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         self.timeout = timeout
         self.retries = retries
 
-        self.pool = self.QueueCls(maxsize)
+        self.pool: queue.LifoQueue[typing.Any] | None = self._new_pool_queue(maxsize)
         self.block = block
 
         self.proxy = _proxy
@@ -211,7 +212,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         self.proxy_config = _proxy_config
 
         # Fill the queue up so that doing get() on it will block properly
-        for _ in xrange(maxsize):
+        for _ in range(maxsize):
             self.pool.put(None)
 
         # These are mostly for testing and debugging purposes.
@@ -221,8 +222,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         if self.proxy:
             # Enable Nagle's algorithm for proxies, to avoid packet fragmentation.
-            # We cannot know if the user has added default socket options, so we cannot replace the
-            # list.
+            # Defaulting `socket_options` to an empty list avoids it defaulting to
+            # ``HTTPConnection.default_socket_options``.
             self.conn_kw.setdefault("socket_options", [])
 
             self.conn_kw["proxy"] = self.proxy
@@ -236,9 +237,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         # Close all the HTTPConnections in the pool before the
         # HTTPConnectionPool object is garbage collected.
-        weakref_finalize(self, _close_pool_connections, pool)
+        weakref.finalize(self, _close_pool_connections, pool)
 
-    def _new_conn(self):
+    def _new_conn(self) -> BaseHTTPConnection:
         """
         Return a fresh :class:`HTTPConnection`.
         """
@@ -254,12 +255,11 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             host=self.host,
             port=self.port,
             timeout=self.timeout.connect_timeout,
-            strict=self.strict,
-            **self.conn_kw
+            **self.conn_kw,
         )
         return conn
 
-    def _get_conn(self, timeout=None):
+    def _get_conn(self, timeout: float | None = None) -> BaseHTTPConnection:
         """
         Get a connection. Will return a pooled connection if one is available.
 
@@ -272,33 +272,32 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             :prop:`.block` is ``True``.
         """
         conn = None
+
+        if self.pool is None:
+            raise ClosedPoolError(self, "Pool is closed.")
+
         try:
             conn = self.pool.get(block=self.block, timeout=timeout)
 
         except AttributeError:  # self.pool is None
-            raise ClosedPoolError(self, "Pool is closed.")
+            raise ClosedPoolError(self, "Pool is closed.") from None  # Defensive:
 
         except queue.Empty:
             if self.block:
                 raise EmptyPoolError(
                     self,
-                    "Pool reached maximum size and no more connections are allowed.",
-                )
+                    "Pool is empty and a new connection can't be opened due to blocking mode.",
+                ) from None
             pass  # Oh well, we'll create a new connection then
 
         # If this is a persistent connection, check if it got disconnected
         if conn and is_connection_dropped(conn):
             log.debug("Resetting dropped connection: %s", self.host)
             conn.close()
-            if getattr(conn, "auto_open", 1) == 0:
-                # This is a proxied connection that has been mutated by
-                # http.client._tunnel() and cannot be reused (since it would
-                # attempt to bypass the proxy)
-                conn = None
 
         return conn or self._new_conn()
 
-    def _put_conn(self, conn):
+    def _put_conn(self, conn: BaseHTTPConnection | None) -> None:
         """
         Put a connection back into the pool.
 
@@ -312,36 +311,47 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         If the pool is closed, then the connection will be closed and discarded.
         """
-        try:
-            self.pool.put(conn, block=False)
-            return  # Everything is dandy, done.
-        except AttributeError:
-            # self.pool is None.
-            pass
-        except queue.Full:
-            # This should never happen if self.block == True
-            log.warning(
-                "Connection pool is full, discarding connection: %s. Connection pool size: %s",
-                self.host,
-                self.pool.qsize(),
-            )
+        if self.pool is not None:
+            try:
+                self.pool.put(conn, block=False)
+                return  # Everything is dandy, done.
+            except AttributeError:
+                # self.pool is None.
+                pass
+            except queue.Full:
+                # Connection never got put back into the pool, close it.
+                if conn:
+                    conn.close()
+
+                if self.block:
+                    # This should never happen if you got the conn from self._get_conn
+                    raise FullPoolError(
+                        self,
+                        "Pool reached maximum size and no more connections are allowed.",
+                    ) from None
+
+                log.warning(
+                    "Connection pool is full, discarding connection: %s. Connection pool size: %s",
+                    self.host,
+                    self.pool.qsize(),
+                )
+
         # Connection never got put back into the pool, close it.
         if conn:
             conn.close()
 
-    def _validate_conn(self, conn):
+    def _validate_conn(self, conn: BaseHTTPConnection) -> None:
         """
         Called right before a request is made, after the socket is created.
         """
-        pass
 
-    def _prepare_proxy(self, conn):
+    def _prepare_proxy(self, conn: BaseHTTPConnection) -> None:
         # Nothing to do for HTTP connections.
         pass
 
-    def _get_timeout(self, timeout):
+    def _get_timeout(self, timeout: _TYPE_TIMEOUT) -> Timeout:
         """Helper that always returns a :class:`urllib3.util.Timeout`"""
-        if timeout is _Default:
+        if timeout is _DEFAULT_TIMEOUT:
             return self.timeout.clone()
 
         if isinstance(timeout, Timeout):
@@ -351,34 +361,40 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             # can be removed later
             return Timeout.from_float(timeout)
 
-    def _raise_timeout(self, err, url, timeout_value):
+    def _raise_timeout(
+        self,
+        err: BaseSSLError | OSError | SocketTimeout,
+        url: str,
+        timeout_value: _TYPE_TIMEOUT | None,
+    ) -> None:
         """Is the error actually a timeout? Will raise a ReadTimeout or pass"""
 
         if isinstance(err, SocketTimeout):
             raise ReadTimeoutError(
-                self, url, "Read timed out. (read timeout=%s)" % timeout_value
-            )
+                self, url, f"Read timed out. (read timeout={timeout_value})"
+            ) from err
 
-        # See the above comment about EAGAIN in Python 3. In Python 2 we have
-        # to specifically catch it and throw the timeout error
+        # See the above comment about EAGAIN in Python 3.
         if hasattr(err, "errno") and err.errno in _blocking_errnos:
             raise ReadTimeoutError(
-                self, url, "Read timed out. (read timeout=%s)" % timeout_value
-            )
-
-        # Catch possible read timeouts thrown as SSL errors. If not the
-        # case, rethrow the original. We need to do this because of:
-        # http://bugs.python.org/issue10272
-        if "timed out" in str(err) or "did not complete (read)" in str(
-            err
-        ):  # Python < 2.7.4
-            raise ReadTimeoutError(
-                self, url, "Read timed out. (read timeout=%s)" % timeout_value
-            )
+                self, url, f"Read timed out. (read timeout={timeout_value})"
+            ) from err
 
     def _make_request(
-        self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw
-    ):
+        self,
+        conn: BaseHTTPConnection,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | None = None,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        chunked: bool = False,
+        response_conn: BaseHTTPConnection | None = None,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        enforce_content_length: bool = True,
+    ) -> BaseHTTPResponse:
         """
         Perform a request on a given urllib connection object taken from our
         pool.
@@ -386,185 +402,6 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         :param conn:
             a connection from one of our connection pools
 
-        :param timeout:
-            Socket timeout in seconds for the request. This can be a
-            float or integer, which will set the same timeout value for
-            the socket connect and the socket read, or an instance of
-            :class:`urllib3.util.Timeout`, which gives you more fine-grained
-            control over your timeouts.
-        """
-        self.num_requests += 1
-
-        timeout_obj = self._get_timeout(timeout)
-        timeout_obj.start_connect()
-        conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout)
-
-        # Trigger any extra validation we need to do.
-        try:
-            self._validate_conn(conn)
-        except (SocketTimeout, BaseSSLError) as e:
-            # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout.
-            self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
-            raise
-
-        # conn.request() calls http.client.*.request, not the method in
-        # urllib3.request. It also calls makefile (recv) on the socket.
-        try:
-            if chunked:
-                conn.request_chunked(method, url, **httplib_request_kw)
-            else:
-                conn.request(method, url, **httplib_request_kw)
-
-        # We are swallowing BrokenPipeError (errno.EPIPE) since the server is
-        # legitimately able to close the connection after sending a valid response.
-        # With this behaviour, the received response is still readable.
-        except BrokenPipeError:
-            # Python 3
-            pass
-        except IOError as e:
-            # Python 2 and macOS/Linux
-            # EPIPE and ESHUTDOWN are BrokenPipeError on Python 2, and EPROTOTYPE/ECONNRESET are needed on macOS
-            # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/
-            if e.errno not in {
-                errno.EPIPE,
-                errno.ESHUTDOWN,
-                errno.EPROTOTYPE,
-                errno.ECONNRESET,
-            }:
-                raise
-
-        # Reset the timeout for the recv() on the socket
-        read_timeout = timeout_obj.read_timeout
-
-        # App Engine doesn't have a sock attr
-        if getattr(conn, "sock", None):
-            # In Python 3 socket.py will catch EAGAIN and return None when you
-            # try and read into the file pointer created by http.client, which
-            # instead raises a BadStatusLine exception. Instead of catching
-            # the exception and assuming all BadStatusLine exceptions are read
-            # timeouts, check for a zero timeout before making the request.
-            if read_timeout == 0:
-                raise ReadTimeoutError(
-                    self, url, "Read timed out. (read timeout=%s)" % read_timeout
-                )
-            if read_timeout is Timeout.DEFAULT_TIMEOUT:
-                conn.sock.settimeout(socket.getdefaulttimeout())
-            else:  # None or a value
-                conn.sock.settimeout(read_timeout)
-
-        # Receive the response from the server
-        try:
-            try:
-                # Python 2.7, use buffering of HTTP responses
-                httplib_response = conn.getresponse(buffering=True)
-            except TypeError:
-                # Python 3
-                try:
-                    httplib_response = conn.getresponse()
-                except BaseException as e:
-                    # Remove the TypeError from the exception chain in
-                    # Python 3 (including for exceptions like SystemExit).
-                    # Otherwise it looks like a bug in the code.
-                    six.raise_from(e, None)
-        except (SocketTimeout, BaseSSLError, SocketError) as e:
-            self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
-            raise
-
-        # AppEngine doesn't have a version attr.
-        http_version = getattr(conn, "_http_vsn_str", "HTTP/?")
-        log.debug(
-            '%s://%s:%s "%s %s %s" %s %s',
-            self.scheme,
-            self.host,
-            self.port,
-            method,
-            url,
-            http_version,
-            httplib_response.status,
-            httplib_response.length,
-        )
-
-        try:
-            assert_header_parsing(httplib_response.msg)
-        except (HeaderParsingError, TypeError) as hpe:  # Platform-specific: Python 3
-            log.warning(
-                "Failed to parse headers (url=%s): %s",
-                self._absolute_url(url),
-                hpe,
-                exc_info=True,
-            )
-
-        return httplib_response
-
-    def _absolute_url(self, path):
-        return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url
-
-    def close(self):
-        """
-        Close all pooled connections and disable the pool.
-        """
-        if self.pool is None:
-            return
-        # Disable access to the pool
-        old_pool, self.pool = self.pool, None
-
-        # Close all the HTTPConnections in the pool.
-        _close_pool_connections(old_pool)
-
-    def is_same_host(self, url):
-        """
-        Check if the given ``url`` is a member of the same host as this
-        connection pool.
-        """
-        if url.startswith("/"):
-            return True
-
-        # TODO: Add optional support for socket.gethostbyname checking.
-        scheme, host, port = get_host(url)
-        if host is not None:
-            host = _normalize_host(host, scheme=scheme)
-
-        # Use explicit default port for comparison when none is given
-        if self.port and not port:
-            port = port_by_scheme.get(scheme)
-        elif not self.port and port == port_by_scheme.get(scheme):
-            port = None
-
-        return (scheme, host, port) == (self.scheme, self.host, self.port)
-
-    def urlopen(
-        self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        retries=None,
-        redirect=True,
-        assert_same_host=True,
-        timeout=_Default,
-        pool_timeout=None,
-        release_conn=None,
-        chunked=False,
-        body_pos=None,
-        **response_kw
-    ):
-        """
-        Get a connection from the pool and perform an HTTP request. This is the
-        lowest level call for making a request, so you'll need to specify all
-        the raw details.
-
-        .. note::
-
-           More commonly, it's appropriate to use a convenience method provided
-           by :class:`.RequestMethods`, such as :meth:`request`.
-
-        .. note::
-
-           `release_conn` will only behave as expected if
-           `preload_content=False` because we want to make
-           `preload_content=False` the default behaviour someday soon without
-           breaking backwards compatibility.
-
         :param method:
             HTTP request method (such as GET, POST, PUT, etc.)
 
@@ -596,6 +433,234 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
 
+        :param timeout:
+            If specified, overrides the default timeout for this one
+            request. It may be a float (in seconds) or an instance of
+            :class:`urllib3.util.Timeout`.
+
+        :param chunked:
+            If True, urllib3 will send the body using chunked transfer
+            encoding. Otherwise, urllib3 will send the body using the standard
+            content-length form. Defaults to False.
+
+        :param response_conn:
+            Set this to ``None`` if you will handle releasing the connection or
+            set the connection to have the response release it.
+
+        :param preload_content:
+          If True, the response's body will be preloaded during construction.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
+        :param enforce_content_length:
+            Enforce content length checking. Body returned by server must match
+            value of Content-Length header, if present. Otherwise, raise error.
+        """
+        self.num_requests += 1
+
+        timeout_obj = self._get_timeout(timeout)
+        timeout_obj.start_connect()
+        conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout)
+
+        try:
+            # Trigger any extra validation we need to do.
+            try:
+                self._validate_conn(conn)
+            except (SocketTimeout, BaseSSLError) as e:
+                self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
+                raise
+
+        # _validate_conn() starts the connection to an HTTPS proxy
+        # so we need to wrap errors with 'ProxyError' here too.
+        except (
+            OSError,
+            NewConnectionError,
+            TimeoutError,
+            BaseSSLError,
+            CertificateError,
+            SSLError,
+        ) as e:
+            new_e: Exception = e
+            if isinstance(e, (BaseSSLError, CertificateError)):
+                new_e = SSLError(e)
+            # If the connection didn't successfully connect to it's proxy
+            # then there
+            if isinstance(
+                new_e, (OSError, NewConnectionError, TimeoutError, SSLError)
+            ) and (conn and conn.proxy and not conn.has_connected_to_proxy):
+                new_e = _wrap_proxy_error(new_e, conn.proxy.scheme)
+            raise new_e
+
+        # conn.request() calls http.client.*.request, not the method in
+        # urllib3.request. It also calls makefile (recv) on the socket.
+        try:
+            conn.request(
+                method,
+                url,
+                body=body,
+                headers=headers,
+                chunked=chunked,
+                preload_content=preload_content,
+                decode_content=decode_content,
+                enforce_content_length=enforce_content_length,
+            )
+
+        # We are swallowing BrokenPipeError (errno.EPIPE) since the server is
+        # legitimately able to close the connection after sending a valid response.
+        # With this behaviour, the received response is still readable.
+        except BrokenPipeError:
+            pass
+        except OSError as e:
+            # MacOS/Linux
+            # EPROTOTYPE and ECONNRESET are needed on macOS
+            # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/
+            # Condition changed later to emit ECONNRESET instead of only EPROTOTYPE.
+            if e.errno != errno.EPROTOTYPE and e.errno != errno.ECONNRESET:
+                raise
+
+        # Reset the timeout for the recv() on the socket
+        read_timeout = timeout_obj.read_timeout
+
+        if not conn.is_closed:
+            # In Python 3 socket.py will catch EAGAIN and return None when you
+            # try and read into the file pointer created by http.client, which
+            # instead raises a BadStatusLine exception. Instead of catching
+            # the exception and assuming all BadStatusLine exceptions are read
+            # timeouts, check for a zero timeout before making the request.
+            if read_timeout == 0:
+                raise ReadTimeoutError(
+                    self, url, f"Read timed out. (read timeout={read_timeout})"
+                )
+            conn.timeout = read_timeout
+
+        # Receive the response from the server
+        try:
+            response = conn.getresponse()
+        except (BaseSSLError, OSError) as e:
+            self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
+            raise
+
+        # Set properties that are used by the pooling layer.
+        response.retries = retries
+        response._connection = response_conn  # type: ignore[attr-defined]
+        response._pool = self  # type: ignore[attr-defined]
+
+        log.debug(
+            '%s://%s:%s "%s %s %s" %s %s',
+            self.scheme,
+            self.host,
+            self.port,
+            method,
+            url,
+            response.version_string,
+            response.status,
+            response.length_remaining,
+        )
+
+        return response
+
+    def close(self) -> None:
+        """
+        Close all pooled connections and disable the pool.
+        """
+        if self.pool is None:
+            return
+        # Disable access to the pool
+        old_pool, self.pool = self.pool, None
+
+        # Close all the HTTPConnections in the pool.
+        _close_pool_connections(old_pool)
+
+    def is_same_host(self, url: str) -> bool:
+        """
+        Check if the given ``url`` is a member of the same host as this
+        connection pool.
+        """
+        if url.startswith("/"):
+            return True
+
+        # TODO: Add optional support for socket.gethostbyname checking.
+        scheme, _, host, port, *_ = parse_url(url)
+        scheme = scheme or "http"
+        if host is not None:
+            host = _normalize_host(host, scheme=scheme)
+
+        # Use explicit default port for comparison when none is given
+        if self.port is not None and port is None:
+            port = port_by_scheme.get(scheme)
+        elif self.port is None and port == port_by_scheme.get(scheme):
+            port = None
+
+        return (scheme, host, port) == (self.scheme, self.host, self.port)
+
+    def urlopen(  # type: ignore[override]
+        self,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | bool | int | None = None,
+        redirect: bool = True,
+        assert_same_host: bool = True,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        pool_timeout: int | None = None,
+        release_conn: bool | None = None,
+        chunked: bool = False,
+        body_pos: _TYPE_BODY_POSITION | None = None,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        **response_kw: typing.Any,
+    ) -> BaseHTTPResponse:
+        """
+        Get a connection from the pool and perform an HTTP request. This is the
+        lowest level call for making a request, so you'll need to specify all
+        the raw details.
+
+        .. note::
+
+           More commonly, it's appropriate to use a convenience method
+           such as :meth:`request`.
+
+        .. note::
+
+           `release_conn` will only behave as expected if
+           `preload_content=False` because we want to make
+           `preload_content=False` the default behaviour someday soon without
+           breaking backwards compatibility.
+
+        :param method:
+            HTTP request method (such as GET, POST, PUT, etc.)
+
+        :param url:
+            The URL to perform the request on.
+
+        :param body:
+            Data to send in the request body, either :class:`str`, :class:`bytes`,
+            an iterable of :class:`str`/:class:`bytes`, or a file-like object.
+
+        :param headers:
+            Dictionary of custom headers to send, such as User-Agent,
+            If-None-Match, etc. If None, pool headers are used. If provided,
+            these headers completely replace any pool-specific headers.
+
+        :param retries:
+            Configure the number of retries to allow before raising a
+            :class:`~urllib3.exceptions.MaxRetryError` exception.
+
+            If ``None`` (default) will retry 3 times, see ``Retry.DEFAULT``. Pass a
+            :class:`~urllib3.util.retry.Retry` object for fine-grained control
+            over different types of retries.
+            Pass an integer number to retry connection errors that many times,
+            but no other types of errors. Pass zero to never retry.
+
+            If ``False``, then retries are disabled and any exception is raised
+            immediately. Also, instead of raising a MaxRetryError on redirects,
+            the redirect response will be returned.
+
+        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
+
         :param redirect:
             If True, automatically handle redirects (status codes 301, 302,
             303, 307, 308). Each redirect counts as a retry. Disabling retries
@@ -616,6 +681,13 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             block for ``pool_timeout`` seconds and raise EmptyPoolError if no
             connection is available within the time period.
 
+        :param bool preload_content:
+            If True, the response's body will be preloaded into memory.
+
+        :param bool decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
         :param release_conn:
             If False, then the urlopen call will not release the connection
             back into the pool once a response is received (but will release if
@@ -623,10 +695,10 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             `preload_content=True`). This is useful if you're not preloading
             the response's content immediately. You will need to call
             ``r.release_conn()`` on the response ``r`` to return the connection
-            back into the pool. If None, it takes the value of
-            ``response_kw.get('preload_content', True)``.
+            back into the pool. If None, it takes the value of ``preload_content``
+            which defaults to ``True``.
 
-        :param chunked:
+        :param bool chunked:
             If True, urllib3 will send the body using chunked transfer
             encoding. Otherwise, urllib3 will send the body using the standard
             content-length form. Defaults to False.
@@ -635,14 +707,16 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             Position to seek to in file-like body in the event of a retry or
             redirect. Typically this won't need to be set because urllib3 will
             auto-populate the value when needed.
-
-        :param \\**response_kw:
-            Additional parameters are passed to
-            :meth:`urllib3.response.HTTPResponse.from_httplib`
         """
-
-        parsed_url = parse_url(url)
-        destination_scheme = parsed_url.scheme
+        # Ensure that the URL we're connecting to is properly encoded
+        if url.startswith("/"):
+            # URLs starting with / are inherently schemeless.
+            url = to_str(_encode_target(url))
+            destination_scheme = None
+        else:
+            parsed_url = parse_url(url)
+            destination_scheme = parsed_url.scheme
+            url = to_str(parsed_url._replace(fragment=None).url)
 
         if headers is None:
             headers = self.headers
@@ -651,18 +725,12 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
 
         if release_conn is None:
-            release_conn = response_kw.get("preload_content", True)
+            release_conn = preload_content
 
         # Check host
         if assert_same_host and not self.is_same_host(url):
             raise HostChangedError(self, url, retries)
 
-        # Ensure that the URL we're connecting to is properly encoded
-        if url.startswith("/"):
-            url = six.ensure_str(_encode_target(url))
-        else:
-            url = six.ensure_str(parsed_url.url)
-
         conn = None
 
         # Track whether `conn` needs to be released before
@@ -684,8 +752,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         # have to copy the headers dict so we can safely change it without those
         # changes being reflected in anyone else's copy.
         if not http_tunnel_required:
-            headers = headers.copy()
-            headers.update(self.proxy_headers)
+            headers = headers.copy()  # type: ignore[attr-defined]
+            headers.update(self.proxy_headers)  # type: ignore[union-attr]
 
         # Must keep the exception bound to a separate variable or else Python 3
         # complains about UnboundLocalError.
@@ -699,29 +767,21 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         # for future rewinds in the event of a redirect/retry.
         body_pos = set_file_position(body, body_pos)
 
+        timeout_obj = self._get_timeout(timeout)
         try:
             # Request a connection from the queue.
-            timeout_obj = self._get_timeout(timeout)
             conn = self._get_conn(timeout=pool_timeout)
+            conn.timeout = timeout_obj.connect_timeout  # type: ignore[assignment]
 
-            conn.timeout = timeout_obj.connect_timeout
-
-            is_new_proxy_conn = self.proxy is not None and not getattr(
-                conn, "sock", None
-            )
-            if is_new_proxy_conn and http_tunnel_required:
-                self._prepare_proxy(conn)
-
-            # Make the request on the httplib connection object.
-            httplib_response = self._make_request(
-                conn,
-                method,
-                url,
-                timeout=timeout_obj,
-                body=body,
-                headers=headers,
-                chunked=chunked,
-            )
+            # Is this a closed/new connection that requires CONNECT tunnelling?
+            if self.proxy is not None and http_tunnel_required and conn.is_closed:
+                try:
+                    self._prepare_proxy(conn)
+                except (BaseSSLError, OSError, SocketTimeout) as e:
+                    self._raise_timeout(
+                        err=e, url=self.proxy.url, timeout_value=conn.timeout
+                    )
+                    raise
 
             # If we're going to release the connection in ``finally:``, then
             # the response doesn't need to know about the connection. Otherwise
@@ -729,16 +789,20 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             # mess.
             response_conn = conn if not release_conn else None
 
-            # Pass method to Response for length checking
-            response_kw["request_method"] = method
-
-            # Import httplib's response into our own wrapper object
-            response = self.ResponseCls.from_httplib(
-                httplib_response,
-                pool=self,
-                connection=response_conn,
+            # Make the request on the HTTPConnection object
+            response = self._make_request(
+                conn,
+                method,
+                url,
+                timeout=timeout_obj,
+                body=body,
+                headers=headers,
+                chunked=chunked,
                 retries=retries,
-                **response_kw
+                response_conn=response_conn,
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
             # Everything went great!
@@ -753,54 +817,35 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         except (
             TimeoutError,
             HTTPException,
-            SocketError,
+            OSError,
             ProtocolError,
             BaseSSLError,
             SSLError,
             CertificateError,
+            ProxyError,
         ) as e:
             # Discard the connection for these exceptions. It will be
             # replaced during the next _get_conn() call.
             clean_exit = False
-
-            def _is_ssl_error_message_from_http_proxy(ssl_error):
-                # We're trying to detect the message 'WRONG_VERSION_NUMBER' but
-                # SSLErrors are kinda all over the place when it comes to the message,
-                # so we try to cover our bases here!
-                message = " ".join(re.split("[^a-z]", str(ssl_error).lower()))
-                return (
-                    "wrong version number" in message
-                    or "unknown protocol" in message
-                    or "record layer failure" in message
-                )
-
-            # Try to detect a common user error with proxies which is to
-            # set an HTTP proxy to be HTTPS when it should be 'http://'
-            # (ie {'http': 'http://proxy', 'https': 'https://proxy'})
-            # Instead we add a nice error message and point to a URL.
-            if (
-                isinstance(e, BaseSSLError)
-                and self.proxy
-                and _is_ssl_error_message_from_http_proxy(e)
-                and conn.proxy
-                and conn.proxy.scheme == "https"
-            ):
-                e = ProxyError(
-                    "Your proxy appears to only use HTTP and not HTTPS, "
-                    "try changing your proxy URL to be HTTP. See: "
-                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                    "#https-proxy-error-http-proxy",
-                    SSLError(e),
-                )
-            elif isinstance(e, (BaseSSLError, CertificateError)):
-                e = SSLError(e)
-            elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy:
-                e = ProxyError("Cannot connect to proxy.", e)
-            elif isinstance(e, (SocketError, HTTPException)):
-                e = ProtocolError("Connection aborted.", e)
+            new_e: Exception = e
+            if isinstance(e, (BaseSSLError, CertificateError)):
+                new_e = SSLError(e)
+            if isinstance(
+                new_e,
+                (
+                    OSError,
+                    NewConnectionError,
+                    TimeoutError,
+                    SSLError,
+                    HTTPException,
+                ),
+            ) and (conn and conn.proxy and not conn.has_connected_to_proxy):
+                new_e = _wrap_proxy_error(new_e, conn.proxy.scheme)
+            elif isinstance(new_e, (OSError, HTTPException)):
+                new_e = ProtocolError("Connection aborted.", new_e)
 
             retries = retries.increment(
-                method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2]
+                method, url, error=new_e, _pool=self, _stacktrace=sys.exc_info()[2]
             )
             retries.sleep()
 
@@ -813,7 +858,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 # to throw the connection away unless explicitly told not to.
                 # Close the connection, set the variable to None, and make sure
                 # we put the None back in the pool to avoid leaking it.
-                conn = conn and conn.close()
+                if conn:
+                    conn.close()
+                    conn = None
                 release_this_conn = True
 
             if release_this_conn:
@@ -825,7 +872,16 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         if not conn:
             # Try again
             log.warning(
-                "Retrying (%r) after connection broken by '%r': %s", retries, err, url
+                "Retrying (%r) after connection broken by '%r': %s",
+                retries,
+                err,
+                url,
+                # Provide an unique attribute with the host needed by pip to
+                # rewrite this warning. Ideally, we'd go with a better solution,
+                # but backwards compatibility and other constraints make those
+                # unfeasible, so this is the least bad option.
+                # See also: https://github.com/urllib3/urllib3/issues/2580.
+                extra={"__urllib3-retry-warning": {"host": self.host}},
             )
             return self.urlopen(
                 method,
@@ -840,7 +896,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                **response_kw
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
         # Handle redirect?
@@ -851,8 +909,25 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 method = "GET"
                 # And lose the body not to transfer anything sensitive.
                 body = None
+                # The body is gone, so the state that describes it has to go
+                # too: there is nothing left to frame with chunked transfer
+                # encoding, and nothing left to rewind.
+                chunked = False
+                body_pos = None
                 headers = HTTPHeaderDict(headers)._prepare_for_method_change()
 
+            # Strip headers marked as unsafe to forward to the redirected location.
+            # Check remove_headers_on_redirect to avoid a potential network call within
+            # self.is_same_host() which may use socket.gethostbyname() in the future.
+            if retries.remove_headers_on_redirect and not self.is_same_host(
+                redirect_location
+            ):
+                new_headers = headers.copy()  # type: ignore[union-attr]
+                for header in headers:
+                    if header.lower() in retries.remove_headers_on_redirect:
+                        new_headers.pop(header, None)
+                headers = new_headers
+
             try:
                 retries = retries.increment(method, url, response=response, _pool=self)
             except MaxRetryError:
@@ -877,7 +952,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                **response_kw
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
         # Check if we should retry the HTTP response.
@@ -907,7 +984,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                **response_kw
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
         return response
@@ -928,37 +1007,35 @@ class HTTPSConnectionPool(HTTPConnectionPool):
     """
 
     scheme = "https"
-    ConnectionCls = HTTPSConnection
+    ConnectionCls: type[BaseHTTPSConnection] = HTTPSConnection
 
     def __init__(
         self,
-        host,
-        port=None,
-        strict=False,
-        timeout=Timeout.DEFAULT_TIMEOUT,
-        maxsize=1,
-        block=False,
-        headers=None,
-        retries=None,
-        _proxy=None,
-        _proxy_headers=None,
-        key_file=None,
-        cert_file=None,
-        cert_reqs=None,
-        key_password=None,
-        ca_certs=None,
-        ssl_version=None,
-        assert_hostname=None,
-        assert_fingerprint=None,
-        ca_cert_dir=None,
-        **conn_kw
-    ):
-
-        HTTPConnectionPool.__init__(
-            self,
+        host: str,
+        port: int | None = None,
+        timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT,
+        maxsize: int = 1,
+        block: bool = False,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | bool | int | None = None,
+        _proxy: Url | None = None,
+        _proxy_headers: typing.Mapping[str, str] | None = None,
+        key_file: str | None = None,
+        cert_file: str | None = None,
+        cert_reqs: int | str | None = None,
+        key_password: str | None = None,
+        ca_certs: str | None = None,
+        ssl_version: int | str | None = None,
+        ssl_minimum_version: ssl.TLSVersion | None = None,
+        ssl_maximum_version: ssl.TLSVersion | None = None,
+        assert_hostname: str | typing.Literal[False] | None = None,
+        assert_fingerprint: str | None = None,
+        ca_cert_dir: str | None = None,
+        **conn_kw: typing.Any,
+    ) -> None:
+        super().__init__(
             host,
             port,
-            strict,
             timeout,
             maxsize,
             block,
@@ -966,7 +1043,7 @@ class HTTPSConnectionPool(HTTPConnectionPool):
             retries,
             _proxy,
             _proxy_headers,
-            **conn_kw
+            **conn_kw,
         )
 
         self.key_file = key_file
@@ -976,47 +1053,29 @@ class HTTPSConnectionPool(HTTPConnectionPool):
         self.ca_certs = ca_certs
         self.ca_cert_dir = ca_cert_dir
         self.ssl_version = ssl_version
+        self.ssl_minimum_version = ssl_minimum_version
+        self.ssl_maximum_version = ssl_maximum_version
         self.assert_hostname = assert_hostname
         self.assert_fingerprint = assert_fingerprint
 
-    def _prepare_conn(self, conn):
-        """
-        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
-        and establish the tunnel if proxy is used.
-        """
-
-        if isinstance(conn, VerifiedHTTPSConnection):
-            conn.set_cert(
-                key_file=self.key_file,
-                key_password=self.key_password,
-                cert_file=self.cert_file,
-                cert_reqs=self.cert_reqs,
-                ca_certs=self.ca_certs,
-                ca_cert_dir=self.ca_cert_dir,
-                assert_hostname=self.assert_hostname,
-                assert_fingerprint=self.assert_fingerprint,
-            )
-            conn.ssl_version = self.ssl_version
-        return conn
-
-    def _prepare_proxy(self, conn):
-        """
-        Establishes a tunnel connection through HTTP CONNECT.
-
-        Tunnel connection is established early because otherwise httplib would
-        improperly set Host: header to proxy's IP:port.
-        """
-
-        conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers)
-
-        if self.proxy.scheme == "https":
-            conn.tls_in_tls_required = True
+    def _prepare_proxy(self, conn: HTTPSConnection) -> None:  # type: ignore[override]
+        """Establishes a tunnel connection through HTTP CONNECT."""
+        if self.proxy and self.proxy.scheme == "https":
+            tunnel_scheme = "https"
+        else:
+            tunnel_scheme = "http"
 
+        conn.set_tunnel(
+            scheme=tunnel_scheme,
+            host=self._tunnel_host,
+            port=self.port,
+            headers=self.proxy_headers,
+        )
         conn.connect()
 
-    def _new_conn(self):
+    def _new_conn(self) -> BaseHTTPSConnection:
         """
-        Return a fresh :class:`http.client.HTTPSConnection`.
+        Return a fresh :class:`urllib3.connection.HTTPConnection`.
         """
         self.num_connections += 1
         log.debug(
@@ -1026,64 +1085,59 @@ class HTTPSConnectionPool(HTTPConnectionPool):
             self.port or "443",
         )
 
-        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:
-            raise SSLError(
+        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:  # type: ignore[comparison-overlap]
+            raise ImportError(
                 "Can't connect to HTTPS URL because the SSL module is not available."
             )
 
-        actual_host = self.host
+        actual_host: str = self.host
         actual_port = self.port
-        if self.proxy is not None:
+        if self.proxy is not None and self.proxy.host is not None:
             actual_host = self.proxy.host
             actual_port = self.proxy.port
 
-        conn = self.ConnectionCls(
+        return self.ConnectionCls(
             host=actual_host,
             port=actual_port,
             timeout=self.timeout.connect_timeout,
-            strict=self.strict,
             cert_file=self.cert_file,
             key_file=self.key_file,
             key_password=self.key_password,
-            **self.conn_kw
+            cert_reqs=self.cert_reqs,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            assert_hostname=self.assert_hostname,
+            assert_fingerprint=self.assert_fingerprint,
+            ssl_version=self.ssl_version,
+            ssl_minimum_version=self.ssl_minimum_version,
+            ssl_maximum_version=self.ssl_maximum_version,
+            **self.conn_kw,
         )
 
-        return self._prepare_conn(conn)
-
-    def _validate_conn(self, conn):
+    def _validate_conn(self, conn: BaseHTTPConnection) -> None:
         """
         Called right before a request is made, after the socket is created.
         """
-        super(HTTPSConnectionPool, self)._validate_conn(conn)
+        super()._validate_conn(conn)
 
         # Force connect early to allow us to validate the connection.
-        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
+        if conn.is_closed:
             conn.connect()
 
-        if not conn.is_verified:
+        # TODO revise this, see https://github.com/urllib3/urllib3/issues/2791
+        if not conn.is_verified and not conn.proxy_is_verified:
             warnings.warn(
                 (
-                    "Unverified HTTPS request is being made to host '%s'. "
+                    f"Unverified HTTPS request is being made to host '{conn.host}'. "
                     "Adding certificate verification is strongly advised. See: "
-                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                    "#ssl-warnings" % conn.host
-                ),
-                InsecureRequestWarning,
-            )
-
-        if getattr(conn, "proxy_is_verified", None) is False:
-            warnings.warn(
-                (
-                    "Unverified HTTPS connection done to an HTTPS proxy. "
-                    "Adding certificate verification is strongly advised. See: "
-                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                    "#ssl-warnings"
+                    "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
+                    "#tls-warnings"
                 ),
                 InsecureRequestWarning,
             )
 
 
-def connection_from_url(url, **kw):
+def connection_from_url(url: str, **kw: typing.Any) -> HTTPConnectionPool:
     """
     Given a url, return an :class:`.ConnectionPool` instance of its host.
 
@@ -1103,15 +1157,25 @@ def connection_from_url(url, **kw):
         >>> conn = connection_from_url('http://google.com/')
         >>> r = conn.request('GET', '/')
     """
-    scheme, host, port = get_host(url)
-    port = port or port_by_scheme.get(scheme, 80)
+    scheme, _, host, port, *_ = parse_url(url)
+    scheme = scheme or "http"
+    if port is None:
+        port = port_by_scheme.get(scheme, 80)
     if scheme == "https":
-        return HTTPSConnectionPool(host, port=port, **kw)
+        return HTTPSConnectionPool(host, port=port, **kw)  # type: ignore[arg-type]
     else:
-        return HTTPConnectionPool(host, port=port, **kw)
+        return HTTPConnectionPool(host, port=port, **kw)  # type: ignore[arg-type]
 
 
-def _normalize_host(host, scheme):
+@typing.overload
+def _normalize_host(host: None, scheme: str | None) -> None: ...
+
+
+@typing.overload
+def _normalize_host(host: str, scheme: str | None) -> str: ...
+
+
+def _normalize_host(host: str | None, scheme: str | None) -> str | None:
     """
     Normalize hosts for comparisons and use with sockets.
     """
@@ -1124,12 +1188,19 @@ def _normalize_host(host, scheme):
     # Instead, we need to make sure we never pass ``None`` as the port.
     # However, for backward compatibility reasons we can't actually
     # *assert* that.  See http://bugs.python.org/issue28539
-    if host.startswith("[") and host.endswith("]"):
+    if host and host.startswith("[") and host.endswith("]"):
         host = host[1:-1]
     return host
 
 
-def _close_pool_connections(pool):
+def _url_from_pool(
+    pool: HTTPConnectionPool | HTTPSConnectionPool, path: str | None = None
+) -> str:
+    """Returns the URL from a given connection pool. This is mainly used for testing and logging."""
+    return Url(scheme=pool.scheme, host=pool.host, port=pool.port, path=path).url
+
+
+def _close_pool_connections(pool: queue.LifoQueue[typing.Any]) -> None:
     """Drains a queue of connections and closes each one."""
     try:
         while True:
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py
deleted file mode 100644
index 8765b90..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py
+++ /dev/null
@@ -1,36 +0,0 @@
-"""
-This module provides means to detect the App Engine environment.
-"""
-
-import os
-
-
-def is_appengine():
-    return is_local_appengine() or is_prod_appengine()
-
-
-def is_appengine_sandbox():
-    """Reports if the app is running in the first generation sandbox.
-
-    The second generation runtimes are technically still in a sandbox, but it
-    is much less restrictive, so generally you shouldn't need to check for it.
-    see https://cloud.google.com/appengine/docs/standard/runtimes
-    """
-    return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27"
-
-
-def is_local_appengine():
-    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
-        "SERVER_SOFTWARE", ""
-    ).startswith("Development/")
-
-
-def is_prod_appengine():
-    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
-        "SERVER_SOFTWARE", ""
-    ).startswith("Google App Engine/")
-
-
-def is_prod_appengine_mvms():
-    """Deprecated."""
-    return False
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py
deleted file mode 100644
index 264d564..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py
+++ /dev/null
@@ -1,519 +0,0 @@
-"""
-This module uses ctypes to bind a whole bunch of functions and constants from
-SecureTransport. The goal here is to provide the low-level API to
-SecureTransport. These are essentially the C-level functions and constants, and
-they're pretty gross to work with.
-
-This code is a bastardised version of the code found in Will Bond's oscrypto
-library. An enormous debt is owed to him for blazing this trail for us. For
-that reason, this code should be considered to be covered both by urllib3's
-license and by oscrypto's:
-
-    Copyright (c) 2015-2016 Will Bond 
-
-    Permission is hereby granted, free of charge, to any person obtaining a
-    copy of this software and associated documentation files (the "Software"),
-    to deal in the Software without restriction, including without limitation
-    the rights to use, copy, modify, merge, publish, distribute, sublicense,
-    and/or sell copies of the Software, and to permit persons to whom the
-    Software is furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in
-    all copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-    DEALINGS IN THE SOFTWARE.
-"""
-from __future__ import absolute_import
-
-import platform
-from ctypes import (
-    CDLL,
-    CFUNCTYPE,
-    POINTER,
-    c_bool,
-    c_byte,
-    c_char_p,
-    c_int32,
-    c_long,
-    c_size_t,
-    c_uint32,
-    c_ulong,
-    c_void_p,
-)
-from ctypes.util import find_library
-
-from ...packages.six import raise_from
-
-if platform.system() != "Darwin":
-    raise ImportError("Only macOS is supported")
-
-version = platform.mac_ver()[0]
-version_info = tuple(map(int, version.split(".")))
-if version_info < (10, 8):
-    raise OSError(
-        "Only OS X 10.8 and newer are supported, not %s.%s"
-        % (version_info[0], version_info[1])
-    )
-
-
-def load_cdll(name, macos10_16_path):
-    """Loads a CDLL by name, falling back to known path on 10.16+"""
-    try:
-        # Big Sur is technically 11 but we use 10.16 due to the Big Sur
-        # beta being labeled as 10.16.
-        if version_info >= (10, 16):
-            path = macos10_16_path
-        else:
-            path = find_library(name)
-        if not path:
-            raise OSError  # Caught and reraised as 'ImportError'
-        return CDLL(path, use_errno=True)
-    except OSError:
-        raise_from(ImportError("The library %s failed to load" % name), None)
-
-
-Security = load_cdll(
-    "Security", "/System/Library/Frameworks/Security.framework/Security"
-)
-CoreFoundation = load_cdll(
-    "CoreFoundation",
-    "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation",
-)
-
-
-Boolean = c_bool
-CFIndex = c_long
-CFStringEncoding = c_uint32
-CFData = c_void_p
-CFString = c_void_p
-CFArray = c_void_p
-CFMutableArray = c_void_p
-CFDictionary = c_void_p
-CFError = c_void_p
-CFType = c_void_p
-CFTypeID = c_ulong
-
-CFTypeRef = POINTER(CFType)
-CFAllocatorRef = c_void_p
-
-OSStatus = c_int32
-
-CFDataRef = POINTER(CFData)
-CFStringRef = POINTER(CFString)
-CFArrayRef = POINTER(CFArray)
-CFMutableArrayRef = POINTER(CFMutableArray)
-CFDictionaryRef = POINTER(CFDictionary)
-CFArrayCallBacks = c_void_p
-CFDictionaryKeyCallBacks = c_void_p
-CFDictionaryValueCallBacks = c_void_p
-
-SecCertificateRef = POINTER(c_void_p)
-SecExternalFormat = c_uint32
-SecExternalItemType = c_uint32
-SecIdentityRef = POINTER(c_void_p)
-SecItemImportExportFlags = c_uint32
-SecItemImportExportKeyParameters = c_void_p
-SecKeychainRef = POINTER(c_void_p)
-SSLProtocol = c_uint32
-SSLCipherSuite = c_uint32
-SSLContextRef = POINTER(c_void_p)
-SecTrustRef = POINTER(c_void_p)
-SSLConnectionRef = c_uint32
-SecTrustResultType = c_uint32
-SecTrustOptionFlags = c_uint32
-SSLProtocolSide = c_uint32
-SSLConnectionType = c_uint32
-SSLSessionOption = c_uint32
-
-
-try:
-    Security.SecItemImport.argtypes = [
-        CFDataRef,
-        CFStringRef,
-        POINTER(SecExternalFormat),
-        POINTER(SecExternalItemType),
-        SecItemImportExportFlags,
-        POINTER(SecItemImportExportKeyParameters),
-        SecKeychainRef,
-        POINTER(CFArrayRef),
-    ]
-    Security.SecItemImport.restype = OSStatus
-
-    Security.SecCertificateGetTypeID.argtypes = []
-    Security.SecCertificateGetTypeID.restype = CFTypeID
-
-    Security.SecIdentityGetTypeID.argtypes = []
-    Security.SecIdentityGetTypeID.restype = CFTypeID
-
-    Security.SecKeyGetTypeID.argtypes = []
-    Security.SecKeyGetTypeID.restype = CFTypeID
-
-    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
-    Security.SecCertificateCreateWithData.restype = SecCertificateRef
-
-    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
-    Security.SecCertificateCopyData.restype = CFDataRef
-
-    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
-    Security.SecCopyErrorMessageString.restype = CFStringRef
-
-    Security.SecIdentityCreateWithCertificate.argtypes = [
-        CFTypeRef,
-        SecCertificateRef,
-        POINTER(SecIdentityRef),
-    ]
-    Security.SecIdentityCreateWithCertificate.restype = OSStatus
-
-    Security.SecKeychainCreate.argtypes = [
-        c_char_p,
-        c_uint32,
-        c_void_p,
-        Boolean,
-        c_void_p,
-        POINTER(SecKeychainRef),
-    ]
-    Security.SecKeychainCreate.restype = OSStatus
-
-    Security.SecKeychainDelete.argtypes = [SecKeychainRef]
-    Security.SecKeychainDelete.restype = OSStatus
-
-    Security.SecPKCS12Import.argtypes = [
-        CFDataRef,
-        CFDictionaryRef,
-        POINTER(CFArrayRef),
-    ]
-    Security.SecPKCS12Import.restype = OSStatus
-
-    SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t))
-    SSLWriteFunc = CFUNCTYPE(
-        OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t)
-    )
-
-    Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc]
-    Security.SSLSetIOFuncs.restype = OSStatus
-
-    Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t]
-    Security.SSLSetPeerID.restype = OSStatus
-
-    Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef]
-    Security.SSLSetCertificate.restype = OSStatus
-
-    Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean]
-    Security.SSLSetCertificateAuthorities.restype = OSStatus
-
-    Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef]
-    Security.SSLSetConnection.restype = OSStatus
-
-    Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t]
-    Security.SSLSetPeerDomainName.restype = OSStatus
-
-    Security.SSLHandshake.argtypes = [SSLContextRef]
-    Security.SSLHandshake.restype = OSStatus
-
-    Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
-    Security.SSLRead.restype = OSStatus
-
-    Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
-    Security.SSLWrite.restype = OSStatus
-
-    Security.SSLClose.argtypes = [SSLContextRef]
-    Security.SSLClose.restype = OSStatus
-
-    Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)]
-    Security.SSLGetNumberSupportedCiphers.restype = OSStatus
-
-    Security.SSLGetSupportedCiphers.argtypes = [
-        SSLContextRef,
-        POINTER(SSLCipherSuite),
-        POINTER(c_size_t),
-    ]
-    Security.SSLGetSupportedCiphers.restype = OSStatus
-
-    Security.SSLSetEnabledCiphers.argtypes = [
-        SSLContextRef,
-        POINTER(SSLCipherSuite),
-        c_size_t,
-    ]
-    Security.SSLSetEnabledCiphers.restype = OSStatus
-
-    Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)]
-    Security.SSLGetNumberEnabledCiphers.restype = OSStatus
-
-    Security.SSLGetEnabledCiphers.argtypes = [
-        SSLContextRef,
-        POINTER(SSLCipherSuite),
-        POINTER(c_size_t),
-    ]
-    Security.SSLGetEnabledCiphers.restype = OSStatus
-
-    Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)]
-    Security.SSLGetNegotiatedCipher.restype = OSStatus
-
-    Security.SSLGetNegotiatedProtocolVersion.argtypes = [
-        SSLContextRef,
-        POINTER(SSLProtocol),
-    ]
-    Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus
-
-    Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)]
-    Security.SSLCopyPeerTrust.restype = OSStatus
-
-    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
-    Security.SecTrustSetAnchorCertificates.restype = OSStatus
-
-    Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean]
-    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus
-
-    Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)]
-    Security.SecTrustEvaluate.restype = OSStatus
-
-    Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef]
-    Security.SecTrustGetCertificateCount.restype = CFIndex
-
-    Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex]
-    Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef
-
-    Security.SSLCreateContext.argtypes = [
-        CFAllocatorRef,
-        SSLProtocolSide,
-        SSLConnectionType,
-    ]
-    Security.SSLCreateContext.restype = SSLContextRef
-
-    Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean]
-    Security.SSLSetSessionOption.restype = OSStatus
-
-    Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol]
-    Security.SSLSetProtocolVersionMin.restype = OSStatus
-
-    Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol]
-    Security.SSLSetProtocolVersionMax.restype = OSStatus
-
-    try:
-        Security.SSLSetALPNProtocols.argtypes = [SSLContextRef, CFArrayRef]
-        Security.SSLSetALPNProtocols.restype = OSStatus
-    except AttributeError:
-        # Supported only in 10.12+
-        pass
-
-    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
-    Security.SecCopyErrorMessageString.restype = CFStringRef
-
-    Security.SSLReadFunc = SSLReadFunc
-    Security.SSLWriteFunc = SSLWriteFunc
-    Security.SSLContextRef = SSLContextRef
-    Security.SSLProtocol = SSLProtocol
-    Security.SSLCipherSuite = SSLCipherSuite
-    Security.SecIdentityRef = SecIdentityRef
-    Security.SecKeychainRef = SecKeychainRef
-    Security.SecTrustRef = SecTrustRef
-    Security.SecTrustResultType = SecTrustResultType
-    Security.SecExternalFormat = SecExternalFormat
-    Security.OSStatus = OSStatus
-
-    Security.kSecImportExportPassphrase = CFStringRef.in_dll(
-        Security, "kSecImportExportPassphrase"
-    )
-    Security.kSecImportItemIdentity = CFStringRef.in_dll(
-        Security, "kSecImportItemIdentity"
-    )
-
-    # CoreFoundation time!
-    CoreFoundation.CFRetain.argtypes = [CFTypeRef]
-    CoreFoundation.CFRetain.restype = CFTypeRef
-
-    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
-    CoreFoundation.CFRelease.restype = None
-
-    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
-    CoreFoundation.CFGetTypeID.restype = CFTypeID
-
-    CoreFoundation.CFStringCreateWithCString.argtypes = [
-        CFAllocatorRef,
-        c_char_p,
-        CFStringEncoding,
-    ]
-    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef
-
-    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
-    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p
-
-    CoreFoundation.CFStringGetCString.argtypes = [
-        CFStringRef,
-        c_char_p,
-        CFIndex,
-        CFStringEncoding,
-    ]
-    CoreFoundation.CFStringGetCString.restype = c_bool
-
-    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
-    CoreFoundation.CFDataCreate.restype = CFDataRef
-
-    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
-    CoreFoundation.CFDataGetLength.restype = CFIndex
-
-    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
-    CoreFoundation.CFDataGetBytePtr.restype = c_void_p
-
-    CoreFoundation.CFDictionaryCreate.argtypes = [
-        CFAllocatorRef,
-        POINTER(CFTypeRef),
-        POINTER(CFTypeRef),
-        CFIndex,
-        CFDictionaryKeyCallBacks,
-        CFDictionaryValueCallBacks,
-    ]
-    CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef
-
-    CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef]
-    CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef
-
-    CoreFoundation.CFArrayCreate.argtypes = [
-        CFAllocatorRef,
-        POINTER(CFTypeRef),
-        CFIndex,
-        CFArrayCallBacks,
-    ]
-    CoreFoundation.CFArrayCreate.restype = CFArrayRef
-
-    CoreFoundation.CFArrayCreateMutable.argtypes = [
-        CFAllocatorRef,
-        CFIndex,
-        CFArrayCallBacks,
-    ]
-    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef
-
-    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
-    CoreFoundation.CFArrayAppendValue.restype = None
-
-    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
-    CoreFoundation.CFArrayGetCount.restype = CFIndex
-
-    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
-    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p
-
-    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(
-        CoreFoundation, "kCFAllocatorDefault"
-    )
-    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(
-        CoreFoundation, "kCFTypeArrayCallBacks"
-    )
-    CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll(
-        CoreFoundation, "kCFTypeDictionaryKeyCallBacks"
-    )
-    CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll(
-        CoreFoundation, "kCFTypeDictionaryValueCallBacks"
-    )
-
-    CoreFoundation.CFTypeRef = CFTypeRef
-    CoreFoundation.CFArrayRef = CFArrayRef
-    CoreFoundation.CFStringRef = CFStringRef
-    CoreFoundation.CFDictionaryRef = CFDictionaryRef
-
-except (AttributeError):
-    raise ImportError("Error initializing ctypes")
-
-
-class CFConst(object):
-    """
-    A class object that acts as essentially a namespace for CoreFoundation
-    constants.
-    """
-
-    kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
-
-
-class SecurityConst(object):
-    """
-    A class object that acts as essentially a namespace for Security constants.
-    """
-
-    kSSLSessionOptionBreakOnServerAuth = 0
-
-    kSSLProtocol2 = 1
-    kSSLProtocol3 = 2
-    kTLSProtocol1 = 4
-    kTLSProtocol11 = 7
-    kTLSProtocol12 = 8
-    # SecureTransport does not support TLS 1.3 even if there's a constant for it
-    kTLSProtocol13 = 10
-    kTLSProtocolMaxSupported = 999
-
-    kSSLClientSide = 1
-    kSSLStreamType = 0
-
-    kSecFormatPEMSequence = 10
-
-    kSecTrustResultInvalid = 0
-    kSecTrustResultProceed = 1
-    # This gap is present on purpose: this was kSecTrustResultConfirm, which
-    # is deprecated.
-    kSecTrustResultDeny = 3
-    kSecTrustResultUnspecified = 4
-    kSecTrustResultRecoverableTrustFailure = 5
-    kSecTrustResultFatalTrustFailure = 6
-    kSecTrustResultOtherError = 7
-
-    errSSLProtocol = -9800
-    errSSLWouldBlock = -9803
-    errSSLClosedGraceful = -9805
-    errSSLClosedNoNotify = -9816
-    errSSLClosedAbort = -9806
-
-    errSSLXCertChainInvalid = -9807
-    errSSLCrypto = -9809
-    errSSLInternal = -9810
-    errSSLCertExpired = -9814
-    errSSLCertNotYetValid = -9815
-    errSSLUnknownRootCert = -9812
-    errSSLNoRootCert = -9813
-    errSSLHostNameMismatch = -9843
-    errSSLPeerHandshakeFail = -9824
-    errSSLPeerUserCancelled = -9839
-    errSSLWeakPeerEphemeralDHKey = -9850
-    errSSLServerAuthCompleted = -9841
-    errSSLRecordOverflow = -9847
-
-    errSecVerifyFailed = -67808
-    errSecNoTrustSettings = -25263
-    errSecItemNotFound = -25300
-    errSecInvalidTrustSettings = -25262
-
-    # Cipher suites. We only pick the ones our default cipher string allows.
-    # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values
-    TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C
-    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030
-    TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B
-    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F
-    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9
-    TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8
-    TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F
-    TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E
-    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024
-    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028
-    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A
-    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014
-    TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B
-    TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039
-    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023
-    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027
-    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009
-    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013
-    TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067
-    TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033
-    TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D
-    TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C
-    TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D
-    TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C
-    TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
-    TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
-    TLS_AES_128_GCM_SHA256 = 0x1301
-    TLS_AES_256_GCM_SHA384 = 0x1302
-    TLS_AES_128_CCM_8_SHA256 = 0x1305
-    TLS_AES_128_CCM_SHA256 = 0x1304
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py
deleted file mode 100644
index fa0b245..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py
+++ /dev/null
@@ -1,397 +0,0 @@
-"""
-Low-level helpers for the SecureTransport bindings.
-
-These are Python functions that are not directly related to the high-level APIs
-but are necessary to get them to work. They include a whole bunch of low-level
-CoreFoundation messing about and memory management. The concerns in this module
-are almost entirely about trying to avoid memory leaks and providing
-appropriate and useful assistance to the higher-level code.
-"""
-import base64
-import ctypes
-import itertools
-import os
-import re
-import ssl
-import struct
-import tempfile
-
-from .bindings import CFConst, CoreFoundation, Security
-
-# This regular expression is used to grab PEM data out of a PEM bundle.
-_PEM_CERTS_RE = re.compile(
-    b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL
-)
-
-
-def _cf_data_from_bytes(bytestring):
-    """
-    Given a bytestring, create a CFData object from it. This CFData object must
-    be CFReleased by the caller.
-    """
-    return CoreFoundation.CFDataCreate(
-        CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring)
-    )
-
-
-def _cf_dictionary_from_tuples(tuples):
-    """
-    Given a list of Python tuples, create an associated CFDictionary.
-    """
-    dictionary_size = len(tuples)
-
-    # We need to get the dictionary keys and values out in the same order.
-    keys = (t[0] for t in tuples)
-    values = (t[1] for t in tuples)
-    cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys)
-    cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values)
-
-    return CoreFoundation.CFDictionaryCreate(
-        CoreFoundation.kCFAllocatorDefault,
-        cf_keys,
-        cf_values,
-        dictionary_size,
-        CoreFoundation.kCFTypeDictionaryKeyCallBacks,
-        CoreFoundation.kCFTypeDictionaryValueCallBacks,
-    )
-
-
-def _cfstr(py_bstr):
-    """
-    Given a Python binary data, create a CFString.
-    The string must be CFReleased by the caller.
-    """
-    c_str = ctypes.c_char_p(py_bstr)
-    cf_str = CoreFoundation.CFStringCreateWithCString(
-        CoreFoundation.kCFAllocatorDefault,
-        c_str,
-        CFConst.kCFStringEncodingUTF8,
-    )
-    return cf_str
-
-
-def _create_cfstring_array(lst):
-    """
-    Given a list of Python binary data, create an associated CFMutableArray.
-    The array must be CFReleased by the caller.
-
-    Raises an ssl.SSLError on failure.
-    """
-    cf_arr = None
-    try:
-        cf_arr = CoreFoundation.CFArrayCreateMutable(
-            CoreFoundation.kCFAllocatorDefault,
-            0,
-            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
-        )
-        if not cf_arr:
-            raise MemoryError("Unable to allocate memory!")
-        for item in lst:
-            cf_str = _cfstr(item)
-            if not cf_str:
-                raise MemoryError("Unable to allocate memory!")
-            try:
-                CoreFoundation.CFArrayAppendValue(cf_arr, cf_str)
-            finally:
-                CoreFoundation.CFRelease(cf_str)
-    except BaseException as e:
-        if cf_arr:
-            CoreFoundation.CFRelease(cf_arr)
-        raise ssl.SSLError("Unable to allocate array: %s" % (e,))
-    return cf_arr
-
-
-def _cf_string_to_unicode(value):
-    """
-    Creates a Unicode string from a CFString object. Used entirely for error
-    reporting.
-
-    Yes, it annoys me quite a lot that this function is this complex.
-    """
-    value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p))
-
-    string = CoreFoundation.CFStringGetCStringPtr(
-        value_as_void_p, CFConst.kCFStringEncodingUTF8
-    )
-    if string is None:
-        buffer = ctypes.create_string_buffer(1024)
-        result = CoreFoundation.CFStringGetCString(
-            value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8
-        )
-        if not result:
-            raise OSError("Error copying C string from CFStringRef")
-        string = buffer.value
-    if string is not None:
-        string = string.decode("utf-8")
-    return string
-
-
-def _assert_no_error(error, exception_class=None):
-    """
-    Checks the return code and throws an exception if there is an error to
-    report
-    """
-    if error == 0:
-        return
-
-    cf_error_string = Security.SecCopyErrorMessageString(error, None)
-    output = _cf_string_to_unicode(cf_error_string)
-    CoreFoundation.CFRelease(cf_error_string)
-
-    if output is None or output == u"":
-        output = u"OSStatus %s" % error
-
-    if exception_class is None:
-        exception_class = ssl.SSLError
-
-    raise exception_class(output)
-
-
-def _cert_array_from_pem(pem_bundle):
-    """
-    Given a bundle of certs in PEM format, turns them into a CFArray of certs
-    that can be used to validate a cert chain.
-    """
-    # Normalize the PEM bundle's line endings.
-    pem_bundle = pem_bundle.replace(b"\r\n", b"\n")
-
-    der_certs = [
-        base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle)
-    ]
-    if not der_certs:
-        raise ssl.SSLError("No root certificates specified")
-
-    cert_array = CoreFoundation.CFArrayCreateMutable(
-        CoreFoundation.kCFAllocatorDefault,
-        0,
-        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
-    )
-    if not cert_array:
-        raise ssl.SSLError("Unable to allocate memory!")
-
-    try:
-        for der_bytes in der_certs:
-            certdata = _cf_data_from_bytes(der_bytes)
-            if not certdata:
-                raise ssl.SSLError("Unable to allocate memory!")
-            cert = Security.SecCertificateCreateWithData(
-                CoreFoundation.kCFAllocatorDefault, certdata
-            )
-            CoreFoundation.CFRelease(certdata)
-            if not cert:
-                raise ssl.SSLError("Unable to build cert object!")
-
-            CoreFoundation.CFArrayAppendValue(cert_array, cert)
-            CoreFoundation.CFRelease(cert)
-    except Exception:
-        # We need to free the array before the exception bubbles further.
-        # We only want to do that if an error occurs: otherwise, the caller
-        # should free.
-        CoreFoundation.CFRelease(cert_array)
-        raise
-
-    return cert_array
-
-
-def _is_cert(item):
-    """
-    Returns True if a given CFTypeRef is a certificate.
-    """
-    expected = Security.SecCertificateGetTypeID()
-    return CoreFoundation.CFGetTypeID(item) == expected
-
-
-def _is_identity(item):
-    """
-    Returns True if a given CFTypeRef is an identity.
-    """
-    expected = Security.SecIdentityGetTypeID()
-    return CoreFoundation.CFGetTypeID(item) == expected
-
-
-def _temporary_keychain():
-    """
-    This function creates a temporary Mac keychain that we can use to work with
-    credentials. This keychain uses a one-time password and a temporary file to
-    store the data. We expect to have one keychain per socket. The returned
-    SecKeychainRef must be freed by the caller, including calling
-    SecKeychainDelete.
-
-    Returns a tuple of the SecKeychainRef and the path to the temporary
-    directory that contains it.
-    """
-    # Unfortunately, SecKeychainCreate requires a path to a keychain. This
-    # means we cannot use mkstemp to use a generic temporary file. Instead,
-    # we're going to create a temporary directory and a filename to use there.
-    # This filename will be 8 random bytes expanded into base64. We also need
-    # some random bytes to password-protect the keychain we're creating, so we
-    # ask for 40 random bytes.
-    random_bytes = os.urandom(40)
-    filename = base64.b16encode(random_bytes[:8]).decode("utf-8")
-    password = base64.b16encode(random_bytes[8:])  # Must be valid UTF-8
-    tempdirectory = tempfile.mkdtemp()
-
-    keychain_path = os.path.join(tempdirectory, filename).encode("utf-8")
-
-    # We now want to create the keychain itself.
-    keychain = Security.SecKeychainRef()
-    status = Security.SecKeychainCreate(
-        keychain_path, len(password), password, False, None, ctypes.byref(keychain)
-    )
-    _assert_no_error(status)
-
-    # Having created the keychain, we want to pass it off to the caller.
-    return keychain, tempdirectory
-
-
-def _load_items_from_file(keychain, path):
-    """
-    Given a single file, loads all the trust objects from it into arrays and
-    the keychain.
-    Returns a tuple of lists: the first list is a list of identities, the
-    second a list of certs.
-    """
-    certificates = []
-    identities = []
-    result_array = None
-
-    with open(path, "rb") as f:
-        raw_filedata = f.read()
-
-    try:
-        filedata = CoreFoundation.CFDataCreate(
-            CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata)
-        )
-        result_array = CoreFoundation.CFArrayRef()
-        result = Security.SecItemImport(
-            filedata,  # cert data
-            None,  # Filename, leaving it out for now
-            None,  # What the type of the file is, we don't care
-            None,  # what's in the file, we don't care
-            0,  # import flags
-            None,  # key params, can include passphrase in the future
-            keychain,  # The keychain to insert into
-            ctypes.byref(result_array),  # Results
-        )
-        _assert_no_error(result)
-
-        # A CFArray is not very useful to us as an intermediary
-        # representation, so we are going to extract the objects we want
-        # and then free the array. We don't need to keep hold of keys: the
-        # keychain already has them!
-        result_count = CoreFoundation.CFArrayGetCount(result_array)
-        for index in range(result_count):
-            item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index)
-            item = ctypes.cast(item, CoreFoundation.CFTypeRef)
-
-            if _is_cert(item):
-                CoreFoundation.CFRetain(item)
-                certificates.append(item)
-            elif _is_identity(item):
-                CoreFoundation.CFRetain(item)
-                identities.append(item)
-    finally:
-        if result_array:
-            CoreFoundation.CFRelease(result_array)
-
-        CoreFoundation.CFRelease(filedata)
-
-    return (identities, certificates)
-
-
-def _load_client_cert_chain(keychain, *paths):
-    """
-    Load certificates and maybe keys from a number of files. Has the end goal
-    of returning a CFArray containing one SecIdentityRef, and then zero or more
-    SecCertificateRef objects, suitable for use as a client certificate trust
-    chain.
-    """
-    # Ok, the strategy.
-    #
-    # This relies on knowing that macOS will not give you a SecIdentityRef
-    # unless you have imported a key into a keychain. This is a somewhat
-    # artificial limitation of macOS (for example, it doesn't necessarily
-    # affect iOS), but there is nothing inside Security.framework that lets you
-    # get a SecIdentityRef without having a key in a keychain.
-    #
-    # So the policy here is we take all the files and iterate them in order.
-    # Each one will use SecItemImport to have one or more objects loaded from
-    # it. We will also point at a keychain that macOS can use to work with the
-    # private key.
-    #
-    # Once we have all the objects, we'll check what we actually have. If we
-    # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise,
-    # we'll take the first certificate (which we assume to be our leaf) and
-    # ask the keychain to give us a SecIdentityRef with that cert's associated
-    # key.
-    #
-    # We'll then return a CFArray containing the trust chain: one
-    # SecIdentityRef and then zero-or-more SecCertificateRef objects. The
-    # responsibility for freeing this CFArray will be with the caller. This
-    # CFArray must remain alive for the entire connection, so in practice it
-    # will be stored with a single SSLSocket, along with the reference to the
-    # keychain.
-    certificates = []
-    identities = []
-
-    # Filter out bad paths.
-    paths = (path for path in paths if path)
-
-    try:
-        for file_path in paths:
-            new_identities, new_certs = _load_items_from_file(keychain, file_path)
-            identities.extend(new_identities)
-            certificates.extend(new_certs)
-
-        # Ok, we have everything. The question is: do we have an identity? If
-        # not, we want to grab one from the first cert we have.
-        if not identities:
-            new_identity = Security.SecIdentityRef()
-            status = Security.SecIdentityCreateWithCertificate(
-                keychain, certificates[0], ctypes.byref(new_identity)
-            )
-            _assert_no_error(status)
-            identities.append(new_identity)
-
-            # We now want to release the original certificate, as we no longer
-            # need it.
-            CoreFoundation.CFRelease(certificates.pop(0))
-
-        # We now need to build a new CFArray that holds the trust chain.
-        trust_chain = CoreFoundation.CFArrayCreateMutable(
-            CoreFoundation.kCFAllocatorDefault,
-            0,
-            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
-        )
-        for item in itertools.chain(identities, certificates):
-            # ArrayAppendValue does a CFRetain on the item. That's fine,
-            # because the finally block will release our other refs to them.
-            CoreFoundation.CFArrayAppendValue(trust_chain, item)
-
-        return trust_chain
-    finally:
-        for obj in itertools.chain(identities, certificates):
-            CoreFoundation.CFRelease(obj)
-
-
-TLS_PROTOCOL_VERSIONS = {
-    "SSLv2": (0, 2),
-    "SSLv3": (3, 0),
-    "TLSv1": (3, 1),
-    "TLSv1.1": (3, 2),
-    "TLSv1.2": (3, 3),
-}
-
-
-def _build_tls_unknown_ca_alert(version):
-    """
-    Builds a TLS alert record for an unknown CA.
-    """
-    ver_maj, ver_min = TLS_PROTOCOL_VERSIONS[version]
-    severity_fatal = 0x02
-    description_unknown_ca = 0x30
-    msg = struct.pack(">BB", severity_fatal, description_unknown_ca)
-    msg_len = len(msg)
-    record_type_alert = 0x15
-    record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg
-    return record
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/appengine.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/appengine.py
deleted file mode 100644
index 1717ee2..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/appengine.py
+++ /dev/null
@@ -1,314 +0,0 @@
-"""
-This module provides a pool manager that uses Google App Engine's
-`URLFetch Service `_.
-
-Example usage::
-
-    from pip._vendor.urllib3 import PoolManager
-    from pip._vendor.urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox
-
-    if is_appengine_sandbox():
-        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
-        http = AppEngineManager()
-    else:
-        # PoolManager uses a socket-level API behind the scenes
-        http = PoolManager()
-
-    r = http.request('GET', 'https://google.com/')
-
-There are `limitations `_ to the URLFetch service and it may not be
-the best choice for your application. There are three options for using
-urllib3 on Google App Engine:
-
-1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
-   cost-effective in many circumstances as long as your usage is within the
-   limitations.
-2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
-   Sockets also have `limitations and restrictions
-   `_ and have a lower free quota than URLFetch.
-   To use sockets, be sure to specify the following in your ``app.yaml``::
-
-        env_variables:
-            GAE_USE_SOCKETS_HTTPLIB : 'true'
-
-3. If you are using `App Engine Flexible
-`_, you can use the standard
-:class:`PoolManager` without any configuration or special environment variables.
-"""
-
-from __future__ import absolute_import
-
-import io
-import logging
-import warnings
-
-from ..exceptions import (
-    HTTPError,
-    HTTPWarning,
-    MaxRetryError,
-    ProtocolError,
-    SSLError,
-    TimeoutError,
-)
-from ..packages.six.moves.urllib.parse import urljoin
-from ..request import RequestMethods
-from ..response import HTTPResponse
-from ..util.retry import Retry
-from ..util.timeout import Timeout
-from . import _appengine_environ
-
-try:
-    from google.appengine.api import urlfetch
-except ImportError:
-    urlfetch = None
-
-
-log = logging.getLogger(__name__)
-
-
-class AppEnginePlatformWarning(HTTPWarning):
-    pass
-
-
-class AppEnginePlatformError(HTTPError):
-    pass
-
-
-class AppEngineManager(RequestMethods):
-    """
-    Connection manager for Google App Engine sandbox applications.
-
-    This manager uses the URLFetch service directly instead of using the
-    emulated httplib, and is subject to URLFetch limitations as described in
-    the App Engine documentation `here
-    `_.
-
-    Notably it will raise an :class:`AppEnginePlatformError` if:
-        * URLFetch is not available.
-        * If you attempt to use this on App Engine Flexible, as full socket
-          support is available.
-        * If a request size is more than 10 megabytes.
-        * If a response size is more than 32 megabytes.
-        * If you use an unsupported request method such as OPTIONS.
-
-    Beyond those cases, it will raise normal urllib3 errors.
-    """
-
-    def __init__(
-        self,
-        headers=None,
-        retries=None,
-        validate_certificate=True,
-        urlfetch_retries=True,
-    ):
-        if not urlfetch:
-            raise AppEnginePlatformError(
-                "URLFetch is not available in this environment."
-            )
-
-        warnings.warn(
-            "urllib3 is using URLFetch on Google App Engine sandbox instead "
-            "of sockets. To use sockets directly instead of URLFetch see "
-            "https://urllib3.readthedocs.io/en/1.26.x/reference/urllib3.contrib.html.",
-            AppEnginePlatformWarning,
-        )
-
-        RequestMethods.__init__(self, headers)
-        self.validate_certificate = validate_certificate
-        self.urlfetch_retries = urlfetch_retries
-
-        self.retries = retries or Retry.DEFAULT
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        # Return False to re-raise any potential exceptions
-        return False
-
-    def urlopen(
-        self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        retries=None,
-        redirect=True,
-        timeout=Timeout.DEFAULT_TIMEOUT,
-        **response_kw
-    ):
-
-        retries = self._get_retries(retries, redirect)
-
-        try:
-            follow_redirects = redirect and retries.redirect != 0 and retries.total
-            response = urlfetch.fetch(
-                url,
-                payload=body,
-                method=method,
-                headers=headers or {},
-                allow_truncated=False,
-                follow_redirects=self.urlfetch_retries and follow_redirects,
-                deadline=self._get_absolute_timeout(timeout),
-                validate_certificate=self.validate_certificate,
-            )
-        except urlfetch.DeadlineExceededError as e:
-            raise TimeoutError(self, e)
-
-        except urlfetch.InvalidURLError as e:
-            if "too large" in str(e):
-                raise AppEnginePlatformError(
-                    "URLFetch request too large, URLFetch only "
-                    "supports requests up to 10mb in size.",
-                    e,
-                )
-            raise ProtocolError(e)
-
-        except urlfetch.DownloadError as e:
-            if "Too many redirects" in str(e):
-                raise MaxRetryError(self, url, reason=e)
-            raise ProtocolError(e)
-
-        except urlfetch.ResponseTooLargeError as e:
-            raise AppEnginePlatformError(
-                "URLFetch response too large, URLFetch only supports"
-                "responses up to 32mb in size.",
-                e,
-            )
-
-        except urlfetch.SSLCertificateError as e:
-            raise SSLError(e)
-
-        except urlfetch.InvalidMethodError as e:
-            raise AppEnginePlatformError(
-                "URLFetch does not support method: %s" % method, e
-            )
-
-        http_response = self._urlfetch_response_to_http_response(
-            response, retries=retries, **response_kw
-        )
-
-        # Handle redirect?
-        redirect_location = redirect and http_response.get_redirect_location()
-        if redirect_location:
-            # Check for redirect response
-            if self.urlfetch_retries and retries.raise_on_redirect:
-                raise MaxRetryError(self, url, "too many redirects")
-            else:
-                if http_response.status == 303:
-                    method = "GET"
-
-                try:
-                    retries = retries.increment(
-                        method, url, response=http_response, _pool=self
-                    )
-                except MaxRetryError:
-                    if retries.raise_on_redirect:
-                        raise MaxRetryError(self, url, "too many redirects")
-                    return http_response
-
-                retries.sleep_for_retry(http_response)
-                log.debug("Redirecting %s -> %s", url, redirect_location)
-                redirect_url = urljoin(url, redirect_location)
-                return self.urlopen(
-                    method,
-                    redirect_url,
-                    body,
-                    headers,
-                    retries=retries,
-                    redirect=redirect,
-                    timeout=timeout,
-                    **response_kw
-                )
-
-        # Check if we should retry the HTTP response.
-        has_retry_after = bool(http_response.headers.get("Retry-After"))
-        if retries.is_retry(method, http_response.status, has_retry_after):
-            retries = retries.increment(method, url, response=http_response, _pool=self)
-            log.debug("Retry: %s", url)
-            retries.sleep(http_response)
-            return self.urlopen(
-                method,
-                url,
-                body=body,
-                headers=headers,
-                retries=retries,
-                redirect=redirect,
-                timeout=timeout,
-                **response_kw
-            )
-
-        return http_response
-
-    def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw):
-
-        if is_prod_appengine():
-            # Production GAE handles deflate encoding automatically, but does
-            # not remove the encoding header.
-            content_encoding = urlfetch_resp.headers.get("content-encoding")
-
-            if content_encoding == "deflate":
-                del urlfetch_resp.headers["content-encoding"]
-
-        transfer_encoding = urlfetch_resp.headers.get("transfer-encoding")
-        # We have a full response's content,
-        # so let's make sure we don't report ourselves as chunked data.
-        if transfer_encoding == "chunked":
-            encodings = transfer_encoding.split(",")
-            encodings.remove("chunked")
-            urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings)
-
-        original_response = HTTPResponse(
-            # In order for decoding to work, we must present the content as
-            # a file-like object.
-            body=io.BytesIO(urlfetch_resp.content),
-            msg=urlfetch_resp.header_msg,
-            headers=urlfetch_resp.headers,
-            status=urlfetch_resp.status_code,
-            **response_kw
-        )
-
-        return HTTPResponse(
-            body=io.BytesIO(urlfetch_resp.content),
-            headers=urlfetch_resp.headers,
-            status=urlfetch_resp.status_code,
-            original_response=original_response,
-            **response_kw
-        )
-
-    def _get_absolute_timeout(self, timeout):
-        if timeout is Timeout.DEFAULT_TIMEOUT:
-            return None  # Defer to URLFetch's default.
-        if isinstance(timeout, Timeout):
-            if timeout._read is not None or timeout._connect is not None:
-                warnings.warn(
-                    "URLFetch does not support granular timeout settings, "
-                    "reverting to total or default URLFetch timeout.",
-                    AppEnginePlatformWarning,
-                )
-            return timeout.total
-        return timeout
-
-    def _get_retries(self, retries, redirect):
-        if not isinstance(retries, Retry):
-            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
-
-        if retries.connect or retries.read or retries.redirect:
-            warnings.warn(
-                "URLFetch only supports total retries and does not "
-                "recognize connect, read, or redirect retry parameters.",
-                AppEnginePlatformWarning,
-            )
-
-        return retries
-
-
-# Alias methods from _appengine_environ to maintain public API interface.
-
-is_appengine = _appengine_environ.is_appengine
-is_appengine_sandbox = _appengine_environ.is_appengine_sandbox
-is_local_appengine = _appengine_environ.is_local_appengine
-is_prod_appengine = _appengine_environ.is_prod_appengine
-is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py
deleted file mode 100644
index 4716657..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py
+++ /dev/null
@@ -1,130 +0,0 @@
-"""
-NTLM authenticating pool, contributed by erikcederstran
-
-Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
-"""
-from __future__ import absolute_import
-
-import warnings
-from logging import getLogger
-
-from ntlm import ntlm
-
-from .. import HTTPSConnectionPool
-from ..packages.six.moves.http_client import HTTPSConnection
-
-warnings.warn(
-    "The 'urllib3.contrib.ntlmpool' module is deprecated and will be removed "
-    "in urllib3 v2.0 release, urllib3 is not able to support it properly due "
-    "to reasons listed in issue: https://github.com/urllib3/urllib3/issues/2282. "
-    "If you are a user of this module please comment in the mentioned issue.",
-    DeprecationWarning,
-)
-
-log = getLogger(__name__)
-
-
-class NTLMConnectionPool(HTTPSConnectionPool):
-    """
-    Implements an NTLM authentication version of an urllib3 connection pool
-    """
-
-    scheme = "https"
-
-    def __init__(self, user, pw, authurl, *args, **kwargs):
-        """
-        authurl is a random URL on the server that is protected by NTLM.
-        user is the Windows user, probably in the DOMAIN\\username format.
-        pw is the password for the user.
-        """
-        super(NTLMConnectionPool, self).__init__(*args, **kwargs)
-        self.authurl = authurl
-        self.rawuser = user
-        user_parts = user.split("\\", 1)
-        self.domain = user_parts[0].upper()
-        self.user = user_parts[1]
-        self.pw = pw
-
-    def _new_conn(self):
-        # Performs the NTLM handshake that secures the connection. The socket
-        # must be kept open while requests are performed.
-        self.num_connections += 1
-        log.debug(
-            "Starting NTLM HTTPS connection no. %d: https://%s%s",
-            self.num_connections,
-            self.host,
-            self.authurl,
-        )
-
-        headers = {"Connection": "Keep-Alive"}
-        req_header = "Authorization"
-        resp_header = "www-authenticate"
-
-        conn = HTTPSConnection(host=self.host, port=self.port)
-
-        # Send negotiation message
-        headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE(
-            self.rawuser
-        )
-        log.debug("Request headers: %s", headers)
-        conn.request("GET", self.authurl, None, headers)
-        res = conn.getresponse()
-        reshdr = dict(res.headers)
-        log.debug("Response status: %s %s", res.status, res.reason)
-        log.debug("Response headers: %s", reshdr)
-        log.debug("Response data: %s [...]", res.read(100))
-
-        # Remove the reference to the socket, so that it can not be closed by
-        # the response object (we want to keep the socket open)
-        res.fp = None
-
-        # Server should respond with a challenge message
-        auth_header_values = reshdr[resp_header].split(", ")
-        auth_header_value = None
-        for s in auth_header_values:
-            if s[:5] == "NTLM ":
-                auth_header_value = s[5:]
-        if auth_header_value is None:
-            raise Exception(
-                "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header])
-            )
-
-        # Send authentication message
-        ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE(
-            auth_header_value
-        )
-        auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(
-            ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags
-        )
-        headers[req_header] = "NTLM %s" % auth_msg
-        log.debug("Request headers: %s", headers)
-        conn.request("GET", self.authurl, None, headers)
-        res = conn.getresponse()
-        log.debug("Response status: %s %s", res.status, res.reason)
-        log.debug("Response headers: %s", dict(res.headers))
-        log.debug("Response data: %s [...]", res.read()[:100])
-        if res.status != 200:
-            if res.status == 401:
-                raise Exception("Server rejected request: wrong username or password")
-            raise Exception("Wrong server response: %s %s" % (res.status, res.reason))
-
-        res.fp = None
-        log.debug("Connection established")
-        return conn
-
-    def urlopen(
-        self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        retries=3,
-        redirect=True,
-        assert_same_host=True,
-    ):
-        if headers is None:
-            headers = {}
-        headers["Connection"] = "Keep-Alive"
-        return super(NTLMConnectionPool, self).urlopen(
-            method, url, body, headers, retries, redirect, assert_same_host
-        )
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py
index 19e4aa9..faed2b8 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py
@@ -1,17 +1,17 @@
 """
-TLS with SNI_-support for Python 2. Follow these instructions if you would
-like to verify TLS certificates in Python 2. Note, the default libraries do
-*not* do certificate checking; you need to do additional work to validate
-certificates yourself.
+Module for using pyOpenSSL as a TLS backend. This module was relevant before
+the standard library ``ssl`` module supported SNI, but now that we've dropped
+support for Python 2.7 all relevant Python versions support SNI so
+**this module is no longer recommended**.
 
 This needs the following packages installed:
 
-* `pyOpenSSL`_ (tested with 16.0.0)
-* `cryptography`_ (minimum 1.3.4, from pyopenssl)
-* `idna`_ (minimum 2.0, from cryptography)
+* `pyOpenSSL`_ (tested with 19.0.0)
+* `cryptography`_ (minimum 2.3, from pyopenssl)
+* `idna`_ (minimum 2.1, from cryptography)
 
-However, pyopenssl depends on cryptography, which depends on idna, so while we
-use all three directly here we end up having relatively few packages required.
+However, pyOpenSSL depends on cryptography, so while we use all three directly here we
+end up having relatively few packages required.
 
 You can install them with the following command:
 
@@ -33,74 +33,47 @@ like this:
     except ImportError:
         pass
 
-Now you can use :mod:`urllib3` as you normally would, and it will support SNI
-when the required modules are installed.
-
-Activating this module also has the positive side effect of disabling SSL/TLS
-compression in Python 2 (see `CRIME attack`_).
-
-.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
-.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
 .. _pyopenssl: https://www.pyopenssl.org
 .. _cryptography: https://cryptography.io
 .. _idna: https://github.com/kjd/idna
 """
-from __future__ import absolute_import
 
-import OpenSSL.crypto
+from __future__ import annotations
+
 import OpenSSL.SSL
 from cryptography import x509
-from cryptography.hazmat.backends.openssl import backend as openssl_backend
+from cryptography.hazmat.primitives.serialization import load_pem_private_key
+from cryptography.x509.oid import NameOID
 
 try:
-    from cryptography.x509 import UnsupportedExtension
+    from cryptography.x509 import UnsupportedExtension  # type: ignore[attr-defined]
 except ImportError:
     # UnsupportedExtension is gone in cryptography >= 2.1.0
-    class UnsupportedExtension(Exception):
+    class UnsupportedExtension(Exception):  # type: ignore[no-redef]
         pass
 
 
-from io import BytesIO
-from socket import error as SocketError
-from socket import timeout
-
-try:  # Platform-specific: Python 2
-    from socket import _fileobject
-except ImportError:  # Platform-specific: Python 3
-    _fileobject = None
-    from ..packages.backports.makefile import backport_makefile
-
 import logging
 import ssl
-import sys
-import warnings
+import typing
+from socket import socket as socket_cls
 
 from .. import util
-from ..packages import six
-from ..util.ssl_ import PROTOCOL_TLS_CLIENT
 
-warnings.warn(
-    "'urllib3.contrib.pyopenssl' module is deprecated and will be removed "
-    "in a future release of urllib3 2.x. Read more in this issue: "
-    "https://github.com/urllib3/urllib3/issues/2680",
-    category=DeprecationWarning,
-    stacklevel=2,
-)
+if typing.TYPE_CHECKING:
+    from OpenSSL.crypto import X509
+
 
 __all__ = ["inject_into_urllib3", "extract_from_urllib3"]
 
-# SNI always works.
-HAS_SNI = True
-
 # Map from urllib3 to PyOpenSSL compatible parameter-values.
-_openssl_versions = {
-    util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,
-    PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,
-    ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD,
+_openssl_versions: dict[int, int] = {
+    util.ssl_.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,  # type: ignore[attr-defined]
+    util.ssl_.PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,  # type: ignore[attr-defined]
 }
 
-if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"):
-    _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD
+if hasattr(ssl, "PROTOCOL_TLSv1") and hasattr(OpenSSL.SSL, "TLSv1_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1] = OpenSSL.SSL.TLSv1_METHOD
 
 if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"):
     _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD
@@ -115,43 +88,77 @@ _stdlib_to_openssl_verify = {
     ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER
     + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT,
 }
-_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items())
+_openssl_to_stdlib_verify = {v: k for k, v in _stdlib_to_openssl_verify.items()}
+
+# The SSLvX values are the most likely to be missing in the future
+# but we check them all just to be sure.
+_OP_NO_SSLv2_OR_SSLv3: int = getattr(OpenSSL.SSL, "OP_NO_SSLv2", 0) | getattr(
+    OpenSSL.SSL, "OP_NO_SSLv3", 0
+)
+_OP_NO_TLSv1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1", 0)
+_OP_NO_TLSv1_1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_1", 0)
+_OP_NO_TLSv1_2: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_2", 0)
+_OP_NO_TLSv1_3: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_3", 0)
+
+_openssl_to_ssl_minimum_version: dict[int, int] = {
+    ssl.TLSVersion.MINIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3,
+    ssl.TLSVersion.TLSv1: _OP_NO_SSLv2_OR_SSLv3,
+    ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1,
+    ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1,
+    ssl.TLSVersion.TLSv1_3: (
+        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2
+    ),
+    ssl.TLSVersion.MAXIMUM_SUPPORTED: (
+        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2
+    ),
+}
+_openssl_to_ssl_maximum_version: dict[int, int] = {
+    ssl.TLSVersion.MINIMUM_SUPPORTED: (
+        _OP_NO_SSLv2_OR_SSLv3
+        | _OP_NO_TLSv1
+        | _OP_NO_TLSv1_1
+        | _OP_NO_TLSv1_2
+        | _OP_NO_TLSv1_3
+    ),
+    ssl.TLSVersion.TLSv1: (
+        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3
+    ),
+    ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3,
+    ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_3,
+    ssl.TLSVersion.TLSv1_3: _OP_NO_SSLv2_OR_SSLv3,
+    ssl.TLSVersion.MAXIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3,
+}
 
 # OpenSSL will only write 16K at a time
 SSL_WRITE_BLOCKSIZE = 16384
 
-orig_util_HAS_SNI = util.HAS_SNI
 orig_util_SSLContext = util.ssl_.SSLContext
 
 
 log = logging.getLogger(__name__)
 
 
-def inject_into_urllib3():
+def inject_into_urllib3() -> None:
     "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support."
 
     _validate_dependencies_met()
 
-    util.SSLContext = PyOpenSSLContext
-    util.ssl_.SSLContext = PyOpenSSLContext
-    util.HAS_SNI = HAS_SNI
-    util.ssl_.HAS_SNI = HAS_SNI
+    util.SSLContext = PyOpenSSLContext  # type: ignore[assignment]
+    util.ssl_.SSLContext = PyOpenSSLContext  # type: ignore[assignment]
     util.IS_PYOPENSSL = True
     util.ssl_.IS_PYOPENSSL = True
 
 
-def extract_from_urllib3():
+def extract_from_urllib3() -> None:
     "Undo monkey-patching by :func:`inject_into_urllib3`."
 
     util.SSLContext = orig_util_SSLContext
     util.ssl_.SSLContext = orig_util_SSLContext
-    util.HAS_SNI = orig_util_HAS_SNI
-    util.ssl_.HAS_SNI = orig_util_HAS_SNI
     util.IS_PYOPENSSL = False
     util.ssl_.IS_PYOPENSSL = False
 
 
-def _validate_dependencies_met():
+def _validate_dependencies_met() -> None:
     """
     Verifies that PyOpenSSL's package-level dependencies have been met.
     Throws `ImportError` if they are not met.
@@ -177,7 +184,7 @@ def _validate_dependencies_met():
         )
 
 
-def _dnsname_to_stdlib(name):
+def _dnsname_to_stdlib(name: str) -> str | None:
     """
     Converts a dNSName SubjectAlternativeName field to the form used by the
     standard library on the given Python version.
@@ -191,7 +198,7 @@ def _dnsname_to_stdlib(name):
     the name given should be skipped.
     """
 
-    def idna_encode(name):
+    def idna_encode(name: str) -> bytes | None:
         """
         Borrowed wholesale from the Python Cryptography Project. It turns out
         that we can't just safely call `idna.encode`: it can explode for
@@ -200,7 +207,7 @@ def _dnsname_to_stdlib(name):
         from pip._vendor import idna
 
         try:
-            for prefix in [u"*.", u"."]:
+            for prefix in ["*.", "."]:
                 if name.startswith(prefix):
                     name = name[len(prefix) :]
                     return prefix.encode("ascii") + idna.encode(name)
@@ -212,24 +219,17 @@ def _dnsname_to_stdlib(name):
     if ":" in name:
         return name
 
-    name = idna_encode(name)
-    if name is None:
+    encoded_name = idna_encode(name)
+    if encoded_name is None:
         return None
-    elif sys.version_info >= (3, 0):
-        name = name.decode("utf-8")
-    return name
+    return encoded_name.decode("utf-8")
 
 
-def get_subj_alt_name(peer_cert):
+def get_subj_alt_name(peer_cert: X509) -> list[tuple[str, str]]:
     """
     Given an PyOpenSSL certificate, provides all the subject alternative names.
     """
-    # Pass the cert to cryptography, which has much better APIs for this.
-    if hasattr(peer_cert, "to_cryptography"):
-        cert = peer_cert.to_cryptography()
-    else:
-        der = OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, peer_cert)
-        cert = x509.load_der_x509_certificate(der, openssl_backend)
+    cert = peer_cert.to_cryptography()
 
     # We want to find the SAN extension. Ask Cryptography to locate it (it's
     # faster than looping in Python)
@@ -273,93 +273,103 @@ def get_subj_alt_name(peer_cert):
     return names
 
 
-class WrappedSocket(object):
-    """API-compatibility wrapper for Python OpenSSL's Connection-class.
-
-    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
-    collector of pypy.
+def _get_common_name(peer_cert: X509) -> str | None:
     """
+    Given a pyOpenSSL certificate, return the subject's common name.
+    """
+    cert = peer_cert.to_cryptography()
+    names = cert.subject.get_attributes_for_oid(NameOID.COMMON_NAME)
+    return typing.cast(str, names[0].value) if names else None
 
-    def __init__(self, connection, socket, suppress_ragged_eofs=True):
+
+class WrappedSocket:
+    """API-compatibility wrapper for Python OpenSSL's Connection-class."""
+
+    def __init__(
+        self,
+        connection: OpenSSL.SSL.Connection,
+        socket: socket_cls,
+        suppress_ragged_eofs: bool = True,
+    ) -> None:
         self.connection = connection
         self.socket = socket
         self.suppress_ragged_eofs = suppress_ragged_eofs
-        self._makefile_refs = 0
+        self._io_refs = 0
         self._closed = False
 
-    def fileno(self):
+    def fileno(self) -> int:
         return self.socket.fileno()
 
     # Copy-pasted from Python 3.5 source code
-    def _decref_socketios(self):
-        if self._makefile_refs > 0:
-            self._makefile_refs -= 1
+    def _decref_socketios(self) -> None:
+        if self._io_refs > 0:
+            self._io_refs -= 1
         if self._closed:
             self.close()
 
-    def recv(self, *args, **kwargs):
+    def recv(self, *args: typing.Any, **kwargs: typing.Any) -> bytes:
         try:
             data = self.connection.recv(*args, **kwargs)
         except OpenSSL.SSL.SysCallError as e:
             if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                 return b""
             else:
-                raise SocketError(str(e))
+                raise OSError(e.args[0], str(e)) from e
         except OpenSSL.SSL.ZeroReturnError:
             if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                 return b""
             else:
                 raise
-        except OpenSSL.SSL.WantReadError:
+        except OpenSSL.SSL.WantReadError as e:
             if not util.wait_for_read(self.socket, self.socket.gettimeout()):
-                raise timeout("The read operation timed out")
+                raise TimeoutError("The read operation timed out") from e
             else:
                 return self.recv(*args, **kwargs)
 
         # TLS 1.3 post-handshake authentication
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError("read error: %r" % e)
+            raise ssl.SSLError(f"read error: {e!r}") from e
         else:
             return data
 
-    def recv_into(self, *args, **kwargs):
+    def recv_into(self, *args: typing.Any, **kwargs: typing.Any) -> int:
         try:
             return self.connection.recv_into(*args, **kwargs)
         except OpenSSL.SSL.SysCallError as e:
             if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                 return 0
             else:
-                raise SocketError(str(e))
+                raise OSError(e.args[0], str(e)) from e
         except OpenSSL.SSL.ZeroReturnError:
             if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                 return 0
             else:
                 raise
-        except OpenSSL.SSL.WantReadError:
+        except OpenSSL.SSL.WantReadError as e:
             if not util.wait_for_read(self.socket, self.socket.gettimeout()):
-                raise timeout("The read operation timed out")
+                raise TimeoutError("The read operation timed out") from e
             else:
                 return self.recv_into(*args, **kwargs)
 
         # TLS 1.3 post-handshake authentication
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError("read error: %r" % e)
+            raise ssl.SSLError(f"read error: {e!r}") from e
 
-    def settimeout(self, timeout):
+    def settimeout(self, timeout: float) -> None:
         return self.socket.settimeout(timeout)
 
-    def _send_until_done(self, data):
+    def _send_until_done(self, data: bytes) -> int:
         while True:
             try:
                 return self.connection.send(data)
-            except OpenSSL.SSL.WantWriteError:
+            except OpenSSL.SSL.WantWriteError as e:
                 if not util.wait_for_write(self.socket, self.socket.gettimeout()):
-                    raise timeout()
+                    raise TimeoutError() from e
                 continue
             except OpenSSL.SSL.SysCallError as e:
-                raise SocketError(str(e))
+                raise OSError(e.args[0], str(e)) from e
 
-    def sendall(self, data):
+    def sendall(self, data: bytes) -> None:
         total_sent = 0
         while total_sent < len(data):
             sent = self._send_until_done(
@@ -367,135 +377,179 @@ class WrappedSocket(object):
             )
             total_sent += sent
 
-    def shutdown(self):
-        # FIXME rethrow compatible exceptions should we ever use this
-        self.connection.shutdown()
+    def shutdown(self, how: int) -> None:
+        try:
+            self.connection.shutdown()
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError(f"shutdown error: {e!r}") from e
 
-    def close(self):
-        if self._makefile_refs < 1:
-            try:
-                self._closed = True
-                return self.connection.close()
-            except OpenSSL.SSL.Error:
-                return
-        else:
-            self._makefile_refs -= 1
+    def close(self) -> None:
+        self._closed = True
+        if self._io_refs <= 0:
+            self._real_close()
 
-    def getpeercert(self, binary_form=False):
+    def _real_close(self) -> None:
+        try:
+            return self.connection.close()  # type: ignore[no-any-return]
+        except OpenSSL.SSL.Error:
+            return
+
+    @typing.overload
+    def getpeercert(
+        self, binary_form: typing.Literal[False] = False
+    ) -> dict[str, list[typing.Any]] | None: ...
+
+    @typing.overload
+    def getpeercert(self, binary_form: typing.Literal[True]) -> bytes | None: ...
+
+    def getpeercert(
+        self, binary_form: bool = False
+    ) -> dict[str, list[typing.Any]] | bytes | None:
         x509 = self.connection.get_peer_certificate()
 
-        if not x509:
-            return x509
+        if x509 is None:
+            return None
 
         if binary_form:
             return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)
 
         return {
-            "subject": ((("commonName", x509.get_subject().CN),),),
+            "subject": ((("commonName", _get_common_name(x509)),),),  # type: ignore[dict-item]
             "subjectAltName": get_subj_alt_name(x509),
         }
 
-    def version(self):
+    def version(self) -> str:
         return self.connection.get_protocol_version_name()
 
-    def _reuse(self):
-        self._makefile_refs += 1
-
-    def _drop(self):
-        if self._makefile_refs < 1:
-            self.close()
-        else:
-            self._makefile_refs -= 1
+    def selected_alpn_protocol(self) -> str | None:
+        alpn_proto = self.connection.get_alpn_proto_negotiated()
+        return alpn_proto.decode() if alpn_proto else None
 
 
-if _fileobject:  # Platform-specific: Python 2
-
-    def makefile(self, mode, bufsize=-1):
-        self._makefile_refs += 1
-        return _fileobject(self, mode, bufsize, close=True)
-
-else:  # Platform-specific: Python 3
-    makefile = backport_makefile
-
-WrappedSocket.makefile = makefile
+WrappedSocket.makefile = socket_cls.makefile  # type: ignore[attr-defined]
 
 
-class PyOpenSSLContext(object):
+class PyOpenSSLContext:
     """
     I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
     for translating the interface of the standard library ``SSLContext`` object
     to calls into PyOpenSSL.
     """
 
-    def __init__(self, protocol):
+    def __init__(self, protocol: int) -> None:
         self.protocol = _openssl_versions[protocol]
         self._ctx = OpenSSL.SSL.Context(self.protocol)
         self._options = 0
         self.check_hostname = False
+        self._minimum_version: int = ssl.TLSVersion.MINIMUM_SUPPORTED
+        self._maximum_version: int = ssl.TLSVersion.MAXIMUM_SUPPORTED
+        self._verify_flags: int = ssl.VERIFY_X509_TRUSTED_FIRST
 
     @property
-    def options(self):
+    def options(self) -> int:
         return self._options
 
     @options.setter
-    def options(self, value):
+    def options(self, value: int) -> None:
         self._options = value
-        self._ctx.set_options(value)
+        self._set_ctx_options()
 
     @property
-    def verify_mode(self):
+    def verify_flags(self) -> int:
+        return self._verify_flags
+
+    @verify_flags.setter
+    def verify_flags(self, value: int) -> None:
+        self._verify_flags = value
+        self._ctx.get_cert_store().set_flags(self._verify_flags)  # type: ignore[union-attr]
+
+    @property
+    def verify_mode(self) -> int:
         return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]
 
     @verify_mode.setter
-    def verify_mode(self, value):
+    def verify_mode(self, value: ssl.VerifyMode) -> None:
         self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)
 
-    def set_default_verify_paths(self):
+    def set_default_verify_paths(self) -> None:
         self._ctx.set_default_verify_paths()
 
-    def set_ciphers(self, ciphers):
-        if isinstance(ciphers, six.text_type):
+    def set_ciphers(self, ciphers: bytes | str) -> None:
+        if isinstance(ciphers, str):
             ciphers = ciphers.encode("utf-8")
         self._ctx.set_cipher_list(ciphers)
 
-    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+    def load_verify_locations(
+        self,
+        cafile: str | None = None,
+        capath: str | None = None,
+        cadata: bytes | None = None,
+    ) -> None:
         if cafile is not None:
-            cafile = cafile.encode("utf-8")
+            cafile = cafile.encode("utf-8")  # type: ignore[assignment]
         if capath is not None:
-            capath = capath.encode("utf-8")
+            capath = capath.encode("utf-8")  # type: ignore[assignment]
         try:
             self._ctx.load_verify_locations(cafile, capath)
             if cadata is not None:
-                self._ctx.load_verify_locations(BytesIO(cadata))
+                self._ctx.load_verify_locations(cadata)
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError("unable to load trusted certificates: %r" % e)
+            raise ssl.SSLError(f"unable to load trusted certificates: {e!r}") from e
 
-    def load_cert_chain(self, certfile, keyfile=None, password=None):
-        self._ctx.use_certificate_chain_file(certfile)
-        if password is not None:
-            if not isinstance(password, six.binary_type):
-                password = password.encode("utf-8")
-            self._ctx.set_passwd_cb(lambda *_: password)
-        self._ctx.use_privatekey_file(keyfile or certfile)
+    def load_cert_chain(
+        self,
+        certfile: str,
+        keyfile: str | None = None,
+        password: str | bytes | None = None,
+    ) -> None:
+        try:
+            self._ctx.use_certificate_chain_file(certfile)
+            if password is not None:
+                if not isinstance(password, bytes):
+                    password = password.encode("utf-8")
+                # pyOpenSSL added cryptography-key support in 24.3.0.
+                # Keep using the older password-callback path until 2026's
+                # versions because set_passwd_cb() became deprecated in 26.3.0.
+                if int(OpenSSL.__version__.split(".")[0]) >= 26:
+                    with open(keyfile or certfile, "rb") as key_file:
+                        key_data = key_file.read()
+                    try:
+                        private_key = load_pem_private_key(key_data, password)
+                    except TypeError:
+                        # Match SSLContext by ignoring passwords supplied
+                        # for unencrypted keys.
+                        # Incorrect passwords for encrypted keys raise
+                        # ValueError instead.
+                        private_key = load_pem_private_key(key_data, None)
+                    # cryptography's loader returns a wider private-key union
+                    # than pyOpenSSL accepts, so we add `type: ignore` here.
+                    self._ctx.use_privatekey(private_key)  # type: ignore[arg-type]
+                else:
+                    self._ctx.set_passwd_cb(lambda *_: password)
+                    self._ctx.use_privatekey_file(keyfile or certfile)
+            else:
+                self._ctx.use_privatekey_file(keyfile or certfile)
+        except (OpenSSL.SSL.Error, TypeError, ValueError) as e:
+            raise ssl.SSLError(f"Unable to load certificate chain: {e!r}") from e
 
-    def set_alpn_protocols(self, protocols):
-        protocols = [six.ensure_binary(p) for p in protocols]
-        return self._ctx.set_alpn_protos(protocols)
+    def set_alpn_protocols(self, protocols: list[bytes | str]) -> None:
+        protocols = [util.util.to_bytes(p, "ascii") for p in protocols]
+        return self._ctx.set_alpn_protos(protocols)  # type: ignore[arg-type]
 
     def wrap_socket(
         self,
-        sock,
-        server_side=False,
-        do_handshake_on_connect=True,
-        suppress_ragged_eofs=True,
-        server_hostname=None,
-    ):
+        sock: socket_cls,
+        server_side: bool = False,
+        do_handshake_on_connect: bool = True,
+        suppress_ragged_eofs: bool = True,
+        server_hostname: bytes | str | None = None,
+    ) -> WrappedSocket:
         cnx = OpenSSL.SSL.Connection(self._ctx, sock)
 
-        if isinstance(server_hostname, six.text_type):  # Platform-specific: Python 3
-            server_hostname = server_hostname.encode("utf-8")
-
-        if server_hostname is not None:
+        # If server_hostname is an IP, don't use it for SNI, per RFC6066 Section 3
+        if server_hostname and not util.ssl_.is_ipaddress(server_hostname):
+            if isinstance(server_hostname, str):
+                server_hostname = server_hostname.encode("utf-8")
             cnx.set_tlsext_host_name(server_hostname)
 
         cnx.set_connect_state()
@@ -503,16 +557,47 @@ class PyOpenSSLContext(object):
         while True:
             try:
                 cnx.do_handshake()
-            except OpenSSL.SSL.WantReadError:
+            except OpenSSL.SSL.WantReadError as e:
                 if not util.wait_for_read(sock, sock.gettimeout()):
-                    raise timeout("select timed out")
+                    raise TimeoutError("select timed out") from e
                 continue
             except OpenSSL.SSL.Error as e:
-                raise ssl.SSLError("bad handshake: %r" % e)
+                raise ssl.SSLError(f"bad handshake: {e!r}") from e
             break
 
         return WrappedSocket(cnx, sock)
 
+    def _set_ctx_options(self) -> None:
+        self._ctx.set_options(
+            self._options
+            | _openssl_to_ssl_minimum_version[self._minimum_version]
+            | _openssl_to_ssl_maximum_version[self._maximum_version]
+        )
 
-def _verify_callback(cnx, x509, err_no, err_depth, return_code):
+    @property
+    def minimum_version(self) -> int:
+        return self._minimum_version
+
+    @minimum_version.setter
+    def minimum_version(self, minimum_version: int) -> None:
+        self._minimum_version = minimum_version
+        self._set_ctx_options()
+
+    @property
+    def maximum_version(self) -> int:
+        return self._maximum_version
+
+    @maximum_version.setter
+    def maximum_version(self, maximum_version: int) -> None:
+        self._maximum_version = maximum_version
+        self._set_ctx_options()
+
+
+def _verify_callback(
+    cnx: OpenSSL.SSL.Connection,
+    x509: X509,
+    err_no: int,
+    err_depth: int,
+    return_code: int,
+) -> bool:
     return err_no == 0
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/securetransport.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/securetransport.py
deleted file mode 100644
index 722ee4e..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/securetransport.py
+++ /dev/null
@@ -1,920 +0,0 @@
-"""
-SecureTranport support for urllib3 via ctypes.
-
-This makes platform-native TLS available to urllib3 users on macOS without the
-use of a compiler. This is an important feature because the Python Package
-Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
-that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
-this is to give macOS users an alternative solution to the problem, and that
-solution is to use SecureTransport.
-
-We use ctypes here because this solution must not require a compiler. That's
-because pip is not allowed to require a compiler either.
-
-This is not intended to be a seriously long-term solution to this problem.
-The hope is that PEP 543 will eventually solve this issue for us, at which
-point we can retire this contrib module. But in the short term, we need to
-solve the impending tire fire that is Python on Mac without this kind of
-contrib module. So...here we are.
-
-To use this module, simply import and inject it::
-
-    import pip._vendor.urllib3.contrib.securetransport as securetransport
-    securetransport.inject_into_urllib3()
-
-Happy TLSing!
-
-This code is a bastardised version of the code found in Will Bond's oscrypto
-library. An enormous debt is owed to him for blazing this trail for us. For
-that reason, this code should be considered to be covered both by urllib3's
-license and by oscrypto's:
-
-.. code-block::
-
-    Copyright (c) 2015-2016 Will Bond 
-
-    Permission is hereby granted, free of charge, to any person obtaining a
-    copy of this software and associated documentation files (the "Software"),
-    to deal in the Software without restriction, including without limitation
-    the rights to use, copy, modify, merge, publish, distribute, sublicense,
-    and/or sell copies of the Software, and to permit persons to whom the
-    Software is furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in
-    all copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-    DEALINGS IN THE SOFTWARE.
-"""
-from __future__ import absolute_import
-
-import contextlib
-import ctypes
-import errno
-import os.path
-import shutil
-import socket
-import ssl
-import struct
-import threading
-import weakref
-
-from .. import util
-from ..packages import six
-from ..util.ssl_ import PROTOCOL_TLS_CLIENT
-from ._securetransport.bindings import CoreFoundation, Security, SecurityConst
-from ._securetransport.low_level import (
-    _assert_no_error,
-    _build_tls_unknown_ca_alert,
-    _cert_array_from_pem,
-    _create_cfstring_array,
-    _load_client_cert_chain,
-    _temporary_keychain,
-)
-
-try:  # Platform-specific: Python 2
-    from socket import _fileobject
-except ImportError:  # Platform-specific: Python 3
-    _fileobject = None
-    from ..packages.backports.makefile import backport_makefile
-
-__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
-
-# SNI always works
-HAS_SNI = True
-
-orig_util_HAS_SNI = util.HAS_SNI
-orig_util_SSLContext = util.ssl_.SSLContext
-
-# This dictionary is used by the read callback to obtain a handle to the
-# calling wrapped socket. This is a pretty silly approach, but for now it'll
-# do. I feel like I should be able to smuggle a handle to the wrapped socket
-# directly in the SSLConnectionRef, but for now this approach will work I
-# guess.
-#
-# We need to lock around this structure for inserts, but we don't do it for
-# reads/writes in the callbacks. The reasoning here goes as follows:
-#
-#    1. It is not possible to call into the callbacks before the dictionary is
-#       populated, so once in the callback the id must be in the dictionary.
-#    2. The callbacks don't mutate the dictionary, they only read from it, and
-#       so cannot conflict with any of the insertions.
-#
-# This is good: if we had to lock in the callbacks we'd drastically slow down
-# the performance of this code.
-_connection_refs = weakref.WeakValueDictionary()
-_connection_ref_lock = threading.Lock()
-
-# Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over
-# for no better reason than we need *a* limit, and this one is right there.
-SSL_WRITE_BLOCKSIZE = 16384
-
-# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to
-# individual cipher suites. We need to do this because this is how
-# SecureTransport wants them.
-CIPHER_SUITES = [
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
-    SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
-    SecurityConst.TLS_AES_256_GCM_SHA384,
-    SecurityConst.TLS_AES_128_GCM_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_AES_128_CCM_8_SHA256,
-    SecurityConst.TLS_AES_128_CCM_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA,
-]
-
-# Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of
-# TLSv1 and a high of TLSv1.2. For everything else, we pin to that version.
-# TLSv1 to 1.2 are supported on macOS 10.8+
-_protocol_to_min_max = {
-    util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
-    PROTOCOL_TLS_CLIENT: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
-}
-
-if hasattr(ssl, "PROTOCOL_SSLv2"):
-    _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = (
-        SecurityConst.kSSLProtocol2,
-        SecurityConst.kSSLProtocol2,
-    )
-if hasattr(ssl, "PROTOCOL_SSLv3"):
-    _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = (
-        SecurityConst.kSSLProtocol3,
-        SecurityConst.kSSLProtocol3,
-    )
-if hasattr(ssl, "PROTOCOL_TLSv1"):
-    _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = (
-        SecurityConst.kTLSProtocol1,
-        SecurityConst.kTLSProtocol1,
-    )
-if hasattr(ssl, "PROTOCOL_TLSv1_1"):
-    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = (
-        SecurityConst.kTLSProtocol11,
-        SecurityConst.kTLSProtocol11,
-    )
-if hasattr(ssl, "PROTOCOL_TLSv1_2"):
-    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = (
-        SecurityConst.kTLSProtocol12,
-        SecurityConst.kTLSProtocol12,
-    )
-
-
-def inject_into_urllib3():
-    """
-    Monkey-patch urllib3 with SecureTransport-backed SSL-support.
-    """
-    util.SSLContext = SecureTransportContext
-    util.ssl_.SSLContext = SecureTransportContext
-    util.HAS_SNI = HAS_SNI
-    util.ssl_.HAS_SNI = HAS_SNI
-    util.IS_SECURETRANSPORT = True
-    util.ssl_.IS_SECURETRANSPORT = True
-
-
-def extract_from_urllib3():
-    """
-    Undo monkey-patching by :func:`inject_into_urllib3`.
-    """
-    util.SSLContext = orig_util_SSLContext
-    util.ssl_.SSLContext = orig_util_SSLContext
-    util.HAS_SNI = orig_util_HAS_SNI
-    util.ssl_.HAS_SNI = orig_util_HAS_SNI
-    util.IS_SECURETRANSPORT = False
-    util.ssl_.IS_SECURETRANSPORT = False
-
-
-def _read_callback(connection_id, data_buffer, data_length_pointer):
-    """
-    SecureTransport read callback. This is called by ST to request that data
-    be returned from the socket.
-    """
-    wrapped_socket = None
-    try:
-        wrapped_socket = _connection_refs.get(connection_id)
-        if wrapped_socket is None:
-            return SecurityConst.errSSLInternal
-        base_socket = wrapped_socket.socket
-
-        requested_length = data_length_pointer[0]
-
-        timeout = wrapped_socket.gettimeout()
-        error = None
-        read_count = 0
-
-        try:
-            while read_count < requested_length:
-                if timeout is None or timeout >= 0:
-                    if not util.wait_for_read(base_socket, timeout):
-                        raise socket.error(errno.EAGAIN, "timed out")
-
-                remaining = requested_length - read_count
-                buffer = (ctypes.c_char * remaining).from_address(
-                    data_buffer + read_count
-                )
-                chunk_size = base_socket.recv_into(buffer, remaining)
-                read_count += chunk_size
-                if not chunk_size:
-                    if not read_count:
-                        return SecurityConst.errSSLClosedGraceful
-                    break
-        except (socket.error) as e:
-            error = e.errno
-
-            if error is not None and error != errno.EAGAIN:
-                data_length_pointer[0] = read_count
-                if error == errno.ECONNRESET or error == errno.EPIPE:
-                    return SecurityConst.errSSLClosedAbort
-                raise
-
-        data_length_pointer[0] = read_count
-
-        if read_count != requested_length:
-            return SecurityConst.errSSLWouldBlock
-
-        return 0
-    except Exception as e:
-        if wrapped_socket is not None:
-            wrapped_socket._exception = e
-        return SecurityConst.errSSLInternal
-
-
-def _write_callback(connection_id, data_buffer, data_length_pointer):
-    """
-    SecureTransport write callback. This is called by ST to request that data
-    actually be sent on the network.
-    """
-    wrapped_socket = None
-    try:
-        wrapped_socket = _connection_refs.get(connection_id)
-        if wrapped_socket is None:
-            return SecurityConst.errSSLInternal
-        base_socket = wrapped_socket.socket
-
-        bytes_to_write = data_length_pointer[0]
-        data = ctypes.string_at(data_buffer, bytes_to_write)
-
-        timeout = wrapped_socket.gettimeout()
-        error = None
-        sent = 0
-
-        try:
-            while sent < bytes_to_write:
-                if timeout is None or timeout >= 0:
-                    if not util.wait_for_write(base_socket, timeout):
-                        raise socket.error(errno.EAGAIN, "timed out")
-                chunk_sent = base_socket.send(data)
-                sent += chunk_sent
-
-                # This has some needless copying here, but I'm not sure there's
-                # much value in optimising this data path.
-                data = data[chunk_sent:]
-        except (socket.error) as e:
-            error = e.errno
-
-            if error is not None and error != errno.EAGAIN:
-                data_length_pointer[0] = sent
-                if error == errno.ECONNRESET or error == errno.EPIPE:
-                    return SecurityConst.errSSLClosedAbort
-                raise
-
-        data_length_pointer[0] = sent
-
-        if sent != bytes_to_write:
-            return SecurityConst.errSSLWouldBlock
-
-        return 0
-    except Exception as e:
-        if wrapped_socket is not None:
-            wrapped_socket._exception = e
-        return SecurityConst.errSSLInternal
-
-
-# We need to keep these two objects references alive: if they get GC'd while
-# in use then SecureTransport could attempt to call a function that is in freed
-# memory. That would be...uh...bad. Yeah, that's the word. Bad.
-_read_callback_pointer = Security.SSLReadFunc(_read_callback)
-_write_callback_pointer = Security.SSLWriteFunc(_write_callback)
-
-
-class WrappedSocket(object):
-    """
-    API-compatibility wrapper for Python's OpenSSL wrapped socket object.
-
-    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
-    collector of PyPy.
-    """
-
-    def __init__(self, socket):
-        self.socket = socket
-        self.context = None
-        self._makefile_refs = 0
-        self._closed = False
-        self._exception = None
-        self._keychain = None
-        self._keychain_dir = None
-        self._client_cert_chain = None
-
-        # We save off the previously-configured timeout and then set it to
-        # zero. This is done because we use select and friends to handle the
-        # timeouts, but if we leave the timeout set on the lower socket then
-        # Python will "kindly" call select on that socket again for us. Avoid
-        # that by forcing the timeout to zero.
-        self._timeout = self.socket.gettimeout()
-        self.socket.settimeout(0)
-
-    @contextlib.contextmanager
-    def _raise_on_error(self):
-        """
-        A context manager that can be used to wrap calls that do I/O from
-        SecureTransport. If any of the I/O callbacks hit an exception, this
-        context manager will correctly propagate the exception after the fact.
-        This avoids silently swallowing those exceptions.
-
-        It also correctly forces the socket closed.
-        """
-        self._exception = None
-
-        # We explicitly don't catch around this yield because in the unlikely
-        # event that an exception was hit in the block we don't want to swallow
-        # it.
-        yield
-        if self._exception is not None:
-            exception, self._exception = self._exception, None
-            self.close()
-            raise exception
-
-    def _set_ciphers(self):
-        """
-        Sets up the allowed ciphers. By default this matches the set in
-        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
-        custom and doesn't allow changing at this time, mostly because parsing
-        OpenSSL cipher strings is going to be a freaking nightmare.
-        """
-        ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES)
-        result = Security.SSLSetEnabledCiphers(
-            self.context, ciphers, len(CIPHER_SUITES)
-        )
-        _assert_no_error(result)
-
-    def _set_alpn_protocols(self, protocols):
-        """
-        Sets up the ALPN protocols on the context.
-        """
-        if not protocols:
-            return
-        protocols_arr = _create_cfstring_array(protocols)
-        try:
-            result = Security.SSLSetALPNProtocols(self.context, protocols_arr)
-            _assert_no_error(result)
-        finally:
-            CoreFoundation.CFRelease(protocols_arr)
-
-    def _custom_validate(self, verify, trust_bundle):
-        """
-        Called when we have set custom validation. We do this in two cases:
-        first, when cert validation is entirely disabled; and second, when
-        using a custom trust DB.
-        Raises an SSLError if the connection is not trusted.
-        """
-        # If we disabled cert validation, just say: cool.
-        if not verify:
-            return
-
-        successes = (
-            SecurityConst.kSecTrustResultUnspecified,
-            SecurityConst.kSecTrustResultProceed,
-        )
-        try:
-            trust_result = self._evaluate_trust(trust_bundle)
-            if trust_result in successes:
-                return
-            reason = "error code: %d" % (trust_result,)
-        except Exception as e:
-            # Do not trust on error
-            reason = "exception: %r" % (e,)
-
-        # SecureTransport does not send an alert nor shuts down the connection.
-        rec = _build_tls_unknown_ca_alert(self.version())
-        self.socket.sendall(rec)
-        # close the connection immediately
-        # l_onoff = 1, activate linger
-        # l_linger = 0, linger for 0 seoncds
-        opts = struct.pack("ii", 1, 0)
-        self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_LINGER, opts)
-        self.close()
-        raise ssl.SSLError("certificate verify failed, %s" % reason)
-
-    def _evaluate_trust(self, trust_bundle):
-        # We want data in memory, so load it up.
-        if os.path.isfile(trust_bundle):
-            with open(trust_bundle, "rb") as f:
-                trust_bundle = f.read()
-
-        cert_array = None
-        trust = Security.SecTrustRef()
-
-        try:
-            # Get a CFArray that contains the certs we want.
-            cert_array = _cert_array_from_pem(trust_bundle)
-
-            # Ok, now the hard part. We want to get the SecTrustRef that ST has
-            # created for this connection, shove our CAs into it, tell ST to
-            # ignore everything else it knows, and then ask if it can build a
-            # chain. This is a buuuunch of code.
-            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
-            _assert_no_error(result)
-            if not trust:
-                raise ssl.SSLError("Failed to copy trust reference")
-
-            result = Security.SecTrustSetAnchorCertificates(trust, cert_array)
-            _assert_no_error(result)
-
-            result = Security.SecTrustSetAnchorCertificatesOnly(trust, True)
-            _assert_no_error(result)
-
-            trust_result = Security.SecTrustResultType()
-            result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result))
-            _assert_no_error(result)
-        finally:
-            if trust:
-                CoreFoundation.CFRelease(trust)
-
-            if cert_array is not None:
-                CoreFoundation.CFRelease(cert_array)
-
-        return trust_result.value
-
-    def handshake(
-        self,
-        server_hostname,
-        verify,
-        trust_bundle,
-        min_version,
-        max_version,
-        client_cert,
-        client_key,
-        client_key_passphrase,
-        alpn_protocols,
-    ):
-        """
-        Actually performs the TLS handshake. This is run automatically by
-        wrapped socket, and shouldn't be needed in user code.
-        """
-        # First, we do the initial bits of connection setup. We need to create
-        # a context, set its I/O funcs, and set the connection reference.
-        self.context = Security.SSLCreateContext(
-            None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType
-        )
-        result = Security.SSLSetIOFuncs(
-            self.context, _read_callback_pointer, _write_callback_pointer
-        )
-        _assert_no_error(result)
-
-        # Here we need to compute the handle to use. We do this by taking the
-        # id of self modulo 2**31 - 1. If this is already in the dictionary, we
-        # just keep incrementing by one until we find a free space.
-        with _connection_ref_lock:
-            handle = id(self) % 2147483647
-            while handle in _connection_refs:
-                handle = (handle + 1) % 2147483647
-            _connection_refs[handle] = self
-
-        result = Security.SSLSetConnection(self.context, handle)
-        _assert_no_error(result)
-
-        # If we have a server hostname, we should set that too.
-        if server_hostname:
-            if not isinstance(server_hostname, bytes):
-                server_hostname = server_hostname.encode("utf-8")
-
-            result = Security.SSLSetPeerDomainName(
-                self.context, server_hostname, len(server_hostname)
-            )
-            _assert_no_error(result)
-
-        # Setup the ciphers.
-        self._set_ciphers()
-
-        # Setup the ALPN protocols.
-        self._set_alpn_protocols(alpn_protocols)
-
-        # Set the minimum and maximum TLS versions.
-        result = Security.SSLSetProtocolVersionMin(self.context, min_version)
-        _assert_no_error(result)
-
-        result = Security.SSLSetProtocolVersionMax(self.context, max_version)
-        _assert_no_error(result)
-
-        # If there's a trust DB, we need to use it. We do that by telling
-        # SecureTransport to break on server auth. We also do that if we don't
-        # want to validate the certs at all: we just won't actually do any
-        # authing in that case.
-        if not verify or trust_bundle is not None:
-            result = Security.SSLSetSessionOption(
-                self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True
-            )
-            _assert_no_error(result)
-
-        # If there's a client cert, we need to use it.
-        if client_cert:
-            self._keychain, self._keychain_dir = _temporary_keychain()
-            self._client_cert_chain = _load_client_cert_chain(
-                self._keychain, client_cert, client_key
-            )
-            result = Security.SSLSetCertificate(self.context, self._client_cert_chain)
-            _assert_no_error(result)
-
-        while True:
-            with self._raise_on_error():
-                result = Security.SSLHandshake(self.context)
-
-                if result == SecurityConst.errSSLWouldBlock:
-                    raise socket.timeout("handshake timed out")
-                elif result == SecurityConst.errSSLServerAuthCompleted:
-                    self._custom_validate(verify, trust_bundle)
-                    continue
-                else:
-                    _assert_no_error(result)
-                    break
-
-    def fileno(self):
-        return self.socket.fileno()
-
-    # Copy-pasted from Python 3.5 source code
-    def _decref_socketios(self):
-        if self._makefile_refs > 0:
-            self._makefile_refs -= 1
-        if self._closed:
-            self.close()
-
-    def recv(self, bufsiz):
-        buffer = ctypes.create_string_buffer(bufsiz)
-        bytes_read = self.recv_into(buffer, bufsiz)
-        data = buffer[:bytes_read]
-        return data
-
-    def recv_into(self, buffer, nbytes=None):
-        # Read short on EOF.
-        if self._closed:
-            return 0
-
-        if nbytes is None:
-            nbytes = len(buffer)
-
-        buffer = (ctypes.c_char * nbytes).from_buffer(buffer)
-        processed_bytes = ctypes.c_size_t(0)
-
-        with self._raise_on_error():
-            result = Security.SSLRead(
-                self.context, buffer, nbytes, ctypes.byref(processed_bytes)
-            )
-
-        # There are some result codes that we want to treat as "not always
-        # errors". Specifically, those are errSSLWouldBlock,
-        # errSSLClosedGraceful, and errSSLClosedNoNotify.
-        if result == SecurityConst.errSSLWouldBlock:
-            # If we didn't process any bytes, then this was just a time out.
-            # However, we can get errSSLWouldBlock in situations when we *did*
-            # read some data, and in those cases we should just read "short"
-            # and return.
-            if processed_bytes.value == 0:
-                # Timed out, no data read.
-                raise socket.timeout("recv timed out")
-        elif result in (
-            SecurityConst.errSSLClosedGraceful,
-            SecurityConst.errSSLClosedNoNotify,
-        ):
-            # The remote peer has closed this connection. We should do so as
-            # well. Note that we don't actually return here because in
-            # principle this could actually be fired along with return data.
-            # It's unlikely though.
-            self.close()
-        else:
-            _assert_no_error(result)
-
-        # Ok, we read and probably succeeded. We should return whatever data
-        # was actually read.
-        return processed_bytes.value
-
-    def settimeout(self, timeout):
-        self._timeout = timeout
-
-    def gettimeout(self):
-        return self._timeout
-
-    def send(self, data):
-        processed_bytes = ctypes.c_size_t(0)
-
-        with self._raise_on_error():
-            result = Security.SSLWrite(
-                self.context, data, len(data), ctypes.byref(processed_bytes)
-            )
-
-        if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0:
-            # Timed out
-            raise socket.timeout("send timed out")
-        else:
-            _assert_no_error(result)
-
-        # We sent, and probably succeeded. Tell them how much we sent.
-        return processed_bytes.value
-
-    def sendall(self, data):
-        total_sent = 0
-        while total_sent < len(data):
-            sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE])
-            total_sent += sent
-
-    def shutdown(self):
-        with self._raise_on_error():
-            Security.SSLClose(self.context)
-
-    def close(self):
-        # TODO: should I do clean shutdown here? Do I have to?
-        if self._makefile_refs < 1:
-            self._closed = True
-            if self.context:
-                CoreFoundation.CFRelease(self.context)
-                self.context = None
-            if self._client_cert_chain:
-                CoreFoundation.CFRelease(self._client_cert_chain)
-                self._client_cert_chain = None
-            if self._keychain:
-                Security.SecKeychainDelete(self._keychain)
-                CoreFoundation.CFRelease(self._keychain)
-                shutil.rmtree(self._keychain_dir)
-                self._keychain = self._keychain_dir = None
-            return self.socket.close()
-        else:
-            self._makefile_refs -= 1
-
-    def getpeercert(self, binary_form=False):
-        # Urgh, annoying.
-        #
-        # Here's how we do this:
-        #
-        # 1. Call SSLCopyPeerTrust to get hold of the trust object for this
-        #    connection.
-        # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf.
-        # 3. To get the CN, call SecCertificateCopyCommonName and process that
-        #    string so that it's of the appropriate type.
-        # 4. To get the SAN, we need to do something a bit more complex:
-        #    a. Call SecCertificateCopyValues to get the data, requesting
-        #       kSecOIDSubjectAltName.
-        #    b. Mess about with this dictionary to try to get the SANs out.
-        #
-        # This is gross. Really gross. It's going to be a few hundred LoC extra
-        # just to repeat something that SecureTransport can *already do*. So my
-        # operating assumption at this time is that what we want to do is
-        # instead to just flag to urllib3 that it shouldn't do its own hostname
-        # validation when using SecureTransport.
-        if not binary_form:
-            raise ValueError("SecureTransport only supports dumping binary certs")
-        trust = Security.SecTrustRef()
-        certdata = None
-        der_bytes = None
-
-        try:
-            # Grab the trust store.
-            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
-            _assert_no_error(result)
-            if not trust:
-                # Probably we haven't done the handshake yet. No biggie.
-                return None
-
-            cert_count = Security.SecTrustGetCertificateCount(trust)
-            if not cert_count:
-                # Also a case that might happen if we haven't handshaked.
-                # Handshook? Handshaken?
-                return None
-
-            leaf = Security.SecTrustGetCertificateAtIndex(trust, 0)
-            assert leaf
-
-            # Ok, now we want the DER bytes.
-            certdata = Security.SecCertificateCopyData(leaf)
-            assert certdata
-
-            data_length = CoreFoundation.CFDataGetLength(certdata)
-            data_buffer = CoreFoundation.CFDataGetBytePtr(certdata)
-            der_bytes = ctypes.string_at(data_buffer, data_length)
-        finally:
-            if certdata:
-                CoreFoundation.CFRelease(certdata)
-            if trust:
-                CoreFoundation.CFRelease(trust)
-
-        return der_bytes
-
-    def version(self):
-        protocol = Security.SSLProtocol()
-        result = Security.SSLGetNegotiatedProtocolVersion(
-            self.context, ctypes.byref(protocol)
-        )
-        _assert_no_error(result)
-        if protocol.value == SecurityConst.kTLSProtocol13:
-            raise ssl.SSLError("SecureTransport does not support TLS 1.3")
-        elif protocol.value == SecurityConst.kTLSProtocol12:
-            return "TLSv1.2"
-        elif protocol.value == SecurityConst.kTLSProtocol11:
-            return "TLSv1.1"
-        elif protocol.value == SecurityConst.kTLSProtocol1:
-            return "TLSv1"
-        elif protocol.value == SecurityConst.kSSLProtocol3:
-            return "SSLv3"
-        elif protocol.value == SecurityConst.kSSLProtocol2:
-            return "SSLv2"
-        else:
-            raise ssl.SSLError("Unknown TLS version: %r" % protocol)
-
-    def _reuse(self):
-        self._makefile_refs += 1
-
-    def _drop(self):
-        if self._makefile_refs < 1:
-            self.close()
-        else:
-            self._makefile_refs -= 1
-
-
-if _fileobject:  # Platform-specific: Python 2
-
-    def makefile(self, mode, bufsize=-1):
-        self._makefile_refs += 1
-        return _fileobject(self, mode, bufsize, close=True)
-
-else:  # Platform-specific: Python 3
-
-    def makefile(self, mode="r", buffering=None, *args, **kwargs):
-        # We disable buffering with SecureTransport because it conflicts with
-        # the buffering that ST does internally (see issue #1153 for more).
-        buffering = 0
-        return backport_makefile(self, mode, buffering, *args, **kwargs)
-
-
-WrappedSocket.makefile = makefile
-
-
-class SecureTransportContext(object):
-    """
-    I am a wrapper class for the SecureTransport library, to translate the
-    interface of the standard library ``SSLContext`` object to calls into
-    SecureTransport.
-    """
-
-    def __init__(self, protocol):
-        self._min_version, self._max_version = _protocol_to_min_max[protocol]
-        self._options = 0
-        self._verify = False
-        self._trust_bundle = None
-        self._client_cert = None
-        self._client_key = None
-        self._client_key_passphrase = None
-        self._alpn_protocols = None
-
-    @property
-    def check_hostname(self):
-        """
-        SecureTransport cannot have its hostname checking disabled. For more,
-        see the comment on getpeercert() in this file.
-        """
-        return True
-
-    @check_hostname.setter
-    def check_hostname(self, value):
-        """
-        SecureTransport cannot have its hostname checking disabled. For more,
-        see the comment on getpeercert() in this file.
-        """
-        pass
-
-    @property
-    def options(self):
-        # TODO: Well, crap.
-        #
-        # So this is the bit of the code that is the most likely to cause us
-        # trouble. Essentially we need to enumerate all of the SSL options that
-        # users might want to use and try to see if we can sensibly translate
-        # them, or whether we should just ignore them.
-        return self._options
-
-    @options.setter
-    def options(self, value):
-        # TODO: Update in line with above.
-        self._options = value
-
-    @property
-    def verify_mode(self):
-        return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE
-
-    @verify_mode.setter
-    def verify_mode(self, value):
-        self._verify = True if value == ssl.CERT_REQUIRED else False
-
-    def set_default_verify_paths(self):
-        # So, this has to do something a bit weird. Specifically, what it does
-        # is nothing.
-        #
-        # This means that, if we had previously had load_verify_locations
-        # called, this does not undo that. We need to do that because it turns
-        # out that the rest of the urllib3 code will attempt to load the
-        # default verify paths if it hasn't been told about any paths, even if
-        # the context itself was sometime earlier. We resolve that by just
-        # ignoring it.
-        pass
-
-    def load_default_certs(self):
-        return self.set_default_verify_paths()
-
-    def set_ciphers(self, ciphers):
-        # For now, we just require the default cipher string.
-        if ciphers != util.ssl_.DEFAULT_CIPHERS:
-            raise ValueError("SecureTransport doesn't support custom cipher strings")
-
-    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
-        # OK, we only really support cadata and cafile.
-        if capath is not None:
-            raise ValueError("SecureTransport does not support cert directories")
-
-        # Raise if cafile does not exist.
-        if cafile is not None:
-            with open(cafile):
-                pass
-
-        self._trust_bundle = cafile or cadata
-
-    def load_cert_chain(self, certfile, keyfile=None, password=None):
-        self._client_cert = certfile
-        self._client_key = keyfile
-        self._client_cert_passphrase = password
-
-    def set_alpn_protocols(self, protocols):
-        """
-        Sets the ALPN protocols that will later be set on the context.
-
-        Raises a NotImplementedError if ALPN is not supported.
-        """
-        if not hasattr(Security, "SSLSetALPNProtocols"):
-            raise NotImplementedError(
-                "SecureTransport supports ALPN only in macOS 10.12+"
-            )
-        self._alpn_protocols = [six.ensure_binary(p) for p in protocols]
-
-    def wrap_socket(
-        self,
-        sock,
-        server_side=False,
-        do_handshake_on_connect=True,
-        suppress_ragged_eofs=True,
-        server_hostname=None,
-    ):
-        # So, what do we do here? Firstly, we assert some properties. This is a
-        # stripped down shim, so there is some functionality we don't support.
-        # See PEP 543 for the real deal.
-        assert not server_side
-        assert do_handshake_on_connect
-        assert suppress_ragged_eofs
-
-        # Ok, we're good to go. Now we want to create the wrapped socket object
-        # and store it in the appropriate place.
-        wrapped_socket = WrappedSocket(sock)
-
-        # Now we can handshake
-        wrapped_socket.handshake(
-            server_hostname,
-            self._verify,
-            self._trust_bundle,
-            self._min_version,
-            self._max_version,
-            self._client_cert,
-            self._client_key,
-            self._client_key_passphrase,
-            self._alpn_protocols,
-        )
-        return wrapped_socket
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/socks.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/socks.py
index c326e80..67fceb0 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/socks.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/contrib/socks.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 This module contains provisional support for SOCKS proxies from within
 urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
@@ -38,7 +37,8 @@ with the proxy:
     proxy_url="socks5h://:@proxy-host"
 
 """
-from __future__ import absolute_import
+
+from __future__ import annotations
 
 try:
     import socks
@@ -51,13 +51,13 @@ except ImportError:
         (
             "SOCKS support in urllib3 requires the installation of optional "
             "dependencies: specifically, PySocks.  For more information, see "
-            "https://urllib3.readthedocs.io/en/1.26.x/contrib.html#socks-proxies"
+            "https://urllib3.readthedocs.io/en/latest/advanced-usage.html#socks-proxies"
         ),
         DependencyWarning,
     )
     raise
 
-from socket import error as SocketError
+import typing
 from socket import timeout as SocketTimeout
 
 from ..connection import HTTPConnection, HTTPSConnection
@@ -69,7 +69,16 @@ from ..util.url import parse_url
 try:
     import ssl
 except ImportError:
-    ssl = None
+    ssl = None  # type: ignore[assignment]
+
+
+class _TYPE_SOCKS_OPTIONS(typing.TypedDict):
+    socks_version: int
+    proxy_host: str | None
+    proxy_port: str | None
+    username: str | None
+    password: str | None
+    rdns: bool
 
 
 class SOCKSConnection(HTTPConnection):
@@ -77,15 +86,20 @@ class SOCKSConnection(HTTPConnection):
     A plain-text HTTP connection that connects via a SOCKS proxy.
     """
 
-    def __init__(self, *args, **kwargs):
-        self._socks_options = kwargs.pop("_socks_options")
-        super(SOCKSConnection, self).__init__(*args, **kwargs)
+    def __init__(
+        self,
+        _socks_options: _TYPE_SOCKS_OPTIONS,
+        *args: typing.Any,
+        **kwargs: typing.Any,
+    ) -> None:
+        self._socks_options = _socks_options
+        super().__init__(*args, **kwargs)
 
-    def _new_conn(self):
+    def _new_conn(self) -> socks.socksocket:
         """
         Establish a new connection via the SOCKS proxy.
         """
-        extra_kw = {}
+        extra_kw: dict[str, typing.Any] = {}
         if self.source_address:
             extra_kw["source_address"] = self.source_address
 
@@ -97,20 +111,19 @@ class SOCKSConnection(HTTPConnection):
                 (self.host, self.port),
                 proxy_type=self._socks_options["socks_version"],
                 proxy_addr=self._socks_options["proxy_host"],
-                proxy_port=self._socks_options["proxy_port"],
+                proxy_port=self._socks_options["proxy_port"],  # type: ignore[arg-type]
                 proxy_username=self._socks_options["username"],
                 proxy_password=self._socks_options["password"],
                 proxy_rdns=self._socks_options["rdns"],
-                timeout=self.timeout,
-                **extra_kw
+                timeout=self.timeout,  # type: ignore[arg-type]
+                **extra_kw,
             )
 
-        except SocketTimeout:
+        except SocketTimeout as e:
             raise ConnectTimeoutError(
                 self,
-                "Connection to %s timed out. (connect timeout=%s)"
-                % (self.host, self.timeout),
-            )
+                f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
+            ) from e
 
         except socks.ProxyError as e:
             # This is fragile as hell, but it seems to be the only way to raise
@@ -120,22 +133,23 @@ class SOCKSConnection(HTTPConnection):
                 if isinstance(error, SocketTimeout):
                     raise ConnectTimeoutError(
                         self,
-                        "Connection to %s timed out. (connect timeout=%s)"
-                        % (self.host, self.timeout),
-                    )
+                        f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
+                    ) from e
                 else:
+                    # Adding `from e` messes with coverage somehow, so it's omitted.
+                    # See #2386.
                     raise NewConnectionError(
-                        self, "Failed to establish a new connection: %s" % error
+                        self, f"Failed to establish a new connection: {error}"
                     )
-            else:
+            else:  # Defensive: see https://github.com/urllib3/urllib3/pull/3728#pullrequestreview-3816302703
                 raise NewConnectionError(
-                    self, "Failed to establish a new connection: %s" % e
-                )
+                    self, f"Failed to establish a new connection: {e}"
+                ) from e
 
-        except SocketError as e:  # Defensive: PySocks should catch all these.
+        except OSError as e:  # Defensive: PySocks should catch all these.
             raise NewConnectionError(
-                self, "Failed to establish a new connection: %s" % e
-            )
+                self, f"Failed to establish a new connection: {e}"
+            ) from e
 
         return conn
 
@@ -169,19 +183,17 @@ class SOCKSProxyManager(PoolManager):
 
     def __init__(
         self,
-        proxy_url,
-        username=None,
-        password=None,
-        num_pools=10,
-        headers=None,
-        **connection_pool_kw
+        proxy_url: str,
+        username: str | None = None,
+        password: str | None = None,
+        num_pools: int = 10,
+        headers: typing.Mapping[str, str] | None = None,
+        **connection_pool_kw: typing.Any,
     ):
         parsed = parse_url(proxy_url)
 
-        if username is None and password is None and parsed.auth is not None:
-            split = parsed.auth.split(":")
-            if len(split) == 2:
-                username, password = split
+        if username is None and password is None:
+            username, password = parsed.auth_decoded
         if parsed.scheme == "socks5":
             socks_version = socks.PROXY_TYPE_SOCKS5
             rdns = False
@@ -195,7 +207,7 @@ class SOCKSProxyManager(PoolManager):
             socks_version = socks.PROXY_TYPE_SOCKS4
             rdns = True
         else:
-            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)
+            raise ValueError(f"Unable to determine SOCKS version from {proxy_url}")
 
         self.proxy_url = proxy_url
 
@@ -209,8 +221,6 @@ class SOCKSProxyManager(PoolManager):
         }
         connection_pool_kw["_socks_options"] = socks_options
 
-        super(SOCKSProxyManager, self).__init__(
-            num_pools, headers, **connection_pool_kw
-        )
+        super().__init__(num_pools, headers, **connection_pool_kw)
 
         self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/exceptions.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/exceptions.py
index cba6f3f..3d7e9b9 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/exceptions.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/exceptions.py
@@ -1,6 +1,16 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
-from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead
+import socket
+import typing
+import warnings
+from email.errors import MessageDefect
+from http.client import IncompleteRead as httplib_IncompleteRead
+
+if typing.TYPE_CHECKING:
+    from .connection import HTTPConnection
+    from .connectionpool import ConnectionPool
+    from .response import HTTPResponse
+    from .util.retry import Retry
 
 # Base Exceptions
 
@@ -8,64 +18,61 @@ from .packages.six.moves.http_client import IncompleteRead as httplib_Incomplete
 class HTTPError(Exception):
     """Base exception used by this module."""
 
-    pass
-
 
 class HTTPWarning(Warning):
     """Base warning used by this module."""
 
-    pass
+
+_TYPE_REDUCE_RESULT = tuple[typing.Callable[..., object], tuple[object, ...]]
 
 
 class PoolError(HTTPError):
     """Base exception for errors caused within a pool."""
 
-    def __init__(self, pool, message):
+    def __init__(self, pool: ConnectionPool, message: str) -> None:
         self.pool = pool
-        HTTPError.__init__(self, "%s: %s" % (pool, message))
+        self._message = message
+        super().__init__(f"{pool}: {message}")
 
-    def __reduce__(self):
+    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
         # For pickling purposes.
-        return self.__class__, (None, None)
+        return self.__class__, (None, self._message)
 
 
 class RequestError(PoolError):
     """Base exception for PoolErrors that have associated URLs."""
 
-    def __init__(self, pool, url, message):
+    def __init__(self, pool: ConnectionPool, url: str | None, message: str) -> None:
         self.url = url
-        PoolError.__init__(self, pool, message)
+        super().__init__(pool, message)
 
-    def __reduce__(self):
+    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
         # For pickling purposes.
-        return self.__class__, (None, self.url, None)
+        return self.__class__, (None, self.url, self._message)
 
 
 class SSLError(HTTPError):
     """Raised when SSL certificate fails in an HTTPS connection."""
 
-    pass
-
 
 class ProxyError(HTTPError):
     """Raised when the connection to a proxy fails."""
 
-    def __init__(self, message, error, *args):
-        super(ProxyError, self).__init__(message, error, *args)
+    # The original error is also available as __cause__.
+    original_error: Exception
+
+    def __init__(self, message: str, error: Exception) -> None:
+        super().__init__(message, error)
         self.original_error = error
 
 
 class DecodeError(HTTPError):
     """Raised when automatic decoding based on Content-Type fails."""
 
-    pass
-
 
 class ProtocolError(HTTPError):
     """Raised when something unexpected happens mid-request/response."""
 
-    pass
-
 
 #: Renamed to ProtocolError but aliased for backwards compatibility.
 ConnectionError = ProtocolError
@@ -79,33 +86,40 @@ class MaxRetryError(RequestError):
 
     :param pool: The connection pool
     :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
-    :param string url: The requested Url
-    :param exceptions.Exception reason: The underlying error
+    :param str url: The requested Url
+    :param reason: The underlying error
+    :type reason: :class:`Exception`
 
     """
 
-    def __init__(self, pool, url, reason=None):
+    def __init__(
+        self, pool: ConnectionPool, url: str | None, reason: Exception | None = None
+    ) -> None:
         self.reason = reason
 
-        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)
+        message = f"Max retries exceeded with url: {url} (Caused by {reason!r})"
 
-        RequestError.__init__(self, pool, url, message)
+        super().__init__(pool, url, message)
+
+    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
+        # For pickling purposes.
+        return self.__class__, (None, self.url, self.reason)
 
 
 class HostChangedError(RequestError):
     """Raised when an existing pool gets a request for a foreign host."""
 
-    def __init__(self, pool, url, retries=3):
-        message = "Tried to open a foreign host with url: %s" % url
-        RequestError.__init__(self, pool, url, message)
+    def __init__(
+        self, pool: ConnectionPool, url: str, retries: Retry | int = 3
+    ) -> None:
+        message = f"Tried to open a foreign host with url: {url}"
+        super().__init__(pool, url, message)
         self.retries = retries
 
 
 class TimeoutStateError(HTTPError):
     """Raised when passing an invalid state to a timeout"""
 
-    pass
-
 
 class TimeoutError(HTTPError):
     """Raised when a socket timeout error occurs.
@@ -114,53 +128,77 @@ class TimeoutError(HTTPError):
     ` and :exc:`ConnectTimeoutErrors `.
     """
 
-    pass
-
 
 class ReadTimeoutError(TimeoutError, RequestError):
     """Raised when a socket timeout occurs while receiving data from a server"""
 
-    pass
-
 
 # This timeout error does not have a URL attached and needs to inherit from the
 # base HTTPError
 class ConnectTimeoutError(TimeoutError):
     """Raised when a socket timeout occurs while connecting to a server"""
 
-    pass
 
-
-class NewConnectionError(ConnectTimeoutError, PoolError):
+class NewConnectionError(ConnectTimeoutError, HTTPError):
     """Raised when we fail to establish a new connection. Usually ECONNREFUSED."""
 
-    pass
+    def __init__(self, conn: HTTPConnection, message: str) -> None:
+        self.conn = conn
+        self._message = message
+        super().__init__(f"{conn}: {message}")
+
+    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
+        # For pickling purposes.
+        return self.__class__, (None, self._message)
+
+    @property
+    def pool(self) -> HTTPConnection:
+        warnings.warn(
+            "The 'pool' property is deprecated and will be removed "
+            "in urllib3 v3.0. Use 'conn' instead.",
+            FutureWarning,
+            stacklevel=2,
+        )
+
+        return self.conn
+
+
+class NameResolutionError(NewConnectionError):
+    """Raised when host name resolution fails."""
+
+    def __init__(self, host: str, conn: HTTPConnection, reason: socket.gaierror):
+        message = f"Failed to resolve '{host}' ({reason})"
+        self._host = host
+        self._reason = reason
+        super().__init__(conn, message)
+
+    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
+        # For pickling purposes.
+        return self.__class__, (self._host, None, self._reason)
 
 
 class EmptyPoolError(PoolError):
     """Raised when a pool runs out of connections and no more are allowed."""
 
-    pass
+
+class FullPoolError(PoolError):
+    """Raised when we try to add a connection to a full pool in blocking mode."""
 
 
 class ClosedPoolError(PoolError):
     """Raised when a request enters a pool after the pool has been closed."""
 
-    pass
-
 
 class LocationValueError(ValueError, HTTPError):
     """Raised when there is something wrong with a given URL input."""
 
-    pass
-
 
 class LocationParseError(LocationValueError):
     """Raised when get_host or similar fails to parse the URL input."""
 
-    def __init__(self, location):
-        message = "Failed to parse: %s" % location
-        HTTPError.__init__(self, message)
+    def __init__(self, location: str) -> None:
+        message = f"Failed to parse: {location}"
+        super().__init__(message)
 
         self.location = location
 
@@ -168,9 +206,9 @@ class LocationParseError(LocationValueError):
 class URLSchemeUnknown(LocationValueError):
     """Raised when a URL input has an unsupported scheme."""
 
-    def __init__(self, scheme):
-        message = "Not supported URL scheme %s" % scheme
-        super(URLSchemeUnknown, self).__init__(message)
+    def __init__(self, scheme: str):
+        message = f"Not supported URL scheme {scheme}"
+        super().__init__(message)
 
         self.scheme = scheme
 
@@ -185,38 +223,22 @@ class ResponseError(HTTPError):
 class SecurityWarning(HTTPWarning):
     """Warned when performing security reducing actions"""
 
-    pass
-
-
-class SubjectAltNameWarning(SecurityWarning):
-    """Warned when connecting to a host with a certificate missing a SAN."""
-
-    pass
-
 
 class InsecureRequestWarning(SecurityWarning):
     """Warned when making an unverified HTTPS request."""
 
-    pass
+
+class NotOpenSSLWarning(SecurityWarning):
+    """Warned when using unsupported SSL library"""
 
 
 class SystemTimeWarning(SecurityWarning):
     """Warned when system time is suspected to be wrong"""
 
-    pass
-
 
 class InsecurePlatformWarning(SecurityWarning):
     """Warned when certain TLS/SSL configuration is not available on a platform."""
 
-    pass
-
-
-class SNIMissingWarning(HTTPWarning):
-    """Warned when making a HTTPS request without SNI available."""
-
-    pass
-
 
 class DependencyWarning(HTTPWarning):
     """
@@ -224,14 +246,10 @@ class DependencyWarning(HTTPWarning):
     dependencies.
     """
 
-    pass
-
 
 class ResponseNotChunked(ProtocolError, ValueError):
     """Response needs to be chunked in order to read it as chunks."""
 
-    pass
-
 
 class BodyNotHttplibCompatible(HTTPError):
     """
@@ -239,8 +257,6 @@ class BodyNotHttplibCompatible(HTTPError):
     (have an fp attribute which returns raw chunks) for read_chunked().
     """
 
-    pass
-
 
 class IncompleteRead(HTTPError, httplib_IncompleteRead):
     """
@@ -250,10 +266,14 @@ class IncompleteRead(HTTPError, httplib_IncompleteRead):
     for ``partial`` to avoid creating large objects on streamed reads.
     """
 
-    def __init__(self, partial, expected):
-        super(IncompleteRead, self).__init__(partial, expected)
+    partial: int  # type: ignore[assignment]
+    expected: int
 
-    def __repr__(self):
+    def __init__(self, partial: int, expected: int) -> None:
+        self.partial = partial
+        self.expected = expected
+
+    def __repr__(self) -> str:
         return "IncompleteRead(%i bytes read, %i more expected)" % (
             self.partial,
             self.expected,
@@ -263,14 +283,13 @@ class IncompleteRead(HTTPError, httplib_IncompleteRead):
 class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
     """Invalid chunk length in a chunked response."""
 
-    def __init__(self, response, length):
-        super(InvalidChunkLength, self).__init__(
-            response.tell(), response.length_remaining
-        )
+    def __init__(self, response: HTTPResponse, length: bytes) -> None:
+        self.partial: int = response.tell()  # type: ignore[assignment]
+        self.expected: int | None = response.length_remaining
         self.response = response
         self.length = length
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return "InvalidChunkLength(got length %r, %i bytes read)" % (
             self.length,
             self.partial,
@@ -280,15 +299,13 @@ class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
 class InvalidHeader(HTTPError):
     """The header provided was somehow invalid."""
 
-    pass
-
 
 class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
     """ProxyManager does not support the supplied scheme"""
 
     # TODO(t-8ch): Stop inheriting from AssertionError in v2.0.
 
-    def __init__(self, scheme):
+    def __init__(self, scheme: str | None) -> None:
         # 'localhost' is here because our URL parser parses
         # localhost:8080 -> scheme=localhost, remove if we fix this.
         if scheme == "localhost":
@@ -296,28 +313,23 @@ class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
         if scheme is None:
             message = "Proxy URL had no scheme, should start with http:// or https://"
         else:
-            message = (
-                "Proxy URL had unsupported scheme %s, should use http:// or https://"
-                % scheme
-            )
-        super(ProxySchemeUnknown, self).__init__(message)
+            message = f"Proxy URL had unsupported scheme {scheme}, should use http:// or https://"
+        super().__init__(message)
 
 
 class ProxySchemeUnsupported(ValueError):
     """Fetching HTTPS resources through HTTPS proxies is unsupported"""
 
-    pass
-
 
 class HeaderParsingError(HTTPError):
     """Raised by assert_header_parsing, but we convert it to a log.warning statement."""
 
-    def __init__(self, defects, unparsed_data):
-        message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data)
-        super(HeaderParsingError, self).__init__(message)
+    def __init__(
+        self, defects: list[MessageDefect], unparsed_data: bytes | str | None
+    ) -> None:
+        message = f"{defects or 'Unknown'}, unparsed data: {unparsed_data!r}"
+        super().__init__(message)
 
 
 class UnrewindableBodyError(HTTPError):
     """urllib3 encountered an error when trying to rewind a body"""
-
-    pass
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/fields.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/fields.py
index 9d630f4..fe68e17 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/fields.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/fields.py
@@ -1,13 +1,20 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import email.utils
 import mimetypes
-import re
+import typing
 
-from .packages import six
+_TYPE_FIELD_VALUE = typing.Union[str, bytes]
+_TYPE_FIELD_VALUE_TUPLE = typing.Union[
+    _TYPE_FIELD_VALUE,
+    tuple[str, _TYPE_FIELD_VALUE],
+    tuple[str, _TYPE_FIELD_VALUE, str],
+]
 
 
-def guess_content_type(filename, default="application/octet-stream"):
+def guess_content_type(
+    filename: str | None, default: str = "application/octet-stream"
+) -> str:
     """
     Guess the "Content-Type" of a file.
 
@@ -21,7 +28,7 @@ def guess_content_type(filename, default="application/octet-stream"):
     return default
 
 
-def format_header_param_rfc2231(name, value):
+def format_header_param_rfc2231(name: str, value: _TYPE_FIELD_VALUE) -> str:
     """
     Helper function to format and quote a single header parameter using the
     strategy defined in RFC 2231.
@@ -34,14 +41,28 @@ def format_header_param_rfc2231(name, value):
         The name of the parameter, a string expected to be ASCII only.
     :param value:
         The value of the parameter, provided as ``bytes`` or `str``.
-    :ret:
+    :returns:
         An RFC-2231-formatted unicode string.
+
+    .. deprecated:: 2.0.0
+        Will be removed in urllib3 v3.0. This is not valid for
+        ``multipart/form-data`` header parameters.
     """
-    if isinstance(value, six.binary_type):
+    import warnings
+
+    warnings.warn(
+        "'format_header_param_rfc2231' is insecure, deprecated and will be "
+        "removed in urllib3 v3.0. This is not valid for "
+        "multipart/form-data header parameters.",
+        FutureWarning,
+        stacklevel=2,
+    )
+
+    if isinstance(value, bytes):
         value = value.decode("utf-8")
 
     if not any(ch in value for ch in '"\\\r\n'):
-        result = u'%s="%s"' % (name, value)
+        result = f'{name}="{value}"'
         try:
             result.encode("ascii")
         except (UnicodeEncodeError, UnicodeDecodeError):
@@ -49,81 +70,87 @@ def format_header_param_rfc2231(name, value):
         else:
             return result
 
-    if six.PY2:  # Python 2:
-        value = value.encode("utf-8")
-
-    # encode_rfc2231 accepts an encoded string and returns an ascii-encoded
-    # string in Python 2 but accepts and returns unicode strings in Python 3
     value = email.utils.encode_rfc2231(value, "utf-8")
-    value = "%s*=%s" % (name, value)
-
-    if six.PY2:  # Python 2:
-        value = value.decode("utf-8")
+    value = f"{name}*={value}"
 
     return value
 
 
-_HTML5_REPLACEMENTS = {
-    u"\u0022": u"%22",
-    # Replace "\" with "\\".
-    u"\u005C": u"\u005C\u005C",
-}
-
-# All control characters from 0x00 to 0x1F *except* 0x1B.
-_HTML5_REPLACEMENTS.update(
-    {
-        six.unichr(cc): u"%{:02X}".format(cc)
-        for cc in range(0x00, 0x1F + 1)
-        if cc not in (0x1B,)
-    }
-)
-
-
-def _replace_multiple(value, needles_and_replacements):
-    def replacer(match):
-        return needles_and_replacements[match.group(0)]
-
-    pattern = re.compile(
-        r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()])
-    )
-
-    result = pattern.sub(replacer, value)
-
-    return result
-
-
-def format_header_param_html5(name, value):
+def format_multipart_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str:
     """
-    Helper function to format and quote a single header parameter using the
-    HTML5 strategy.
+    Format and quote a single multipart header parameter.
 
-    Particularly useful for header parameters which might contain
-    non-ASCII values, like file names. This follows the `HTML5 Working Draft
-    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.
+    This follows the `WHATWG HTML Standard`_ as of 2021/06/10, matching
+    the behavior of current browser and curl versions. Values are
+    assumed to be UTF-8. The ``\\n``, ``\\r``, and ``"`` characters are
+    percent encoded.
 
-    .. _HTML5 Working Draft Section 4.10.22.7:
-        https://w3c.github.io/html/sec-forms.html#multipart-form-data
+    .. _WHATWG HTML Standard:
+        https://html.spec.whatwg.org/multipage/
+        form-control-infrastructure.html#multipart-form-data
 
     :param name:
-        The name of the parameter, a string expected to be ASCII only.
+        The name of the parameter, an ASCII-only ``str``.
     :param value:
-        The value of the parameter, provided as ``bytes`` or `str``.
-    :ret:
-        A unicode string, stripped of troublesome characters.
+        The value of the parameter, a ``str`` or UTF-8 encoded
+        ``bytes``.
+    :returns:
+        A string ``name="value"`` with the escaped value.
+
+    .. versionchanged:: 2.0.0
+        Matches the WHATWG HTML Standard as of 2021/06/10. Control
+        characters are no longer percent encoded.
+
+    .. versionchanged:: 2.0.0
+        Renamed from ``format_header_param_html5`` and
+        ``format_header_param``. The old names will be removed in
+        urllib3 v3.0.
     """
-    if isinstance(value, six.binary_type):
+    if isinstance(value, bytes):
         value = value.decode("utf-8")
 
-    value = _replace_multiple(value, _HTML5_REPLACEMENTS)
-
-    return u'%s="%s"' % (name, value)
+    # percent encode \n \r "
+    value = value.translate({10: "%0A", 13: "%0D", 34: "%22"})
+    return f'{name}="{value}"'
 
 
-# For backwards-compatibility.
-format_header_param = format_header_param_html5
+def format_header_param_html5(name: str, value: _TYPE_FIELD_VALUE) -> str:
+    """
+    .. deprecated:: 2.0.0
+        Renamed to :func:`format_multipart_header_param`. Will be
+        removed in urllib3 v3.0.
+    """
+    import warnings
+
+    warnings.warn(
+        "'format_header_param_html5' has been renamed to "
+        "'format_multipart_header_param'. The old name will be "
+        "removed in urllib3 v3.0.",
+        FutureWarning,
+        stacklevel=2,
+    )
+    return format_multipart_header_param(name, value)
 
 
-class RequestField(object):
+def format_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str:
+    """
+    .. deprecated:: 2.0.0
+        Renamed to :func:`format_multipart_header_param`. Will be
+        removed in urllib3 v3.0.
+    """
+    import warnings
+
+    warnings.warn(
+        "'format_header_param' has been renamed to "
+        "'format_multipart_header_param'. The old name will be "
+        "removed in urllib3 v3.0.",
+        FutureWarning,
+        stacklevel=2,
+    )
+    return format_multipart_header_param(name, value)
+
+
+class RequestField:
     """
     A data container for request body parameters.
 
@@ -135,29 +162,47 @@ class RequestField(object):
         An optional filename of the request field. Must be unicode.
     :param headers:
         An optional dict-like object of headers to initially use for the field.
-    :param header_formatter:
-        An optional callable that is used to encode and format the headers. By
-        default, this is :func:`format_header_param_html5`.
+
+    .. versionchanged:: 2.0.0
+        The ``header_formatter`` parameter is deprecated and will
+        be removed in urllib3 v3.0.
     """
 
     def __init__(
         self,
-        name,
-        data,
-        filename=None,
-        headers=None,
-        header_formatter=format_header_param_html5,
+        name: str,
+        data: _TYPE_FIELD_VALUE,
+        filename: str | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None,
     ):
         self._name = name
         self._filename = filename
         self.data = data
-        self.headers = {}
+        self.headers: dict[str, str | None] = {}
         if headers:
             self.headers = dict(headers)
-        self.header_formatter = header_formatter
+
+        if header_formatter is not None:
+            import warnings
+
+            warnings.warn(
+                "The 'header_formatter' parameter is deprecated and "
+                "will be removed in urllib3 v3.0.",
+                FutureWarning,
+                stacklevel=2,
+            )
+            self.header_formatter = header_formatter
+        else:
+            self.header_formatter = format_multipart_header_param
 
     @classmethod
-    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
+    def from_tuples(
+        cls,
+        fieldname: str,
+        value: _TYPE_FIELD_VALUE_TUPLE,
+        header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None,
+    ) -> RequestField:
         """
         A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.
 
@@ -174,6 +219,10 @@ class RequestField(object):
 
         Field names and filenames must be unicode.
         """
+        filename: str | None
+        content_type: str | None
+        data: _TYPE_FIELD_VALUE
+
         if isinstance(value, tuple):
             if len(value) == 3:
                 filename, data, content_type = value
@@ -192,20 +241,29 @@ class RequestField(object):
 
         return request_param
 
-    def _render_part(self, name, value):
+    def _render_part(self, name: str, value: _TYPE_FIELD_VALUE) -> str:
         """
-        Overridable helper function to format a single header parameter. By
-        default, this calls ``self.header_formatter``.
+        Override this method to change how each multipart header
+        parameter is formatted. By default, this calls
+        :func:`format_multipart_header_param`.
 
         :param name:
-            The name of the parameter, a string expected to be ASCII only.
+            The name of the parameter, an ASCII-only ``str``.
         :param value:
-            The value of the parameter, provided as a unicode string.
-        """
+            The value of the parameter, a ``str`` or UTF-8 encoded
+            ``bytes``.
 
+        :meta public:
+        """
         return self.header_formatter(name, value)
 
-    def _render_parts(self, header_parts):
+    def _render_parts(
+        self,
+        header_parts: (
+            dict[str, _TYPE_FIELD_VALUE | None]
+            | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]
+        ),
+    ) -> str:
         """
         Helper function to format and quote a single header.
 
@@ -216,18 +274,21 @@ class RequestField(object):
             A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
             as `k1="v1"; k2="v2"; ...`.
         """
+        iterable: typing.Iterable[tuple[str, _TYPE_FIELD_VALUE | None]]
+
         parts = []
-        iterable = header_parts
         if isinstance(header_parts, dict):
             iterable = header_parts.items()
+        else:
+            iterable = header_parts
 
         for name, value in iterable:
             if value is not None:
                 parts.append(self._render_part(name, value))
 
-        return u"; ".join(parts)
+        return "; ".join(parts)
 
-    def render_headers(self):
+    def render_headers(self) -> str:
         """
         Renders the headers for this request field.
         """
@@ -236,39 +297,45 @@ class RequestField(object):
         sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"]
         for sort_key in sort_keys:
             if self.headers.get(sort_key, False):
-                lines.append(u"%s: %s" % (sort_key, self.headers[sort_key]))
+                lines.append(f"{sort_key}: {self.headers[sort_key]}")
 
         for header_name, header_value in self.headers.items():
             if header_name not in sort_keys:
                 if header_value:
-                    lines.append(u"%s: %s" % (header_name, header_value))
+                    lines.append(f"{header_name}: {header_value}")
 
-        lines.append(u"\r\n")
-        return u"\r\n".join(lines)
+        lines.append("\r\n")
+        return "\r\n".join(lines)
 
     def make_multipart(
-        self, content_disposition=None, content_type=None, content_location=None
-    ):
+        self,
+        content_disposition: str | None = None,
+        content_type: str | None = None,
+        content_location: str | None = None,
+    ) -> None:
         """
         Makes this request field into a multipart request field.
 
         This method overrides "Content-Disposition", "Content-Type" and
         "Content-Location" headers to the request parameter.
 
+        :param content_disposition:
+            The 'Content-Disposition' of the request body. Defaults to 'form-data'
         :param content_type:
             The 'Content-Type' of the request body.
         :param content_location:
             The 'Content-Location' of the request body.
 
         """
-        self.headers["Content-Disposition"] = content_disposition or u"form-data"
-        self.headers["Content-Disposition"] += u"; ".join(
+        content_disposition = (content_disposition or "form-data") + "; ".join(
             [
-                u"",
+                "",
                 self._render_parts(
-                    ((u"name", self._name), (u"filename", self._filename))
+                    (("name", self._name), ("filename", self._filename))
                 ),
             ]
         )
+
+        self.headers["Content-Disposition"] = content_disposition
         self.headers["Content-Type"] = content_type
         self.headers["Content-Location"] = content_location
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/filepost.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/filepost.py
index 36c9252..14f70b0 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/filepost.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/filepost.py
@@ -1,28 +1,32 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import binascii
 import codecs
 import os
+import typing
 from io import BytesIO
 
-from .fields import RequestField
-from .packages import six
-from .packages.six import b
+from .fields import _TYPE_FIELD_VALUE_TUPLE, RequestField
 
 writer = codecs.lookup("utf-8")[3]
 
+_TYPE_FIELDS_SEQUENCE = typing.Sequence[
+    typing.Union[tuple[str, _TYPE_FIELD_VALUE_TUPLE], RequestField]
+]
+_TYPE_FIELDS = typing.Union[
+    _TYPE_FIELDS_SEQUENCE,
+    typing.Mapping[str, _TYPE_FIELD_VALUE_TUPLE],
+]
 
-def choose_boundary():
+
+def choose_boundary() -> str:
     """
     Our embarrassingly-simple replacement for mimetools.choose_boundary.
     """
-    boundary = binascii.hexlify(os.urandom(16))
-    if not six.PY2:
-        boundary = boundary.decode("ascii")
-    return boundary
+    return binascii.hexlify(os.urandom(16)).decode()
 
 
-def iter_field_objects(fields):
+def iter_field_objects(fields: _TYPE_FIELDS) -> typing.Iterable[RequestField]:
     """
     Iterate over fields.
 
@@ -30,42 +34,29 @@ def iter_field_objects(fields):
     :class:`~urllib3.fields.RequestField`.
 
     """
-    if isinstance(fields, dict):
-        i = six.iteritems(fields)
-    else:
-        i = iter(fields)
+    iterable: typing.Iterable[RequestField | tuple[str, _TYPE_FIELD_VALUE_TUPLE]]
 
-    for field in i:
+    if isinstance(fields, typing.Mapping):
+        iterable = fields.items()
+    else:
+        iterable = fields
+
+    for field in iterable:
         if isinstance(field, RequestField):
             yield field
         else:
             yield RequestField.from_tuples(*field)
 
 
-def iter_fields(fields):
-    """
-    .. deprecated:: 1.6
-
-    Iterate over fields.
-
-    The addition of :class:`~urllib3.fields.RequestField` makes this function
-    obsolete. Instead, use :func:`iter_field_objects`, which returns
-    :class:`~urllib3.fields.RequestField` objects.
-
-    Supports list of (k, v) tuples and dicts.
-    """
-    if isinstance(fields, dict):
-        return ((k, v) for k, v in six.iteritems(fields))
-
-    return ((k, v) for k, v in fields)
-
-
-def encode_multipart_formdata(fields, boundary=None):
+def encode_multipart_formdata(
+    fields: _TYPE_FIELDS, boundary: str | None = None
+) -> tuple[bytes, str]:
     """
     Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
 
     :param fields:
         Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
+        Values are processed by :func:`urllib3.fields.RequestField.from_tuples`.
 
     :param boundary:
         If not specified, then a random boundary will be generated using
@@ -76,7 +67,7 @@ def encode_multipart_formdata(fields, boundary=None):
         boundary = choose_boundary()
 
     for field in iter_field_objects(fields):
-        body.write(b("--%s\r\n" % (boundary)))
+        body.write(f"--{boundary}\r\n".encode("latin-1"))
 
         writer(body).write(field.render_headers())
         data = field.data
@@ -84,15 +75,15 @@ def encode_multipart_formdata(fields, boundary=None):
         if isinstance(data, int):
             data = str(data)  # Backwards compatibility
 
-        if isinstance(data, six.text_type):
+        if isinstance(data, str):
             writer(body).write(data)
         else:
             body.write(data)
 
         body.write(b"\r\n")
 
-    body.write(b("--%s--\r\n" % (boundary)))
+    body.write(f"--{boundary}--\r\n".encode("latin-1"))
 
-    content_type = str("multipart/form-data; boundary=%s" % boundary)
+    content_type = f"multipart/form-data; boundary={boundary}"
 
     return body.getvalue(), content_type
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py
deleted file mode 100644
index b8fb215..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py
+++ /dev/null
@@ -1,51 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-backports.makefile
-~~~~~~~~~~~~~~~~~~
-
-Backports the Python 3 ``socket.makefile`` method for use with anything that
-wants to create a "fake" socket object.
-"""
-import io
-from socket import SocketIO
-
-
-def backport_makefile(
-    self, mode="r", buffering=None, encoding=None, errors=None, newline=None
-):
-    """
-    Backport of ``socket.makefile`` from Python 3.5.
-    """
-    if not set(mode) <= {"r", "w", "b"}:
-        raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
-    writing = "w" in mode
-    reading = "r" in mode or not writing
-    assert reading or writing
-    binary = "b" in mode
-    rawmode = ""
-    if reading:
-        rawmode += "r"
-    if writing:
-        rawmode += "w"
-    raw = SocketIO(self, rawmode)
-    self._makefile_refs += 1
-    if buffering is None:
-        buffering = -1
-    if buffering < 0:
-        buffering = io.DEFAULT_BUFFER_SIZE
-    if buffering == 0:
-        if not binary:
-            raise ValueError("unbuffered streams must be binary")
-        return raw
-    if reading and writing:
-        buffer = io.BufferedRWPair(raw, raw, buffering)
-    elif reading:
-        buffer = io.BufferedReader(raw, buffering)
-    else:
-        assert writing
-        buffer = io.BufferedWriter(raw, buffering)
-    if binary:
-        return buffer
-    text = io.TextIOWrapper(buffer, encoding, errors, newline)
-    text.mode = mode
-    return text
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py
deleted file mode 100644
index a2f2966..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py
+++ /dev/null
@@ -1,155 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-backports.weakref_finalize
-~~~~~~~~~~~~~~~~~~
-
-Backports the Python 3 ``weakref.finalize`` method.
-"""
-from __future__ import absolute_import
-
-import itertools
-import sys
-from weakref import ref
-
-__all__ = ["weakref_finalize"]
-
-
-class weakref_finalize(object):
-    """Class for finalization of weakrefable objects
-    finalize(obj, func, *args, **kwargs) returns a callable finalizer
-    object which will be called when obj is garbage collected. The
-    first time the finalizer is called it evaluates func(*arg, **kwargs)
-    and returns the result. After this the finalizer is dead, and
-    calling it just returns None.
-    When the program exits any remaining finalizers for which the
-    atexit attribute is true will be run in reverse order of creation.
-    By default atexit is true.
-    """
-
-    # Finalizer objects don't have any state of their own.  They are
-    # just used as keys to lookup _Info objects in the registry.  This
-    # ensures that they cannot be part of a ref-cycle.
-
-    __slots__ = ()
-    _registry = {}
-    _shutdown = False
-    _index_iter = itertools.count()
-    _dirty = False
-    _registered_with_atexit = False
-
-    class _Info(object):
-        __slots__ = ("weakref", "func", "args", "kwargs", "atexit", "index")
-
-    def __init__(self, obj, func, *args, **kwargs):
-        if not self._registered_with_atexit:
-            # We may register the exit function more than once because
-            # of a thread race, but that is harmless
-            import atexit
-
-            atexit.register(self._exitfunc)
-            weakref_finalize._registered_with_atexit = True
-        info = self._Info()
-        info.weakref = ref(obj, self)
-        info.func = func
-        info.args = args
-        info.kwargs = kwargs or None
-        info.atexit = True
-        info.index = next(self._index_iter)
-        self._registry[self] = info
-        weakref_finalize._dirty = True
-
-    def __call__(self, _=None):
-        """If alive then mark as dead and return func(*args, **kwargs);
-        otherwise return None"""
-        info = self._registry.pop(self, None)
-        if info and not self._shutdown:
-            return info.func(*info.args, **(info.kwargs or {}))
-
-    def detach(self):
-        """If alive then mark as dead and return (obj, func, args, kwargs);
-        otherwise return None"""
-        info = self._registry.get(self)
-        obj = info and info.weakref()
-        if obj is not None and self._registry.pop(self, None):
-            return (obj, info.func, info.args, info.kwargs or {})
-
-    def peek(self):
-        """If alive then return (obj, func, args, kwargs);
-        otherwise return None"""
-        info = self._registry.get(self)
-        obj = info and info.weakref()
-        if obj is not None:
-            return (obj, info.func, info.args, info.kwargs or {})
-
-    @property
-    def alive(self):
-        """Whether finalizer is alive"""
-        return self in self._registry
-
-    @property
-    def atexit(self):
-        """Whether finalizer should be called at exit"""
-        info = self._registry.get(self)
-        return bool(info) and info.atexit
-
-    @atexit.setter
-    def atexit(self, value):
-        info = self._registry.get(self)
-        if info:
-            info.atexit = bool(value)
-
-    def __repr__(self):
-        info = self._registry.get(self)
-        obj = info and info.weakref()
-        if obj is None:
-            return "<%s object at %#x; dead>" % (type(self).__name__, id(self))
-        else:
-            return "<%s object at %#x; for %r at %#x>" % (
-                type(self).__name__,
-                id(self),
-                type(obj).__name__,
-                id(obj),
-            )
-
-    @classmethod
-    def _select_for_exit(cls):
-        # Return live finalizers marked for exit, oldest first
-        L = [(f, i) for (f, i) in cls._registry.items() if i.atexit]
-        L.sort(key=lambda item: item[1].index)
-        return [f for (f, i) in L]
-
-    @classmethod
-    def _exitfunc(cls):
-        # At shutdown invoke finalizers for which atexit is true.
-        # This is called once all other non-daemonic threads have been
-        # joined.
-        reenable_gc = False
-        try:
-            if cls._registry:
-                import gc
-
-                if gc.isenabled():
-                    reenable_gc = True
-                    gc.disable()
-                pending = None
-                while True:
-                    if pending is None or weakref_finalize._dirty:
-                        pending = cls._select_for_exit()
-                        weakref_finalize._dirty = False
-                    if not pending:
-                        break
-                    f = pending.pop()
-                    try:
-                        # gc is disabled, so (assuming no daemonic
-                        # threads) the following is the only line in
-                        # this function which might trigger creation
-                        # of a new finalizer
-                        f()
-                    except Exception:
-                        sys.excepthook(*sys.exc_info())
-                    assert f not in cls._registry
-        finally:
-            # prevent any more finalizers from executing during shutdown
-            weakref_finalize._shutdown = True
-            if reenable_gc:
-                gc.enable()
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/six.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/six.py
deleted file mode 100644
index f099a3d..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/packages/six.py
+++ /dev/null
@@ -1,1076 +0,0 @@
-# Copyright (c) 2010-2020 Benjamin Peterson
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
-"""Utilities for writing code that runs on Python 2 and 3"""
-
-from __future__ import absolute_import
-
-import functools
-import itertools
-import operator
-import sys
-import types
-
-__author__ = "Benjamin Peterson "
-__version__ = "1.16.0"
-
-
-# Useful for very coarse version differentiation.
-PY2 = sys.version_info[0] == 2
-PY3 = sys.version_info[0] == 3
-PY34 = sys.version_info[0:2] >= (3, 4)
-
-if PY3:
-    string_types = (str,)
-    integer_types = (int,)
-    class_types = (type,)
-    text_type = str
-    binary_type = bytes
-
-    MAXSIZE = sys.maxsize
-else:
-    string_types = (basestring,)
-    integer_types = (int, long)
-    class_types = (type, types.ClassType)
-    text_type = unicode
-    binary_type = str
-
-    if sys.platform.startswith("java"):
-        # Jython always uses 32 bits.
-        MAXSIZE = int((1 << 31) - 1)
-    else:
-        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
-        class X(object):
-            def __len__(self):
-                return 1 << 31
-
-        try:
-            len(X())
-        except OverflowError:
-            # 32-bit
-            MAXSIZE = int((1 << 31) - 1)
-        else:
-            # 64-bit
-            MAXSIZE = int((1 << 63) - 1)
-        del X
-
-if PY34:
-    from importlib.util import spec_from_loader
-else:
-    spec_from_loader = None
-
-
-def _add_doc(func, doc):
-    """Add documentation to a function."""
-    func.__doc__ = doc
-
-
-def _import_module(name):
-    """Import module, returning the module after the last dot."""
-    __import__(name)
-    return sys.modules[name]
-
-
-class _LazyDescr(object):
-    def __init__(self, name):
-        self.name = name
-
-    def __get__(self, obj, tp):
-        result = self._resolve()
-        setattr(obj, self.name, result)  # Invokes __set__.
-        try:
-            # This is a bit ugly, but it avoids running this again by
-            # removing this descriptor.
-            delattr(obj.__class__, self.name)
-        except AttributeError:
-            pass
-        return result
-
-
-class MovedModule(_LazyDescr):
-    def __init__(self, name, old, new=None):
-        super(MovedModule, self).__init__(name)
-        if PY3:
-            if new is None:
-                new = name
-            self.mod = new
-        else:
-            self.mod = old
-
-    def _resolve(self):
-        return _import_module(self.mod)
-
-    def __getattr__(self, attr):
-        _module = self._resolve()
-        value = getattr(_module, attr)
-        setattr(self, attr, value)
-        return value
-
-
-class _LazyModule(types.ModuleType):
-    def __init__(self, name):
-        super(_LazyModule, self).__init__(name)
-        self.__doc__ = self.__class__.__doc__
-
-    def __dir__(self):
-        attrs = ["__doc__", "__name__"]
-        attrs += [attr.name for attr in self._moved_attributes]
-        return attrs
-
-    # Subclasses should override this
-    _moved_attributes = []
-
-
-class MovedAttribute(_LazyDescr):
-    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
-        super(MovedAttribute, self).__init__(name)
-        if PY3:
-            if new_mod is None:
-                new_mod = name
-            self.mod = new_mod
-            if new_attr is None:
-                if old_attr is None:
-                    new_attr = name
-                else:
-                    new_attr = old_attr
-            self.attr = new_attr
-        else:
-            self.mod = old_mod
-            if old_attr is None:
-                old_attr = name
-            self.attr = old_attr
-
-    def _resolve(self):
-        module = _import_module(self.mod)
-        return getattr(module, self.attr)
-
-
-class _SixMetaPathImporter(object):
-
-    """
-    A meta path importer to import six.moves and its submodules.
-
-    This class implements a PEP302 finder and loader. It should be compatible
-    with Python 2.5 and all existing versions of Python3
-    """
-
-    def __init__(self, six_module_name):
-        self.name = six_module_name
-        self.known_modules = {}
-
-    def _add_module(self, mod, *fullnames):
-        for fullname in fullnames:
-            self.known_modules[self.name + "." + fullname] = mod
-
-    def _get_module(self, fullname):
-        return self.known_modules[self.name + "." + fullname]
-
-    def find_module(self, fullname, path=None):
-        if fullname in self.known_modules:
-            return self
-        return None
-
-    def find_spec(self, fullname, path, target=None):
-        if fullname in self.known_modules:
-            return spec_from_loader(fullname, self)
-        return None
-
-    def __get_module(self, fullname):
-        try:
-            return self.known_modules[fullname]
-        except KeyError:
-            raise ImportError("This loader does not know module " + fullname)
-
-    def load_module(self, fullname):
-        try:
-            # in case of a reload
-            return sys.modules[fullname]
-        except KeyError:
-            pass
-        mod = self.__get_module(fullname)
-        if isinstance(mod, MovedModule):
-            mod = mod._resolve()
-        else:
-            mod.__loader__ = self
-        sys.modules[fullname] = mod
-        return mod
-
-    def is_package(self, fullname):
-        """
-        Return true, if the named module is a package.
-
-        We need this method to get correct spec objects with
-        Python 3.4 (see PEP451)
-        """
-        return hasattr(self.__get_module(fullname), "__path__")
-
-    def get_code(self, fullname):
-        """Return None
-
-        Required, if is_package is implemented"""
-        self.__get_module(fullname)  # eventually raises ImportError
-        return None
-
-    get_source = get_code  # same as get_code
-
-    def create_module(self, spec):
-        return self.load_module(spec.name)
-
-    def exec_module(self, module):
-        pass
-
-
-_importer = _SixMetaPathImporter(__name__)
-
-
-class _MovedItems(_LazyModule):
-
-    """Lazy loading of moved objects"""
-
-    __path__ = []  # mark as package
-
-
-_moved_attributes = [
-    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
-    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
-    MovedAttribute(
-        "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"
-    ),
-    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
-    MovedAttribute("intern", "__builtin__", "sys"),
-    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
-    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
-    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
-    MovedAttribute("getoutput", "commands", "subprocess"),
-    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
-    MovedAttribute(
-        "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"
-    ),
-    MovedAttribute("reduce", "__builtin__", "functools"),
-    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
-    MovedAttribute("StringIO", "StringIO", "io"),
-    MovedAttribute("UserDict", "UserDict", "collections"),
-    MovedAttribute("UserList", "UserList", "collections"),
-    MovedAttribute("UserString", "UserString", "collections"),
-    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
-    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
-    MovedAttribute(
-        "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"
-    ),
-    MovedModule("builtins", "__builtin__"),
-    MovedModule("configparser", "ConfigParser"),
-    MovedModule(
-        "collections_abc",
-        "collections",
-        "collections.abc" if sys.version_info >= (3, 3) else "collections",
-    ),
-    MovedModule("copyreg", "copy_reg"),
-    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
-    MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"),
-    MovedModule(
-        "_dummy_thread",
-        "dummy_thread",
-        "_dummy_thread" if sys.version_info < (3, 9) else "_thread",
-    ),
-    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
-    MovedModule("http_cookies", "Cookie", "http.cookies"),
-    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
-    MovedModule("html_parser", "HTMLParser", "html.parser"),
-    MovedModule("http_client", "httplib", "http.client"),
-    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
-    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
-    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
-    MovedModule(
-        "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"
-    ),
-    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
-    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
-    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
-    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
-    MovedModule("cPickle", "cPickle", "pickle"),
-    MovedModule("queue", "Queue"),
-    MovedModule("reprlib", "repr"),
-    MovedModule("socketserver", "SocketServer"),
-    MovedModule("_thread", "thread", "_thread"),
-    MovedModule("tkinter", "Tkinter"),
-    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
-    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
-    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
-    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
-    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
-    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
-    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
-    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
-    MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"),
-    MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"),
-    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
-    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
-    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
-    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"),
-    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
-    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
-    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
-    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
-    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
-    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
-]
-# Add windows specific modules.
-if sys.platform == "win32":
-    _moved_attributes += [
-        MovedModule("winreg", "_winreg"),
-    ]
-
-for attr in _moved_attributes:
-    setattr(_MovedItems, attr.name, attr)
-    if isinstance(attr, MovedModule):
-        _importer._add_module(attr, "moves." + attr.name)
-del attr
-
-_MovedItems._moved_attributes = _moved_attributes
-
-moves = _MovedItems(__name__ + ".moves")
-_importer._add_module(moves, "moves")
-
-
-class Module_six_moves_urllib_parse(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_parse"""
-
-
-_urllib_parse_moved_attributes = [
-    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
-    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
-    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
-    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
-    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
-    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
-    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
-    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
-    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
-    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
-    MovedAttribute("quote", "urllib", "urllib.parse"),
-    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
-    MovedAttribute("unquote", "urllib", "urllib.parse"),
-    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
-    MovedAttribute(
-        "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"
-    ),
-    MovedAttribute("urlencode", "urllib", "urllib.parse"),
-    MovedAttribute("splitquery", "urllib", "urllib.parse"),
-    MovedAttribute("splittag", "urllib", "urllib.parse"),
-    MovedAttribute("splituser", "urllib", "urllib.parse"),
-    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
-    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
-]
-for attr in _urllib_parse_moved_attributes:
-    setattr(Module_six_moves_urllib_parse, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
-    "moves.urllib_parse",
-    "moves.urllib.parse",
-)
-
-
-class Module_six_moves_urllib_error(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_error"""
-
-
-_urllib_error_moved_attributes = [
-    MovedAttribute("URLError", "urllib2", "urllib.error"),
-    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
-    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
-]
-for attr in _urllib_error_moved_attributes:
-    setattr(Module_six_moves_urllib_error, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
-    "moves.urllib_error",
-    "moves.urllib.error",
-)
-
-
-class Module_six_moves_urllib_request(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_request"""
-
-
-_urllib_request_moved_attributes = [
-    MovedAttribute("urlopen", "urllib2", "urllib.request"),
-    MovedAttribute("install_opener", "urllib2", "urllib.request"),
-    MovedAttribute("build_opener", "urllib2", "urllib.request"),
-    MovedAttribute("pathname2url", "urllib", "urllib.request"),
-    MovedAttribute("url2pathname", "urllib", "urllib.request"),
-    MovedAttribute("getproxies", "urllib", "urllib.request"),
-    MovedAttribute("Request", "urllib2", "urllib.request"),
-    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
-    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
-    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
-    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
-    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
-    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
-    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
-    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
-    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
-    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
-    MovedAttribute("URLopener", "urllib", "urllib.request"),
-    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
-    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
-    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
-    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
-]
-for attr in _urllib_request_moved_attributes:
-    setattr(Module_six_moves_urllib_request, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
-    "moves.urllib_request",
-    "moves.urllib.request",
-)
-
-
-class Module_six_moves_urllib_response(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_response"""
-
-
-_urllib_response_moved_attributes = [
-    MovedAttribute("addbase", "urllib", "urllib.response"),
-    MovedAttribute("addclosehook", "urllib", "urllib.response"),
-    MovedAttribute("addinfo", "urllib", "urllib.response"),
-    MovedAttribute("addinfourl", "urllib", "urllib.response"),
-]
-for attr in _urllib_response_moved_attributes:
-    setattr(Module_six_moves_urllib_response, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
-    "moves.urllib_response",
-    "moves.urllib.response",
-)
-
-
-class Module_six_moves_urllib_robotparser(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
-
-
-_urllib_robotparser_moved_attributes = [
-    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
-]
-for attr in _urllib_robotparser_moved_attributes:
-    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_robotparser._moved_attributes = (
-    _urllib_robotparser_moved_attributes
-)
-
-_importer._add_module(
-    Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
-    "moves.urllib_robotparser",
-    "moves.urllib.robotparser",
-)
-
-
-class Module_six_moves_urllib(types.ModuleType):
-
-    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
-
-    __path__ = []  # mark as package
-    parse = _importer._get_module("moves.urllib_parse")
-    error = _importer._get_module("moves.urllib_error")
-    request = _importer._get_module("moves.urllib_request")
-    response = _importer._get_module("moves.urllib_response")
-    robotparser = _importer._get_module("moves.urllib_robotparser")
-
-    def __dir__(self):
-        return ["parse", "error", "request", "response", "robotparser"]
-
-
-_importer._add_module(
-    Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib"
-)
-
-
-def add_move(move):
-    """Add an item to six.moves."""
-    setattr(_MovedItems, move.name, move)
-
-
-def remove_move(name):
-    """Remove item from six.moves."""
-    try:
-        delattr(_MovedItems, name)
-    except AttributeError:
-        try:
-            del moves.__dict__[name]
-        except KeyError:
-            raise AttributeError("no such move, %r" % (name,))
-
-
-if PY3:
-    _meth_func = "__func__"
-    _meth_self = "__self__"
-
-    _func_closure = "__closure__"
-    _func_code = "__code__"
-    _func_defaults = "__defaults__"
-    _func_globals = "__globals__"
-else:
-    _meth_func = "im_func"
-    _meth_self = "im_self"
-
-    _func_closure = "func_closure"
-    _func_code = "func_code"
-    _func_defaults = "func_defaults"
-    _func_globals = "func_globals"
-
-
-try:
-    advance_iterator = next
-except NameError:
-
-    def advance_iterator(it):
-        return it.next()
-
-
-next = advance_iterator
-
-
-try:
-    callable = callable
-except NameError:
-
-    def callable(obj):
-        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
-
-
-if PY3:
-
-    def get_unbound_function(unbound):
-        return unbound
-
-    create_bound_method = types.MethodType
-
-    def create_unbound_method(func, cls):
-        return func
-
-    Iterator = object
-else:
-
-    def get_unbound_function(unbound):
-        return unbound.im_func
-
-    def create_bound_method(func, obj):
-        return types.MethodType(func, obj, obj.__class__)
-
-    def create_unbound_method(func, cls):
-        return types.MethodType(func, None, cls)
-
-    class Iterator(object):
-        def next(self):
-            return type(self).__next__(self)
-
-    callable = callable
-_add_doc(
-    get_unbound_function, """Get the function out of a possibly unbound function"""
-)
-
-
-get_method_function = operator.attrgetter(_meth_func)
-get_method_self = operator.attrgetter(_meth_self)
-get_function_closure = operator.attrgetter(_func_closure)
-get_function_code = operator.attrgetter(_func_code)
-get_function_defaults = operator.attrgetter(_func_defaults)
-get_function_globals = operator.attrgetter(_func_globals)
-
-
-if PY3:
-
-    def iterkeys(d, **kw):
-        return iter(d.keys(**kw))
-
-    def itervalues(d, **kw):
-        return iter(d.values(**kw))
-
-    def iteritems(d, **kw):
-        return iter(d.items(**kw))
-
-    def iterlists(d, **kw):
-        return iter(d.lists(**kw))
-
-    viewkeys = operator.methodcaller("keys")
-
-    viewvalues = operator.methodcaller("values")
-
-    viewitems = operator.methodcaller("items")
-else:
-
-    def iterkeys(d, **kw):
-        return d.iterkeys(**kw)
-
-    def itervalues(d, **kw):
-        return d.itervalues(**kw)
-
-    def iteritems(d, **kw):
-        return d.iteritems(**kw)
-
-    def iterlists(d, **kw):
-        return d.iterlists(**kw)
-
-    viewkeys = operator.methodcaller("viewkeys")
-
-    viewvalues = operator.methodcaller("viewvalues")
-
-    viewitems = operator.methodcaller("viewitems")
-
-_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
-_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
-_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.")
-_add_doc(
-    iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary."
-)
-
-
-if PY3:
-
-    def b(s):
-        return s.encode("latin-1")
-
-    def u(s):
-        return s
-
-    unichr = chr
-    import struct
-
-    int2byte = struct.Struct(">B").pack
-    del struct
-    byte2int = operator.itemgetter(0)
-    indexbytes = operator.getitem
-    iterbytes = iter
-    import io
-
-    StringIO = io.StringIO
-    BytesIO = io.BytesIO
-    del io
-    _assertCountEqual = "assertCountEqual"
-    if sys.version_info[1] <= 1:
-        _assertRaisesRegex = "assertRaisesRegexp"
-        _assertRegex = "assertRegexpMatches"
-        _assertNotRegex = "assertNotRegexpMatches"
-    else:
-        _assertRaisesRegex = "assertRaisesRegex"
-        _assertRegex = "assertRegex"
-        _assertNotRegex = "assertNotRegex"
-else:
-
-    def b(s):
-        return s
-
-    # Workaround for standalone backslash
-
-    def u(s):
-        return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape")
-
-    unichr = unichr
-    int2byte = chr
-
-    def byte2int(bs):
-        return ord(bs[0])
-
-    def indexbytes(buf, i):
-        return ord(buf[i])
-
-    iterbytes = functools.partial(itertools.imap, ord)
-    import StringIO
-
-    StringIO = BytesIO = StringIO.StringIO
-    _assertCountEqual = "assertItemsEqual"
-    _assertRaisesRegex = "assertRaisesRegexp"
-    _assertRegex = "assertRegexpMatches"
-    _assertNotRegex = "assertNotRegexpMatches"
-_add_doc(b, """Byte literal""")
-_add_doc(u, """Text literal""")
-
-
-def assertCountEqual(self, *args, **kwargs):
-    return getattr(self, _assertCountEqual)(*args, **kwargs)
-
-
-def assertRaisesRegex(self, *args, **kwargs):
-    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
-
-
-def assertRegex(self, *args, **kwargs):
-    return getattr(self, _assertRegex)(*args, **kwargs)
-
-
-def assertNotRegex(self, *args, **kwargs):
-    return getattr(self, _assertNotRegex)(*args, **kwargs)
-
-
-if PY3:
-    exec_ = getattr(moves.builtins, "exec")
-
-    def reraise(tp, value, tb=None):
-        try:
-            if value is None:
-                value = tp()
-            if value.__traceback__ is not tb:
-                raise value.with_traceback(tb)
-            raise value
-        finally:
-            value = None
-            tb = None
-
-else:
-
-    def exec_(_code_, _globs_=None, _locs_=None):
-        """Execute code in a namespace."""
-        if _globs_ is None:
-            frame = sys._getframe(1)
-            _globs_ = frame.f_globals
-            if _locs_ is None:
-                _locs_ = frame.f_locals
-            del frame
-        elif _locs_ is None:
-            _locs_ = _globs_
-        exec ("""exec _code_ in _globs_, _locs_""")
-
-    exec_(
-        """def reraise(tp, value, tb=None):
-    try:
-        raise tp, value, tb
-    finally:
-        tb = None
-"""
-    )
-
-
-if sys.version_info[:2] > (3,):
-    exec_(
-        """def raise_from(value, from_value):
-    try:
-        raise value from from_value
-    finally:
-        value = None
-"""
-    )
-else:
-
-    def raise_from(value, from_value):
-        raise value
-
-
-print_ = getattr(moves.builtins, "print", None)
-if print_ is None:
-
-    def print_(*args, **kwargs):
-        """The new-style print function for Python 2.4 and 2.5."""
-        fp = kwargs.pop("file", sys.stdout)
-        if fp is None:
-            return
-
-        def write(data):
-            if not isinstance(data, basestring):
-                data = str(data)
-            # If the file has an encoding, encode unicode with it.
-            if (
-                isinstance(fp, file)
-                and isinstance(data, unicode)
-                and fp.encoding is not None
-            ):
-                errors = getattr(fp, "errors", None)
-                if errors is None:
-                    errors = "strict"
-                data = data.encode(fp.encoding, errors)
-            fp.write(data)
-
-        want_unicode = False
-        sep = kwargs.pop("sep", None)
-        if sep is not None:
-            if isinstance(sep, unicode):
-                want_unicode = True
-            elif not isinstance(sep, str):
-                raise TypeError("sep must be None or a string")
-        end = kwargs.pop("end", None)
-        if end is not None:
-            if isinstance(end, unicode):
-                want_unicode = True
-            elif not isinstance(end, str):
-                raise TypeError("end must be None or a string")
-        if kwargs:
-            raise TypeError("invalid keyword arguments to print()")
-        if not want_unicode:
-            for arg in args:
-                if isinstance(arg, unicode):
-                    want_unicode = True
-                    break
-        if want_unicode:
-            newline = unicode("\n")
-            space = unicode(" ")
-        else:
-            newline = "\n"
-            space = " "
-        if sep is None:
-            sep = space
-        if end is None:
-            end = newline
-        for i, arg in enumerate(args):
-            if i:
-                write(sep)
-            write(arg)
-        write(end)
-
-
-if sys.version_info[:2] < (3, 3):
-    _print = print_
-
-    def print_(*args, **kwargs):
-        fp = kwargs.get("file", sys.stdout)
-        flush = kwargs.pop("flush", False)
-        _print(*args, **kwargs)
-        if flush and fp is not None:
-            fp.flush()
-
-
-_add_doc(reraise, """Reraise an exception.""")
-
-if sys.version_info[0:2] < (3, 4):
-    # This does exactly the same what the :func:`py3:functools.update_wrapper`
-    # function does on Python versions after 3.2. It sets the ``__wrapped__``
-    # attribute on ``wrapper`` object and it doesn't raise an error if any of
-    # the attributes mentioned in ``assigned`` and ``updated`` are missing on
-    # ``wrapped`` object.
-    def _update_wrapper(
-        wrapper,
-        wrapped,
-        assigned=functools.WRAPPER_ASSIGNMENTS,
-        updated=functools.WRAPPER_UPDATES,
-    ):
-        for attr in assigned:
-            try:
-                value = getattr(wrapped, attr)
-            except AttributeError:
-                continue
-            else:
-                setattr(wrapper, attr, value)
-        for attr in updated:
-            getattr(wrapper, attr).update(getattr(wrapped, attr, {}))
-        wrapper.__wrapped__ = wrapped
-        return wrapper
-
-    _update_wrapper.__doc__ = functools.update_wrapper.__doc__
-
-    def wraps(
-        wrapped,
-        assigned=functools.WRAPPER_ASSIGNMENTS,
-        updated=functools.WRAPPER_UPDATES,
-    ):
-        return functools.partial(
-            _update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated
-        )
-
-    wraps.__doc__ = functools.wraps.__doc__
-
-else:
-    wraps = functools.wraps
-
-
-def with_metaclass(meta, *bases):
-    """Create a base class with a metaclass."""
-    # This requires a bit of explanation: the basic idea is to make a dummy
-    # metaclass for one level of class instantiation that replaces itself with
-    # the actual metaclass.
-    class metaclass(type):
-        def __new__(cls, name, this_bases, d):
-            if sys.version_info[:2] >= (3, 7):
-                # This version introduced PEP 560 that requires a bit
-                # of extra care (we mimic what is done by __build_class__).
-                resolved_bases = types.resolve_bases(bases)
-                if resolved_bases is not bases:
-                    d["__orig_bases__"] = bases
-            else:
-                resolved_bases = bases
-            return meta(name, resolved_bases, d)
-
-        @classmethod
-        def __prepare__(cls, name, this_bases):
-            return meta.__prepare__(name, bases)
-
-    return type.__new__(metaclass, "temporary_class", (), {})
-
-
-def add_metaclass(metaclass):
-    """Class decorator for creating a class with a metaclass."""
-
-    def wrapper(cls):
-        orig_vars = cls.__dict__.copy()
-        slots = orig_vars.get("__slots__")
-        if slots is not None:
-            if isinstance(slots, str):
-                slots = [slots]
-            for slots_var in slots:
-                orig_vars.pop(slots_var)
-        orig_vars.pop("__dict__", None)
-        orig_vars.pop("__weakref__", None)
-        if hasattr(cls, "__qualname__"):
-            orig_vars["__qualname__"] = cls.__qualname__
-        return metaclass(cls.__name__, cls.__bases__, orig_vars)
-
-    return wrapper
-
-
-def ensure_binary(s, encoding="utf-8", errors="strict"):
-    """Coerce **s** to six.binary_type.
-
-    For Python 2:
-      - `unicode` -> encoded to `str`
-      - `str` -> `str`
-
-    For Python 3:
-      - `str` -> encoded to `bytes`
-      - `bytes` -> `bytes`
-    """
-    if isinstance(s, binary_type):
-        return s
-    if isinstance(s, text_type):
-        return s.encode(encoding, errors)
-    raise TypeError("not expecting type '%s'" % type(s))
-
-
-def ensure_str(s, encoding="utf-8", errors="strict"):
-    """Coerce *s* to `str`.
-
-    For Python 2:
-      - `unicode` -> encoded to `str`
-      - `str` -> `str`
-
-    For Python 3:
-      - `str` -> `str`
-      - `bytes` -> decoded to `str`
-    """
-    # Optimization: Fast return for the common case.
-    if type(s) is str:
-        return s
-    if PY2 and isinstance(s, text_type):
-        return s.encode(encoding, errors)
-    elif PY3 and isinstance(s, binary_type):
-        return s.decode(encoding, errors)
-    elif not isinstance(s, (text_type, binary_type)):
-        raise TypeError("not expecting type '%s'" % type(s))
-    return s
-
-
-def ensure_text(s, encoding="utf-8", errors="strict"):
-    """Coerce *s* to six.text_type.
-
-    For Python 2:
-      - `unicode` -> `unicode`
-      - `str` -> `unicode`
-
-    For Python 3:
-      - `str` -> `str`
-      - `bytes` -> decoded to `str`
-    """
-    if isinstance(s, binary_type):
-        return s.decode(encoding, errors)
-    elif isinstance(s, text_type):
-        return s
-    else:
-        raise TypeError("not expecting type '%s'" % type(s))
-
-
-def python_2_unicode_compatible(klass):
-    """
-    A class decorator that defines __unicode__ and __str__ methods under Python 2.
-    Under Python 3 it does nothing.
-
-    To support Python 2 and 3 with a single code base, define a __str__ method
-    returning text and apply this decorator to the class.
-    """
-    if PY2:
-        if "__str__" not in klass.__dict__:
-            raise ValueError(
-                "@python_2_unicode_compatible cannot be applied "
-                "to %s because it doesn't define __str__()." % klass.__name__
-            )
-        klass.__unicode__ = klass.__str__
-        klass.__str__ = lambda self: self.__unicode__().encode("utf-8")
-    return klass
-
-
-# Complete the moves implementation.
-# This code is at the end of this module to speed up module loading.
-# Turn this module into a package.
-__path__ = []  # required for PEP 302 and PEP 451
-__package__ = __name__  # see PEP 366 @ReservedAssignment
-if globals().get("__spec__") is not None:
-    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
-# Remove other six meta path importers, since they cause problems. This can
-# happen if six is removed from sys.modules and then reloaded. (Setuptools does
-# this for some reason.)
-if sys.meta_path:
-    for i, importer in enumerate(sys.meta_path):
-        # Here's some real nastiness: Another "instance" of the six module might
-        # be floating around. Therefore, we can't use isinstance() to check for
-        # the six meta path importer, since the other six instance will have
-        # inserted an importer with different class.
-        if (
-            type(importer).__name__ == "_SixMetaPathImporter"
-            and importer.name == __name__
-        ):
-            del sys.meta_path[i]
-            break
-    del i, importer
-# Finally, add the importer to the meta path import hook.
-sys.meta_path.append(_importer)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/poolmanager.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/poolmanager.py
index fb51bf7..b3e4ac5 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/poolmanager.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/poolmanager.py
@@ -1,24 +1,33 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
-import collections
 import functools
 import logging
+import typing
+import warnings
+from types import TracebackType
+from urllib.parse import urljoin
 
 from ._collections import HTTPHeaderDict, RecentlyUsedContainer
+from ._request_methods import RequestMethods
+from .connection import ProxyConfig
 from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme
 from .exceptions import (
     LocationValueError,
     MaxRetryError,
     ProxySchemeUnknown,
-    ProxySchemeUnsupported,
     URLSchemeUnknown,
 )
-from .packages import six
-from .packages.six.moves.urllib.parse import urljoin
-from .request import RequestMethods
+from .response import BaseHTTPResponse
+from .util.connection import _TYPE_SOCKET_OPTIONS
 from .util.proxy import connection_requires_http_tunnel
 from .util.retry import Retry
-from .util.url import parse_url
+from .util.timeout import Timeout
+from .util.url import Url, parse_url
+
+if typing.TYPE_CHECKING:
+    import ssl
+
+    from typing_extensions import Self
 
 __all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]
 
@@ -30,53 +39,64 @@ SSL_KEYWORDS = (
     "cert_file",
     "cert_reqs",
     "ca_certs",
+    "ca_cert_data",
     "ssl_version",
+    "ssl_minimum_version",
+    "ssl_maximum_version",
     "ca_cert_dir",
     "ssl_context",
     "key_password",
     "server_hostname",
+    "assert_hostname",
+    "assert_fingerprint",
 )
-
-# All known keyword arguments that could be provided to the pool manager, its
-# pools, or the underlying connections. This is used to construct a pool key.
-_key_fields = (
-    "key_scheme",  # str
-    "key_host",  # str
-    "key_port",  # int
-    "key_timeout",  # int or float or Timeout
-    "key_retries",  # int or Retry
-    "key_strict",  # bool
-    "key_block",  # bool
-    "key_source_address",  # str
-    "key_key_file",  # str
-    "key_key_password",  # str
-    "key_cert_file",  # str
-    "key_cert_reqs",  # str
-    "key_ca_certs",  # str
-    "key_ssl_version",  # str
-    "key_ca_cert_dir",  # str
-    "key_ssl_context",  # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext
-    "key_maxsize",  # int
-    "key_headers",  # dict
-    "key__proxy",  # parsed proxy url
-    "key__proxy_headers",  # dict
-    "key__proxy_config",  # class
-    "key_socket_options",  # list of (level (int), optname (int), value (int or str)) tuples
-    "key__socks_options",  # dict
-    "key_assert_hostname",  # bool or string
-    "key_assert_fingerprint",  # str
-    "key_server_hostname",  # str
-)
-
-#: The namedtuple class used to construct keys for the connection pool.
-#: All custom key schemes should include the fields in this key at a minimum.
-PoolKey = collections.namedtuple("PoolKey", _key_fields)
-
-_proxy_config_fields = ("ssl_context", "use_forwarding_for_https")
-ProxyConfig = collections.namedtuple("ProxyConfig", _proxy_config_fields)
+# Default value for `blocksize` - a new parameter introduced to
+# http.client.HTTPConnection & http.client.HTTPSConnection in Python 3.7
+_DEFAULT_BLOCKSIZE = 16384
 
 
-def _default_key_normalizer(key_class, request_context):
+class PoolKey(typing.NamedTuple):
+    """
+    All known keyword arguments that could be provided to the pool manager, its
+    pools, or the underlying connections.
+
+    All custom key schemes should include the fields in this key at a minimum.
+    """
+
+    key_scheme: str
+    key_host: str
+    key_port: int | None
+    key_timeout: Timeout | float | int | None
+    key_retries: Retry | bool | int | None
+    key_block: bool | None
+    key_source_address: tuple[str, int] | None
+    key_key_file: str | None
+    key_key_password: str | None
+    key_cert_file: str | None
+    key_cert_reqs: str | None
+    key_ca_certs: str | None
+    key_ca_cert_data: str | bytes | None
+    key_ssl_version: int | str | None
+    key_ssl_minimum_version: ssl.TLSVersion | None
+    key_ssl_maximum_version: ssl.TLSVersion | None
+    key_ca_cert_dir: str | None
+    key_ssl_context: ssl.SSLContext | None
+    key_maxsize: int | None
+    key_headers: frozenset[tuple[str, str]] | None
+    key__proxy: Url | None
+    key__proxy_headers: frozenset[tuple[str, str]] | None
+    key__proxy_config: ProxyConfig | None
+    key_socket_options: _TYPE_SOCKET_OPTIONS | None
+    key__socks_options: frozenset[tuple[str, str]] | None
+    key_assert_hostname: bool | str | None
+    key_assert_fingerprint: str | None
+    key_server_hostname: str | None
+    key_blocksize: int | None
+
+
+def _default_key_normalizer(
+    key_class: type[PoolKey], request_context: dict[str, typing.Any]
+) -> PoolKey:
     """
     Create a pool key out of a request context dictionary.
 
@@ -122,6 +142,10 @@ def _default_key_normalizer(key_class, request_context):
         if field not in context:
             context[field] = None
 
+    # Default key_blocksize to _DEFAULT_BLOCKSIZE if missing from the context
+    if context.get("key_blocksize") is None:
+        context["key_blocksize"] = _DEFAULT_BLOCKSIZE
+
     return key_class(**context)
 
 
@@ -154,23 +178,50 @@ class PoolManager(RequestMethods):
         Additional parameters are used to create fresh
         :class:`urllib3.connectionpool.ConnectionPool` instances.
 
-    Example::
+    Example:
 
-        >>> manager = PoolManager(num_pools=2)
-        >>> r = manager.request('GET', 'http://google.com/')
-        >>> r = manager.request('GET', 'http://google.com/mail')
-        >>> r = manager.request('GET', 'http://yahoo.com/')
-        >>> len(manager.pools)
-        2
+    .. code-block:: python
+
+        from pip._vendor import urllib3
+
+        http = urllib3.PoolManager(num_pools=2)
+
+        resp1 = http.request("GET", "https://google.com/")
+        resp2 = http.request("GET", "https://google.com/mail")
+        resp3 = http.request("GET", "https://yahoo.com/")
+
+        print(len(http.pools))
+        # 2
 
     """
 
-    proxy = None
-    proxy_config = None
+    proxy: Url | None = None
+    proxy_config: ProxyConfig | None = None
 
-    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
-        RequestMethods.__init__(self, headers)
+    def __init__(
+        self,
+        num_pools: int = 10,
+        headers: typing.Mapping[str, str] | None = None,
+        **connection_pool_kw: typing.Any,
+    ) -> None:
+        super().__init__(headers)
+        # PoolManager handles redirects itself in PoolManager.urlopen().
+        # It always passes redirect=False to the underlying connection pool to
+        # suppress per-pool redirect handling. If the user supplied a non-Retry
+        # value (int/bool/etc) for retries and we let the pool normalize it
+        # while redirect=False, the resulting Retry object would have redirect
+        # handling disabled, which can interfere with PoolManager's own
+        # redirect logic. Normalize here so redirects remain governed solely by
+        # PoolManager logic.
+        if "retries" in connection_pool_kw:
+            retries = connection_pool_kw["retries"]
+            if not isinstance(retries, Retry):
+                retries = Retry.from_int(retries)
+                connection_pool_kw = connection_pool_kw.copy()
+                connection_pool_kw["retries"] = retries
         self.connection_pool_kw = connection_pool_kw
+
+        self.pools: RecentlyUsedContainer[PoolKey, HTTPConnectionPool]
         self.pools = RecentlyUsedContainer(num_pools)
 
         # Locally set the pool classes and keys so other PoolManagers can
@@ -178,15 +229,26 @@ class PoolManager(RequestMethods):
         self.pool_classes_by_scheme = pool_classes_by_scheme
         self.key_fn_by_scheme = key_fn_by_scheme.copy()
 
-    def __enter__(self):
+    def __enter__(self) -> Self:
         return self
 
-    def __exit__(self, exc_type, exc_val, exc_tb):
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> typing.Literal[False]:
         self.clear()
         # Return False to re-raise any potential exceptions
         return False
 
-    def _new_pool(self, scheme, host, port, request_context=None):
+    def _new_pool(
+        self,
+        scheme: str,
+        host: str,
+        port: int,
+        request_context: dict[str, typing.Any] | None = None,
+    ) -> HTTPConnectionPool:
         """
         Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and
         any additional pool keyword arguments.
@@ -196,10 +258,15 @@ class PoolManager(RequestMethods):
         connection pools handed out by :meth:`connection_from_url` and
         companion methods. It is intended to be overridden for customization.
         """
-        pool_cls = self.pool_classes_by_scheme[scheme]
+        pool_cls: type[HTTPConnectionPool] = self.pool_classes_by_scheme[scheme]
         if request_context is None:
             request_context = self.connection_pool_kw.copy()
 
+        # Default blocksize to _DEFAULT_BLOCKSIZE if missing or explicitly
+        # set to 'None' in the request_context.
+        if request_context.get("blocksize") is None:
+            request_context["blocksize"] = _DEFAULT_BLOCKSIZE
+
         # Although the context has everything necessary to create the pool,
         # this function has historically only used the scheme, host, and port
         # in the positional args. When an API change is acceptable these can
@@ -213,7 +280,7 @@ class PoolManager(RequestMethods):
 
         return pool_cls(host, port, **request_context)
 
-    def clear(self):
+    def clear(self) -> None:
         """
         Empty our store of pools and direct them all to close.
 
@@ -222,7 +289,13 @@ class PoolManager(RequestMethods):
         """
         self.pools.clear()
 
-    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+    def connection_from_host(
+        self,
+        host: str | None,
+        port: int | None = None,
+        scheme: str | None = "http",
+        pool_kwargs: dict[str, typing.Any] | None = None,
+    ) -> HTTPConnectionPool:
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme.
 
@@ -238,20 +311,30 @@ class PoolManager(RequestMethods):
 
         request_context = self._merge_pool_kwargs(pool_kwargs)
         request_context["scheme"] = scheme or "http"
-        if not port:
+        if port is None:
             port = port_by_scheme.get(request_context["scheme"].lower(), 80)
         request_context["port"] = port
         request_context["host"] = host
 
         return self.connection_from_context(request_context)
 
-    def connection_from_context(self, request_context):
+    def connection_from_context(
+        self, request_context: dict[str, typing.Any]
+    ) -> HTTPConnectionPool:
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context.
 
         ``request_context`` must at least contain the ``scheme`` key and its
         value must be a key in ``key_fn_by_scheme`` instance variable.
         """
+        if "strict" in request_context:
+            warnings.warn(
+                "The 'strict' parameter is no longer needed on Python 3+. "
+                "This will raise an error in urllib3 v3.0.",
+                FutureWarning,
+            )
+            request_context.pop("strict")
+
         scheme = request_context["scheme"].lower()
         pool_key_constructor = self.key_fn_by_scheme.get(scheme)
         if not pool_key_constructor:
@@ -260,7 +343,9 @@ class PoolManager(RequestMethods):
 
         return self.connection_from_pool_key(pool_key, request_context=request_context)
 
-    def connection_from_pool_key(self, pool_key, request_context=None):
+    def connection_from_pool_key(
+        self, pool_key: PoolKey, request_context: dict[str, typing.Any]
+    ) -> HTTPConnectionPool:
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key.
 
@@ -284,7 +369,9 @@ class PoolManager(RequestMethods):
 
         return pool
 
-    def connection_from_url(self, url, pool_kwargs=None):
+    def connection_from_url(
+        self, url: str, pool_kwargs: dict[str, typing.Any] | None = None
+    ) -> HTTPConnectionPool:
         """
         Similar to :func:`urllib3.connectionpool.connection_from_url`.
 
@@ -300,7 +387,9 @@ class PoolManager(RequestMethods):
             u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
         )
 
-    def _merge_pool_kwargs(self, override):
+    def _merge_pool_kwargs(
+        self, override: dict[str, typing.Any] | None
+    ) -> dict[str, typing.Any]:
         """
         Merge a dictionary of override values for self.connection_pool_kw.
 
@@ -320,7 +409,7 @@ class PoolManager(RequestMethods):
                     base_pool_kwargs[key] = value
         return base_pool_kwargs
 
-    def _proxy_requires_url_absolute_form(self, parsed_url):
+    def _proxy_requires_url_absolute_form(self, parsed_url: Url) -> bool:
         """
         Indicates if the proxy requires the complete destination URL in the
         request.  Normally this is only needed when not using an HTTP CONNECT
@@ -333,24 +422,9 @@ class PoolManager(RequestMethods):
             self.proxy, self.proxy_config, parsed_url.scheme
         )
 
-    def _validate_proxy_scheme_url_selection(self, url_scheme):
-        """
-        Validates that were not attempting to do TLS in TLS connections on
-        Python2 or with unsupported SSL implementations.
-        """
-        if self.proxy is None or url_scheme != "https":
-            return
-
-        if self.proxy.scheme != "https":
-            return
-
-        if six.PY2 and not self.proxy_config.use_forwarding_for_https:
-            raise ProxySchemeUnsupported(
-                "Contacting HTTPS destinations through HTTPS proxies "
-                "'via CONNECT tunnels' is not supported in Python 2"
-            )
-
-    def urlopen(self, method, url, redirect=True, **kw):
+    def urlopen(  # type: ignore[override]
+        self, method: str, url: str, redirect: bool = True, **kw: typing.Any
+    ) -> BaseHTTPResponse:
         """
         Same as :meth:`urllib3.HTTPConnectionPool.urlopen`
         with custom cross-host redirect logic and only sends the request-uri
@@ -360,7 +434,16 @@ class PoolManager(RequestMethods):
         :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
         """
         u = parse_url(url)
-        self._validate_proxy_scheme_url_selection(u.scheme)
+
+        if u.scheme is None:
+            warnings.warn(
+                "URLs without a scheme (ie 'https://') are deprecated and will raise an error "
+                "in urllib3 v3.0. To avoid this FutureWarning ensure all URLs "
+                "start with 'https://' or 'http://'. Read more in this issue: "
+                "https://github.com/urllib3/urllib3/issues/2920",
+                category=FutureWarning,
+                stacklevel=2,
+            )
 
         conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)
 
@@ -368,10 +451,10 @@ class PoolManager(RequestMethods):
         kw["redirect"] = False
 
         if "headers" not in kw:
-            kw["headers"] = self.headers.copy()
+            kw["headers"] = self.headers
 
         if self._proxy_requires_url_absolute_form(u):
-            response = conn.urlopen(method, url, **kw)
+            response = conn.urlopen(method, u._replace(fragment=None).url, **kw)
         else:
             response = conn.urlopen(method, u.request_uri, **kw)
 
@@ -387,9 +470,14 @@ class PoolManager(RequestMethods):
             method = "GET"
             # And lose the body not to transfer anything sensitive.
             kw["body"] = None
+            # The body is gone, so the state that describes it has to go too:
+            # there is nothing left to frame with chunked transfer encoding,
+            # and nothing left to rewind.
+            kw["chunked"] = False
+            kw["body_pos"] = None
             kw["headers"] = HTTPHeaderDict(kw["headers"])._prepare_for_method_change()
 
-        retries = kw.get("retries")
+        retries = kw.get("retries", response.retries)
         if not isinstance(retries, Retry):
             retries = Retry.from_int(retries, redirect=redirect)
 
@@ -399,10 +487,11 @@ class PoolManager(RequestMethods):
         if retries.remove_headers_on_redirect and not conn.is_same_host(
             redirect_location
         ):
-            headers = list(six.iterkeys(kw["headers"]))
-            for header in headers:
+            new_headers = kw["headers"].copy()
+            for header in kw["headers"]:
                 if header.lower() in retries.remove_headers_on_redirect:
-                    kw["headers"].pop(header, None)
+                    new_headers.pop(header, None)
+            kw["headers"] = new_headers
 
         try:
             retries = retries.increment(method, url, response=response, _pool=conn)
@@ -448,67 +537,113 @@ class ProxyManager(PoolManager):
         private.  IP address, target hostname, SNI, and port are always visible
         to an HTTPS proxy even when this flag is disabled.
 
+    :param proxy_assert_hostname:
+        The hostname of the certificate to verify against.
+
+    :param proxy_assert_fingerprint:
+        The fingerprint of the certificate to verify against.
+
     Example:
-        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
-        >>> r1 = proxy.request('GET', 'http://google.com/')
-        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
-        >>> len(proxy.pools)
-        1
-        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
-        >>> r4 = proxy.request('GET', 'https://twitter.com/')
-        >>> len(proxy.pools)
-        3
+
+    .. code-block:: python
+
+        from pip._vendor import urllib3
+
+        proxy = urllib3.ProxyManager("https://localhost:3128/")
+
+        resp1 = proxy.request("GET", "http://google.com/")
+        resp2 = proxy.request("GET", "http://httpbin.org/")
+
+        # One pool was shared by both plain HTTP requests.
+        print(len(proxy.pools))
+        # 1
+
+        resp3 = proxy.request("GET", "https://httpbin.org/")
+        resp4 = proxy.request("GET", "https://twitter.com/")
+
+        # A separate pool was added for each HTTPS target.
+        print(len(proxy.pools))
+        # 3
 
     """
 
     def __init__(
         self,
-        proxy_url,
-        num_pools=10,
-        headers=None,
-        proxy_headers=None,
-        proxy_ssl_context=None,
-        use_forwarding_for_https=False,
-        **connection_pool_kw
-    ):
-
+        proxy_url: str,
+        num_pools: int = 10,
+        headers: typing.Mapping[str, str] | None = None,
+        proxy_headers: typing.Mapping[str, str] | None = None,
+        proxy_ssl_context: ssl.SSLContext | None = None,
+        use_forwarding_for_https: bool = False,
+        proxy_assert_hostname: None | str | typing.Literal[False] = None,
+        proxy_assert_fingerprint: str | None = None,
+        **connection_pool_kw: typing.Any,
+    ) -> None:
         if isinstance(proxy_url, HTTPConnectionPool):
-            proxy_url = "%s://%s:%i" % (
-                proxy_url.scheme,
-                proxy_url.host,
-                proxy_url.port,
-            )
-        proxy = parse_url(proxy_url)
+            str_proxy_url = f"{proxy_url.scheme}://{proxy_url.host}:{proxy_url.port}"
+        else:
+            str_proxy_url = proxy_url
+        proxy = parse_url(str_proxy_url)
 
         if proxy.scheme not in ("http", "https"):
             raise ProxySchemeUnknown(proxy.scheme)
 
-        if not proxy.port:
+        # Keep the deprecated ssl_context fallback on the manager for
+        # compatibility, while passing only explicit proxy policy to connections.
+        self.proxy_ssl_context = proxy_ssl_context
+        if (
+            use_forwarding_for_https
+            and proxy.scheme == "https"
+            and connection_pool_kw.get("ssl_context") is not None
+        ):
+            warnings.warn(
+                "Passing ssl_context when use_forwarding_for_https=True is deprecated "
+                "and will raise an error in urllib3 v3.0. "
+                "Use proxy_ssl_context to configure the TLS connection to the proxy.",
+                FutureWarning,
+                stacklevel=2,
+            )
+            if self.proxy_ssl_context is None:
+                self.proxy_ssl_context = connection_pool_kw.get("ssl_context")
+
+        if proxy.port is None:
             port = port_by_scheme.get(proxy.scheme, 80)
             proxy = proxy._replace(port=port)
 
         self.proxy = proxy
         self.proxy_headers = proxy_headers or {}
-        self.proxy_ssl_context = proxy_ssl_context
-        self.proxy_config = ProxyConfig(proxy_ssl_context, use_forwarding_for_https)
+        self.proxy_config = ProxyConfig(
+            proxy_ssl_context,
+            use_forwarding_for_https,
+            proxy_assert_hostname,
+            proxy_assert_fingerprint,
+        )
 
         connection_pool_kw["_proxy"] = self.proxy
         connection_pool_kw["_proxy_headers"] = self.proxy_headers
         connection_pool_kw["_proxy_config"] = self.proxy_config
 
-        super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw)
+        super().__init__(num_pools, headers, **connection_pool_kw)
 
-    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+    def connection_from_host(
+        self,
+        host: str | None,
+        port: int | None = None,
+        scheme: str | None = "http",
+        pool_kwargs: dict[str, typing.Any] | None = None,
+    ) -> HTTPConnectionPool:
         if scheme == "https":
-            return super(ProxyManager, self).connection_from_host(
+            return super().connection_from_host(
                 host, port, scheme, pool_kwargs=pool_kwargs
             )
 
-        return super(ProxyManager, self).connection_from_host(
-            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs
+        return super().connection_from_host(
+            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs  # type: ignore[union-attr]
         )
 
-    def _set_proxy_headers(self, url, headers=None):
+    def _set_proxy_headers(
+        self, url: str, headers: typing.Mapping[str, str] | None = None
+    ) -> typing.Mapping[str, str]:
         """
         Sets headers needed by proxies: specifically, the Accept and Host
         headers. Only sets headers not provided by the user.
@@ -523,7 +658,9 @@ class ProxyManager(PoolManager):
             headers_.update(headers)
         return headers_
 
-    def urlopen(self, method, url, redirect=True, **kw):
+    def urlopen(  # type: ignore[override]
+        self, method: str, url: str, redirect: bool = True, **kw: typing.Any
+    ) -> BaseHTTPResponse:
         "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute."
         u = parse_url(url)
         if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme):
@@ -533,8 +670,8 @@ class ProxyManager(PoolManager):
             headers = kw.get("headers", self.headers)
             kw["headers"] = self._set_proxy_headers(url, headers)
 
-        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)
+        return super().urlopen(method, url, redirect=redirect, **kw)
 
 
-def proxy_from_url(url, **kw):
+def proxy_from_url(url: str, **kw: typing.Any) -> ProxyManager:
     return ProxyManager(proxy_url=url, **kw)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/request.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/request.py
deleted file mode 100644
index 3b4cf99..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/request.py
+++ /dev/null
@@ -1,191 +0,0 @@
-from __future__ import absolute_import
-
-import sys
-
-from .filepost import encode_multipart_formdata
-from .packages import six
-from .packages.six.moves.urllib.parse import urlencode
-
-__all__ = ["RequestMethods"]
-
-
-class RequestMethods(object):
-    """
-    Convenience mixin for classes who implement a :meth:`urlopen` method, such
-    as :class:`urllib3.HTTPConnectionPool` and
-    :class:`urllib3.PoolManager`.
-
-    Provides behavior for making common types of HTTP request methods and
-    decides which type of request field encoding to use.
-
-    Specifically,
-
-    :meth:`.request_encode_url` is for sending requests whose fields are
-    encoded in the URL (such as GET, HEAD, DELETE).
-
-    :meth:`.request_encode_body` is for sending requests whose fields are
-    encoded in the *body* of the request using multipart or www-form-urlencoded
-    (such as for POST, PUT, PATCH).
-
-    :meth:`.request` is for making any kind of request, it will look up the
-    appropriate encoding format and use one of the above two methods to make
-    the request.
-
-    Initializer parameters:
-
-    :param headers:
-        Headers to include with all requests, unless other headers are given
-        explicitly.
-    """
-
-    _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}
-
-    def __init__(self, headers=None):
-        self.headers = headers or {}
-
-    def urlopen(
-        self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        encode_multipart=True,
-        multipart_boundary=None,
-        **kw
-    ):  # Abstract
-        raise NotImplementedError(
-            "Classes extending RequestMethods must implement "
-            "their own ``urlopen`` method."
-        )
-
-    def request(self, method, url, fields=None, headers=None, **urlopen_kw):
-        """
-        Make a request using :meth:`urlopen` with the appropriate encoding of
-        ``fields`` based on the ``method`` used.
-
-        This is a convenience method that requires the least amount of manual
-        effort. It can be used in most situations, while still having the
-        option to drop down to more specific methods when necessary, such as
-        :meth:`request_encode_url`, :meth:`request_encode_body`,
-        or even the lowest level :meth:`urlopen`.
-        """
-        method = method.upper()
-
-        urlopen_kw["request_url"] = url
-
-        if method in self._encode_url_methods:
-            return self.request_encode_url(
-                method, url, fields=fields, headers=headers, **urlopen_kw
-            )
-        else:
-            return self.request_encode_body(
-                method, url, fields=fields, headers=headers, **urlopen_kw
-            )
-
-    def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw):
-        """
-        Make a request using :meth:`urlopen` with the ``fields`` encoded in
-        the url. This is useful for request methods like GET, HEAD, DELETE, etc.
-        """
-        if headers is None:
-            headers = self.headers
-
-        extra_kw = {"headers": headers}
-        extra_kw.update(urlopen_kw)
-
-        if fields:
-            url += "?" + urlencode(fields)
-
-        return self.urlopen(method, url, **extra_kw)
-
-    def request_encode_body(
-        self,
-        method,
-        url,
-        fields=None,
-        headers=None,
-        encode_multipart=True,
-        multipart_boundary=None,
-        **urlopen_kw
-    ):
-        """
-        Make a request using :meth:`urlopen` with the ``fields`` encoded in
-        the body. This is useful for request methods like POST, PUT, PATCH, etc.
-
-        When ``encode_multipart=True`` (default), then
-        :func:`urllib3.encode_multipart_formdata` is used to encode
-        the payload with the appropriate content type. Otherwise
-        :func:`urllib.parse.urlencode` is used with the
-        'application/x-www-form-urlencoded' content type.
-
-        Multipart encoding must be used when posting files, and it's reasonably
-        safe to use it in other times too. However, it may break request
-        signing, such as with OAuth.
-
-        Supports an optional ``fields`` parameter of key/value strings AND
-        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
-        the MIME type is optional. For example::
-
-            fields = {
-                'foo': 'bar',
-                'fakefile': ('foofile.txt', 'contents of foofile'),
-                'realfile': ('barfile.txt', open('realfile').read()),
-                'typedfile': ('bazfile.bin', open('bazfile').read(),
-                              'image/jpeg'),
-                'nonamefile': 'contents of nonamefile field',
-            }
-
-        When uploading a file, providing a filename (the first parameter of the
-        tuple) is optional but recommended to best mimic behavior of browsers.
-
-        Note that if ``headers`` are supplied, the 'Content-Type' header will
-        be overwritten because it depends on the dynamic random boundary string
-        which is used to compose the body of the request. The random boundary
-        string can be explicitly set with the ``multipart_boundary`` parameter.
-        """
-        if headers is None:
-            headers = self.headers
-
-        extra_kw = {"headers": {}}
-
-        if fields:
-            if "body" in urlopen_kw:
-                raise TypeError(
-                    "request got values for both 'fields' and 'body', can only specify one."
-                )
-
-            if encode_multipart:
-                body, content_type = encode_multipart_formdata(
-                    fields, boundary=multipart_boundary
-                )
-            else:
-                body, content_type = (
-                    urlencode(fields),
-                    "application/x-www-form-urlencoded",
-                )
-
-            extra_kw["body"] = body
-            extra_kw["headers"] = {"Content-Type": content_type}
-
-        extra_kw["headers"].update(headers)
-        extra_kw.update(urlopen_kw)
-
-        return self.urlopen(method, url, **extra_kw)
-
-
-if not six.PY2:
-
-    class RequestModule(sys.modules[__name__].__class__):
-        def __call__(self, *args, **kwargs):
-            """
-            If user tries to call this module directly urllib3 v2.x style raise an error to the user
-            suggesting they may need urllib3 v2
-            """
-            raise TypeError(
-                "'module' object is not callable\n"
-                "urllib3.request() method is not supported in this release, "
-                "upgrade to urllib3 v2 to use it\n"
-                "see https://urllib3.readthedocs.io/en/stable/v2-migration-guide.html"
-            )
-
-    sys.modules[__name__].__class__ = RequestModule
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/response.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/response.py
index 8909f84..05a82d9 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/response.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/response.py
@@ -1,22 +1,32 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
+import collections
 import io
+import json as _json
 import logging
+import socket
 import sys
+import typing
 import warnings
 import zlib
 from contextlib import contextmanager
-from socket import error as SocketError
+from http.client import HTTPMessage as _HttplibHTTPMessage
+from http.client import HTTPResponse as _HttplibHTTPResponse
 from socket import timeout as SocketTimeout
 
+if typing.TYPE_CHECKING:
+    from ._base_connection import BaseHTTPConnection
+
 brotli = None
 
 from . import util
+from ._base_connection import _TYPE_BODY
 from ._collections import HTTPHeaderDict
-from .connection import BaseSSLError, HTTPException
+from .connection import BaseSSLError, HTTPConnection, HTTPException
 from .exceptions import (
     BodyNotHttplibCompatible,
     DecodeError,
+    DependencyWarning,
     HTTPError,
     IncompleteRead,
     InvalidChunkLength,
@@ -26,101 +36,278 @@ from .exceptions import (
     ResponseNotChunked,
     SSLError,
 )
-from .packages import six
 from .util.response import is_fp_closed, is_response_to_head
+from .util.retry import Retry
+
+if typing.TYPE_CHECKING:
+    from .connectionpool import HTTPConnectionPool
 
 log = logging.getLogger(__name__)
 
+# Read in 64 KiB chunks
+_READ_CHUNK_SIZE = 2**16
 
-class DeflateDecoder(object):
-    def __init__(self):
+# Maximum length of a chunk-size line (and the trailing CRLF line) when reading a
+# chunked-transfer-encoded response. Matches ``http.client._MAXLINE`` so urllib3's
+# streaming path bounds these reads exactly like the stdlib ``.read()`` path does,
+# preventing a malicious server from forcing unbounded buffering (memory exhaustion)
+# via an unterminated chunk-size line.
+_MAX_CHUNK_LINE_LENGTH = 2**16
+
+
+class ContentDecoder:
+    def decompress(self, data: bytes, max_length: int = -1) -> bytes:
+        raise NotImplementedError()
+
+    @property
+    def has_unconsumed_tail(self) -> bool:
+        raise NotImplementedError()
+
+    def flush(self) -> bytes:
+        raise NotImplementedError()
+
+
+class DeflateDecoder(ContentDecoder):
+    def __init__(self) -> None:
         self._first_try = True
-        self._data = b""
+        self._first_try_data = b""
+        self._unfed_data = b""
         self._obj = zlib.decompressobj()
 
-    def __getattr__(self, name):
-        return getattr(self._obj, name)
-
-    def decompress(self, data):
-        if not data:
+    def decompress(self, data: bytes, max_length: int = -1) -> bytes:
+        data = self._unfed_data + data
+        self._unfed_data = b""
+        # Data received after EOF cannot produce more output from this
+        # Deflate stream.
+        if self._obj.eof:
+            return b""
+        if not data and not self._obj.unconsumed_tail:
             return data
+        original_max_length = max_length
+        if original_max_length < 0:
+            max_length = 0
+        elif original_max_length == 0:
+            # We should not pass 0 to the zlib decompressor because 0 is
+            # the default value that will make zlib decompress without a
+            # length limit.
+            # Data should be stored for subsequent calls.
+            self._unfed_data = data
+            return b""
 
+        # Subsequent calls always reuse `self._obj`. zlib requires
+        # passing the unconsumed tail if decompression is to continue.
         if not self._first_try:
-            return self._obj.decompress(data)
+            return self._obj.decompress(
+                self._obj.unconsumed_tail + data, max_length=max_length
+            )
 
-        self._data += data
+        # First call tries with RFC 1950 ZLIB format.
+        self._first_try_data += data
         try:
-            decompressed = self._obj.decompress(data)
+            decompressed = self._obj.decompress(data, max_length=max_length)
             if decompressed:
                 self._first_try = False
-                self._data = None
+                self._first_try_data = b""
             return decompressed
+        # On failure, it falls back to RFC 1951 DEFLATE format.
         except zlib.error:
             self._first_try = False
             self._obj = zlib.decompressobj(-zlib.MAX_WBITS)
             try:
-                return self.decompress(self._data)
+                return self.decompress(
+                    self._first_try_data, max_length=original_max_length
+                )
             finally:
-                self._data = None
+                self._first_try_data = b""
+
+    @property
+    def has_unconsumed_tail(self) -> bool:
+        return bool(self._unfed_data) or (
+            bool(self._obj.unconsumed_tail)
+            and not self._first_try
+            and not self._obj.eof
+        )
+
+    def flush(self) -> bytes:
+        return self._obj.flush()
 
 
-class GzipDecoderState(object):
-
+class GzipDecoderState:
     FIRST_MEMBER = 0
     OTHER_MEMBERS = 1
     SWALLOW_DATA = 2
 
 
-class GzipDecoder(object):
-    def __init__(self):
+class GzipDecoder(ContentDecoder):
+    def __init__(self) -> None:
         self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
         self._state = GzipDecoderState.FIRST_MEMBER
+        self._unconsumed_tail = b""
 
-    def __getattr__(self, name):
-        return getattr(self._obj, name)
-
-    def decompress(self, data):
+    def decompress(self, data: bytes, max_length: int = -1) -> bytes:
         ret = bytearray()
-        if self._state == GzipDecoderState.SWALLOW_DATA or not data:
+        if self._state == GzipDecoderState.SWALLOW_DATA:
             return bytes(ret)
+
+        if max_length == 0:
+            # We should not pass 0 to the zlib decompressor because 0 is
+            # the default value that will make zlib decompress without a
+            # length limit.
+            # Data should be stored for subsequent calls.
+            self._unconsumed_tail += data
+            return b""
+
+        # zlib requires passing the unconsumed tail to the subsequent
+        # call if decompression is to continue.
+        data = self._unconsumed_tail + data
+        if not data and self._obj.eof:
+            return bytes(ret)
+
         while True:
             try:
-                ret += self._obj.decompress(data)
+                ret += self._obj.decompress(
+                    data, max_length=max(max_length - len(ret), 0)
+                )
             except zlib.error:
                 previous_state = self._state
                 # Ignore data after the first error
                 self._state = GzipDecoderState.SWALLOW_DATA
+                self._unconsumed_tail = b""
                 if previous_state == GzipDecoderState.OTHER_MEMBERS:
                     # Allow trailing garbage acceptable in other gzip clients
                     return bytes(ret)
                 raise
-            data = self._obj.unused_data
+
+            self._unconsumed_tail = data = (
+                self._obj.unconsumed_tail or self._obj.unused_data
+            )
+            if max_length > 0 and len(ret) >= max_length:
+                break
+
             if not data:
                 return bytes(ret)
-            self._state = GzipDecoderState.OTHER_MEMBERS
-            self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+            # When the end of a gzip member is reached, a new decompressor
+            # must be created for unused (possibly future) data.
+            if self._obj.eof:
+                self._state = GzipDecoderState.OTHER_MEMBERS
+                self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+
+        return bytes(ret)
+
+    @property
+    def has_unconsumed_tail(self) -> bool:
+        return bool(self._unconsumed_tail)
+
+    def flush(self) -> bytes:
+        return self._obj.flush()
 
 
 if brotli is not None:
 
-    class BrotliDecoder(object):
+    class BrotliDecoder(ContentDecoder):
         # Supports both 'brotlipy' and 'Brotli' packages
         # since they share an import name. The top branches
         # are for 'brotlipy' and bottom branches for 'Brotli'
-        def __init__(self):
+        def __init__(self) -> None:
             self._obj = brotli.Decompressor()
             if hasattr(self._obj, "decompress"):
-                self.decompress = self._obj.decompress
+                setattr(self, "_decompress", self._obj.decompress)
             else:
-                self.decompress = self._obj.process
+                setattr(self, "_decompress", self._obj.process)
 
-        def flush(self):
+        # Requires Brotli >= 1.2.0 for `output_buffer_limit`.
+        def _decompress(self, data: bytes, output_buffer_limit: int = -1) -> bytes:
+            raise NotImplementedError()
+
+        def decompress(self, data: bytes, max_length: int = -1) -> bytes:
+            try:
+                if max_length > 0:
+                    return self._decompress(data, output_buffer_limit=max_length)
+                else:
+                    return self._decompress(data)
+            except TypeError:
+                # Fallback for Brotli/brotlicffi/brotlipy versions without
+                # the `output_buffer_limit` parameter.
+                warnings.warn(
+                    "Brotli >= 1.2.0 is required to prevent decompression bombs.",
+                    DependencyWarning,
+                )
+                return self._decompress(data)
+
+        @property
+        def has_unconsumed_tail(self) -> bool:
+            try:
+                return not self._obj.can_accept_more_data()
+            except AttributeError:
+                return False
+
+        def flush(self) -> bytes:
             if hasattr(self._obj, "flush"):
-                return self._obj.flush()
+                return self._obj.flush()  # type: ignore[no-any-return]
             return b""
 
 
-class MultiDecoder(object):
+try:
+    if sys.version_info >= (3, 14):
+        from compression import zstd
+    else:
+        from backports import zstd
+except ImportError:
+    HAS_ZSTD = False
+else:
+    HAS_ZSTD = True
+
+    class ZstdDecoder(ContentDecoder):
+        def __init__(self) -> None:
+            self._obj = zstd.ZstdDecompressor()
+
+        def decompress(self, data: bytes, max_length: int = -1) -> bytes:
+            if not data and not self.has_unconsumed_tail:
+                return b""
+            if self._obj.eof:
+                data = self._obj.unused_data + data
+                self._obj = zstd.ZstdDecompressor()
+            part = self._obj.decompress(data, max_length=max_length)
+            length = len(part)
+            data_parts = [part]
+            # Every loop iteration is supposed to read data from a separate frame.
+            # The loop breaks when:
+            #   - enough data is read;
+            #   - no more unused data is available;
+            #   - end of the last read frame has not been reached (i.e.,
+            #     more data has to be fed).
+            while (
+                self._obj.eof
+                and self._obj.unused_data
+                and (max_length < 0 or length < max_length)
+            ):
+                unused_data = self._obj.unused_data
+                if not self._obj.needs_input:
+                    self._obj = zstd.ZstdDecompressor()
+                part = self._obj.decompress(
+                    unused_data,
+                    max_length=(max_length - length) if max_length > 0 else -1,
+                )
+                if part_length := len(part):
+                    data_parts.append(part)
+                    length += part_length
+                elif self._obj.needs_input:
+                    break
+            return b"".join(data_parts)
+
+        @property
+        def has_unconsumed_tail(self) -> bool:
+            return not (self._obj.needs_input or self._obj.eof) or bool(
+                self._obj.unused_data
+            )
+
+        def flush(self) -> bytes:
+            if not self._obj.eof:
+                raise DecodeError("Zstandard data is incomplete")
+            return b""
+
+
+class MultiDecoder(ContentDecoder):
     """
     From RFC7231:
         If one or more encodings have been applied to a representation, the
@@ -129,32 +316,394 @@ class MultiDecoder(object):
         they were applied.
     """
 
-    def __init__(self, modes):
-        self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]
+    # Maximum allowed number of chained HTTP encodings in the
+    # Content-Encoding header.
+    max_decode_links = 5
 
-    def flush(self):
+    def __init__(self, modes: str) -> None:
+        encodings = [m.strip() for m in modes.split(",")]
+        if len(encodings) > self.max_decode_links:
+            raise DecodeError(
+                "Too many content encodings in the chain: "
+                f"{len(encodings)} > {self.max_decode_links}"
+            )
+        self._decoders = [_get_decoder(e) for e in encodings]
+
+    def flush(self) -> bytes:
         return self._decoders[0].flush()
 
-    def decompress(self, data):
-        for d in reversed(self._decoders):
-            data = d.decompress(data)
-        return data
+    def decompress(self, data: bytes, max_length: int = -1) -> bytes:
+        if max_length <= 0:
+            for d in reversed(self._decoders):
+                data = d.decompress(data)
+            return data
+
+        ret = bytearray()
+        # Every while loop iteration goes through all decoders once.
+        # It exits when enough data is read or no more data can be read.
+        # It is possible that the while loop iteration does not produce
+        # any data because we retrieve up to `max_length` from every
+        # decoder, and the amount of bytes may be insufficient for the
+        # next decoder to produce enough/any output.
+        while True:
+            any_data = False
+            for d in reversed(self._decoders):
+                data = d.decompress(data, max_length=max_length - len(ret))
+                if data:
+                    any_data = True
+                # We should not break when no data is returned because
+                # next decoders may produce data even with empty input.
+            ret += data
+            if not any_data or len(ret) >= max_length:
+                return bytes(ret)
+            data = b""
+
+    @property
+    def has_unconsumed_tail(self) -> bool:
+        return any(d.has_unconsumed_tail for d in self._decoders)
 
 
-def _get_decoder(mode):
+def _get_decoder(mode: str) -> ContentDecoder:
     if "," in mode:
         return MultiDecoder(mode)
 
-    if mode == "gzip":
+    # According to RFC 9110 section 8.4.1.3, recipients should
+    # consider x-gzip equivalent to gzip
+    if mode in ("gzip", "x-gzip"):
         return GzipDecoder()
 
     if brotli is not None and mode == "br":
         return BrotliDecoder()
 
+    if HAS_ZSTD and mode == "zstd":
+        return ZstdDecoder()
+
     return DeflateDecoder()
 
 
-class HTTPResponse(io.IOBase):
+class BytesQueueBuffer:
+    """Memory-efficient bytes buffer
+
+    To return decoded data in read() and still follow the BufferedIOBase API, we need a
+    buffer to always return the correct amount of bytes.
+
+    This buffer should be filled using calls to put()
+
+    Our maximum memory usage is determined by the sum of the size of:
+
+     * self.buffer, which contains the full data
+     * the largest chunk that we will copy in get()
+    """
+
+    def __init__(self) -> None:
+        self.buffer: typing.Deque[bytes | memoryview[bytes]] = collections.deque()
+        self._size: int = 0
+
+    def __len__(self) -> int:
+        return self._size
+
+    def put(self, data: bytes) -> None:
+        self.buffer.append(data)
+        self._size += len(data)
+
+    def get(self, n: int) -> bytes:
+        if n == 0:
+            return b""
+        elif not self.buffer:
+            raise RuntimeError("buffer is empty")
+        elif n < 0:
+            raise ValueError("n should be > 0")
+
+        if len(self.buffer[0]) == n and isinstance(self.buffer[0], bytes):
+            self._size -= n
+            return self.buffer.popleft()
+
+        fetched = 0
+        ret = io.BytesIO()
+        while fetched < n:
+            remaining = n - fetched
+            chunk = self.buffer.popleft()
+            chunk_length = len(chunk)
+            if remaining < chunk_length:
+                chunk = memoryview(chunk)
+                left_chunk, right_chunk = chunk[:remaining], chunk[remaining:]
+                ret.write(left_chunk)
+                self.buffer.appendleft(right_chunk)
+                self._size -= remaining
+                break
+            else:
+                ret.write(chunk)
+                self._size -= chunk_length
+            fetched += chunk_length
+
+            if not self.buffer:
+                break
+
+        return ret.getvalue()
+
+    def get_all(self) -> bytes:
+        buffer = self.buffer
+        if not buffer:
+            assert self._size == 0
+            return b""
+        if len(buffer) == 1:
+            result = buffer.pop()
+            if isinstance(result, memoryview):
+                result = result.tobytes()
+        else:
+            ret = io.BytesIO()
+            ret.writelines(buffer.popleft() for _ in range(len(buffer)))
+            result = ret.getvalue()
+        self._size = 0
+        return result
+
+
+class BaseHTTPResponse(io.IOBase):
+    CONTENT_DECODERS = ["gzip", "x-gzip", "deflate"]
+    if brotli is not None:
+        CONTENT_DECODERS += ["br"]
+    if HAS_ZSTD:
+        CONTENT_DECODERS += ["zstd"]
+    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
+
+    DECODER_ERROR_CLASSES: tuple[type[Exception], ...] = (IOError, zlib.error)
+    if brotli is not None:
+        DECODER_ERROR_CLASSES += (brotli.error,)
+
+    if HAS_ZSTD:
+        DECODER_ERROR_CLASSES += (zstd.ZstdError,)
+
+    def __init__(
+        self,
+        *,
+        headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None,
+        status: int,
+        version: int,
+        version_string: str,
+        reason: str | None,
+        decode_content: bool,
+        request_url: str | None,
+        retries: Retry | None = None,
+    ) -> None:
+        if isinstance(headers, HTTPHeaderDict):
+            self.headers = headers
+        else:
+            self.headers = HTTPHeaderDict(headers)  # type: ignore[arg-type]
+        self.status = status
+        self.version = version
+        self.version_string = version_string
+        self.reason = reason
+        self.decode_content = decode_content
+        self._has_decoded_content = False
+        self._request_url: str | None = request_url
+        self.retries = retries
+
+        self.chunked = False
+        tr_enc = self.headers.get("transfer-encoding", "").lower()
+        # Don't incur the penalty of creating a list and then discarding it
+        encodings = (enc.strip() for enc in tr_enc.split(","))
+        if "chunked" in encodings:
+            self.chunked = True
+
+        self._decoder: ContentDecoder | None = None
+        # Distinguish an uninitialized decoder from a response needing no decoder.
+        self._decoder_initialized = False
+        self.length_remaining: int | None
+
+    def get_redirect_location(self) -> str | None | typing.Literal[False]:
+        """
+        Should we redirect and where to?
+
+        :returns: Truthy redirect location string if we got a redirect status
+            code and valid location. ``None`` if redirect status and no
+            location. ``False`` if not a redirect status code.
+        """
+        if self.status in self.REDIRECT_STATUSES:
+            return self.headers.get("location")
+        return False
+
+    @property
+    def data(self) -> bytes:
+        raise NotImplementedError()
+
+    def json(self) -> typing.Any:
+        """
+        Deserializes the body of the HTTP response as a Python object.
+
+        The body of the HTTP response must be encoded using UTF-8, as per
+        `RFC 8529 Section 8.1 `_.
+
+        To use a custom JSON decoder pass the result of :attr:`HTTPResponse.data` to
+        your custom decoder instead.
+
+        If the body of the HTTP response is not decodable to UTF-8, a
+        `UnicodeDecodeError` will be raised. If the body of the HTTP response is not a
+        valid JSON document, a `json.JSONDecodeError` will be raised.
+
+        Read more :ref:`here `.
+
+        :returns: The body of the HTTP response as a Python object.
+        """
+        data = self.data.decode("utf-8")
+        return _json.loads(data)
+
+    @property
+    def url(self) -> str | None:
+        raise NotImplementedError()
+
+    @url.setter
+    def url(self, url: str | None) -> None:
+        raise NotImplementedError()
+
+    @property
+    def connection(self) -> BaseHTTPConnection | None:
+        raise NotImplementedError()
+
+    @property
+    def retries(self) -> Retry | None:
+        return self._retries
+
+    @retries.setter
+    def retries(self, retries: Retry | None) -> None:
+        # Override the request_url if retries has a redirect location.
+        if retries is not None and retries.history:
+            self.url = retries.history[-1].redirect_location
+        self._retries = retries
+
+    def stream(
+        self, amt: int | None = _READ_CHUNK_SIZE, decode_content: bool | None = None
+    ) -> typing.Iterator[bytes]:
+        raise NotImplementedError()
+
+    def read(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+        cache_content: bool = False,
+    ) -> bytes:
+        raise NotImplementedError()
+
+    def read1(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+    ) -> bytes:
+        raise NotImplementedError()
+
+    def read_chunked(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+    ) -> typing.Iterator[bytes]:
+        raise NotImplementedError()
+
+    def release_conn(self) -> None:
+        raise NotImplementedError()
+
+    def drain_conn(self) -> None:
+        raise NotImplementedError()
+
+    def shutdown(self) -> None:
+        raise NotImplementedError()
+
+    def close(self) -> None:
+        raise NotImplementedError()
+
+    def _init_decoder(self) -> None:
+        """
+        Set-up the _decoder attribute if necessary.
+        """
+        if self._decoder_initialized:
+            return
+
+        if self._decoder is None:
+            # Note: content-encoding value should be case-insensitive, per RFC 7230
+            # Section 3.2
+            content_encoding = self.headers.get("content-encoding", "").lower()
+            if content_encoding in self.CONTENT_DECODERS:
+                self._decoder = _get_decoder(content_encoding)
+            elif "," in content_encoding:
+                encodings = [
+                    e.strip()
+                    for e in content_encoding.split(",")
+                    if e.strip() in self.CONTENT_DECODERS
+                ]
+                if encodings:
+                    self._decoder = _get_decoder(content_encoding)
+
+        self._decoder_initialized = True
+
+    def _decode(
+        self,
+        data: bytes,
+        decode_content: bool | None,
+        flush_decoder: bool,
+        max_length: int | None = None,
+    ) -> bytes:
+        """
+        Decode the data passed in and potentially flush the decoder.
+        """
+        if not decode_content:
+            if self._has_decoded_content:
+                raise RuntimeError(
+                    "Calling read(decode_content=False) is not supported after "
+                    "read(decode_content=True) was called."
+                )
+            return data
+
+        if max_length is None or flush_decoder:
+            max_length = -1
+
+        try:
+            if self._decoder:
+                data = self._decoder.decompress(data, max_length=max_length)
+                self._has_decoded_content = True
+        except self.DECODER_ERROR_CLASSES as e:
+            content_encoding = self.headers.get("content-encoding", "").lower()
+            raise DecodeError(
+                "Received response with content-encoding: %s, but "
+                "failed to decode it." % content_encoding,
+                e,
+            ) from e
+        if flush_decoder:
+            data += self._flush_decoder()
+
+        return data
+
+    def _flush_decoder(self) -> bytes:
+        """
+        Flushes the decoder. Should only be called if the decoder is actually
+        being used.
+        """
+        if self._decoder:
+            return self._decoder.decompress(b"") + self._decoder.flush()
+        return b""
+
+    # Compatibility methods for `io` module
+    def readinto(self, b: bytearray | memoryview[int]) -> int:
+        temp = self.read(len(b))
+        if len(temp) == 0:
+            return 0
+        else:
+            b[: len(temp)] = temp
+            return len(temp)
+
+    # Methods used by dependent libraries
+    def getheaders(self) -> HTTPHeaderDict:
+        return self.headers
+
+    def getheader(self, name: str, default: str | None = None) -> str | None:
+        return self.headers.get(name, default)
+
+    # Compatibility method for http.cookiejar
+    def info(self) -> HTTPHeaderDict:
+        return self.headers
+
+    def geturl(self) -> str | None:
+        return self.url
+
+
+class HTTPResponse(BaseHTTPResponse):
     """
     HTTP Response container.
 
@@ -187,140 +736,129 @@ class HTTPResponse(io.IOBase):
         value of Content-Length header, if present. Otherwise, raise error.
     """
 
-    CONTENT_DECODERS = ["gzip", "deflate"]
-    if brotli is not None:
-        CONTENT_DECODERS += ["br"]
-    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
-
     def __init__(
         self,
-        body="",
-        headers=None,
-        status=0,
-        version=0,
-        reason=None,
-        strict=0,
-        preload_content=True,
-        decode_content=True,
-        original_response=None,
-        pool=None,
-        connection=None,
-        msg=None,
-        retries=None,
-        enforce_content_length=False,
-        request_method=None,
-        request_url=None,
-        auto_close=True,
-    ):
+        body: _TYPE_BODY = "",
+        headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None,
+        status: int = 0,
+        version: int = 0,
+        version_string: str = "HTTP/?",
+        reason: str | None = None,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        original_response: _HttplibHTTPResponse | None = None,
+        pool: HTTPConnectionPool | None = None,
+        connection: HTTPConnection | None = None,
+        msg: _HttplibHTTPMessage | None = None,
+        retries: Retry | None = None,
+        enforce_content_length: bool = True,
+        request_method: str | None = None,
+        request_url: str | None = None,
+        auto_close: bool = True,
+        sock_shutdown: typing.Callable[[int], None] | None = None,
+    ) -> None:
+        super().__init__(
+            headers=headers,
+            status=status,
+            version=version,
+            version_string=version_string,
+            reason=reason,
+            decode_content=decode_content,
+            request_url=request_url,
+            retries=retries,
+        )
 
-        if isinstance(headers, HTTPHeaderDict):
-            self.headers = headers
-        else:
-            self.headers = HTTPHeaderDict(headers)
-        self.status = status
-        self.version = version
-        self.reason = reason
-        self.strict = strict
-        self.decode_content = decode_content
-        self.retries = retries
         self.enforce_content_length = enforce_content_length
         self.auto_close = auto_close
 
-        self._decoder = None
         self._body = None
-        self._fp = None
+        self._uncached_read_occurred = False
+        self._fp: _HttplibHTTPResponse | None = None
         self._original_response = original_response
         self._fp_bytes_read = 0
         self.msg = msg
-        self._request_url = request_url
 
-        if body and isinstance(body, (six.string_types, bytes)):
+        if body and isinstance(body, (str, bytes)):
             self._body = body
 
         self._pool = pool
         self._connection = connection
 
         if hasattr(body, "read"):
-            self._fp = body
+            self._fp = body  # type: ignore[assignment]
+        self._sock_shutdown = sock_shutdown
 
         # Are we using the chunked-style of transfer encoding?
-        self.chunked = False
-        self.chunk_left = None
-        tr_enc = self.headers.get("transfer-encoding", "").lower()
-        # Don't incur the penalty of creating a list and then discarding it
-        encodings = (enc.strip() for enc in tr_enc.split(","))
-        if "chunked" in encodings:
-            self.chunked = True
+        self.chunk_left: int | None = None
 
         # Determine length of response
         self.length_remaining = self._init_length(request_method)
 
+        # Used to return the correct amount of bytes for partial read()s
+        self._decoded_buffer = BytesQueueBuffer()
+
         # If requested, preload the body.
         if preload_content and not self._body:
             self._body = self.read(decode_content=decode_content)
 
-    def get_redirect_location(self):
-        """
-        Should we redirect and where to?
-
-        :returns: Truthy redirect location string if we got a redirect status
-            code and valid location. ``None`` if redirect status and no
-            location. ``False`` if not a redirect status code.
-        """
-        if self.status in self.REDIRECT_STATUSES:
-            return self.headers.get("location")
-
-        return False
-
-    def release_conn(self):
+    def release_conn(self) -> None:
         if not self._pool or not self._connection:
-            return
+            return None
 
         self._pool._put_conn(self._connection)
         self._connection = None
 
-    def drain_conn(self):
+    def drain_conn(self) -> None:
         """
         Read and discard any remaining HTTP response data in the response connection.
 
         Unread data in the HTTPResponse connection blocks the connection from being released back to the pool.
         """
         try:
-            self.read()
-        except (HTTPError, SocketError, BaseSSLError, HTTPException):
+            while self._raw_read(_READ_CHUNK_SIZE):
+                pass
+        except (HTTPError, OSError, BaseSSLError, HTTPException):
             pass
+        if self._has_decoded_content:
+            # `_raw_read` skips decompression, so we should clean up the
+            # decoder to avoid keeping unnecessary data in memory.
+            self._decoded_buffer = BytesQueueBuffer()
+            self._decoder = None
 
     @property
-    def data(self):
+    def data(self) -> bytes:
         # For backwards-compat with earlier urllib3 0.4 and earlier.
         if self._body:
-            return self._body
+            return self._body  # type: ignore[return-value]
 
         if self._fp:
             return self.read(cache_content=True)
 
+        return None  # type: ignore[return-value]
+
     @property
-    def connection(self):
+    def connection(self) -> HTTPConnection | None:
         return self._connection
 
-    def isclosed(self):
+    def isclosed(self) -> bool:
         return is_fp_closed(self._fp)
 
-    def tell(self):
+    def tell(self) -> int:
         """
         Obtain the number of bytes pulled over the wire so far. May differ from
-        the amount of content returned by :meth:``urllib3.response.HTTPResponse.read``
+        the amount of content returned by :meth:`HTTPResponse.read`
         if bytes are encoded on the wire (e.g, compressed).
         """
         return self._fp_bytes_read
 
-    def _init_length(self, request_method):
+    def _init_length(self, request_method: str | None) -> int | None:
         """
         Set initial length value for Response content if available.
         """
-        length = self.headers.get("content-length")
+        length: int | None
+        content_length: str | None = self.headers.get("content-length")
 
-        if length is not None:
+        if content_length is not None:
             if self.chunked:
                 # This Response will fail with an IncompleteRead if it can't be
                 # received as chunked. This method falls back to attempt reading
@@ -340,11 +878,11 @@ class HTTPResponse(io.IOBase):
                 # (e.g. Content-Length: 42, 42). This line ensures the values
                 # are all valid ints and that as long as the `set` length is 1,
                 # all values are the same. Otherwise, the header is invalid.
-                lengths = set([int(val) for val in length.split(",")])
+                lengths = {int(val) for val in content_length.split(",")}
                 if len(lengths) > 1:
                     raise InvalidHeader(
                         "Content-Length contained multiple "
-                        "unmatching values (%s)" % length
+                        "unmatching values (%s)" % content_length
                     )
                 length = lengths.pop()
             except ValueError:
@@ -353,6 +891,9 @@ class HTTPResponse(io.IOBase):
                 if length < 0:
                     length = None
 
+        else:  # if content_length is None
+            length = None
+
         # Convert status to int for comparison
         # In some cases, httplib returns a status of "_UNKNOWN"
         try:
@@ -366,64 +907,8 @@ class HTTPResponse(io.IOBase):
 
         return length
 
-    def _init_decoder(self):
-        """
-        Set-up the _decoder attribute if necessary.
-        """
-        # Note: content-encoding value should be case-insensitive, per RFC 7230
-        # Section 3.2
-        content_encoding = self.headers.get("content-encoding", "").lower()
-        if self._decoder is None:
-            if content_encoding in self.CONTENT_DECODERS:
-                self._decoder = _get_decoder(content_encoding)
-            elif "," in content_encoding:
-                encodings = [
-                    e.strip()
-                    for e in content_encoding.split(",")
-                    if e.strip() in self.CONTENT_DECODERS
-                ]
-                if len(encodings):
-                    self._decoder = _get_decoder(content_encoding)
-
-    DECODER_ERROR_CLASSES = (IOError, zlib.error)
-    if brotli is not None:
-        DECODER_ERROR_CLASSES += (brotli.error,)
-
-    def _decode(self, data, decode_content, flush_decoder):
-        """
-        Decode the data passed in and potentially flush the decoder.
-        """
-        if not decode_content:
-            return data
-
-        try:
-            if self._decoder:
-                data = self._decoder.decompress(data)
-        except self.DECODER_ERROR_CLASSES as e:
-            content_encoding = self.headers.get("content-encoding", "").lower()
-            raise DecodeError(
-                "Received response with content-encoding: %s, but "
-                "failed to decode it." % content_encoding,
-                e,
-            )
-        if flush_decoder:
-            data += self._flush_decoder()
-
-        return data
-
-    def _flush_decoder(self):
-        """
-        Flushes the decoder. Should only be called if the decoder is actually
-        being used.
-        """
-        if self._decoder:
-            buf = self._decoder.decompress(b"")
-            return buf + self._decoder.flush()
-
-        return b""
-
     @contextmanager
-    def _error_catcher(self):
+    def _error_catcher(self) -> typing.Generator[None]:
         """
         Catch low-level python exceptions, instead re-raising urllib3
         variants, so that low-level exceptions are not leaked in the
@@ -437,22 +922,28 @@ class HTTPResponse(io.IOBase):
             try:
                 yield
 
-            except SocketTimeout:
+            except SocketTimeout as e:
                 # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but
                 # there is yet no clean way to get at it from this context.
-                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+                raise ReadTimeoutError(self._pool, None, "Read timed out.") from e  # type: ignore[arg-type]
 
             except BaseSSLError as e:
-                # FIXME: Is there a better way to differentiate between SSLErrors?
-                if "read operation timed out" not in str(e):
-                    # SSL errors related to framing/MAC get wrapped and reraised here
-                    raise SSLError(e)
+                # SSL errors related to framing/MAC get wrapped and reraised here
+                raise SSLError(e) from e
 
-                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+            except IncompleteRead as e:
+                if (
+                    e.expected is not None
+                    and e.partial is not None
+                    and e.expected == -e.partial
+                ):
+                    arg = "Response may not contain content."
+                else:
+                    arg = f"Connection broken: {e!r}"
+                raise ProtocolError(arg, e) from e
 
-            except (HTTPException, SocketError) as e:
-                # This includes IncompleteRead.
-                raise ProtocolError("Connection broken: %r" % e, e)
+            except (HTTPException, OSError) as e:
+                raise ProtocolError(f"Connection broken: {e!r}", e) from e
 
             # If no exception is thrown, we should avoid cleaning up
             # unnecessarily.
@@ -478,7 +969,12 @@ class HTTPResponse(io.IOBase):
             if self._original_response and self._original_response.isclosed():
                 self.release_conn()
 
-    def _fp_read(self, amt):
+    def _fp_read(
+        self,
+        amt: int | None = None,
+        *,
+        read1: bool = False,
+    ) -> bytes:
         """
         Read a response with the thought that reading the number of bytes
         larger than can fit in a 32-bit int at a time via SSL in some
@@ -486,22 +982,20 @@ class HTTPResponse(io.IOBase):
         if `amt` or `self.length_remaining` indicate that a problem may
         happen.
 
-        The known cases:
-          * 3.8 <= CPython < 3.9.7 because of a bug
-            https://github.com/urllib3/urllib3/issues/2513#issuecomment-1152559900.
-          * urllib3 injected with pyOpenSSL-backed SSL-support.
-          * CPython < 3.10 only when `amt` does not fit 32-bit int.
+        This happens to urllib3 injected with pyOpenSSL-backed SSL-support.
         """
         assert self._fp
-        c_int_max = 2 ** 31 - 1
+        c_int_max = 2**31 - 1
         if (
-            (
-                (amt and amt > c_int_max)
-                or (self.length_remaining and self.length_remaining > c_int_max)
+            (amt and amt > c_int_max)
+            or (
+                amt is None
+                and self.length_remaining
+                and self.length_remaining > c_int_max
             )
-            and not util.IS_SECURETRANSPORT
-            and (util.IS_PYOPENSSL or sys.version_info < (3, 10))
-        ):
+        ) and util.IS_PYOPENSSL:
+            if read1:
+                return self._fp.read1(c_int_max)
             buffer = io.BytesIO()
             # Besides `max_chunk_amt` being a maximum chunk size, it
             # affects memory overhead of reading a response by this
@@ -509,7 +1003,7 @@ class HTTPResponse(io.IOBase):
             # `c_int_max` equal to 2 GiB - 1 byte is the actual maximum
             # chunk size that does not lead to an overflow error, but
             # 256 MiB is a compromise.
-            max_chunk_amt = 2 ** 28
+            max_chunk_amt = 2**28
             while amt is None or amt != 0:
                 if amt is not None:
                     chunk_amt = min(amt, max_chunk_amt)
@@ -522,11 +1016,70 @@ class HTTPResponse(io.IOBase):
                 buffer.write(data)
                 del data  # to reduce peak memory usage by `max_chunk_amt`.
             return buffer.getvalue()
+        elif read1:
+            return self._fp.read1(amt) if amt is not None else self._fp.read1()
         else:
             # StringIO doesn't like amt=None
             return self._fp.read(amt) if amt is not None else self._fp.read()
 
-    def read(self, amt=None, decode_content=None, cache_content=False):
+    def _raw_read(
+        self,
+        amt: int | None = None,
+        *,
+        read1: bool = False,
+    ) -> bytes:
+        """
+        Reads `amt` of bytes from the socket.
+        """
+        if self._fp is None:
+            return None  # type: ignore[return-value]
+
+        fp_closed = getattr(self._fp, "closed", False)
+
+        with self._error_catcher():
+            data = self._fp_read(amt, read1=read1) if not fp_closed else b""
+            if amt is not None and amt != 0 and not data:
+                # Platform-specific: Buggy versions of Python.
+                # Close the connection when no data is returned
+                #
+                # This is redundant to what httplib/http.client _should_
+                # already do.  However, versions of python released before
+                # December 15, 2012 (http://bugs.python.org/issue16298) do
+                # not properly close the connection in all cases. There is
+                # no harm in redundantly calling close.
+                self._fp.close()
+                if (
+                    self.enforce_content_length
+                    and self.length_remaining is not None
+                    and self.length_remaining != 0
+                ):
+                    # This is an edge case that httplib failed to cover due
+                    # to concerns of backward compatibility. We're
+                    # addressing it here to make sure IncompleteRead is
+                    # raised during streaming, so all calls with incorrect
+                    # Content-Length are caught.
+                    raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
+            elif read1 and (
+                (amt != 0 and not data) or self.length_remaining == len(data)
+            ):
+                # All data has been read, but `self._fp.read1` in
+                # CPython 3.12 and older doesn't always close
+                # `http.client.HTTPResponse`, so we close it here.
+                # See https://github.com/python/cpython/issues/113199
+                self._fp.close()
+
+        if data:
+            self._fp_bytes_read += len(data)
+            if self.length_remaining is not None:
+                self.length_remaining -= len(data)
+        return data
+
+    def read(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+        cache_content: bool = False,
+    ) -> bytes:
         """
         Similar to :meth:`http.client.HTTPResponse.read`, but with two additional
         parameters: ``decode_content`` and ``cache_content``.
@@ -551,54 +1104,158 @@ class HTTPResponse(io.IOBase):
         if decode_content is None:
             decode_content = self.decode_content
 
-        if self._fp is None:
-            return
+        if amt and amt < 0:
+            # Negative numbers and `None` should be treated the same.
+            amt = None
+        elif amt is not None:
+            cache_content = False
 
-        flush_decoder = False
-        fp_closed = getattr(self._fp, "closed", False)
+            if (
+                self._decoder
+                and self._decoder.has_unconsumed_tail
+                and len(self._decoded_buffer) < amt
+            ):
+                decoded_data = self._decode(
+                    b"",
+                    decode_content,
+                    flush_decoder=False,
+                    max_length=amt - len(self._decoded_buffer),
+                )
+                self._decoded_buffer.put(decoded_data)
+            if len(self._decoded_buffer) >= amt:
+                return self._decoded_buffer.get(amt)
 
-        with self._error_catcher():
-            data = self._fp_read(amt) if not fp_closed else b""
-            if amt is None:
-                flush_decoder = True
-            else:
-                cache_content = False
-                if (
-                    amt != 0 and not data
-                ):  # Platform-specific: Buggy versions of Python.
-                    # Close the connection when no data is returned
-                    #
-                    # This is redundant to what httplib/http.client _should_
-                    # already do.  However, versions of python released before
-                    # December 15, 2012 (http://bugs.python.org/issue16298) do
-                    # not properly close the connection in all cases. There is
-                    # no harm in redundantly calling close.
-                    self._fp.close()
-                    flush_decoder = True
-                    if self.enforce_content_length and self.length_remaining not in (
-                        0,
-                        None,
-                    ):
-                        # This is an edge case that httplib failed to cover due
-                        # to concerns of backward compatibility. We're
-                        # addressing it here to make sure IncompleteRead is
-                        # raised during streaming, so all calls with incorrect
-                        # Content-Length are caught.
-                        raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
+        data = self._raw_read(amt)
+        if not cache_content:
+            self._uncached_read_occurred = True
 
-        if data:
-            self._fp_bytes_read += len(data)
-            if self.length_remaining is not None:
-                self.length_remaining -= len(data)
+        flush_decoder = amt is None or (amt != 0 and not data)
 
+        if (
+            not data
+            and len(self._decoded_buffer) == 0
+            and not (self._decoder and self._decoder.has_unconsumed_tail)
+        ):
+            return data
+
+        if amt is None:
             data = self._decode(data, decode_content, flush_decoder)
+            # It's possible that there is buffered decoded data after a
+            # partial read.
+            if decode_content and len(self._decoded_buffer) > 0:
+                self._decoded_buffer.put(data)
+                data = self._decoded_buffer.get_all()
 
-            if cache_content:
+            if cache_content and not self._uncached_read_occurred:
                 self._body = data
+        else:
+            # do not waste memory on buffer when not decoding
+            if not decode_content:
+                if self._has_decoded_content:
+                    raise RuntimeError(
+                        "Calling read(decode_content=False) is not supported after "
+                        "read(decode_content=True) was called."
+                    )
+                return data
+
+            decoded_data = self._decode(
+                data,
+                decode_content,
+                flush_decoder,
+                max_length=amt - len(self._decoded_buffer),
+            )
+            self._decoded_buffer.put(decoded_data)
+
+            while len(self._decoded_buffer) < amt and data:
+                # TODO make sure to initially read enough data to get past the headers
+                # For example, the GZ file header takes 10 bytes, we don't want to read
+                # it one byte at a time
+                data = self._raw_read(amt)
+                decoded_data = self._decode(
+                    data,
+                    decode_content,
+                    flush_decoder,
+                    max_length=amt - len(self._decoded_buffer),
+                )
+                self._decoded_buffer.put(decoded_data)
+            data = self._decoded_buffer.get(amt)
 
         return data
 
-    def stream(self, amt=2 ** 16, decode_content=None):
+    def read1(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+    ) -> bytes:
+        """
+        Similar to ``http.client.HTTPResponse.read1`` and documented
+        in :meth:`io.BufferedReader.read1`, but with an additional parameter:
+        ``decode_content``.
+
+        :param amt:
+            How much of the content to read.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        if decode_content is None:
+            decode_content = self.decode_content
+        if amt and amt < 0:
+            # Negative numbers and `None` should be treated the same.
+            amt = None
+        # try and respond without going to the network
+        if self._has_decoded_content:
+            if not decode_content:
+                raise RuntimeError(
+                    "Calling read1(decode_content=False) is not supported after "
+                    "read1(decode_content=True) was called."
+                )
+            if (
+                self._decoder
+                and self._decoder.has_unconsumed_tail
+                and (amt is None or len(self._decoded_buffer) < amt)
+            ):
+                decoded_data = self._decode(
+                    b"",
+                    decode_content,
+                    flush_decoder=False,
+                    max_length=(
+                        amt - len(self._decoded_buffer) if amt is not None else None
+                    ),
+                )
+                self._decoded_buffer.put(decoded_data)
+            if len(self._decoded_buffer) > 0:
+                if amt is None:
+                    return self._decoded_buffer.get_all()
+                return self._decoded_buffer.get(amt)
+        if amt == 0:
+            return b""
+
+        # FIXME, this method's type doesn't say returning None is possible
+        data = self._raw_read(amt, read1=True)
+        self._uncached_read_occurred = True
+        if not decode_content or data is None:
+            return data
+
+        self._init_decoder()
+        while True:
+            flush_decoder = not data
+            decoded_data = self._decode(
+                data, decode_content, flush_decoder, max_length=amt
+            )
+            self._decoded_buffer.put(decoded_data)
+            if decoded_data or flush_decoder:
+                break
+            data = self._raw_read(8192, read1=True)
+
+        if amt is None:
+            return self._decoded_buffer.get_all()
+        return self._decoded_buffer.get(amt)
+
+    def stream(
+        self, amt: int | None = _READ_CHUNK_SIZE, decode_content: bool | None = None
+    ) -> typing.Generator[bytes]:
         """
         A generator wrapper for the read() method. A call will block until
         ``amt`` bytes have been read from the connection or until the
@@ -614,74 +1271,39 @@ class HTTPResponse(io.IOBase):
             If True, will attempt to decode the body based on the
             'content-encoding' header.
         """
+        if amt == 0:
+            return
+
         if self.chunked and self.supports_chunked_reads():
-            for line in self.read_chunked(amt, decode_content=decode_content):
-                yield line
+            yield from self.read_chunked(amt, decode_content=decode_content)
         else:
-            while not is_fp_closed(self._fp):
+            while (
+                not is_fp_closed(self._fp)
+                or len(self._decoded_buffer) > 0
+                or (self._decoder and self._decoder.has_unconsumed_tail)
+            ):
                 data = self.read(amt=amt, decode_content=decode_content)
 
                 if data:
                     yield data
 
-    @classmethod
-    def from_httplib(ResponseCls, r, **response_kw):
-        """
-        Given an :class:`http.client.HTTPResponse` instance ``r``, return a
-        corresponding :class:`urllib3.response.HTTPResponse` object.
-
-        Remaining parameters are passed to the HTTPResponse constructor, along
-        with ``original_response=r``.
-        """
-        headers = r.msg
-
-        if not isinstance(headers, HTTPHeaderDict):
-            if six.PY2:
-                # Python 2.7
-                headers = HTTPHeaderDict.from_httplib(headers)
-            else:
-                headers = HTTPHeaderDict(headers.items())
-
-        # HTTPResponse objects in Python 3 don't have a .strict attribute
-        strict = getattr(r, "strict", 0)
-        resp = ResponseCls(
-            body=r,
-            headers=headers,
-            status=r.status,
-            version=r.version,
-            reason=r.reason,
-            strict=strict,
-            original_response=r,
-            **response_kw
-        )
-        return resp
-
-    # Backwards-compatibility methods for http.client.HTTPResponse
-    def getheaders(self):
-        warnings.warn(
-            "HTTPResponse.getheaders() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-        return self.headers
-
-    def getheader(self, name, default=None):
-        warnings.warn(
-            "HTTPResponse.getheader() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-        return self.headers.get(name, default)
-
-    # Backwards compatibility for http.cookiejar
-    def info(self):
-        return self.headers
-
     # Overrides from io.IOBase
-    def close(self):
-        if not self.closed:
+    def readable(self) -> bool:
+        return True
+
+    def shutdown(self) -> None:
+        if not self._sock_shutdown:
+            raise ValueError("Cannot shutdown socket as self._sock_shutdown is not set")
+        if self._connection is None:
+            raise RuntimeError(
+                "Cannot shutdown as connection has already been released to the pool"
+            )
+        self._sock_shutdown(socket.SHUT_RD)
+
+    def close(self) -> None:
+        self._sock_shutdown = None
+
+        if not self.closed and self._fp:
             self._fp.close()
 
         if self._connection:
@@ -691,9 +1313,9 @@ class HTTPResponse(io.IOBase):
             io.IOBase.close(self)
 
     @property
-    def closed(self):
+    def closed(self) -> bool:
         if not self.auto_close:
-            return io.IOBase.closed.__get__(self)
+            return io.IOBase.closed.__get__(self)  # type: ignore[no-any-return]
         elif self._fp is None:
             return True
         elif hasattr(self._fp, "isclosed"):
@@ -703,18 +1325,18 @@ class HTTPResponse(io.IOBase):
         else:
             return True
 
-    def fileno(self):
+    def fileno(self) -> int:
         if self._fp is None:
-            raise IOError("HTTPResponse has no file to get a fileno from")
+            raise OSError("HTTPResponse has no file to get a fileno from")
         elif hasattr(self._fp, "fileno"):
             return self._fp.fileno()
         else:
-            raise IOError(
+            raise OSError(
                 "The file-like object this HTTPResponse is wrapped "
                 "around has no file descriptor"
             )
 
-    def flush(self):
+    def flush(self) -> None:
         if (
             self._fp is not None
             and hasattr(self._fp, "flush")
@@ -722,20 +1344,7 @@ class HTTPResponse(io.IOBase):
         ):
             return self._fp.flush()
 
-    def readable(self):
-        # This method is required for `io` module compatibility.
-        return True
-
-    def readinto(self, b):
-        # This method is required for `io` module compatibility.
-        temp = self.read(len(b))
-        if len(temp) == 0:
-            return 0
-        else:
-            b[: len(temp)] = temp
-            return len(temp)
-
-    def supports_chunked_reads(self):
+    def supports_chunked_reads(self) -> bool:
         """
         Checks if the underlying file-like object looks like a
         :class:`http.client.HTTPResponse` object. We do this by testing for
@@ -744,43 +1353,54 @@ class HTTPResponse(io.IOBase):
         """
         return hasattr(self._fp, "fp")
 
-    def _update_chunk_length(self):
+    def _update_chunk_length(self) -> None:
         # First, we'll figure out length of a chunk and then
         # we'll try to read it from socket.
         if self.chunk_left is not None:
-            return
-        line = self._fp.fp.readline()
+            return None
+        line = self._fp.fp.readline(_MAX_CHUNK_LINE_LENGTH + 1)  # type: ignore[union-attr]
+        if len(line) > _MAX_CHUNK_LINE_LENGTH:
+            self.close()
+            raise ProtocolError(
+                "Response chunk size line exceeded maximum allowed length"
+            ) from None
         line = line.split(b";", 1)[0]
         try:
             self.chunk_left = int(line, 16)
         except ValueError:
-            # Invalid chunked protocol response, abort.
             self.close()
-            raise InvalidChunkLength(self, line)
+            if line:
+                # Invalid chunked protocol response, abort.
+                raise InvalidChunkLength(self, line) from None
+            else:
+                # Truncated at start of next chunk
+                raise ProtocolError("Response ended prematurely") from None
 
-    def _handle_chunk(self, amt):
+    def _handle_chunk(self, amt: int | None) -> bytes:
         returned_chunk = None
         if amt is None:
-            chunk = self._fp._safe_read(self.chunk_left)
+            chunk = self._fp._safe_read(self.chunk_left)  # type: ignore[union-attr]
             returned_chunk = chunk
-            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
-        elif amt < self.chunk_left:
-            value = self._fp._safe_read(amt)
+        elif self.chunk_left is not None and amt < self.chunk_left:
+            value = self._fp._safe_read(amt)  # type: ignore[union-attr]
             self.chunk_left = self.chunk_left - amt
             returned_chunk = value
         elif amt == self.chunk_left:
-            value = self._fp._safe_read(amt)
-            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            value = self._fp._safe_read(amt)  # type: ignore[union-attr]
+            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
             returned_chunk = value
         else:  # amt > self.chunk_left
-            returned_chunk = self._fp._safe_read(self.chunk_left)
-            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            returned_chunk = self._fp._safe_read(self.chunk_left)  # type: ignore[union-attr]
+            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
-        return returned_chunk
+        return returned_chunk  # type: ignore[no-any-return]
 
-    def read_chunked(self, amt=None, decode_content=None):
+    def read_chunked(
+        self, amt: int | None = None, decode_content: bool | None = None
+    ) -> typing.Generator[bytes]:
         """
         Similar to :meth:`HTTPResponse.read`, but with an additional
         parameter: ``decode_content``.
@@ -811,20 +1431,35 @@ class HTTPResponse(io.IOBase):
             # Don't bother reading the body of a HEAD request.
             if self._original_response and is_response_to_head(self._original_response):
                 self._original_response.close()
-                return
+                return None
 
             # If a response is already read and closed
             # then return immediately.
-            if self._fp.fp is None:
+            if self._fp.fp is None:  # type: ignore[union-attr]
+                return None
+
+            if amt == 0:
                 return
+            elif amt and amt < 0:
+                # Negative numbers and `None` should be treated the same,
+                # but httplib handles only `None` correctly.
+                amt = None
 
             while True:
-                self._update_chunk_length()
-                if self.chunk_left == 0:
-                    break
-                chunk = self._handle_chunk(amt)
+                # First, check if any data is left in the decoder's buffer.
+                if self._decoder and self._decoder.has_unconsumed_tail:
+                    chunk = b""
+                else:
+                    self._update_chunk_length()
+                    self._uncached_read_occurred = True
+                    if self.chunk_left == 0:
+                        break
+                    chunk = self._handle_chunk(amt)
                 decoded = self._decode(
-                    chunk, decode_content=decode_content, flush_decoder=False
+                    chunk,
+                    decode_content=decode_content,
+                    flush_decoder=False,
+                    max_length=amt,
                 )
                 if decoded:
                     yield decoded
@@ -838,8 +1473,12 @@ class HTTPResponse(io.IOBase):
                     yield decoded
 
             # Chunk content ends with \r\n: discard it.
-            while True:
-                line = self._fp.fp.readline()
+            while self._fp is not None:
+                line = self._fp.fp.readline(_MAX_CHUNK_LINE_LENGTH + 1)
+                if len(line) > _MAX_CHUNK_LINE_LENGTH:
+                    raise ProtocolError(
+                        "Response chunk trailer line exceeded maximum allowed length"
+                    )
                 if not line:
                     # Some sites may not end with '\r\n'.
                     break
@@ -850,27 +1489,29 @@ class HTTPResponse(io.IOBase):
             if self._original_response:
                 self._original_response.close()
 
-    def geturl(self):
+    @property
+    def url(self) -> str | None:
         """
         Returns the URL that was the source of this response.
         If the request that generated this response redirected, this method
         will return the final redirect location.
         """
-        if self.retries is not None and len(self.retries.history):
-            return self.retries.history[-1].redirect_location
-        else:
-            return self._request_url
+        return self._request_url
 
-    def __iter__(self):
-        buffer = []
+    @url.setter
+    def url(self, url: str | None) -> None:
+        self._request_url = url
+
+    def __iter__(self) -> typing.Iterator[bytes]:
+        buffer: list[bytes] = []
         for chunk in self.stream(decode_content=True):
             if b"\n" in chunk:
-                chunk = chunk.split(b"\n")
-                yield b"".join(buffer) + chunk[0] + b"\n"
-                for x in chunk[1:-1]:
+                chunks = chunk.split(b"\n")
+                yield b"".join(buffer) + chunks[0] + b"\n"
+                for x in chunks[1:-1]:
                     yield x + b"\n"
-                if chunk[-1]:
-                    buffer = [chunk[-1]]
+                if chunks[-1]:
+                    buffer = [chunks[-1]]
                 else:
                     buffer = []
             else:
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/__init__.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/__init__.py
index 4547fc5..5341260 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/__init__.py
@@ -1,46 +1,39 @@
-from __future__ import absolute_import
-
 # For backwards compatibility, provide imports that used to be here.
+from __future__ import annotations
+
 from .connection import is_connection_dropped
 from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers
 from .response import is_fp_closed
 from .retry import Retry
 from .ssl_ import (
     ALPN_PROTOCOLS,
-    HAS_SNI,
     IS_PYOPENSSL,
-    IS_SECURETRANSPORT,
-    PROTOCOL_TLS,
     SSLContext,
     assert_fingerprint,
+    create_urllib3_context,
     resolve_cert_reqs,
     resolve_ssl_version,
     ssl_wrap_socket,
 )
-from .timeout import Timeout, current_time
-from .url import Url, get_host, parse_url, split_first
+from .timeout import Timeout
+from .url import Url, parse_url
 from .wait import wait_for_read, wait_for_write
 
 __all__ = (
-    "HAS_SNI",
     "IS_PYOPENSSL",
-    "IS_SECURETRANSPORT",
     "SSLContext",
-    "PROTOCOL_TLS",
     "ALPN_PROTOCOLS",
     "Retry",
     "Timeout",
     "Url",
     "assert_fingerprint",
-    "current_time",
+    "create_urllib3_context",
     "is_connection_dropped",
     "is_fp_closed",
-    "get_host",
     "parse_url",
     "make_headers",
     "resolve_cert_reqs",
     "resolve_ssl_version",
-    "split_first",
     "ssl_wrap_socket",
     "wait_for_read",
     "wait_for_write",
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/connection.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/connection.py
index 6af1138..f92519e 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/connection.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/connection.py
@@ -1,33 +1,23 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import socket
+import typing
 
-from ..contrib import _appengine_environ
 from ..exceptions import LocationParseError
-from ..packages import six
-from .wait import NoWayToWaitForSocketError, wait_for_read
+from .timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT
+
+_TYPE_SOCKET_OPTIONS = list[tuple[int, int, typing.Union[int, bytes]]]
+
+if typing.TYPE_CHECKING:
+    from .._base_connection import BaseHTTPConnection
 
 
-def is_connection_dropped(conn):  # Platform-specific
+def is_connection_dropped(conn: BaseHTTPConnection) -> bool:  # Platform-specific
     """
     Returns True if the connection is dropped and should be closed.
-
-    :param conn:
-        :class:`http.client.HTTPConnection` object.
-
-    Note: For platforms like AppEngine, this will always return ``False`` to
-    let the platform handle connection recycling transparently for us.
+    :param conn: :class:`urllib3.connection.HTTPConnection` object.
     """
-    sock = getattr(conn, "sock", False)
-    if sock is False:  # Platform-specific: AppEngine
-        return False
-    if sock is None:  # Connection already closed (such as by httplib).
-        return True
-    try:
-        # Returns True if readable, which here means it's been dropped
-        return wait_for_read(sock, timeout=0.0)
-    except NoWayToWaitForSocketError:  # Platform-specific: AppEngine
-        return False
+    return not conn.is_connected
 
 
 # This function is copied from socket.py in the Python 2.7 standard
@@ -35,11 +25,11 @@ def is_connection_dropped(conn):  # Platform-specific
 # One additional modification is that we avoid binding to IPv6 servers
 # discovered in DNS if the system doesn't have IPv6 functionality.
 def create_connection(
-    address,
-    timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
-    source_address=None,
-    socket_options=None,
-):
+    address: tuple[str, int],
+    timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+    source_address: tuple[str, int] | None = None,
+    socket_options: _TYPE_SOCKET_OPTIONS | None = None,
+) -> socket.socket:
     """Connect to *address* and return the socket object.
 
     Convenience function.  Connect to *address* (a 2-tuple ``(host,
@@ -65,9 +55,7 @@ def create_connection(
     try:
         host.encode("idna")
     except UnicodeError:
-        return six.raise_from(
-            LocationParseError(u"'%s', label empty or too long" % host), None
-        )
+        raise LocationParseError(f"'{host}', label empty or too long") from None
 
     for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM):
         af, socktype, proto, canonname, sa = res
@@ -78,26 +66,33 @@ def create_connection(
             # If provided, set socket level options before connecting.
             _set_socket_options(sock, socket_options)
 
-            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
+            if timeout is not _DEFAULT_TIMEOUT:
                 sock.settimeout(timeout)
             if source_address:
                 sock.bind(source_address)
             sock.connect(sa)
+            # Break explicitly a reference cycle
+            err = None
             return sock
 
-        except socket.error as e:
-            err = e
+        except OSError as _:
+            err = _
             if sock is not None:
                 sock.close()
-                sock = None
 
     if err is not None:
-        raise err
-
-    raise socket.error("getaddrinfo returns an empty list")
+        try:
+            raise err
+        finally:
+            # Break explicitly a reference cycle
+            err = None
+    else:
+        raise OSError("getaddrinfo returns an empty list")
 
 
-def _set_socket_options(sock, options):
+def _set_socket_options(
+    sock: socket.socket, options: _TYPE_SOCKET_OPTIONS | None
+) -> None:
     if options is None:
         return
 
@@ -105,7 +100,7 @@ def _set_socket_options(sock, options):
         sock.setsockopt(*opt)
 
 
-def allowed_gai_family():
+def allowed_gai_family() -> socket.AddressFamily:
     """This function is designed to work in the context of
     getaddrinfo, where family=socket.AF_UNSPEC is the default and
     will perform a DNS search for both IPv6 and IPv4 records."""
@@ -116,18 +111,11 @@ def allowed_gai_family():
     return family
 
 
-def _has_ipv6(host):
+def _has_ipv6(host: str) -> bool:
     """Returns True if the system can bind an IPv6 address."""
     sock = None
     has_ipv6 = False
 
-    # App Engine doesn't support IPV6 sockets and actually has a quota on the
-    # number of sockets that can be used, so just early out here instead of
-    # creating a socket needlessly.
-    # See https://github.com/urllib3/urllib3/issues/1446
-    if _appengine_environ.is_appengine_sandbox():
-        return False
-
     if socket.has_ipv6:
         # has_ipv6 returns true if cPython was compiled with IPv6 support.
         # It does not tell us if the system has IPv6 support enabled. To
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/proxy.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/proxy.py
index 2199cc7..908fc66 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/proxy.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/proxy.py
@@ -1,9 +1,18 @@
-from .ssl_ import create_urllib3_context, resolve_cert_reqs, resolve_ssl_version
+from __future__ import annotations
+
+import typing
+
+from .url import Url
+
+if typing.TYPE_CHECKING:
+    from ..connection import ProxyConfig
 
 
 def connection_requires_http_tunnel(
-    proxy_url=None, proxy_config=None, destination_scheme=None
-):
+    proxy_url: Url | None = None,
+    proxy_config: ProxyConfig | None = None,
+    destination_scheme: str | None = None,
+) -> bool:
     """
     Returns True if the connection requires an HTTP CONNECT through the proxy.
 
@@ -32,26 +41,3 @@ def connection_requires_http_tunnel(
 
     # Otherwise always use a tunnel.
     return True
-
-
-def create_proxy_ssl_context(
-    ssl_version, cert_reqs, ca_certs=None, ca_cert_dir=None, ca_cert_data=None
-):
-    """
-    Generates a default proxy ssl context if one hasn't been provided by the
-    user.
-    """
-    ssl_context = create_urllib3_context(
-        ssl_version=resolve_ssl_version(ssl_version),
-        cert_reqs=resolve_cert_reqs(cert_reqs),
-    )
-
-    if (
-        not ca_certs
-        and not ca_cert_dir
-        and not ca_cert_data
-        and hasattr(ssl_context, "load_default_certs")
-    ):
-        ssl_context.load_default_certs()
-
-    return ssl_context
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/queue.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/queue.py
deleted file mode 100644
index 4178410..0000000
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/queue.py
+++ /dev/null
@@ -1,22 +0,0 @@
-import collections
-
-from ..packages import six
-from ..packages.six.moves import queue
-
-if six.PY2:
-    # Queue is imported for side effects on MS Windows. See issue #229.
-    import Queue as _unused_module_Queue  # noqa: F401
-
-
-class LifoQueue(queue.Queue):
-    def _init(self, _):
-        self.queue = collections.deque()
-
-    def _qsize(self, len=len):
-        return len(self.queue)
-
-    def _put(self, item):
-        self.queue.append(item)
-
-    def _get(self):
-        return self.queue.pop()
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/request.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/request.py
index 330766e..8ae5d65 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/request.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/request.py
@@ -1,9 +1,16 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
+import io
+import sys
+import typing
 from base64 import b64encode
+from enum import Enum
 
 from ..exceptions import UnrewindableBodyError
-from ..packages.six import b, integer_types
+from .util import to_bytes
+
+if typing.TYPE_CHECKING:
+    from typing import Final
 
 # Pass as a value within ``headers`` to skip
 # emitting some HTTP headers that are added automatically.
@@ -14,17 +21,44 @@ SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"])
 
 ACCEPT_ENCODING = "gzip,deflate"
 
-_FAILEDTELL = object()
+try:
+    if sys.version_info >= (3, 14):
+        from compression import zstd as _unused_module_zstd  # noqa: F401
+    else:
+        from backports import zstd as _unused_module_zstd  # noqa: F401
+except ImportError:
+    pass
+else:
+    ACCEPT_ENCODING += ",zstd"
+
+
+class _TYPE_FAILEDTELL(Enum):
+    token = 0
+
+
+_FAILEDTELL: Final[_TYPE_FAILEDTELL] = _TYPE_FAILEDTELL.token
+
+_TYPE_BODY_POSITION = typing.Union[int, _TYPE_FAILEDTELL]
+
+# When sending a request with these methods we aren't expecting
+# a body so don't need to set an explicit 'Content-Length: 0'
+# The reason we do this in the negative instead of tracking methods
+# which 'should' have a body is because unknown methods should be
+# treated as if they were 'POST' which *does* expect a body.
+_METHODS_NOT_EXPECTING_BODY = {"GET", "HEAD", "DELETE", "TRACE", "OPTIONS", "CONNECT"}
 
 
 def make_headers(
-    keep_alive=None,
-    accept_encoding=None,
-    user_agent=None,
-    basic_auth=None,
-    proxy_basic_auth=None,
-    disable_cache=None,
-):
+    keep_alive: bool | None = None,
+    accept_encoding: bool | list[str] | str | None = None,
+    user_agent: str | None = None,
+    basic_auth: str | None = None,
+    proxy_basic_auth: str | None = None,
+    disable_cache: bool | None = None,
+    *,
+    basic_auth_encoding: str = "latin-1",
+    proxy_basic_auth_encoding: str = "latin-1",
+) -> dict[str, str]:
     """
     Shortcuts for generating request headers.
 
@@ -33,7 +67,11 @@ def make_headers(
 
     :param accept_encoding:
         Can be a boolean, list, or string.
-        ``True`` translates to 'gzip,deflate'.
+        ``True`` translates to 'gzip,deflate'.  If the dependencies for
+        Brotli (either the ``brotli`` or ``brotlicffi`` package) and/or
+        Zstandard (the ``backports.zstd`` package for Python before 3.14)
+        algorithms are installed, then their encodings are
+        included in the string ('br' and 'zstd', respectively).
         List will get joined by comma.
         String will be used as provided.
 
@@ -43,23 +81,58 @@ def make_headers(
 
     :param basic_auth:
         Colon-separated username:password string for 'authorization: basic ...'
-        auth header.
+        auth header. Basic authentication transmits Base64-encoded bytes, not
+        Unicode text, so the string is encoded with ``basic_auth_encoding``
+        before Base64 encoding.
+
+        Must contain decoded credentials (not percent-encoded).
+        For URLs parsed with :func:`parse_url`, use :attr:`Url.auth_decoded_joined`
+        to get the properly formatted string.
+
+    :param basic_auth_encoding:
+        Text encoding used to encode ``basic_auth`` before Base64 encoding.
+        Defaults to "latin-1" for backward compatibility. Use "utf-8" only
+        when the peer expects UTF-8 Basic authentication credentials.
+
+        Must contain decoded credentials (not percent-encoded).
+        For URLs parsed with :func:`parse_url`, use :attr:`Url.auth_decoded_joined`
+        to get the properly formatted string.
 
     :param proxy_basic_auth:
         Colon-separated username:password string for 'proxy-authorization: basic ...'
-        auth header.
+        auth header. Basic authentication transmits Base64-encoded bytes, not
+        Unicode text, so the string is encoded with ``proxy_basic_auth_encoding``
+        before Base64 encoding.
+
+        Must contain decoded credentials (not percent-encoded).
+        For URLs parsed with :func:`parse_url`, use :attr:`Url.auth_decoded_joined`
+        to get the properly formatted string.
+
+    :param proxy_basic_auth_encoding:
+        Text encoding used to encode ``proxy_basic_auth`` before Base64
+        encoding. Defaults to "latin-1" for backward compatibility. Use
+        "utf-8" only when the proxy expects UTF-8 Basic authentication
+        credentials.
+
+        Must contain decoded credentials (not percent-encoded).
+        For URLs parsed with :func:`parse_url`, use :attr:`Url.auth_decoded_joined`
+        to get the properly formatted string.
 
     :param disable_cache:
         If ``True``, adds 'cache-control: no-cache' header.
 
-    Example::
+    Example:
 
-        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
-        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
-        >>> make_headers(accept_encoding=True)
-        {'accept-encoding': 'gzip,deflate'}
+    .. code-block:: python
+
+        from pip._vendor import urllib3
+
+        print(urllib3.util.make_headers(keep_alive=True, user_agent="Batman/1.0"))
+        # {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
+        print(urllib3.util.make_headers(accept_encoding=True))
+        # {'accept-encoding': 'gzip,deflate'}
     """
-    headers = {}
+    headers: dict[str, str] = {}
     if accept_encoding:
         if isinstance(accept_encoding, str):
             pass
@@ -76,12 +149,14 @@ def make_headers(
         headers["connection"] = "keep-alive"
 
     if basic_auth:
-        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")
+        headers["authorization"] = (
+            f"Basic {b64encode(basic_auth.encode(basic_auth_encoding)).decode()}"
+        )
 
     if proxy_basic_auth:
-        headers["proxy-authorization"] = "Basic " + b64encode(
-            b(proxy_basic_auth)
-        ).decode("utf-8")
+        headers["proxy-authorization"] = (
+            f"Basic {b64encode(proxy_basic_auth.encode(proxy_basic_auth_encoding)).decode()}"
+        )
 
     if disable_cache:
         headers["cache-control"] = "no-cache"
@@ -89,7 +164,9 @@ def make_headers(
     return headers
 
 
-def set_file_position(body, pos):
+def set_file_position(
+    body: typing.Any, pos: _TYPE_BODY_POSITION | None
+) -> _TYPE_BODY_POSITION | None:
     """
     If a position is provided, move file to that point.
     Otherwise, we'll attempt to record a position for future use.
@@ -99,7 +176,7 @@ def set_file_position(body, pos):
     elif getattr(body, "tell", None) is not None:
         try:
             pos = body.tell()
-        except (IOError, OSError):
+        except OSError:
             # This differentiates from None, allowing us to catch
             # a failed `tell()` later when trying to rewind the body.
             pos = _FAILEDTELL
@@ -107,7 +184,7 @@ def set_file_position(body, pos):
     return pos
 
 
-def rewind_body(body, body_pos):
+def rewind_body(body: typing.IO[typing.AnyStr], body_pos: _TYPE_BODY_POSITION) -> None:
     """
     Attempt to rewind body to a certain position.
     Primarily used for request redirects and retries.
@@ -119,19 +196,95 @@ def rewind_body(body, body_pos):
         Position to seek to in file.
     """
     body_seek = getattr(body, "seek", None)
-    if body_seek is not None and isinstance(body_pos, integer_types):
+    if body_seek is not None and isinstance(body_pos, int):
         try:
             body_seek(body_pos)
-        except (IOError, OSError):
+        except OSError as e:
             raise UnrewindableBodyError(
                 "An error occurred when rewinding request body for redirect/retry."
-            )
+            ) from e
     elif body_pos is _FAILEDTELL:
         raise UnrewindableBodyError(
             "Unable to record file position for rewinding "
             "request body during a redirect/retry."
         )
+    elif body_seek is None:
+        raise UnrewindableBodyError("body does not implement seek.")
     else:
         raise ValueError(
-            "body_pos must be of type integer, instead it was %s." % type(body_pos)
+            f"body_pos must be of type integer, instead it was {type(body_pos)}."
         )
+
+
+class ChunksAndContentLength(typing.NamedTuple):
+    chunks: typing.Iterable[bytes] | None
+    content_length: int | None
+
+
+def body_to_chunks(
+    body: typing.Any | None, method: str, blocksize: int
+) -> ChunksAndContentLength:
+    """Takes the HTTP request method, body, and blocksize and
+    transforms them into an iterable of chunks to pass to
+    socket.sendall() and an optional 'Content-Length' header.
+
+    A 'Content-Length' of 'None' indicates the length of the body
+    can't be determined so should use 'Transfer-Encoding: chunked'
+    for framing instead.
+    """
+
+    chunks: typing.Iterable[bytes] | None
+    content_length: int | None
+
+    # No body, we need to make a recommendation on 'Content-Length'
+    # based on whether that request method is expected to have
+    # a body or not.
+    if body is None:
+        chunks = None
+        if method.upper() not in _METHODS_NOT_EXPECTING_BODY:
+            content_length = 0
+        else:
+            content_length = None
+
+    # Bytes or strings become bytes
+    elif isinstance(body, (str, bytes)):
+        chunks = (to_bytes(body),)
+        content_length = len(chunks[0])
+
+    # File-like object, TODO: use seek() and tell() for length?
+    elif hasattr(body, "read"):
+
+        def chunk_readable() -> typing.Iterable[bytes]:
+            encode = isinstance(body, io.TextIOBase)
+            while True:
+                datablock = body.read(blocksize)
+                if not datablock:
+                    break
+                if encode:
+                    datablock = datablock.encode("utf-8")
+                yield datablock
+
+        chunks = chunk_readable()
+        content_length = None
+
+    # Otherwise we need to start checking via duck-typing.
+    else:
+        try:
+            # Check if the body implements the buffer API.
+            mv = memoryview(body)
+        except TypeError:
+            try:
+                # Check if the body is an iterable
+                chunks = iter(body)
+                content_length = None
+            except TypeError:
+                raise TypeError(
+                    f"'body' must be a bytes-like object, file-like "
+                    f"object, or iterable. Instead was {body!r}"
+                ) from None
+        else:
+            # Since it implements the buffer API can be passed directly to socket.sendall()
+            chunks = (body,)
+            content_length = mv.nbytes
+
+    return ChunksAndContentLength(chunks=chunks, content_length=content_length)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/response.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/response.py
index 5ea609c..0f45786 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/response.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/response.py
@@ -1,12 +1,12 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
+import http.client as httplib
 from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect
 
 from ..exceptions import HeaderParsingError
-from ..packages.six.moves import http_client as httplib
 
 
-def is_fp_closed(obj):
+def is_fp_closed(obj: object) -> bool:
     """
     Checks whether a given file-like object is closed.
 
@@ -17,27 +17,27 @@ def is_fp_closed(obj):
     try:
         # Check `isclosed()` first, in case Python3 doesn't set `closed`.
         # GH Issue #928
-        return obj.isclosed()
+        return obj.isclosed()  # type: ignore[no-any-return, attr-defined]
     except AttributeError:
         pass
 
     try:
         # Check via the official file-like-object way.
-        return obj.closed
+        return obj.closed  # type: ignore[no-any-return, attr-defined]
     except AttributeError:
         pass
 
     try:
         # Check if the object is a container for another file-like object that
         # gets released on exhaustion (e.g. HTTPResponse).
-        return obj.fp is None
+        return obj.fp is None  # type: ignore[attr-defined]
     except AttributeError:
         pass
 
     raise ValueError("Unable to determine whether fp is closed.")
 
 
-def assert_header_parsing(headers):
+def assert_header_parsing(headers: httplib.HTTPMessage) -> None:
     """
     Asserts whether all headers have been successfully parsed.
     Extracts encountered errors from the result of parsing headers.
@@ -53,55 +53,49 @@ def assert_header_parsing(headers):
     # This will fail silently if we pass in the wrong kind of parameter.
     # To make debugging easier add an explicit check.
     if not isinstance(headers, httplib.HTTPMessage):
-        raise TypeError("expected httplib.Message, got {0}.".format(type(headers)))
-
-    defects = getattr(headers, "defects", None)
-    get_payload = getattr(headers, "get_payload", None)
+        raise TypeError(f"expected httplib.Message, got {type(headers)}.")
 
     unparsed_data = None
-    if get_payload:
-        # get_payload is actually email.message.Message.get_payload;
-        # we're only interested in the result if it's not a multipart message
-        if not headers.is_multipart():
-            payload = get_payload()
 
-            if isinstance(payload, (bytes, str)):
-                unparsed_data = payload
-    if defects:
-        # httplib is assuming a response body is available
-        # when parsing headers even when httplib only sends
-        # header data to parse_headers() This results in
-        # defects on multipart responses in particular.
-        # See: https://github.com/urllib3/urllib3/issues/800
+    # get_payload is actually email.message.Message.get_payload;
+    # we're only interested in the result if it's not a multipart message
+    if not headers.is_multipart():
+        payload = headers.get_payload()
 
-        # So we ignore the following defects:
-        # - StartBoundaryNotFoundDefect:
-        #     The claimed start boundary was never found.
-        # - MultipartInvariantViolationDefect:
-        #     A message claimed to be a multipart but no subparts were found.
-        defects = [
-            defect
-            for defect in defects
-            if not isinstance(
-                defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
-            )
-        ]
+        if isinstance(payload, (bytes, str)):
+            unparsed_data = payload
+
+    # httplib is assuming a response body is available
+    # when parsing headers even when httplib only sends
+    # header data to parse_headers() This results in
+    # defects on multipart responses in particular.
+    # See: https://github.com/urllib3/urllib3/issues/800
+
+    # So we ignore the following defects:
+    # - StartBoundaryNotFoundDefect:
+    #     The claimed start boundary was never found.
+    # - MultipartInvariantViolationDefect:
+    #     A message claimed to be a multipart but no subparts were found.
+    defects = [
+        defect
+        for defect in headers.defects
+        if not isinstance(
+            defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
+        )
+    ]
 
     if defects or unparsed_data:
         raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data)
 
 
-def is_response_to_head(response):
+def is_response_to_head(response: httplib.HTTPResponse) -> bool:
     """
     Checks whether the request of a response has been a HEAD-request.
-    Handles the quirks of AppEngine.
 
     :param http.client.HTTPResponse response:
         Response to check if the originating request
         used 'HEAD' as a method.
     """
     # FIXME: Can we do this somehow without accessing private httplib _method?
-    method = response._method
-    if isinstance(method, int):  # Platform-specific: Appengine
-        return method == 3
-    return method.upper() == "HEAD"
+    method_str = response._method  # type: str  # type: ignore[attr-defined]
+    return method_str.upper() == "HEAD"
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/retry.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/retry.py
index 9a1e90d..868f293 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/retry.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/retry.py
@@ -1,12 +1,15 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import email
 import logging
+import random
 import re
 import time
+import typing
 import warnings
-from collections import namedtuple
+from collections.abc import Collection
 from itertools import takewhile
+from types import TracebackType
 
 from ..exceptions import (
     ConnectTimeoutError,
@@ -17,97 +20,51 @@ from ..exceptions import (
     ReadTimeoutError,
     ResponseError,
 )
-from ..packages import six
+from .util import reraise
+
+if typing.TYPE_CHECKING:
+    from typing_extensions import Self
+
+    from ..connectionpool import ConnectionPool
+    from ..response import BaseHTTPResponse
 
 log = logging.getLogger(__name__)
 
 
 # Data structure for representing the metadata of requests that result in a retry.
-RequestHistory = namedtuple(
-    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
-)
+class RequestHistory(typing.NamedTuple):
+    method: str | None
+    url: str | None
+    error: Exception | None
+    status: int | None
+    redirect_location: str | None
 
 
-# TODO: In v2 we can remove this sentinel and metaclass with deprecated options.
-_Default = object()
-
-
-class _RetryMeta(type):
-    @property
-    def DEFAULT_METHOD_WHITELIST(cls):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
-            DeprecationWarning,
-        )
-        return cls.DEFAULT_ALLOWED_METHODS
-
-    @DEFAULT_METHOD_WHITELIST.setter
-    def DEFAULT_METHOD_WHITELIST(cls, value):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
-            DeprecationWarning,
-        )
-        cls.DEFAULT_ALLOWED_METHODS = value
-
-    @property
-    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
-            DeprecationWarning,
-        )
-        return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
-
-    @DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter
-    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
-            DeprecationWarning,
-        )
-        cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value
-
-    @property
-    def BACKOFF_MAX(cls):
-        warnings.warn(
-            "Using 'Retry.BACKOFF_MAX' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
-            DeprecationWarning,
-        )
-        return cls.DEFAULT_BACKOFF_MAX
-
-    @BACKOFF_MAX.setter
-    def BACKOFF_MAX(cls, value):
-        warnings.warn(
-            "Using 'Retry.BACKOFF_MAX' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
-            DeprecationWarning,
-        )
-        cls.DEFAULT_BACKOFF_MAX = value
-
-
-@six.add_metaclass(_RetryMeta)
-class Retry(object):
+class Retry:
     """Retry configuration.
 
     Each retry attempt will create a new Retry object with updated values, so
     they can be safely reused.
 
-    Retries can be defined as a default for a pool::
+    Retries can be defined as a default for a pool:
+
+    .. code-block:: python
 
         retries = Retry(connect=5, read=2, redirect=5)
         http = PoolManager(retries=retries)
-        response = http.request('GET', 'http://example.com/')
+        response = http.request("GET", "https://example.com/")
 
-    Or per-request (which overrides the default for the pool)::
+    Or per-request (which overrides the default for the pool):
 
-        response = http.request('GET', 'http://example.com/', retries=Retry(10))
+    .. code-block:: python
 
-    Retries can be disabled by passing ``False``::
+        response = http.request("GET", "https://example.com/", retries=Retry(10))
 
-        response = http.request('GET', 'http://example.com/', retries=False)
+    Retries can be disabled by passing ``False``:
+
+    .. code-block:: python
+
+        response = http.request("GET", "https://example.com/", retries=False)
 
     Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
     retries are disabled, in which case the causing exception will be raised.
@@ -169,21 +126,16 @@ class Retry(object):
         If ``total`` is not set, it's a good idea to set this to 0 to account
         for unexpected edge cases and avoid infinite retry loops.
 
-    :param iterable allowed_methods:
+    :param Collection allowed_methods:
         Set of uppercased HTTP method verbs that we should retry on.
 
         By default, we only retry on methods which are considered to be
         idempotent (multiple requests with the same parameters end with the
         same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`.
 
-        Set to a ``False`` value to retry on any verb.
+        Set to a ``None`` value to retry on any verb.
 
-        .. warning::
-
-            Previously this parameter was named ``method_whitelist``, that
-            usage is deprecated in v1.26.0 and will be removed in v2.0.
-
-    :param iterable status_forcelist:
+    :param Collection status_forcelist:
         A set of integer HTTP status codes that we should force a retry on.
         A retry is initiated if the request method is in ``allowed_methods``
         and the response status code is in ``status_forcelist``.
@@ -195,13 +147,25 @@ class Retry(object):
         (most errors are resolved immediately by a second try without a
         delay). urllib3 will sleep for::
 
-            {backoff factor} * (2 ** ({number of total retries} - 1))
+            {backoff factor} * (2 ** ({number of previous retries}))
 
-        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
-        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
-        than :attr:`Retry.DEFAULT_BACKOFF_MAX`.
+        seconds. If `backoff_jitter` is non-zero, this sleep is extended by::
 
-        By default, backoff is disabled (set to 0).
+            random.uniform(0, {backoff jitter})
+
+        seconds. For example, if the backoff_factor is 0.1, then :func:`Retry.sleep` will
+        sleep for [0.0s, 0.2s, 0.4s, 0.8s, ...] between retries. No backoff will ever
+        be longer than `backoff_max`.
+
+        By default, backoff is disabled (factor set to 0).
+
+    :param float backoff_max:
+        The maximum backoff time (in seconds) between retry attempts.
+        This value caps the computed backoff from `backoff_factor`.
+
+    :param float backoff_jitter:
+        Random jitter amount (in seconds) added to the computed backoff.
+        Jitter is sampled uniformly from `0` to `backoff_jitter`.
 
     :param bool raise_on_redirect: Whether, if the number of redirects is
         exhausted, to raise a MaxRetryError, or to return a response with a
@@ -220,10 +184,15 @@ class Retry(object):
         Whether to respect Retry-After header on status codes defined as
         :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.
 
-    :param iterable remove_headers_on_redirect:
+    :param Collection remove_headers_on_redirect:
         Sequence of headers to remove from the request when a response
         indicating a redirect is returned before firing off the redirected
         request.
+
+    :param int retry_after_max: Number of seconds to allow as the maximum for
+        Retry-After headers. Defaults to :attr:`Retry.DEFAULT_RETRY_AFTER_MAX`.
+        Any Retry-After headers larger than this value will be limited to this
+        value.
     """
 
     #: Default methods to be used for ``allowed_methods``
@@ -231,7 +200,8 @@ class Retry(object):
         ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"]
     )
 
-    #: Default status codes to be used for ``status_forcelist``
+    #: Default status codes that trigger a retry when a Retry-After header is
+    #: present and ``respect_retry_after_header`` is enabled.
     RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503])
 
     #: Default headers to be used for ``remove_headers_on_redirect``
@@ -239,48 +209,38 @@ class Retry(object):
         ["Cookie", "Authorization", "Proxy-Authorization"]
     )
 
-    #: Maximum backoff time.
+    #: Default maximum backoff time.
     DEFAULT_BACKOFF_MAX = 120
 
+    # This is undocumented in the RFC. Setting to 6 hours matches other popular libraries.
+    #: Default maximum allowed value for Retry-After headers in seconds
+    DEFAULT_RETRY_AFTER_MAX: typing.Final[int] = 21600
+
+    # Backward compatibility; assigned outside of the class.
+    DEFAULT: typing.ClassVar[Retry]
+
     def __init__(
         self,
-        total=10,
-        connect=None,
-        read=None,
-        redirect=None,
-        status=None,
-        other=None,
-        allowed_methods=_Default,
-        status_forcelist=None,
-        backoff_factor=0,
-        raise_on_redirect=True,
-        raise_on_status=True,
-        history=None,
-        respect_retry_after_header=True,
-        remove_headers_on_redirect=_Default,
-        # TODO: Deprecated, remove in v2.0
-        method_whitelist=_Default,
-    ):
-
-        if method_whitelist is not _Default:
-            if allowed_methods is not _Default:
-                raise ValueError(
-                    "Using both 'allowed_methods' and "
-                    "'method_whitelist' together is not allowed. "
-                    "Instead only use 'allowed_methods'"
-                )
-            warnings.warn(
-                "Using 'method_whitelist' with Retry is deprecated and "
-                "will be removed in v2.0. Use 'allowed_methods' instead",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            allowed_methods = method_whitelist
-        if allowed_methods is _Default:
-            allowed_methods = self.DEFAULT_ALLOWED_METHODS
-        if remove_headers_on_redirect is _Default:
-            remove_headers_on_redirect = self.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
-
+        total: bool | int | None = 10,
+        connect: int | None = None,
+        read: int | None = None,
+        redirect: bool | int | None = None,
+        status: int | None = None,
+        other: int | None = None,
+        allowed_methods: typing.Collection[str] | None = DEFAULT_ALLOWED_METHODS,
+        status_forcelist: typing.Collection[int] | None = None,
+        backoff_factor: float = 0,
+        backoff_max: float = DEFAULT_BACKOFF_MAX,
+        raise_on_redirect: bool = True,
+        raise_on_status: bool = True,
+        history: tuple[RequestHistory, ...] | None = None,
+        respect_retry_after_header: bool = True,
+        remove_headers_on_redirect: typing.Collection[
+            str
+        ] = DEFAULT_REMOVE_HEADERS_ON_REDIRECT,
+        backoff_jitter: float = 0.0,
+        retry_after_max: int = DEFAULT_RETRY_AFTER_MAX,
+    ) -> None:
         self.total = total
         self.connect = connect
         self.read = read
@@ -293,17 +253,29 @@ class Retry(object):
 
         self.redirect = redirect
         self.status_forcelist = status_forcelist or set()
+        if not allowed_methods and isinstance(allowed_methods, Collection):
+            warnings.warn(
+                "Using an empty collection for 'allowed_methods' option to "
+                "retry on any verb is deprecated and will skip retries for "
+                "all verbs in urllib3 v3.0. Instead use "
+                "Retry(..., allowed_methods=None).",
+                FutureWarning,
+                stacklevel=2,
+            )
         self.allowed_methods = allowed_methods
         self.backoff_factor = backoff_factor
+        self.backoff_max = backoff_max
+        self.retry_after_max = retry_after_max
         self.raise_on_redirect = raise_on_redirect
         self.raise_on_status = raise_on_status
-        self.history = history or tuple()
+        self.history = history or ()
         self.respect_retry_after_header = respect_retry_after_header
         self.remove_headers_on_redirect = frozenset(
-            [h.lower() for h in remove_headers_on_redirect]
+            h.lower() for h in remove_headers_on_redirect
         )
+        self.backoff_jitter = backoff_jitter
 
-    def new(self, **kw):
+    def new(self, **kw: typing.Any) -> Self:
         params = dict(
             total=self.total,
             connect=self.connect,
@@ -311,36 +283,29 @@ class Retry(object):
             redirect=self.redirect,
             status=self.status,
             other=self.other,
+            allowed_methods=self.allowed_methods,
             status_forcelist=self.status_forcelist,
             backoff_factor=self.backoff_factor,
+            backoff_max=self.backoff_max,
+            retry_after_max=self.retry_after_max,
             raise_on_redirect=self.raise_on_redirect,
             raise_on_status=self.raise_on_status,
             history=self.history,
             remove_headers_on_redirect=self.remove_headers_on_redirect,
             respect_retry_after_header=self.respect_retry_after_header,
+            backoff_jitter=self.backoff_jitter,
         )
 
-        # TODO: If already given in **kw we use what's given to us
-        # If not given we need to figure out what to pass. We decide
-        # based on whether our class has the 'method_whitelist' property
-        # and if so we pass the deprecated 'method_whitelist' otherwise
-        # we use 'allowed_methods'. Remove in v2.0
-        if "method_whitelist" not in kw and "allowed_methods" not in kw:
-            if "method_whitelist" in self.__dict__:
-                warnings.warn(
-                    "Using 'method_whitelist' with Retry is deprecated and "
-                    "will be removed in v2.0. Use 'allowed_methods' instead",
-                    DeprecationWarning,
-                )
-                params["method_whitelist"] = self.allowed_methods
-            else:
-                params["allowed_methods"] = self.allowed_methods
-
         params.update(kw)
-        return type(self)(**params)
+        return type(self)(**params)  # type: ignore[arg-type]
 
     @classmethod
-    def from_int(cls, retries, redirect=True, default=None):
+    def from_int(
+        cls,
+        retries: Retry | bool | int | None,
+        redirect: bool | int | None = True,
+        default: Retry | bool | int | None = None,
+    ) -> Retry:
         """Backwards-compatibility for the old retries format."""
         if retries is None:
             retries = default if default is not None else cls.DEFAULT
@@ -353,7 +318,7 @@ class Retry(object):
         log.debug("Converted retries value: %r -> %r", retries, new_retries)
         return new_retries
 
-    def get_backoff_time(self):
+    def get_backoff_time(self) -> float:
         """Formula for computing the current backoff
 
         :rtype: float
@@ -368,32 +333,32 @@ class Retry(object):
             return 0
 
         backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
-        return min(self.DEFAULT_BACKOFF_MAX, backoff_value)
+        if self.backoff_jitter != 0.0:
+            backoff_value += random.random() * self.backoff_jitter
+        return float(max(0, min(self.backoff_max, backoff_value)))
 
-    def parse_retry_after(self, retry_after):
+    def parse_retry_after(self, retry_after: str) -> float:
+        seconds: float
         # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4
         if re.match(r"^\s*[0-9]+\s*$", retry_after):
             seconds = int(retry_after)
         else:
             retry_date_tuple = email.utils.parsedate_tz(retry_after)
             if retry_date_tuple is None:
-                raise InvalidHeader("Invalid Retry-After header: %s" % retry_after)
-            if retry_date_tuple[9] is None:  # Python 2
-                # Assume UTC if no timezone was specified
-                # On Python2.7, parsedate_tz returns None for a timezone offset
-                # instead of 0 if no timezone is given, where mktime_tz treats
-                # a None timezone offset as local time.
-                retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:]
+                raise InvalidHeader(f"Invalid Retry-After header: {retry_after}")
 
             retry_date = email.utils.mktime_tz(retry_date_tuple)
             seconds = retry_date - time.time()
 
-        if seconds < 0:
-            seconds = 0
+        seconds = max(seconds, 0)
+
+        # Check the seconds do not exceed the specified maximum
+        if seconds > self.retry_after_max:
+            seconds = self.retry_after_max
 
         return seconds
 
-    def get_retry_after(self, response):
+    def get_retry_after(self, response: BaseHTTPResponse) -> float | None:
         """Get the value of Retry-After in seconds."""
 
         retry_after = response.headers.get("Retry-After")
@@ -403,7 +368,7 @@ class Retry(object):
 
         return self.parse_retry_after(retry_after)
 
-    def sleep_for_retry(self, response=None):
+    def sleep_for_retry(self, response: BaseHTTPResponse) -> bool:
         retry_after = self.get_retry_after(response)
         if retry_after:
             time.sleep(retry_after)
@@ -411,13 +376,13 @@ class Retry(object):
 
         return False
 
-    def _sleep_backoff(self):
+    def _sleep_backoff(self) -> None:
         backoff = self.get_backoff_time()
         if backoff <= 0:
             return
         time.sleep(backoff)
 
-    def sleep(self, response=None):
+    def sleep(self, response: BaseHTTPResponse | None = None) -> None:
         """Sleep between retry attempts.
 
         This method will respect a server's ``Retry-After`` response header
@@ -433,7 +398,7 @@ class Retry(object):
 
         self._sleep_backoff()
 
-    def _is_connection_error(self, err):
+    def _is_connection_error(self, err: Exception) -> bool:
         """Errors when we're fairly sure that the server did not receive the
         request, so it should be safe to retry.
         """
@@ -441,33 +406,23 @@ class Retry(object):
             err = err.original_error
         return isinstance(err, ConnectTimeoutError)
 
-    def _is_read_error(self, err):
+    def _is_read_error(self, err: Exception) -> bool:
         """Errors that occur after the request has been started, so we should
         assume that the server began processing it.
         """
         return isinstance(err, (ReadTimeoutError, ProtocolError))
 
-    def _is_method_retryable(self, method):
+    def _is_method_retryable(self, method: str) -> bool:
         """Checks if a given HTTP method should be retried upon, depending if
         it is included in the allowed_methods
         """
-        # TODO: For now favor if the Retry implementation sets its own method_whitelist
-        # property outside of our constructor to avoid breaking custom implementations.
-        if "method_whitelist" in self.__dict__:
-            warnings.warn(
-                "Using 'method_whitelist' with Retry is deprecated and "
-                "will be removed in v2.0. Use 'allowed_methods' instead",
-                DeprecationWarning,
-            )
-            allowed_methods = self.method_whitelist
-        else:
-            allowed_methods = self.allowed_methods
-
-        if allowed_methods and method.upper() not in allowed_methods:
+        if self.allowed_methods and method.upper() not in self.allowed_methods:
             return False
         return True
 
-    def is_retry(self, method, status_code, has_retry_after=False):
+    def is_retry(
+        self, method: str, status_code: int, has_retry_after: bool = False
+    ) -> bool:
         """Is this method/status code retryable? (Based on allowlists and control
         variables such as the number of total retries to allow, whether to
         respect the Retry-After header, whether this header is present, and
@@ -480,24 +435,27 @@ class Retry(object):
         if self.status_forcelist and status_code in self.status_forcelist:
             return True
 
-        return (
+        return bool(
             self.total
             and self.respect_retry_after_header
             and has_retry_after
             and (status_code in self.RETRY_AFTER_STATUS_CODES)
         )
 
-    def is_exhausted(self):
+    def is_exhausted(self) -> bool:
         """Are we out of retries?"""
-        retry_counts = (
-            self.total,
-            self.connect,
-            self.read,
-            self.redirect,
-            self.status,
-            self.other,
-        )
-        retry_counts = list(filter(None, retry_counts))
+        retry_counts = [
+            x
+            for x in (
+                self.total,
+                self.connect,
+                self.read,
+                self.redirect,
+                self.status,
+                self.other,
+            )
+            if x
+        ]
         if not retry_counts:
             return False
 
@@ -505,18 +463,18 @@ class Retry(object):
 
     def increment(
         self,
-        method=None,
-        url=None,
-        response=None,
-        error=None,
-        _pool=None,
-        _stacktrace=None,
-    ):
+        method: str | None = None,
+        url: str | None = None,
+        response: BaseHTTPResponse | None = None,
+        error: Exception | None = None,
+        _pool: ConnectionPool | None = None,
+        _stacktrace: TracebackType | None = None,
+    ) -> Self:
         """Return a new Retry object with incremented retry counters.
 
         :param response: A response object, or None, if the server did not
             return a response.
-        :type response: :class:`~urllib3.response.HTTPResponse`
+        :type response: :class:`~urllib3.response.BaseHTTPResponse`
         :param Exception error: An error encountered during the request, or
             None if the response was received successfully.
 
@@ -524,7 +482,7 @@ class Retry(object):
         """
         if self.total is False and error:
             # Disabled, indicate to re-raise the error.
-            raise six.reraise(type(error), error, _stacktrace)
+            raise reraise(type(error), error, _stacktrace)
 
         total = self.total
         if total is not None:
@@ -542,14 +500,14 @@ class Retry(object):
         if error and self._is_connection_error(error):
             # Connect retry?
             if connect is False:
-                raise six.reraise(type(error), error, _stacktrace)
+                raise reraise(type(error), error, _stacktrace)
             elif connect is not None:
                 connect -= 1
 
         elif error and self._is_read_error(error):
             # Read retry?
-            if read is False or not self._is_method_retryable(method):
-                raise six.reraise(type(error), error, _stacktrace)
+            if read is False or method is None or not self._is_method_retryable(method):
+                raise reraise(type(error), error, _stacktrace)
             elif read is not None:
                 read -= 1
 
@@ -563,7 +521,9 @@ class Retry(object):
             if redirect is not None:
                 redirect -= 1
             cause = "too many redirects"
-            redirect_location = response.get_redirect_location()
+            response_redirect_location = response.get_redirect_location()
+            if response_redirect_location:
+                redirect_location = response_redirect_location
             status = response.status
 
         else:
@@ -591,31 +551,18 @@ class Retry(object):
         )
 
         if new_retry.is_exhausted():
-            raise MaxRetryError(_pool, url, error or ResponseError(cause))
+            reason = error or ResponseError(cause)
+            raise MaxRetryError(_pool, url, reason) from reason  # type: ignore[arg-type]
 
         log.debug("Incremented Retry for (url='%s'): %r", url, new_retry)
 
         return new_retry
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return (
-            "{cls.__name__}(total={self.total}, connect={self.connect}, "
-            "read={self.read}, redirect={self.redirect}, status={self.status})"
-        ).format(cls=type(self), self=self)
-
-    def __getattr__(self, item):
-        if item == "method_whitelist":
-            # TODO: Remove this deprecated alias in v2.0
-            warnings.warn(
-                "Using 'method_whitelist' with Retry is deprecated and "
-                "will be removed in v2.0. Use 'allowed_methods' instead",
-                DeprecationWarning,
-            )
-            return self.allowed_methods
-        try:
-            return getattr(super(Retry, self), item)
-        except AttributeError:
-            return getattr(Retry, item)
+            f"{type(self).__name__}(total={self.total}, connect={self.connect}, "
+            f"read={self.read}, redirect={self.redirect}, status={self.status})"
+        )
 
 
 # For backwards compatibility (equivalent to pre-v1.9):
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_.py
index 0a6a0e0..f6445a4 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_.py
@@ -1,28 +1,26 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import hashlib
 import hmac
 import os
+import socket
 import sys
+import typing
 import warnings
-from binascii import hexlify, unhexlify
+from binascii import Error as BinasciiError
+from binascii import unhexlify
 
-from ..exceptions import (
-    InsecurePlatformWarning,
-    ProxySchemeUnsupported,
-    SNIMissingWarning,
-    SSLError,
-)
-from ..packages import six
-from .url import BRACELESS_IPV6_ADDRZ_RE, IPV4_RE
+from ..exceptions import ProxySchemeUnsupported, SSLError
+from .url import _BRACELESS_IPV6_ADDRZ_RE, _IPV4_RE
 
 SSLContext = None
 SSLTransport = None
-HAS_SNI = False
+HAS_NEVER_CHECK_COMMON_NAME = False
 IS_PYOPENSSL = False
-IS_SECURETRANSPORT = False
 ALPN_PROTOCOLS = ["http/1.1"]
 
+_TYPE_VERSION_INFO = tuple[int, int, int, str, int]
+
 # Maps the length of a digest to a possible hash function producing this digest
 HASHFUNC_MAP = {
     length: getattr(hashlib, algorithm, None)
@@ -30,159 +28,84 @@ HASHFUNC_MAP = {
 }
 
 
-def _const_compare_digest_backport(a, b):
-    """
-    Compare two digests of equal length in constant time.
+def _is_has_never_check_common_name_reliable(
+    openssl_version: str,
+) -> bool:
+    # As of May 2023, all released versions of LibreSSL fail to reject certificates with
+    # only common names, see https://github.com/urllib3/urllib3/pull/3024
+    is_openssl = openssl_version.startswith("OpenSSL ")
 
-    The digests must be of type str/bytes.
-    Returns True if the digests match, and False otherwise.
-    """
-    result = abs(len(a) - len(b))
-    for left, right in zip(bytearray(a), bytearray(b)):
-        result |= left ^ right
-    return result == 0
+    return is_openssl
 
 
-_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)
+if typing.TYPE_CHECKING:
+    from ssl import VerifyMode
+    from typing import TypedDict
 
-try:  # Test for SSL features
+    from .ssltransport import SSLTransport as SSLTransportType
+
+    class _TYPE_PEER_CERT_RET_DICT(TypedDict, total=False):
+        subjectAltName: tuple[tuple[str, str], ...]
+        subject: tuple[tuple[tuple[str, str], ...], ...]
+        serialNumber: str
+
+
+# Mapping from 'ssl.PROTOCOL_TLSX' to 'TLSVersion.X'
+_SSL_VERSION_TO_TLS_VERSION: dict[int, int] = {}
+
+try:  # Do we have ssl at all?
     import ssl
-    from ssl import CERT_REQUIRED, wrap_socket
-except ImportError:
-    pass
-
-try:
-    from ssl import HAS_SNI  # Has SNI?
-except ImportError:
-    pass
-
-try:
-    from .ssltransport import SSLTransport
-except ImportError:
-    pass
-
-
-try:  # Platform-specific: Python 3.6
-    from ssl import PROTOCOL_TLS
+    from ssl import (  # type: ignore[assignment]
+        CERT_REQUIRED,
+        HAS_NEVER_CHECK_COMMON_NAME,
+        OP_NO_COMPRESSION,
+        OP_NO_TICKET,
+        OPENSSL_VERSION,
+        PROTOCOL_TLS,
+        PROTOCOL_TLS_CLIENT,
+        VERIFY_X509_PARTIAL_CHAIN,
+        VERIFY_X509_STRICT,
+        OP_NO_SSLv2,
+        OP_NO_SSLv3,
+        SSLContext,
+        TLSVersion,
+    )
 
     PROTOCOL_SSLv23 = PROTOCOL_TLS
-except ImportError:
-    try:
-        from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS
 
-        PROTOCOL_SSLv23 = PROTOCOL_TLS
-    except ImportError:
-        PROTOCOL_SSLv23 = PROTOCOL_TLS = 2
+    # Setting SSLContext.hostname_checks_common_name = False didn't work with
+    # LibreSSL, check details in the used function.
+    if HAS_NEVER_CHECK_COMMON_NAME and not _is_has_never_check_common_name_reliable(
+        OPENSSL_VERSION,
+    ):  # Defensive:
+        HAS_NEVER_CHECK_COMMON_NAME = False
 
-try:
-    from ssl import PROTOCOL_TLS_CLIENT
-except ImportError:
-    PROTOCOL_TLS_CLIENT = PROTOCOL_TLS
-
-
-try:
-    from ssl import OP_NO_COMPRESSION, OP_NO_SSLv2, OP_NO_SSLv3
-except ImportError:
-    OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000
-    OP_NO_COMPRESSION = 0x20000
-
-
-try:  # OP_NO_TICKET was added in Python 3.6
-    from ssl import OP_NO_TICKET
-except ImportError:
-    OP_NO_TICKET = 0x4000
-
-
-# A secure default.
-# Sources for more information on TLS ciphers:
-#
-# - https://wiki.mozilla.org/Security/Server_Side_TLS
-# - https://www.ssllabs.com/projects/best-practices/index.html
-# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
-#
-# The general intent is:
-# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE),
-# - prefer ECDHE over DHE for better performance,
-# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and
-#   security,
-# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common,
-# - disable NULL authentication, MD5 MACs, DSS, and other
-#   insecure ciphers for security reasons.
-# - NOTE: TLS 1.3 cipher suites are managed through a different interface
-#   not exposed by CPython (yet!) and are enabled by default if they're available.
-DEFAULT_CIPHERS = ":".join(
-    [
-        "ECDHE+AESGCM",
-        "ECDHE+CHACHA20",
-        "DHE+AESGCM",
-        "DHE+CHACHA20",
-        "ECDH+AESGCM",
-        "DH+AESGCM",
-        "ECDH+AES",
-        "DH+AES",
-        "RSA+AESGCM",
-        "RSA+AES",
-        "!aNULL",
-        "!eNULL",
-        "!MD5",
-        "!DSS",
-    ]
-)
-
-try:
-    from ssl import SSLContext  # Modern SSL?
-except ImportError:
-
-    class SSLContext(object):  # Platform-specific: Python 2
-        def __init__(self, protocol_version):
-            self.protocol = protocol_version
-            # Use default values from a real SSLContext
-            self.check_hostname = False
-            self.verify_mode = ssl.CERT_NONE
-            self.ca_certs = None
-            self.options = 0
-            self.certfile = None
-            self.keyfile = None
-            self.ciphers = None
-
-        def load_cert_chain(self, certfile, keyfile):
-            self.certfile = certfile
-            self.keyfile = keyfile
-
-        def load_verify_locations(self, cafile=None, capath=None, cadata=None):
-            self.ca_certs = cafile
-
-            if capath is not None:
-                raise SSLError("CA directories not supported in older Pythons")
-
-            if cadata is not None:
-                raise SSLError("CA data not supported in older Pythons")
-
-        def set_ciphers(self, cipher_suite):
-            self.ciphers = cipher_suite
-
-        def wrap_socket(self, socket, server_hostname=None, server_side=False):
-            warnings.warn(
-                "A true SSLContext object is not available. This prevents "
-                "urllib3 from configuring SSL appropriately and may cause "
-                "certain SSL connections to fail. You can upgrade to a newer "
-                "version of Python to solve this. For more information, see "
-                "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                "#ssl-warnings",
-                InsecurePlatformWarning,
+    # Need to be careful here in case old TLS versions get
+    # removed in future 'ssl' module implementations.
+    for attr in ("TLSv1", "TLSv1_1", "TLSv1_2"):
+        try:
+            _SSL_VERSION_TO_TLS_VERSION[getattr(ssl, f"PROTOCOL_{attr}")] = getattr(
+                TLSVersion, attr
             )
-            kwargs = {
-                "keyfile": self.keyfile,
-                "certfile": self.certfile,
-                "ca_certs": self.ca_certs,
-                "cert_reqs": self.verify_mode,
-                "ssl_version": self.protocol,
-                "server_side": server_side,
-            }
-            return wrap_socket(socket, ciphers=self.ciphers, **kwargs)
+        except AttributeError:  # Defensive:
+            continue
+
+    from .ssltransport import SSLTransport  # type: ignore[assignment]
+except ImportError:
+    OP_NO_COMPRESSION = 0x20000  # type: ignore[assignment,misc]
+    OP_NO_TICKET = 0x4000  # type: ignore[assignment,misc]
+    OP_NO_SSLv2 = 0x1000000  # type: ignore[assignment,misc]
+    OP_NO_SSLv3 = 0x2000000  # type: ignore[assignment,misc]
+    PROTOCOL_SSLv23 = PROTOCOL_TLS = 2  # type: ignore[assignment,misc]
+    PROTOCOL_TLS_CLIENT = 16  # type: ignore[assignment,misc]
+    VERIFY_X509_PARTIAL_CHAIN = 0x80000  # type: ignore[assignment,misc]
+    VERIFY_X509_STRICT = 0x20  # type: ignore[assignment,misc]
 
 
-def assert_fingerprint(cert, fingerprint):
+_TYPE_PEER_CERT_RET = typing.Union["_TYPE_PEER_CERT_RET_DICT", bytes, None]
+
+
+def assert_fingerprint(cert: bytes | None, fingerprint: str) -> None:
     """
     Checks if given fingerprint matches the supplied certificate.
 
@@ -192,32 +115,34 @@ def assert_fingerprint(cert, fingerprint):
         Fingerprint as string of hexdigits, can be interspersed by colons.
     """
 
+    if cert is None:
+        raise SSLError("No certificate for the peer.")
+
     fingerprint = fingerprint.replace(":", "").lower()
     digest_length = len(fingerprint)
     if digest_length not in HASHFUNC_MAP:
-        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))
+        raise SSLError(f"Fingerprint of invalid length: {fingerprint}")
     hashfunc = HASHFUNC_MAP.get(digest_length)
     if hashfunc is None:
         raise SSLError(
-            "Hash function implementation unavailable for fingerprint length: {0}".format(
-                digest_length
-            )
+            f"Hash function implementation unavailable for fingerprint length: {digest_length}"
         )
 
     # We need encode() here for py32; works on py2 and p33.
-    fingerprint_bytes = unhexlify(fingerprint.encode())
+    try:
+        fingerprint_bytes = unhexlify(fingerprint.encode())
+    except BinasciiError as e:
+        raise SSLError(e) from e
 
     cert_digest = hashfunc(cert).digest()
 
-    if not _const_compare_digest(cert_digest, fingerprint_bytes):
+    if not hmac.compare_digest(cert_digest, fingerprint_bytes):
         raise SSLError(
-            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
-                fingerprint, hexlify(cert_digest)
-            )
+            f'Fingerprints did not match. Expected "{fingerprint}", got "{cert_digest.hex()}"'
         )
 
 
-def resolve_cert_reqs(candidate):
+def resolve_cert_reqs(candidate: None | int | str) -> VerifyMode:
     """
     Resolves the argument to a numeric constant, which can be passed to
     the wrap_socket function/method from the ssl module.
@@ -235,12 +160,12 @@ def resolve_cert_reqs(candidate):
         res = getattr(ssl, candidate, None)
         if res is None:
             res = getattr(ssl, "CERT_" + candidate)
-        return res
+        return res  # type: ignore[no-any-return]
 
-    return candidate
+    return candidate  # type: ignore[return-value]
 
 
-def resolve_ssl_version(candidate):
+def resolve_ssl_version(candidate: None | int | str) -> int:
     """
     like resolve_cert_reqs
     """
@@ -251,35 +176,34 @@ def resolve_ssl_version(candidate):
         res = getattr(ssl, candidate, None)
         if res is None:
             res = getattr(ssl, "PROTOCOL_" + candidate)
-        return res
+        return typing.cast(int, res)
 
     return candidate
 
 
 def create_urllib3_context(
-    ssl_version=None, cert_reqs=None, options=None, ciphers=None
-):
-    """All arguments have the same meaning as ``ssl_wrap_socket``.
-
-    By default, this function does a lot of the same work that
-    ``ssl.create_default_context`` does on Python 3.4+. It:
-
-    - Disables SSLv2, SSLv3, and compression
-    - Sets a restricted set of server ciphers
-
-    If you wish to enable SSLv3, you can do::
-
-        from pip._vendor.urllib3.util import ssl_
-        context = ssl_.create_urllib3_context()
-        context.options &= ~ssl_.OP_NO_SSLv3
-
-    You can do the same to enable compression (substituting ``COMPRESSION``
-    for ``SSLv3`` in the last line above).
+    ssl_version: int | None = None,
+    cert_reqs: int | None = None,
+    options: int | None = None,
+    ciphers: str | None = None,
+    ssl_minimum_version: int | None = None,
+    ssl_maximum_version: int | None = None,
+    verify_flags: int | None = None,
+) -> ssl.SSLContext:
+    """Creates and configures an :class:`ssl.SSLContext` instance for use with urllib3.
 
     :param ssl_version:
         The desired protocol version to use. This will default to
         PROTOCOL_SSLv23 which will negotiate the highest protocol that both
         the server and your installation of OpenSSL support.
+
+        This parameter is deprecated instead use 'ssl_minimum_version'.
+    :param ssl_minimum_version:
+        The minimum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value.
+    :param ssl_maximum_version:
+        The maximum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value.
+        Not recommended to set to anything other than 'ssl.TLSVersion.MAXIMUM_SUPPORTED' which is the
+        default value.
     :param cert_reqs:
         Whether to require the certificate verification. This defaults to
         ``ssl.CERT_REQUIRED``.
@@ -287,18 +211,61 @@ def create_urllib3_context(
         Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
         ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``.
     :param ciphers:
-        Which cipher suites to allow the server to select.
+        Which cipher suites to allow the server to select. Defaults to either system configured
+        ciphers if OpenSSL 1.1.1+, otherwise uses a secure default set of ciphers.
+    :param verify_flags:
+        The flags for certificate verification operations. These default to
+        ``ssl.VERIFY_X509_PARTIAL_CHAIN`` and ``ssl.VERIFY_X509_STRICT`` for Python 3.13+.
     :returns:
         Constructed SSLContext object with specified options
     :rtype: SSLContext
     """
-    # PROTOCOL_TLS is deprecated in Python 3.10
-    if not ssl_version or ssl_version == PROTOCOL_TLS:
-        ssl_version = PROTOCOL_TLS_CLIENT
+    if SSLContext is None:
+        raise TypeError("Can't create an SSLContext object without an ssl module")
 
-    context = SSLContext(ssl_version)
+    # This means 'ssl_version' was specified as an exact value.
+    if ssl_version not in (None, PROTOCOL_TLS, PROTOCOL_TLS_CLIENT):
+        # Disallow setting 'ssl_version' and 'ssl_minimum|maximum_version'
+        # to avoid conflicts.
+        if ssl_minimum_version is not None or ssl_maximum_version is not None:
+            raise ValueError(
+                "Can't specify both 'ssl_version' and either "
+                "'ssl_minimum_version' or 'ssl_maximum_version'"
+            )
 
-    context.set_ciphers(ciphers or DEFAULT_CIPHERS)
+        # 'ssl_version' is deprecated and will be removed in the future.
+        else:
+            # Use 'ssl_minimum_version' and 'ssl_maximum_version' instead.
+            ssl_minimum_version = _SSL_VERSION_TO_TLS_VERSION.get(
+                ssl_version, TLSVersion.MINIMUM_SUPPORTED
+            )
+            ssl_maximum_version = _SSL_VERSION_TO_TLS_VERSION.get(
+                ssl_version, TLSVersion.MAXIMUM_SUPPORTED
+            )
+
+            # This warning message is pushing users to use 'ssl_minimum_version'
+            # instead of both min/max. Best practice is to only set the minimum version and
+            # keep the maximum version to be it's default value: 'TLSVersion.MAXIMUM_SUPPORTED'
+            warnings.warn(
+                "'ssl_version' option is deprecated and will be "
+                "removed in urllib3 v3.0. Instead use 'ssl_minimum_version'",
+                category=FutureWarning,
+                stacklevel=2,
+            )
+
+    context = SSLContext(PROTOCOL_TLS_CLIENT)
+    if ssl_minimum_version is not None:
+        context.minimum_version = ssl_minimum_version
+    else:  # pyOpenSSL defaults to 'MINIMUM_SUPPORTED' so explicitly set TLSv1.2 here
+        context.minimum_version = TLSVersion.TLSv1_2
+
+    if ssl_maximum_version is not None:
+        context.maximum_version = ssl_maximum_version
+
+    # Unless we're given ciphers defer to either system ciphers in
+    # the case of OpenSSL 1.1.1+ or use our own secure default ciphers.
+    if ciphers:
+        context.set_ciphers(ciphers)
 
     # Setting the default here, as we may have no ssl module on import
     cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs
@@ -320,65 +287,103 @@ def create_urllib3_context(
 
     context.options |= options
 
+    if verify_flags is None:
+        verify_flags = 0
+        # In Python 3.13+ ssl.create_default_context() sets VERIFY_X509_PARTIAL_CHAIN
+        # and VERIFY_X509_STRICT so we do the same
+        if sys.version_info >= (3, 13):
+            verify_flags |= VERIFY_X509_PARTIAL_CHAIN
+            verify_flags |= VERIFY_X509_STRICT
+
+    context.verify_flags |= verify_flags
+
     # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is
     # necessary for conditional client cert authentication with TLS 1.3.
-    # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older
-    # versions of Python.  We only enable on Python 3.7.4+ or if certificate
-    # verification is enabled to work around Python issue #37428
-    # See: https://bugs.python.org/issue37428
-    if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr(
-        context, "post_handshake_auth", None
-    ) is not None:
+    # The attribute is None for OpenSSL <= 1.1.0 or does not exist when using
+    # an SSLContext created by pyOpenSSL.
+    if getattr(context, "post_handshake_auth", None) is not None:
         context.post_handshake_auth = True
 
-    def disable_check_hostname():
-        if (
-            getattr(context, "check_hostname", None) is not None
-        ):  # Platform-specific: Python 3.2
-            # We do our own verification, including fingerprints and alternative
-            # hostnames. So disable it here
-            context.check_hostname = False
-
     # The order of the below lines setting verify_mode and check_hostname
     # matter due to safe-guards SSLContext has to prevent an SSLContext with
-    # check_hostname=True, verify_mode=NONE/OPTIONAL. This is made even more
-    # complex because we don't know whether PROTOCOL_TLS_CLIENT will be used
-    # or not so we don't know the initial state of the freshly created SSLContext.
-    if cert_reqs == ssl.CERT_REQUIRED:
+    # check_hostname=True, verify_mode=NONE/OPTIONAL.
+    # We always set 'check_hostname=False' for pyOpenSSL so we rely on our own
+    # 'ssl.match_hostname()' implementation.
+    if cert_reqs == ssl.CERT_REQUIRED and not IS_PYOPENSSL:
         context.verify_mode = cert_reqs
-        disable_check_hostname()
+        context.check_hostname = True
     else:
-        disable_check_hostname()
+        context.check_hostname = False
         context.verify_mode = cert_reqs
 
-    # Enable logging of TLS session keys via defacto standard environment variable
-    # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values.
-    if hasattr(context, "keylog_filename"):
-        sslkeylogfile = os.environ.get("SSLKEYLOGFILE")
-        if sslkeylogfile:
-            context.keylog_filename = sslkeylogfile
+    context.hostname_checks_common_name = False
+
+    if "SSLKEYLOGFILE" in os.environ:
+        sslkeylogfile = os.path.expandvars(os.environ.get("SSLKEYLOGFILE"))
+    else:
+        sslkeylogfile = None
+    if sslkeylogfile:
+        context.keylog_filename = sslkeylogfile
 
     return context
 
 
+@typing.overload
 def ssl_wrap_socket(
-    sock,
-    keyfile=None,
-    certfile=None,
-    cert_reqs=None,
-    ca_certs=None,
-    server_hostname=None,
-    ssl_version=None,
-    ciphers=None,
-    ssl_context=None,
-    ca_cert_dir=None,
-    key_password=None,
-    ca_cert_data=None,
-    tls_in_tls=False,
-):
+    sock: socket.socket,
+    keyfile: str | None = ...,
+    certfile: str | None = ...,
+    cert_reqs: int | None = ...,
+    ca_certs: str | None = ...,
+    server_hostname: str | None = ...,
+    ssl_version: int | None = ...,
+    ciphers: str | None = ...,
+    ssl_context: ssl.SSLContext | None = ...,
+    ca_cert_dir: str | None = ...,
+    key_password: str | None = ...,
+    ca_cert_data: None | str | bytes = ...,
+    tls_in_tls: typing.Literal[False] = ...,
+) -> ssl.SSLSocket: ...
+
+
+@typing.overload
+def ssl_wrap_socket(
+    sock: socket.socket,
+    keyfile: str | None = ...,
+    certfile: str | None = ...,
+    cert_reqs: int | None = ...,
+    ca_certs: str | None = ...,
+    server_hostname: str | None = ...,
+    ssl_version: int | None = ...,
+    ciphers: str | None = ...,
+    ssl_context: ssl.SSLContext | None = ...,
+    ca_cert_dir: str | None = ...,
+    key_password: str | None = ...,
+    ca_cert_data: None | str | bytes = ...,
+    tls_in_tls: bool = ...,
+) -> ssl.SSLSocket | SSLTransportType: ...
+
+
+def ssl_wrap_socket(
+    sock: socket.socket,
+    keyfile: str | None = None,
+    certfile: str | None = None,
+    cert_reqs: int | None = None,
+    ca_certs: str | None = None,
+    server_hostname: str | None = None,
+    ssl_version: int | None = None,
+    ciphers: str | None = None,
+    ssl_context: ssl.SSLContext | None = None,
+    ca_cert_dir: str | None = None,
+    key_password: str | None = None,
+    ca_cert_data: None | str | bytes = None,
+    tls_in_tls: bool = False,
+) -> ssl.SSLSocket | SSLTransportType:
     """
-    All arguments except for server_hostname, ssl_context, and ca_cert_dir have
-    the same meaning as they do when using :func:`ssl.wrap_socket`.
+    All arguments except for server_hostname, ssl_context, tls_in_tls, ca_cert_data and
+    ca_cert_dir have the same meaning as they do when using
+    :func:`ssl.create_default_context`, :meth:`ssl.SSLContext.load_cert_chain`,
+    :meth:`ssl.SSLContext.set_ciphers` and :meth:`ssl.SSLContext.wrap_socket`.
 
     :param server_hostname:
         When SNI is supported, the expected hostname of the certificate
@@ -401,19 +406,18 @@ def ssl_wrap_socket(
     """
     context = ssl_context
     if context is None:
-        # Note: This branch of code and all the variables in it are no longer
-        # used by urllib3 itself. We should consider deprecating and removing
-        # this code.
+        # Note: This branch of code and all the variables in it are only used in tests.
+        # We should consider deprecating and removing this code.
         context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers)
 
     if ca_certs or ca_cert_dir or ca_cert_data:
         try:
             context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data)
-        except (IOError, OSError) as e:
-            raise SSLError(e)
+        except OSError as e:
+            raise SSLError(e) from e
 
     elif ssl_context is None and hasattr(context, "load_default_certs"):
-        # try to load OS default certs; works well on Windows (require Python3.4+)
+        # try to load OS default certs; works well on Windows.
         context.load_default_certs()
 
     # Attempt to detect if we get the goofy behavior of the
@@ -428,57 +432,28 @@ def ssl_wrap_socket(
         else:
             context.load_cert_chain(certfile, keyfile, key_password)
 
-    try:
-        if hasattr(context, "set_alpn_protocols"):
-            context.set_alpn_protocols(ALPN_PROTOCOLS)
-    except NotImplementedError:  # Defensive: in CI, we always have set_alpn_protocols
-        pass
+    context.set_alpn_protocols(ALPN_PROTOCOLS)
 
-    # If we detect server_hostname is an IP address then the SNI
-    # extension should not be used according to RFC3546 Section 3.1
-    use_sni_hostname = server_hostname and not is_ipaddress(server_hostname)
-    # SecureTransport uses server_hostname in certificate verification.
-    send_sni = (use_sni_hostname and HAS_SNI) or (
-        IS_SECURETRANSPORT and server_hostname
-    )
-    # Do not warn the user if server_hostname is an invalid SNI hostname.
-    if not HAS_SNI and use_sni_hostname:
-        warnings.warn(
-            "An HTTPS request has been made, but the SNI (Server Name "
-            "Indication) extension to TLS is not available on this platform. "
-            "This may cause the server to present an incorrect TLS "
-            "certificate, which can cause validation failures. You can upgrade to "
-            "a newer version of Python to solve this. For more information, see "
-            "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-            "#ssl-warnings",
-            SNIMissingWarning,
-        )
-
-    if send_sni:
-        ssl_sock = _ssl_wrap_socket_impl(
-            sock, context, tls_in_tls, server_hostname=server_hostname
-        )
-    else:
-        ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls)
+    ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls, server_hostname)
     return ssl_sock
 
 
-def is_ipaddress(hostname):
+def is_ipaddress(hostname: str | bytes) -> bool:
     """Detects whether the hostname given is an IPv4 or IPv6 address.
     Also detects IPv6 addresses with Zone IDs.
 
     :param str hostname: Hostname to examine.
     :return: True if the hostname is an IP address, False otherwise.
     """
-    if not six.PY2 and isinstance(hostname, bytes):
+    if isinstance(hostname, bytes):
         # IDN A-label bytes are ASCII compatible.
         hostname = hostname.decode("ascii")
-    return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname))
+    return bool(_IPV4_RE.match(hostname) or _BRACELESS_IPV6_ADDRZ_RE.match(hostname))
 
 
-def _is_key_file_encrypted(key_file):
+def _is_key_file_encrypted(key_file: str) -> bool:
     """Detects if a key file is encrypted or not."""
-    with open(key_file, "r") as f:
+    with open(key_file) as f:
         for line in f:
             # Look for Proc-Type: 4,ENCRYPTED
             if "ENCRYPTED" in line:
@@ -487,7 +462,12 @@ def _is_key_file_encrypted(key_file):
     return False
 
 
-def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None):
+def _ssl_wrap_socket_impl(
+    sock: socket.socket,
+    ssl_context: ssl.SSLContext,
+    tls_in_tls: bool,
+    server_hostname: str | None = None,
+) -> ssl.SSLSocket | SSLTransportType:
     if tls_in_tls:
         if not SSLTransport:
             # Import error, ssl is not available.
@@ -498,7 +478,4 @@ def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None):
         SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context)
         return SSLTransport(sock, ssl_context, server_hostname)
 
-    if server_hostname:
-        return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
-    else:
-        return ssl_context.wrap_socket(sock)
+    return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py
index 1dd950c..94994f2 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py
@@ -1,19 +1,18 @@
-"""The match_hostname() function from Python 3.3.3, essential when using SSL."""
+"""The match_hostname() function from Python 3.5, essential when using SSL."""
 
 # Note: This file is under the PSF license as the code comes from the python
 # stdlib.   http://docs.python.org/3/license.html
+# It is modified to remove commonName support.
 
+from __future__ import annotations
+
+import ipaddress
 import re
-import sys
+import typing
+from ipaddress import IPv4Address, IPv6Address
 
-# ipaddress has been backported to 2.6+ in pypi.  If it is installed on the
-# system, use it to handle IPAddress ServerAltnames (this was added in
-# python-3.5) otherwise only do DNS matching.  This allows
-# util.ssl_match_hostname to continue to be used in Python 2.7.
-try:
-    import ipaddress
-except ImportError:
-    ipaddress = None
+if typing.TYPE_CHECKING:
+    from .ssl_ import _TYPE_PEER_CERT_RET_DICT
 
 __version__ = "3.5.0.1"
 
@@ -22,7 +21,9 @@ class CertificateError(ValueError):
     pass
 
 
-def _dnsname_match(dn, hostname, max_wildcards=1):
+def _dnsname_match(
+    dn: typing.Any, hostname: str, max_wildcards: int = 1
+) -> typing.Match[str] | None | bool:
     """Matching according to RFC 6125, section 6.4.3
 
     http://tools.ietf.org/html/rfc6125#section-6.4.3
@@ -49,7 +50,7 @@ def _dnsname_match(dn, hostname, max_wildcards=1):
 
     # speed up common case w/o wildcards
     if not wildcards:
-        return dn.lower() == hostname.lower()
+        return bool(dn.lower() == hostname.lower())
 
     # RFC 6125, section 6.4.3, subitem 1.
     # The client SHOULD NOT attempt to match a presented identifier in which
@@ -76,26 +77,26 @@ def _dnsname_match(dn, hostname, max_wildcards=1):
     return pat.match(hostname)
 
 
-def _to_unicode(obj):
-    if isinstance(obj, str) and sys.version_info < (3,):
-        # ignored flake8 # F821 to support python 2.7 function
-        obj = unicode(obj, encoding="ascii", errors="strict")  # noqa: F821
-    return obj
-
-
-def _ipaddress_match(ipname, host_ip):
+def _ipaddress_match(ipname: str, host_ip: IPv4Address | IPv6Address) -> bool:
     """Exact matching of IP addresses.
 
-    RFC 6125 explicitly doesn't define an algorithm for this
-    (section 1.7.2 - "Out of Scope").
+    RFC 9110 section 4.3.5: "A reference identity of IP-ID contains the decoded
+    bytes of the IP address. An IP version 4 address is 4 octets, and an IP
+    version 6 address is 16 octets. [...] A reference identity of type IP-ID
+    matches if the address is identical to an iPAddress value of the
+    subjectAltName extension of the certificate."
     """
     # OpenSSL may add a trailing newline to a subjectAltName's IP address
     # Divergence from upstream: ipaddress can't handle byte str
-    ip = ipaddress.ip_address(_to_unicode(ipname).rstrip())
-    return ip == host_ip
+    ip = ipaddress.ip_address(ipname.rstrip())
+    return bool(ip.packed == host_ip.packed)
 
 
-def match_hostname(cert, hostname):
+def match_hostname(
+    cert: _TYPE_PEER_CERT_RET_DICT | None,
+    hostname: str,
+    hostname_checks_common_name: bool = False,
+) -> None:
     """Verify that *cert* (in decoded format as returned by
     SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
     rules are followed, but IP addresses are not accepted for *hostname*.
@@ -109,23 +110,16 @@ def match_hostname(cert, hostname):
             "SSL socket or SSL context with either "
             "CERT_OPTIONAL or CERT_REQUIRED"
         )
+
     try:
-        # Divergence from upstream: ipaddress can't handle byte str
-        host_ip = ipaddress.ip_address(_to_unicode(hostname))
-    except (UnicodeError, ValueError):
-        # ValueError: Not an IP address (common case)
-        # UnicodeError: Divergence from upstream: Have to deal with ipaddress not taking
-        # byte strings.  addresses should be all ascii, so we consider it not
-        # an ipaddress in this case
+        host_ip = ipaddress.ip_address(hostname)
+    except ValueError:
+        # Not an IP address (common case)
         host_ip = None
-    except AttributeError:
-        # Divergence from upstream: Make ipaddress library optional
-        if ipaddress is None:
-            host_ip = None
-        else:  # Defensive
-            raise
     dnsnames = []
-    san = cert.get("subjectAltName", ())
+    san: tuple[tuple[str, str], ...] = cert.get("subjectAltName", ())
+    key: str
+    value: str
     for key, value in san:
         if key == "DNS":
             if host_ip is None and _dnsname_match(value, hostname):
@@ -135,25 +129,25 @@ def match_hostname(cert, hostname):
             if host_ip is not None and _ipaddress_match(value, host_ip):
                 return
             dnsnames.append(value)
-    if not dnsnames:
-        # The subject is only checked when there is no dNSName entry
-        # in subjectAltName
+
+    # We only check 'commonName' if it's enabled and we're not verifying
+    # an IP address. IP addresses aren't valid within 'commonName'.
+    if hostname_checks_common_name and host_ip is None and not dnsnames:
         for sub in cert.get("subject", ()):
             for key, value in sub:
-                # XXX according to RFC 2818, the most specific Common Name
-                # must be used.
                 if key == "commonName":
                     if _dnsname_match(value, hostname):
                         return
-                    dnsnames.append(value)
+                    dnsnames.append(
+                        value
+                    )  # Defensive: for older PyPy and OpenSSL versions
+
     if len(dnsnames) > 1:
         raise CertificateError(
             "hostname %r "
             "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames)))
         )
     elif len(dnsnames) == 1:
-        raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0]))
+        raise CertificateError(f"hostname {hostname!r} doesn't match {dnsnames[0]!r}")
     else:
-        raise CertificateError(
-            "no appropriate commonName or subjectAltName fields were found"
-        )
+        raise CertificateError("no appropriate subjectAltName fields were found")
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssltransport.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssltransport.py
index 4a7105d..6d59bc3 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssltransport.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/ssltransport.py
@@ -1,9 +1,20 @@
+from __future__ import annotations
+
 import io
 import socket
 import ssl
+import typing
 
 from ..exceptions import ProxySchemeUnsupported
-from ..packages import six
+
+if typing.TYPE_CHECKING:
+    from typing_extensions import Self
+
+    from .ssl_ import _TYPE_PEER_CERT_RET, _TYPE_PEER_CERT_RET_DICT
+
+
+_WriteBuffer = typing.Union[bytearray, memoryview]
+_ReturnValue = typing.TypeVar("_ReturnValue")
 
 SSL_BLOCKSIZE = 16384
 
@@ -20,7 +31,7 @@ class SSLTransport:
     """
 
     @staticmethod
-    def _validate_ssl_context_for_tls_in_tls(ssl_context):
+    def _validate_ssl_context_for_tls_in_tls(ssl_context: ssl.SSLContext) -> None:
         """
         Raises a ProxySchemeUnsupported if the provided ssl_context can't be used
         for TLS in TLS.
@@ -30,20 +41,18 @@ class SSLTransport:
         """
 
         if not hasattr(ssl_context, "wrap_bio"):
-            if six.PY2:
-                raise ProxySchemeUnsupported(
-                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
-                    "supported on Python 2"
-                )
-            else:
-                raise ProxySchemeUnsupported(
-                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
-                    "available on non-native SSLContext"
-                )
+            raise ProxySchemeUnsupported(
+                "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                "available on non-native SSLContext"
+            )
 
     def __init__(
-        self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True
-    ):
+        self,
+        socket: socket.socket,
+        ssl_context: ssl.SSLContext,
+        server_hostname: str | None = None,
+        suppress_ragged_eofs: bool = True,
+    ) -> None:
         """
         Create an SSLTransport around socket using the provided ssl_context.
         """
@@ -60,33 +69,36 @@ class SSLTransport:
         # Perform initial handshake.
         self._ssl_io_loop(self.sslobj.do_handshake)
 
-    def __enter__(self):
+    def __enter__(self) -> Self:
         return self
 
-    def __exit__(self, *_):
+    def __exit__(self, *_: typing.Any) -> None:
         self.close()
 
-    def fileno(self):
+    def fileno(self) -> int:
         return self.socket.fileno()
 
-    def read(self, len=1024, buffer=None):
+    def read(self, len: int = 1024, buffer: typing.Any | None = None) -> int | bytes:
         return self._wrap_ssl_read(len, buffer)
 
-    def recv(self, len=1024, flags=0):
+    def recv(self, buflen: int = 1024, flags: int = 0) -> int | bytes:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to recv")
-        return self._wrap_ssl_read(len)
+        return self._wrap_ssl_read(buflen)
 
-    def recv_into(self, buffer, nbytes=None, flags=0):
+    def recv_into(
+        self,
+        buffer: _WriteBuffer,
+        nbytes: int | None = None,
+        flags: int = 0,
+    ) -> None | int | bytes:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to recv_into")
-        if buffer and (nbytes is None):
+        if nbytes is None:
             nbytes = len(buffer)
-        elif nbytes is None:
-            nbytes = 1024
         return self.read(nbytes, buffer)
 
-    def sendall(self, data, flags=0):
+    def sendall(self, data: bytes, flags: int = 0) -> None:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to sendall")
         count = 0
@@ -96,15 +108,20 @@ class SSLTransport:
                 v = self.send(byte_view[count:])
                 count += v
 
-    def send(self, data, flags=0):
+    def send(self, data: bytes, flags: int = 0) -> int:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to send")
-        response = self._ssl_io_loop(self.sslobj.write, data)
-        return response
+        return self._ssl_io_loop(self.sslobj.write, data)
 
     def makefile(
-        self, mode="r", buffering=None, encoding=None, errors=None, newline=None
-    ):
+        self,
+        mode: str,
+        buffering: int | None = None,
+        *,
+        encoding: str | None = None,
+        errors: str | None = None,
+        newline: str | None = None,
+    ) -> typing.BinaryIO | typing.TextIO | socket.SocketIO:
         """
         Python's httpclient uses makefile and buffered io when reading HTTP
         messages and we need to support it.
@@ -113,7 +130,7 @@ class SSLTransport:
         changes to point to the socket directly.
         """
         if not set(mode) <= {"r", "w", "b"}:
-            raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+            raise ValueError(f"invalid mode {mode!r} (only r, w, b allowed)")
 
         writing = "w" in mode
         reading = "r" in mode or not writing
@@ -124,8 +141,8 @@ class SSLTransport:
             rawmode += "r"
         if writing:
             rawmode += "w"
-        raw = socket.SocketIO(self, rawmode)
-        self.socket._io_refs += 1
+        raw = socket.SocketIO(self, rawmode)  # type: ignore[arg-type]
+        self.socket._io_refs += 1  # type: ignore[attr-defined]
         if buffering is None:
             buffering = -1
         if buffering < 0:
@@ -134,8 +151,9 @@ class SSLTransport:
             if not binary:
                 raise ValueError("unbuffered streams must be binary")
             return raw
+        buffer: typing.BinaryIO
         if reading and writing:
-            buffer = io.BufferedRWPair(raw, raw, buffering)
+            buffer = io.BufferedRWPair(raw, raw, buffering)  # type: ignore[assignment]
         elif reading:
             buffer = io.BufferedReader(raw, buffering)
         else:
@@ -144,46 +162,51 @@ class SSLTransport:
         if binary:
             return buffer
         text = io.TextIOWrapper(buffer, encoding, errors, newline)
-        text.mode = mode
+        text.mode = mode  # type: ignore[misc]
         return text
 
-    def unwrap(self):
+    def unwrap(self) -> None:
         self._ssl_io_loop(self.sslobj.unwrap)
 
-    def close(self):
+    def close(self) -> None:
         self.socket.close()
 
-    def getpeercert(self, binary_form=False):
-        return self.sslobj.getpeercert(binary_form)
+    @typing.overload
+    def getpeercert(
+        self, binary_form: typing.Literal[False] = ...
+    ) -> _TYPE_PEER_CERT_RET_DICT | None: ...
 
-    def version(self):
+    @typing.overload
+    def getpeercert(self, binary_form: typing.Literal[True]) -> bytes | None: ...
+
+    def getpeercert(self, binary_form: bool = False) -> _TYPE_PEER_CERT_RET:
+        return self.sslobj.getpeercert(binary_form)  # type: ignore[return-value]
+
+    def version(self) -> str | None:
         return self.sslobj.version()
 
-    def cipher(self):
+    def cipher(self) -> tuple[str, str, int] | None:
         return self.sslobj.cipher()
 
-    def selected_alpn_protocol(self):
+    def selected_alpn_protocol(self) -> str | None:
         return self.sslobj.selected_alpn_protocol()
 
-    def selected_npn_protocol(self):
-        return self.sslobj.selected_npn_protocol()
-
-    def shared_ciphers(self):
+    def shared_ciphers(self) -> list[tuple[str, str, int]] | None:
         return self.sslobj.shared_ciphers()
 
-    def compression(self):
+    def compression(self) -> str | None:
         return self.sslobj.compression()
 
-    def settimeout(self, value):
+    def settimeout(self, value: float | None) -> None:
         self.socket.settimeout(value)
 
-    def gettimeout(self):
+    def gettimeout(self) -> float | None:
         return self.socket.gettimeout()
 
-    def _decref_socketios(self):
-        self.socket._decref_socketios()
+    def _decref_socketios(self) -> None:
+        self.socket._decref_socketios()  # type: ignore[attr-defined]
 
-    def _wrap_ssl_read(self, len, buffer=None):
+    def _wrap_ssl_read(self, len: int, buffer: bytearray | None = None) -> int | bytes:
         try:
             return self._ssl_io_loop(self.sslobj.read, len, buffer)
         except ssl.SSLError as e:
@@ -192,7 +215,29 @@ class SSLTransport:
             else:
                 raise
 
-    def _ssl_io_loop(self, func, *args):
+    # func is sslobj.do_handshake or sslobj.unwrap
+    @typing.overload
+    def _ssl_io_loop(self, func: typing.Callable[[], None]) -> None: ...
+
+    # func is sslobj.write, arg1 is data
+    @typing.overload
+    def _ssl_io_loop(self, func: typing.Callable[[bytes], int], arg1: bytes) -> int: ...
+
+    # func is sslobj.read, arg1 is len, arg2 is buffer
+    @typing.overload
+    def _ssl_io_loop(
+        self,
+        func: typing.Callable[[int, bytearray | None], bytes],
+        arg1: int,
+        arg2: bytearray | None,
+    ) -> bytes: ...
+
+    def _ssl_io_loop(
+        self,
+        func: typing.Callable[..., _ReturnValue],
+        arg1: None | bytes | int = None,
+        arg2: bytearray | None = None,
+    ) -> _ReturnValue:
         """Performs an I/O loop between incoming/outgoing and the socket."""
         should_loop = True
         ret = None
@@ -200,7 +245,12 @@ class SSLTransport:
         while should_loop:
             errno = None
             try:
-                ret = func(*args)
+                if arg1 is None and arg2 is None:
+                    ret = func()
+                elif arg2 is None:
+                    ret = func(arg1)
+                else:
+                    ret = func(arg1, arg2)
             except ssl.SSLError as e:
                 if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE):
                     # WANT_READ, and WANT_WRITE are expected, others are not.
@@ -218,4 +268,4 @@ class SSLTransport:
                     self.incoming.write(buf)
                 else:
                     self.incoming.write_eof()
-        return ret
+        return typing.cast(_ReturnValue, ret)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/timeout.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/timeout.py
index 78e18a6..c6cdb35 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/timeout.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/timeout.py
@@ -1,44 +1,56 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import time
-
-# The default socket timeout, used by httplib to indicate that no timeout was; specified by the user
-from socket import _GLOBAL_DEFAULT_TIMEOUT, getdefaulttimeout
+import typing
+from enum import Enum
+from socket import getdefaulttimeout
 
 from ..exceptions import TimeoutStateError
 
-# A sentinel value to indicate that no timeout was specified by the user in
-# urllib3
-_Default = object()
+if typing.TYPE_CHECKING:
+    from typing import Final
 
 
-# Use time.monotonic if available.
-current_time = getattr(time, "monotonic", time.time)
+class _TYPE_DEFAULT(Enum):
+    # This value should never be passed to socket.settimeout() so for safety we use a -1.
+    # socket.settimout() raises a ValueError for negative values.
+    token = -1
 
 
-class Timeout(object):
+_DEFAULT_TIMEOUT: Final[_TYPE_DEFAULT] = _TYPE_DEFAULT.token
+
+_TYPE_TIMEOUT = typing.Optional[typing.Union[float, _TYPE_DEFAULT]]
+
+
+class Timeout:
     """Timeout configuration.
 
     Timeouts can be defined as a default for a pool:
 
     .. code-block:: python
 
-       timeout = Timeout(connect=2.0, read=7.0)
-       http = PoolManager(timeout=timeout)
-       response = http.request('GET', 'http://example.com/')
+        from pip._vendor import urllib3
+
+        timeout = urllib3.util.Timeout(connect=2.0, read=7.0)
+
+        http = urllib3.PoolManager(timeout=timeout)
+
+        resp = http.request("GET", "https://example.com/")
+
+        print(resp.status)
 
     Or per-request (which overrides the default for the pool):
 
     .. code-block:: python
 
-       response = http.request('GET', 'http://example.com/', timeout=Timeout(10))
+       response = http.request("GET", "https://example.com/", timeout=Timeout(10))
 
     Timeouts can be disabled by setting all the parameters to ``None``:
 
     .. code-block:: python
 
        no_timeout = Timeout(connect=None, read=None)
-       response = http.request('GET', 'http://example.com/, timeout=no_timeout)
+       response = http.request("GET", "https://example.com/", timeout=no_timeout)
 
 
     :param total:
@@ -89,38 +101,34 @@ class Timeout(object):
         the case; if a server streams one byte every fifteen seconds, a timeout
         of 20 seconds will not trigger, even though the request will take
         several minutes to complete.
-
-        If your goal is to cut off any request after a set amount of wall clock
-        time, consider having a second "watcher" thread to cut off a slow
-        request.
     """
 
     #: A sentinel object representing the default timeout value
-    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT
+    DEFAULT_TIMEOUT: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT
 
-    def __init__(self, total=None, connect=_Default, read=_Default):
+    def __init__(
+        self,
+        total: _TYPE_TIMEOUT = None,
+        connect: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        read: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+    ) -> None:
         self._connect = self._validate_timeout(connect, "connect")
         self._read = self._validate_timeout(read, "read")
         self.total = self._validate_timeout(total, "total")
-        self._start_connect = None
+        self._start_connect: float | None = None
 
-    def __repr__(self):
-        return "%s(connect=%r, read=%r, total=%r)" % (
-            type(self).__name__,
-            self._connect,
-            self._read,
-            self.total,
-        )
+    def __repr__(self) -> str:
+        return f"{type(self).__name__}(connect={self._connect!r}, read={self._read!r}, total={self.total!r})"
 
     # __str__ provided for backwards compatibility
     __str__ = __repr__
 
-    @classmethod
-    def resolve_default_timeout(cls, timeout):
-        return getdefaulttimeout() if timeout is cls.DEFAULT_TIMEOUT else timeout
+    @staticmethod
+    def resolve_default_timeout(timeout: _TYPE_TIMEOUT) -> float | None:
+        return getdefaulttimeout() if timeout is _DEFAULT_TIMEOUT else timeout
 
     @classmethod
-    def _validate_timeout(cls, value, name):
+    def _validate_timeout(cls, value: _TYPE_TIMEOUT, name: str) -> _TYPE_TIMEOUT:
         """Check that a timeout attribute is valid.
 
         :param value: The timeout value to validate
@@ -130,10 +138,7 @@ class Timeout(object):
         :raises ValueError: If it is a numeric value less than or equal to
             zero, or the type is not an integer, float, or None.
         """
-        if value is _Default:
-            return cls.DEFAULT_TIMEOUT
-
-        if value is None or value is cls.DEFAULT_TIMEOUT:
+        if value is None or value is _DEFAULT_TIMEOUT:
             return value
 
         if isinstance(value, bool):
@@ -147,7 +152,7 @@ class Timeout(object):
             raise ValueError(
                 "Timeout value %s was %s, but it must be an "
                 "int, float or None." % (name, value)
-            )
+            ) from None
 
         try:
             if value <= 0:
@@ -157,16 +162,15 @@ class Timeout(object):
                     "than or equal to 0." % (name, value)
                 )
         except TypeError:
-            # Python 3
             raise ValueError(
                 "Timeout value %s was %s, but it must be an "
                 "int, float or None." % (name, value)
-            )
+            ) from None
 
         return value
 
     @classmethod
-    def from_float(cls, timeout):
+    def from_float(cls, timeout: _TYPE_TIMEOUT) -> Timeout:
         """Create a new Timeout from a legacy timeout value.
 
         The timeout value used by httplib.py sets the same timeout on the
@@ -175,13 +179,13 @@ class Timeout(object):
         passed to this function.
 
         :param timeout: The legacy timeout value.
-        :type timeout: integer, float, sentinel default object, or None
+        :type timeout: integer, float, :attr:`urllib3.util.Timeout.DEFAULT_TIMEOUT`, or None
         :return: Timeout object
         :rtype: :class:`Timeout`
         """
         return Timeout(read=timeout, connect=timeout)
 
-    def clone(self):
+    def clone(self) -> Timeout:
         """Create a copy of the timeout object
 
         Timeout properties are stored per-pool but each request needs a fresh
@@ -195,7 +199,7 @@ class Timeout(object):
         # detect the user default.
         return Timeout(connect=self._connect, read=self._read, total=self.total)
 
-    def start_connect(self):
+    def start_connect(self) -> float:
         """Start the timeout clock, used during a connect() attempt
 
         :raises urllib3.exceptions.TimeoutStateError: if you attempt
@@ -203,10 +207,10 @@ class Timeout(object):
         """
         if self._start_connect is not None:
             raise TimeoutStateError("Timeout timer has already been started.")
-        self._start_connect = current_time()
+        self._start_connect = time.monotonic()
         return self._start_connect
 
-    def get_connect_duration(self):
+    def get_connect_duration(self) -> float:
         """Gets the time elapsed since the call to :meth:`start_connect`.
 
         :return: Elapsed time in seconds.
@@ -218,10 +222,10 @@ class Timeout(object):
             raise TimeoutStateError(
                 "Can't get connect duration for timer that has not started."
             )
-        return current_time() - self._start_connect
+        return time.monotonic() - self._start_connect
 
     @property
-    def connect_timeout(self):
+    def connect_timeout(self) -> _TYPE_TIMEOUT:
         """Get the value to use when setting a connection timeout.
 
         This will be a positive float or integer, the value None
@@ -233,13 +237,13 @@ class Timeout(object):
         if self.total is None:
             return self._connect
 
-        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
+        if self._connect is None or self._connect is _DEFAULT_TIMEOUT:
             return self.total
 
-        return min(self._connect, self.total)
+        return min(self._connect, self.total)  # type: ignore[type-var]
 
     @property
-    def read_timeout(self):
+    def read_timeout(self) -> float | None:
         """Get the value for the read timeout.
 
         This assumes some time has elapsed in the connection timeout and
@@ -251,21 +255,21 @@ class Timeout(object):
         raised.
 
         :return: Value to use for the read timeout.
-        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        :rtype: int, float or None
         :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
             has not yet been called on this object.
         """
         if (
             self.total is not None
-            and self.total is not self.DEFAULT_TIMEOUT
+            and self.total is not _DEFAULT_TIMEOUT
             and self._read is not None
-            and self._read is not self.DEFAULT_TIMEOUT
+            and self._read is not _DEFAULT_TIMEOUT
         ):
             # In case the connect timeout has not yet been established.
             if self._start_connect is None:
                 return self._read
             return max(0, min(self.total - self.get_connect_duration(), self._read))
-        elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT:
+        elif self.total is not None and self.total is not _DEFAULT_TIMEOUT:
             return max(0, self.total - self.get_connect_duration())
         else:
-            return self._read
+            return self.resolve_default_timeout(self._read)
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/url.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/url.py
index a960b2f..e155925 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/url.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/url.py
@@ -1,22 +1,24 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import re
-from collections import namedtuple
+import typing
+from functools import partial
+from urllib.parse import unquote as _unquote
 
 from ..exceptions import LocationParseError
-from ..packages import six
-
-url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"]
+from .util import to_str
 
 # We only want to normalize urls with an HTTP(S) scheme.
 # urllib3 infers URLs without a scheme (None) to be http.
-NORMALIZABLE_SCHEMES = ("http", "https", None)
+_NORMALIZABLE_SCHEMES = ("http", "https", None)
 
 # Almost all of these patterns were derived from the
 # 'rfc3986' module: https://github.com/python-hyper/rfc3986
-PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
-SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
-URI_RE = re.compile(
+_PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
+_HOST_PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}|%")
+_SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
+_HOST_INVALID_CHAR_RE = re.compile(r"[\x00-\x20\x7f]")
+_URI_RE = re.compile(
     r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
     r"(?://([^\\/?#]*))?"
     r"([^?#]*)"
@@ -25,10 +27,10 @@ URI_RE = re.compile(
     re.UNICODE | re.DOTALL,
 )
 
-IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
-HEX_PAT = "[0-9A-Fa-f]{1,4}"
-LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT)
-_subs = {"hex": HEX_PAT, "ls32": LS32_PAT}
+_IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
+_HEX_PAT = "[0-9A-Fa-f]{1,4}"
+_LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=_HEX_PAT, ipv4=_IPV4_PAT)
+_subs = {"hex": _HEX_PAT, "ls32": _LS32_PAT}
 _variations = [
     #                            6( h16 ":" ) ls32
     "(?:%(hex)s:){6}%(ls32)s",
@@ -50,69 +52,124 @@ _variations = [
     "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
 ]
 
-UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
-IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
-ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
-IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
-REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
-TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
+_UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
+_IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
+_ZONE_ID_PAT = "(?:%25|%)(?:[" + _UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
+_IPV6_ADDRZ_PAT = r"\[" + _IPV6_PAT + r"(?:" + _ZONE_ID_PAT + r")?\]"
+_REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
+_TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
 
-IPV4_RE = re.compile("^" + IPV4_PAT + "$")
-IPV6_RE = re.compile("^" + IPV6_PAT + "$")
-IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
-BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
-ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
+_IPV4_RE = re.compile(
+    r"^(?:0[xX][0-9a-fA-F]+|[0-9]+)(?:\.(?:0[xX][0-9a-fA-F]+|[0-9]+)){0,3}$"
+)
+_IPV6_RE = re.compile("^" + _IPV6_PAT + "$")
+_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT + "$")
+_BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT[2:-2] + "$")
+_ZONE_ID_RE = re.compile("(" + _ZONE_ID_PAT + r")\]$")
 
 _HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*?(|0|[1-9][0-9]{0,4}))?$") % (
-    REG_NAME_PAT,
-    IPV4_PAT,
-    IPV6_ADDRZ_PAT,
+    _REG_NAME_PAT,
+    _IPV4_PAT,
+    _IPV6_ADDRZ_PAT,
 )
 _HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL)
 
-UNRESERVED_CHARS = set(
+_UNRESERVED_CHARS = set(
     "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~"
 )
-SUB_DELIM_CHARS = set("!$&'()*+,;=")
-USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"}
-PATH_CHARS = USERINFO_CHARS | {"@", "/"}
-QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"}
+_SUB_DELIM_CHARS = set("!$&'()*+,;=")
+_USERINFO_CHARS = _UNRESERVED_CHARS | _SUB_DELIM_CHARS | {":"}
+_PATH_CHARS = _USERINFO_CHARS | {"@", "/"}
+_QUERY_CHARS = _FRAGMENT_CHARS = _PATH_CHARS | {"?"}
 
 
-class Url(namedtuple("Url", url_attrs)):
+class Url(
+    typing.NamedTuple(
+        "Url",
+        [
+            ("scheme", typing.Optional[str]),
+            ("auth", typing.Optional[str]),
+            ("host", typing.Optional[str]),
+            ("port", typing.Optional[int]),
+            ("path", typing.Optional[str]),
+            ("query", typing.Optional[str]),
+            ("fragment", typing.Optional[str]),
+        ],
+    )
+):
     """
     Data structure for representing an HTTP URL. Used as a return value for
     :func:`parse_url`. Both the scheme and host are normalized as they are
     both case-insensitive according to RFC 3986.
+
+    :param auth: User information as defined in RFC 3986 3.2.1. This
+        component is kept percent-encoded. Use :attr:`auth_decoded` or
+        :attr:`auth_decoded_joined` to get the decoded form.
     """
 
-    __slots__ = ()
-
-    def __new__(
+    def __new__(  # type: ignore[no-untyped-def]
         cls,
-        scheme=None,
-        auth=None,
-        host=None,
-        port=None,
-        path=None,
-        query=None,
-        fragment=None,
+        scheme: str | None = None,
+        auth: str | None = None,
+        host: str | None = None,
+        port: int | None = None,
+        path: str | None = None,
+        query: str | None = None,
+        fragment: str | None = None,
     ):
         if path and not path.startswith("/"):
             path = "/" + path
         if scheme is not None:
             scheme = scheme.lower()
-        return super(Url, cls).__new__(
-            cls, scheme, auth, host, port, path, query, fragment
+        return super().__new__(cls, scheme, auth, host, port, path, query, fragment)
+
+    @property
+    def auth_decoded(self) -> tuple[None, None] | tuple[str, str | None]:
+        """
+        User information with %-escapes decoded as UTF-8, returned as a
+        ``(username, password)`` tuple.
+
+        Both values are ``None`` if ``auth`` is ``None``.
+        ``password`` is ``None`` if not present in the auth component.
+        """
+        if self.auth is None:
+            return None, None
+        username, sep, password = self.auth.partition(":")
+        return (
+            _unquote(username, encoding="utf-8"),
+            _unquote(password, encoding="utf-8") if sep else None,
         )
 
     @property
-    def hostname(self):
+    def auth_decoded_joined(self) -> str | None:
+        """
+        User information with %-escapes decoded as UTF-8, as a string
+        prepared for encoding into an 'authorization: basic ...' header.
+
+        This property does not choose the encoding used for an
+        'authorization: basic ...' header. Use the ``basic_auth_encoding`` or
+        ``proxy_basic_auth_encoding`` parameters of
+        :func:`urllib3.util.make_headers` when converting the returned string
+        into Basic authentication bytes.
+
+        This is a convenience property that joins the username and
+        password with a colon, if both are present.
+        If only the username is present, a trailing colon is still
+        appended.
+        If ``auth`` is ``None``, this returns ``None``.
+        """
+        username, password = self.auth_decoded
+        if username is None:
+            return None
+        return f"{username}:{password or ''}"
+
+    @property
+    def hostname(self) -> str | None:
         """For backwards-compatibility with urlparse. We're nice like that."""
         return self.host
 
     @property
-    def request_uri(self):
+    def request_uri(self) -> str:
         """Absolute path including the query string."""
         uri = self.path or "/"
 
@@ -122,14 +179,37 @@ class Url(namedtuple("Url", url_attrs)):
         return uri
 
     @property
-    def netloc(self):
-        """Network location including host and port"""
-        if self.port:
-            return "%s:%d" % (self.host, self.port)
+    def authority(self) -> str | None:
+        """
+        Authority component as defined in RFC 3986 3.2.
+        This includes userinfo (auth), host and port.
+
+        i.e.
+            userinfo@host:port
+        """
+        userinfo = self.auth
+        netloc = self.netloc
+        if netloc is None or userinfo is None:
+            return netloc
+        else:
+            return f"{userinfo}@{netloc}"
+
+    @property
+    def netloc(self) -> str | None:
+        """
+        Network location including host and port.
+
+        If you need the equivalent of urllib.parse's ``netloc``,
+        use the ``authority`` property instead.
+        """
+        if self.host is None:
+            return None
+        if self.port is not None:
+            return f"{self.host}:{self.port}"
         return self.host
 
     @property
-    def url(self):
+    def url(self) -> str:
         """
         Convert self into a url
 
@@ -138,88 +218,89 @@ class Url(namedtuple("Url", url_attrs)):
         :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
         with a blank port will have : removed).
 
-        Example: ::
+        Example:
 
-            >>> U = parse_url('http://google.com/mail/')
-            >>> U.url
-            'http://google.com/mail/'
-            >>> Url('http', 'username:password', 'host.com', 80,
-            ... '/path', 'query', 'fragment').url
-            'http://username:password@host.com:80/path?query#fragment'
+        .. code-block:: python
+
+            from pip._vendor import urllib3
+
+            U = urllib3.util.parse_url("https://google.com/mail/")
+
+            print(U.url)
+            # "https://google.com/mail/"
+
+            print( urllib3.util.Url("https", "username:password",
+                                    "host.com", 80, "/path", "query", "fragment"
+                                    ).url
+                )
+            # "https://username:password@host.com:80/path?query#fragment"
         """
         scheme, auth, host, port, path, query, fragment = self
-        url = u""
+        url = ""
 
         # We use "is not None" we want things to happen with empty strings (or 0 port)
         if scheme is not None:
-            url += scheme + u"://"
+            url += scheme + "://"
         if auth is not None:
-            url += auth + u"@"
+            url += auth + "@"
         if host is not None:
             url += host
         if port is not None:
-            url += u":" + str(port)
+            url += ":" + str(port)
         if path is not None:
             url += path
         if query is not None:
-            url += u"?" + query
+            url += "?" + query
         if fragment is not None:
-            url += u"#" + fragment
+            url += "#" + fragment
 
         return url
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.url
 
 
-def split_first(s, delims):
-    """
-    .. deprecated:: 1.25
-
-    Given a string and an iterable of delimiters, split on the first found
-    delimiter. Return two split parts and the matched delimiter.
-
-    If not found, then the first part is the full input string.
-
-    Example::
-
-        >>> split_first('foo/bar?baz', '?/=')
-        ('foo', 'bar?baz', '/')
-        >>> split_first('foo/bar?baz', '123')
-        ('foo/bar?baz', '', None)
-
-    Scales linearly with number of delims. Not ideal for large number of delims.
-    """
-    min_idx = None
-    min_delim = None
-    for d in delims:
-        idx = s.find(d)
-        if idx < 0:
-            continue
-
-        if min_idx is None or idx < min_idx:
-            min_idx = idx
-            min_delim = d
-
-    if min_idx is None or min_idx < 0:
-        return s, "", None
-
-    return s[:min_idx], s[min_idx + 1 :], min_delim
+@typing.overload
+def _encode_invalid_chars(
+    component: str, allowed_chars: typing.Container[str]
+) -> str:  # Abstract
+    ...
 
 
-def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
+@typing.overload
+def _encode_invalid_chars(
+    component: None, allowed_chars: typing.Container[str]
+) -> None:  # Abstract
+    ...
+
+
+def _encode_invalid_chars(
+    component: str | None, allowed_chars: typing.Container[str]
+) -> str | None:
     """Percent-encodes a URI component without reapplying
     onto an already percent-encoded component.
     """
     if component is None:
         return component
 
-    component = six.ensure_text(component)
+    component = to_str(component)
+
+    # Fast path: an ASCII component that consists only of allowed characters
+    # and contains no '%' needs neither encoding nor percent-normalization.
+    # Components containing '%' always take the general path below because
+    # how '%' is treated depends on whether the whole component is already
+    # percent-encoded.
+    if (
+        "%" not in component
+        and component.isascii()
+        and all(map(allowed_chars.__contains__, component))
+    ):
+        return component
 
     # Normalize existing percent-encoded bytes.
     # Try to see if the component we're encoding is already percent-encoded
     # so we can skip all '%' characters but still encode all others.
-    component, percent_encodings = PERCENT_RE.subn(
+    component, percent_encodings = _PERCENT_RE.subn(
         lambda match: match.group(0).upper(), component
     )
 
@@ -227,21 +308,19 @@ def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
     is_percent_encoded = percent_encodings == uri_bytes.count(b"%")
     encoded_component = bytearray()
 
-    for i in range(0, len(uri_bytes)):
-        # Will return a single character bytestring on both Python 2 & 3
-        byte = uri_bytes[i : i + 1]
-        byte_ord = ord(byte)
-        if (is_percent_encoded and byte == b"%") or (
-            byte_ord < 128 and byte.decode() in allowed_chars
+    # Iterating over bytes yields integers; 0x25 is '%'.
+    for byte_ord in uri_bytes:
+        if (is_percent_encoded and byte_ord == 0x25) or (
+            byte_ord < 128 and chr(byte_ord) in allowed_chars
         ):
-            encoded_component += byte
-            continue
-        encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))
+            encoded_component.append(byte_ord)
+        else:
+            encoded_component += b"%%%02X" % byte_ord
 
-    return encoded_component.decode(encoding)
+    return encoded_component.decode()
 
 
-def _remove_path_dot_segments(path):
+def _remove_path_dot_segments(path: str) -> str:
     # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code
     segments = path.split("/")  # Turn the path into a list of segments
     output = []  # Initialize the variable to use to store output
@@ -251,7 +330,7 @@ def _remove_path_dot_segments(path):
         if segment == ".":
             continue
         # Anything other than '..', should be appended to the output
-        elif segment != "..":
+        if segment != "..":
             output.append(segment)
         # In this case segment == '..', if we can, we should pop the last
         # element
@@ -271,18 +350,29 @@ def _remove_path_dot_segments(path):
     return "/".join(output)
 
 
-def _normalize_host(host, scheme):
-    if host:
-        if isinstance(host, six.binary_type):
-            host = six.ensure_str(host)
+@typing.overload
+def _normalize_host(host: None, scheme: str | None) -> None: ...
 
-        if scheme in NORMALIZABLE_SCHEMES:
-            is_ipv6 = IPV6_ADDRZ_RE.match(host)
+
+@typing.overload
+def _normalize_host(host: str, scheme: str | None) -> str: ...
+
+
+def _normalize_host(host: str | None, scheme: str | None) -> str | None:
+    if host:
+        invalid_host_char = _HOST_INVALID_CHAR_RE.search(host)
+        if invalid_host_char:
+            raise LocationParseError(
+                f"Host {host!r} contains invalid character "
+                f"{invalid_host_char.group()!r}"
+            )
+        if scheme in _NORMALIZABLE_SCHEMES:
+            is_ipv6 = _IPV6_ADDRZ_RE.match(host)
             if is_ipv6:
                 # IPv6 hosts of the form 'a::b%zone' are encoded in a URL as
                 # such per RFC 6874: 'a::b%25zone'. Unquote the ZoneID
                 # separator as necessary to return a valid RFC 4007 scoped IP.
-                match = ZONE_ID_RE.search(host)
+                match = _ZONE_ID_RE.search(host)
                 if match:
                     start, end = match.span(1)
                     zone_id = host[start:end]
@@ -291,46 +381,94 @@ def _normalize_host(host, scheme):
                         zone_id = zone_id[3:]
                     else:
                         zone_id = zone_id[1:]
-                    zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS)
-                    return host[:start].lower() + zone_id + host[end:]
+                    zone_id = _PERCENT_RE.sub(
+                        partial(_normalize_zone_id_percent_encoding, error_host=host),
+                        zone_id,
+                    )
+                    zone_id = _encode_invalid_chars(zone_id, _UNRESERVED_CHARS)
+                    return f"{host[:start].lower()}%{zone_id}{host[end:]}"
                 else:
                     return host.lower()
-            elif not IPV4_RE.match(host):
-                return six.ensure_str(
-                    b".".join([_idna_encode(label) for label in host.split(".")])
+            elif not _IPV4_RE.match(host):
+                if "%" in host:
+                    host = _HOST_PERCENT_RE.sub(_normalize_host_percent_encoding, host)
+                return to_str(
+                    b".".join([_idna_encode(label) for label in host.split(".")]),
+                    "ascii",
                 )
     return host
 
 
-def _idna_encode(name):
-    if name and any(ord(x) >= 128 for x in name):
+def _decode_percent_encoding(match: re.Match[str], *, error_host: str) -> str:
+    percent_encoded_octet = match.group(0)
+    decoded_octet = chr(int(percent_encoded_octet[1:], 16))
+    # Keep this narrower than _HOST_INVALID_CHAR_RE because "%20" is valid
+    # percent-encoding and remains encoded.
+    if decoded_octet < "\x20" or decoded_octet == "\x7f":
+        raise LocationParseError(
+            f"Host {error_host!r} contains invalid percent-encoded "
+            f"control character {percent_encoded_octet!r}"
+        )
+    return decoded_octet
+
+
+def _normalize_host_percent_encoding(match: re.Match[str]) -> str:
+    # Reject invalid percent encodings
+    if match.group(0) == "%":
+        raise LocationParseError(f"{match.string!r} is not a valid host")
+    decoded_octet = _decode_percent_encoding(match, error_host=match.string)
+    if decoded_octet in _UNRESERVED_CHARS:
+        return decoded_octet
+    return match.group(0).upper()
+
+
+def _normalize_zone_id_percent_encoding(
+    match: re.Match[str], *, error_host: str
+) -> str:
+    _decode_percent_encoding(match, error_host=error_host)
+    return match.group(0).upper()
+
+
+def _idna_encode(name: str) -> bytes:
+    if not name.isascii():
         try:
             from pip._vendor import idna
         except ImportError:
-            six.raise_from(
-                LocationParseError("Unable to parse URL without the 'idna' module"),
-                None,
-            )
+            raise LocationParseError(
+                "Unable to parse URL without the 'idna' module"
+            ) from None
+
         try:
             return idna.encode(name.lower(), strict=True, std3_rules=True)
         except idna.IDNAError:
-            six.raise_from(
-                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None
-            )
-    return name.lower().encode("ascii")
+            raise LocationParseError(
+                f"Name '{name}' is not a valid IDNA label"
+            ) from None
+
+    return _PERCENT_RE.sub(lambda match: match.group(0).upper(), name.lower()).encode(
+        "ascii"
+    )
 
 
-def _encode_target(target):
-    """Percent-encodes a request target so that there are no invalid characters"""
-    path, query = TARGET_RE.match(target).groups()
-    target = _encode_invalid_chars(path, PATH_CHARS)
-    query = _encode_invalid_chars(query, QUERY_CHARS)
+def _encode_target(target: str) -> str:
+    """Percent-encodes a request target so that there are no invalid characters
+
+    Pre-condition for this function is that 'target' must start with '/'.
+    If that is the case then _TARGET_RE will always produce a match.
+    """
+    match = _TARGET_RE.match(target)
+    if not match:  # Defensive:
+        raise LocationParseError(f"{target!r} is not a valid request URI")
+
+    path, query = match.groups()
+    encoded_target = _encode_invalid_chars(path, _PATH_CHARS)
     if query is not None:
-        target += "?" + query
-    return target
+        query = _encode_invalid_chars(query, _QUERY_CHARS)
+        encoded_target += "?" + query
+    return encoded_target
 
 
-def parse_url(url):
+def parse_url(url: str) -> Url:
     """
     Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
     performed to parse incomplete urls. Fields not provided will be None.
@@ -341,60 +479,82 @@ def parse_url(url):
 
     :param str url: URL to parse into a :class:`.Url` namedtuple.
 
-    Partly backwards-compatible with :mod:`urlparse`.
+    Partly backwards-compatible with :mod:`urllib.parse`.
 
-    Example::
+    Example:
 
-        >>> parse_url('http://google.com/mail/')
-        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
-        >>> parse_url('google.com:80')
-        Url(scheme=None, host='google.com', port=80, path=None, ...)
-        >>> parse_url('/foo?bar')
-        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
+    .. code-block:: python
+
+        from pip._vendor import urllib3
+
+        print( urllib3.util.parse_url('http://google.com/mail/'))
+        # Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
+
+        print( urllib3.util.parse_url('google.com:80'))
+        # Url(scheme=None, host='google.com', port=80, path=None, ...)
+
+        print( urllib3.util.parse_url('/foo?bar'))
+        # Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
     """
     if not url:
         # Empty
         return Url()
 
-    source_url = url
-    if not SCHEME_RE.search(url):
+    if not _SCHEME_RE.search(url):
         url = "//" + url
 
-    try:
-        scheme, authority, path, query, fragment = URI_RE.match(url).groups()
-        normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES
+    scheme: str | None
+    authority: str | None
+    auth: str | None
+    host: str | None
+    port: str | None
+    port_int: int | None
+    path: str | None
+    query: str | None
+    fragment: str | None
 
-        if scheme:
-            scheme = scheme.lower()
+    scheme, authority, path, query, fragment = _URI_RE.match(url).groups()  # type: ignore[union-attr]
+    normalize_uri = scheme is None or scheme.lower() in _NORMALIZABLE_SCHEMES
 
-        if authority:
-            auth, _, host_port = authority.rpartition("@")
-            auth = auth or None
-            host, port = _HOST_PORT_RE.match(host_port).groups()
-            if auth and normalize_uri:
-                auth = _encode_invalid_chars(auth, USERINFO_CHARS)
-            if port == "":
-                port = None
-        else:
-            auth, host, port = None, None, None
+    if scheme:
+        scheme = scheme.lower()
 
-        if port is not None:
-            port = int(port)
-            if not (0 <= port <= 65535):
-                raise LocationParseError(url)
+    if authority:
+        auth, _, host_port = authority.rpartition("@")
+        auth = auth or None
+        host_port_match = _HOST_PORT_RE.fullmatch(host_port)
+        if not host_port_match:
+            invalid_host_char = _HOST_INVALID_CHAR_RE.search(host_port)
+            if invalid_host_char:
+                raise LocationParseError(
+                    f"Host {host_port!r} contains invalid character "
+                    f"{invalid_host_char.group()!r}"
+                )
+            raise LocationParseError(f"{host_port!r} is not a valid host or port")
+        host, port = host_port_match.groups()
+        if auth and normalize_uri:
+            auth = _encode_invalid_chars(auth, _USERINFO_CHARS)
+        if port == "":
+            port = None
+    else:
+        auth, host, port = None, None, None
 
-        host = _normalize_host(host, scheme)
+    if port is not None:
+        port_int = int(port)
+        if not (0 <= port_int <= 65535):
+            raise LocationParseError(url)
+    else:
+        port_int = None
 
-        if normalize_uri and path:
-            path = _remove_path_dot_segments(path)
-            path = _encode_invalid_chars(path, PATH_CHARS)
-        if normalize_uri and query:
-            query = _encode_invalid_chars(query, QUERY_CHARS)
-        if normalize_uri and fragment:
-            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
+    host = _normalize_host(host, scheme)
 
-    except (ValueError, AttributeError):
-        return six.raise_from(LocationParseError(source_url), None)
+    if normalize_uri and path:
+        path = _remove_path_dot_segments(path)
+        path = _encode_invalid_chars(path, _PATH_CHARS)
+    if normalize_uri and query:
+        query = _encode_invalid_chars(query, _QUERY_CHARS)
+    if normalize_uri and fragment:
+        fragment = _encode_invalid_chars(fragment, _FRAGMENT_CHARS)
 
     # For the sake of backwards compatibility we put empty
     # string values for path if there are any defined values
@@ -406,30 +566,12 @@ def parse_url(url):
         else:
             path = None
 
-    # Ensure that each part of the URL is a `str` for
-    # backwards compatibility.
-    if isinstance(url, six.text_type):
-        ensure_func = six.ensure_text
-    else:
-        ensure_func = six.ensure_str
-
-    def ensure_type(x):
-        return x if x is None else ensure_func(x)
-
     return Url(
-        scheme=ensure_type(scheme),
-        auth=ensure_type(auth),
-        host=ensure_type(host),
-        port=port,
-        path=ensure_type(path),
-        query=ensure_type(query),
-        fragment=ensure_type(fragment),
+        scheme=scheme,
+        auth=auth,
+        host=host,
+        port=port_int,
+        path=path,
+        query=query,
+        fragment=fragment,
     )
-
-
-def get_host(url):
-    """
-    Deprecated. Use :func:`parse_url` instead.
-    """
-    p = parse_url(url)
-    return p.scheme or "http", p.hostname, p.port
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/wait.py b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/wait.py
index 21b4590..aeca0c7 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/wait.py
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/urllib3/util/wait.py
@@ -1,18 +1,10 @@
-import errno
+from __future__ import annotations
+
 import select
-import sys
+import socket
 from functools import partial
 
-try:
-    from time import monotonic
-except ImportError:
-    from time import time as monotonic
-
-__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"]
-
-
-class NoWayToWaitForSocketError(Exception):
-    pass
+__all__ = ["wait_for_read", "wait_for_write"]
 
 
 # How should we wait on sockets?
@@ -37,37 +29,13 @@ class NoWayToWaitForSocketError(Exception):
 # So: on Windows we use select(), and everywhere else we use poll(). We also
 # fall back to select() in case poll() is somehow broken or missing.
 
-if sys.version_info >= (3, 5):
-    # Modern Python, that retries syscalls by default
-    def _retry_on_intr(fn, timeout):
-        return fn(timeout)
 
-else:
-    # Old and broken Pythons.
-    def _retry_on_intr(fn, timeout):
-        if timeout is None:
-            deadline = float("inf")
-        else:
-            deadline = monotonic() + timeout
-
-        while True:
-            try:
-                return fn(timeout)
-            # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7
-            except (OSError, select.error) as e:
-                # 'e.args[0]' incantation works for both OSError and select.error
-                if e.args[0] != errno.EINTR:
-                    raise
-                else:
-                    timeout = deadline - monotonic()
-                    if timeout < 0:
-                        timeout = 0
-                    if timeout == float("inf"):
-                        timeout = None
-                    continue
-
-
-def select_wait_for_socket(sock, read=False, write=False, timeout=None):
+def select_wait_for_socket(
+    sock: socket.socket,
+    read: bool = False,
+    write: bool = False,
+    timeout: float | None = None,
+) -> bool:
     if not read and not write:
         raise RuntimeError("must specify at least one of read=True, write=True")
     rcheck = []
@@ -82,11 +50,16 @@ def select_wait_for_socket(sock, read=False, write=False, timeout=None):
     # sockets for both conditions. (The stdlib selectors module does the same
     # thing.)
     fn = partial(select.select, rcheck, wcheck, wcheck)
-    rready, wready, xready = _retry_on_intr(fn, timeout)
+    rready, wready, xready = fn(timeout)
     return bool(rready or wready or xready)
 
 
-def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
+def poll_wait_for_socket(
+    sock: socket.socket,
+    read: bool = False,
+    write: bool = False,
+    timeout: float | None = None,
+) -> bool:
     if not read and not write:
         raise RuntimeError("must specify at least one of read=True, write=True")
     mask = 0
@@ -98,32 +71,33 @@ def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
     poll_obj.register(sock, mask)
 
     # For some reason, poll() takes timeout in milliseconds
-    def do_poll(t):
+    def do_poll(t: float | None) -> list[tuple[int, int]]:
         if t is not None:
             t *= 1000
         return poll_obj.poll(t)
 
-    return bool(_retry_on_intr(do_poll, timeout))
+    return bool(do_poll(timeout))
 
 
-def null_wait_for_socket(*args, **kwargs):
-    raise NoWayToWaitForSocketError("no select-equivalent available")
-
-
-def _have_working_poll():
+def _have_working_poll() -> bool:
     # Apparently some systems have a select.poll that fails as soon as you try
     # to use it, either due to strange configuration or broken monkeypatching
     # from libraries like eventlet/greenlet.
     try:
         poll_obj = select.poll()
-        _retry_on_intr(poll_obj.poll, 0)
+        poll_obj.poll(0)
     except (AttributeError, OSError):
         return False
     else:
         return True
 
 
-def wait_for_socket(*args, **kwargs):
+def wait_for_socket(
+    sock: socket.socket,
+    read: bool = False,
+    write: bool = False,
+    timeout: float | None = None,
+) -> bool:
     # We delay choosing which implementation to use until the first time we're
     # called. We could do it at import time, but then we might make the wrong
     # decision if someone goes wild with monkeypatching select.poll after
@@ -133,19 +107,17 @@ def wait_for_socket(*args, **kwargs):
         wait_for_socket = poll_wait_for_socket
     elif hasattr(select, "select"):
         wait_for_socket = select_wait_for_socket
-    else:  # Platform-specific: Appengine.
-        wait_for_socket = null_wait_for_socket
-    return wait_for_socket(*args, **kwargs)
+    return wait_for_socket(sock, read, write, timeout)
 
 
-def wait_for_read(sock, timeout=None):
+def wait_for_read(sock: socket.socket, timeout: float | None = None) -> bool:
     """Waits for reading to be available on a given socket.
     Returns True if the socket is readable, or False if the timeout expired.
     """
     return wait_for_socket(sock, read=True, timeout=timeout)
 
 
-def wait_for_write(sock, timeout=None):
+def wait_for_write(sock: socket.socket, timeout: float | None = None) -> bool:
     """Waits for writing to be available on a given socket.
     Returns True if the socket is readable, or False if the timeout expired.
     """
diff --git a/.venv/lib/python3.14/site-packages/pip/_vendor/vendor.txt b/.venv/lib/python3.14/site-packages/pip/_vendor/vendor.txt
index dd2f5f3..70dc752 100644
--- a/.venv/lib/python3.14/site-packages/pip/_vendor/vendor.txt
+++ b/.venv/lib/python3.14/site-packages/pip/_vendor/vendor.txt
@@ -1,19 +1,18 @@
 CacheControl==0.14.4
-distlib==0.4.0
+distlib==0.4.4
 distro==1.9.0
-msgpack==1.1.2
-packaging==26.0
-platformdirs==4.5.1
-pyproject-hooks==1.2.0
-requests==2.32.5
-    certifi==2026.1.4
-    idna==3.11
-    urllib3==1.26.20
-rich==14.2.0
-    pygments==2.19.2
+msgpack==1.2.4
+packaging==26.3
+platformdirs==4.12.4
+pyproject-hooks==1.3.3
+requests==2.34.2
+    certifi==2026.10.23
+    idna==3.20
+    urllib3==2.8.0
+rich==15.0.0
+    pygments==2.21.0
 resolvelib==1.2.1
 setuptools==70.3.0
-tomli==2.3.0
+tomli==2.3.2
 tomli-w==1.2.0
-truststore==0.10.4
-dependency-groups==1.3.1
+truststore==0.10.5
diff --git a/.venv/lib/python3.14/site-packages/pygame/__briefcase/__init__.py b/.venv/lib/python3.14/site-packages/pygame/__briefcase/__init__.py
deleted file mode 100644
index e69de29..0000000
diff --git a/.venv/lib/python3.14/site-packages/pygame/__briefcase/pygame_ce.py b/.venv/lib/python3.14/site-packages/pygame/__briefcase/pygame_ce.py
deleted file mode 100644
index 266a0ca..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/__briefcase/pygame_ce.py
+++ /dev/null
@@ -1,148 +0,0 @@
-from briefcase.bootstraps.base import BaseGuiBootstrap
-
-
-class PygameCEGuiBootstrap(BaseGuiBootstrap):
-    display_name_annotation = "does not support iOS/Android/Web deployment"
-
-    def app_source(self):
-        return """\
-import importlib.metadata
-import os
-import sys
-
-import pygame
-
-
-SCREEN_WIDTH, SCREEN_HEIGHT = 800, 600
-BGCOLOR = (255, 255, 255)
-
-
-def main():
-    # Linux desktop environments use an app's .desktop file to integrate the app
-    # in to their application menus. The .desktop file of this app will include
-    # the StartupWMClass key, set to app's formal name. This helps associate the
-    # app's windows to its menu item.
-    #
-    # For association to work, any windows of the app must have WMCLASS property
-    # set to match the value set in app's desktop file. For pygame_ce, this is
-    # set using the SDL_VIDEO_X11_WMCLASS environment variable.
-
-    # Find the name of the module that was used to start the app
-    app_module = sys.modules["__main__"].__package__
-    # Retrieve the app's metadata
-    metadata = importlib.metadata.metadata(app_module)
-
-    os.environ["SDL_VIDEO_X11_WMCLASS"] = metadata["Formal-Name"]
-
-    pygame.init()
-    pygame.display.set_caption(metadata["Formal-Name"])
-    screen = pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT))
-
-    running = True
-    while running:
-        for event in pygame.event.get():
-            if event.type == pygame.QUIT:
-                running = False
-                break
-
-        screen.fill(BGCOLOR)
-        pygame.display.flip()
-
-    pygame.quit()
-"""
-
-    def pyproject_table_briefcase_app_extra_content(self):
-        return """
-requires = [
-    "pygame-ce",
-]
-"""
-
-    def pyproject_table_macOS(self):
-        return """\
-universal_build = true
-requires = [
-    "std-nslog~=1.0.0",
-]
-"""
-
-    def pyproject_table_linux(self):
-        return """\
-requires = [
-]
-"""
-
-    def pyproject_table_linux_system_debian(self):
-        return """\
-system_requires = [
-]
-
-system_runtime_requires = [
-]
-"""
-
-    def pyproject_table_linux_system_rhel(self):
-        return """\
-system_requires = [
-]
-
-system_runtime_requires = [
-]
-"""
-
-    def pyproject_table_linux_system_suse(self):
-        return """\
-system_requires = [
-]
-
-system_runtime_requires = [
-]
-"""
-
-    def pyproject_table_linux_system_arch(self):
-        return """\
-system_requires = [
-]
-
-system_runtime_requires = [
-]
-"""
-
-    def pyproject_table_linux_appimage(self):
-        return """\
-manylinux = "manylinux_2_28"
-
-system_requires = [
-]
-
-linuxdeploy_plugins = [
-]
-"""
-
-    def pyproject_table_linux_flatpak(self):
-        return """\
-flatpak_runtime = "org.freedesktop.Platform"
-flatpak_runtime_version = "23.08"
-flatpak_sdk = "org.freedesktop.Sdk"
-"""
-
-    def pyproject_table_windows(self):
-        return """\
-requires = [
-]
-"""
-
-    def pyproject_table_iOS(self):
-        return """\
-supported = false
-"""
-
-    def pyproject_table_android(self):
-        return """\
-supported = false
-"""
-
-    def pyproject_table_web(self):
-        return """\
-supported = false
-"""
diff --git a/.venv/lib/python3.14/site-packages/pygame/__init__.py b/.venv/lib/python3.14/site-packages/pygame/__init__.py
index 9e02e6e..da8bff7 100644
--- a/.venv/lib/python3.14/site-packages/pygame/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pygame/__init__.py
@@ -1,4 +1,4 @@
-# pygame-ce - Python Game Library
+# pygame - Python Game Library
 # Copyright (C) 2000-2001  Pete Shinners
 #
 # This library is free software; you can redistribute it and/or
@@ -21,42 +21,24 @@
 It is written on top of the excellent SDL library. This allows you
 to create fully featured games and multimedia programs in the python
 language. The package is highly portable, with games running on
-Windows, macOS, OS X, BeOS, FreeBSD, IRIX, and Linux."""
+Windows, MacOS, OS X, BeOS, FreeBSD, IRIX, and Linux."""
 
-import os
 import sys
-import platform
+import os
 
 # Choose Windows display driver
 if os.name == "nt":
     pygame_dir = os.path.split(__file__)[0]
-    dll_parents = {pygame_dir}
-    try:
-        # For editable support, add some more folders where DLLs are available.
-        # This block only executes under an editable install. In a "normal"
-        # install, the json file will not be installed at the supplied path.
-        with open(
-            os.path.join(
-                os.path.dirname(pygame_dir), "buildconfig", "win_dll_dirs.json"
-            ),
-            encoding="utf-8",
-        ) as f:
-            import json
 
-            dll_parents.update(json.load(f))
-            del json
-    except (FileNotFoundError, ValueError):
-        pass
+    # pypy does not find the dlls, so we add package folder to PATH.
+    os.environ["PATH"] = os.environ["PATH"] + ";" + pygame_dir
 
-    d = ""  # define variable here so that we can consistently delete it
-    for d in dll_parents:
-        # adding to PATH is the legacy way, os.add_dll_directory is the new
-        # and recommended method. For extra safety we do both
-        os.environ["PATH"] = os.environ["PATH"] + ";" + d
-        os.add_dll_directory(d)
+    # windows store python does not find the dlls, so we run this
+    if sys.version_info > (3, 8):
+        os.add_dll_directory(pygame_dir)  # only available in 3.8+
 
     # cleanup namespace
-    del pygame_dir, dll_parents, d
+    del pygame_dir
 
 # when running under X11, always set the SDL window WM_CLASS to make the
 #   window managers correctly match the pygame window.
@@ -73,13 +55,9 @@ class MissingModule:
 
     def __init__(self, name, urgent=0):
         self.name = name
-        exc_type, exc_msg, _ = sys.exc_info()
-        if exc_type is not None:
-            self.info = str(exc_msg)
-            self.reason = f"{exc_type.__name__}: {self.info}"
-        else:
-            self.info = ""
-            self.reason = f": {self.info}"
+        exc_type, exc_msg = sys.exc_info()[:2]
+        self.info = str(exc_msg)
+        self.reason = f"{exc_type.__name__}: {self.info}"
         self.urgent = urgent
         if urgent:
             self.warn()
@@ -106,31 +84,6 @@ class MissingModule:
             print(message)
 
 
-# This is a special loader for WebAssembly platform
-# where pygame is in fact statically linked
-# mixing single phase (C) and multiphase modules (cython)
-if sys.platform in ("wasi", "emscripten"):
-    try:
-        import pygame.base as pygame_static
-    except ModuleNotFoundError:
-        pygame_static = None
-
-    if pygame_static:
-        pygame = sys.modules[__name__]
-
-        # cython modules use multiphase initialisation when not in builtin Inittab.
-
-        from pygame import _sdl2
-
-        import importlib.machinery
-
-        loader = importlib.machinery.FrozenImporter
-        spec = importlib.machinery.ModuleSpec("", loader)
-        pygame_static.import_cython(spec)
-        del loader, spec
-    del pygame_static
-
-
 # we need to import like this, each at a time. the cleanest way to import
 # our modules is with the import command (not the __import__ function)
 # isort: skip_file
@@ -139,33 +92,31 @@ if sys.platform in ("wasi", "emscripten"):
 from pygame.base import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
 from pygame.constants import *  # now has __all__ pylint: disable=wildcard-import; lgtm[py/polluting-import]
 from pygame.version import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
+from pygame.rect import Rect
 from pygame.rwobject import encode_string, encode_file_path
-
-
-import pygame.rect
-
-Rect = pygame.rect.Rect
-FRect = pygame.rect.FRect
-
-
+import pygame.surflock
 import pygame.color
 
 Color = pygame.color.Color
-
 import pygame.bufferproxy
 
 BufferProxy = pygame.bufferproxy.BufferProxy
-
 import pygame.math
 
 Vector2 = pygame.math.Vector2
 Vector3 = pygame.math.Vector3
 
-
-from pygame.base import __version__
+__version__ = ver
 
 # next, the "standard" modules
 # we still allow them to be missing for stripped down pygame distributions
+if get_sdl_version() < (2, 0, 0):
+    # cdrom only available for SDL 1.2.X
+    try:
+        import pygame.cdrom
+    except (ImportError, OSError):
+        cdrom = MissingModule("cdrom", urgent=1)
+
 try:
     import pygame.display
 except (ImportError, OSError):
@@ -178,7 +129,6 @@ except (ImportError, OSError):
 
 try:
     import pygame.event
-    from pygame.event import Event
 except (ImportError, OSError):
     event = MissingModule("event", urgent=1)
 
@@ -189,7 +139,6 @@ except (ImportError, OSError):
 
 try:
     import pygame.joystick
-    from pygame.joystick import Joystick
 except (ImportError, OSError):
     joystick = MissingModule("joystick", urgent=1)
 
@@ -213,6 +162,16 @@ except (ImportError, OSError):
         _attribute_undefined("pygame.Cursor")
 
 
+try:
+    import pygame.sprite
+except (ImportError, OSError):
+    sprite = MissingModule("sprite", urgent=1)
+
+try:
+    import pygame.threads
+except (ImportError, OSError):
+    threads = MissingModule("threads", urgent=1)
+
 try:
     import pygame.pixelcopy
 except (ImportError, OSError):
@@ -220,7 +179,6 @@ except (ImportError, OSError):
 
 
 try:
-    import pygame.surflock
     from pygame.surface import Surface, SurfaceType
 except (ImportError, OSError):
 
@@ -229,13 +187,6 @@ except (ImportError, OSError):
 
     SurfaceType = Surface
 
-# sprite.py is using pygame.surface.Surface type
-try:
-    import pygame.sprite
-except (ImportError, OSError):
-    sprite = MissingModule("sprite", urgent=1)
-
-
 try:
     import pygame.mask
     from pygame.mask import Mask
@@ -254,9 +205,16 @@ except (ImportError, OSError):
         _attribute_undefined("pygame.PixelArray")
 
 
+try:
+    from pygame.overlay import Overlay
+except (ImportError, OSError):
+
+    def Overlay(format, size):  # pylint: disable=unused-argument
+        _attribute_undefined("pygame.Overlay")
+
+
 try:
     import pygame.time
-    from pygame.time import Clock
 except (ImportError, OSError):
     time = MissingModule("time", urgent=1)
 
@@ -277,15 +235,13 @@ try:
     import pygame.font
     import pygame.sysfont
 
-    from pygame.font import Font
-
     pygame.font.SysFont = pygame.sysfont.SysFont
     pygame.font.get_fonts = pygame.sysfont.get_fonts
     pygame.font.match_font = pygame.sysfont.match_font
 except (ImportError, OSError):
     font = MissingModule("font", urgent=0)
 
-# try to load pygame.mixer_music before mixer, for py2app...
+# try and load pygame.mixer_music before mixer, for py2app...
 try:
     import pygame.mixer_music
 
@@ -296,8 +252,6 @@ except (ImportError, OSError):
 
 try:
     import pygame.mixer
-    from pygame.mixer import Sound
-    from pygame.mixer import Channel
 except (ImportError, OSError):
     mixer = MissingModule("mixer", urgent=0)
 
@@ -306,86 +260,20 @@ try:
 except (ImportError, OSError):
     scrap = MissingModule("scrap", urgent=0)
 
-# Two lazily imported modules to avoid loading numpy unnecessarily
-
-from importlib.util import LazyLoader, find_spec, module_from_spec
-
-
-def lazy_import(name):
-    """Lazily import a pygame module.
-
-    See https://docs.python.org/3/library/importlib.html#implementing-lazy-imports
-    Only load the module upon its first attribute access.
-
-    Lazily imported modules are directly referenced in packager_imports function.
-    """
-    fullname = "pygame." + name
-    spec = find_spec(fullname)
-    if spec is None or spec.loader is None:
-        return MissingModule(name, urgent=0)
-    loader = LazyLoader(spec.loader)
-    spec.loader = loader
-    module = module_from_spec(spec)
-    sys.modules[fullname] = module
-    loader.exec_module(module)
-    return module
-
-
-# Check if numpy is available for surfarray and sndarray modules
-numpy_missing = find_spec("numpy") is None
-
 try:
-    if numpy_missing:
-        # Always fails here. Need the error message for MissingModule.reason
-        import numpy  # pylint: disable=ungrouped-imports
-    # Check that module dependencies are not missing, or get error message
-    import pygame.pixelcopy  # pylint: disable=ungrouped-imports
+    import pygame.surfarray
 except (ImportError, OSError):
     surfarray = MissingModule("surfarray", urgent=0)
-else:
-    surfarray = lazy_import("surfarray")
 
 try:
-    if numpy_missing:
-        # Always fails here. Need the error message for MissingModule.reason
-        import numpy  # pylint: disable=ungrouped-imports
-    # Check that module dependencies are not missing, or get error message
-    import pygame.mixer  # pylint: disable=ungrouped-imports
+    import pygame.sndarray
 except (ImportError, OSError):
     sndarray = MissingModule("sndarray", urgent=0)
-else:
-    sndarray = lazy_import("sndarray")
-
-del LazyLoader, find_spec, lazy_import, module_from_spec, numpy_missing
 
 try:
-    import pygame._debug
-    from pygame._debug import print_debug_info
+    import pygame.fastevent
 except (ImportError, OSError):
-    debug = MissingModule("_debug", urgent=0)
-
-try:
-    import pygame.system
-    from pygame._data_classes import PowerState as power_state
-
-    power_state.__module__ = "pygame.system"
-    del power_state
-except (ImportError, OSError):
-    system = MissingModule("system", urgent=0)
-
-try:
-    from pygame.window import Window
-except (ImportError, OSError):
-
-    def Window(title="pygame window", size=(640, 480), position=None, **kwargs):  # pylint: disable=unused-argument
-        _attribute_undefined("pygame.Window")
-
-
-try:
-    import pygame.typing
-except (ImportError, OSError):
-    typing = MissingModule("typing", urgent=0)
-
+    fastevent = MissingModule("fastevent", urgent=0)
 
 # there's also a couple "internal" modules not needed
 # by users, but putting them here helps "dependency finder"
@@ -407,21 +295,13 @@ except (ImportError, OSError):
 
 
 def packager_imports():
-    """Some additional imports that py2app/py2exe will want to see.
-
-    This function is never executed.
-    Some tools scan the source code for import statements.
-    """
+    """some additional imports that py2app/py2exe will want to see"""
     import atexit
     import numpy
     import OpenGL.GL
     import pygame.macosx
     import pygame.colordict
 
-    # lazy imports
-    import pygame.surfarray
-    import pygame.sndarray
-
 
 # make Rects pickleable
 
@@ -452,23 +332,14 @@ def __color_reduce(c):
 
 copyreg.pickle(Color, __color_reduce, __color_constructor)
 
+# Thanks for supporting pygame. Without support now, there won't be pygame later.
 if "PYGAME_HIDE_SUPPORT_PROMPT" not in os.environ:
-    import sysconfig
-
-    python_version = platform.python_version()
-
-    if (
-        sys.platform not in ("wasi", "emscripten")
-        and (sys.version_info >= (3, 13, 0))
-        and sysconfig.get_config_var("Py_GIL_DISABLED")
-    ):
-        python_version += f"t, {'' if sys._is_gil_enabled() else 'No '}GIL"
-
     print(
-        f"pygame-ce {ver} (SDL {'.'.join(map(str, get_sdl_version()))}, "
-        f"Python {python_version})"
+        "pygame {} (SDL {}.{}.{}, Python {}.{}.{})".format(  # pylint: disable=consider-using-f-string
+            ver, *get_sdl_version() + sys.version_info[0:3]
+        )
     )
-    del python_version, sysconfig
+    print("Hello from the pygame community. https://www.pygame.org/contribute.html")
 
 # cleanup namespace
-del pygame, os, sys, platform, MissingModule, copyreg, packager_imports
+del pygame, os, sys, MissingModule, copyreg, packager_imports
diff --git a/.venv/lib/python3.14/site-packages/pygame/__init__.pyi b/.venv/lib/python3.14/site-packages/pygame/__init__.pyi
index bf79ffa..2d26fd1 100644
--- a/.venv/lib/python3.14/site-packages/pygame/__init__.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/__init__.pyi
@@ -1,9 +1,13 @@
 # buildconfig/stubs/gen_stubs.py
 # A script to auto-generate locals.pyi, constants.pyi and __init__.pyi typestubs
 # IMPORTANT NOTE: Do not edit this file by hand!
-# ruff: noqa: I001
 
-from . import (
+
+from typing import Tuple, NoReturn
+
+def Overlay(format: int, size: Tuple[int, int]) -> NoReturn: ...
+
+from pygame import (
     display as display,
     draw as draw,
     event as event,
@@ -22,7 +26,9 @@ from . import (
     sprite as sprite,
     surfarray as surfarray,
     transform as transform,
+    fastevent as fastevent,
     scrap as scrap,
+    threads as threads,
     version as version,
     base as base,
     bufferproxy as bufferproxy,
@@ -35,14 +41,9 @@ from . import (
     surface as surface,
     surflock as surflock,
     sysfont as sysfont,
-    _debug as _debug,
-    system as system,
-    geometry as geometry,
-    window as window,
-    typing as typing,
 )
 
-from .rect import Rect as Rect, FRect as FRect
+from .rect import Rect as Rect
 from .surface import Surface as Surface, SurfaceType as SurfaceType
 from .color import Color as Color
 from .pixelarray import PixelArray as PixelArray
@@ -50,15 +51,7 @@ from .math import Vector2 as Vector2, Vector3 as Vector3
 from .cursors import Cursor as Cursor
 from .bufferproxy import BufferProxy as BufferProxy
 from .mask import Mask as Mask
-from ._debug import print_debug_info as print_debug_info
-from .event import Event as Event
-from .font import Font as Font
-from .mixer import Sound as Sound, Channel as Channel
-from .time import Clock as Clock
-from .joystick import Joystick as Joystick
-from .window import Window as Window
 from .base import (
-    __version__ as __version__,
     BufferError as BufferError,
     HAVE_NEWBUF as HAVE_NEWBUF,
     error as error,
@@ -78,7 +71,7 @@ from .rwobject import (
     encode_string as encode_string,
 )
 
-from .version import SDL as SDL, rev as rev, ver as ver, vernum as vernum
+from .version import SDL as SDL, rev as rev, ver as ver, vernum as vernum, ver as __version__
 from .constants import (
     ACTIVEEVENT as ACTIVEEVENT,
     ANYFORMAT as ANYFORMAT,
@@ -109,26 +102,10 @@ from .constants import (
     AUDIO_U16SYS as AUDIO_U16SYS,
     AUDIO_U8 as AUDIO_U8,
     BIG_ENDIAN as BIG_ENDIAN,
-    BLENDFACTOR_DST_ALPHA as BLENDFACTOR_DST_ALPHA,
-    BLENDFACTOR_DST_COLOR as BLENDFACTOR_DST_COLOR,
-    BLENDFACTOR_ONE as BLENDFACTOR_ONE,
-    BLENDFACTOR_ONE_MINUS_DST_ALPHA as BLENDFACTOR_ONE_MINUS_DST_ALPHA,
-    BLENDFACTOR_ONE_MINUS_DST_COLOR as BLENDFACTOR_ONE_MINUS_DST_COLOR,
-    BLENDFACTOR_ONE_MINUS_SRC_ALPHA as BLENDFACTOR_ONE_MINUS_SRC_ALPHA,
-    BLENDFACTOR_ONE_MINUS_SRC_COLOR as BLENDFACTOR_ONE_MINUS_SRC_COLOR,
-    BLENDFACTOR_SRC_ALPHA as BLENDFACTOR_SRC_ALPHA,
-    BLENDFACTOR_SRC_COLOR as BLENDFACTOR_SRC_COLOR,
-    BLENDFACTOR_ZERO as BLENDFACTOR_ZERO,
     BLENDMODE_ADD as BLENDMODE_ADD,
     BLENDMODE_BLEND as BLENDMODE_BLEND,
     BLENDMODE_MOD as BLENDMODE_MOD,
-    BLENDMODE_MUL as BLENDMODE_MUL,
     BLENDMODE_NONE as BLENDMODE_NONE,
-    BLENDOPERATION_ADD as BLENDOPERATION_ADD,
-    BLENDOPERATION_MAXIMUM as BLENDOPERATION_MAXIMUM,
-    BLENDOPERATION_MINIMUM as BLENDOPERATION_MINIMUM,
-    BLENDOPERATION_REV_SUBTRACT as BLENDOPERATION_REV_SUBTRACT,
-    BLENDOPERATION_SUBTRACT as BLENDOPERATION_SUBTRACT,
     BLEND_ADD as BLEND_ADD,
     BLEND_ALPHA_SDL2 as BLEND_ALPHA_SDL2,
     BLEND_MAX as BLEND_MAX,
@@ -189,10 +166,6 @@ from .constants import (
     CONTROLLER_BUTTON_START as CONTROLLER_BUTTON_START,
     CONTROLLER_BUTTON_X as CONTROLLER_BUTTON_X,
     CONTROLLER_BUTTON_Y as CONTROLLER_BUTTON_Y,
-    DIRECTION_BTT as DIRECTION_BTT,
-    DIRECTION_LTR as DIRECTION_LTR,
-    DIRECTION_RTL as DIRECTION_RTL,
-    DIRECTION_TTB as DIRECTION_TTB,
     DOUBLEBUF as DOUBLEBUF,
     DROPBEGIN as DROPBEGIN,
     DROPCOMPLETE as DROPCOMPLETE,
@@ -201,15 +174,6 @@ from .constants import (
     FINGERDOWN as FINGERDOWN,
     FINGERMOTION as FINGERMOTION,
     FINGERUP as FINGERUP,
-    FLASH_BRIEFLY as FLASH_BRIEFLY,
-    FLASH_CANCEL as FLASH_CANCEL,
-    FLASH_UNTIL_FOCUSED as FLASH_UNTIL_FOCUSED,
-    FLIP_HORIZONTAL as FLIP_HORIZONTAL,
-    FLIP_NONE as FLIP_NONE,
-    FLIP_VERTICAL as FLIP_VERTICAL,
-    FONT_CENTER as FONT_CENTER,
-    FONT_LEFT as FONT_LEFT,
-    FONT_RIGHT as FONT_RIGHT,
     FULLSCREEN as FULLSCREEN,
     GL_ACCELERATED_VISUAL as GL_ACCELERATED_VISUAL,
     GL_ACCUM_ALPHA_SIZE as GL_ACCUM_ALPHA_SIZE,
@@ -257,7 +221,6 @@ from .constants import (
     HWACCEL as HWACCEL,
     HWPALETTE as HWPALETTE,
     HWSURFACE as HWSURFACE,
-    IS_CE as IS_CE,
     JOYAXISMOTION as JOYAXISMOTION,
     JOYBALLMOTION as JOYBALLMOTION,
     JOYBUTTONDOWN as JOYBUTTONDOWN,
@@ -607,7 +570,6 @@ from .constants import (
     MULTIGESTURE as MULTIGESTURE,
     NOEVENT as NOEVENT,
     NOFRAME as NOFRAME,
-    NULL_VIDEODRIVER as NULL_VIDEODRIVER,
     NUMEVENTS as NUMEVENTS,
     OPENGL as OPENGL,
     OPENGLBLIT as OPENGLBLIT,
@@ -625,8 +587,6 @@ from .constants import (
     SCRAP_PPM as SCRAP_PPM,
     SCRAP_SELECTION as SCRAP_SELECTION,
     SCRAP_TEXT as SCRAP_TEXT,
-    SCROLL_ERASE as SCROLL_ERASE,
-    SCROLL_REPEAT as SCROLL_REPEAT,
     SHOWN as SHOWN,
     SRCALPHA as SRCALPHA,
     SRCCOLORKEY as SRCCOLORKEY,
@@ -646,9 +606,6 @@ from .constants import (
     SYSWMEVENT as SYSWMEVENT,
     TEXTEDITING as TEXTEDITING,
     TEXTINPUT as TEXTINPUT,
-    TEXTUREACCESS_STATIC as TEXTUREACCESS_STATIC,
-    TEXTUREACCESS_STREAMING as TEXTUREACCESS_STREAMING,
-    TEXTUREACCESS_TARGET as TEXTUREACCESS_TARGET,
     TIMER_RESOLUTION as TIMER_RESOLUTION,
     USEREVENT as USEREVENT,
     USEREVENT_DROPFILE as USEREVENT_DROPFILE,
@@ -667,8 +624,6 @@ from .constants import (
     WINDOWMAXIMIZED as WINDOWMAXIMIZED,
     WINDOWMINIMIZED as WINDOWMINIMIZED,
     WINDOWMOVED as WINDOWMOVED,
-    WINDOWPOS_CENTERED as WINDOWPOS_CENTERED,
-    WINDOWPOS_UNDEFINED as WINDOWPOS_UNDEFINED,
     WINDOWRESIZED as WINDOWRESIZED,
     WINDOWRESTORED as WINDOWRESTORED,
     WINDOWSHOWN as WINDOWSHOWN,
diff --git a/.venv/lib/python3.14/site-packages/pygame/__pyinstaller/hook-pygame.py b/.venv/lib/python3.14/site-packages/pygame/__pyinstaller/hook-pygame.py
index cc14dd0..01477b6 100644
--- a/.venv/lib/python3.14/site-packages/pygame/__pyinstaller/hook-pygame.py
+++ b/.venv/lib/python3.14/site-packages/pygame/__pyinstaller/hook-pygame.py
@@ -1,6 +1,6 @@
 """
 binaries hook for pygame seems to be required for pygame 2.0 Windows.
-Otherwise, some essential DLLs will not be transferred to the exe.
+Otherwise some essential DLLs will not be transferred to the exe.
 
 And also put hooks for datas, resources that pygame uses, to work
 correctly with pyinstaller
diff --git a/.venv/lib/python3.14/site-packages/pygame/_camera.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_camera.cpython-314-x86_64-linux-gnu.so
index 9f89a24..e773f31 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_camera.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_camera.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_camera_opencv.py b/.venv/lib/python3.14/site-packages/pygame/_camera_opencv.py
index cd81f3a..289bf7e 100644
--- a/.venv/lib/python3.14/site-packages/pygame/_camera_opencv.py
+++ b/.venv/lib/python3.14/site-packages/pygame/_camera_opencv.py
@@ -1,12 +1,39 @@
+"""pygame.camera backend that uses OpenCV.
+
+Uses the cv2 module opencv for python.
+See https://pypi.org/project/opencv-python/ for wheels version.
+
+python3 -m pip install opencv-python --user
+"""
+
+import sys
 import time
 
-import cv2
 import numpy
+import cv2
+
 import pygame
 
 
 def list_cameras():
-    return [0]
+    """ """
+    index = 0
+    device_idx = []
+    failed = 0
+
+    # Sometimes there are gaps between the device index.
+    # We keep trying max_gaps times.
+    max_gaps = 3
+
+    while failed < max_gaps:
+        vcap = cv2.VideoCapture(index)
+        if not vcap.read()[0]:
+            failed += 1
+        else:
+            device_idx.append(index)
+        vcap.release()
+        index += 1
+    return device_idx
 
 
 def list_cameras_darwin():
@@ -33,12 +60,20 @@ def list_cameras_darwin():
 
 
 class Camera:
-    # device should not have a default argument!!
-    # leaving here for compatibility, but I fixed the stubs.
-    def __init__(self, device=0, size=(640, 480), mode="RGB"):
+    def __init__(self, device=0, size=(640, 480), mode="RGB", api_preference=None):
+        """
+        api_preference - cv2.CAP_DSHOW cv2.CAP_V4L2 cv2.CAP_MSMF and others
+
+        # See https://docs.opencv.org/3.4/d4/d15/group__videoio__flags__base.html
+        """
         self._device_index = device
         self._size = size
 
+        self.api_preference = api_preference
+        if api_preference is not None and sys.platform == "win32":
+            # seems more compatible on windows?
+            self.api_preference = cv2.CAP_DSHOW
+
         if mode == "RGB":
             self._fmt = cv2.COLOR_BGR2RGB
         elif mode == "YUV":
@@ -51,13 +86,13 @@ class Camera:
         self._open = False
 
     # all of this could have been done in the constructor, but creating
-    # the VideoCapture is very time-consuming, so it makes more sense in the
+    # the VideoCapture is very time consuming, so it makes more sense in the
     # actual start() method
     def start(self):
         if self._open:
             return
 
-        self._cam = cv2.VideoCapture(self._device_index)
+        self._cam = cv2.VideoCapture(self._device_index, self.api_preference)
 
         if not self._cam.isOpened():
             raise ValueError("Could not open camera.")
@@ -161,7 +196,7 @@ class Camera:
 
 
 class CameraMac(Camera):
-    def __init__(self, device=0, size=(640, 480), mode="RGB"):
+    def __init__(self, device=0, size=(640, 480), mode="RGB", api_preference=None):
         if isinstance(device, int):
             _dev = device
         elif isinstance(device, str):
@@ -172,4 +207,4 @@ class CameraMac(Camera):
                 str(type(device)),
             )
 
-        super().__init__(_dev, size, mode)
+        super().__init__(_dev, size, mode, api_preference)
diff --git a/.venv/lib/python3.14/site-packages/pygame/_data_classes.py b/.venv/lib/python3.14/site-packages/pygame/_data_classes.py
deleted file mode 100644
index 53e717b..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_data_classes.py
+++ /dev/null
@@ -1,13 +0,0 @@
-from dataclasses import dataclass
-
-
-@dataclass(frozen=True)
-class PowerState:
-    battery_percent: int | None
-    battery_seconds: int | None
-    on_battery: bool
-    no_battery: bool
-    charging: bool
-    charged: bool
-    plugged_in: bool
-    has_battery: bool
diff --git a/.venv/lib/python3.14/site-packages/pygame/_debug.py b/.venv/lib/python3.14/site-packages/pygame/_debug.py
deleted file mode 100644
index 4e22952..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_debug.py
+++ /dev/null
@@ -1,186 +0,0 @@
-"""Debug functionality that allows for more useful issue reporting"""
-
-import importlib
-import platform
-import sys
-import traceback
-from os import environ
-
-from pygame.system import get_cpu_instruction_sets
-from pygame.version import ver
-
-
-def str_from_tuple(version_tuple):
-    """Converts a tuple like (2, 0, 20) into a string joined by periods
-
-    Args:
-        version_tuple: tuple(version_major, version_minor, version_patch)
-
-    Returns:
-       str: "major.minor.patch"
-    """
-    if version_tuple is None:
-        return "None"
-
-    strs = map(str, version_tuple)
-    return ".".join(strs)
-
-
-def attempt_import(module, function_name, output_str=""):
-    """Attempts to import function_name from module
-
-    Args:
-        module: string representing module name
-        function_name: string representing function name to be imported
-        output_str: optional string to prepend error messages to if one occurs
-
-    Returns:
-        tuple(str, bool, Any):
-            [0]: output_str + error_message
-            [1]: True if successful, False if failed
-            [2]: if successful, the thing that was imported, else None
-    """
-    try:
-        mod = importlib.import_module(module)
-        i = getattr(mod, function_name)
-        success = True
-    except (ImportError, AttributeError):
-        i = None
-        output_str += f"There was a problem with {module} import\n"
-        output_str += "A default value will be returned for the version\n"
-        output_str += traceback.format_exc() + "\n" + "=" * 20 + "\n"
-        success = False
-
-    return (output_str, success, i)
-
-
-def _get_platform_info():
-    """
-    Internal helper to get platform information
-    """
-    cpu_inst_dict = get_cpu_instruction_sets()
-    sse2 = "Yes" if cpu_inst_dict["SSE2"] else "No"
-    avx2 = "Yes" if cpu_inst_dict["AVX2"] else "No"
-    neon = "Yes" if cpu_inst_dict["NEON"] else "No"
-    ret = f"Platform:\t\t{platform.platform()}\n"
-    ret += f"System:\t\t\t{platform.system()}\n"
-    ret += f"System Version:\t\t{platform.version()}\n"
-    ret += f"Processor:\t\t{platform.processor()}\tSSE2: {sse2}\tAVX2: {avx2}\tNEON: {neon}\n"
-    ret += (
-        f"Architecture:\t\tBits: {platform.architecture()[0]}\t"
-        f"Linkage: {platform.architecture()[1]}\n\n"
-    )
-
-    ret += f"Python:\t\t\t{platform.python_implementation()} {sys.version}\n"
-    ret += (
-        f"GIL Enabled:\t\t{sys._is_gil_enabled()}\n"
-        if hasattr(sys, "_is_gil_enabled")
-        else "GIL Enabled:\t\tTrue\n"
-    )
-    ret += f"pygame version:\t\t{ver}\n"
-    return ret
-
-
-def print_debug_info(filename=None):
-    """Gets debug information for reporting bugs. Prints to console
-    if filename is not specified, otherwise writes to that file
-    (note: if filename is not an empty file, it will overwrite whatever is
-    in there)
-
-    Args:
-        filename: string name of the file to save
-    """
-    debug_str = ""
-
-    # keyword for compat with getters
-    def default_return(linked=True):
-        # pylint: disable=unused-argument
-        return (-1, -1, -1)
-
-    from pygame.base import get_sdl_version
-    from pygame.display import (
-        get_driver as get_display_driver,
-        get_init as display_init,
-    )
-
-    debug_str, *mixer = attempt_import("pygame.mixer", "get_driver", debug_str)
-    get_mixer_driver = mixer[1] if mixer[0] else lambda: None
-
-    debug_str, *mixer = attempt_import("pygame.mixer", "get_init", debug_str)
-    mixer_init = mixer[1] if mixer[0] else lambda: False
-
-    debug_str, *mixer = attempt_import(
-        "pygame.mixer", "get_sdl_mixer_version", debug_str
-    )
-    get_sdl_mixer_version = mixer[1] if mixer[0] else default_return
-
-    debug_str, *font = attempt_import("pygame.font", "get_sdl_ttf_version", debug_str)
-    if not font[0]:
-        get_sdl_ttf_version = default_return
-    else:
-        get_sdl_ttf_version = font[1]
-
-    debug_str, *image = attempt_import(
-        "pygame.image", "get_sdl_image_version", debug_str
-    )
-    if not image[0]:
-        get_sdl_image_version = default_return
-    else:
-        get_sdl_image_version = image[1]
-
-    debug_str, *freetype = attempt_import("pygame.freetype", "get_version", debug_str)
-    if not freetype[0]:
-        ft_version = default_return
-    else:
-        ft_version = freetype[1]
-
-    debug_str += _get_platform_info()
-
-    debug_str += (
-        f"SDL versions:\t\tLinked: {str_from_tuple(get_sdl_version())}\t"
-        f"Compiled: {str_from_tuple(get_sdl_version(linked=False))}\n"
-    )
-
-    debug_str += (
-        f"SDL Mixer versions:\tLinked: {str_from_tuple(get_sdl_mixer_version())}\t"
-        f"Compiled: {str_from_tuple(get_sdl_mixer_version(linked=False))}\n"
-    )
-
-    debug_str += (
-        f"SDL Font versions:\tLinked: {str_from_tuple(get_sdl_ttf_version())}\t"
-        f"Compiled: {str_from_tuple(get_sdl_ttf_version(linked=False))}\n"
-    )
-
-    debug_str += (
-        f"SDL Image versions:\tLinked: {str_from_tuple(get_sdl_image_version())}\t"
-        f"Compiled: {str_from_tuple(get_sdl_image_version(linked=False))}\n"
-    )
-
-    debug_str += (
-        f"Freetype versions:\tLinked: {str_from_tuple(ft_version())}\t"
-        f"Compiled: {str_from_tuple(ft_version(linked=False))}\n\n"
-    )
-
-    if display_init():
-        driver = get_display_driver()
-        if driver.upper() != "X11":
-            debug_str += f"Display Driver:\t\t{driver}\n"
-        else:
-            is_xwayland = (environ.get("XDG_SESSION_TYPE") == "wayland") or (
-                "WAYLAND_DISPLAY" in environ
-            )
-            debug_str += f"Display Driver:\t\t{driver} ( xwayland == {is_xwayland} )\n"
-    else:
-        debug_str += "Display Driver:\t\tDisplay Not Initialized\n"
-
-    if mixer_init():
-        debug_str += f"Mixer Driver:\t\t{get_mixer_driver()}"
-    else:
-        debug_str += "Mixer Driver:\t\tMixer Not Initialized"
-
-    if filename is None:
-        print(debug_str)
-
-    else:
-        with open(filename, "w", encoding="utf8") as debugfile:
-            debugfile.write(debug_str)
diff --git a/.venv/lib/python3.14/site-packages/pygame/_debug.pyi b/.venv/lib/python3.14/site-packages/pygame/_debug.pyi
deleted file mode 100644
index 61aecb1..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_debug.pyi
+++ /dev/null
@@ -1,7 +0,0 @@
-from collections.abc import Callable
-
-def str_from_tuple(version_tuple: tuple[int, int, int] | None) -> str: ...
-def attempt_import(
-    module: str, function_name: str, output_str: str = ""
-) -> tuple[str, bool, Callable | None]: ...
-def print_debug_info(filename: str | None = None) -> None: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/_freetype.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_freetype.cpython-314-x86_64-linux-gnu.so
index 7cd9b0c..3153ed8 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_freetype.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_freetype.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_render.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_render.cpython-314-x86_64-linux-gnu.so
deleted file mode 100755
index 519a256..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/_render.cpython-314-x86_64-linux-gnu.so and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_render.pyi b/.venv/lib/python3.14/site-packages/pygame/_render.pyi
deleted file mode 100644
index 907bda2..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_render.pyi
+++ /dev/null
@@ -1,148 +0,0 @@
-from collections.abc import Iterable
-from typing import Any, Protocol, final
-
-from pygame.color import Color
-from pygame.rect import Rect
-from pygame.surface import Surface
-from pygame.typing import ColorLike, IntPoint, Point, RectLike, SequenceLike
-from pygame.window import Window
-
-class _DrawableClass(Protocol):
-    # Object that has the draw method that accepts area and dest arguments
-    def draw(self, area: RectLike | None = None, dest: RectLike | None = None): ...
-
-@final
-class Renderer:
-    def __init__(
-        self,
-        window: Window,
-        index: int = -1,
-        accelerated: int = -1,
-        vsync: bool = False,
-        target_texture: bool = False,
-    ) -> None: ...
-    def blit(
-        self,
-        source: "Texture" | "Image" | _DrawableClass,
-        dest: RectLike | None = None,
-        area: RectLike | None = None,
-        special_flags: int = 0,
-    ) -> Rect: ...
-    def clear(self) -> None: ...
-    def draw_line(self, p1: Point, p2: Point) -> None: ...
-    def draw_point(self, point: Point) -> None: ...
-    def draw_quad(self, p1: Point, p2: Point, p3: Point, p4: Point) -> None: ...
-    def draw_rect(self, rect: RectLike) -> None: ...
-    def draw_triangle(self, p1: Point, p2: Point, p3: Point) -> None: ...
-    def fill_quad(self, p1: Point, p2: Point, p3: Point, p4: Point) -> None: ...
-    def fill_rect(self, rect: RectLike) -> None: ...
-    def fill_triangle(self, p1: Point, p2: Point, p3: Point) -> None: ...
-    def get_viewport(self) -> Rect: ...
-    def coordinates_to_window(self, point: Point) -> tuple[float, float]: ...
-    def coordinates_from_window(self, point: Point) -> tuple[float, float]: ...
-    def present(self) -> None: ...
-    def set_viewport(self, area: RectLike | None) -> None: ...
-    def to_surface(
-        self, surface: Surface | None = None, area: RectLike | None = None
-    ) -> Surface: ...
-    @property
-    def draw_blend_mode(self) -> int: ...
-    @draw_blend_mode.setter
-    def draw_blend_mode(self, value: int) -> None: ...
-    @property
-    def draw_color(self) -> Color: ...
-    @draw_color.setter
-    def draw_color(self, value: ColorLike) -> None: ...
-    @property
-    def logical_size(self) -> tuple[int, int]: ...
-    @logical_size.setter
-    def logical_size(self, value: IntPoint) -> None: ...
-    @property
-    def scale(self) -> tuple[float, float]: ...
-    @scale.setter
-    def scale(self, value: Point) -> None: ...
-    @property
-    def target(self) -> "Texture": ...
-    @target.setter
-    def target(self, value: "Texture") -> None: ...
-    @classmethod
-    def compose_custom_blend_mode(
-        cls, color_mode: SequenceLike[int], alpha_mode: SequenceLike[int]
-    ) -> int: ...
-    @classmethod
-    def from_window(cls, window: Window) -> Renderer: ...
-
-@final
-class Texture:
-    def __init__(
-        self,
-        renderer: Renderer,
-        size: Iterable[int],
-        depth: int = 0,
-        static: bool = False,
-        streaming: bool = False,
-        target: bool = False,
-        scale_quality: int | None = None,
-    ) -> None: ...
-    @property
-    def alpha(self) -> int: ...
-    @alpha.setter
-    def alpha(self, value: int) -> None: ...
-    @property
-    def blend_mode(self) -> int: ...
-    @blend_mode.setter
-    def blend_mode(self, value: int) -> None: ...
-    @property
-    def color(self) -> Color: ...
-    @color.setter
-    def color(self, value: ColorLike) -> None: ...
-    @property
-    def width(self) -> int: ...
-    @property
-    def height(self) -> int: ...
-    @property
-    def renderer(self) -> Renderer: ...
-    @classmethod
-    def from_surface(cls, renderer: Renderer, surface: Surface) -> Texture: ...
-    def draw(
-        self,
-        srcrect: RectLike | None = None,
-        dstrect: RectLike | None = None,
-        angle: float = 0.0,
-        origin: Iterable[int] | None = None,
-        flip_x: bool = False,
-        flip_y: bool = False,
-    ) -> None: ...
-    def draw_triangle(
-        self,
-        p1_xy: Point,
-        p2_xy: Point,
-        p3_xy: Point,
-        p1_uv: Point = (0.0, 0.0),
-        p2_uv: Point = (1.0, 1.0),
-        p3_uv: Point = (0.0, 1.0),
-        p1_mod: ColorLike = (255, 255, 255, 255),
-        p2_mod: ColorLike = (255, 255, 255, 255),
-        p3_mod: ColorLike = (255, 255, 255, 255),
-    ) -> None: ...
-    def draw_quad(
-        self,
-        p1_xy: Point,
-        p2_xy: Point,
-        p3_xy: Point,
-        p4_xy: Point,
-        p1_uv: Point = (0.0, 0.0),
-        p2_uv: Point = (1.0, 0.0),
-        p3_uv: Point = (1.0, 1.0),
-        p4_uv: Point = (0.0, 1.0),
-        p1_mod: ColorLike = (255, 255, 255, 255),
-        p2_mod: ColorLike = (255, 255, 255, 255),
-        p3_mod: ColorLike = (255, 255, 255, 255),
-        p4_mod: ColorLike = (255, 255, 255, 255),
-    ) -> None: ...
-    def get_rect(self, **kwargs: Any) -> Rect: ...
-    def update(self, surface: Surface, area: RectLike | None = None) -> None: ...
-
-@final
-class Image:
-    pass
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/__init__.py b/.venv/lib/python3.14/site-packages/pygame/_sdl2/__init__.py
index 6ad3b1b..b08b716 100644
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/__init__.py
+++ b/.venv/lib/python3.14/site-packages/pygame/_sdl2/__init__.py
@@ -1,4 +1,3 @@
-if __import__("sys").platform not in ("wasi", "emscripten"):
-    from .audio import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
-    from .sdl2 import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
-    from .video import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
+from .sdl2 import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
+from .audio import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
+from .video import *  # pylint: disable=wildcard-import; lgtm[py/polluting-import]
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.cpython-314-x86_64-linux-gnu.so
index b1e9319..b678260 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.pyi b/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.pyi
index 0068b73..332f645 100644
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/_sdl2/audio.pyi
@@ -1,5 +1,4 @@
-from collections.abc import Callable
-from typing import Optional
+from typing import Callable, List
 
 AUDIO_U8: int
 AUDIO_S8: int
@@ -21,12 +20,12 @@ AUDIO_ALLOW_FORMAT_CHANGE: int
 AUDIO_ALLOW_CHANNELS_CHANGE: int
 AUDIO_ALLOW_ANY_CHANGE: int
 
-def get_audio_device_names(iscapture: bool = False) -> list[str]: ...
+def get_audio_device_names(iscapture: bool = False) -> List[str]: ...
 
 class AudioDevice:
     def __init__(
         self,
-        devicename: Optional[str],
+        devicename: str,
         iscapture: bool,
         frequency: int,
         audioformat: int,
@@ -40,7 +39,7 @@ class AudioDevice:
     @property
     def deviceid(self) -> int: ...
     @property
-    def devicename(self) -> Optional[str]: ...
+    def devicename(self) -> str: ...
     @property
     def callback(self) -> Callable[[AudioDevice, memoryview], None]: ...
     @property
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.cpython-314-x86_64-linux-gnu.so
index b75de8d..821d120 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.pyi b/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.pyi
index b924986..3810fbb 100644
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller.pyi
@@ -1,34 +1,35 @@
-from typing import final
+from typing import Dict, Mapping, Optional
 
 from pygame.joystick import JoystickType
-from pygame.typing import ColorLike
 
 def init() -> None: ...
 def get_init() -> bool: ...
 def quit() -> None: ...
-def is_controller(device_index: int) -> bool: ...
+def set_eventstate(state: bool) -> None: ...
+def get_eventstate() -> bool: ...
+def update() -> None: ...
 def get_count() -> int: ...
-@final
+def is_controller(index: int) -> bool: ...
+def name_forindex(index: int) -> Optional[str]: ...
+
 class Controller:
-    def __new__(cls, device_index: int) -> Controller: ...
-    def __init__(self, device_index: int) -> None: ...
-    @classmethod
-    def from_joystick(cls, joystick: JoystickType) -> Controller: ...
-    def get_init(self) -> bool: ...
-    def init(self) -> None: ...
-    def quit(self) -> None: ...
-    @property
-    def id(self) -> int: ...
+    def __init__(self, index: int) -> None: ...
     @property
     def name(self) -> str: ...
+    @property
+    def id(self) -> int: ...
+    def init(self) -> None: ...
+    def get_init(self) -> bool: ...
+    def quit(self) -> None: ...
+    @staticmethod
+    def from_joystick(joy: JoystickType) -> Controller: ...
     def attached(self) -> bool: ...
     def as_joystick(self) -> JoystickType: ...
     def get_axis(self, axis: int) -> int: ...
     def get_button(self, button: int) -> bool: ...
-    def get_mapping(self) -> dict[str, str]: ...
-    def set_mapping(self, mapping: dict[str, str]) -> int: ...
+    def get_mapping(self) -> Dict[str, str]: ...
+    def set_mapping(self, mapping: Mapping[str, str]) -> int: ...
     def rumble(
         self, low_frequency: float, high_frequency: float, duration: int
     ) -> bool: ...
     def stop_rumble(self) -> None: ...
-    def set_led(self, color: ColorLike, /) -> bool: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller_old.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller_old.cpython-314-x86_64-linux-gnu.so
deleted file mode 100755
index 746a066..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller_old.cpython-314-x86_64-linux-gnu.so and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller_old.pyi b/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller_old.pyi
deleted file mode 100644
index 2337555..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/controller_old.pyi
+++ /dev/null
@@ -1,35 +0,0 @@
-from collections.abc import Mapping
-
-from pygame.joystick import JoystickType
-
-def init() -> None: ...
-def get_init() -> bool: ...
-def quit() -> None: ...
-def set_eventstate(state: bool) -> None: ...
-def get_eventstate() -> bool: ...
-def update() -> None: ...
-def get_count() -> int: ...
-def is_controller(index: int) -> bool: ...
-def name_forindex(index: int) -> str | None: ...
-
-class Controller:
-    def __init__(self, index: int) -> None: ...
-    @property
-    def name(self) -> str: ...
-    @property
-    def id(self) -> int: ...
-    def init(self) -> None: ...
-    def get_init(self) -> bool: ...
-    def quit(self) -> None: ...
-    @staticmethod
-    def from_joystick(joy: JoystickType) -> Controller: ...
-    def attached(self) -> bool: ...
-    def as_joystick(self) -> JoystickType: ...
-    def get_axis(self, axis: int) -> int: ...
-    def get_button(self, button: int) -> bool: ...
-    def get_mapping(self) -> dict[str, str]: ...
-    def set_mapping(self, mapping: Mapping[str, str]) -> int: ...
-    def rumble(
-        self, low_frequency: float, high_frequency: float, duration: int
-    ) -> bool: ...
-    def stop_rumble(self) -> None: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/mixer.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_sdl2/mixer.cpython-314-x86_64-linux-gnu.so
index 9713b70..4d4c03a 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_sdl2/mixer.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_sdl2/mixer.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.cpython-314-x86_64-linux-gnu.so
index 5eb6173..3f95843 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.pyi b/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.pyi
index aab925d..8a2b622 100644
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/_sdl2/sdl2.pyi
@@ -1,3 +1,5 @@
+from typing import Optional
+
 INIT_TIMER: int
 INIT_AUDIO: int
 INIT_VIDEO: int
@@ -9,6 +11,6 @@ INIT_NOPARACHUTE: int
 INIT_EVERYTHING: int
 
 class error(RuntimeError):
-    def __init__(self, message: str | None = None) -> None: ...
+    def __init__(self, message: Optional[str] = None) -> None: ...
 
 def init_subsystem(flags: int) -> None: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.cpython-314-x86_64-linux-gnu.so
index 85213d9..f0a30c8 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.pyi b/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.pyi
index 1f33b2f..93e2745 100644
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/_sdl2/touch.pyi
@@ -1,12 +1,6 @@
-from typing import TypedDict
-
-class _FingerDict(TypedDict):
-    id: int
-    x: float
-    y: float
-    pressure: float
+from typing import Dict, Union
 
 def get_num_devices() -> int: ...
-def get_device(index: int, /) -> int: ...
-def get_num_fingers(device_id: int, /) -> int: ...
-def get_finger(touchid: int, index: int) -> _FingerDict | None: ...
+def get_device(index: int) -> int: ...
+def get_num_fingers(device_id: int) -> int: ...
+def get_finger(touchid: int, index: int) -> Dict[str, Union[int, float]]: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.cpython-314-x86_64-linux-gnu.so
index 06b63e1..8eeaa0b 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.pyi b/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.pyi
index f8c8b30..a2d4afe 100644
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/_sdl2/video.pyi
@@ -1,18 +1,16 @@
-from collections.abc import Generator, Iterable
-from typing import Any
+from typing import Any, Generator, Iterable, Optional, Tuple, Union
 
-from pygame.color import Color
 from pygame.rect import Rect
 from pygame.surface import Surface
-from pygame.typing import ColorLike, Point, RectLike
-from pygame.window import Window as Window
+
+from .._common import RectValue, Literal, ColorValue
 
 WINDOWPOS_UNDEFINED: int
 WINDOWPOS_CENTERED: int
 
-SCALEQUALITY_NEAREST: int
-SCALEQUALITY_LINEAR: int
-SCALEQUALITY_BEST: int
+MESSAGEBOX_ERROR: int
+MESSAGEBOX_WARNING: int
+MESSAGEBOX_INFORMATION: int
 
 class RendererDriverInfo:
     name: str
@@ -22,18 +20,64 @@ class RendererDriverInfo:
     max_texture_height: int
 
 def get_drivers() -> Generator[RendererDriverInfo, None, None]: ...
-def get_grabbed_window() -> Window | None: ...
+def get_grabbed_window() -> Optional[Window]: ...
+def messagebox(
+    title: str,
+    message: str,
+    window: Optional[Window] = None,
+    info: bool = False,
+    warn: bool = False,
+    error: bool = False,
+    buttons: Tuple[str, ...] = ("OK",),
+    return_button: int = 0,
+    escape_button: int = 0,
+) -> int: ...
+
+class Window:
+    DEFAULT_SIZE: Tuple[Literal[640], Literal[480]]
+    def __init__(
+        self,
+        title: str = "pygame",
+        size: Iterable[int] = (640, 480),
+        position: Optional[Iterable[int]] = None,
+        fullscreen: bool = False,
+        fullscreen_desktop: bool = False,
+        **kwargs: bool
+    ) -> None: ...
+    @classmethod
+    def from_display_module(cls) -> Window: ...
+    @classmethod
+    def from_window(cls, other: int) -> Window: ...
+    grab: bool
+    relative_mouse: bool
+    def set_windowed(self) -> None: ...
+    def set_fullscreen(self, desktop: bool = False) -> None: ...
+    title: str
+    def destroy(self) -> None: ...
+    def hide(self) -> None: ...
+    def show(self) -> None: ...
+    def focus(self, input_only: bool = False) -> None: ...
+    def restore(self) -> None: ...
+    def maximize(self) -> None: ...
+    def minimize(self) -> None: ...
+    resizable: bool
+    borderless: bool
+    def set_icon(self, surface: Surface) -> None: ...
+    id: int
+    size: Iterable[int]
+    position: Union[int, Iterable[int]]
+    opacity: float
+    display_index: int
+    def set_modal_for(self, parent: Window) -> None: ...
 
 class Texture:
     def __init__(
         self,
         renderer: Renderer,
         size: Iterable[int],
-        depth: int = 0,
         static: bool = False,
         streaming: bool = False,
         target: bool = False,
-        scale_quality: int | None = None,
     ) -> None: ...
     @staticmethod
     def from_surface(renderer: Renderer, surface: Surface) -> Texture: ...
@@ -42,74 +86,39 @@ class Texture:
     height: int
     alpha: int
     blend_mode: int
-
-    @property
-    def color(self) -> Color: ...
-    @color.setter
-    def color(self, value: ColorLike) -> None: ...
+    color: ColorValue
     def get_rect(self, **kwargs: Any) -> Rect: ...
     def draw(
         self,
-        srcrect: RectLike | None = None,
-        dstrect: RectLike | None = None,
+        srcrect: Optional[RectValue] = None,
+        dstrect: Optional[RectValue] = None,
         angle: float = 0.0,
-        origin: Iterable[int] | None = None,
+        origin: Optional[Iterable[int]] = None,
         flip_x: bool = False,
         flip_y: bool = False,
     ) -> None: ...
-    def draw_triangle(
-        self,
-        p1_xy: Point,
-        p2_xy: Point,
-        p3_xy: Point,
-        p1_uv: Point = (0.0, 0.0),
-        p2_uv: Point = (1.0, 1.0),
-        p3_uv: Point = (0.0, 1.0),
-        p1_mod: Iterable[int] = (255, 255, 255, 255),
-        p2_mod: Iterable[int] = (255, 255, 255, 255),
-        p3_mod: Iterable[int] = (255, 255, 255, 255),
-    ) -> None: ...
-    def draw_quad(
-        self,
-        p1_xy: Point,
-        p2_xy: Point,
-        p3_xy: Point,
-        p4_xy: Point,
-        p1_uv: Point = (0.0, 0.0),
-        p2_uv: Point = (1.0, 0.0),
-        p3_uv: Point = (1.0, 1.0),
-        p4_uv: Point = (0.0, 1.0),
-        p1_mod: Iterable[int] = (255, 255, 255, 255),
-        p2_mod: Iterable[int] = (255, 255, 255, 255),
-        p3_mod: Iterable[int] = (255, 255, 255, 255),
-        p4_mod: Iterable[int] = (255, 255, 255, 255),
-    ) -> None: ...
-    def update(self, surface: Surface, area: RectLike | None = None) -> None: ...
+    def update(self, surface: Surface, area: Optional[RectValue] = None) -> None: ...
 
 class Image:
     def __init__(
         self,
-        texture_or_image: Texture | Image,
-        srcrect: RectLike | None = None,
+        textureOrImage: Union[Texture, Image],
+        srcrect: Optional[RectValue] = None,
     ) -> None: ...
-    def get_rect(self) -> Rect: ...
+    def get_rect(self, **kwargs: Any) -> Rect: ...
     def draw(
-        self, srcrect: RectLike | None = None, dstrect: RectLike | None = None
+        self, srcrect: Optional[RectValue] = None, dstrect: Optional[RectValue] = None
     ) -> None: ...
     angle: float
-    origin: Iterable[float] | None
+    origin: Optional[Iterable[float]]
     flip_x: bool
     flip_y: bool
+    color: ColorValue
     alpha: float
     blend_mode: int
     texture: Texture
     srcrect: Rect
 
-    @property
-    def color(self) -> Color: ...
-    @color.setter
-    def color(self, value: ColorLike) -> None: ...
-
 class Renderer:
     def __init__(
         self,
@@ -122,38 +131,29 @@ class Renderer:
     @classmethod
     def from_window(cls, window: Window) -> Renderer: ...
     draw_blend_mode: int
-    @property
-    def draw_color(self) -> Color: ...
-    @draw_color.setter
-    def draw_color(self, value: ColorLike) -> None: ...
+    draw_color: ColorValue
     def clear(self) -> None: ...
     def present(self) -> None: ...
     def get_viewport(self) -> Rect: ...
-    def set_viewport(self, area: RectLike | None) -> None: ...
+    def set_viewport(self, area: Optional[RectValue]) -> None: ...
     logical_size: Iterable[int]
-    def coordinates_to_window(self, point: Point) -> tuple[float, float]: ...
-    def coordinates_from_window(self, point: Point) -> tuple[float, float]: ...
     scale: Iterable[float]
-    target: Texture | None
+    target: Optional[Texture]
     def blit(
         self,
-        source: Texture | Image,
-        dest: RectLike | None = None,
-        area: RectLike | None = None,
+        source: Union[Texture, Image],
+        dest: Optional[RectValue] = None,
+        area: Optional[RectValue] = None,
         special_flags: int = 0,
     ) -> Rect: ...
-    def draw_line(self, p1: Point, p2: Point) -> None: ...
-    def draw_point(self, point: Point) -> None: ...
-    def draw_rect(self, rect: RectLike) -> None: ...
-    def fill_rect(self, rect: RectLike) -> None: ...
-    def draw_triangle(self, p1: Point, p2: Point, p3: Point) -> None: ...
-    def fill_triangle(self, p1: Point, p2: Point, p3: Point) -> None: ...
-    def draw_quad(self, p1: Point, p2: Point, p3: Point, p4: Point) -> None: ...
-    def fill_quad(self, p1: Point, p2: Point, p3: Point, p4: Point) -> None: ...
+    def draw_line(self, p1: Iterable[int], p2: Iterable[int]) -> None: ...
+    def draw_point(self, point: Iterable[int]) -> None: ...
+    def draw_rect(self, rect: RectValue) -> None: ...
+    def fill_rect(self, rect: RectValue) -> None: ...
     def to_surface(
-        self, surface: Surface | None = None, area: RectLike | None = None
+        self, surface: Optional[Surface] = None, area: Optional[RectValue] = None
     ) -> Surface: ...
     @staticmethod
     def compose_custom_blend_mode(
-        color_mode: tuple[int, int, int], alpha_mode: tuple[int, int, int]
+        color_mode: Tuple[int, int, int], alpha_mode: Tuple[int, int, int]
     ) -> int: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/window.py b/.venv/lib/python3.14/site-packages/pygame/_sdl2/window.py
deleted file mode 100644
index 675b566..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/window.py
+++ /dev/null
@@ -1 +0,0 @@
-from .video import Window  # pylint: disable=wildcard-import
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sdl2/window.pyi b/.venv/lib/python3.14/site-packages/pygame/_sdl2/window.pyi
deleted file mode 100644
index 4bb5c12..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_sdl2/window.pyi
+++ /dev/null
@@ -1 +0,0 @@
-from pygame._sdl2.video import Window as Window
diff --git a/.venv/lib/python3.14/site-packages/pygame/_sprite.py b/.venv/lib/python3.14/site-packages/pygame/_sprite.py
deleted file mode 100644
index b97e45d..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/_sprite.py
+++ /dev/null
@@ -1,28 +0,0 @@
-import warnings
-
-warnings.warn(
-    "The ._sprite submodule is deprecated since 2.4.0. Please use pygame.sprite instead.",
-    category=DeprecationWarning,
-    stacklevel=2,
-)
-
-from pygame.sprite import (
-    AbstractGroup,
-    DirtySprite,
-    Group,
-    GroupSingle,
-    LayeredDirty,
-    LayeredUpdates,
-    RenderClear,
-    RenderPlain,
-    RenderUpdates,
-    Sprite,
-    collide_circle,
-    collide_circle_ratio,
-    collide_mask,
-    collide_rect,
-    collide_rect_ratio,
-    groupcollide,
-    spritecollide,
-    spritecollideany,
-)
diff --git a/.venv/lib/python3.14/site-packages/pygame/base.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/base.cpython-314-x86_64-linux-gnu.so
index 1eddb0e..5921c4a 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/base.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/base.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/base.pyi b/.venv/lib/python3.14/site-packages/pygame/base.pyi
index b974235..c641e36 100644
--- a/.venv/lib/python3.14/site-packages/pygame/base.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/base.pyi
@@ -1,7 +1,4 @@
-from collections.abc import Callable
-from typing import Any
-
-__version__: str
+from typing import Any, Tuple, Callable
 
 class error(RuntimeError): ...
 class BufferError(Exception): ...
@@ -9,14 +6,14 @@ class BufferError(Exception): ...
 # Always defined
 HAVE_NEWBUF: int = 1
 
-def init() -> tuple[int, int]: ...
+def init() -> Tuple[int, int]: ...
 def quit() -> None: ...
 def get_init() -> bool: ...
 def get_error() -> str: ...
-def set_error(error_msg: str, /) -> None: ...
-def get_sdl_version(linked: bool = True) -> tuple[int, int, int]: ...
+def set_error(error_msg: str) -> None: ...
+def get_sdl_version(linked: bool = True) -> Tuple[int, int, int]: ...
 def get_sdl_byteorder() -> int: ...
-def register_quit(callable: Callable[[], Any], /) -> None: ...
+def register_quit(callable: Callable[[], Any]) -> None: ...
 
 # undocumented part of pygame API, kept here to make stubtest happy
-def get_array_interface(arg: Any, /) -> dict: ...
+def get_array_interface(arg: Any) -> dict: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/bufferproxy.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/bufferproxy.cpython-314-x86_64-linux-gnu.so
index 78c9444..7680566 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/bufferproxy.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/bufferproxy.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/bufferproxy.pyi b/.venv/lib/python3.14/site-packages/pygame/bufferproxy.pyi
index f896bd0..b77eb46 100644
--- a/.venv/lib/python3.14/site-packages/pygame/bufferproxy.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/bufferproxy.pyi
@@ -1,27 +1,15 @@
-import sys
-from typing import Any
+from typing import Any, Dict, overload
 
 class BufferProxy:
-    @property
-    def parent(self) -> Any: ...
-    @property
-    def length(self) -> int: ...
-    @property
-    def raw(self) -> bytes: ...
+    parent: Any
+    length: int
+    raw: bytes
     # possibly going to be deprecated/removed soon, in which case these
     # typestubs must be removed too
-    @property
-    def __array_interface__(self) -> dict[str, Any]: ...
-    @property
-    def __array_struct__(self) -> Any: ...
-    if sys.version_info >= (3, 12):
-        def __buffer__(self, flags: int, /) -> memoryview[int]: ...
-        def __release_buffer__(self, view: memoryview[int], /) -> None: ...
-    def __new__(
-        cls, parent: Any
-    ) -> BufferProxy: ...  # TODO: parent: TypedDict | Protocol
-    def write(
-        self,
-        buffer: str | bytes,  # Any "read-only bytes-like-object" is valid
-        offset: int = 0,
-    ) -> None: ...
+    __array_interface__: Dict[str, Any]
+    __array_struct__: Any
+    @overload
+    def __init__(self) -> None: ...
+    @overload
+    def __init__(self, parent: Any) -> None: ...
+    def write(self, buffer: bytes, offset: int = 0) -> None: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/camera.py b/.venv/lib/python3.14/site-packages/pygame/camera.py
index 166eb9f..5f31c97 100644
--- a/.venv/lib/python3.14/site-packages/pygame/camera.py
+++ b/.venv/lib/python3.14/site-packages/pygame/camera.py
@@ -56,9 +56,7 @@ def _pre_init_placeholder_varargs(*_, **__):
 
 
 class _PreInitPlaceholderCamera(AbstractCamera):
-    def __init__(self, *args, **kwargs):
-        _pre_init_placeholder()
-
+    __init__ = _pre_init_placeholder_varargs
     start = _pre_init_placeholder_varargs
     stop = _pre_init_placeholder_varargs
     get_controls = _pre_init_placeholder_varargs
@@ -106,6 +104,20 @@ def _setup_backend(backend):
         list_cameras = _camera.list_cameras
         Camera = _camera.Camera
 
+    elif backend == "videocapture":
+        from pygame import _camera_vidcapture
+
+        warnings.warn(
+            "The VideoCapture backend is not recommended and may be removed."
+            "For Python3 and Windows 8+, there is now a native Windows "
+            "backend built into pygame.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+        _camera_vidcapture.init()
+        list_cameras = _camera_vidcapture.list_cameras
+        Camera = _camera_vidcapture.Camera
     else:
         raise ValueError("unrecognized backend name")
 
@@ -113,16 +125,34 @@ def _setup_backend(backend):
 def get_backends():
     possible_backends = []
 
-    if sys.platform == "win32" and int(platform.win32_ver()[0].split(".")[0]) >= 8:
-        possible_backends.append("_camera (MSMF)")
+    if sys.platform == "win32":
+        version_code = platform.win32_ver()[0].split(".")[0]
+        if "Server" in version_code:
+            version_code = ''.join(filter(str.isdigit, version_code))[:4]
+            minimum_satisfied = int(version_code) >= 2012
+        else:
+            minimum_satisfied = int(version_code) >= 8
 
-    if sys.platform == "linux":
+        if minimum_satisfied:
+            try:
+                # If cv2 is installed, prefer that on windows.
+                import cv2
+
+                possible_backends.append("OpenCV")
+            except ImportError:
+                possible_backends.append("_camera (MSMF)")
+
+    if "linux" in sys.platform:
         possible_backends.append("_camera (V4L2)")
 
     if "darwin" in sys.platform:
         possible_backends.append("OpenCV-Mac")
 
-    possible_backends.append("OpenCV")
+    if "OpenCV" not in possible_backends:
+        possible_backends.append("OpenCV")
+
+    if sys.platform == "win32":
+        possible_backends.append("VideoCapture")
 
     # see if we have any user specified defaults in environments.
     camera_env = os.environ.get("PYGAME_CAMERA", "").lower()
@@ -131,6 +161,11 @@ def get_backends():
             possible_backends.remove("OpenCV")
         possible_backends = ["OpenCV"] + possible_backends
 
+    if camera_env in ("vidcapture", "videocapture"):  # prioritize vidcapture
+        if "VideoCapture" in possible_backends:
+            possible_backends.remove("VideoCapture")
+        possible_backends = ["VideoCapture"] + possible_backends
+
     return possible_backends
 
 
@@ -155,8 +190,8 @@ def init(backend=None):
         _setup_backend(backend)
     except ImportError:
         emsg = f"Backend '{backend}' is not supported on your platform!"
-        if backend in ("opencv", "opencv-mac"):
-            dep = "OpenCV"
+        if backend in ("opencv", "opencv-mac", "videocapture"):
+            dep = "vidcap" if backend == "videocapture" else "OpenCV"
             emsg += (
                 f" Make sure you have '{dep}' installed to be able to use this backend"
             )
@@ -176,7 +211,7 @@ def quit():
 
 
 if __name__ == "__main__":
-    # try to use this camera stuff with the pygame camera example.
+    # try and use this camera stuff with the pygame camera example.
     import pygame.examples.camera
 
     # pygame.camera.Camera = Camera
diff --git a/.venv/lib/python3.14/site-packages/pygame/camera.pyi b/.venv/lib/python3.14/site-packages/pygame/camera.pyi
index fb2ca46..eb0360c 100644
--- a/.venv/lib/python3.14/site-packages/pygame/camera.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/camera.pyi
@@ -1,16 +1,12 @@
 from abc import ABC, abstractmethod
-from typing import Literal
+from typing import List, Optional, Sequence, Tuple, Union
 
 from pygame.surface import Surface
-from pygame.typing import IntPoint
 
-def get_backends() -> list[str]: ...
-def init(backend: str | None = None) -> None: ...
+def get_backends() -> List[str]: ...
+def init(backend: Optional[str] = None) -> None: ...
 def quit() -> None: ...
-def list_cameras() -> list[str] | list[int]: ...
-def colorspace(
-    surface: Surface, color: Literal["YUV", "HSV"], dest_surface: Surface = ..., /
-) -> Surface: ...
+def list_cameras() -> List[str]: ...
 
 class AbstractCamera(ABC):
     @abstractmethod
@@ -20,11 +16,11 @@ class AbstractCamera(ABC):
     @abstractmethod
     def stop(self) -> None: ...
     @abstractmethod
-    def get_size(self) -> tuple[int, int]: ...
+    def get_size(self) -> Tuple[int, int]: ...
     @abstractmethod
     def query_image(self) -> bool: ...
     @abstractmethod
-    def get_image(self, dest_surf: Surface | None = None) -> Surface: ...
+    def get_image(self, dest_surf: Optional[Surface] = None) -> Surface: ...
     @abstractmethod
     def get_raw(self) -> bytes: ...
     # set_controls and get_controls are not a part of the AbstractCamera ABC,
@@ -34,20 +30,20 @@ class AbstractCamera(ABC):
 class Camera(AbstractCamera):
     def __init__(
         self,
-        device: str | int,
-        size: IntPoint = (640, 480),
+        device: Union[str, int] = 0,
+        size: Union[Tuple[int, int], Sequence[int]] = (640, 480),
         format: str = "RGB",
     ) -> None: ...
     def start(self) -> None: ...
     def stop(self) -> None: ...
-    def get_controls(self) -> tuple[bool, bool, int]: ...
+    def get_controls(self) -> Tuple[bool, bool, int]: ...
     def set_controls(
         self,
         hflip: bool = ...,
         vflip: bool = ...,
         brightness: int = ...,
-    ) -> tuple[bool, bool, int]: ...
-    def get_size(self) -> tuple[int, int]: ...
+    ) -> Tuple[bool, bool, int]: ...
+    def get_size(self) -> Tuple[int, int]: ...
     def query_image(self) -> bool: ...
-    def get_image(self, surface: Surface | None = None) -> Surface: ...
+    def get_image(self, surface: Optional[Surface] = None) -> Surface: ...
     def get_raw(self) -> bytes: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/color.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/color.cpython-314-x86_64-linux-gnu.so
index b7305cd..ea259ad 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/color.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/color.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/color.pyi b/.venv/lib/python3.14/site-packages/pygame/color.pyi
index eb05035..93ed688 100644
--- a/.venv/lib/python3.14/site-packages/pygame/color.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/color.pyi
@@ -1,228 +1,36 @@
 import sys
-from collections.abc import Collection, Iterator
-from typing import Any, ClassVar, SupportsIndex, overload
+from typing import Any, Dict, Iterator, Tuple, overload
 
-from pygame.typing import ColorLike
-from typing_extensions import deprecated  # added in 3.13
+from ._common import ColorValue
 
-THECOLORS: dict[str, tuple[int, int, int, int]]
+if sys.version_info >= (3, 9):
+    from collections.abc import Collection
+else:
+    from typing import Collection
+
+THECOLORS: Dict[str, Tuple[int, int, int, int]]
 
 # Color confirms to the Collection ABC, since it also confirms to
 # Sized, Iterable and Container ABCs
 class Color(Collection[int]):
-    """Pygame object for color representations.
-
-    The ``Color`` class represents ``RGBA`` color values using a value range of
-    0 to 255 inclusive. It allows basic arithmetic operations — binary
-    operations ``+``, ``-``, ``*``, ``//``, ``%``, and unary operation ``~`` — to
-    create new colors, supports conversions to other color spaces such as ``HSV``
-    or ``HSL`` and lets you adjust single color channels.
-    Alpha defaults to 255 (fully opaque) when not given.
-    The arithmetic operations and ``correct_gamma()`` method preserve subclasses.
-    For the binary operators, the class of the returned color is that of the
-    left hand color object of the operator.
-
-    Color objects support swizzling for their ``RGBA`` attributes, which allows
-    the creation of new color objects with the corresponding swizzled attributes
-    as its ``RGBA`` attributes. For example, ``color.bgra`` provides a shortcut to
-    doing ``Color(color.b, color.g, color.r, color.a)``. Swizzling with other than
-    4 attributes will return a tuple consisting of the corresponding elements
-    instead of a color object.
-
-    Color objects support equality comparison with other color objects and 3 or
-    4 element tuples of integers. There was a bug in pygame 1.8.1
-    where the default alpha was 0, not 255 like previously.
-
-    Color objects export the C level array interface. The interface exports a
-    read-only one dimensional unsigned byte array of the same assigned length
-    as the color. The new buffer interface is also exported, with the same
-    characteristics as the array interface.
-
-    The floor division, ``//``, and modulus, ``%``, operators do not raise
-    an exception for division by zero. Instead, if a color, or alpha, channel
-    in the right hand color is 0, then the result is 0. For example: ::
-
-        # These expressions are True
-        Color(255, 255, 255, 255) // Color(0, 64, 64, 64) == Color(0, 3, 3, 3)
-        Color(255, 255, 255, 255) % Color(64, 64, 64, 0) == Color(63, 63, 63, 0)
-
-    Use ``int(color)`` to return the immutable integer value of the color,
-    usable as a ``dict`` key. This integer value differs from the mapped
-    pixel values of :meth:`pygame.Surface.get_at_mapped`,
-    :meth:`pygame.Surface.map_rgb` and :meth:`pygame.Surface.unmap_rgb`.
-    It can be passed as a ``color_value`` argument to :class:`Color`
-    (useful with sets).
-
-    See :doc:`color_list` for samples of the available named colors.
-
-    :param int r: red value in the range of 0 to 255 inclusive
-    :param int g: green value in the range of 0 to 255 inclusive
-    :param int b: blue value in the range of 0 to 255 inclusive
-    :param int a: (optional) alpha value in the range of 0 to 255 inclusive,
-        default is 255
-    :param color_value: color value (see note below for the supported formats)
-
-        .. note::
-            Supported ``color_value`` formats:
-
-            | - **Color object:** clones the given :class:`Color` object
-
-            | - **Color name: str:** name of the color to use, e.g. ``'red'``
-                (all the supported name strings can be found in the
-                :doc:`color_list`, with sample swatches)
-
-            | - **HTML color format str:** ``'#rrggbbaa'`` or ``'#rrggbb'``,
-                where rr, gg, bb, and aa are 2-digit hex numbers in the range
-                of 0 to 0xFF inclusive, the aa (alpha) value defaults to 0xFF
-                if not provided
-
-            | - **hex number str:** ``'0xrrggbbaa'`` or ``'0xrrggbb'``, where
-                rr, gg, bb, and aa are 2-digit hex numbers in the range of 0x00
-                to 0xFF inclusive, the aa (alpha) value defaults to 0xFF if not
-                provided
-
-            | - **int:** int value of the color to use, using hex numbers can
-                make this parameter more readable, e.g. ``0xrrggbbaa``, where rr,
-                gg, bb, and aa are 2-digit hex numbers in the range of 0x00 to
-                0xFF inclusive, note that the aa (alpha) value is not optional for
-                the int format and must be provided
-
-            | - **tuple/list of int color values:** ``(R, G, B, A)`` or
-                ``(R, G, B)``, where R, G, B, and A are int values in the range of
-                0 to 255 inclusive, the A (alpha) value defaults to 255 if not
-                provided
-
-    :type color_value: Color or str or int or tuple(int, int, int, [int]) or
-        list(int, int, int, [int])
-
-    :returns: a newly created :class:`Color` object
-    :rtype: Color
-
-    .. versionchanged:: 2.5.6
-        ``bytes(Color(...))`` (assuming `bytes `_ is
-        the built-in type) now returns a ``bytes`` object (of length 4) with the RGBA values of the color,
-        as opposed to :class:`Color` being interpreted as an integer (think ``int(Color(...))``) causing it
-        to return a ``bytes`` object filled with 0s the length of said integer.
-    .. versionchangedold:: 2.0.0
-        Support for tuples, lists, and :class:`Color` objects when creating
-        :class:`Color` objects.
-    .. versionchangedold:: 1.9.2 Color objects export the C level array interface.
-    .. versionchangedold:: 1.9.0 Color objects support 4-element tuples of integers.
-    .. versionchangedold:: 1.8.1 New implementation of the class.
-    """
-
     r: int
-    """Gets or sets the red value of the Color.
-
-    The red value of the Color.
-    """
-
     g: int
-    """Gets or sets the green value of the Color.
-
-    The green value of the Color.
-    """
-
     b: int
-    """Gets or sets the blue value of the Color.
-
-    The blue value of the Color.
-    """
-
     a: int
-    """Gets or sets the alpha value of the Color.
-
-    The alpha value of the Color.
-    """
-
-    cmy: tuple[float, float, float]
-    """Gets or sets the CMY representation of the Color.
-
-    The ``CMY`` representation of the Color. The ``CMY`` components are in
-    the ranges ``C`` = [0, 1], ``M`` = [0, 1], ``Y`` = [0, 1]. Note that this
-    will not return the absolutely exact ``CMY`` values for the set ``RGB``
-    values in all cases. Due to the ``RGB`` mapping from 0-255 and the
-    ``CMY`` mapping from 0-1 rounding errors may cause the ``CMY`` values to
-    differ slightly from what you might expect.
-    """
-
-    hsva: tuple[float, float, float, float]
-    """Gets or sets the HSVA representation of the Color.
-
-    The ``HSVA`` representation of the Color. The ``HSVA`` components are in
-    the ranges ``H`` = [0, 360], ``S`` = [0, 100], ``V`` = [0, 100], A = [0,
-    100]. Note that this will not return the absolutely exact ``HSV`` values
-    for the set ``RGB`` values in all cases. Due to the ``RGB`` mapping from
-    0-255 and the ``HSV`` mapping from 0-100 and 0-360 rounding errors may
-    cause the ``HSV`` values to differ slightly from what you might expect.
-    """
-
-    hsla: tuple[float, float, float, float]
-    """Gets or sets the HSLA representation of the Color.
-
-    The ``HSLA`` representation of the Color. The ``HSLA`` components are in
-    the ranges ``H`` = [0, 360], ``S`` = [0, 100], ``L`` = [0, 100], A = [0,
-    100]. Note that this will not return the absolutely exact ``HSL`` values
-    for the set ``RGB`` values in all cases. Due to the ``RGB`` mapping from
-    0-255 and the ``HSL`` mapping from 0-100 and 0-360 rounding errors may
-    cause the ``HSL`` values to differ slightly from what you might expect.
-    """
-
-    i1i2i3: tuple[float, float, float]
-    """Gets or sets the I1I2I3 representation of the Color.
-
-    The ``I1I2I3`` representation of the Color. The ``I1I2I3`` components are
-    in the ranges ``I1`` = [0, 1], ``I2`` = [-0.5, 0.5], ``I3`` = [-0.5,
-    0.5]. Note that this will not return the absolutely exact ``I1I2I3``
-    values for the set ``RGB`` values in all cases. Due to the ``RGB``
-    mapping from 0-255 and the ``I1I2I3`` mapping from 0-1 rounding errors
-    may cause the ``I1I2I3`` values to differ slightly from what you might
-    expect.
-    """
-
-    normalized: tuple[float, float, float, float]
-    """Gets or sets the normalized representation of the Color.
-
-    The ``Normalized`` representation of the Color. The components of the ``Normalized``
-    representation represent the basic ``RGBA`` values but normalized the
-    ranges of the values are ``r`` = [0, 1], ``g`` = [0, 1], ``b`` = [0, 1]
-    and ``a`` = [0, 1] respectively. Note that this will not return the absolutely exact
-    ``Normalized`` values for the set ``RGBA`` values in all cases.
-    Due to the ``RGB`` mapping from 0-255 and the ``Normalized`` mapping from 0-1
-    rounding errors may cause the ``Normalized`` values to differ
-    slightly from what you might expect.
-
-    .. versionadded:: 2.5.0
-    """
-
-    hex: str
-    """Gets or sets the stringified hexadecimal representation of the Color.
-
-    The stringified hexadecimal representation of the Color. The hexadecimal string
-    is formatted as ``"#rrggbbaa"`` where rr, gg, bb, and aa are two digit hex numbers
-    in the range from 0x00 to 0xff.
-
-    Setting this property means changing the color channels in place. Both lowercase
-    and uppercase letters are allowed, the alpha can be omitted (defaults to 0xff) and
-    the string can start with either ``#`` or ``0x``.
-
-    .. versionadded:: 2.5.4
-    """
-
-    __hash__: ClassVar[None]  # type: ignore[assignment]
-    @property
-    def __array_struct__(self) -> Any: ...
-    if sys.version_info >= (3, 12):
-        def __buffer__(self, flags: int, /) -> memoryview[int]: ...
-
+    cmy: Tuple[float, float, float]
+    hsva: Tuple[float, float, float, float]
+    hsla: Tuple[float, float, float, float]
+    i1i2i3: Tuple[float, float, float]
+    __hash__: None  # type: ignore
+    __array_struct__: Any
     @overload
     def __init__(self, r: int, g: int, b: int, a: int = 255) -> None: ...
     @overload
-    def __init__(self, rgbvalue: ColorLike) -> None: ...
+    def __init__(self, rgbvalue: ColorValue) -> None: ...
     @overload
-    def __getitem__(self, i: SupportsIndex) -> int: ...
+    def __getitem__(self, i: int) -> int: ...
     @overload
-    def __getitem__(self, s: slice) -> tuple[int, ...]: ...
+    def __getitem__(self, s: slice) -> Tuple[int]: ...
     def __setitem__(self, key: int, value: int) -> None: ...
     def __iter__(self) -> Iterator[int]: ...
     def __add__(self, other: Color) -> Color: ...
@@ -232,180 +40,17 @@ class Color(Collection[int]):
     def __mod__(self, other: Color) -> Color: ...
     def __int__(self) -> int: ...
     def __float__(self) -> float: ...
-    def __bytes__(self) -> bytes: ...
     def __len__(self) -> int: ...
     def __index__(self) -> int: ...
     def __invert__(self) -> Color: ...
     def __contains__(self, other: int) -> bool: ...  # type: ignore[override]
-    def __getattribute__(self, name: str) -> Color | tuple[int, ...]: ...
-    def __setattr__(self, name: str, value: Color | tuple[int, ...]) -> None: ...
+    def normalize(self) -> Tuple[float, float, float, float]: ...
+    def correct_gamma(self, gamma: float) -> Color: ...
+    def set_length(self, length: int) -> None: ...
+    def lerp(self, color: ColorValue, amount: float) -> Color: ...
+    def premul_alpha(self) -> Color: ...
     @overload
-    @classmethod
-    def from_cmy(cls, object: tuple[float, float, float], /) -> Color: ...
+    def update(self, r: int, g: int, b: int, a: int = 255) -> None: ...
     @overload
-    @classmethod
-    def from_cmy(cls, c: float, m: float, y: float, /) -> Color: ...
-    @classmethod  # type: ignore
-    def from_cmy(cls, *args) -> Color:  # type: ignore
-        """Returns a Color object from a CMY representation.
-
-        Creates a Color object from the given CMY components. Refer to :attr:`Color.cmy`
-        for more information.
-
-        .. versionadded:: 2.3.1
-        """
-
-    @overload
-    @classmethod
-    def from_hsva(cls, object: tuple[float, float, float, float], /) -> Color: ...
-    @overload
-    @classmethod
-    def from_hsva(cls, h: float, s: float, v: float, a: float, /) -> Color: ...
-    @classmethod  # type: ignore
-    def from_hsva(cls, *args) -> Color:  # type: ignore
-        """Returns a Color object from an HSVA representation.
-
-        Creates a Color object from the given HSVA components. Refer to :attr:`Color.hsva`
-        for more information.
-
-        .. versionadded:: 2.3.1
-        """
-
-    @overload
-    @classmethod
-    def from_hsla(cls, object: tuple[float, float, float, float], /) -> Color: ...
-    @overload
-    @classmethod
-    def from_hsla(cls, h: float, s: float, l: float, a: float, /) -> Color: ...
-    @classmethod  # type: ignore
-    def from_hsla(cls, *args) -> Color:  # type: ignore
-        """Returns a Color object from an HSLA representation.
-
-        Creates a Color object from the given HSLA components. Refer to :attr:`Color.hsla`
-        for more information.
-
-        .. versionadded:: 2.3.1
-        """
-
-    @overload
-    @classmethod
-    def from_i1i2i3(cls, object: tuple[float, float, float], /) -> Color: ...
-    @overload
-    @classmethod
-    def from_i1i2i3(cls, i1: float, i2: float, i3: float, /) -> Color: ...
-    @classmethod  # type: ignore
-    def from_i1i2i3(cls, *args) -> Color:  # type: ignore
-        """Returns a Color object from a I1I2I3 representation.
-
-        Creates a Color object from the given I1I2I3 components. Refer to :attr:`Color.i1i2i3`
-        for more information.
-
-        .. versionadded:: 2.3.1
-        """
-
-    @overload
-    @classmethod
-    def from_normalized(cls, object: tuple[float, float, float, float], /) -> Color: ...
-    @overload
-    @classmethod
-    def from_normalized(cls, r: float, g: float, b: float, a: float, /) -> Color: ...
-    @classmethod  # type: ignore
-    def from_normalized(cls, *args) -> Color:  # type: ignore
-        """Returns a Color object from a Normalized representation.
-
-        Creates a Color object from the given Normalized components. Refer to :attr:`Color.normalized`
-        for more information.
-
-        .. versionadded:: 2.5.0
-        """
-
-    @classmethod
-    def from_hex(cls, hex: str, /) -> Color:
-        """Returns a Color object from a Hexadecimal representation.
-
-        Creates a Color object from the given Hexadecimal components. Refer to :attr:`Color.hex`
-        for more information.
-
-        .. versionadded:: 2.5.6
-        """
-
-    def normalize(self) -> tuple[float, float, float, float]:
-        """Returns the normalized RGBA values of the Color.
-
-        Returns the normalized ``RGBA`` values of the Color as floating point
-        values.
-        """
-
-    def correct_gamma(self, gamma: float, /) -> Color:
-        """Applies a certain gamma value to the Color.
-
-        Applies a certain gamma value to the Color and returns a new Color with
-        the adjusted ``RGBA`` values.
-        """
-
-    @deprecated("since 2.1.3. Use unpacking instead")
-    def set_length(self, length: int, /) -> None:
-        """Set the number of elements in the Color to 1,2,3, or 4.
-
-        DEPRECATED: You may unpack the values you need like so,
-        ``r, g, b, _ = pygame.Color(100, 100, 100)``
-        If you only want r, g and b
-        Or
-        ``r, g, *_ = pygame.Color(100, 100, 100)``
-        if you only want r and g
-
-        The default Color length is 4. Colors can have lengths 1,2,3 or 4. This
-        is useful if you want to unpack to r,g,b and not r,g,b,a. If you want to
-        get the length of a Color do ``len(acolor)``.
-
-        .. deprecated:: 2.1.3
-        .. versionaddedold:: 1.9.0
-        """
-
-    def grayscale(self) -> Color:
-        """Returns the grayscale of a Color.
-
-        Returns a new Color object which represents the grayscaled version of self, using the luminosity formula,
-        which weights red, green, and blue according to their relative contribution to perceived brightness.
-
-        .. versionadded:: 2.1.4
-        """
-
-    def lerp(self, color: ColorLike, amount: float) -> Color:
-        """Returns a linear interpolation to the given Color.
-
-        Returns a Color which is a linear interpolation between self and the
-        given Color in RGBA space. The second parameter determines how far
-        between self and other the result is going to be.
-        It must be a value between 0 and 1 where 0 means self and 1 means
-        other will be returned.
-
-        .. versionaddedold:: 2.0.1
-        """
-
-    def premul_alpha(self) -> Color:
-        """Returns a Color where the r,g,b components have been multiplied by the alpha.
-
-        Returns a new Color where each of the red, green and blue color
-        channels have been multiplied by the alpha channel of the original
-        color. The alpha channel remains unchanged.
-
-        This is useful when working with the ``BLEND_PREMULTIPLIED`` blending mode
-        flag for :meth:`pygame.Surface.blit()`, which assumes that all surfaces using
-        it are using pre-multiplied alpha colors.
-
-        .. versionaddedold:: 2.0.0
-        """
-
-    @overload
-    def update(self, r: int, g: int, b: int, a: int = 255, /) -> None: ...
-    @overload
-    def update(self, rgbvalue: ColorLike, /) -> None: ...
-    def update(self, *args) -> None:  # type: ignore
-        """Sets the elements of the color.
-
-        Sets the elements of the color. See parameters for :meth:`pygame.Color` for the
-        parameters of this function. If the alpha value was not set it will not change.
-
-        .. versionaddedold:: 2.0.1
-        """
+    def update(self, rgbvalue: ColorValue) -> None: ...
+    def grayscale(self) -> Color: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/colordict.py b/.venv/lib/python3.14/site-packages/pygame/colordict.py
index fe9d741..0bd7256 100644
--- a/.venv/lib/python3.14/site-packages/pygame/colordict.py
+++ b/.venv/lib/python3.14/site-packages/pygame/colordict.py
@@ -1,4 +1,4 @@
-#    pygame-ce - Python Game Library
+#    pygame - Python Game Library
 #    Copyright (C) 2000-2003  Pete Shinners
 #
 #    This library is free software; you can redistribute it and/or
@@ -18,9 +18,9 @@
 #    Pete Shinners
 #    pete@shinners.org
 
-"""A dictionary of RGBA tuples indexed by color names.
+""" A dictionary of RGBA tuples indexed by color names.
 
-See https://pyga.me/docs/ref/color_list.html for sample swatches.
+See https://www.pygame.org/docs/ref/color_list.html for sample swatches.
 """
 
 THECOLORS = {
diff --git a/.venv/lib/python3.14/site-packages/pygame/constants.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/constants.cpython-314-x86_64-linux-gnu.so
index a948a7f..b03314c 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/constants.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/constants.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/constants.pyi b/.venv/lib/python3.14/site-packages/pygame/constants.pyi
index 044d953..07b2d46 100644
--- a/.venv/lib/python3.14/site-packages/pygame/constants.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/constants.pyi
@@ -31,26 +31,10 @@ AUDIO_U16MSB: int
 AUDIO_U16SYS: int
 AUDIO_U8: int
 BIG_ENDIAN: int
-BLENDFACTOR_DST_ALPHA: int
-BLENDFACTOR_DST_COLOR: int
-BLENDFACTOR_ONE: int
-BLENDFACTOR_ONE_MINUS_DST_ALPHA: int
-BLENDFACTOR_ONE_MINUS_DST_COLOR: int
-BLENDFACTOR_ONE_MINUS_SRC_ALPHA: int
-BLENDFACTOR_ONE_MINUS_SRC_COLOR: int
-BLENDFACTOR_SRC_ALPHA: int
-BLENDFACTOR_SRC_COLOR: int
-BLENDFACTOR_ZERO: int
 BLENDMODE_ADD: int
 BLENDMODE_BLEND: int
 BLENDMODE_MOD: int
-BLENDMODE_MUL: int
 BLENDMODE_NONE: int
-BLENDOPERATION_ADD: int
-BLENDOPERATION_MAXIMUM: int
-BLENDOPERATION_MINIMUM: int
-BLENDOPERATION_REV_SUBTRACT: int
-BLENDOPERATION_SUBTRACT: int
 BLEND_ADD: int
 BLEND_ALPHA_SDL2: int
 BLEND_MAX: int
@@ -111,10 +95,6 @@ CONTROLLER_BUTTON_RIGHTSTICK: int
 CONTROLLER_BUTTON_START: int
 CONTROLLER_BUTTON_X: int
 CONTROLLER_BUTTON_Y: int
-DIRECTION_BTT: int
-DIRECTION_LTR: int
-DIRECTION_RTL: int
-DIRECTION_TTB: int
 DOUBLEBUF: int
 DROPBEGIN: int
 DROPCOMPLETE: int
@@ -123,15 +103,6 @@ DROPTEXT: int
 FINGERDOWN: int
 FINGERMOTION: int
 FINGERUP: int
-FLASH_BRIEFLY: int
-FLASH_CANCEL: int
-FLASH_UNTIL_FOCUSED: int
-FLIP_HORIZONTAL: int
-FLIP_NONE: int
-FLIP_VERTICAL: int
-FONT_CENTER: int
-FONT_LEFT: int
-FONT_RIGHT: int
 FULLSCREEN: int
 GL_ACCELERATED_VISUAL: int
 GL_ACCUM_ALPHA_SIZE: int
@@ -179,7 +150,6 @@ HIDDEN: int
 HWACCEL: int
 HWPALETTE: int
 HWSURFACE: int
-IS_CE: int
 JOYAXISMOTION: int
 JOYBALLMOTION: int
 JOYBUTTONDOWN: int
@@ -529,7 +499,6 @@ MOUSEWHEEL: int
 MULTIGESTURE: int
 NOEVENT: int
 NOFRAME: int
-NULL_VIDEODRIVER: str
 NUMEVENTS: int
 OPENGL: int
 OPENGLBLIT: int
@@ -547,8 +516,6 @@ SCRAP_PBM: str
 SCRAP_PPM: str
 SCRAP_SELECTION: int
 SCRAP_TEXT: str
-SCROLL_ERASE: int
-SCROLL_REPEAT: int
 SHOWN: int
 SRCALPHA: int
 SRCCOLORKEY: int
@@ -568,9 +535,6 @@ SYSTEM_CURSOR_WAITARROW: int
 SYSWMEVENT: int
 TEXTEDITING: int
 TEXTINPUT: int
-TEXTUREACCESS_STATIC: int
-TEXTUREACCESS_STREAMING: int
-TEXTUREACCESS_TARGET: int
 TIMER_RESOLUTION: int
 USEREVENT: int
 USEREVENT_DROPFILE: int
@@ -589,606 +553,8 @@ WINDOWLEAVE: int
 WINDOWMAXIMIZED: int
 WINDOWMINIMIZED: int
 WINDOWMOVED: int
-WINDOWPOS_CENTERED: int
-WINDOWPOS_UNDEFINED: int
 WINDOWRESIZED: int
 WINDOWRESTORED: int
 WINDOWSHOWN: int
 WINDOWSIZECHANGED: int
 WINDOWTAKEFOCUS: int
-__all__ = [
-    "LIL_ENDIAN",
-    "BIG_ENDIAN",
-    "SWSURFACE",
-    "HWSURFACE",
-    "RESIZABLE",
-    "ASYNCBLIT",
-    "OPENGL",
-    "OPENGLBLIT",
-    "ANYFORMAT",
-    "HWPALETTE",
-    "DOUBLEBUF",
-    "FULLSCREEN",
-    "HWACCEL",
-    "SRCCOLORKEY",
-    "RLEACCELOK",
-    "RLEACCEL",
-    "SRCALPHA",
-    "PREALLOC",
-    "NOFRAME",
-    "SHOWN",
-    "HIDDEN",
-    "SCROLL_ERASE",
-    "SCROLL_REPEAT",
-    "SCALED",
-    "GL_RED_SIZE",
-    "GL_GREEN_SIZE",
-    "GL_BLUE_SIZE",
-    "GL_ALPHA_SIZE",
-    "GL_BUFFER_SIZE",
-    "GL_DOUBLEBUFFER",
-    "GL_DEPTH_SIZE",
-    "GL_STENCIL_SIZE",
-    "GL_ACCUM_RED_SIZE",
-    "GL_ACCUM_GREEN_SIZE",
-    "GL_ACCUM_BLUE_SIZE",
-    "GL_ACCUM_ALPHA_SIZE",
-    "GL_ACCELERATED_VISUAL",
-    "GL_CONTEXT_MAJOR_VERSION",
-    "GL_CONTEXT_MINOR_VERSION",
-    "GL_SHARE_WITH_CURRENT_CONTEXT",
-    "GL_CONTEXT_FLAGS",
-    "GL_CONTEXT_DEBUG_FLAG",
-    "GL_CONTEXT_FORWARD_COMPATIBLE_FLAG",
-    "GL_CONTEXT_ROBUST_ACCESS_FLAG",
-    "GL_CONTEXT_RESET_ISOLATION_FLAG",
-    "GL_CONTEXT_PROFILE_MASK",
-    "GL_CONTEXT_PROFILE_CORE",
-    "GL_CONTEXT_PROFILE_COMPATIBILITY",
-    "GL_CONTEXT_PROFILE_ES",
-    "GL_FRAMEBUFFER_SRGB_CAPABLE",
-    "GL_CONTEXT_RELEASE_BEHAVIOR",
-    "GL_CONTEXT_RELEASE_BEHAVIOR_NONE",
-    "GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH",
-    "BLENDMODE_NONE",
-    "BLENDMODE_BLEND",
-    "BLENDMODE_ADD",
-    "BLENDMODE_MOD",
-    "BLENDMODE_MUL",
-    "BLENDFACTOR_ZERO",
-    "BLENDFACTOR_ONE",
-    "BLENDFACTOR_SRC_COLOR",
-    "BLENDFACTOR_ONE_MINUS_SRC_COLOR",
-    "BLENDFACTOR_SRC_ALPHA",
-    "BLENDFACTOR_ONE_MINUS_SRC_ALPHA",
-    "BLENDFACTOR_DST_COLOR",
-    "BLENDFACTOR_ONE_MINUS_DST_COLOR",
-    "BLENDFACTOR_DST_ALPHA",
-    "BLENDFACTOR_ONE_MINUS_DST_ALPHA",
-    "BLENDOPERATION_ADD",
-    "BLENDOPERATION_SUBTRACT",
-    "BLENDOPERATION_REV_SUBTRACT",
-    "BLENDOPERATION_MINIMUM",
-    "BLENDOPERATION_MAXIMUM",
-    "GL_STEREO",
-    "GL_MULTISAMPLEBUFFERS",
-    "GL_MULTISAMPLESAMPLES",
-    "GL_SWAP_CONTROL",
-    "TIMER_RESOLUTION",
-    "AUDIO_U8",
-    "AUDIO_S8",
-    "AUDIO_U16LSB",
-    "AUDIO_S16LSB",
-    "AUDIO_U16MSB",
-    "AUDIO_S16MSB",
-    "AUDIO_U16",
-    "AUDIO_S16",
-    "AUDIO_U16SYS",
-    "AUDIO_S16SYS",
-    "SCRAP_TEXT",
-    "SCRAP_BMP",
-    "SCRAP_PPM",
-    "SCRAP_PBM",
-    "SCRAP_CLIPBOARD",
-    "SCRAP_SELECTION",
-    "BLEND_ADD",
-    "BLEND_SUB",
-    "BLEND_MULT",
-    "BLEND_MIN",
-    "BLEND_MAX",
-    "BLEND_RGB_ADD",
-    "BLEND_RGB_SUB",
-    "BLEND_RGB_MULT",
-    "BLEND_RGB_MIN",
-    "BLEND_RGB_MAX",
-    "BLEND_RGBA_ADD",
-    "BLEND_RGBA_SUB",
-    "BLEND_RGBA_MULT",
-    "BLEND_RGBA_MIN",
-    "BLEND_RGBA_MAX",
-    "BLEND_PREMULTIPLIED",
-    "BLEND_ALPHA_SDL2",
-    "NOEVENT",
-    "ACTIVEEVENT",
-    "KEYDOWN",
-    "KEYUP",
-    "MOUSEMOTION",
-    "MOUSEBUTTONDOWN",
-    "MOUSEBUTTONUP",
-    "JOYAXISMOTION",
-    "JOYBALLMOTION",
-    "JOYHATMOTION",
-    "JOYBUTTONDOWN",
-    "JOYBUTTONUP",
-    "VIDEORESIZE",
-    "VIDEOEXPOSE",
-    "QUIT",
-    "SYSWMEVENT",
-    "MIDIIN",
-    "MIDIOUT",
-    "USEREVENT",
-    "NUMEVENTS",
-    "APP_TERMINATING",
-    "APP_LOWMEMORY",
-    "APP_WILLENTERBACKGROUND",
-    "APP_DIDENTERBACKGROUND",
-    "APP_WILLENTERFOREGROUND",
-    "APP_DIDENTERFOREGROUND",
-    "CLIPBOARDUPDATE",
-    "KEYMAPCHANGED",
-    "RENDER_TARGETS_RESET",
-    "RENDER_DEVICE_RESET",
-    "HAT_CENTERED",
-    "HAT_UP",
-    "HAT_RIGHTUP",
-    "HAT_RIGHT",
-    "HAT_RIGHTDOWN",
-    "HAT_DOWN",
-    "HAT_LEFTDOWN",
-    "HAT_LEFT",
-    "HAT_LEFTUP",
-    "BUTTON_LEFT",
-    "BUTTON_MIDDLE",
-    "BUTTON_RIGHT",
-    "FINGERMOTION",
-    "FINGERDOWN",
-    "FINGERUP",
-    "MULTIGESTURE",
-    "AUDIODEVICEADDED",
-    "AUDIODEVICEREMOVED",
-    "MOUSEWHEEL",
-    "TEXTINPUT",
-    "TEXTEDITING",
-    "WINDOWSHOWN",
-    "WINDOWHIDDEN",
-    "WINDOWEXPOSED",
-    "WINDOWMOVED",
-    "WINDOWRESIZED",
-    "WINDOWSIZECHANGED",
-    "WINDOWMINIMIZED",
-    "WINDOWMAXIMIZED",
-    "WINDOWRESTORED",
-    "WINDOWENTER",
-    "WINDOWLEAVE",
-    "WINDOWFOCUSGAINED",
-    "WINDOWFOCUSLOST",
-    "WINDOWCLOSE",
-    "WINDOWTAKEFOCUS",
-    "WINDOWHITTEST",
-    "WINDOWICCPROFCHANGED",
-    "WINDOWDISPLAYCHANGED",
-    "TEXTUREACCESS_STATIC",
-    "TEXTUREACCESS_STREAMING",
-    "TEXTUREACCESS_TARGET",
-    "FLIP_NONE",
-    "FLIP_HORIZONTAL",
-    "FLIP_VERTICAL",
-    "CONTROLLERAXISMOTION",
-    "CONTROLLERBUTTONDOWN",
-    "CONTROLLERBUTTONUP",
-    "CONTROLLERDEVICEADDED",
-    "CONTROLLERDEVICEREMOVED",
-    "CONTROLLERDEVICEREMAPPED",
-    "CONTROLLERTOUCHPADDOWN",
-    "CONTROLLERTOUCHPADMOTION",
-    "CONTROLLERTOUCHPADUP",
-    "CONTROLLERSENSORUPDATE",
-    "LOCALECHANGED",
-    "JOYDEVICEADDED",
-    "JOYDEVICEREMOVED",
-    "BUTTON_X1",
-    "BUTTON_X2",
-    "BUTTON_WHEELUP",
-    "BUTTON_WHEELDOWN",
-    "AUDIO_ALLOW_FREQUENCY_CHANGE",
-    "AUDIO_ALLOW_FORMAT_CHANGE",
-    "AUDIO_ALLOW_CHANNELS_CHANGE",
-    "AUDIO_ALLOW_ANY_CHANGE",
-    "DROPFILE",
-    "DROPTEXT",
-    "DROPBEGIN",
-    "DROPCOMPLETE",
-    "CONTROLLER_AXIS_INVALID",
-    "CONTROLLER_AXIS_LEFTX",
-    "CONTROLLER_AXIS_LEFTY",
-    "CONTROLLER_AXIS_RIGHTX",
-    "CONTROLLER_AXIS_RIGHTY",
-    "CONTROLLER_AXIS_TRIGGERLEFT",
-    "CONTROLLER_AXIS_TRIGGERRIGHT",
-    "CONTROLLER_AXIS_MAX",
-    "CONTROLLER_BUTTON_INVALID",
-    "CONTROLLER_BUTTON_A",
-    "CONTROLLER_BUTTON_B",
-    "CONTROLLER_BUTTON_X",
-    "CONTROLLER_BUTTON_Y",
-    "CONTROLLER_BUTTON_BACK",
-    "CONTROLLER_BUTTON_GUIDE",
-    "CONTROLLER_BUTTON_START",
-    "CONTROLLER_BUTTON_LEFTSTICK",
-    "CONTROLLER_BUTTON_RIGHTSTICK",
-    "CONTROLLER_BUTTON_LEFTSHOULDER",
-    "CONTROLLER_BUTTON_RIGHTSHOULDER",
-    "CONTROLLER_BUTTON_DPAD_UP",
-    "CONTROLLER_BUTTON_DPAD_DOWN",
-    "CONTROLLER_BUTTON_DPAD_LEFT",
-    "CONTROLLER_BUTTON_DPAD_RIGHT",
-    "CONTROLLER_BUTTON_MAX",
-    "K_AC_BACK",
-    "KSCAN_AC_BACK",
-    "K_UNKNOWN",
-    "KSCAN_UNKNOWN",
-    "K_BACKSPACE",
-    "KSCAN_BACKSPACE",
-    "K_TAB",
-    "KSCAN_TAB",
-    "K_CLEAR",
-    "KSCAN_CLEAR",
-    "K_RETURN",
-    "KSCAN_RETURN",
-    "K_PAUSE",
-    "KSCAN_PAUSE",
-    "K_ESCAPE",
-    "KSCAN_ESCAPE",
-    "K_SPACE",
-    "KSCAN_SPACE",
-    "K_QUOTE",
-    "KSCAN_APOSTROPHE",
-    "K_COMMA",
-    "KSCAN_COMMA",
-    "K_MINUS",
-    "KSCAN_MINUS",
-    "K_PERIOD",
-    "KSCAN_PERIOD",
-    "K_SLASH",
-    "KSCAN_SLASH",
-    "K_0",
-    "KSCAN_0",
-    "K_1",
-    "KSCAN_1",
-    "K_2",
-    "KSCAN_2",
-    "K_3",
-    "KSCAN_3",
-    "K_4",
-    "KSCAN_4",
-    "K_5",
-    "KSCAN_5",
-    "K_6",
-    "KSCAN_6",
-    "K_7",
-    "KSCAN_7",
-    "K_8",
-    "KSCAN_8",
-    "K_9",
-    "KSCAN_9",
-    "K_SEMICOLON",
-    "KSCAN_SEMICOLON",
-    "K_EQUALS",
-    "KSCAN_EQUALS",
-    "K_LEFTBRACKET",
-    "KSCAN_LEFTBRACKET",
-    "K_BACKSLASH",
-    "KSCAN_BACKSLASH",
-    "K_RIGHTBRACKET",
-    "KSCAN_RIGHTBRACKET",
-    "K_BACKQUOTE",
-    "KSCAN_GRAVE",
-    "K_a",
-    "KSCAN_A",
-    "K_b",
-    "KSCAN_B",
-    "K_c",
-    "KSCAN_C",
-    "K_d",
-    "KSCAN_D",
-    "K_e",
-    "KSCAN_E",
-    "K_f",
-    "KSCAN_F",
-    "K_g",
-    "KSCAN_G",
-    "K_h",
-    "KSCAN_H",
-    "K_i",
-    "KSCAN_I",
-    "K_j",
-    "KSCAN_J",
-    "K_k",
-    "KSCAN_K",
-    "K_l",
-    "KSCAN_L",
-    "K_m",
-    "KSCAN_M",
-    "K_n",
-    "KSCAN_N",
-    "K_o",
-    "KSCAN_O",
-    "K_p",
-    "KSCAN_P",
-    "K_q",
-    "KSCAN_Q",
-    "K_r",
-    "KSCAN_R",
-    "K_s",
-    "KSCAN_S",
-    "K_t",
-    "KSCAN_T",
-    "K_u",
-    "KSCAN_U",
-    "K_v",
-    "KSCAN_V",
-    "K_w",
-    "KSCAN_W",
-    "K_x",
-    "KSCAN_X",
-    "K_y",
-    "KSCAN_Y",
-    "K_z",
-    "KSCAN_Z",
-    "K_DELETE",
-    "KSCAN_DELETE",
-    "K_KP_0",
-    "KSCAN_KP_0",
-    "K_KP_1",
-    "KSCAN_KP_1",
-    "K_KP_2",
-    "KSCAN_KP_2",
-    "K_KP_3",
-    "KSCAN_KP_3",
-    "K_KP_4",
-    "KSCAN_KP_4",
-    "K_KP_5",
-    "KSCAN_KP_5",
-    "K_KP_6",
-    "KSCAN_KP_6",
-    "K_KP_7",
-    "KSCAN_KP_7",
-    "K_KP_8",
-    "KSCAN_KP_8",
-    "K_KP_9",
-    "KSCAN_KP_9",
-    "K_KP0",
-    "KSCAN_KP0",
-    "K_KP1",
-    "KSCAN_KP1",
-    "K_KP2",
-    "KSCAN_KP2",
-    "K_KP3",
-    "KSCAN_KP3",
-    "K_KP4",
-    "KSCAN_KP4",
-    "K_KP5",
-    "KSCAN_KP5",
-    "K_KP6",
-    "KSCAN_KP6",
-    "K_KP7",
-    "KSCAN_KP7",
-    "K_KP8",
-    "KSCAN_KP8",
-    "K_KP9",
-    "KSCAN_KP9",
-    "K_KP_PERIOD",
-    "KSCAN_KP_PERIOD",
-    "K_KP_DIVIDE",
-    "KSCAN_KP_DIVIDE",
-    "K_KP_MULTIPLY",
-    "KSCAN_KP_MULTIPLY",
-    "K_KP_MINUS",
-    "KSCAN_KP_MINUS",
-    "K_KP_PLUS",
-    "KSCAN_KP_PLUS",
-    "K_KP_ENTER",
-    "KSCAN_KP_ENTER",
-    "K_KP_EQUALS",
-    "KSCAN_KP_EQUALS",
-    "K_UP",
-    "KSCAN_UP",
-    "K_DOWN",
-    "KSCAN_DOWN",
-    "K_RIGHT",
-    "KSCAN_RIGHT",
-    "K_LEFT",
-    "KSCAN_LEFT",
-    "K_INSERT",
-    "KSCAN_INSERT",
-    "K_HOME",
-    "KSCAN_HOME",
-    "K_END",
-    "KSCAN_END",
-    "K_PAGEUP",
-    "KSCAN_PAGEUP",
-    "K_PAGEDOWN",
-    "KSCAN_PAGEDOWN",
-    "K_F1",
-    "KSCAN_F1",
-    "K_F2",
-    "KSCAN_F2",
-    "K_F3",
-    "KSCAN_F3",
-    "K_F4",
-    "KSCAN_F4",
-    "K_F5",
-    "KSCAN_F5",
-    "K_F6",
-    "KSCAN_F6",
-    "K_F7",
-    "KSCAN_F7",
-    "K_F8",
-    "KSCAN_F8",
-    "K_F9",
-    "KSCAN_F9",
-    "K_F10",
-    "KSCAN_F10",
-    "K_F11",
-    "KSCAN_F11",
-    "K_F12",
-    "KSCAN_F12",
-    "K_F13",
-    "KSCAN_F13",
-    "K_F14",
-    "KSCAN_F14",
-    "K_F15",
-    "KSCAN_F15",
-    "K_NUMLOCKCLEAR",
-    "KSCAN_NUMLOCKCLEAR",
-    "K_NUMLOCK",
-    "KSCAN_NUMLOCK",
-    "K_CAPSLOCK",
-    "KSCAN_CAPSLOCK",
-    "K_SCROLLLOCK",
-    "KSCAN_SCROLLLOCK",
-    "K_SCROLLOCK",
-    "KSCAN_SCROLLOCK",
-    "K_RSHIFT",
-    "KSCAN_RSHIFT",
-    "K_LSHIFT",
-    "KSCAN_LSHIFT",
-    "K_RCTRL",
-    "KSCAN_RCTRL",
-    "K_LCTRL",
-    "KSCAN_LCTRL",
-    "K_RALT",
-    "KSCAN_RALT",
-    "K_LALT",
-    "KSCAN_LALT",
-    "K_RGUI",
-    "KSCAN_RGUI",
-    "K_RMETA",
-    "KSCAN_RMETA",
-    "K_LGUI",
-    "KSCAN_LGUI",
-    "K_LMETA",
-    "KSCAN_LMETA",
-    "K_LSUPER",
-    "KSCAN_LSUPER",
-    "K_RSUPER",
-    "KSCAN_RSUPER",
-    "K_MODE",
-    "KSCAN_MODE",
-    "K_HELP",
-    "KSCAN_HELP",
-    "K_PRINTSCREEN",
-    "KSCAN_PRINTSCREEN",
-    "K_PRINT",
-    "KSCAN_PRINT",
-    "K_SYSREQ",
-    "KSCAN_SYSREQ",
-    "K_BREAK",
-    "KSCAN_BREAK",
-    "K_MENU",
-    "KSCAN_MENU",
-    "K_POWER",
-    "KSCAN_POWER",
-    "K_CURRENCYUNIT",
-    "KSCAN_CURRENCYUNIT",
-    "K_CURRENCYSUBUNIT",
-    "KSCAN_CURRENCYSUBUNIT",
-    "K_EURO",
-    "KSCAN_EURO",
-    "KSCAN_INTERNATIONAL1",
-    "KSCAN_INTERNATIONAL2",
-    "KSCAN_INTERNATIONAL3",
-    "KSCAN_INTERNATIONAL4",
-    "KSCAN_INTERNATIONAL5",
-    "KSCAN_INTERNATIONAL6",
-    "KSCAN_INTERNATIONAL7",
-    "KSCAN_INTERNATIONAL8",
-    "KSCAN_INTERNATIONAL9",
-    "KSCAN_LANG1",
-    "KSCAN_LANG2",
-    "KSCAN_LANG3",
-    "KSCAN_LANG4",
-    "KSCAN_LANG5",
-    "KSCAN_LANG6",
-    "KSCAN_LANG7",
-    "KSCAN_LANG8",
-    "KSCAN_LANG9",
-    "KSCAN_NONUSBACKSLASH",
-    "KSCAN_NONUSHASH",
-    "K_EXCLAIM",
-    "K_QUOTEDBL",
-    "K_HASH",
-    "K_DOLLAR",
-    "K_AMPERSAND",
-    "K_PERCENT",
-    "K_LEFTPAREN",
-    "K_RIGHTPAREN",
-    "K_ASTERISK",
-    "K_PLUS",
-    "K_COLON",
-    "K_LESS",
-    "K_GREATER",
-    "K_QUESTION",
-    "K_AT",
-    "K_CARET",
-    "K_UNDERSCORE",
-    "KMOD_NONE",
-    "KMOD_LSHIFT",
-    "KMOD_RSHIFT",
-    "KMOD_LCTRL",
-    "KMOD_RCTRL",
-    "KMOD_LALT",
-    "KMOD_RALT",
-    "KMOD_LGUI",
-    "KMOD_LMETA",
-    "KMOD_RGUI",
-    "KMOD_RMETA",
-    "KMOD_NUM",
-    "KMOD_CAPS",
-    "KMOD_MODE",
-    "KMOD_CTRL",
-    "KMOD_SHIFT",
-    "KMOD_ALT",
-    "KMOD_GUI",
-    "KMOD_META",
-    "APPMOUSEFOCUS",
-    "APPINPUTFOCUS",
-    "APPACTIVE",
-    "SYSTEM_CURSOR_ARROW",
-    "SYSTEM_CURSOR_IBEAM",
-    "SYSTEM_CURSOR_WAIT",
-    "SYSTEM_CURSOR_CROSSHAIR",
-    "SYSTEM_CURSOR_WAITARROW",
-    "SYSTEM_CURSOR_SIZENWSE",
-    "SYSTEM_CURSOR_SIZENESW",
-    "SYSTEM_CURSOR_SIZEWE",
-    "SYSTEM_CURSOR_SIZENS",
-    "SYSTEM_CURSOR_SIZEALL",
-    "SYSTEM_CURSOR_NO",
-    "SYSTEM_CURSOR_HAND",
-    "USEREVENT_DROPFILE",
-    "DIRECTION_LTR",
-    "DIRECTION_RTL",
-    "DIRECTION_TTB",
-    "DIRECTION_BTT",
-    "FONT_LEFT",
-    "FONT_CENTER",
-    "FONT_RIGHT",
-    "IS_CE",
-    "NULL_VIDEODRIVER",
-    "WINDOWPOS_UNDEFINED",
-    "WINDOWPOS_CENTERED",
-    "FLASH_CANCEL",
-    "FLASH_BRIEFLY",
-    "FLASH_UNTIL_FOCUSED",
-]
diff --git a/.venv/lib/python3.14/site-packages/pygame/cursors.py b/.venv/lib/python3.14/site-packages/pygame/cursors.py
index 8186bfd..2c920be 100644
--- a/.venv/lib/python3.14/site-packages/pygame/cursors.py
+++ b/.venv/lib/python3.14/site-packages/pygame/cursors.py
@@ -1,4 +1,4 @@
-#    pygame-ce - Python Game Library
+#    pygame - Python Game Library
 #    Copyright (C) 2000-2003  Pete Shinners
 #
 #    This library is free software; you can redistribute it and/or
@@ -18,59 +18,21 @@
 #    Pete Shinners
 #    pete@shinners.org
 
-"""Pygame module for cursor resources.
+"""Set of cursor resources available for use. These cursors come
+in a sequence of values that are needed as the arguments for
+pygame.mouse.set_cursor(). To dereference the sequence in place
+and create the cursor in one step, call like this:
+    pygame.mouse.set_cursor(*pygame.cursors.arrow).
 
-Pygame offers control over the system hardware cursor. Pygame supports
-black and white cursors (bitmap cursors), as well as system variant cursors and color cursors.
-You control the cursor with functions inside :mod:`pygame.mouse`.
+Here is a list of available cursors:
+    arrow, diamond, ball, broken_x, tri_left, tri_right
 
-This cursors module contains functions for loading and decoding various
-cursor formats. These allow you to easily store your cursors in external files
-or directly as encoded python strings.
+There is also a sample string cursor named 'thickarrow_strings'.
+The compile() function can convert these string cursors into cursor byte data that can be used to
+create Cursor objects.
 
-The module includes several standard cursors. The :func:`pygame.mouse.set_cursor()`
-function takes several arguments. All those arguments have been stored in a
-single tuple you can call like this:
-
-::
-
-   >>> pygame.mouse.set_cursor(*pygame.cursors.arrow)
-
-The following variables can be passed to ``pygame.mouse.set_cursor`` function:
-
-   * ``pygame.cursors.arrow``
-
-   * ``pygame.cursors.diamond``
-
-   * ``pygame.cursors.broken_x``
-
-   * ``pygame.cursors.tri_left``
-
-   * ``pygame.cursors.tri_right``
-
-   * ``pygame.cursors.ball``
-
-This module also contains a few cursors as formatted strings. You'll need to
-pass these to ``pygame.cursors.compile()`` function before you can use them.
-The example call would look like this:
-
-::
-
-   >>> cursor = pygame.cursors.compile(pygame.cursors.textmarker_strings)
-   >>> pygame.mouse.set_cursor((8, 16), (0, 0), *cursor)
-
-The following strings can be converted into cursor bitmaps with
-``pygame.cursors.compile()`` :
-
-   * ``pygame.cursors.thickarrow_strings``
-
-   * ``pygame.cursors.sizer_x_strings``
-
-   * ``pygame.cursors.sizer_y_strings``
-
-   * ``pygame.cursors.sizer_xy_strings``
-
-   * ``pygame.cursors.textmarker_strings``
+Alternately, you can also create Cursor objects using surfaces or cursors constants,
+such as pygame.SYSTEM_CURSOR_ARROW.
 """
 
 import pygame
@@ -92,95 +54,21 @@ _cursor_id_table = {
 
 
 class Cursor:
-    """Pygame object representing a cursor.
-
-    In pygame 2, there are 3 types of cursors you can create to give your
-    game that little bit of extra polish. There's **bitmap** type cursors,
-    which existed in pygame 1.x, and are compiled from a string or load from an xbm file.
-    Then there are **system** type cursors, where you choose a preset that will
-    convey the same meaning but look native across different operating systems.
-    Finally you can create a **color** cursor, which displays a pygame surface as the cursor.
-
-    **Creating a system cursor**
-
-    Choose a constant from this list, pass it into ``pygame.cursors.Cursor(constant)``,
-    and you're good to go. Be advised that not all systems support every system
-    cursor, and you may get a substitution instead. For example, on macOS,
-    WAIT/WAITARROW should show up as an arrow, and SIZENWSE/SIZENESW/SIZEALL
-    should show up as a closed hand. And on Wayland, every SIZE cursor should
-    show up as a hand.
-
-    ::
-
-       Pygame Cursor Constant           Description
-       --------------------------------------------
-       pygame.SYSTEM_CURSOR_ARROW       arrow
-       pygame.SYSTEM_CURSOR_IBEAM       i-beam
-       pygame.SYSTEM_CURSOR_WAIT        wait
-       pygame.SYSTEM_CURSOR_CROSSHAIR   crosshair
-       pygame.SYSTEM_CURSOR_WAITARROW   small wait cursor
-                                        (or wait if not available)
-       pygame.SYSTEM_CURSOR_SIZENWSE    double arrow pointing
-                                        northwest and southeast
-       pygame.SYSTEM_CURSOR_SIZENESW    double arrow pointing
-                                        northeast and southwest
-       pygame.SYSTEM_CURSOR_SIZEWE      double arrow pointing
-                                        west and east
-       pygame.SYSTEM_CURSOR_SIZENS      double arrow pointing
-                                        north and south
-       pygame.SYSTEM_CURSOR_SIZEALL     four pointed arrow pointing
-                                        north, south, east, and west
-       pygame.SYSTEM_CURSOR_NO          slashed circle or crossbones
-       pygame.SYSTEM_CURSOR_HAND        hand
-
-    **Creating a cursor without passing arguments**
-
-    In addition to the cursor constants available and described above, you can
-    also call ``pygame.cursors.Cursor()``, and your cursor is ready (doing that
-    is the same as calling ``pygame.cursors.Cursor(pygame.SYSTEM_CURSOR_ARROW)``.
-    Doing one of those calls actually creates a system cursor using the default
-    native image.
-
-    **Creating a color cursor**
-
-    To create a color cursor, create a ``Cursor`` from a ``hotspot`` and a ``surface``.
-    ``hotspot`` are (x,y) coordinates that determine where in the cursor the exact point is.
-    The hotspot position must be within the bounds of the ``surface``.
-
-    **Creating a bitmap cursor**
-
-    When the mouse cursor is visible, it will be displayed as a black and white
-    bitmap using the given bitmask arrays. The ``size`` is a sequence containing
-    the cursor width and height. ``hotspot`` is a sequence containing the cursor
-    hotspot position.
-
-    A cursor has a width and height, but a mouse position is represented by a
-    set of point coordinates. So the value passed into the cursor ``hotspot``
-    variable helps pygame to actually determine at what exact point the cursor
-    is at.
-
-    ``xormasks`` is a sequence of bytes containing the cursor xor data masks.
-    Lastly ``andmasks``, a sequence of bytes containing the cursor bitmask data.
-    To create these variables, we can make use of the
-    :func:`pygame.cursors.compile()` function.
-
-    Width and height must be a multiple of 8, and the mask arrays must be the
-    correct size for the given width and height. Otherwise an exception is raised.
-
-    .. versionaddedold:: 2.0.1
-    """
-
     def __init__(self, *args):
-        self.type = "system"
-        """Get the cursor type.
+        """Cursor(size, hotspot, xormasks, andmasks) -> Cursor
+        Cursor(hotspot, Surface) -> Cursor
+        Cursor(constant) -> Cursor
+        Cursor(Cursor) -> copies the Cursor object passed as an argument
+        Cursor() -> Cursor
 
-        The type will be ``"system"``, ``"bitmap"``, or ``"color"``.
-        """
-        self.data = tuple()
-        """Get the cursor data.
+        pygame object for representing cursors
 
-        Returns the data that was used to create this cursor object, wrapped up in a tuple.
-        """
+        You can initialize a cursor from a system cursor or use the
+        constructor on an existing Cursor object, which will copy it.
+        Providing a Surface instance will render the cursor displayed
+        as that Surface when used.
+
+        These Surfaces may use other colors than black and white."""
         if len(args) == 0:
             self.type = "system"
             self.data = (pygame.SYSTEM_CURSOR_ARROW,)
@@ -218,14 +106,12 @@ class Cursor:
     def __ne__(self, other):
         return not self.__eq__(other)
 
-    def copy(self):
-        """Copy the current cursor.
-
-        Returns a new Cursor object with the same data and hotspot as the original.
-        """
+    def __copy__(self):
+        """Clone the current Cursor object.
+        You can do the same thing by doing Cursor(Cursor)."""
         return self.__class__(self)
 
-    __copy__ = copy
+    copy = __copy__
 
     def __hash__(self):
         return hash(tuple([self.type] + list(self.data)))
@@ -829,51 +715,25 @@ textmarker_strings = (
 
 
 def compile(strings, black="X", white=".", xor="o"):
-    """Create binary cursor data from simple strings.
+    """pygame.cursors.compile(strings, black, white, xor) -> data, mask
+    compile cursor strings into cursor data
 
-    A sequence of strings can be used to create binary cursor data for the
-    system cursor. This returns the binary data in the form of two tuples.
-    Those can be passed as the third and fourth arguments respectively of the
-    :func:`pygame.mouse.set_cursor()` function.
+    This takes a set of strings with equal length and computes
+    the binary data for that cursor. The string widths must be
+    divisible by 8.
 
-    If you are creating your own cursor strings, you can use any value represent
-    the black and white pixels. Some system allow you to set a special toggle
-    color for the system color, this is also called the xor color. If the system
+    The black and white arguments are single letter strings that
+    tells which characters will represent black pixels, and which
+    characters represent white pixels. All other characters are
+    considered clear.
+
+    Some systems allow you to set a special toggle color for the
+    system color, this is also called the xor color. If the system
     does not support xor cursors, that color will simply be black.
 
-    The height must be divisible by 8. The width of the strings must all be equal
-    and be divisible by 8. If these two conditions are not met, ``ValueError`` is
-    raised.
-    An example set of cursor strings looks like this
-
-    ::
-
-        thickarrow_strings = (               #sized 24x24
-          "XX                      ",
-          "XXX                     ",
-          "XXXX                    ",
-          "XX.XX                   ",
-          "XX..XX                  ",
-          "XX...XX                 ",
-          "XX....XX                ",
-          "XX.....XX               ",
-          "XX......XX              ",
-          "XX.......XX             ",
-          "XX........XX            ",
-          "XX........XXX           ",
-          "XX......XXXXX           ",
-          "XX.XXX..XX              ",
-          "XXXX XX..XX             ",
-          "XX   XX..XX             ",
-          "     XX..XX             ",
-          "      XX..XX            ",
-          "      XX..XX            ",
-          "       XXXX             ",
-          "       XX               ",
-          "                        ",
-          "                        ",
-          "                        ")
-
+    This returns a tuple containing the cursor data and cursor mask
+    data. Both these arguments are used when setting a cursor with
+    pygame.mouse.set_cursor().
     """
     # first check for consistent lengths
     size = len(strings[0]), len(strings)
@@ -913,21 +773,12 @@ def compile(strings, black="X", white=".", xor="o"):
 
 
 def load_xbm(curs, mask):
-    """Load cursor data from an XBM file.
+    """pygame.cursors.load_xbm(cursorfile, maskfile) -> cursor_args
+    reads a pair of XBM files into set_cursor arguments
 
-    This loads cursors for a simple subset of ``XBM`` files. ``XBM`` files are
-    traditionally used to store cursors on UNIX systems, they are an ASCII
-    format used to represent simple images.
-
-    Sometimes the black and white color values will be split into two separate
-    ``XBM`` files. You can pass a second maskfile argument to load the two
-    images into a single cursor.
-
-    The curs and mask arguments can either be filenames or file-like
-    object with the readlines method.
-
-    The return value cursor_args can be passed directly to the
-    ``pygame.mouse.set_cursor()`` function.
+    Arguments can either be filenames or filelike objects
+    with the readlines method. Not largely tested, but
+    should work with typical XBM files.
     """
 
     def bitswap(num):
diff --git a/.venv/lib/python3.14/site-packages/pygame/cursors.pyi b/.venv/lib/python3.14/site-packages/pygame/cursors.pyi
index 66e338c..7edc62b 100644
--- a/.venv/lib/python3.14/site-packages/pygame/cursors.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/cursors.pyi
@@ -1,13 +1,13 @@
-from collections.abc import Iterator
-from typing import Any, Literal, TypeAlias, overload
+from typing import Any, Iterator, Sequence, Tuple, Union, overload
 
 from pygame.surface import Surface
-from pygame.typing import FileLike, IntPoint, SequenceLike
 
-_SmallString: TypeAlias = tuple[
+from ._common import FileArg, Literal
+
+_Small_string = Tuple[
     str, str, str, str, str, str, str, str, str, str, str, str, str, str, str, str
 ]
-_BigString: TypeAlias = tuple[
+_Big_string = Tuple[
     str,
     str,
     str,
@@ -40,21 +40,21 @@ broken_x: Cursor
 tri_left: Cursor
 tri_right: Cursor
 ball: Cursor
-thickarrow_strings: _BigString
-sizer_x_strings: _SmallString
-sizer_y_strings: _BigString
-sizer_xy_strings: _SmallString
-textmarker_strings: _SmallString
+thickarrow_strings: _Big_string
+sizer_x_strings: _Small_string
+sizer_y_strings: _Big_string
+sizer_xy_strings: _Small_string
+textmarker_strings: _Small_string
 
 def compile(
-    strings: SequenceLike[str],
+    strings: Sequence[str],
     black: str = "X",
     white: str = ".",
     xor: str = "o",
-) -> tuple[tuple[int, ...], tuple[int, ...]]: ...
+) -> Tuple[Tuple[int, ...], Tuple[int, ...]]: ...
 def load_xbm(
-    curs: FileLike, mask: FileLike
-) -> tuple[tuple[int, int], tuple[int, int], tuple[int, ...], tuple[int, ...]]: ...
+    curs: FileArg, mask: FileArg
+) -> Tuple[Tuple[int, int], Tuple[int, int], Tuple[int, ...], Tuple[int, ...]]: ...
 
 class Cursor:
     @overload
@@ -64,26 +64,28 @@ class Cursor:
     @overload
     def __init__(
         self,
-        size: IntPoint,
-        hotspot: IntPoint,
-        xormasks: SequenceLike[int],
-        andmasks: SequenceLike[int],
+        size: Union[Tuple[int, int], Sequence[int]],
+        hotspot: Union[Tuple[int, int], Sequence[int]],
+        xormasks: Sequence[int],
+        andmasks: Sequence[int],
     ) -> None: ...
     @overload
     def __init__(
         self,
-        hotspot: IntPoint,
+        hotspot: Union[Tuple[int, int], Sequence[int]],
         surface: Surface,
     ) -> None: ...
     def __iter__(self) -> Iterator[Any]: ...
     def __len__(self) -> int: ...
     def __copy__(self) -> Cursor: ...
     def __hash__(self) -> int: ...
-    def __getitem__(self, index: int) -> int | IntPoint | Surface: ...
-    def copy(self) -> Cursor: ...
+    def __getitem__(
+        self, index: int
+    ) -> Union[int, Tuple[int, int], Sequence[int], Surface]: ...
+    copy = __copy__
     type: Literal["system", "color", "bitmap"]
-    data: (
-        tuple[int]
-        | tuple[tuple[int, int], tuple[int, int], tuple[int, ...], tuple[int, ...]]
-        | tuple[IntPoint, Surface]
-    )
+    data: Union[
+        Tuple[int],
+        Tuple[Tuple[int, int], Tuple[int, int], Tuple[int, ...], Tuple[int, ...]],
+        Tuple[Union[Tuple[int, int], Sequence[int]], Surface],
+    ]
diff --git a/.venv/lib/python3.14/site-packages/pygame/display.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/display.cpython-314-x86_64-linux-gnu.so
index bc18c19..7125eba 100755
Binary files a/.venv/lib/python3.14/site-packages/pygame/display.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/display.cpython-314-x86_64-linux-gnu.so differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/display.pyi b/.venv/lib/python3.14/site-packages/pygame/display.pyi
index 7622cf8..443a1f9 100644
--- a/.venv/lib/python3.14/site-packages/pygame/display.pyi
+++ b/.venv/lib/python3.14/site-packages/pygame/display.pyi
@@ -1,869 +1,77 @@
-"""Pygame module to control the display window and screen.
+from typing import Union, Tuple, List, Optional, Dict, Sequence, overload
 
-This module offers control over the pygame display. Pygame has a single display
-Surface that is either contained in a window or runs full screen. Once you
-create the display you treat it as a regular Surface. Changes are not
-immediately visible onscreen; you must choose one of the two flipping functions
-to update the actual display.
-
-The origin of the display, where x = 0 and y = 0, is the top left of the
-screen. Both axes increase positively towards the bottom right of the screen.
-
-The pygame display can actually be initialized in one of several modes. By
-default, the display is a basic software driven framebuffer. You can request
-special modules like automatic scaling or OpenGL support. These are
-controlled by flags passed to ``pygame.display.set_mode()``.
-
-Pygame can only have a single display active at any time. Creating a new one
-with ``pygame.display.set_mode()`` will close the previous display. To detect
-the number and size of attached screens, you can use
-``pygame.display.get_desktop_sizes`` and then select appropriate window size
-and display index to pass to ``pygame.display.set_mode()``.
-
-For backward compatibility ``pygame.display`` allows precise control over
-the pixel format or display resolutions. This used to be necessary with old
-graphics cards and CRT screens, but is usually not needed any more. Use the
-functions ``pygame.display.mode_ok()``, ``pygame.display.list_modes()``, and
-``pygame.display.Info()`` to query detailed information about the display.
-
-Once the display Surface is created, the functions from this module affect the
-single existing display. The Surface becomes invalid if the module is
-uninitialized. If a new display mode is set, the existing Surface will
-automatically switch to operate on the new display.
-
-When the display mode is set, several events are placed on the pygame event
-queue. ``pygame.QUIT`` is sent when the user has requested the program to
-shut down. The window will receive ``pygame.ACTIVEEVENT`` events as the display
-gains and loses input focus. If the display is set to be resizable with the
-``pygame.RESIZABLE`` flag, ``pygame.VIDEORESIZE`` event(s) will be sent when the
-user adjusts the window dimensions. Depending on your platform, this may be
-multiple gradual events or one event at the end (Windows). Hardware displays
-that draw direct to the screen will get ``pygame.VIDEOEXPOSE`` events when
-portions of the window must be redrawn.
-
-A new windowevent API was introduced in pygame 2.0.1. Check event module docs
-for more information on that
-
-Some display environments have an option for automatically stretching all
-windows. When this option is enabled, this automatic stretching distorts the
-appearance of the pygame window. In the pygame examples directory, there is
-example code (prevent_display_stretching.py) which shows how to disable this
-automatic stretching of the pygame display on Microsoft Windows (Vista or newer
-required).
-"""
-
-from collections.abc import Iterable
-from typing import Literal, overload
-
-from pygame._sdl2 import Window
-from pygame.constants import FULLSCREEN
 from pygame.surface import Surface
-from pygame.typing import (
-    ColorLike,
-    IntPoint,
-    Point,
-    RectLike,
-    SequenceLike,
-)
-from typing_extensions import deprecated  # added in 3.13
+from pygame.constants import FULLSCREEN
+from ._common import Coordinate, RectValue, ColorValue, RGBAOutput
 
 class _VidInfo:
-    @property
-    def hw(self) -> int: ...
-    @property
-    def wm(self) -> int: ...
-    @property
-    def video_mem(self) -> int: ...
-    @property
-    def bitsize(self) -> int: ...
-    @property
-    def bytesize(self) -> int: ...
-    @property
-    def masks(self) -> tuple[int, int, int, int]: ...
-    @property
-    def shifts(self) -> tuple[int, int, int, int]: ...
-    @property
-    def losses(self) -> tuple[int, int, int, int]: ...
-    @property
-    def blit_hw(self) -> int: ...
-    @property
-    def blit_hw_CC(self) -> int: ...
-    @property
-    def blit_hw_A(self) -> int: ...
-    @property
-    def blit_sw(self) -> int: ...
-    @property
-    def blit_sw_CC(self) -> int: ...
-    @property
-    def blit_sw_A(self) -> int: ...
-    @property
-    def current_h(self) -> int: ...
-    @property
-    def current_w(self) -> int: ...
-    @property
-    def pixel_format(self) -> str: ...
-
-def init() -> None:
-    """Initialize the display module.
-
-    Initializes the pygame display module. The display module cannot do anything
-    until it is initialized. This is usually handled for you automatically when
-    you call the higher level ``pygame.init()``.
-
-    Pygame will select from one of several internal display backends when it is
-    initialized. The display mode will be chosen depending on the platform and
-    permissions of current user. Before the display module is initialized the
-    environment variable ``SDL_VIDEODRIVER`` can be set to control which backend
-    is used. The systems with multiple choices are listed here.
-
-    ::
-
-        Windows : windib, directx
-        Unix    : x11, dga, fbcon, directfb, ggi, vgl, svgalib, aalib, wayland
-
-    :note: On wayland desktops, pygame-ce may choose to use the X11 video driver to run on Xwayland.
-        This behaviour is determined by the SDL library and might change in the future, so it's suggested
-        to account for this and not rely on the default behavior. The Wayland video driver can be forced
-        by setting the ``SDL_VIDEODRIVER`` environment variable to ``"wayland"``
-
-    On some platforms it is possible to embed the pygame display into an already
-    existing window. To do this, the environment variable ``SDL_WINDOWID`` must
-    be set to a string containing the window id or handle. The environment
-    variable is checked when the pygame display is initialized. Be aware that
-    there can be many strange side effects when running in an embedded display.
-
-    It is harmless to call this more than once, repeated calls have no effect.
-
-    .. versionchanged:: 2.5.0 the manylinux wheels distributed by us now support the ``wayland`` videodriver
-
-    """
-
-def quit() -> None:
-    """Uninitialize the display module.
-
-    This will shut down the entire display module. This means any active
-    displays will be closed. This will also be handled automatically when the
-    program exits.
-
-    It is harmless to call this more than once, repeated calls have no effect.
-    """
-
-def get_init() -> bool:
-    """Returns True if the display module has been initialized.
-
-    Returns True if the :mod:`pygame.display` module is currently initialized.
-    """
+    hw: int
+    wm: int
+    video_mem: int
+    bitsize: int
+    bytesize: int
+    masks: RGBAOutput
+    shifts: RGBAOutput
+    losses: RGBAOutput
+    blit_hw: int
+    blit_hw_CC: int
+    blit_hw_A: int
+    blit_sw: int
+    blit_sw_CC: int
+    blit_sw_A: int
+    current_h: int
+    current_w: int
 
+def init() -> None: ...
+def quit() -> None: ...
+def get_init() -> bool: ...
 def set_mode(
-    size: Point = (0, 0),
+    size: Coordinate = (0, 0),
     flags: int = 0,
     depth: int = 0,
     display: int = 0,
     vsync: int = 0,
-) -> Surface:
-    """Initialize a window or screen for display.
-
-    This will create a window or display output and return a display Surface.
-    The arguments passed in are requests for a display type. The actual created
-    display will be the best possible match supported by the system.
-
-    Note that calling this function implicitly initializes ``pygame.display``, if
-    it was not initialized before.
-
-    The size argument is a pair of numbers representing the width and
-    height. The flags argument is a collection of additional options. The depth
-    argument represents the number of bits to use for color.
-
-    The Surface that gets returned can be drawn to like a regular Surface but
-    changes will eventually be seen on the monitor.
-
-    If no size is passed or is set to ``(0, 0)``, the created Surface will have
-    the same size as the current screen resolution. If only the width or height
-    are set to ``0``, the Surface will have the same width or height as the
-    screen resolution.
-
-    Since pygame 2, the depth argument is ignored, in favour of the best
-    and fastest one. It also raises a deprecation warning since pygame-ce
-    2.4.0 if the passed in depth is not 0 or the one pygame selects.
-
-    When requesting fullscreen display modes, sometimes an exact match for the
-    requested size cannot be made. In these situations pygame will select
-    the closest compatible match. The returned surface will still always match
-    the requested size.
-
-    On high resolution displays(4k, 1080p) and tiny graphics games (640x480)
-    show up very small so that they are unplayable. SCALED scales up the window
-    for you. The game thinks it's a 640x480 window, but really it can be bigger.
-    Mouse events are scaled for you, so your game doesn't need to do it. Note
-    that SCALED is considered an experimental API and may change in future
-    releases.
-
-    The flags argument controls which type of display you want. There are
-    several to choose from, and you can even combine multiple types using the
-    bitwise or operator, (the pipe "|" character). Here are the display
-    flags you will want to choose from:
-
-    ::
-
-        pygame.FULLSCREEN    create a fullscreen display
-        pygame.DOUBLEBUF     only applicable with OPENGL
-        pygame.HWSURFACE     (obsolete in pygame 2) hardware accelerated, only in FULLSCREEN
-        pygame.OPENGL        create an OpenGL-renderable display
-        pygame.RESIZABLE     display window should be sizeable
-        pygame.NOFRAME       display window will have no border or controls
-        pygame.SCALED        resolution depends on desktop size and scale graphics
-        pygame.SHOWN         window is opened in visible mode (default)
-        pygame.HIDDEN        window is opened in hidden mode
-
-
-    .. versionaddedold:: 2.0.0 ``SCALED``, ``SHOWN`` and ``HIDDEN``
-
-    .. versionaddedold:: 2.0.0 ``vsync`` parameter
-
-    By setting the ``vsync`` parameter to ``1``, it is possible to get a display
-    with vertical sync at a constant frame rate determined by the monitor and
-    graphics drivers. Subsequent calls to :func:`pygame.display.flip()` or
-    :func:`pygame.display.update()` will block (i.e. *wait*) until the screen
-    has refreshed, in order to prevent "screen tearing"
-    .
-
-    Be careful when using this feature together with ``pygame.time.Clock`` or
-    :func:`pygame.time.delay()`, as multiple forms of waiting and frame rate
-    limiting may interact to cause skipped frames.
-
-    The request only works when graphics acceleration is available on the
-    system. The exact behaviour depends on the hardware and driver
-    configuration. When  ``vsync`` is requested, but unavailable,
-    ``set_mode()`` may raise an exception.
-
-    Setting the ``vsync`` parameter to ``-1`` in conjunction with  ``OPENGL``
-    will request the OpenGL-specific feature "adaptive vsync" .
-
-    Here is an example usage of a call
-    to ``set_mode()`` that may give you a display with vsync:
-
-    ::
-
-        flags = pygame.OPENGL | pygame.FULLSCREEN
-        try:
-            window_surface = pygame.display.set_mode((1920, 1080), flags, vsync=1)
-            vsync_success=True
-        except pygame.error:
-            window_surface = pygame.display.set_mode((1920, 1080), flags)
-            vsync_success=False
-
-    .. versionaddedold:: 2.0.0 ``vsync`` parameter
-
-    .. versionchanged:: 2.2.0 passing ``vsync`` can raise an exception
-
-    .. versionchanged:: 2.2.0 explicit request for "adaptive vsync"
-
-    .. versionchanged:: 2.2.0 ``vsync=1`` does not require ``SCALED`` or ``OPENGL``
-
-    .. deprecated:: 2.4.0 The depth argument is ignored, and will be set to the optimal value
-
-    .. versionchanged:: 2.5.0 No longer emits warning when running on xwayland, see :func:`pygame.display.init` for details on running on wayland directly
-
-    Basic example:
-
-    ::
-
-        # Open a window on the screen
-        screen_width=700
-        screen_height=400
-        screen=pygame.display.set_mode([screen_width, screen_height])
-
-    The display index ``0`` means the default display is used. If no display
-    index argument is provided, the default display can be overridden with an
-    environment variable.
-
-
-    .. versionchangedold:: 1.9.5 ``display`` argument added
-
-    .. versionchanged:: 2.1.3
-        pygame now ensures that subsequent calls to this function clears the
-        window to black. On older versions, this was an implementation detail
-        on the major platforms this function was tested with.
-    """
-
-def get_surface() -> Surface | None:
-    """Get a reference to the currently set display surface.
-
-    Return a reference to the currently set display Surface. If no display mode
-    has been set this will return None.
-    """
-
-def flip() -> None:
-    """Update the full display Surface to the screen.
-
-    This will update the contents of the entire display.
-
-    When using an ``pygame.OPENGL`` display mode this will perform a gl buffer
-    swap.
-    """
-
+) -> Surface: ...
+def get_surface() -> Surface: ...
+def flip() -> None: ...
 @overload
-def update() -> None: ...
+def update(
+    rectangle: Optional[Union[RectValue, Sequence[Optional[RectValue]]]] = None
+) -> None: ...
 @overload
-def update(rectangle: RectLike | None, /) -> None: ...
+def update(x: int, y: int, w: int, h: int) -> None: ...
 @overload
-def update(rectangles: Iterable[RectLike | None], /) -> None: ...
-@overload
-def update(x: float, y: float, w: float, h: float, /) -> None: ...
-@overload
-def update(xy: Point, wh: Point, /) -> None: ...
-def update(*args):  # type: ignore
-    """Update all, or a portion, of the display. For non-OpenGL displays.
-
-    For non OpenGL display Surfaces, this function is very similar to
-    ``pygame.display.flip()`` with an optional parameter that allows only
-    portions of the display surface to be updated, instead of the entire area.
-    If no argument is passed it updates the entire Surface area like
-    ``pygame.display.flip()``.
-
-    .. note:: calling ``display.update(None)`` means no part of the window is
-        updated. Whereas ``display.update()`` means the whole window is
-        updated.
-
-    You can pass the function a single rectangle, or an iterable of rectangles.
-    Generally you do not want to pass an iterable of rectangles as there is a
-    performance cost per rectangle passed to the function. On modern hardware,
-    after a very small number of rectangles passed in, the per-rectangle cost
-    will exceed the saving of updating less pixels. In most applications it is
-    simply more efficient to update the entire display surface at once, it also
-    means  you do not need to keep track of a list of rectangles for each call
-    to update.
-
-    If passing an iterable of rectangles it is safe to include None
-    values in the list, which will be skipped.
-
-    This call cannot be used on ``pygame.OPENGL`` displays and will generate an
-    exception.
-
-    .. versionchanged:: 2.5.1 Added support for passing an iterable, previously only sequence was allowed
-    """
-
-def get_driver() -> str:
-    """Get the name of the pygame display backend.
-
-    Pygame chooses one of many available display backends when it is
-    initialized. This returns the internal name used for the display backend.
-    This can be used to provide limited information about what display
-    capabilities might be accelerated. See the ``SDL_VIDEODRIVER`` flags in
-    ``pygame.display.init()`` to see some of the common options.
-    """
-
-def Info() -> _VidInfo:
-    """Create a video display information object.
-
-    Creates a simple object containing several attributes to describe the
-    current graphics environment. If this is called before
-    ``pygame.display.set_mode()`` some platforms can provide information about
-    the default display mode. This can also be called after setting the display
-    mode to verify specific display options were satisfied. The VidInfo object
-    has several attributes:
-
-    .. code-block:: text
-
-      hw:         1 if the display is hardware accelerated
-      wm:         1 if windowed display modes can be used
-      video_mem:  The megabytes of video memory on the display.
-                  This is 0 if unknown
-      bitsize:    Number of bits used to store each pixel
-      bytesize:   Number of bytes used to store each pixel
-      masks:      Four values used to pack RGBA values into pixels
-      shifts:     Four values used to pack RGBA values into pixels
-      losses:     Four values used to pack RGBA values into pixels
-      blit_hw:    1 if hardware Surface blitting is accelerated
-      blit_hw_CC: 1 if hardware Surface colorkey blitting is accelerated
-      blit_hw_A:  1 if hardware Surface pixel alpha blitting is
-                  accelerated
-      blit_sw:    1 if software Surface blitting is accelerated
-      blit_sw_CC: 1 if software Surface colorkey blitting is
-                  accelerated
-      blit_sw_A:  1 if software Surface pixel alpha blitting is
-                  accelerated
-      current_h, current_w:  Height and width of the current video
-                  mode, or of the desktop mode if called before
-                  the display.set_mode is called. They are -1 on error.
-      pixel_format: The pixel format of the display Surface as a string.
-                  E.g PIXELFORMAT_RGB888.
-
-    .. versionchanged:: 2.4.0 ``pixel_format`` attribute added.
-    """
-
-def get_wm_info() -> dict[str, int]:
-    """Get information about the current windowing system.
-
-    Creates a dictionary filled with string keys. The strings and values are
-    arbitrarily created by the system. Some systems may have no information and
-    an empty dictionary will be returned. Most platforms will return a "window"
-    key with the value set to the system id for the current display.
-
-    .. versionaddedold:: 1.7.1
-    """
-
-def get_desktop_sizes() -> list[tuple[int, int]]:
-    """Get sizes of active desktops.
-
-    This function returns the sizes of the currently configured
-    virtual desktops as a list of (x, y) tuples of integers.
-
-    The length of the list is not the same as the number of attached monitors,
-    as a desktop can be mirrored across multiple monitors. The desktop sizes
-    do not indicate the maximum monitor resolutions supported by the hardware,
-    but the desktop size configured in the operating system.
-
-    In order to fit windows into the desktop as it is currently configured, and
-    to respect the resolution configured by the operating system in fullscreen
-    mode, this function *should* be used to replace many use cases of
-    ``pygame.display.list_modes()`` whenever applicable.
-
-    .. versionaddedold:: 2.0.0
-    """
-
+def update(xy: Coordinate, wh: Coordinate) -> None: ...
+def get_driver() -> str: ...
+def Info() -> _VidInfo: ...
+def get_wm_info() -> Dict[str, int]: ...
 def list_modes(
     depth: int = 0,
     flags: int = FULLSCREEN,
     display: int = 0,
-) -> list[tuple[int, int]]:
-    """Get list of available fullscreen modes.
-
-    This function returns a list of possible sizes for a specified color
-    depth. The return value will be an empty list if no display modes are
-    available with the given arguments. A return value of ``-1`` means that
-    any requested size should work (this is likely the case for windowed
-    modes). Mode sizes are sorted from biggest to smallest.
-
-    If depth is ``0``, the current/best color depth for the display is used.
-    The flags defaults to ``pygame.FULLSCREEN``, but you may need to add
-    additional flags for specific fullscreen modes.
-
-    The display index ``0`` means the default display is used.
-
-    Since pygame 2.0, ``pygame.display.get_desktop_sizes()`` has taken over
-    some use cases from ``pygame.display.list_modes()``:
-
-    To find a suitable size for non-fullscreen windows, it is preferable to
-    use ``pygame.display.get_desktop_sizes()`` to get the size of the *current*
-    desktop, and to then choose a smaller window size. This way, the window is
-    guaranteed to fit, even when the monitor is configured to a lower resolution
-    than the maximum supported by the hardware.
-
-    To avoid changing the physical monitor resolution, it is also preferable to
-    use ``pygame.display.get_desktop_sizes()`` to determine the fullscreen
-    resolution. Developers are strongly advised to default to the current
-    physical monitor resolution unless the user explicitly requests a different
-    one (e.g. in an options menu or configuration file).
-
-    .. versionchangedold:: 1.9.5 ``display`` argument added
-    """
-
+) -> List[Tuple[int, int]]: ...
 def mode_ok(
-    size: IntPoint,
+    size: Union[Sequence[int], Tuple[int, int]],
     flags: int = 0,
     depth: int = 0,
     display: int = 0,
-) -> int:
-    """Pick the best color depth for a display mode.
-
-    This function uses the same arguments as ``pygame.display.set_mode()``. It
-    is used to determine if a requested display mode is available. It will
-    return ``0`` if the display mode cannot be set. Otherwise it will return a
-    pixel depth that best matches the display asked for.
-
-    Usually the depth argument is not passed, but some platforms can support
-    multiple display depths. If passed it will hint to which depth is a better
-    match.
-
-    The function will return ``0`` if the passed display flags cannot be set.
-
-    The display index ``0`` means the default display is used.
-
-    .. versionchangedold:: 1.9.5 ``display`` argument added
-    """
-
-def gl_get_attribute(flag: int, /) -> int:
-    """Get the value for an OpenGL flag for the current display.
-
-    After calling ``pygame.display.set_mode()`` with the ``pygame.OPENGL`` flag,
-    it is a good idea to check the value of any requested OpenGL attributes. See
-    ``pygame.display.gl_set_attribute()`` for a list of valid flags.
-    """
-
-def gl_set_attribute(flag: int, value: int, /) -> None:
-    """Request an OpenGL display attribute for the display mode.
-
-    When calling ``pygame.display.set_mode()`` with the ``pygame.OPENGL`` flag,
-    Pygame automatically handles setting the OpenGL attributes like color and
-    double-buffering. OpenGL offers several other attributes you may want control
-    over. Pass one of these attributes as the flag, and its appropriate value.
-    This must be called before ``pygame.display.set_mode()``.
-
-    Many settings are the requested minimum. Creating a window with an OpenGL context
-    will fail if OpenGL cannot provide the requested attribute, but it may for example
-    give you a stencil buffer even if you request none, or it may give you a larger
-    one than requested.
-
-    The ``OPENGL`` flags are
-
-    ::
-
-        GL_ALPHA_SIZE, GL_DEPTH_SIZE, GL_STENCIL_SIZE, GL_ACCUM_RED_SIZE,
-        GL_ACCUM_GREEN_SIZE,  GL_ACCUM_BLUE_SIZE, GL_ACCUM_ALPHA_SIZE,
-        GL_MULTISAMPLEBUFFERS, GL_MULTISAMPLESAMPLES, GL_STEREO
-
-    :const:`GL_MULTISAMPLEBUFFERS`
-
-        Whether to enable multisampling anti-aliasing.
-        Defaults to 0 (disabled).
-        Set ``GL_MULTISAMPLESAMPLES`` to a value
-        above 0 to control the amount of anti-aliasing.
-        A typical value is 2 or 3.
-
-    :const:`GL_STENCIL_SIZE`
-
-        Minimum bit size of the stencil buffer. Defaults to 0.
-
-    :const:`GL_DEPTH_SIZE`
-
-        Minimum bit size of the depth buffer. Defaults to 16.
-
-    :const:`GL_STEREO`
-
-        1 enables stereo 3D. Defaults to 0.
-
-    :const:`GL_BUFFER_SIZE`
-
-        Minimum bit size of the frame buffer. Defaults to 0.
-
-    .. versionaddedold:: 2.0.0 Additional attributes:
-
-    ::
-
-        GL_ACCELERATED_VISUAL,
-        GL_CONTEXT_MAJOR_VERSION, GL_CONTEXT_MINOR_VERSION,
-        GL_CONTEXT_FLAGS, GL_CONTEXT_PROFILE_MASK,
-        GL_SHARE_WITH_CURRENT_CONTEXT,
-        GL_CONTEXT_RELEASE_BEHAVIOR,
-        GL_FRAMEBUFFER_SRGB_CAPABLE
-
-    :const:`GL_CONTEXT_PROFILE_MASK`
-
-        Sets the OpenGL profile to one of these values:
-
-        ::
-
-            GL_CONTEXT_PROFILE_CORE             disable deprecated features
-            GL_CONTEXT_PROFILE_COMPATIBILITY    allow deprecated features
-            GL_CONTEXT_PROFILE_ES               allow only the ES feature
-                                                subset of OpenGL
-
-    :const:`GL_ACCELERATED_VISUAL`
-
-        Set to 1 to require hardware acceleration, or 0 to force software render.
-        By default, both are allowed.
-    """
-
-def get_active() -> bool:
-    """Returns True when the display is active on the screen.
-
-    Returns True when the display Surface is considered actively
-    renderable on the screen and may be visible to the user. This is
-    the default state immediately after ``pygame.display.set_mode()``.
-    This method may return True even if the application is fully hidden
-    behind another application window.
-
-    This will return False if the display Surface has been iconified or
-    minimized (either via ``pygame.display.iconify()`` or via an OS
-    specific method such as the minimize-icon available on most
-    desktops).
-
-    The method can also return False for other reasons without the
-    application being explicitly iconified or minimized by the user.  A
-    notable example being if the user has multiple virtual desktops and
-    the display Surface is not on the active virtual desktop.
-
-    .. note:: This function returning True is unrelated to whether the
-        application has input focus.  Please see
-        ``pygame.key.get_focused()`` and ``pygame.mouse.get_focused()``
-        for APIs related to input focus.
-    """
-
-def iconify() -> bool:
-    """Iconify the display surface.
-
-    Request the window for the display surface be iconified or hidden. Not all
-    systems and displays support an iconified display. The function will return
-    True if successful.
-
-    When the display is iconified ``pygame.display.get_active()`` will return
-    ``False``. The event queue should receive an ``ACTIVEEVENT`` event when the
-    window has been iconified. Additionally, the event queue also receives a
-    ``WINDOWEVENT_MINIMIZED`` event when the window has been iconified on pygame 2.
-    """
-
-def toggle_fullscreen() -> int:
-    """Switch between fullscreen and windowed displays.
-
-    Switches the display window between windowed and fullscreen modes.
-    Display driver support is not great when using pygame 1, but with
-    pygame 2 it is the most reliable method to switch to and from fullscreen.
-
-    Supported display drivers in pygame 1:
-
-        * x11 (Linux/Unix)
-        * wayland (Linux/Unix)
-
-    Supported display drivers in pygame 2:
-
-        * windows (Windows)
-        * x11 (Linux/Unix)
-        * wayland (Linux/Unix)
-        * cocoa (OSX/Mac)
-
-    .. note:: :func:`toggle_fullscreen` doesn't work on Windows
-        unless the window size is in :func:`pygame.display.list_modes()` or
-        the window is created with the flag ``pygame.SCALED``.
-        See `issue #1221 `_.
-    """
-
-@deprecated("since 2.1.4. Removed in SDL3")
-def set_gamma(red: float, green: float = ..., blue: float = ..., /) -> bool:
-    """Change the hardware gamma ramps.
-
-    DEPRECATED: This functionality will go away in SDL3.
-
-    Set the red, green, and blue gamma values on the display hardware. If the
-    green and blue arguments are not passed, they will both be the same as red.
-    Not all systems and hardware support gamma ramps, if the function succeeds
-    it will return ``True``.
-
-    A gamma value of ``1.0`` creates a linear color table. Lower values will
-    darken the display and higher values will brighten.
-
-    .. deprecated:: 2.1.4
-    """
-
-@deprecated("since 2.1.4. Removed in SDL3")
+) -> int: ...
+def gl_get_attribute(flag: int) -> int: ...
+def gl_set_attribute(flag: int, value: int) -> None: ...
+def get_active() -> bool: ...
+def iconify() -> bool: ...
+def toggle_fullscreen() -> int: ...
+def set_gamma(red: float, green: float = ..., blue: float = ...) -> int: ...
 def set_gamma_ramp(
-    red: SequenceLike[int], green: SequenceLike[int], blue: SequenceLike[int], /
-) -> bool:
-    """Change the hardware gamma ramps with a custom lookup.
-
-    DEPRECATED: This functionality will go away in SDL3.
-
-    Set the red, green, and blue gamma ramps with an explicit lookup table. Each
-    argument should be sequence of 256 integers. The integers should range
-    between ``0`` and ``0xffff``. Not all systems and hardware support gamma
-    ramps, if the function succeeds it will return ``True``.
-
-    .. deprecated:: 2.1.4
-    """
-
-def set_icon(surface: Surface, /) -> None:
-    """Change the system image for the display window.
-
-    Sets the runtime icon the system will use to represent the display window.
-    All windows default to a simple pygame logo for the window icon.
-
-    Note that calling this function implicitly initializes ``pygame.display``, if
-    it was not initialized before.
-
-    You can pass any surface, but most systems want a smaller image around
-    32x32. The image can have colorkey transparency which will be passed to the
-    system.
-
-    Some systems do not allow the window icon to change after it has been shown.
-    This function can be called before ``pygame.display.set_mode()`` to create
-    the icon before the display mode is set.
-    """
-
-def set_caption(title: str, icontitle: str | None = None, /) -> None:
-    """Set the current window caption.
-
-    If the display has a window title, this function will change the name on the
-    window. In pygame 1.x, some systems supported an alternate shorter title to
-    be used for minimized displays, but in pygame 2 ``icontitle`` does nothing.
-    """
-
-def get_caption() -> tuple[str, str]:
-    """Get the current window caption.
-
-    Returns the title and icontitle of the display window. In pygame 2.x
-    these will always be the same value.
-    """
-
-def set_palette(palette: SequenceLike[ColorLike], /) -> None:
-    """Set the display color palette for indexed displays.
-
-    This will change the video display color palette for 8-bit displays. This
-    does not change the palette for the actual display Surface, only the palette
-    that is used to display the Surface. If no palette argument is passed, the
-    system default palette will be restored. The palette is a sequence of
-    ``RGB`` triplets.
-    """
-
-def get_num_displays() -> int:
-    """Return the number of displays.
-
-    Returns the number of available displays. This is always 1 if
-    :func:`pygame.get_sdl_version()` returns a major version number below 2.
-
-    .. versionaddedold:: 1.9.5
-    """
-
-def get_window_size() -> tuple[int, int]:
-    """Return the size of the window or screen.
-
-    Returns the size of the window initialized with :func:`pygame.display.set_mode()`.
-    This may differ from the size of the display surface if ``SCALED`` is used.
-
-    .. versionaddedold:: 2.0.0
-    """
-
-def get_window_position() -> tuple[int, int]:
-    """Return the position of the window or screen.
-
-    Returns the position of the window initialized with :func:`pygame.display.set_mode()`.
-    The position will change when the user moves the window or when the
-    position is set manually with :func:`pygame.display.set_window_position()`.
-    Coordinates could be negative or outside the desktop size bounds. The
-    position is relative to the topleft of the primary monitor and the y coordinate
-    ignores the window frame.
-
-    .. versionadded:: 2.5.0
-    """
-
-def set_window_position(position: Point) -> None:
-    """Set the current window position.
-
-    Sets the position of the window initialized with :func:`pygame.display.set_mode()`.
-    This differs from updating environment variables as this function can be
-    called after the display has been initialised. The position is expected to
-    be relative to the topleft of the primary monitor. The y coordinate will
-    ignore the window frame (y = 0 means the frame is hidden). The user will
-    still be able to move the window after this call. See also
-    :func:`pygame.display.get_window_position()`.
-
-    .. note:: This function is not supported on some video drivers (like wayland)
-        and a :exc:`pygame.error` exception may be raised in such cases.
-
-    .. versionadded:: 2.5.0
-    """
-
-def get_allow_screensaver() -> bool:
-    """Return whether the screensaver is allowed to run.
-
-    Return whether screensaver is allowed to run whilst the app is running. Default
-    is ``False``. By default pygame does not allow the screensaver during game
-    play.
-
-    .. note:: Some platforms do not have a screensaver or support
-        disabling the screensaver.  Please see
-        :func:`pygame.display.set_allow_screensaver()` for
-        caveats with screensaver support.
-
-    .. versionaddedold:: 2.0.0
-    """
-
-def set_allow_screensaver(value: bool = True) -> None:
-    """Set whether the screensaver may run.
-
-    Change whether screensavers should be allowed whilst the app is running.
-    The default value of the argument to the function is True.
-    By default pygame does not allow the screensaver during game play.
-
-    If the screensaver has been disallowed due to this function, it will automatically
-    be allowed to run when :func:`pygame.quit()` is called.
-
-    It is possible to influence the default value via the environment variable
-    ``SDL_HINT_VIDEO_ALLOW_SCREENSAVER``, which can be set to either ``0`` (disable)
-    or ``1`` (enable).
-
-    .. note:: Disabling screensaver is subject to platform support.
-        When platform support is absent, this function will
-        silently appear to work even though the screensaver state
-        is unchanged. The lack of feedback is due to SDL not
-        providing any supported method for determining whether
-        it supports changing the screensaver state.
-
-    .. versionaddedold:: 2.0.0
-    """
-
-def is_fullscreen() -> bool:
-    """Returns True if the pygame window created by pygame.display.set_mode() is in full-screen mode.
-
-    Edge cases:
-    If the window is in windowed mode, but maximized, this will return `False`.
-    If the window is in "borderless fullscreen" mode, this will return `True`.
-
-    .. versionadded:: 2.2.0
-    """
-
-def is_vsync() -> bool:
-    """Returns True if vertical synchronisation for pygame.display.flip() and pygame.display.update() is enabled.
-
-    .. versionadded:: 2.2.0
-    """
-
-def get_current_refresh_rate() -> int:
-    """Returns the screen refresh rate or 0 if unknown.
-
-    The screen refresh rate for the current window. In windowed mode, this
-    should be equal to the refresh rate of the desktop the window is on.
-
-    If no window is open, an exception is raised.
-
-    When a constant refresh rate cannot be determined, 0 is returned.
-
-    .. versionadded:: 2.2.0
-    """
-
-def get_desktop_refresh_rates() -> list[int]:
-    """Returns the screen refresh rates for all displays (in windowed mode).
-
-    If the current window is in full-screen mode, the actual refresh rate for
-    that window can differ.
-
-    This is safe to call when no window is open (i.e. before any calls to
-    :func:`pygame.display.set_mode()`
-
-    When a constant refresh rate cannot be determined, 0 is returned for that
-    desktop.
-
-    .. versionadded:: 2.2.0
-    """
-
-def message_box(
-    title: str,
-    message: str | None = None,
-    message_type: Literal["info", "warn", "error"] = "info",
-    parent_window: Window | None = None,
-    buttons: SequenceLike[str] = ("OK",),
-    return_button: int = 0,
-    escape_button: int | None = None,
-) -> int:
-    """Create a native GUI message box.
-
-    :param str title: A title string.
-    :param str message: A message string. If this parameter is set to ``None``, the message will be the title.
-    :param str message_type: Set the type of message_box, could be ``"info"``, ``"warn"`` or ``"error"``.
-    :param pygame.Window parent_window: The parent window of the message box.
-    :param tuple buttons: An optional sequence of button name strings to show to the user.
-    :param int return_button: Button index to use if the return key is hit, ``0`` by default.
-    :param int escape_button: Button index to use if the escape key is hit, ``None`` for no button linked by default.
-
-    :return: The index of the button that was pushed.
-
-    This function should be called on the thread that ``set_mode()`` is called.
-    It will block execution of that thread until the user clicks a button or
-    closes the message_box.
-
-    This function may be called at any time, even before ``pygame.init()``.
-
-    Negative values of ``return_button`` and ``escape_button`` are allowed
-    just like standard Python list indexing.
-
-    .. versionadded:: 2.4.0
-    """
+    red: Sequence[int], green: Sequence[int], blue: Sequence[int]
+) -> int: ...
+def set_icon(surface: Surface) -> None: ...
+def set_caption(title: str, icontitle: Optional[str] = None) -> None: ...
+def get_caption() -> Tuple[str, str]: ...
+def set_palette(palette: Sequence[ColorValue]) -> None: ...
+def get_num_displays() -> int: ...
+def get_window_size() -> Tuple[int, int]: ...
+def get_allow_screensaver() -> bool: ...
+def set_allow_screensaver(value: bool = True) -> None: ...
+def get_desktop_sizes() -> List[Tuple[int, int]]: ...
+def is_fullscreen() -> bool: ...
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/__init__.py b/.venv/lib/python3.14/site-packages/pygame/docs/__init__.py
deleted file mode 100644
index fbe690c..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/__init__.py
+++ /dev/null
@@ -1,10 +0,0 @@
-# python -m pygame.docs
-
-from pathlib import Path
-
-PKG_DIR = Path(__file__).absolute().parent / "generated"
-
-
-# for test suite to confirm pygame-ce built with local docs
-def has_local_docs():
-    return PKG_DIR.exists()
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/__main__.py b/.venv/lib/python3.14/site-packages/pygame/docs/__main__.py
index c270c15..249b65e 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/__main__.py
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/__main__.py
@@ -1,17 +1,37 @@
-import platform
+# python -m pygame.docs
 
-# use relative import here and not absolute, so that `python -m docs` works at
-# development time
-from .serve import main as serve
-from .static import main as static
+import os
+import webbrowser
+from urllib.parse import quote, urlunparse
 
 
-def main():
-    if platform.system() == "Linux":
-        serve()
+def _iterpath(path):
+    path, last = os.path.split(path)
+    if last:
+        yield from _iterpath(path)
+        yield last
+
+
+# for test suite to confirm pygame built with local docs
+def has_local_docs():
+    pkg_dir = os.path.dirname(os.path.abspath(__file__))
+    main_page = os.path.join(pkg_dir, "generated", "index.html")
+    return os.path.exists(main_page)
+
+
+def open_docs():
+    pkg_dir = os.path.dirname(os.path.abspath(__file__))
+    main_page = os.path.join(pkg_dir, "generated", "index.html")
+    if os.path.exists(main_page):
+        url_path = quote("/".join(_iterpath(main_page)))
+        drive, rest = os.path.splitdrive(__file__)
+        if drive:
+            url_path = f"{drive}/{url_path}"
+        url = urlunparse(("file", "", url_path, "", "", ""))
     else:
-        static()
+        url = "https://www.pygame.org/docs/"
+    webbrowser.open(url)
 
 
 if __name__ == "__main__":
-    main()
+    open_docs()
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/chimpshot.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/chimpshot.webp
deleted file mode 100644
index 7cf15f8..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/chimpshot.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/draw_module_example.png b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/draw_module_example.png
index 7997a68..42d6ed1 100644
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/draw_module_example.png and b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/draw_module_example.png differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/intro_ball.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/intro_ball.webp
deleted file mode 100644
index 6c4eca9..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/intro_ball.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/premultiplied_alpha_composition.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/premultiplied_alpha_composition.webp
deleted file mode 100644
index e39db1a..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/premultiplied_alpha_composition.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/project.png b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/project.png
deleted file mode 100644
index 3177bf0..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/project.png and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/project_clamp.png b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/project_clamp.png
deleted file mode 100644
index e3447bc..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/project_clamp.png and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_lofi.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_lofi.webp
deleted file mode 100644
index 48cddf2..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_lofi.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_logo.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_logo.webp
deleted file mode 100644
index d930bd1..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_logo.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_powered.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_powered.webp
deleted file mode 100644
index 65a3487..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_powered.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_powered_lowres.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_powered_lowres.webp
deleted file mode 100644
index 10379a7..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_powered_lowres.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_tiny.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_tiny.webp
deleted file mode 100644
index 0e652c0..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/pygame_ce_tiny.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/straight_alpha_composition.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/straight_alpha_composition.webp
deleted file mode 100644
index 62f57ac..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/straight_alpha_composition.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_allblack.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_allblack.webp
deleted file mode 100644
index c8e54dc..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_allblack.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_flipped.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_flipped.webp
deleted file mode 100644
index 3b3da69..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_flipped.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_redimg.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_redimg.webp
deleted file mode 100644
index c6dd896..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_redimg.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_rgbarray.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_rgbarray.webp
deleted file mode 100644
index 659ccc9..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_rgbarray.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_scaledown.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_scaledown.webp
deleted file mode 100644
index f056ab7..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_scaledown.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_scaleup.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_scaleup.webp
deleted file mode 100644
index dab01d8..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_scaleup.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_soften.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_soften.webp
deleted file mode 100644
index bdd671f..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_soften.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_striped.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_striped.webp
deleted file mode 100644
index 2dbcd1e..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_striped.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_xfade.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_xfade.webp
deleted file mode 100644
index 7ccb098..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/surfarray_xfade.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_basic.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_basic.webp
deleted file mode 100644
index 17689cb..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_basic.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_event-flowchart.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_event-flowchart.webp
deleted file mode 100644
index 891b882..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_event-flowchart.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_formulae.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_formulae.webp
deleted file mode 100644
index 651c20d..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_formulae.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_radians.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_radians.webp
deleted file mode 100644
index 97f004d..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_images/tom_radians.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/c_api.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/c_api.rst.txt
index f832237..734289f 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/c_api.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/c_api.rst.txt
@@ -12,14 +12,12 @@ pygame C API
    c_api/display.rst
    c_api/event.rst
    c_api/freetype.rst
-   c_api/joystick.rst
    c_api/mixer.rst
    c_api/rect.rst
    c_api/rwobject.rst
    c_api/surface.rst
    c_api/surflock.rst
    c_api/version.rst
-   c_api/window.rst
 
 
 src_c/include/ contains header files for applications
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/index.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/index.rst.txt
index 6b63b6e..8d34d7c 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/index.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/index.rst.txt
@@ -1,5 +1,5 @@
-Pygame-ce Front Page
-====================
+Pygame Front Page
+=================
 
 .. toctree::
    :maxdepth: 2
@@ -7,8 +7,9 @@ Pygame-ce Front Page
    :hidden:
 
    ref/*
-   tutorials/en/*
-   tutorials/es/*
+   tut/*
+   tut/en/**/*
+   tut/ko/**/*
    c_api
    filepaths
    logos
@@ -16,10 +17,9 @@ Pygame-ce Front Page
 Quick start
 -----------
 
-Welcome to pygame-ce! Once you've got pygame-ce installed
-(:code:`pip install pygame-ce` or :code:`pip3 install pygame-ce` for most
-people), the next question is how to get a game loop running. Pygame-ce,
-unlike some other libraries, gives you full control of program
+Welcome to pygame! Once you've got pygame installed (:code:`pip install pygame` or
+:code:`pip3 install pygame` for most people), the next question is how to get a game
+loop running. Pygame, unlike some other libraries, gives you full control of program
 execution. That freedom means it is easy to mess up in your initial steps.
 
 Here is a good example of a basic setup (opens the window, updates the screen, and handles events)--
@@ -32,39 +32,9 @@ Here is a slightly more fleshed out example, which shows you how to move somethi
 .. literalinclude:: ref/code_examples/base_script_example.py
 
 For more in depth reference, check out the :ref:`tutorials-reference-label`
-section below, or reference the API documentation by module.
-
-Experimental modules
---------------------
-
-Experimental modules are work in progress, this is why you should refrain from relying on any features
-provided by these modules, as they are subject to change or removal without prior notice.
-If you want to test these experimental modules, you might want to understand how you import
-them, this is how you can do it:
-
-.. code-block:: python
-
-  from pygame import experimental_module
-  # Or for specific modules like _sdl2.controller
-  from pygame._sdl2 import controller
-  # Or
-  import pygame.experimental_module
-
-Don't forget to report us any problem with the experimental features on `github`_ so we can easily
-turn them to stable API in the future ^^.
-
-**Below is currently the list of experimental modules :**
-
-:doc:`ref/geometry`
-  Pygame module for the Circle, Line, and Polygon objects.
-
-:doc:`ref/sdl2_controller`
-  Pygame module to work with controllers.
-
-:doc:`ref/sdl2_video`
-  Pygame module for porting new SDL video systems.
-
-.. _github: https://github.com/pygame-community/pygame-ce
+section below, check out a video tutorial (`I'm a fan of this one
+`_), or reference the API
+documentation by module.
 
 Documents
 ---------
@@ -72,6 +42,10 @@ Documents
 `Readme`_
   Basic information about pygame: what it is, who is involved, and where to find it.
 
+`Install`_
+  Steps needed to compile pygame on several platforms.
+  Also help on finding and installing prebuilt binaries for your system.
+
 :doc:`filepaths`
   How pygame handles file system paths.
 
@@ -89,65 +63,52 @@ Documents
 Tutorials
 ---------
 
-| `Master Python by making 5 games [the new ultimate introduction to pygame] `_
-|   YouTube video by Clear Code.
+:doc:`Introduction to Pygame `
+  An introduction to the basics of pygame.
+  This is written for users of Python and appeared in volume two of the Py magazine.
 
-| `Pygame in 18 Minutes `_
-|   YouTube video by DaFluffyPotato.
-
-| `Introduction to Pygame-ce, 2D game programming `_
-|   Book by Ralf Adams.
-
-:doc:`Newbie Guide `
-  A list of thirteen helpful tips for people to get comfortable using pygame.
-
-:doc:`Import and Initialize `
+:doc:`Import and Initialize `
   The beginning steps on importing and initializing pygame.
   The pygame package is made of several modules.
   Some modules are not included on all platforms.
 
-:doc:`How do I move an Image? `
+:doc:`How do I move an Image? `
   A basic tutorial that covers the concepts behind 2D computer animation.
   Information about drawing and clearing objects to make them appear animated.
 
-:doc:`Chimp Tutorial, Line by Line `
+:doc:`Chimp Tutorial, Line by Line `
   The pygame examples include a simple program with an interactive fist and a chimpanzee.
   This was inspired by the annoying flash banner of the early 2000s.
   This tutorial examines every line of code used in the example.
 
-:doc:`What is Premultiplied Alpha? `
-  An explanation of alpha compositing and the advantages of using premultiplied alpha.
-
-:doc:`Sprite Module Introduction `
+:doc:`Sprite Module Introduction `
   Pygame includes a higher level sprite module to help organize games.
   The sprite module includes several classes that help manage details found in almost all games types.
   The Sprite classes are a bit more advanced than the regular pygame modules,
   and need more understanding to be properly used.
 
-:doc:`Introduction to Pygame `
-  An introduction to the basics of pygame.
-  This is written for users of Python and appeared in volume two of the Py magazine.
-
-:doc:`Surfarray Introduction `
+:doc:`Surfarray Introduction `
   Pygame used the NumPy python module to allow efficient per pixel effects on images.
   Using the surface arrays is an advanced feature that allows custom effects and filters.
   This also examines some of the simple effects from the pygame example, arraydemo.py.
 
-:doc:`Camera Module Introduction `
+:doc:`Camera Module Introduction `
   Pygame, as of 1.9, has a camera module that allows you to capture images,
   watch live streams, and do some basic computer vision.
   This tutorial covers those use cases.
 
-:doc:`Making Games Tutorial `
+:doc:`Newbie Guide `
+  A list of thirteen helpful tips for people to get comfortable using pygame.
+
+:doc:`Making Games Tutorial `
   A large tutorial that covers the bigger topics needed to create an entire game.
 
-:doc:`Display Modes `
+:doc:`Display Modes `
   Getting a display surface for the screen.
 
-:doc:`Tutorial de Pygame - Ejemplo del Chimpancé, Línea Por Línea `
-  Los ejemplos de pygame incluyen un sencillo programa con un puño interactivo y un chimpancé.
-  Está inspirado en el molesto banner de flash de principios de la década de 2000.
-  Este tutorial examina cada línea de código utilizada en el ejemplo.
+:doc:`한국어 튜토리얼 (Korean Tutorial) `
+  빨간블록 검은블록
+
 
 Reference
 ---------
@@ -239,18 +200,14 @@ Reference
 :doc:`ref/transform`
   Resize and move images.
 
-:doc:`ref/typing`
-  Provide common typehints
-
-:doc:`ref/window`
-  Pygame object that handles a window.
-
 :doc:`pygame C API `
   The C api shared amongst pygame extension modules.
 
 :ref:`search`
   Search pygame documents by keyword.
 
-.. _Readme: https://github.com/pygame-community/pygame-ce#readme
+.. _Readme: ../wiki/about
+
+.. _Install: ../wiki/GettingStarted#Pygame%20Installation
 
 .. _LGPL License: LGPL.txt
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/logos.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/logos.rst.txt
index cda5564..a7ee493 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/logos.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/logos.rst.txt
@@ -1,58 +1,47 @@
 *************************************************
-  Pygame CE Logos Page
+  Pygame Logos Page
 *************************************************
 
-Pygame CE Logos
-===============
+Pygame Logos
+============
 
 These logos are available for use in your own game projects.
-Please put them up wherever you see fit.
-
-The pygame-ce logo and its variants were created by Mega-JC and kadir014 on June 30, 2024.
-
-.. container:: fullwidth
-
-    .. image:: _static/pygame_ce_logo.webp
-
-    | `pygame_ce_logo.svg <_static/pygame_ce_logo.svg>`_
-    | `pygame_ce_logo.webp <_static/pygame_ce_logo.webp>`_ - 1560 x 800
-
-    .. image:: _static/pygame_ce_lofi.webp
-
-    | `pygame_ce_lofi.svg <_static/pygame_ce_lofi.svg>`_
-    | `pygame_ce_lofi.webp <_static/pygame_ce_lofi.webp>`_ - 1560 x 800
-
-    .. image:: _static/pygame_ce_powered.webp
-
-    | `pygame_ce_powered.svg <_static/pygame_ce_powered.svg>`_
-    | `pygame_ce_powered.webp <_static/pygame_ce_powered.webp>`_ - 1560 x 824
-
-    .. image:: _static/pygame_ce_tiny.webp
-
-    | `pygame_ce_tiny.webp <_static/pygame_ce_tiny.webp>`_ - 214 x 110
-
-    .. image:: _static/pygame_ce_powered_lowres.webp
-
-    | `pygame_ce_powered_lowres.webp <_static/pygame_ce_powered_lowres.webp>`_ - 101 x 53
-
-
-
-Upstream & legacy logos
------------------------
-
-The pygame logo was originally created
-by TheCorruptor on July 29, 2001.
-
-It was upscaled alongside its "LoFi" and "Powered" variants by Mega-JC on
+Please put them up wherever you see fit. The logo was created
+by TheCorruptor on July 29, 2001 and upscaled by Mega_JC on
 August 29, 2021.
 
 .. container:: fullwidth
 
-  |  `upstream_logos.zip <_static/upstream_logos.zip>`_ - 314 KB
+    .. image:: _static/pygame_logo.png
+
+    | `pygame_logo.svg <_static/pygame_logo.svg>`_
+    | `pygame_logo.png <_static/pygame_logo.png>`_ - 1561 x 438
+
+    .. image:: _static/pygame_lofi.png
+
+    | `pygame_lofi.svg <_static/pygame_lofi.svg>`_
+    | `pygame_lofi.png <_static/pygame_lofi.png>`_ - 1561 x 438
+
+    .. image:: _static/pygame_powered.png
+
+    | `pygame_powered.svg <_static/pygame_powered.svg>`_
+    | `pygame_powered.png <_static/pygame_powered.png>`_ - 1617 x 640
+
+    .. image:: _static/pygame_tiny.png
+
+    | `pygame_tiny.png <_static/pygame_tiny.png>`_ - 214 x 60
+
+    .. image:: _static/pygame_powered_lowres.png
+
+    | `pygame_powered_lowres.png <_static/pygame_powered_lowres.png>`_ - 101 x 40
+
 
 There is a higher resolution layered photoshop image
-available `here `_. *(1.3 MB)*
+available `here `_. *(1.3 MB)*
+
+Legacy logos
+------------
 
 .. container:: fullwidth
 
-  |  `legacy_logos.zip <_static/legacy_logos.zip>`_ - 50.1 KB
+    `legacy_logos.zip <_static/legacy_logos.zip>`_ - 50.1 KB
\ No newline at end of file
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/bufferproxy.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/bufferproxy.rst.txt
index 5d826ed..bb4e693 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/bufferproxy.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/bufferproxy.rst.txt
@@ -10,7 +10,7 @@
 .. class:: BufferProxy
 
    | :sl:`pygame object to export a surface buffer through an array protocol`
-   | :sg:`BufferProxy(parent) -> BufferProxy`
+   | :sg:`BufferProxy() -> BufferProxy`
 
    :class:`BufferProxy` is a pygame support type, designed as the return value
    of the :meth:`Surface.get_buffer` and :meth:`Surface.get_view` methods.
@@ -47,8 +47,8 @@
 
       ``"strides"`` : tuple : (optional)
          Array stride information as a tuple of integers. It is required
-         only of non C-contiguous arrays. The tuple length must match
-         that of ``"shape"``.
+	 only of non C-contiguous arrays. The tuple length must match
+	 that of ``"shape"``.
 
       ``"parent"`` : object : (optional)
          The exporting object. It can be used to keep the parent object
@@ -57,7 +57,7 @@
       ``"before"`` : callable : (optional)
          Callback invoked when the :class:`BufferProxy` instance
          exports the buffer. The callback is given one argument, the
-         ``"parent"`` object if given, otherwise ``None``.
+	 ``"parent"`` object if given, otherwise ``None``.
          The callback is useful for setting a lock on the parent.
 
       ``"after"`` : callable : (optional)
@@ -65,18 +65,18 @@
          The callback is passed on argument, the ``"parent"`` object if given,
          otherwise None. The callback is useful for releasing a lock on the
          parent.
-
+      
    The BufferProxy class supports subclassing, instance variables, and weak
    references.
 
-   .. versionaddedold:: 1.8.0
-   .. versionextendedold:: 1.9.2
+   .. versionadded:: 1.8.0
+   .. versionextended:: 1.9.2
 
    .. attribute:: parent
 
       | :sl:`Return wrapped exporting object.`
       | :sg:`parent -> Surface`
-      | :sg:`parent -> parent`
+      | :sg:`parent -> `
 
       The :class:`Surface` which returned the :class:`BufferProxy` object or
       the object passed to a :class:`BufferProxy` call.
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/camera.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/camera.rst.txt
index 9bf5aad..a412392 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/camera.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/camera.rst.txt
@@ -8,12 +8,14 @@
 
 | :sl:`pygame module for camera use`
 
+.. note::
+   Use import pygame.camera before using this module.
+
 Pygame currently supports Linux (V4L2) and Windows (MSMF) cameras natively,
 with wider platform support available via an integrated OpenCV backend.
 
-.. versionaddedold:: 2.0.2 Windows native camera support
-.. versionaddedold:: 2.0.3 New OpenCV backends
-.. versionchanged:: 2.3.0 Removed deprecated vidcapture backend
+.. versionadded:: 2.0.2 Windows native camera support
+.. versionadded:: 2.0.3 New OpenCV backends
 
 EXPERIMENTAL!: This API may change or disappear in later pygame releases. If
 you use this, your code will very likely break with the next pygame release.
@@ -44,7 +46,7 @@ The Bayer to ``RGB`` function is based on:
  OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  SUCH DAMAGE.
 
-.. versionaddedold:: 1.9.0
+New in pygame 1.9.0.
 
 .. function:: init
 
@@ -58,7 +60,7 @@ The Bayer to ``RGB`` function is based on:
    want into this function. More about backends in
    :func:`get_backends()`.
 
-   .. versionchangedold:: 2.0.3 Option to explicitly select backend
+   .. versionchanged:: 2.0.3 Option to explicitly select backend
 
    .. ## pygame.camera.init ##
 
@@ -79,28 +81,30 @@ The Bayer to ``RGB`` function is based on:
       _camera (V4L2)    Linux     Builtin
       OpenCV            Any       Uses `opencv-python` module, can't enumerate cameras
       OpenCV-Mac        Mac       Same as OpenCV, but has camera enumeration
+      VideoCapture      Windows   Uses abandoned `VideoCapture` module, can't enumerate
+                                  cameras, may be removed in the future
 
    There are two main differences among backends.
 
    The _camera backends are built in to pygame itself, and require no third
-   party imports. All the other backends do. For the OpenCV backend,
-   the module will need to be installed on your system.
+   party imports. All the other backends do. For the OpenCV and VideoCapture
+   backends, those modules need to be installed on your system.
 
    The other big difference is "camera enumeration." Some backends don't have
    a way to list out camera names, or even the number of cameras on the
    system. In these cases, :func:`list_cameras()` will return
-   something like ``[0]``. If you know you have multiple cameras on the
-   system, these backend ports will pass through a "camera index number"
+   something like ``[0]``. If you know you have multiple cameras on the 
+   system, these backend ports will pass through a "camera index number" 
    through if you use that as the ``device`` parameter.
 
-   .. versionaddedold:: 2.0.3
+   .. versionadded:: 2.0.3
 
    .. ## pygame.camera.get_backends ##
 
 .. function:: colorspace
 
    | :sl:`Surface colorspace conversion`
-   | :sg:`colorspace(surface, format, dest_surface = None, /) -> Surface`
+   | :sg:`colorspace(Surface, format, DestSurface = None) -> Surface`
 
    Allows for conversion from "RGB" to a destination colorspace of "HSV" or
    "YUV". The source and destination surfaces must be the same size and pixel
@@ -131,8 +135,8 @@ The Bayer to ``RGB`` function is based on:
    | :sg:`Camera(device, (width, height), format) -> Camera`
 
    Loads a camera. On Linux, the device is typically something like
-   "/dev/video0". Default width and height are 640 by 480.
-   Format is the desired colorspace of the output.
+   "/dev/video0". Default width and height are 640 by 480. 
+   Format is the desired colorspace of the output. 
    This is useful for computer vision purposes. The default is
    ``RGB``. The following are supported:
 
@@ -214,14 +218,14 @@ The Bayer to ``RGB`` function is based on:
       frame when called with a blocking function like :func:`get_image()`.
       On Windows (MSMF), and the  OpenCV backends, :func:`query_image()`
       should be reliable, though. This is useful to separate the framerate of
-      the game from that of the camera without having to use threading.
+      the game from that of the camera without having to use threading. 
 
       .. ## Camera.query_image ##
 
    .. method:: get_image
 
       | :sl:`captures an image as a Surface`
-      | :sg:`get_image(Surface = None, /) -> Surface`
+      | :sg:`get_image(Surface = None) -> Surface`
 
       Pulls an image off of the buffer as an ``RGB`` Surface. It can optionally
       reuse an existing Surface to save time. The bit-depth of the surface is
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color.rst.txt
index 9b59391..fc5c123 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color.rst.txt
@@ -5,5 +5,279 @@
 
 .. currentmodule:: pygame
 
-.. autopgclass:: Color
-   :members:
+.. class:: Color
+
+   | :sl:`pygame object for color representations`
+   | :sg:`Color(r, g, b) -> Color`
+   | :sg:`Color(r, g, b, a=255) -> Color`
+   | :sg:`Color(color_value) -> Color`
+
+   The ``Color`` class represents ``RGBA`` color values using a value range of
+   0 to 255 inclusive. It allows basic arithmetic operations — binary
+   operations ``+``, ``-``, ``*``, ``//``, ``%``, and unary operation ``~`` — to
+   create new colors, supports conversions to other color spaces such as ``HSV``
+   or ``HSL`` and lets you adjust single color channels.
+   Alpha defaults to 255 (fully opaque) when not given.
+   The arithmetic operations and ``correct_gamma()`` method preserve subclasses.
+   For the binary operators, the class of the returned color is that of the
+   left hand color object of the operator.
+
+   Color objects support equality comparison with other color objects and 3 or
+   4 element tuples of integers. There was a bug in pygame 1.8.1
+   where the default alpha was 0, not 255 like previously.
+
+   Color objects export the C level array interface. The interface exports a
+   read-only one dimensional unsigned byte array of the same assigned length
+   as the color. The new buffer interface is also exported, with the same
+   characteristics as the array interface.
+
+   The floor division, ``//``, and modulus, ``%``, operators do not raise
+   an exception for division by zero. Instead, if a color, or alpha, channel
+   in the right hand color is 0, then the result is 0. For example: ::
+
+       # These expressions are True
+       Color(255, 255, 255, 255) // Color(0, 64, 64, 64) == Color(0, 3, 3, 3)
+       Color(255, 255, 255, 255) % Color(64, 64, 64, 0) == Color(63, 63, 63, 0)
+
+   Use ``int(color)`` to return the immutable integer value of the color,
+   usable as a ``dict`` key. This integer value differs from the mapped
+   pixel values of :meth:`pygame.Surface.get_at_mapped`,
+   :meth:`pygame.Surface.map_rgb` and :meth:`pygame.Surface.unmap_rgb`.
+   It can be passed as a ``color_value`` argument to :class:`Color`
+   (useful with sets).
+
+   See :doc:`color_list` for samples of the available named colors.
+
+   :param int r: red value in the range of 0 to 255 inclusive
+   :param int g: green value in the range of 0 to 255 inclusive
+   :param int b: blue value in the range of 0 to 255 inclusive
+   :param int a: (optional) alpha value in the range of 0 to 255 inclusive,
+      default is 255
+   :param color_value: color value (see note below for the supported formats)
+
+      .. note::
+         Supported ``color_value`` formats:
+            | - **Color object:** clones the given :class:`Color` object
+            | - **Color name: str:** name of the color to use, e.g. ``'red'``
+              (all the supported name strings can be found in the
+               :doc:`color_list`, with sample swatches)
+            | - **HTML color format str:** ``'#rrggbbaa'`` or ``'#rrggbb'``,
+              where rr, gg, bb, and aa are 2-digit hex numbers in the range
+              of 0 to 0xFF inclusive, the aa (alpha) value defaults to 0xFF
+              if not provided
+            | - **hex number str:** ``'0xrrggbbaa'`` or ``'0xrrggbb'``, where
+              rr, gg, bb, and aa are 2-digit hex numbers in the range of 0x00
+              to 0xFF inclusive, the aa (alpha) value defaults to 0xFF if not
+              provided
+            | - **int:** int value of the color to use, using hex numbers can
+              make this parameter more readable, e.g. ``0xrrggbbaa``, where rr,
+              gg, bb, and aa are 2-digit hex numbers in the range of 0x00 to
+              0xFF inclusive, note that the aa (alpha) value is not optional for
+              the int format and must be provided
+            | - **tuple/list of int color values:** ``(R, G, B, A)`` or
+              ``(R, G, B)``, where R, G, B, and A are int values in the range of
+              0 to 255 inclusive, the A (alpha) value defaults to 255 if not
+              provided
+
+   :type color_value: Color or str or int or tuple(int, int, int, [int]) or
+      list(int, int, int, [int])
+
+   :returns: a newly created :class:`Color` object
+   :rtype: Color
+
+   .. versionchanged:: 2.0.0
+      Support for tuples, lists, and :class:`Color` objects when creating
+      :class:`Color` objects.
+   .. versionchanged:: 1.9.2 Color objects export the C level array interface.
+   .. versionchanged:: 1.9.0 Color objects support 4-element tuples of integers.
+   .. versionchanged:: 1.8.1 New implementation of the class.
+
+   .. attribute:: r
+
+      | :sl:`Gets or sets the red value of the Color.`
+      | :sg:`r -> int`
+
+      The red value of the Color.
+
+      .. ## Color.r ##
+
+   .. attribute:: g
+
+      | :sl:`Gets or sets the green value of the Color.`
+      | :sg:`g -> int`
+
+      The green value of the Color.
+
+      .. ## Color.g ##
+
+   .. attribute:: b
+
+      | :sl:`Gets or sets the blue value of the Color.`
+      | :sg:`b -> int`
+
+      The blue value of the Color.
+
+      .. ## Color.b ##
+
+   .. attribute:: a
+
+      | :sl:`Gets or sets the alpha value of the Color.`
+      | :sg:`a -> int`
+
+      The alpha value of the Color.
+
+      .. ## Color.a ##
+
+   .. attribute:: cmy
+
+      | :sl:`Gets or sets the CMY representation of the Color.`
+      | :sg:`cmy -> tuple`
+
+      The ``CMY`` representation of the Color. The ``CMY`` components are in
+      the ranges ``C`` = [0, 1], ``M`` = [0, 1], ``Y`` = [0, 1]. Note that this
+      will not return the absolutely exact ``CMY`` values for the set ``RGB``
+      values in all cases. Due to the ``RGB`` mapping from 0-255 and the
+      ``CMY`` mapping from 0-1 rounding errors may cause the ``CMY`` values to
+      differ slightly from what you might expect.
+
+      .. ## Color.cmy ##
+
+   .. attribute:: hsva
+
+      | :sl:`Gets or sets the HSVA representation of the Color.`
+      | :sg:`hsva -> tuple`
+
+      The ``HSVA`` representation of the Color. The ``HSVA`` components are in
+      the ranges ``H`` = [0, 360], ``S`` = [0, 100], ``V`` = [0, 100], A = [0,
+      100]. Note that this will not return the absolutely exact ``HSV`` values
+      for the set ``RGB`` values in all cases. Due to the ``RGB`` mapping from
+      0-255 and the ``HSV`` mapping from 0-100 and 0-360 rounding errors may
+      cause the ``HSV`` values to differ slightly from what you might expect.
+
+      .. ## Color.hsva ##
+
+   .. attribute:: hsla
+
+      | :sl:`Gets or sets the HSLA representation of the Color.`
+      | :sg:`hsla -> tuple`
+
+      The ``HSLA`` representation of the Color. The ``HSLA`` components are in
+      the ranges ``H`` = [0, 360], ``S`` = [0, 100], ``L`` = [0, 100], A = [0,
+      100]. Note that this will not return the absolutely exact ``HSL`` values
+      for the set ``RGB`` values in all cases. Due to the ``RGB`` mapping from
+      0-255 and the ``HSL`` mapping from 0-100 and 0-360 rounding errors may
+      cause the ``HSL`` values to differ slightly from what you might expect.
+
+      .. ## Color.hsla ##
+
+   .. attribute:: i1i2i3
+
+      | :sl:`Gets or sets the I1I2I3 representation of the Color.`
+      | :sg:`i1i2i3 -> tuple`
+
+      The ``I1I2I3`` representation of the Color. The ``I1I2I3`` components are
+      in the ranges ``I1`` = [0, 1], ``I2`` = [-0.5, 0.5], ``I3`` = [-0.5,
+      0.5]. Note that this will not return the absolutely exact ``I1I2I3``
+      values for the set ``RGB`` values in all cases. Due to the ``RGB``
+      mapping from 0-255 and the ``I1I2I3`` mapping from 0-1 rounding errors
+      may cause the ``I1I2I3`` values to differ slightly from what you might
+      expect.
+
+      .. ## Color.i1i2i3 ##
+
+   .. method:: normalize
+
+      | :sl:`Returns the normalized RGBA values of the Color.`
+      | :sg:`normalize() -> tuple`
+
+      Returns the normalized ``RGBA`` values of the Color as floating point
+      values.
+
+      .. ## Color.normalize ##
+
+   .. method:: correct_gamma
+
+      | :sl:`Applies a certain gamma value to the Color.`
+      | :sg:`correct_gamma (gamma) -> Color`
+
+      Applies a certain gamma value to the Color and returns a new Color with
+      the adjusted ``RGBA`` values.
+
+      .. ## Color.correct_gamma ##
+
+   .. method:: set_length
+
+      | :sl:`Set the number of elements in the Color to 1,2,3, or 4.`
+      | :sg:`set_length(len) -> None`
+
+      DEPRECATED: You may unpack the values you need like so, 
+      ``r, g, b, _ = pygame.Color(100, 100, 100)``
+      If you only want r, g and b
+      Or 
+      ``r, g, *_ = pygame.Color(100, 100, 100)`` 
+      if you only want r and g
+
+      The default Color length is 4. Colors can have lengths 1,2,3 or 4. This
+      is useful if you want to unpack to r,g,b and not r,g,b,a. If you want to
+      get the length of a Color do ``len(acolor)``.
+
+      .. deprecated:: 2.1.3
+      .. versionadded:: 1.9.0
+
+      .. ## Color.set_length ##
+
+   .. method:: grayscale
+
+      | :sl:`returns the grayscale of a Color`
+      | :sg:`grayscale() -> Color`
+
+      Returns a Color which represents the grayscaled version of self using the luminosity formula which weights red, green and blue according to their wavelengths..
+
+      .. ## Color.grayscale ##
+
+   .. method:: lerp
+
+      | :sl:`returns a linear interpolation to the given Color.`
+      | :sg:`lerp(Color, float) -> Color`
+
+      Returns a Color which is a linear interpolation between self and the
+      given Color in RGBA space. The second parameter determines how far
+      between self and other the result is going to be.
+      It must be a value between 0 and 1 where 0 means self and 1 means
+      other will be returned.
+
+      .. versionadded:: 2.0.1
+
+      .. ## Color.lerp ##
+
+   .. method:: premul_alpha
+
+      | :sl:`returns a Color where the r,g,b components have been multiplied by the alpha.`
+      | :sg:`premul_alpha() -> Color`
+
+      Returns a new Color where each of the red, green and blue colour
+      channels have been multiplied by the alpha channel of the original
+      color. The alpha channel remains unchanged.
+
+      This is useful when working with the ``BLEND_PREMULTIPLIED`` blending mode
+      flag for :meth:`pygame.Surface.blit()`, which assumes that all surfaces using
+      it are using pre-multiplied alpha colors.
+
+      .. versionadded:: 2.0.0
+
+      .. ## Color.premul_alpha ##
+
+   .. method:: update
+
+      | :sl:`Sets the elements of the color`
+      | :sg:`update(r, g, b) -> None`
+      | :sg:`update(r, g, b, a=255) -> None`
+      | :sg:`update(color_value) -> None`
+
+      Sets the elements of the color. See parameters for :meth:`pygame.Color` for the
+      parameters of this function. If the alpha value was not set it will not change.
+
+      .. versionadded:: 2.0.1
+
+      .. ## Color.update ##
+   .. ## pygame.Color ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color_list.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color_list.rst.txt
index 8b22682..b6cf289 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color_list.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/color_list.rst.txt
@@ -675,7 +675,7 @@ Named Colors
 
 :doc:`color` lets you specify any of these named colors when creating a new
 ``pygame.Color`` (taken from the
-`colordict module `_).
+`colordict module `_).
 
 .. role:: aliceblue
 .. role:: antiquewhite
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/cursors.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/cursors.rst.txt
index e8fcbbc..6ea68e2 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/cursors.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/cursors.rst.txt
@@ -3,8 +3,248 @@
 :mod:`pygame.cursors`
 =====================
 
-.. autopgmodule:: pygame.cursors
-   :members:
+.. module:: pygame.cursors
+   :synopsis: pygame module for cursor resources
+
+| :sl:`pygame module for cursor resources`
+
+Pygame offers control over the system hardware cursor. Pygame supports
+black and white cursors (bitmap cursors), as well as system variant cursors and color cursors.
+You control the cursor with functions inside :mod:`pygame.mouse`.
+
+This cursors module contains functions for loading and decoding various
+cursor formats. These allow you to easily store your cursors in external files
+or directly as encoded python strings.
+
+The module includes several standard cursors. The :func:`pygame.mouse.set_cursor()`
+function takes several arguments. All those arguments have been stored in a
+single tuple you can call like this:
+
+::
+
+   >>> pygame.mouse.set_cursor(*pygame.cursors.arrow)
+   
+The following variables can be passed to ``pygame.mouse.set_cursor`` function:
+
+   * ``pygame.cursors.arrow``
+
+   * ``pygame.cursors.diamond``
+
+   * ``pygame.cursors.broken_x``
+
+   * ``pygame.cursors.tri_left``
+
+   * ``pygame.cursors.tri_right``
+
+This module also contains a few cursors as formatted strings. You'll need to
+pass these to ``pygame.cursors.compile()`` function before you can use them.
+The example call would look like this:
+
+::
+
+   >>> cursor = pygame.cursors.compile(pygame.cursors.textmarker_strings)
+   >>> pygame.mouse.set_cursor((8, 16), (0, 0), *cursor)
+
+The following strings can be converted into cursor bitmaps with
+``pygame.cursors.compile()`` :
+
+   * ``pygame.cursors.thickarrow_strings``
+
+   * ``pygame.cursors.sizer_x_strings``
+
+   * ``pygame.cursors.sizer_y_strings``
+
+   * ``pygame.cursors.sizer_xy_strings``
+   
+   * ``pygame.cursor.textmarker_strings``
+
+.. function:: compile
+
+   | :sl:`create binary cursor data from simple strings`
+   | :sg:`compile(strings, black='X', white='.', xor='o') -> data, mask`
+
+   A sequence of strings can be used to create binary cursor data for the
+   system cursor. This returns the binary data in the form of two tuples.
+   Those can be passed as the third and fourth arguments respectively of the 
+   :func:`pygame.mouse.set_cursor()` function.
+
+   If you are creating your own cursor strings, you can use any value represent
+   the black and white pixels. Some system allow you to set a special toggle
+   color for the system color, this is also called the xor color. If the system
+   does not support xor cursors, that color will simply be black.
+   
+   The height must be divisible by 8. The width of the strings must all be equal 
+   and be divisible by 8. If these two conditions are not met, ``ValueError`` is
+   raised.
+   An example set of cursor strings looks like this
+
+   ::
+
+       thickarrow_strings = (               #sized 24x24
+         "XX                      ",
+         "XXX                     ",
+         "XXXX                    ",
+         "XX.XX                   ",
+         "XX..XX                  ",
+         "XX...XX                 ",
+         "XX....XX                ",
+         "XX.....XX               ",
+         "XX......XX              ",
+         "XX.......XX             ",
+         "XX........XX            ",
+         "XX........XXX           ",
+         "XX......XXXXX           ",
+         "XX.XXX..XX              ",
+         "XXXX XX..XX             ",
+         "XX   XX..XX             ",
+         "     XX..XX             ",
+         "      XX..XX            ",
+         "      XX..XX            ",
+         "       XXXX             ",
+         "       XX               ",
+         "                        ",
+         "                        ",
+         "                        ")
+
+   .. ## pygame.cursors.compile ##
+
+.. function:: load_xbm
+
+   | :sl:`load cursor data from an XBM file`
+   | :sg:`load_xbm(cursorfile) -> cursor_args`
+   | :sg:`load_xbm(cursorfile, maskfile) -> cursor_args`
+
+   This loads cursors for a simple subset of ``XBM`` files. ``XBM`` files are
+   traditionally used to store cursors on UNIX systems, they are an ASCII
+   format used to represent simple images.
+
+   Sometimes the black and white color values will be split into two separate
+   ``XBM`` files. You can pass a second maskfile argument to load the two
+   images into a single cursor.
+
+   The cursorfile and maskfile arguments can either be filenames or file-like
+   object with the readlines method.
+
+   The return value cursor_args can be passed directly to the
+   ``pygame.mouse.set_cursor()`` function.
+
+   .. ## pygame.cursors.load_xbm ##
+
+
+
+.. class:: Cursor
+
+   | :sl:`pygame object representing a cursor`
+   | :sg:`Cursor(size, hotspot, xormasks, andmasks) -> Cursor`
+   | :sg:`Cursor(hotspot, surface) -> Cursor`
+   | :sg:`Cursor(constant) -> Cursor`
+   | :sg:`Cursor(Cursor) -> Cursor`
+   | :sg:`Cursor() -> Cursor`
+
+   In pygame 2, there are 3 types of cursors you can create to give your
+   game that little bit of extra polish. There's **bitmap** type cursors,
+   which existed in pygame 1.x, and are compiled from a string or load from an xbm file.
+   Then there are **system** type cursors, where you choose a preset that will 
+   convey the same meaning but look native across different operating systems. 
+   Finally you can create a **color** cursor, which displays a pygame surface as the cursor.
+
+   **Creating a system cursor**
+
+   Choose a constant from this list, pass it into ``pygame.cursors.Cursor(constant)``, 
+   and you're good to go. Be advised that not all systems support every system
+   cursor, and you may get a substitution instead. For example, on MacOS,
+   WAIT/WAITARROW should show up as an arrow, and SIZENWSE/SIZENESW/SIZEALL
+   should show up as a closed hand. And on Wayland, every SIZE cursor should 
+   show up as a hand.
+
+   ::
+
+      Pygame Cursor Constant           Description
+      --------------------------------------------
+      pygame.SYSTEM_CURSOR_ARROW       arrow
+      pygame.SYSTEM_CURSOR_IBEAM       i-beam
+      pygame.SYSTEM_CURSOR_WAIT        wait
+      pygame.SYSTEM_CURSOR_CROSSHAIR   crosshair
+      pygame.SYSTEM_CURSOR_WAITARROW   small wait cursor 
+                                       (or wait if not available)
+      pygame.SYSTEM_CURSOR_SIZENWSE    double arrow pointing 
+                                       northwest and southeast
+      pygame.SYSTEM_CURSOR_SIZENESW    double arrow pointing
+                                       northeast and southwest
+      pygame.SYSTEM_CURSOR_SIZEWE      double arrow pointing
+                                       west and east
+      pygame.SYSTEM_CURSOR_SIZENS      double arrow pointing 
+                                       north and south
+      pygame.SYSTEM_CURSOR_SIZEALL     four pointed arrow pointing
+                                       north, south, east, and west
+      pygame.SYSTEM_CURSOR_NO          slashed circle or crossbones
+      pygame.SYSTEM_CURSOR_HAND        hand
+
+   **Creating a cursor without passing arguments**
+   
+   In addition to the cursor constants available and described above,
+   you can also call ``pygame.cursors.Cursor()``, and your cursor is ready (doing that is the same as
+   calling ``pygame.cursors.Cursor(pygame.SYSTEM_CURSOR_ARROW)``.
+   Doing one of those calls actually creates a system cursor using the default native image.
+
+   **Creating a color cursor**
+
+   To create a color cursor, create a ``Cursor`` from a ``hotspot`` and a ``surface``.
+   ``hotspot`` is an (x,y) coordinate that determines where in the cursor the exact point is.
+   The hotspot position must be within the bounds of the ``surface``.
+
+   **Creating a bitmap cursor**
+
+   When the mouse cursor is visible, it will be displayed as a black and white
+   bitmap using the given bitmask arrays. The ``size`` is a sequence containing 
+   the cursor width and height. ``hotspot`` is a sequence containing the cursor 
+   hotspot position. 
+   
+   A cursor has a width and height, but a mouse position is represented by a 
+   set of point coordinates. So the value passed into the cursor ``hotspot`` 
+   variable helps pygame to actually determine at what exact point the cursor 
+   is at.
+   
+   ``xormasks`` is a sequence of bytes containing the cursor xor data masks. 
+   Lastly ``andmasks``, a sequence of bytes containing the cursor bitmask data.
+   To create these variables, we can make use of the 
+   :func:`pygame.cursors.compile()` function.
+
+   Width and height must be a multiple of 8, and the mask arrays must be the 
+   correct size for the given width and height. Otherwise an exception is raised.
+   
+   .. method:: copy
+
+      | :sl:`copy the current cursor`
+      | :sg:`copy() -> Cursor`
+      
+      Returns a new Cursor object with the same data and hotspot as the original.
+   .. ## pygame.cursors.Cursor.copy ##
+   
+
+   .. attribute:: type
+   
+      | :sl:`Gets the cursor type`
+      | :sg:`type -> string`
+
+      The type will be ``"system"``, ``"bitmap"``, or ``"color"``.
+
+   .. ## pygame.cursors.Cursor.type ##
+
+   .. attribute:: data
+
+      | :sl:`Gets the cursor data`
+      | :sg:`data -> tuple`
+
+      Returns the data that was used to create this cursor object, wrapped up in a tuple.
+
+   .. ## pygame.cursors.Cursor.data ##
+
+   .. versionadded:: 2.0.1
+
+   .. ## pygame.cursors.Cursor ##
+   
+.. ## pygame.cursors ##
 
 Example code for creating and settings cursors. (Click the mouse to switch cursor)
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/display.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/display.rst.txt
index 21aa835..ec3bf77 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/display.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/display.rst.txt
@@ -3,5 +3,735 @@
 :mod:`pygame.display`
 =====================
 
-.. autopgmodule:: pygame.display
-   :members:
+.. module:: pygame.display
+   :synopsis: pygame module to control the display window and screen
+
+| :sl:`pygame module to control the display window and screen`
+
+This module offers control over the pygame display. Pygame has a single display
+Surface that is either contained in a window or runs full screen. Once you
+create the display you treat it as a regular Surface. Changes are not
+immediately visible onscreen; you must choose one of the two flipping functions
+to update the actual display.
+
+The origin of the display, where x = 0 and y = 0, is the top left of the
+screen. Both axes increase positively towards the bottom right of the screen.
+
+The pygame display can actually be initialized in one of several modes. By
+default, the display is a basic software driven framebuffer. You can request
+special modules like automatic scaling or OpenGL support. These are
+controlled by flags passed to ``pygame.display.set_mode()``.
+
+Pygame can only have a single display active at any time. Creating a new one
+with ``pygame.display.set_mode()`` will close the previous display. To detect
+the number and size of attached screens, you can use
+``pygame.display.get_desktop_sizes`` and then select appropriate window size
+and display index to pass to ``pygame.display.set_mode()``.
+
+For backward compatibility ``pygame.display`` allows precise control over
+the pixel format or display resolutions. This used to be necessary with old
+graphics cards and CRT screens, but is usually not needed any more. Use the
+functions ``pygame.display.mode_ok()``, ``pygame.display.list_modes()``, and
+``pygame.display.Info()`` to query detailed information about the display.
+
+Once the display Surface is created, the functions from this module affect the
+single existing display. The Surface becomes invalid if the module is
+uninitialized. If a new display mode is set, the existing Surface will
+automatically switch to operate on the new display.
+
+When the display mode is set, several events are placed on the pygame event
+queue. ``pygame.QUIT`` is sent when the user has requested the program to
+shut down. The window will receive ``pygame.ACTIVEEVENT`` events as the display
+gains and loses input focus. If the display is set with the
+``pygame.RESIZABLE`` flag, ``pygame.VIDEORESIZE`` events will be sent when the
+user adjusts the window dimensions. Hardware displays that draw direct to the
+screen will get ``pygame.VIDEOEXPOSE`` events when portions of the window must
+be redrawn.
+
+A new windowevent API was introduced in pygame 2.0.1. Check event module docs
+for more information on that
+
+Some display environments have an option for automatically stretching all
+windows. When this option is enabled, this automatic stretching distorts the
+appearance of the pygame window. In the pygame examples directory, there is
+example code (prevent_display_stretching.py) which shows how to disable this
+automatic stretching of the pygame display on Microsoft Windows (Vista or newer
+required).
+
+.. function:: init
+
+   | :sl:`Initialize the display module`
+   | :sg:`init() -> None`
+
+   Initializes the pygame display module. The display module cannot do anything
+   until it is initialized. This is usually handled for you automatically when
+   you call the higher level ``pygame.init()``.
+
+   Pygame will select from one of several internal display backends when it is
+   initialized. The display mode will be chosen depending on the platform and
+   permissions of current user. Before the display module is initialized the
+   environment variable ``SDL_VIDEODRIVER`` can be set to control which backend
+   is used. The systems with multiple choices are listed here.
+
+   ::
+
+      Windows : windib, directx
+      Unix    : x11, dga, fbcon, directfb, ggi, vgl, svgalib, aalib
+
+   On some platforms it is possible to embed the pygame display into an already
+   existing window. To do this, the environment variable ``SDL_WINDOWID`` must
+   be set to a string containing the window id or handle. The environment
+   variable is checked when the pygame display is initialized. Be aware that
+   there can be many strange side effects when running in an embedded display.
+
+   It is harmless to call this more than once, repeated calls have no effect.
+
+   .. ## pygame.display.init ##
+
+.. function:: quit
+
+   | :sl:`Uninitialize the display module`
+   | :sg:`quit() -> None`
+
+   This will shut down the entire display module. This means any active
+   displays will be closed. This will also be handled automatically when the
+   program exits.
+
+   It is harmless to call this more than once, repeated calls have no effect.
+
+   .. ## pygame.display.quit ##
+
+.. function:: get_init
+
+   | :sl:`Returns True if the display module has been initialized`
+   | :sg:`get_init() -> bool`
+
+   Returns True if the :mod:`pygame.display` module is currently initialized.
+
+   .. ## pygame.display.get_init ##
+
+.. function:: set_mode
+
+   | :sl:`Initialize a window or screen for display`
+   | :sg:`set_mode(size=(0, 0), flags=0, depth=0, display=0, vsync=0) -> Surface`
+
+   This function will create a display Surface. The arguments passed in are
+   requests for a display type. The actual created display will be the best
+   possible match supported by the system.
+
+   Note that calling this function implicitly initializes ``pygame.display``, if
+   it was not initialized before.
+
+   The size argument is a pair of numbers representing the width and
+   height. The flags argument is a collection of additional options. The depth
+   argument represents the number of bits to use for color.
+
+   The Surface that gets returned can be drawn to like a regular Surface but
+   changes will eventually be seen on the monitor.
+
+   If no size is passed or is set to ``(0, 0)`` and pygame uses ``SDL``
+   version 1.2.10 or above, the created Surface will have the same size as the
+   current screen resolution. If only the width or height are set to ``0``, the
+   Surface will have the same width or height as the screen resolution. Using a
+   ``SDL`` version prior to 1.2.10 will raise an exception.
+
+   It is usually best to not pass the depth argument. It will default to the
+   best and fastest color depth for the system. If your game requires a
+   specific color format you can control the depth with this argument. Pygame
+   will emulate an unavailable color depth which can be slow.
+
+   When requesting fullscreen display modes, sometimes an exact match for the
+   requested size cannot be made. In these situations pygame will select
+   the closest compatible match. The returned surface will still always match
+   the requested size.
+
+   On high resolution displays(4k, 1080p) and tiny graphics games (640x480)
+   show up very small so that they are unplayable. SCALED scales up the window
+   for you. The game thinks it's a 640x480 window, but really it can be bigger.
+   Mouse events are scaled for you, so your game doesn't need to do it. Note
+   that SCALED is considered an experimental API and may change in future
+   releases.
+
+   The flags argument controls which type of display you want. There are
+   several to choose from, and you can even combine multiple types using the
+   bitwise or operator, (the pipe "|" character). Here are the display
+   flags you will want to choose from:
+
+   ::
+
+      pygame.FULLSCREEN    create a fullscreen display
+      pygame.DOUBLEBUF     only applicable with OPENGL
+      pygame.HWSURFACE     (obsolete in pygame 2) hardware accelerated, only in FULLSCREEN
+      pygame.OPENGL        create an OpenGL-renderable display
+      pygame.RESIZABLE     display window should be resizeable
+      pygame.NOFRAME       display window will have no border or controls
+      pygame.SCALED        resolution depends on desktop size and scale graphics
+      pygame.SHOWN         window is opened in visible mode (default)
+      pygame.HIDDEN        window is opened in hidden mode
+
+
+   .. versionadded:: 2.0.0 ``SCALED``, ``SHOWN`` and ``HIDDEN``
+
+   By setting the ``vsync`` parameter to ``1``, it is possible to get a display
+   with vertical sync, but you are not guaranteed to get one. The request only
+   works at all for calls to ``set_mode()`` with the ``pygame.OPENGL`` or
+   ``pygame.SCALED`` flags set, and is still not guaranteed even with one of
+   those set. What you get depends on the hardware and driver configuration
+   of the system pygame is running on. Here is an example usage of a call
+   to ``set_mode()`` that may give you a display with vsync:
+
+   ::
+
+     flags = pygame.OPENGL | pygame.FULLSCREEN
+     window_surface = pygame.display.set_mode((1920, 1080), flags, vsync=1)
+
+   Vsync behaviour is considered experimental, and may change in future releases.
+
+   .. versionadded:: 2.0.0 ``vsync``
+
+   Basic example:
+
+   ::
+
+        # Open a window on the screen
+        screen_width=700
+        screen_height=400
+        screen=pygame.display.set_mode([screen_width, screen_height])
+
+   The display index ``0`` means the default display is used. If no display
+   index argument is provided, the default display can be overridden with an
+   environment variable.
+
+
+   .. versionchanged:: 1.9.5 ``display`` argument added
+
+   .. versionchanged:: 2.1.3
+      pygame now ensures that subsequent calls to this function clears the
+      window to black. On older versions, this was an implementation detail
+      on the major platforms this function was tested with.
+
+   .. ## pygame.display.set_mode ##
+
+.. function:: get_surface
+
+   | :sl:`Get a reference to the currently set display surface`
+   | :sg:`get_surface() -> Surface`
+
+   Return a reference to the currently set display Surface. If no display mode
+   has been set this will return None.
+
+   .. ## pygame.display.get_surface ##
+
+.. function:: flip
+
+   | :sl:`Update the full display Surface to the screen`
+   | :sg:`flip() -> None`
+
+   This will update the contents of the entire display. If your display mode is
+   using the flags ``pygame.HWSURFACE`` and ``pygame.DOUBLEBUF`` on pygame 1,
+   this will wait for a vertical retrace and swap the surfaces.
+
+   When using an ``pygame.OPENGL`` display mode this will perform a gl buffer
+   swap.
+
+   .. ## pygame.display.flip ##
+
+.. function:: update
+
+   | :sl:`Update portions of the screen for software displays`
+   | :sg:`update(rectangle=None) -> None`
+   | :sg:`update(rectangle_list) -> None`
+
+   This function is like an optimized version of ``pygame.display.flip()`` for
+   software displays. It allows only a portion of the screen to be updated,
+   instead of the entire area. If no argument is passed it updates the entire
+   Surface area like ``pygame.display.flip()``.
+
+   Note that calling ``display.update(None)`` means no part of the window is
+   updated. Whereas ``display.update()`` means the whole window is updated.
+
+   You can pass the function a single rectangle, or a sequence of rectangles.
+   It is more efficient to pass many rectangles at once than to call update
+   multiple times with single or a partial list of rectangles. If passing a
+   sequence of rectangles it is safe to include None values in the list, which
+   will be skipped.
+
+   This call cannot be used on ``pygame.OPENGL`` displays and will generate an
+   exception.
+
+   .. ## pygame.display.update ##
+
+.. function:: get_driver
+
+   | :sl:`Get the name of the pygame display backend`
+   | :sg:`get_driver() -> name`
+
+   Pygame chooses one of many available display backends when it is
+   initialized. This returns the internal name used for the display backend.
+   This can be used to provide limited information about what display
+   capabilities might be accelerated. See the ``SDL_VIDEODRIVER`` flags in
+   ``pygame.display.set_mode()`` to see some of the common options.
+
+   .. ## pygame.display.get_driver ##
+
+.. function:: Info
+
+   | :sl:`Create a video display information object`
+   | :sg:`Info() -> VideoInfo`
+
+   Creates a simple object containing several attributes to describe the
+   current graphics environment. If this is called before
+   ``pygame.display.set_mode()`` some platforms can provide information about
+   the default display mode. This can also be called after setting the display
+   mode to verify specific display options were satisfied. The VidInfo object
+   has several attributes:
+
+   ::
+
+     hw:         1 if the display is hardware accelerated
+     wm:         1 if windowed display modes can be used
+     video_mem:  The megabytes of video memory on the display. This is 0 if
+                 unknown
+     bitsize:    Number of bits used to store each pixel
+     bytesize:   Number of bytes used to store each pixel
+     masks:      Four values used to pack RGBA values into pixels
+     shifts:     Four values used to pack RGBA values into pixels
+     losses:     Four values used to pack RGBA values into pixels
+     blit_hw:    1 if hardware Surface blitting is accelerated
+     blit_hw_CC: 1 if hardware Surface colorkey blitting is accelerated
+     blit_hw_A:  1 if hardware Surface pixel alpha blitting is accelerated
+     blit_sw:    1 if software Surface blitting is accelerated
+     blit_sw_CC: 1 if software Surface colorkey blitting is accelerated
+     blit_sw_A:  1 if software Surface pixel alpha blitting is accelerated
+     current_h, current_w:  Height and width of the current video mode, or
+                 of the desktop mode if called before the display.set_mode
+                 is called. (current_h, current_w are available since
+                 SDL 1.2.10, and pygame 1.8.0). They are -1 on error, or if
+                 an old SDL is being used.
+
+   .. ## pygame.display.Info ##
+
+.. function:: get_wm_info
+
+   | :sl:`Get information about the current windowing system`
+   | :sg:`get_wm_info() -> dict`
+
+   Creates a dictionary filled with string keys. The strings and values are
+   arbitrarily created by the system. Some systems may have no information and
+   an empty dictionary will be returned. Most platforms will return a "window"
+   key with the value set to the system id for the current display.
+
+   .. versionadded:: 1.7.1
+
+   .. ## pygame.display.get_wm_info ##
+
+.. function:: get_desktop_sizes
+
+   | :sl:`Get sizes of active desktops`
+   | :sg:`get_desktop_sizes() -> list`
+
+   This function returns the sizes of the currently configured
+   virtual desktops as a list of (x, y) tuples of integers.
+
+   The length of the list is not the same as the number of attached monitors,
+   as a desktop can be mirrored across multiple monitors. The desktop sizes
+   do not indicate the maximum monitor resolutions supported by the hardware,
+   but the desktop size configured in the operating system.
+
+   In order to fit windows into the desktop as it is currently configured, and
+   to respect the resolution configured by the operating system in fullscreen
+   mode, this function *should* be used to replace many use cases of
+   ``pygame.display.list_modes()`` whenever applicable.
+
+   .. versionadded:: 2.0.0
+
+.. function:: list_modes
+
+   | :sl:`Get list of available fullscreen modes`
+   | :sg:`list_modes(depth=0, flags=pygame.FULLSCREEN, display=0) -> list`
+
+   This function returns a list of possible sizes for a specified color
+   depth. The return value will be an empty list if no display modes are
+   available with the given arguments. A return value of ``-1`` means that
+   any requested size should work (this is likely the case for windowed
+   modes). Mode sizes are sorted from biggest to smallest.
+
+   If depth is ``0``, the current/best color depth for the display is used.
+   The flags defaults to ``pygame.FULLSCREEN``, but you may need to add
+   additional flags for specific fullscreen modes.
+
+   The display index ``0`` means the default display is used.
+
+   Since pygame 2.0, ``pygame.display.get_desktop_sizes()`` has taken over
+   some use cases from ``pygame.display.list_modes()``:
+
+   To find a suitable size for non-fullscreen windows, it is preferable to
+   use ``pygame.display.get_desktop_sizes()`` to get the size of the *current*
+   desktop, and to then choose a smaller window size. This way, the window is
+   guaranteed to fit, even when the monitor is configured to a lower resolution
+   than the maximum supported by the hardware.
+
+   To avoid changing the physical monitor resolution, it is also preferable to
+   use ``pygame.display.get_desktop_sizes()`` to determine the fullscreen
+   resolution. Developers are strongly advised to default to the current
+   physical monitor resolution unless the user explicitly requests a different
+   one (e.g. in an options menu or configuration file).
+
+   .. versionchanged:: 1.9.5 ``display`` argument added
+
+   .. ## pygame.display.list_modes ##
+
+.. function:: mode_ok
+
+   | :sl:`Pick the best color depth for a display mode`
+   | :sg:`mode_ok(size, flags=0, depth=0, display=0) -> depth`
+
+   This function uses the same arguments as ``pygame.display.set_mode()``. It
+   is used to determine if a requested display mode is available. It will
+   return ``0`` if the display mode cannot be set. Otherwise it will return a
+   pixel depth that best matches the display asked for.
+
+   Usually the depth argument is not passed, but some platforms can support
+   multiple display depths. If passed it will hint to which depth is a better
+   match.
+
+   The function will return ``0`` if the passed display flags cannot be set.
+
+   The display index ``0`` means the default display is used.
+
+   .. versionchanged:: 1.9.5 ``display`` argument added
+
+   .. ## pygame.display.mode_ok ##
+
+.. function:: gl_get_attribute
+
+   | :sl:`Get the value for an OpenGL flag for the current display`
+   | :sg:`gl_get_attribute(flag) -> value`
+
+   After calling ``pygame.display.set_mode()`` with the ``pygame.OPENGL`` flag,
+   it is a good idea to check the value of any requested OpenGL attributes. See
+   ``pygame.display.gl_set_attribute()`` for a list of valid flags.
+
+   .. versionchanged:: 2.5.0 Added support for keyword arguments.
+
+   .. ## pygame.display.gl_get_attribute ##
+
+.. function:: gl_set_attribute
+
+   | :sl:`Request an OpenGL display attribute for the display mode`
+   | :sg:`gl_set_attribute(flag, value) -> None`
+
+   When calling ``pygame.display.set_mode()`` with the ``pygame.OPENGL`` flag,
+   Pygame automatically handles setting the OpenGL attributes like color and
+   double-buffering. OpenGL offers several other attributes you may want control
+   over. Pass one of these attributes as the flag, and its appropriate value.
+   This must be called before ``pygame.display.set_mode()``.
+
+   Many settings are the requested minimum. Creating a window with an OpenGL context
+   will fail if OpenGL cannot provide the requested attribute, but it may for example
+   give you a stencil buffer even if you request none, or it may give you a larger
+   one than requested.
+
+   The ``OPENGL`` flags are:
+
+   ::
+
+     GL_ALPHA_SIZE, GL_DEPTH_SIZE, GL_STENCIL_SIZE, GL_ACCUM_RED_SIZE,
+     GL_ACCUM_GREEN_SIZE,  GL_ACCUM_BLUE_SIZE, GL_ACCUM_ALPHA_SIZE,
+     GL_MULTISAMPLEBUFFERS, GL_MULTISAMPLESAMPLES, GL_STEREO
+
+   :const:`GL_MULTISAMPLEBUFFERS`
+
+     Whether to enable multisampling anti-aliasing.
+     Defaults to 0 (disabled).
+
+     Set ``GL_MULTISAMPLESAMPLES`` to a value
+     above 0 to control the amount of anti-aliasing.
+     A typical value is 2 or 3.
+
+   :const:`GL_STENCIL_SIZE`
+
+     Minimum bit size of the stencil buffer. Defaults to 0.
+
+   :const:`GL_DEPTH_SIZE`
+
+     Minimum bit size of the depth buffer. Defaults to 16.
+
+   :const:`GL_STEREO`
+
+     1 enables stereo 3D. Defaults to 0.
+
+   :const:`GL_BUFFER_SIZE`
+
+     Minimum bit size of the frame buffer. Defaults to 0.
+
+   .. versionchanged:: 2.5.0 Added support for keyword arguments.
+
+   .. versionadded:: 2.0.0 Additional attributes:
+
+   ::
+
+     GL_ACCELERATED_VISUAL,
+     GL_CONTEXT_MAJOR_VERSION, GL_CONTEXT_MINOR_VERSION,
+     GL_CONTEXT_FLAGS, GL_CONTEXT_PROFILE_MASK,
+     GL_SHARE_WITH_CURRENT_CONTEXT,
+     GL_CONTEXT_RELEASE_BEHAVIOR,
+     GL_FRAMEBUFFER_SRGB_CAPABLE
+
+   :const:`GL_CONTEXT_PROFILE_MASK`
+
+     Sets the OpenGL profile to one of these values:
+
+     ::
+
+       GL_CONTEXT_PROFILE_CORE             disable deprecated features
+       GL_CONTEXT_PROFILE_COMPATIBILITY    allow deprecated features
+       GL_CONTEXT_PROFILE_ES               allow only the ES feature
+                                           subset of OpenGL
+
+   :const:`GL_ACCELERATED_VISUAL`
+
+     Set to 1 to require hardware acceleration, or 0 to force software render.
+     By default, both are allowed.
+
+   .. ## pygame.display.gl_set_attribute ##
+
+.. function:: get_active
+
+   | :sl:`Returns True when the display is active on the screen`
+   | :sg:`get_active() -> bool`
+
+   Returns True when the display Surface is considered actively
+   renderable on the screen and may be visible to the user.  This is
+   the default state immediately after ``pygame.display.set_mode()``.
+   This method may return True even if the application is fully hidden
+   behind another application window.
+
+   This will return False if the display Surface has been iconified or
+   minimized (either via ``pygame.display.iconify()`` or via an OS
+   specific method such as the minimize-icon available on most
+   desktops).
+
+   The method can also return False for other reasons without the
+   application being explicitly iconified or minimized by the user.  A
+   notable example being if the user has multiple virtual desktops and
+   the display Surface is not on the active virtual desktop.
+
+   .. note:: This function returning True is unrelated to whether the
+       application has input focus.  Please see
+       ``pygame.key.get_focused()`` and ``pygame.mouse.get_focused()``
+       for APIs related to input focus.
+
+   .. ## pygame.display.get_active ##
+
+.. function:: iconify
+
+   | :sl:`Iconify the display surface`
+   | :sg:`iconify() -> bool`
+
+   Request the window for the display surface be iconified or hidden. Not all
+   systems and displays support an iconified display. The function will return
+   True if successful.
+
+   When the display is iconified ``pygame.display.get_active()`` will return
+   ``False``. The event queue should receive an ``ACTIVEEVENT`` event when the
+   window has been iconified. Additionally, the event queue also receives a
+   ``WINDOWEVENT_MINIMIZED`` event when the window has been iconified on pygame 2.
+
+   .. ## pygame.display.iconify ##
+
+.. function:: toggle_fullscreen
+
+   | :sl:`Switch between fullscreen and windowed displays`
+   | :sg:`toggle_fullscreen() -> int`
+
+   Switches the display window between windowed and fullscreen modes.
+   Display driver support is not great when using pygame 1, but with
+   pygame 2 it is the most reliable method to switch to and from fullscreen.
+
+   Supported display drivers in pygame 1:
+
+    * x11 (Linux/Unix)
+    * wayland (Linux/Unix)
+
+   Supported display drivers in pygame 2:
+
+    * windows (Windows)
+    * x11 (Linux/Unix)
+    * wayland (Linux/Unix)
+    * cocoa (OSX/Mac)
+
+   .. Note:: :func:`toggle_fullscreen` doesn't work on Windows
+             unless the window size is in :func:`pygame.display.list_modes()` or
+             the window is created with the flag ``pygame.SCALED``.
+             See `issue #2380 `_.
+
+   .. ## pygame.display.toggle_fullscreen ##
+
+.. function:: set_gamma
+
+   | :sl:`Change the hardware gamma ramps`
+   | :sg:`set_gamma(red, green=None, blue=None) -> bool`
+
+   DEPRECATED: This functionality will go away in SDL3.
+
+   Set the red, green, and blue gamma values on the display hardware. If the
+   green and blue arguments are not passed, they will both be the same as red.
+   Not all systems and hardware support gamma ramps, if the function succeeds
+   it will return ``True``.
+
+   A gamma value of ``1.0`` creates a linear color table. Lower values will
+   darken the display and higher values will brighten.
+
+   .. deprecated:: 2.2.0
+
+   .. ## pygame.display.set_gamma ##
+
+.. function:: set_gamma_ramp
+
+   | :sl:`Change the hardware gamma ramps with a custom lookup`
+   | :sg:`set_gamma_ramp(red, green, blue) -> bool`
+
+   DEPRECATED: This functionality will go away in SDL3.
+
+   Set the red, green, and blue gamma ramps with an explicit lookup table. Each
+   argument should be sequence of 256 integers. The integers should range
+   between ``0`` and ``0xffff``. Not all systems and hardware support gamma
+   ramps, if the function succeeds it will return ``True``.
+
+   .. deprecated:: 2.2.0
+
+   .. ## pygame.display.set_gamma_ramp ##
+
+.. function:: set_icon
+
+   | :sl:`Change the system image for the display window`
+   | :sg:`set_icon(Surface) -> None`
+
+   Sets the runtime icon the system will use to represent the display window.
+   All windows default to a simple pygame logo for the window icon.
+
+   Note that calling this function implicitly initializes ``pygame.display``, if
+   it was not initialized before.
+
+   You can pass any surface, but most systems want a smaller image around
+   32x32. The image can have colorkey transparency which will be passed to the
+   system.
+
+   Some systems do not allow the window icon to change after it has been shown.
+   This function can be called before ``pygame.display.set_mode()`` to create
+   the icon before the display mode is set.
+
+   .. ## pygame.display.set_icon ##
+
+.. function:: set_caption
+
+   | :sl:`Set the current window caption`
+   | :sg:`set_caption(title, icontitle=None) -> None`
+
+   If the display has a window title, this function will change the name on the
+   window. In pygame 1.x, some systems supported an alternate shorter title to
+   be used for minimized displays, but in pygame 2 ``icontitle`` does nothing.
+
+   .. versionchanged:: 2.5.0 Added support for keyword arguments.
+   
+   .. ## pygame.display.set_caption ##
+
+.. function:: get_caption
+
+   | :sl:`Get the current window caption`
+   | :sg:`get_caption() -> (title, icontitle)`
+
+   Returns the title and icontitle for the display window. In pygame 2.x
+   these will always be the same value.
+
+   .. ## pygame.display.get_caption ##
+
+.. function:: set_palette
+
+   | :sl:`Set the display color palette for indexed displays`
+   | :sg:`set_palette(palette=None) -> None`
+
+   This will change the video display color palette for 8-bit displays. This
+   does not change the palette for the actual display Surface, only the palette
+   that is used to display the Surface. If no palette argument is passed, the
+   system default palette will be restored. The palette is a sequence of
+   ``RGB`` triplets.
+
+   .. versionchanged:: 2.5.0 Added support for keyword arguments.
+
+   .. ## pygame.display.set_palette ##
+
+.. function:: get_num_displays
+
+   | :sl:`Return the number of displays`
+   | :sg:`get_num_displays() -> int`
+
+   Returns the number of available displays. This is always 1 if
+   :func:`pygame.get_sdl_version()` returns a major version number below 2.
+
+   .. versionadded:: 1.9.5
+
+   .. ## pygame.display.get_num_displays ##
+
+.. function:: get_window_size
+
+   | :sl:`Return the size of the window or screen`
+   | :sg:`get_window_size() -> tuple`
+
+   Returns the size of the window initialized with :func:`pygame.display.set_mode()`.
+   This may differ from the size of the display surface if ``SCALED`` is used.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.display.get_window_size ##
+
+.. function:: get_allow_screensaver
+
+   | :sl:`Return whether the screensaver is allowed to run.`
+   | :sg:`get_allow_screensaver() -> bool`
+
+   Return whether screensaver is allowed to run whilst the app is running.
+   Default is ``False``.
+   By default pygame does not allow the screensaver during game play.
+
+   .. note:: Some platforms do not have a screensaver or support
+             disabling the screensaver.  Please see
+             :func:`pygame.display.set_allow_screensaver()` for
+             caveats with screensaver support.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.display.get_allow_screensaver ##
+
+.. function:: set_allow_screensaver
+
+   | :sl:`Set whether the screensaver may run`
+   | :sg:`set_allow_screensaver(bool) -> None`
+
+   Change whether screensavers should be allowed whilst the app is running.
+   The default value of the argument to the function is True.
+   By default pygame does not allow the screensaver during game play.
+
+   If the screensaver has been disallowed due to this function, it will automatically
+   be allowed to run when :func:`pygame.quit()` is called.
+
+   It is possible to influence the default value via the environment variable
+   ``SDL_HINT_VIDEO_ALLOW_SCREENSAVER``, which can be set to either ``0`` (disable)
+   or ``1`` (enable).
+
+   .. note:: Disabling screensaver is subject to platform support.
+             When platform support is absent, this function will
+             silently appear to work even though the screensaver state
+             is unchanged.  The lack of feedback is due to SDL not
+             providing any supported method for determining whether
+             it supports changing the screensaver state.
+             ``SDL_HINT_VIDEO_ALLOW_SCREENSAVER`` is available in SDL 2.0.2 or later.
+             SDL1.2 does not implement this.
+
+   .. versionadded:: 2.0.0
+
+
+   .. ## pygame.display.set_allow_screensaver ##
+
+.. ## pygame.display ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/draw.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/draw.rst.txt
index 6816929..a759860 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/draw.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/draw.rst.txt
@@ -3,8 +3,550 @@
 :mod:`pygame.draw`
 ==================
 
-.. autopgmodule:: pygame.draw
-   :members:
+.. module:: pygame.draw
+   :synopsis: pygame module for drawing shapes
+
+| :sl:`pygame module for drawing shapes`
+
+Draw several simple shapes to a surface. These functions will work for
+rendering to any format of surface.
+
+Most of the functions take a width argument to represent the size of stroke
+(thickness) around the edge of the shape. If a width of 0 is passed the shape
+will be filled (solid).
+
+All the drawing functions respect the clip area for the surface and will be
+constrained to that area. The functions return a rectangle representing the
+bounding area of changed pixels. This bounding rectangle is the 'minimum'
+bounding box that encloses the affected area.
+
+All the drawing functions accept a color argument that can be one of the
+following formats:
+
+   - a :mod:`pygame.Color` object
+   - an ``(RGB)`` triplet (tuple/list)
+   - an ``(RGBA)`` quadruplet (tuple/list)
+   - an integer value that has been mapped to the surface's pixel format
+     (see :func:`pygame.Surface.map_rgb` and :func:`pygame.Surface.unmap_rgb`)
+
+A color's alpha value will be written directly into the surface (if the
+surface contains pixel alphas), but the draw function will not draw
+transparently.
+
+These functions temporarily lock the surface they are operating on. Many
+sequential drawing calls can be sped up by locking and unlocking the surface
+object around the draw calls (see :func:`pygame.Surface.lock` and
+:func:`pygame.Surface.unlock`).
+
+.. note ::
+   See the :mod:`pygame.gfxdraw` module for alternative draw methods.
+
+
+.. function:: rect
+
+   | :sl:`draw a rectangle`
+   | :sg:`rect(surface, color, rect) -> Rect`
+   | :sg:`rect(surface, color, rect, width=0, border_radius=0, border_top_left_radius=-1, border_top_right_radius=-1, border_bottom_left_radius=-1, border_bottom_right_radius=-1) -> Rect`
+
+   Draws a rectangle on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param Rect rect: rectangle to draw, position and dimensions
+   :param int width: (optional) used for line thickness or to indicate that
+      the rectangle is to be filled (not to be confused with the width value
+      of the ``rect`` parameter)
+
+         | if ``width == 0``, (default) fill the rectangle
+         | if ``width > 0``, used for line thickness
+         | if ``width < 0``, nothing will be drawn
+         |
+      
+      .. versionchanged:: 2.1.1 
+          Drawing rects with width now draws the width correctly inside the 
+          rect's area, rather than using an internal call to draw.lines(), 
+          which had half the width spill outside the rect area.
+
+   :param int border_radius: (optional) used for drawing rectangle with rounded corners.
+      The supported range is [0, min(height, width) / 2], with 0 representing a rectangle
+      without rounded corners.
+   :param int border_top_left_radius: (optional) used for setting the value of top left
+      border. If you don't set this value, it will use the border_radius value.
+   :param int border_top_right_radius: (optional) used for setting the value of top right
+      border. If you don't set this value, it will use the border_radius value.
+   :param int border_bottom_left_radius: (optional) used for setting the value of bottom left
+      border. If you don't set this value, it will use the border_radius value.
+   :param int border_bottom_right_radius: (optional) used for setting the value of bottom right
+      border. If you don't set this value, it will use the border_radius value.
+
+         | if ``border_radius < 1`` it will draw rectangle without rounded corners
+         | if any of border radii has the value ``< 0`` it will use value of the border_radius
+         | If sum of radii on the same side of the rectangle is greater than the rect size the radii
+         | will get scaled
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the position of the given ``rect``
+      parameter and its width and height will be 0
+   :rtype: Rect
+
+   .. note::
+      The :func:`pygame.Surface.fill()` method works just as well for drawing
+      filled rectangles and can be hardware accelerated on some platforms.
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+   .. versionchanged:: 2.0.0.dev8 Added support for border radius.
+
+   .. ## pygame.draw.rect ##
+
+.. function:: polygon
+
+   | :sl:`draw a polygon`
+   | :sg:`polygon(surface, color, points) -> Rect`
+   | :sg:`polygon(surface, color, points, width=0) -> Rect`
+
+   Draws a polygon on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param points: a sequence of 3 or more (x, y) coordinates that make up the
+      vertices of the polygon, each *coordinate* in the sequence must be a
+      tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats,
+      e.g. ``[(x1, y1), (x2, y2), (x3, y3)]``
+   :type points: tuple(coordinate) or list(coordinate)
+   :param int width: (optional) used for line thickness or to indicate that
+      the polygon is to be filled
+
+         | if width == 0, (default) fill the polygon
+         | if width > 0, used for line thickness
+         | if width < 0, nothing will be drawn
+         |
+
+         .. note::
+            When using ``width`` values ``> 1``, the edge lines will grow
+            outside the original boundary of the polygon. For more details on
+            how the thickness for edge lines grow, refer to the ``width`` notes
+            of the :func:`pygame.draw.line` function.
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the position of the first point in the
+      ``points`` parameter (float values will be truncated) and its width and
+      height will be 0
+   :rtype: Rect
+
+   :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
+   :raises TypeError: if ``points`` is not a sequence or ``points`` does not
+      contain number pairs
+
+   .. note::
+       For an aapolygon, use :func:`aalines()` with ``closed=True``.
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+
+   .. ## pygame.draw.polygon ##
+
+.. function:: circle
+
+   | :sl:`draw a circle`
+   | :sg:`circle(surface, color, center, radius) -> Rect`
+   | :sg:`circle(surface, color, center, radius, width=0, draw_top_right=None, draw_top_left=None, draw_bottom_left=None, draw_bottom_right=None) -> Rect`
+
+   Draws a circle on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param center: center point of the circle as a sequence of 2 ints/floats,
+      e.g. ``(x, y)``
+   :type center: tuple(int or float, int or float) or
+      list(int or float, int or float) or Vector2(int or float, int or float)
+   :param radius: radius of the circle, measured from the ``center`` parameter,
+      nothing will be drawn if the ``radius`` is less than 1
+   :type radius: int or float
+   :param int width: (optional) used for line thickness or to indicate that
+      the circle is to be filled
+
+         | if ``width == 0``, (default) fill the circle
+         | if ``width > 0``, used for line thickness
+         | if ``width < 0``, nothing will be drawn
+         |
+
+         .. note::
+            When using ``width`` values ``> 1``, the edge lines will only grow
+            inward.
+   :param bool draw_top_right: (optional) if this is set to True then the top right corner
+      of the circle will be drawn
+   :param bool draw_top_left: (optional) if this is set to True then the top left corner
+      of the circle will be drawn
+   :param bool draw_bottom_left: (optional) if this is set to True then the bottom left corner
+      of the circle will be drawn
+   :param bool draw_bottom_right: (optional) if this is set to True then the bottom right corner
+      of the circle will be drawn
+
+         | if any of the draw_circle_part is True then it will draw all circle parts that have the True
+         | value, otherwise it will draw the entire circle.
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the ``center`` parameter value (float
+      values will be truncated) and its width and height will be 0
+   :rtype: Rect
+
+   :raises TypeError: if ``center`` is not a sequence of two numbers
+   :raises TypeError: if ``radius`` is not a number
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+      Nothing is drawn when the radius is 0 (a pixel at the ``center`` coordinates
+      used to be drawn when the radius equaled 0).
+      Floats, and Vector2 are accepted for the ``center`` param.
+      The drawing algorithm was improved to look more like a circle.
+   .. versionchanged:: 2.0.0.dev8 Added support for drawing circle quadrants.
+
+   .. ## pygame.draw.circle ##
+
+.. function:: ellipse
+
+   | :sl:`draw an ellipse`
+   | :sg:`ellipse(surface, color, rect) -> Rect`
+   | :sg:`ellipse(surface, color, rect, width=0) -> Rect`
+
+   Draws an ellipse on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param Rect rect: rectangle to indicate the position and dimensions of the
+      ellipse, the ellipse will be centered inside the rectangle and bounded
+      by it
+   :param int width: (optional) used for line thickness or to indicate that
+      the ellipse is to be filled (not to be confused with the width value
+      of the ``rect`` parameter)
+
+         | if ``width == 0``, (default) fill the ellipse
+         | if ``width > 0``, used for line thickness
+         | if ``width < 0``, nothing will be drawn
+         |
+
+         .. note::
+            When using ``width`` values ``> 1``, the edge lines will only grow
+            inward from the original boundary of the ``rect`` parameter.
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the position of the given ``rect``
+      parameter and its width and height will be 0
+   :rtype: Rect
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+
+   .. ## pygame.draw.ellipse ##
+
+.. function:: arc
+
+   | :sl:`draw an elliptical arc`
+   | :sg:`arc(surface, color, rect, start_angle, stop_angle) -> Rect`
+   | :sg:`arc(surface, color, rect, start_angle, stop_angle, width=1) -> Rect`
+
+   Draws an elliptical arc on the given surface.
+
+   The two angle arguments are given in radians and indicate the start and stop
+   positions of the arc. The arc is drawn in a counterclockwise direction from
+   the ``start_angle`` to the ``stop_angle``.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param Rect rect: rectangle to indicate the position and dimensions of the
+      ellipse which the arc will be based on, the ellipse will be centered
+      inside the rectangle
+   :param float start_angle: start angle of the arc in radians
+   :param float stop_angle: stop angle of the arc in
+      radians
+
+         | if ``start_angle < stop_angle``, the arc is drawn in a
+            counterclockwise direction from the ``start_angle`` to the
+            ``stop_angle``
+         | if ``start_angle > stop_angle``, tau (tau == 2 * pi) will be added
+            to the ``stop_angle``, if the resulting stop angle value is greater
+            than the ``start_angle`` the above ``start_angle < stop_angle`` case
+            applies, otherwise nothing will be drawn
+         | if ``start_angle == stop_angle``, nothing will be drawn
+         |
+
+   :param int width: (optional) used for line thickness (not to be confused
+      with the width value of the ``rect`` parameter)
+
+         | if ``width == 0``, nothing will be drawn
+         | if ``width > 0``, (default is 1) used for line thickness
+         | if ``width < 0``, same as ``width == 0``
+
+         .. note::
+            When using ``width`` values ``> 1``, the edge lines will only grow
+            inward from the original boundary of the ``rect`` parameter.
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the position of the given ``rect``
+      parameter and its width and height will be 0
+   :rtype: Rect
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+
+   .. ## pygame.draw.arc ##
+
+.. function:: line
+
+   | :sl:`draw a straight line`
+   | :sg:`line(surface, color, start_pos, end_pos) -> Rect`
+   | :sg:`line(surface, color, start_pos, end_pos, width=1) -> Rect`
+
+   Draws a straight line on the given surface. There are no endcaps. For thick
+   lines the ends are squared off.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param start_pos: start position of the line, (x, y)
+   :type start_pos: tuple(int or float, int or float) or
+      list(int or float, int or float) or Vector2(int or float, int or float)
+   :param end_pos: end position of the line, (x, y)
+   :type end_pos: tuple(int or float, int or float) or
+      list(int or float, int or float) or Vector2(int or float, int or float)
+   :param int width: (optional) used for line thickness
+
+         | if width >= 1, used for line thickness (default is 1)
+         | if width < 1, nothing will be drawn
+         |
+
+         .. note::
+            When using ``width`` values ``> 1``, lines will grow as follows.
+
+            For odd ``width`` values, the thickness of each line grows with the
+            original line being in the center.
+
+            For even ``width`` values, the thickness of each line grows with the
+            original line being offset from the center (as there is no exact
+            center line drawn). As a result, lines with a slope < 1
+            (horizontal-ish) will have 1 more pixel of thickness below the
+            original line (in the y direction). Lines with a slope >= 1
+            (vertical-ish) will have 1 more pixel of thickness to the right of
+            the original line (in the x direction).
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the ``start_pos`` parameter value (float
+      values will be truncated) and its width and height will be 0
+   :rtype: Rect
+
+   :raises TypeError: if ``start_pos`` or ``end_pos`` is not a sequence of
+      two numbers
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+
+   .. ## pygame.draw.line ##
+
+.. function:: lines
+
+   | :sl:`draw multiple contiguous straight line segments`
+   | :sg:`lines(surface, color, closed, points) -> Rect`
+   | :sg:`lines(surface, color, closed, points, width=1) -> Rect`
+
+   Draws a sequence of contiguous straight lines on the given surface. There are
+   no endcaps or miter joints. For thick lines the ends are squared off.
+   Drawing thick lines with sharp corners can have undesired looking results.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param bool closed: if ``True`` an additional line segment is drawn between
+      the first and last points in the ``points`` sequence
+   :param points: a sequence of 2 or more (x, y) coordinates, where each
+      *coordinate* in the sequence must be a
+      tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats and adjacent
+      coordinates will be connected by a line segment, e.g. for the
+      points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will be drawn
+      from ``(x1, y1)`` to ``(x2, y2)`` and from ``(x2, y2)`` to ``(x3, y3)``,
+      additionally if the ``closed`` parameter is ``True`` another line segment
+      will be drawn from ``(x3, y3)`` to ``(x1, y1)``
+   :type points: tuple(coordinate) or list(coordinate)
+   :param int width: (optional) used for line thickness
+
+         | if width >= 1, used for line thickness (default is 1)
+         | if width < 1, nothing will be drawn
+         |
+
+         .. note::
+            When using ``width`` values ``> 1`` refer to the ``width`` notes
+            of :func:`line` for details on how thick lines grow.
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the position of the first point in the
+      ``points`` parameter (float values will be truncated) and its width and
+      height will be 0
+   :rtype: Rect
+
+   :raises ValueError: if ``len(points) < 2`` (must have at least 2 points)
+   :raises TypeError: if ``points`` is not a sequence or ``points`` does not
+      contain number pairs
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+
+   .. ## pygame.draw.lines ##
+
+.. function:: aaline
+
+   | :sl:`draw a straight antialiased line`
+   | :sg:`aaline(surface, color, start_pos, end_pos) -> Rect`
+   | :sg:`aaline(surface, color, start_pos, end_pos, blend=1) -> Rect`
+
+   Draws a straight antialiased line on the given surface.
+
+   The line has a thickness of one pixel and the endpoints have a height and
+   width of one pixel each.
+
+   The way a line and its endpoints are drawn:
+      If both endpoints are equal, only a single pixel is drawn (after
+      rounding floats to nearest integer).
+
+      Otherwise if the line is not steep (i.e. if the length along the x-axis
+      is greater than the height along the y-axis):
+
+         For each endpoint:
+
+            If ``x``, the endpoint's x-coordinate, is a whole number find
+            which pixels would be covered by it and draw them.
+
+            Otherwise:
+
+               Calculate the position of the nearest point with a whole number
+               for its x-coordinate, when extending the line past the
+               endpoint.
+
+               Find which pixels would be covered and how much by that point.
+
+               If the endpoint is the left one, multiply the coverage by (1 -
+               the decimal part of ``x``).
+
+               Otherwise multiply the coverage by the decimal part of ``x``.
+
+               Then draw those pixels.
+
+               *e.g.:*
+                  | The left endpoint of the line ``((1, 1.3), (5, 3))`` would
+                    cover 70% of the pixel ``(1, 1)`` and 30% of the pixel
+                    ``(1, 2)`` while the right one would cover 100% of the
+                    pixel ``(5, 3)``.
+                  | The left endpoint of the line ``((1.2, 1.4), (4.6, 3.1))``
+                    would cover 56% *(i.e. 0.8 * 70%)* of the pixel ``(1, 1)``
+                    and 24% *(i.e. 0.8 * 30%)* of the pixel ``(1, 2)`` while
+                    the right one would cover 42% *(i.e. 0.6 * 70%)* of the
+                    pixel ``(5, 3)`` and 18% *(i.e. 0.6 * 30%)* of the pixel
+                    ``(5, 4)`` while the right
+
+         Then for each point between the endpoints, along the line, whose
+         x-coordinate is a whole number:
+
+            Find which pixels would be covered and how much by that point and
+            draw them.
+
+            *e.g.:*
+               | The points along the line ``((1, 1), (4, 2.5))`` would be
+                 ``(2, 1.5)`` and ``(3, 2)`` and would cover 50% of the pixel
+                 ``(2, 1)``, 50% of the pixel ``(2, 2)`` and 100% of the pixel
+                 ``(3, 2)``.
+               | The points along the line ``((1.2, 1.4), (4.6, 3.1))`` would
+                 be ``(2, 1.8)`` (covering 20% of the pixel ``(2, 1)`` and 80%
+                 of the pixel ``(2, 2)``), ``(3, 2.3)`` (covering 70% of the
+                 pixel ``(3, 2)`` and 30% of the pixel ``(3, 3)``) and ``(4,
+                 2.8)`` (covering 20% of the pixel ``(2, 1)`` and 80% of the
+                 pixel ``(2, 2)``)
+
+      Otherwise do the same for steep lines as for non-steep lines except
+      along the y-axis instead of the x-axis (using ``y`` instead of ``x``,
+      top instead of left and bottom instead of right).
+
+   .. note::
+      Regarding float values for coordinates, a point with coordinate
+      consisting of two whole numbers is considered being right in the center
+      of said pixel (and having a height and width of 1 pixel would therefore
+      completely cover it), while a point with coordinate where one (or both)
+      of the numbers have non-zero decimal parts would be partially covering
+      two (or four if both numbers have decimal parts) adjacent pixels, *e.g.*
+      the point ``(1.4, 2)`` covers 60% of the pixel ``(1, 2)`` and 40% of the
+      pixel ``(2,2)``.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param start_pos: start position of the line, (x, y)
+   :type start_pos: tuple(int or float, int or float) or
+      list(int or float, int or float) or Vector2(int or float, int or float)
+   :param end_pos: end position of the line, (x, y)
+   :type end_pos: tuple(int or float, int or float) or
+      list(int or float, int or float) or Vector2(int or float, int or float)
+   :param int blend: (optional) (deprecated) if non-zero (default) the line will be blended
+      with the surface's existing pixel shades, otherwise it will overwrite them
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the ``start_pos`` parameter value (float
+      values will be truncated) and its width and height will be 0
+   :rtype: Rect
+
+   :raises TypeError: if ``start_pos`` or ``end_pos`` is not a sequence of
+      two numbers
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+
+   .. ## pygame.draw.aaline ##
+
+.. function:: aalines
+
+   | :sl:`draw multiple contiguous straight antialiased line segments`
+   | :sg:`aalines(surface, color, closed, points) -> Rect`
+   | :sg:`aalines(surface, color, closed, points, blend=1) -> Rect`
+
+   Draws a sequence of contiguous straight antialiased lines on the given
+   surface.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or int or tuple(int, int, int, [int])
+   :param bool closed: if ``True`` an additional line segment is drawn between
+      the first and last points in the ``points`` sequence
+   :param points: a sequence of 2 or more (x, y) coordinates, where each
+      *coordinate* in the sequence must be a
+      tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats and adjacent
+      coordinates will be connected by a line segment, e.g. for the
+      points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will be drawn
+      from ``(x1, y1)`` to ``(x2, y2)`` and from ``(x2, y2)`` to ``(x3, y3)``,
+      additionally if the ``closed`` parameter is ``True`` another line segment
+      will be drawn from ``(x3, y3)`` to ``(x1, y1)``
+   :type points: tuple(coordinate) or list(coordinate)
+   :param int blend: (optional) (deprecated) if non-zero (default) each line will be blended
+      with the surface's existing pixel shades, otherwise the pixels will be
+      overwritten
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the position of the first point in the
+      ``points`` parameter (float values will be truncated) and its width and
+      height will be 0
+   :rtype: Rect
+
+   :raises ValueError: if ``len(points) < 2`` (must have at least 2 points)
+   :raises TypeError: if ``points`` is not a sequence or ``points`` does not
+      contain number pairs
+
+   .. versionchanged:: 2.0.0 Added support for keyword arguments.
+
+   .. ## pygame.draw.aalines ##
+
+.. ## pygame.draw ##
 
 .. figure:: code_examples/draw_module_example.png
    :alt: draw module example
@@ -12,3 +554,4 @@
    Example code for draw module.
 
 .. literalinclude:: code_examples/draw_module_example.py
+
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/event.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/event.rst.txt
index a34ce22..aa5b7e7 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/event.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/event.rst.txt
@@ -8,179 +8,216 @@
 
 | :sl:`pygame module for interacting with events and queues`
 
-.. rubric:: Event queue
-
-Pygame handles all its event messaging through an event queue. The functions in
+Pygame handles all its event messaging through an event queue. The routines in
 this module help you manage that event queue. The input queue is heavily
-dependent on the video system (:mod:`pygame.display` or :class:`pygame.Window`).
-If a window has not been created, the event queue may not work properly.
+dependent on the :mod:`pygame.display` module. If the display has not been
+initialized and a video mode not set, the event queue may not work properly.
 
 The event queue has an upper limit on the number of events it can hold. When
 the queue becomes full new events are quietly dropped. To prevent lost events,
 especially input events which signal a quit command, your program must handle
-events every frame (with :func:`pygame.event.get()`, :func:`pygame.event.pump()`,
-:func:`pygame.event.wait()`, :func:`pygame.event.peek()` or
-:func:`pygame.event.clear()`).
-
-.. note:: Not handling events may cause the system to decide the program is
-   frozen (not responding).
-
-.. rubric:: Events of input devices
+events every frame (with ``pygame.event.get()``, ``pygame.event.pump()``,
+``pygame.event.wait()``, ``pygame.event.peek()`` or ``pygame.event.clear()``)
+and process them. Not handling events may cause your system to decide your
+program has locked up. To speed up queue processing use
+:func:`pygame.event.set_blocked()` to limit which events get queued.
 
 To get the state of various input devices, you can forego the event queue and
 access the input devices directly with their appropriate modules:
-:mod:`pygame.mouse`, :mod:`pygame.key`, and :mod:`pygame.joystick`. However,
-the event queue still needs to be running internally to enable this; programs
-still need to use functions like :func:`pygame.event.get()` or
-:func:`pygame.event.pump()` periodically. Note: Joysticks will not send any
-events until the device has been initialized.
-
-.. rubric:: Event objects
+:mod:`pygame.mouse`, :mod:`pygame.key`, and :mod:`pygame.joystick`. If you use
+this method, remember that pygame requires some form of communication with the
+system window manager and other parts of the platform. To keep pygame in sync
+with the system, you will need to call :func:`pygame.event.pump()` to keep
+everything current. Usually, this should be called once per game loop.
+Note: Joysticks will not send any events until the device has been initialized.
 
 The event queue contains :class:`pygame.event.Event` event objects.
 There are a variety of ways to access the queued events, from simply
-checking for the existence of events, to popping them off of the event queue.
+checking for the existence of events, to grabbing them directly off the stack.
+The event queue also offers some simple filtering which can slightly help
+performance by blocking certain event types from the queue. Use
+:func:`pygame.event.set_allowed()` and :func:`pygame.event.set_blocked()` to
+change this filtering. By default, all event types can be placed on the queue.
 
 All :class:`pygame.event.Event` instances contain an event type identifier
 and attributes specific to that event type. The event type identifier is
-accessible as the :attr:`pygame.event.Event.type` property. An event type's
-specific attributes can be accessed directly as an attribute on the event
-object.
+accessible as the :attr:`pygame.event.Event.type` property. Any of the
+event specific attributes can be accessed through the
+:attr:`pygame.event.Event.__dict__` attribute or directly as an attribute
+of the event object (as member lookups are passed through to the object's
+dictionary values). The event object has no method functions. Users can create
+their own new events with the :func:`pygame.event.Event()` function.
 
-Users can create their own new events (or emulate system events) by
-instantiating :func:`pygame.event.Event()` themselves, usually paired
-with :func:`pygame.event.post()`.
+The event type identifier is in between the values of ``NOEVENT`` and
+``NUMEVENTS``. User defined events should have a value in the inclusive range
+of ``USEREVENT`` to ``NUMEVENTS - 1``. User defined events can get a custom
+event number with :func:`pygame.event.custom_type()`. 
+It is recommended all user events follow this system.
 
 Events support equality and inequality comparisons. Two events are equal if
 they are the same type and have identical attribute values.
 
-.. rubric:: Custom events and debugging
-
-The event type identifier is in between the values of ``NOEVENT`` and
-``NUMEVENTS``. User defined events should have a value in the inclusive range
-of ``USEREVENT`` to ``NUMEVENTS - 1``. User defined events should reserve
-a custom event number with :func:`pygame.event.custom_type()`.
-
 While debugging and experimenting, you can print an event object for a quick
-display of its type and members.
-
-.. rubric:: Event types and attributes
+display of its type and members. The function :func:`pygame.event.event_name()`
+can be used to get a string representing the name of the event type.
 
 Events that come from the system will have a guaranteed set of member
-attributes based on the type. The following are lists of event types with their
-specific attributes and notes.
+attributes based on the type. The following is a list of event types with their
+specific attributes.
+
+::
+
+    QUIT              none
+    ACTIVEEVENT       gain, state
+    KEYDOWN           key, mod, unicode, scancode
+    KEYUP             key, mod, unicode, scancode
+    MOUSEMOTION       pos, rel, buttons, touch
+    MOUSEBUTTONUP     pos, button, touch
+    MOUSEBUTTONDOWN   pos, button, touch
+    JOYAXISMOTION     joy (deprecated), instance_id, axis, value
+    JOYBALLMOTION     joy (deprecated), instance_id, ball, rel
+    JOYHATMOTION      joy (deprecated), instance_id, hat, value
+    JOYBUTTONUP       joy (deprecated), instance_id, button
+    JOYBUTTONDOWN     joy (deprecated), instance_id, button
+    VIDEORESIZE       size, w, h
+    VIDEOEXPOSE       none
+    USEREVENT         code
+
+.. versionchanged:: 2.0.0 The ``joy`` attribute was deprecated, ``instance_id`` was added.
+
+.. versionchanged:: 2.0.1 The ``unicode`` attribute was added to ``KEYUP`` event.
+
+Note that ``ACTIVEEVENT``, ``VIDEORESIZE`` and ``VIDEOEXPOSE`` are considered
+as "legacy" events, the use of pygame2 ``WINDOWEVENT`` API is recommended over
+the use of this older API.
 
 You can also find a list of constants for keyboard keys
 :ref:`here `.
 
-::
+A keyboard event occurs when a key is pressed (``KEYDOWN``) and when a key is released (``KEYUP``) 
+The ``key`` attribute of keyboard events contains the value of what key was pressed or released.
+The ``mod`` attribute contains information about the state of keyboard modifiers (SHIFT, CTRL, ALT, etc.).
+The ``unicode`` attribute stores the 16-bit unicode value of the key that was pressed or released.
+The ``scancode`` attribute represents the physical location of a key on the keyboard.
 
-    Event type                 Attributes/Notes
-
-    QUIT
-    USEREVENT                  (Starting type of the user defined
-                                event types)
-
-    KEYDOWN                    key, mod, unicode, scancode, window(1)
-    KEYUP                      key, mod, unicode, scancode, window(1)
-
-    MOUSEMOTION                pos, rel, buttons, touch(2), window(1)
-    MOUSEBUTTONUP              pos, button, touch(2), clicks(3), window(1)
-    MOUSEBUTTONDOWN            pos, button, touch(2), clicks(3), window(1)
-    MOUSEWHEEL                 which, flipped, x, y, touch(2), precise_x,
-                                precise_y, window(1), pos(5)
-
-    JOYAXISMOTION              instance_id, axis, value (deprecated: joy)
-    JOYBALLMOTION              instance_id, ball, rel (deprecated: joy)
-    JOYHATMOTION               instance_id, hat, value (deprecated: joy)
-    JOYBUTTONUP                instance_id, button (deprecated: joy)
-    JOYBUTTONDOWN              instance_id, button (deprecated: joy)
-    CONTROLLERDEVICEADDED      device_index
-    JOYDEVICEADDED             device_index
-    CONTROLLERDEVICEREMOVED    instance_id
-    JOYDEVICEREMOVED           instance_id
-    CONTROLLERDEVICEREMAPPED   instance_id
-
-    (Use the window event API instead of legacy events)
-    ACTIVEEVENT                gain, state (Legacy event)
-    VIDEORESIZE                size, w, h  (Legacy event)
-    VIDEOEXPOSE                            (Legacy event)
-
-    AUDIODEVICEADDED           which, iscapture
-    AUDIODEVICEREMOVED         which, iscapture
-
-    FINGERMOTION               touch_id, finger_id, x, y, dx, dy, window(1)
-    FINGERDOWN                 touch_id, finger_id, x, y, dx, dy, window(1)
-    FINGERUP                   touch_id, finger_id, x, y, dx, dy, window(1)
-    MULTIGESTURE               touch_id, x, y, pinched, rotated, num_fingers
-
-    TEXTEDITING(4)             text, start(4), length(4), window(1)
-    TEXTINPUT(4)               text, window(1)
-
-    DROPFILE                   window(1), file (Path of the file dropped
-                                on the window)
-    DROPBEGIN                  window(1)
-    DROPCOMPLETE               window(1)
-    DROPTEXT                   window(1)
-
-    MIDIIN                     (Reserved for pygame.midi use)
-    MIDIOUT                    (Reserved for pygame.midi use)
-
-    KEYMAPCHANGED              (Keymap change due to language/keyboard
-                                layout change)
-    CLIPBOARDUPDATE            (Partially experimental)
-    LOCALECHANGED
-
-    RENDER_TARGETS_RESET
-    RENDER_DEVICE_RESET
+The ``ACTIVEEVENT`` contains information about the application gaining or losing focus. The ``gain`` attribute
+will be 1 if the mouse enters the window, otherwise ``gain`` will be 0.  The ``state`` attribute will have a 
+value of ``SDL_APPMOUSEFOCUS`` if mouse focus was gained/lost, ``SDL_APPINPUTFOCUS`` if the application loses
+or gains keyboard focus, or ``SDL_APPACTIVE`` if the application is minimized (``gain`` will be 0) or restored.
 
 |
 
-(``1``): if a :class:`pygame.Window` instance exists for the window that the event
-occurred in, the ``window`` attribute of these events will be that instance,
-otherwise it will be ``None``.
-
-(``2``): The ``touch`` attribute of ``MOUSE`` events indicates whether or not the
-events were generated by a touch input device, and not a real mouse. You might
-want to ignore such events, if your application already handles ``FINGERMOTION``,
-``FINGERDOWN`` and ``FINGERUP`` events.
-
-(``3``): The ``clicks`` attribute of the ``MOUSEBUTTONDOWN`` and ``MOUSEBUTTONUP``
-events indicate the number of clicks occurring in rapid succession, e.g. ``1``
-for single-click, ``2`` for double-click, etc. Note that double, triple, or
-more clicks will still fire mouse events for each individual click, with a
-progressively increasing ``clicks`` attribute.
-
-(``4``): The ``start`` attribute of the ``TEXTEDITING`` event is the cursor position,
-in UTF-8 characters, where the new typing will be inserted into the editing text,
-while the ``length`` attribute is the number of UTF-8 characters that will be
-replaced by the new typing.
-
-These ``TEXT*`` events are useful to implement inputs/languages that require composition,
-provided by the system's IME (Input Method Editor). The ``TEXTINPUT`` event is only
-fired when the text is confirmed.
-
-(``5``): Position information was added to ``MOUSEWHEEL`` events in SDL 2.26.0.  If
-pygame was built on a version lower than that, the ``pos`` attribute is ``None``.
-
-|
-
-Here is a list of the new window events.
-
-All window events have a ``window`` attribute corresponding to the
-:class:`pygame.Window` that generated them.
+When compiled with SDL2, pygame has these additional events and their
+attributes.
 
 ::
 
-   Event type             Short description and additional attributes
+    AUDIODEVICEADDED   which, iscapture (SDL backend >= 2.0.4)
+    AUDIODEVICEREMOVED which, iscapture (SDL backend >= 2.0.4)
+    FINGERMOTION       touch_id, finger_id, x, y, dx, dy
+    FINGERDOWN         touch_id, finger_id, x, y, dx, dy
+    FINGERUP           touch_id, finger_id, x, y, dx, dy
+    MOUSEWHEEL         which, flipped, x, y, touch, precise_x, precise_y
+    MULTIGESTURE       touch_id, x, y, pinched, rotated, num_fingers
+    TEXTEDITING        text, start, length
+    TEXTINPUT          text
+
+.. versionadded:: 1.9.5
+
+.. versionchanged:: 2.0.2 Fixed amount horizontal scroll (x, positive to the right and negative to the left).
+
+.. versionchanged:: 2.0.2 The ``touch`` attribute was added to all the ``MOUSE`` events.
+
+The ``touch`` attribute of ``MOUSE`` events indicates whether or not the events were generated
+by a touch input device, and not a real mouse. You might want to ignore such events, if your application
+already handles ``FINGERMOTION``, ``FINGERDOWN`` and ``FINGERUP`` events.
+
+.. versionadded:: 2.1.3 Added ``precise_x`` and ``precise_y`` to ``MOUSEWHEEL`` events
+
+``MOUSEWHEEL`` event occurs whenever the mouse wheel is moved. 
+The ``which`` attribute determines if the event was generated from a touch input device vs an actual 
+mousewheel. 
+The ``preciseX`` attribute contains a float with the amount scrolled horizontally (positive to the right,
+negative to the left).
+The ``preciseY`` attribute contains a float with the amount scrolled vertically (positive away from user,
+negative towards user).
+The ``flipped`` attribute determines if the values in x and y will be opposite or not. If ``SDL_MOUSEWHEEL_FLIPPED``
+is defined, the direction of x and y will be opposite.
+
+``TEXTEDITING`` event is triggered when a user activates an input method via hotkey or selecting an 
+input method in a GUI and starts typing
+
+The ``which`` attribute for ``AUDIODEVICE*`` events is an integer representing the index for new audio 
+devices that are added. ``AUDIODEVICE*`` events are used to update audio settings or device list. 
+
+|
+
+Many new events were introduced in pygame 2.
+
+pygame can recognize text or files dropped in its window. If a file
+is dropped, ``DROPFILE`` event will be sent, ``file`` will be its path.
+The ``DROPTEXT`` event is only supported on X11.
+
+``MIDIIN`` and ``MIDIOUT`` are events reserved for :mod:`pygame.midi` use.
+``MIDI*`` events differ from ``AUDIODEVICE*`` events in that AUDIODEVICE 
+events are triggered when there is a state change related to an audio 
+input/output device. 
+
+pygame 2 also supports controller hot-plugging
+
+::
+
+   Event name               Attributes and notes
+
+   DROPFILE                 file
+   DROPBEGIN                (SDL backend >= 2.0.5)
+   DROPCOMPLETE             (SDL backend >= 2.0.5)
+   DROPTEXT                 text (SDL backend >= 2.0.5)
+   MIDIIN
+   MIDIOUT
+   CONTROLLERDEVICEADDED    device_index
+   JOYDEVICEADDED           device_index
+   CONTROLLERDEVICEREMOVED  instance_id
+   JOYDEVICEREMOVED         instance_id
+   CONTROLLERDEVICEREMAPPED instance_id
+   KEYMAPCHANGED            (SDL backend >= 2.0.4)
+   CLIPBOARDUPDATE
+   RENDER_TARGETS_RESET     (SDL backend >= 2.0.2)
+   RENDER_DEVICE_RESET      (SDL backend >= 2.0.4)
+   LOCALECHANGED            (SDL backend >= 2.0.14)
+
+Also in this version, ``instance_id`` attributes were added to joystick events,
+and the ``joy`` attribute was deprecated.
+
+``KEYMAPCHANGED`` is a type of an event sent when keymap changes due to a 
+system event such as an input language or keyboard layout change.
+
+``CLIPBOARDUPDATE`` is an event sent when clipboard changes. This can still
+be considered as an experimental feature, some kinds of clipboard changes might
+not trigger this event.
+
+``LOCALECHANGED`` is an event sent when user locale changes
+
+.. versionadded:: 2.0.0
+
+.. versionadded:: 2.1.3 ``KEYMAPCHANGED``, ``CLIPBOARDUPDATE``, 
+   ``RENDER_TARGETS_RESET``, ``RENDER_DEVICE_RESET`` and ``LOCALECHANGED``
+
+|
+
+Since pygame 2.0.1, there are a new set of events, called window events.
+Here is a list of all window events, along with a short description
+
+::
+
+   Event type                Short description
 
    WINDOWSHOWN            Window became shown
    WINDOWHIDDEN           Window became hidden
    WINDOWEXPOSED          Window got updated by some external event
-   WINDOWMOVED            Window got moved        (x, y attributes)
-   WINDOWSIZECHANGED      Window size has changed (x, y attributes)
-   WINDOWRESIZED          Window got resized by the user/window manager
-                           (x, y attributes)
+   WINDOWMOVED            Window got moved
+   WINDOWRESIZED          Window got resized
+   WINDOWSIZECHANGED      Window changed its size
    WINDOWMINIMIZED        Window was minimized
    WINDOWMAXIMIZED        Window was maximized
    WINDOWRESTORED         Window was restored
@@ -189,44 +226,36 @@ All window events have a ``window`` attribute corresponding to the
    WINDOWFOCUSGAINED      Window gained focus
    WINDOWFOCUSLOST        Window lost focus
    WINDOWCLOSE            Window was closed
-   WINDOWTAKEFOCUS        Window was offered focus
-   WINDOWHITTEST          Window has a special hit test
-   WINDOWICCPROFCHANGED   Window ICC profile changed
-                           (SDL backend >= 2.0.18)
-   WINDOWDISPLAYCHANGED   Window moved on a new display (display_index
-                           attribute. SDL backend >= 2.0.18)
+   WINDOWTAKEFOCUS        Window was offered focus (SDL backend >= 2.0.5)
+   WINDOWHITTEST          Window has a special hit test (SDL backend >= 2.0.5)
+   WINDOWICCPROFCHANGED   Window ICC profile changed (SDL backend >= 2.0.18)
+   WINDOWDISPLAYCHANGED   Window moved on a new display (SDL backend >= 2.0.18)
+
+
+``WINDOWMOVED``, ``WINDOWRESIZED`` and ``WINDOWSIZECHANGED`` have ``x`` and
+``y`` attributes, ``WINDOWDISPLAYCHANGED`` has a ``display_index`` attribute.
+All windowevents have a ``window`` attribute.
+
+.. versionadded:: 2.0.1
+
+.. versionadded:: 2.1.3 ``WINDOWICCPROFCHANGED`` and ``WINDOWDISPLAYCHANGED``
 
 |
 
-On Android, the following events can be generated:
+On Android, the following events can be generated
 
 ::
 
-   Event type                Short description
+   Event type                 Short description
 
    APP_TERMINATING           OS is terminating the application
-   APP_LOWMEMORY             OS is low on memory (try to free memory)
+   APP_LOWMEMORY             OS is low on memory, try to free memory if possible
    APP_WILLENTERBACKGROUND   Application is entering background
    APP_DIDENTERBACKGROUND    Application entered background
    APP_WILLENTERFOREGROUND   Application is entering foreground
    APP_DIDENTERFOREGROUND    Application entered foreground
 
-|
-
-.. versionchangedold:: 2.0.0 The ``joy`` attribute was deprecated, ``instance_id`` was added.
-
-.. versionaddedold:: 2.0.1 Window events and the ``unicode`` attribute for ``KEYUP`` events.
-
-.. versionaddedold:: 2.0.2 The ``touch`` attribute was added to all the ``MOUSE`` events.
-
-.. versionadded:: 2.1.3 Android events, ``precise_x`` and ``precise_y`` to ``MOUSEWHEEL`` events,
-   ``KEYMAPCHANGED``, ``CLIPBOARDUPDATE``, ``LOCALECHANGED``, ``WINDOWICCPROFCHANGED``,
-   ``WINDOWDISPLAYCHANGED``, ``RENDER_TARGETS_RESET``, and ``RENDER_DEVICE_RESET``.
-
-.. versionadded:: 2.5.7 The ``clicks`` attribute was added to ``MOUSEBUTTONDOWN``
-   and ``MOUSEBUTTONUP`` events.
-
-.. versionadded:: 2.5.8 The ``pos`` attribute was added to ``MOUSEWHEEL`` events.
+.. versionadded:: 2.1.3
 
 |
 
@@ -275,8 +304,8 @@ On Android, the following events can be generated:
 
    If ``pump`` is ``True`` (the default), then :func:`pygame.event.pump()` will be called.
 
-   .. versionchangedold:: 1.9.5 Added ``pump`` argument
-   .. versionchangedold:: 2.0.2 Added ``exclude`` argument
+   .. versionchanged:: 1.9.5 Added ``pump`` argument
+   .. versionchanged:: 2.0.2 Added ``exclude`` argument
 
    .. ## pygame.event.get ##
 
@@ -302,13 +331,13 @@ On Android, the following events can be generated:
 
    Returns a single event from the queue. If the queue is empty this function
    will wait until one is created. From pygame 2.0.0, if a ``timeout`` argument
-   is given, the function will return an event of type ``pygame.NOEVENT``
+   is given, the function will return an event of type ``pygame.NOEVENT`` 
    if no events enter the queue in ``timeout`` milliseconds. The event is removed
    from the queue once it has been returned. While the program is waiting it will
    sleep in an idle state. This is important for programs that want to share the
    system with other applications.
 
-   .. versionchangedold:: 2.0.0.dev13 Added ``timeout`` argument
+   .. versionchanged:: 2.0.0.dev13 Added ``timeout`` argument
 
    .. caution::
       This function should only be called in the thread that initialized :mod:`pygame.display`.
@@ -325,14 +354,9 @@ On Android, the following events can be generated:
    queue. If a sequence of event types is passed, this will return ``True`` if
    any of those events are on the queue.
 
-   When ``eventtype`` is not passed or ``None``, this function will return ``True`` if
-   there's any event on the queue, and return ``False`` if the queue is empty.
-
    If ``pump`` is ``True`` (the default), then :func:`pygame.event.pump()` will be called.
 
-   .. versionchangedold:: 1.9.5 Added ``pump`` argument
-
-   .. versionchanged:: 2.5.3 no longer mistakenly returns an event when ``eventtype`` is None or not passed.
+   .. versionchanged:: 1.9.5 Added ``pump`` argument
 
    .. ## pygame.event.peek ##
 
@@ -348,14 +372,14 @@ On Android, the following events can be generated:
 
    If ``pump`` is ``True`` (the default), then :func:`pygame.event.pump()` will be called.
 
-   .. versionchangedold:: 1.9.5 Added ``pump`` argument
+   .. versionchanged:: 1.9.5 Added ``pump`` argument
 
    .. ## pygame.event.clear ##
 
 .. function:: event_name
 
    | :sl:`get the string name from an event id`
-   | :sg:`event_name(type, /) -> string`
+   | :sg:`event_name(type) -> string`
 
    Returns a string representing the name (in CapWords style) of the given
    event type.
@@ -363,13 +387,15 @@ On Android, the following events can be generated:
    "UserEvent" is returned for all values in the user event id range.
    "Unknown" is returned when the event type does not exist.
 
+   .. versionchanged:: 2.5.0 Added support for keyword arguments.
    .. ## pygame.event.event_name ##
 
+
 .. function:: set_blocked
 
-   | :sl:`control which events are blocked on the queue`
-   | :sg:`set_blocked(type, /) -> None`
-   | :sg:`set_blocked(typelist, /) -> None`
+   | :sl:`control which events are allowed on the queue`
+   | :sg:`set_blocked(type) -> None`
+   | :sg:`set_blocked(typelist) -> None`
    | :sg:`set_blocked(None) -> None`
 
    The given event types are not allowed to appear on the event queue. By
@@ -384,8 +410,8 @@ On Android, the following events can be generated:
 .. function:: set_allowed
 
    | :sl:`control which events are allowed on the queue`
-   | :sg:`set_allowed(type, /) -> None`
-   | :sg:`set_allowed(typelist, /) -> None`
+   | :sg:`set_allowed(type) -> None`
+   | :sg:`set_allowed(typelist) -> None`
    | :sg:`set_allowed(None) -> None`
 
    The given event types are allowed to appear on the event queue. By default,
@@ -400,8 +426,8 @@ On Android, the following events can be generated:
 .. function:: get_blocked
 
    | :sl:`test if a type of event is blocked from the queue`
-   | :sg:`get_blocked(type, /) -> bool`
-   | :sg:`get_blocked(typelist, /) -> bool`
+   | :sg:`get_blocked(type) -> bool`
+   | :sg:`get_blocked(typelist) -> bool`
 
    Returns ``True`` if the given event type is blocked from the queue. If a
    sequence of event types is passed, this will return ``True`` if any of those
@@ -412,7 +438,7 @@ On Android, the following events can be generated:
 .. function:: set_grab
 
    | :sl:`control the sharing of input devices with other applications`
-   | :sg:`set_grab(bool, /) -> None`
+   | :sg:`set_grab(bool) -> None`
 
    When your program runs in a windowed environment, it will share the mouse
    and keyboard devices with other applications that have focus. If your
@@ -433,26 +459,44 @@ On Android, the following events can be generated:
 
    .. ## pygame.event.get_grab ##
 
+.. function:: set_keyboard_grab
+
+   | :sl:`grab enables capture of system keyboard shortcuts like Alt+Tab or the Meta/Super key.`
+   | :sg:`set_keyboard_grab(bool) -> None`
+
+   Keyboard grab enables capture of system keyboard shortcuts like Alt+Tab or the Meta/Super key.
+   Note that not all system keyboard shortcuts can be captured by applications (one example is Ctrl+Alt+Del on Windows).
+   This is primarily intended for specialized applications such as VNC clients or VM frontends. Normal games should not use keyboard grab.
+
+   .. versionadded:: 2.5.0
+
+   .. ## pygame.event.set_keyboard_grab ##
+
+.. function:: get_keyboard_grab
+
+   | :sl:`get the current keyboard grab state`
+   | :sg:`get_keyboard_grab() -> bool`
+
+   Returns ``True`` when keyboard grab is enabled.
+
+   .. versionadded:: 2.5.0
+
+   .. ## pygame.event.get_keyboard_grab ##
+
 .. function:: post
 
    | :sl:`place a new event on the queue`
-   | :sg:`post(event, /) -> bool`
+   | :sg:`post(Event) -> bool`
 
    Places the given event at the end of the event queue.
 
    This is usually used for placing custom events on the event queue.
    Any type of event can be posted, and the events posted can have any attributes.
 
-   When this event is received on the event queue, it will be a shallow copy of
-   the event object posted by this function; the dict attribute of both events
-   will be a reference to the same dict object in memory. Modifications on one
-   dict can affect another, use deepcopy operations on the dict object if you
-   don't want this behaviour.
-
    This returns a boolean on whether the event was posted or not. Blocked events
    cannot be posted, and this function returns ``False`` if you try to post them.
 
-   .. versionchangedold:: 2.0.1 returns a boolean, previously returned ``None``
+   .. versionchanged:: 2.0.1 returns a boolean, previously returned ``None``
 
    .. ## pygame.event.post ##
 
@@ -461,11 +505,11 @@ On Android, the following events can be generated:
    | :sl:`make custom user event type`
    | :sg:`custom_type() -> int`
 
-   Reserves an event slot for use in a custom event ``userevent`` and returns the integer that the event slot is reserved to.
+   Reserves a ``pygame.USEREVENT`` for a custom use.
 
    If too many events are made a :exc:`pygame.error` is raised.
 
-   .. versionaddedold:: 2.0.0.dev3
+   .. versionadded:: 2.0.0.dev3
 
    .. ## pygame.event.custom_type ##
 
@@ -481,9 +525,6 @@ On Android, the following events can be generated:
    When creating the object, the attributes may come from a dictionary
    argument with string keys or from keyword arguments.
 
-   .. versionchanged:: 2.1.4 This class is also available through the ``pygame.Event``
-      alias.
-
    .. note::
       From version 2.1.3 ``EventType`` is an alias for ``Event``. Beforehand,
       ``Event`` was a function that returned ``EventType`` instances. Use of
@@ -497,7 +538,7 @@ On Android, the following events can be generated:
 
       Read-only. The event type identifier. For user created event
       objects, this is the ``type`` argument passed to
-      :class:`pygame.event.Event()`.
+      :func:`pygame.event.Event()`.
 
       For example, some predefined event identifiers are ``QUIT`` and
       ``MOUSEMOTION``.
@@ -517,7 +558,7 @@ On Android, the following events can be generated:
 
       .. ## pygame.event.Event.__dict__ ##
 
-   .. versionaddedold:: 1.9.2 Mutable attributes.
+   .. versionadded:: 1.9.2 Mutable attributes.
 
    .. ## pygame.event.Event ##
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/examples.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/examples.rst.txt
index 88dc4d9..000ea76 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/examples.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/examples.rst.txt
@@ -26,7 +26,7 @@ eg:
 
    python -m pygame.examples.scaletest someimage.png
 
-Resources such as images and sounds for the examples are found in the
+Resources such as images and sounds for the examples are found in the 
 pygame/examples/data subdirectory.
 
 You can find where the example files are installed by using the following
@@ -287,8 +287,8 @@ pygame much earlier.
    Thumbnail generation with scaling is an example of what you can do with
    pygame.
 
-   ``NOTE``: the pygame scale function uses SIMD acceleration if available,
-   and can be run in multiple threads.
+   ``NOTE``: the pygame scale function uses MMX/SSE if available, and can be
+   run in multiple threads.
 
    If ``headless_no_windows_needed.py`` is run as a program it takes the
    following command line arguments:
@@ -307,7 +307,7 @@ pygame much earlier.
 
    A demo showing full joystick support.
 
-   .. versionaddedold:: 2.0.2
+   .. versionadded:: 2.0.2
 
    .. ## pygame.examples.joystick.main ##
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/font.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/font.rst.txt
index 5fa86b0..9f09a8b 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/font.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/font.rst.txt
@@ -24,7 +24,7 @@ accessed by passing ``None`` as the font name.
 
 Before pygame 2.0.3, pygame.font accepts any UCS-2 / UTF-16 character
 ('\\u0001' to '\\uFFFF'). After 2.0.3, pygame.font built with SDL_ttf
-2.0.15 accepts any valid UCS-4 / UTF-32 character
+2.0.15 accepts any valid UCS-4 / UTF-32 character 
 (like emojis, if the font has them) ('\\U00000001' to '\\U0010FFFF')).
 More about this in :func:`Font.render`.
 
@@ -36,7 +36,7 @@ solves no longer exists, it will likely be removed in the future.
 
 .. function:: init
 
-   | :sl:`Initialize the font module.`
+   | :sl:`initialize the font module`
    | :sg:`init() -> None`
 
    This method is called automatically by ``pygame.init()``. It initializes the
@@ -49,7 +49,7 @@ solves no longer exists, it will likely be removed in the future.
 
 .. function:: quit
 
-   | :sl:`Uninitialize the font module.`
+   | :sl:`uninitialize the font module`
    | :sg:`quit() -> None`
 
    Manually uninitialize SDL_ttf's font system. This is called automatically by
@@ -57,30 +57,90 @@ solves no longer exists, it will likely be removed in the future.
 
    It is safe to call this function even if font is currently not initialized.
 
-   Previously created font objects will be invalid after the font module is quit.
-
    .. ## pygame.font.quit ##
 
 .. function:: get_init
 
-   | :sl:`True if the font module is initialized.`
+   | :sl:`true if the font module is initialized`
    | :sg:`get_init() -> bool`
 
    Test if the font module is initialized or not.
 
    .. ## pygame.font.get_init ##
 
-.. autopgfunction:: get_default_font
+.. function:: get_default_font
 
-.. autopgfunction:: get_sdl_ttf_version
+   | :sl:`get the filename of the default font`
+   | :sg:`get_default_font() -> string`
 
-.. autopgfunction:: get_fonts
+   Return the filename of the system font. This is not the full path to the
+   file. This file can usually be found in the same directory as the font
+   module, but it can also be bundled in separate archives.
 
-.. autopgfunction:: match_font
+   .. ## pygame.font.get_default_font ##
+
+.. function:: get_sdl_ttf_version
+
+   | :sl:`gets SDL_ttf version`
+   | :sg:`get_sdl_ttf_version(linked=True) -> (major, minor, patch)`
+
+   **Experimental:** feature still in development available for testing and feedback. It may change.
+   `Please leave get_sdl_ttf_version feedback with authors `_
+
+   Returns a tuple of integers that identify SDL_ttf's version.
+   SDL_ttf is the underlying font rendering library, written in C,
+   on which pygame's font module depends. If 'linked' is True (the default), 
+   the function returns the version of the linked TTF library. 
+   Otherwise this function returns the version of TTF pygame was compiled with
+
+   .. versionadded:: 2.1.3
+
+   .. ## pygame.font.get_sdl_ttf_version ##
+
+.. function:: get_fonts
+
+   | :sl:`get all available fonts`
+   | :sg:`get_fonts() -> list of strings`
+
+   Returns a list of all the fonts available on the system. The names of the
+   fonts will be set to lowercase with all spaces and punctuation removed. This
+   works on most systems, but some will return an empty list if they cannot
+   find fonts.
+
+   .. versionchanged:: 2.1.3 Checks through user fonts instead of just global fonts for Windows.
+
+   .. ## pygame.font.get_fonts ##
+
+.. function:: match_font
+
+   | :sl:`find a specific font on the system`
+   | :sg:`match_font(name, bold=False, italic=False) -> path`
+
+   Returns the full path to a font file on the system. If bold or italic are
+   set to true, this will attempt to find the correct family of font.
+
+   The font name can also be an iterable of font names, a string of
+   comma-separated font names, or a bytes of comma-separated font names, in
+   which case the set of names will be searched in order.
+   If none of the given names are found, None is returned.
+
+   .. versionadded:: 2.0.1 Accept an iterable of font names.
+
+   .. versionchanged:: 2.1.3 Checks through user fonts instead of just global fonts for Windows.
+
+   Example:
+
+   ::
+
+       print pygame.font.match_font('bitstreamverasans')
+       # output is: /usr/share/fonts/truetype/ttf-bitstream-vera/Vera.ttf
+       # (but only if you have Vera on your system)
+
+   .. ## pygame.font.match_font ##
 
 .. function:: SysFont
 
-   | :sl:`Create a Font object from the system fonts.`
+   | :sl:`create a Font object from the system fonts`
    | :sg:`SysFont(name, size, bold=False, italic=False) -> Font`
 
    Return a new Font object that is loaded from the system fonts. The font will
@@ -93,7 +153,7 @@ solves no longer exists, it will likely be removed in the future.
    comma-separated font names, or a bytes of comma-separated font names, in
    which case the set of names will be searched in order.
 
-   .. versionaddedold:: 2.0.1 Accept an iterable of font names.
+   .. versionadded:: 2.0.1 Accept an iterable of font names.
 
    .. versionchanged:: 2.1.3 Checks through user fonts instead of just global fonts for Windows.
 
@@ -101,9 +161,9 @@ solves no longer exists, it will likely be removed in the future.
 
 .. class:: Font
 
-   | :sl:`Create a new Font object from a file.`
-   | :sg:`Font(filename=None, size=20) -> Font`
-   | :sg:`Font(filename, size) -> Font`
+   | :sl:`create a new Font object from a file`
+   | :sg:`Font(file_path=None, size=12) -> Font`
+   | :sg:`Font(file_path, size) -> Font`
    | :sg:`Font(pathlib.Path, size) -> Font`
    | :sg:`Font(object, size) -> Font`
 
@@ -111,18 +171,13 @@ solves no longer exists, it will likely be removed in the future.
    the height of the font in pixels. If the filename is ``None`` the pygame
    default font will be loaded. If a font cannot be loaded from the arguments
    given an exception will be raised. Once the font is created the size cannot
-   be changed.
+   be changed. If no arguments are given then the default font will be used and
+   a font size of 12 is used.
 
    Font objects are mainly used to render text into new Surface objects. The
    render can emulate bold or italic features, but it is better to load from a
    font with actual italic or bold glyphs.
 
-   .. versionchanged:: 2.1.4 If no arguments are given then the default font will be used and
-      a font size of 20 is used.
-
-   .. versionchanged:: 2.1.4 This class is also available through the ``pygame.Font``
-      alias.
-
    .. attribute:: bold
 
       | :sl:`Gets or sets whether the font should be rendered in (faked) bold.`
@@ -137,38 +192,10 @@ solves no longer exists, it will likely be removed in the future.
       normal. This can be mixed with the italic, underline and
       strikethrough modes.
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Font.bold ##
 
-   .. attribute:: name
-
-      | :sl:`Gets the font's name.`
-      | :sg:`name -> str`
-
-      Read only. Returns the font's name.
-
-      .. versionadded:: 2.2
-
-      .. ## Font.name ##
-
-   .. attribute:: style_name
-
-      | :sl:`Gets the font's style_name.`
-      | :sg:`style_name -> str`
-
-      Read only. Returns the font's style name. Style names are arbitrary, can be an empty string.
-      Here are some examples:
-
-        'Black', 'Bold', 'Bold Italic', 'BoldOblique', 'Book', 'BookOblique', 'Condensed', 'Condensed Oblique',
-        'ExtraLight', 'Italic', 'Light', 'LightOblique', 'Medium', 'MediumOblique', 'Oblique', 'Regular',
-        'Semibold', 'Semilight', 'Slanted'
-
-
-      .. versionadded:: 2.3.1
-
-      .. ## Font.style_name ##
-
    .. attribute:: italic
 
       | :sl:`Gets or sets whether the font should be rendered in (faked) italics.`
@@ -183,7 +210,7 @@ solves no longer exists, it will likely be removed in the future.
       than when normal. This can be mixed with the bold, underline and
       strikethrough modes.
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Font.italic ##
 
@@ -199,10 +226,10 @@ solves no longer exists, it will likely be removed in the future.
       of font size. This can be mixed with the bold, italic and
       strikethrough modes.
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Font.underline ##
-
+   
    .. attribute:: strikethrough
 
       | :sl:`Gets or sets whether the font should be rendered with a strikethrough.`
@@ -219,82 +246,17 @@ solves no longer exists, it will likely be removed in the future.
 
       .. ## Font.strikethrough ##
 
-   .. attribute:: align
-
-      | :sl:`Gets or sets how rendered text is aligned when given a wrap length.`
-      | :sg:`align -> int`
-
-      Can be set to `pygame.FONT_LEFT`, `pygame.FONT_RIGHT`, or
-      `pygame.FONT_CENTER`. This controls the text alignment behavior for the
-      font. Defaults to `pygame.FONT_LEFT`.
-
-      Requires pygame built with SDL_ttf 2.20.0, as all official pygame
-      distributions are.
-
-      .. versionadded:: 2.1.4
-
-      .. ## Font.align ##
-
-   .. attribute:: point_size
-
-      | :sl:`Gets or sets the font's point size.`
-      | :sg:`point_size -> int`
-
-      Returns the point size of the font. Will not be accurate upon initializing
-      the font object when the font name is initialized as ``None``.
-
-      .. versionadded:: 2.3.1
-
-      .. ## Font.point_size ##
-
-
-   .. attribute:: outline
-
-      | :sl:`Gets or sets the font's outline thickness (pixels).`
-      | :sg:`outline -> int`
-
-      The outline value of the font.
-
-      When set to 0, the font will be drawn normally. When positive,
-      the text will be drawn as a hollow outline. The outline grows in all
-      directions a number of pixels equal to the value set. Negative values
-      are not allowed.
-
-      This can be drawn underneath unoutlined text to create a text outline
-      effect. For example: ::
-
-          def render_outlined(
-              font: pygame.Font,
-              text: str,
-              text_color: pygame.typing.ColorLike,
-              outline_color: pygame.typing.ColorLike,
-              outline_width: int,
-          ) -> pygame.Surface:
-              old_outline = font.outline
-              if old_outline != 0:
-                  font.outline = 0
-              base_text_surf = font.render(text, True, text_color)
-              font.outline = outline_width
-              outlined_text_surf = font.render(text, True, outline_color)
-
-              outlined_text_surf.blit(base_text_surf, (outline_width, outline_width))
-              font.outline = old_outline
-              return outlined_text_surf
-
-      .. versionadded:: 2.5.7
-
-      .. ## Font.outline ##
-
    .. method:: render
 
-      | :sl:`Draw text on a new Surface.`
-      | :sg:`render(text, antialias, color, bgcolor=None, wraplength=0) -> Surface`
+      | :sl:`draw text on a new Surface`
+      | :sg:`render(text, antialias, color, background=None) -> Surface`
 
-      This creates a new Surface with the specified text rendered on it.
+      This creates a new Surface with the specified text rendered on it. 
       :mod:`pygame.font` provides no way to directly draw text on an existing
       Surface: instead you must use :func:`Font.render` to create an image
       (Surface) of the text, then blit this image onto another Surface.
 
+      The text can only be a single line: newline characters are not rendered.
       Null characters ('\x00') raise a TypeError. Both Unicode and char (byte)
       strings are accepted. For Unicode strings only UCS-2 characters
       ('\\u0001' to '\\uFFFF') were previously supported and any greater
@@ -302,13 +264,9 @@ solves no longer exists, it will likely be removed in the future.
       UCS-4 range are supported. For char strings a ``LATIN1`` encoding is
       assumed. The antialias argument is a boolean: if True the characters
       will have smooth edges. The color argument is the color of the text
-      [e.g.: (0,0,255) for blue]. The optional bgcolor argument is a color
-      to use for the text background. If bgcolor is ``None`` the area outside
-      the text will be transparent.
-
-      The `wraplength` argument describes the width (in pixels) a line of text
-      should be before wrapping to a new line. See
-      :attr:`pygame.font.Font.align` for line-alignment settings.
+      [e.g.: (0,0,255) for blue]. The optional background argument is a color
+      to use for the text background. If no background is passed the area
+      outside the text will be transparent.
 
       The Surface returned will be of the dimensions required to hold the text.
       (the same as those returned by :func:`Font.size`). If an empty string is passed
@@ -329,60 +287,212 @@ solves no longer exists, it will likely be removed in the future.
       cause the resulting image to maintain transparency information by
       colorkey rather than (much less efficient) alpha values.
 
+      If you render '\\n' an unknown char will be rendered. Usually a
+      rectangle. Instead you need to handle newlines yourself.
+
       Font rendering is not thread safe: only a single thread can render text
       at any time.
 
-      .. versionchangedold:: 2.0.3 Rendering UCS4 unicode works and does not
+      .. versionchanged:: 2.0.3 Rendering UCS4 unicode works and does not
         raise an exception. Use `if hasattr(pygame.font, "UCS4"):` to see if
         pygame supports rendering UCS4 unicode including more languages and
         emoji.
 
-      .. versionchanged:: 2.1.4 newline characters now will break text into
-         multiple lines.
-
-      .. versionadded:: 2.1.4 wraplength parameter
-
-      .. versionchanged:: 2.3.0 now supports keyword arguments.
-
       .. ## Font.render ##
 
-   .. autopgmethod:: size
+   .. method:: size
 
-   .. autopgmethod:: set_underline
+      | :sl:`determine the amount of space needed to render text`
+      | :sg:`size(text) -> (width, height)`
 
-   .. autopgmethod:: get_underline
+      Returns the dimensions needed to render the text. This can be used to
+      help determine the positioning needed for text before it is rendered. It
+      can also be used for word wrapping and other layout effects.
 
-   .. autopgmethod:: set_strikethrough
+      Be aware that most fonts use kerning which adjusts the widths for
+      specific letter pairs. For example, the width for "ae" will not always
+      match the width for "a" + "e".
 
-   .. autopgmethod:: get_strikethrough
+      .. ## Font.size ##
 
-   .. autopgmethod:: set_bold
+   .. method:: set_underline
 
-   .. autopgmethod:: get_bold
+      | :sl:`control if text is rendered with an underline`
+      | :sg:`set_underline(bool) -> None`
 
-   .. autopgmethod:: set_italic
+      When enabled, all rendered fonts will include an underline. The underline
+      is always one pixel thick, regardless of font size. This can be mixed
+      with the bold, italic and strikethrough modes.
 
-   .. autopgmethod:: metrics
+      .. note:: This is the same as the :attr:`underline` attribute.
 
-   .. autopgmethod:: get_italic
+      .. ## Font.set_underline ##
 
-   .. autopgmethod:: get_linesize
+   .. method:: get_underline
 
-   .. autopgmethod:: set_linesize
+      | :sl:`check if text will be rendered with an underline`
+      | :sg:`get_underline() -> bool`
 
-   .. autopgmethod:: get_height
+      Return True when the font underline is enabled.
 
-   .. autopgmethod:: set_point_size
+       .. note:: This is the same as the :attr:`underline` attribute.
 
-   .. autopgmethod:: get_point_size
+      .. ## Font.get_underline ##
+   
+   .. method:: set_strikethrough
 
-   .. autopgmethod:: get_ascent
+      | :sl:`control if text is rendered with a strikethrough`
+      | :sg:`set_strikethrough(bool) -> None`
 
-   .. autopgmethod:: get_descent
+      When enabled, all rendered fonts will include a strikethrough. The
+      strikethrough is always one pixel thick, regardless of font size.
+      This can be mixed with the bold, italic and underline modes.
 
-   .. autopgmethod:: set_script
+      .. note:: This is the same as the :attr:`strikethrough` attribute.
+      
+      .. versionadded:: 2.1.3
 
-   .. autopgmethod:: set_direction
+      .. ## Font.set_strikethrough ##
+
+   .. method:: get_strikethrough
+
+      | :sl:`check if text will be rendered with a strikethrough`
+      | :sg:`get_strikethrough() -> bool`
+
+      Return True when the font strikethrough is enabled.
+
+       .. note:: This is the same as the :attr:`strikethrough` attribute.
+       
+       .. versionadded:: 2.1.3
+
+      .. ## Font.get_strikethrough ##
+
+   .. method:: set_bold
+
+      | :sl:`enable fake rendering of bold text`
+      | :sg:`set_bold(bool) -> None`
+
+      Enables the bold rendering of text. This is a fake stretching of the font
+      that doesn't look good on many font types. If possible load the font from
+      a real bold font file. While bold, the font will have a different width
+      than when normal. This can be mixed with the italic, underline and
+      strikethrough modes.
+
+      .. note:: This is the same as the :attr:`bold` attribute.
+
+      .. ## Font.set_bold ##
+
+   .. method:: get_bold
+
+      | :sl:`check if text will be rendered bold`
+      | :sg:`get_bold() -> bool`
+
+      Return True when the font bold rendering mode is enabled.
+
+      .. note:: This is the same as the :attr:`bold` attribute.
+
+      .. ## Font.get_bold ##
+
+   .. method:: set_italic
+
+      | :sl:`enable fake rendering of italic text`
+      | :sg:`set_italic(bool) -> None`
+
+      Enables fake rendering of italic text. This is a fake skewing of the font
+      that doesn't look good on many font types. If possible load the font from
+      a real italic font file. While italic the font will have a different
+      width than when normal. This can be mixed with the bold, underline and
+      strikethrough modes.
+
+      .. note:: This is the same as the :attr:`italic` attribute.
+
+      .. ## Font.set_italic ##
+
+   .. method:: metrics
+
+      | :sl:`gets the metrics for each character in the passed string`
+      | :sg:`metrics(text) -> list`
+
+      The list contains tuples for each character, which contain the minimum
+      ``X`` offset, the maximum ``X`` offset, the minimum ``Y`` offset, the
+      maximum ``Y`` offset and the advance offset (bearing plus width) of the
+      character. [(minx, maxx, miny, maxy, advance), (minx, maxx, miny, maxy,
+      advance), ...]. None is entered in the list for each unrecognized
+      character.
+
+      .. ## Font.metrics ##
+
+   .. method:: get_italic
+
+      | :sl:`check if the text will be rendered italic`
+      | :sg:`get_italic() -> bool`
+
+      Return True when the font italic rendering mode is enabled.
+
+      .. note:: This is the same as the :attr:`italic` attribute.
+
+      .. ## Font.get_italic ##
+
+   .. method:: get_linesize
+
+      | :sl:`get the line space of the font text`
+      | :sg:`get_linesize() -> int`
+
+      Return the height in pixels for a line of text with the font. When
+      rendering multiple lines of text this is the recommended amount of space
+      between lines.
+
+      .. ## Font.get_linesize ##
+
+   .. method:: get_height
+
+      | :sl:`get the height of the font`
+      | :sg:`get_height() -> int`
+
+      Return the height in pixels of the actual rendered text. This is the
+      average size for each glyph in the font.
+
+      .. ## Font.get_height ##
+
+   .. method:: get_ascent
+
+      | :sl:`get the ascent of the font`
+      | :sg:`get_ascent() -> int`
+
+      Return the height in pixels for the font ascent. The ascent is the number
+      of pixels from the font baseline to the top of the font.
+
+      .. ## Font.get_ascent ##
+
+   .. method:: get_descent
+
+      | :sl:`get the descent of the font`
+      | :sg:`get_descent() -> int`
+
+      Return the height in pixels for the font descent. The descent is the
+      number of pixels from the font baseline to the bottom of the font.
+
+      .. ## Font.get_descent ##
+
+   .. method:: set_script
+
+      | :sl:`set the script code for text shaping`
+      | :sg:`set_script(str) -> None`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave feedback with authors `_
+
+      Sets the script used by harfbuzz text shaping, taking a 4 character
+      script code as input. For example, Hindi is written in the Devanagari
+      script, for which the script code is `"Deva"`. See the full list of
+      script codes in `ISO 15924 `_.
+
+      This method requires pygame built with SDL_ttf 2.20.0 or above. Otherwise the
+      method will raise a pygame.error.
+
+      .. versionadded:: 2.2.0
+
+      .. ## Font.set_script ## 
 
    .. ## pygame.font.Font ##
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/freetype.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/freetype.rst.txt
index 0f20f6e..0f282ac 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/freetype.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/freetype.rst.txt
@@ -4,22 +4,18 @@
 ======================
 
 .. module:: pygame.freetype
-   :synopsis: pygame module for loading and rendering computer fonts
+   :synopsis: Enhanced pygame module for loading and rendering computer fonts
 
-| :sl:`pygame module for loading and rendering computer fonts`
+| :sl:`Enhanced pygame module for loading and rendering computer fonts`
 
-The ``pygame.freetype`` module is an alternative to :mod:`pygame.font`.
-It is implemented directly on the FreeType 2 library, and is not
-backward compatible with :mod:`pygame.font`. :mod:`pygame.font`
-relies on the SDL_ttf library, and due to the SDL_ttf team's efforts,
-``pygame.font`` is now the better supported of our font modules.
-In new code, the use of :mod:`pygame.font` is encouraged.
-``pygame.font``, unlike ``pygame.freetype``, has support for multiline text,
-text shaping for global writing systems, and rendering emoji with color.
-
-The ``pygame.ftfont`` module exists as a limited version of
-the :mod:`pygame.font` API, running on top of ``pygame.freetype``.
-Many of the recently added font features do not work on it.
+The ``pygame.freetype`` module is a replacement for :mod:`pygame.font`.
+It has all of the functionality of the original, plus many new features.
+Yet is has absolutely no dependencies on the SDL_ttf library.
+It is implemented directly on the FreeType 2 library.
+The ``pygame.freetype`` module is not itself backward compatible with
+:mod:`pygame.font`.
+Instead, use the ``pygame.ftfont`` module as a drop-in replacement
+for :mod:`pygame.font`.
 
 All font file formats supported by FreeType can be rendered by
 ``pygame.freetype``, namely ``TTF``, Type1, ``CFF``, OpenType,
@@ -63,7 +59,7 @@ loaded. This module must be imported explicitly to be used. ::
    import pygame
    import pygame.freetype
 
-.. versionaddedold:: 1.9.2 :mod:`freetype`
+.. versionadded:: 1.9.2 :mod:`freetype`
 
 
 .. function:: get_error
@@ -88,7 +84,7 @@ loaded. This module must be imported explicitly to be used. ::
    It will not compile with the original FreeType 1.0. Hence, the first element
    of the tuple will always be "2".
 
-   .. versionchanged:: 2.1.4 ``linked`` keyword argument added and default behavior changed from returning compiled version to returning linked version
+   .. versionchanged:: 2.2.0 ``linked`` keyword argument added and default behavior changed from returning compiled version to returning linked version
 
 .. function:: init
 
@@ -127,7 +123,7 @@ loaded. This module must be imported explicitly to be used. ::
 
    Returns ``True`` if the ``pygame.freetype`` module is currently initialized.
 
-   .. versionaddedold:: 1.9.5
+   .. versionadded:: 1.9.5
 
 .. function:: was_init
 
@@ -155,7 +151,7 @@ loaded. This module must be imported explicitly to be used. ::
 .. function:: set_default_resolution
 
    | :sl:`Set the default pixel size in dots per inch for the module`
-   | :sg:`set_default_resolution(resolution, /)`
+   | :sg:`set_default_resolution([resolution])`
 
    Set the default pixel size, in dots per inch, for the module. If the
    optional argument is omitted or zero the resolution is reset to 72 DPI.
@@ -175,7 +171,7 @@ loaded. This module must be imported explicitly to be used. ::
    comma-separated font names, or a bytes of comma-separated font names, in
    which case the set of names will be searched in order.
 
-   .. versionaddedold:: 2.0.1 Accept an iterable of font names.
+   .. versionadded:: 2.0.1 Accept an iterable of font names.
 
 .. function:: get_default_font
 
@@ -228,22 +224,6 @@ loaded. This module must be imported explicitly to be used. ::
       Read only. Returns the real (long) name of the font, as
       recorded in the font file.
 
-   .. attribute:: style_name
-
-      | :sl:`Gets the font's style_name.`
-      | :sg:`style_name -> str`
-
-      Read only. Returns the font's style name. Style names are arbitrary, can be an empty string.
-      Here are some examples:
-
-        'Black', 'Bold', 'Bold Italic', 'BoldOblique', 'Book', 'BookOblique', 'Condensed', 'Condensed Oblique',
-        'ExtraLight', 'Italic', 'Light', 'LightOblique', 'Medium', 'MediumOblique', 'Oblique', 'Regular',
-        'Semibold', 'Semilight', 'Slanted'
-
-      .. versionadded:: 2.3.1
-
-      .. ## Font.style_name ##
-
    .. attribute:: path
 
       | :sl:`Font file path`
@@ -358,7 +338,7 @@ loaded. This module must be imported explicitly to be used. ::
    .. method:: get_sized_ascender
 
       | :sl:`The scaled ascent of the font in pixels`
-      | :sg:`get_sized_ascender(size=0, /) -> int`
+      | :sg:`get_sized_ascender(=0) -> int`
 
       Return the number of units from the font's baseline to the top of the
       bounding box. It is not adjusted for strong or rotation.
@@ -366,15 +346,15 @@ loaded. This module must be imported explicitly to be used. ::
    .. method:: get_sized_descender
 
       | :sl:`The scaled descent of the font in pixels`
-      | :sg:`get_sized_descender(size=0, /) -> int`
+      | :sg:`get_sized_descender(=0) -> int`
 
-      Return the number of pixels from the font's baseline to the bottom of the
+      Return the number of pixels from the font's baseline to the top of the
       bounding box. It is not adjusted for strong or rotation.
 
    .. method:: get_sized_height
 
       | :sl:`The scaled height of the font in pixels`
-      | :sg:`get_sized_height(size=0, /) -> int`
+      | :sg:`get_sized_height(=0) -> int`
 
       Returns the height of the font. This is the average value of all
       glyphs in the font. It is not adjusted for strong or rotation.
@@ -382,7 +362,7 @@ loaded. This module must be imported explicitly to be used. ::
    .. method:: get_sized_glyph_height
 
       | :sl:`The scaled bounding box height of the font in pixels`
-      | :sg:`get_sized_glyph_height(size=0, /) -> int`
+      | :sg:`get_sized_glyph_height(=0) -> int`
 
       Return the glyph bounding box height of the font in pixels.
       This is the average value of all glyphs in the font.
@@ -743,7 +723,7 @@ loaded. This module must be imported explicitly to be used. ::
       unset and text will render with a transparent background by default.
       Applies to :meth:`render` and :meth:`render_to`.
 
-   .. versionaddedold:: 2.0.0
+   .. versionadded:: 2.0.0
 
    .. attribute:: origin
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/geometry.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/geometry.rst.txt
deleted file mode 100644
index 53b713f..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/geometry.rst.txt
+++ /dev/null
@@ -1,769 +0,0 @@
-.. include:: common.txt
-
-:mod:`pygame.geometry`
-======================
-
-.. module:: pygame.geometry
-   :synopsis: pygame geometry module
-
-   .. warning::
-      **Experimental Module**
-
-      **This module is a work in progress. Refrain from relying on any features provided by
-      this module, as they are subject to change or removal without prior notice.**
-
-   .. versionadded:: 2.4.0
-
-   | :sl:`pygame module for the Circle, Line, and Polygon objects`
-
-.. currentmodule:: pygame
-
-.. class:: Circle
-
-   | :sl:`pygame object for representing a circle`
-   | :sg:`Circle((x, y), radius) -> Circle`
-   | :sg:`Circle(x, y, radius) -> Circle`
-
-   The `Circle` class provides many useful methods for collision testing, transformation and intersection.
-   A `Circle` can be created from a combination of a pair of coordinates that represent
-   the center of the circle and a radius. Circles can also be created from python objects that
-   are already a `Circle` (effectively copying the circle) or have an attribute named "circle".
-
-   Specifically, to construct a circle you can pass the x, y, and radius values as separate
-   arguments or inside a sequence(list or tuple).
-
-   Functions that require a `Circle` argument may also accept these values as Circles:
-
-   ::
-
-      ((x, y), radius)
-      (x, y, radius)
-      (vector2, radius)
-
-   The `Circle` class only stores the x, y and r attributes, everything else is calculated
-   on the fly based on them.
-
-   **Circle Attributes**
-
-   ----
-
-   .. attribute:: x
-
-         | :sl:`center x coordinate of the circle`
-         | :sg:`x -> float`
-
-         The horizontal coordinate of the center of the circle. Reassigning it moves the circle.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.x ##
-
-   .. attribute:: y
-
-         | :sl:`center y coordinate of the circle`
-         | :sg:`y -> float`
-
-         The vertical coordinate of the center of the circle. Reassigning it moves the circle.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.y ##
-
-   .. attribute:: r
-
-         | :sl:`radius of the circle`
-         | :sg:`r -> float`
-
-         Represents the size of the circle. It can't be negative. Reassigning it scales the circle.
-
-         .. versionadded:: 2.4.0
-
-         .. versionchanged:: 2.5.1 It is now allowed to create degenerate circles with :math:`r = 0`.
-
-         .. ## Circle.r ##
-
-   .. attribute:: r_sqr
-
-         | :sl:`radius of the circle squared`
-         | :sg:`r_sqr -> float`
-
-         It's equivalent to :math:`r^2`. It can't be negative. Reassigning it changes the radius to :math:`r = \sqrt{r_{sqr}}`.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.r_sqr ##
-
-   .. attribute:: center
-
-         | :sl:`x and y coordinates of the center of the circle`
-         | :sg:`center -> (float, float)`
-
-         A tuple containing the circle's `x` and `y` coordinates representing its center.
-         Reassigning it moves the circle to the new position.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.center ##
-
-   .. attribute:: diameter
-
-         | :sl:`diameter of the circle`
-         | :sg:`diameter -> float`
-
-         It's equivalent to :math:`2 \cdot r`. It can't be negative. Reassigning it
-         changes the radius to :math:`r = \frac{d}{2}`.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.diameter ##
-
-   .. attribute:: area
-
-         | :sl:`area of the circle`
-         | :sg:`area -> float`
-
-         It's equivalent to :math:`\pi \cdot r^2`. It can't be negative. Reassigning it
-         changes the radius to :math:`r = \sqrt{\frac{area}{\pi}}` producing a circle with matching area.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.area ##
-
-   .. attribute:: circumference
-
-         | :sl:`circumference of the circle`
-         | :sg:`circumference -> float`
-
-         It's equivalent to :math:`2 \cdot \pi \cdot r`. It can't be negative. Reassigning it
-         changes the radius to :math:`r = \frac{circumference}{2\pi}` producing a circle with
-         matching circumference.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.circumference ##
-
-   .. attribute:: top
-
-         | :sl:`top coordinate of the circle`
-         | :sg:`top -> (float, float)`
-
-         A tuple containing the `x` and `y` coordinates that represent the top
-         of the circle.
-         Reassigning it moves the circle to the new position. The radius will not be affected.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Circle.top ##
-
-   .. attribute:: bottom
-
-         | :sl:`bottom coordinate of the circle`
-         | :sg:`bottom -> (float, float)`
-
-         A tuple containing the `x` and `y` coordinates that represent the bottom
-         of the circle.
-         Reassigning it moves the circle to the new position. The radius will not be affected.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Circle.bottom ##
-
-   .. attribute:: left
-
-         | :sl:`left coordinate of the circle`
-         | :sg:`left -> (float, float)`
-
-         A tuple containing the `x` and `y` coordinates that represent the left
-         of the circle.
-         Reassigning it moves the circle to the new position. The radius will not be affected.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Circle.left ##
-
-   .. attribute:: right
-
-         | :sl:`right coordinate of the circle`
-         | :sg:`right -> (float, float)`
-
-         A tuple containing the `x` and `y` coordinates that represent the right
-         of the circle.
-         Reassigning it moves the circle to the new position. The radius will not be affected.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Circle.right ##
-
-   **Circle Methods**
-
-   ----
-
-   .. method:: collidepoint
-
-         | :sl:`tests if a point is inside the circle`
-         | :sg:`collidepoint((x, y), /) -> bool`
-         | :sg:`collidepoint(x, y, /) -> bool`
-         | :sg:`collidepoint(vector2, /) -> bool`
-
-         Returns `True` if the given point is inside this `Circle` (edge included), `False` otherwise.
-         It takes a tuple of (x, y) coordinates, two separate x and y coordinates, or a `Vector2`
-         object as its argument.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.collidepoint ##
-
-   .. method:: collidecircle
-
-         | :sl:`tests if a circle collides with this circle`
-         | :sg:`collidecircle(circle, /) -> bool`
-         | :sg:`collidecircle(x, y, radius, /) -> bool`
-         | :sg:`collidecircle((x, y), radius, /) -> bool`
-         | :sg:`collidecircle(vector2, radius, /) -> bool`
-
-         Returns `True` if the given circle intersects with this `Circle`, `False` otherwise.
-         It takes either a `Circle` object, a tuple of (x, y) coordinates and a radius, or separate x and y
-         coordinates and a radius as its argument.
-
-         .. note::
-             Calling this method with this circle as the argument will always return `True`.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.collidecircle ##
-
-   .. method:: colliderect
-
-         | :sl:`tests if a rectangle collides with this circle`
-         | :sg:`colliderect(rect, /) -> bool`
-         | :sg:`colliderect((x, y, width, height), /) -> bool`
-         | :sg:`colliderect(x, y, width, height, /) -> bool`
-         | :sg:`colliderect((x, y), (width, height), /) -> bool`
-         | :sg:`colliderect(vector2, (width, height), /) -> bool`
-
-         Returns `True` if the given rectangle intersects with this `Circle`, `False` otherwise.
-         Takes either a `Rect` object, a tuple of (x, y, width, height) coordinates, or separate
-         x, y coordinates and width, height as its argument.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.colliderect ##
-
-   .. method:: collideswith
-
-         | :sl:`tests if a shape or point collides with this circle`
-         | :sg:`collideswith(circle, /) -> bool`
-         | :sg:`collideswith(rect, /) -> bool`
-         | :sg:`collideswith((x, y), /) -> bool`
-         | :sg:`collideswith(vector2, /) -> bool`
-
-         Returns `True` if the given shape or point intersects with this `Circle`, `False` otherwise.
-         The shape can be a `Circle`, `Rect`, `FRect`.
-
-         .. note::
-             The shape argument must be an actual shape object (`Circle`, `Rect`, or `FRect`).
-             You can't pass a tuple or list of coordinates representing the shape (except for a point),
-             because the shape type can't be determined from the coordinates alone.
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.collideswith ##
-
-   .. method:: collidelist
-
-         | :sl:`test if a list of objects collide with the circle`
-         | :sg:`collidelist(colliders) -> int`
-
-         The `collidelist` method tests whether a given list of shapes or points collides
-         (overlaps) with this `Circle` object. The function takes in a single argument, which
-         must be a list of `Circle`, `Rect`, `FRect`, or a point. The function returns the index
-         of the first shape or point in the list that collides with the `Circle` object, or
-         -1 if there is no collision.
-
-         .. note::
-             The shapes must be actual shape objects, such as `Circle`, `Rect` or `FRect`
-             instances. It is not possible to pass a tuple or list of coordinates representing
-             the shape as an argument (except for a point), because the shape type can't be
-             determined from the coordinates alone.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Circle.collidelist ##
-
-   .. method:: collidelistall
-
-         | :sl:`test if all objects in a list collide with the circle`
-         | :sg:`collidelistall(colliders) -> list`
-
-         The `collidelistall` method tests whether a given list of shapes or points collides
-         (overlaps) with this `Circle` object. The function takes in a single argument, which
-         must be a list of `Circle`, `Rect`, `FRect`, or a point. The function returns a list
-         containing the indices of all the shapes or points in the list that collide with
-         the `Circle` object, or an empty list if there is no collision.
-
-         .. note::
-             The shapes must be actual shape objects, such as `Circle`, `Rect` or `FRect`
-             instances. It is not possible to pass a tuple or list of coordinates representing
-             the shape as an argument (except for a point), because the shape type can't be
-             determined from the coordinates alone.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Circle.collidelistall ##
-
-   .. method:: contains
-
-         | :sl:`tests if a shape or point is inside the circle`
-         | :sg:`contains(circle, /) -> bool`
-         | :sg:`contains(rect, /) -> bool`
-         | :sg:`contains((x, y), /) -> bool`
-         | :sg:`contains(vector2, /) -> bool`
-
-         Returns `True` if the shape or point is completely contained within this `Circle`, `False` otherwise.
-         The shape can be a `Circle`, `Rect`, `FRect`.
-
-         .. note::
-             The shape argument must be an actual shape object (`Circle`, `Rect`, or `FRect`).
-             You can't pass a tuple or list of coordinates representing the shape (except for a point),
-             because the shape type can't be determined from the coordinates alone.
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.contains ##
-
-   .. method:: move
-
-         | :sl:`moves the circle by a given amount`
-         | :sg:`move((x, y), /) -> Circle`
-         | :sg:`move(x, y, /) -> Circle`
-         | :sg:`move(vector2, /) -> Circle`
-
-         Returns a copy of this `Circle` moved by the given amounts.
-         Takes either a tuple of (x, y) coordinates, two separate x and y coordinates,
-         or a `Vector2` object as its argument.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             Circle((circle.x + x, circle.y + y), circle.r)
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.move ##
-
-   .. method:: move_ip
-
-         | :sl:`moves the circle by a given amount, in place`
-         | :sg:`move_ip((x, y), /) -> None`
-         | :sg:`move_ip(x, y, /) -> None`
-         | :sg:`move_ip(vector2, /) -> None`
-
-         Moves this `Circle` in place by the given amounts.
-         Takes the same types of arguments as :meth:`move` and it always returns `None`.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             circle.x += x
-             circle.y += y
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.move_ip ##
-
-   .. method:: intersect
-
-         | :sl:`finds intersections between the circle and a shape`
-         | :sg:`intersect(circle, /) -> list`
-
-        Finds and returns a list of intersection points between the circle and another shape.
-        The other shape must be a `Circle` object.
-        If the circle does not intersect or has infinite intersections, an empty list is returned.
-
-        .. note::
-            The shape argument must be an instance of the `Circle` class.
-            Passing a tuple or list of coordinates representing the shape is not supported,
-            as the type of shape cannot be determined from coordinates alone.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Circle.intersect ##
-
-   .. method:: update
-
-         | :sl:`updates the circle position and radius`
-         | :sg:`update((x, y), radius, /) -> None`
-         | :sg:`update(x, y, radius, /) -> None`
-         | :sg:`update(vector2, radius, /) -> None`
-
-         Sets the position and radius of this `Circle` to the provided values.
-         It always returns `None`.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             circle.x = x
-             circle.y = y
-             circle.r = radius
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.update ##
-
-   .. method:: rotate
-
-         | :sl:`rotates the circle`
-         | :sg:`rotate(angle, rotation_point=Circle.center, /) -> Circle`
-         | :sg:`rotate(angle, /) -> Circle`
-
-         Returns a copy of this `Circle` rotated by the specified angle (in degrees) around a point.
-         Positive angles rotate the circle clockwise, counter-clockwise otherwise.
-         The rotation point is optional and defaults to the circle's center.
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.rotate ##
-
-   .. method:: rotate_ip
-
-         | :sl:`rotates the circle in place`
-         | :sg:`rotate_ip(angle, rotation_point=Circle.center, /) -> None`
-         | :sg:`rotate_ip(angle, /) -> None`
-
-         Rotates the circle by a specified angle (in degrees) around a point.
-         Positive angles rotate the circle clockwise, counter-clockwise otherwise.
-         The rotation point is optional and defaults to the circle's center.
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.rotate_ip ##
-
-   .. method:: as_rect
-
-         | :sl:`returns the smallest Rect containing the circle`
-         | :sg:`as_rect() -> Rect`
-
-         Returns the smallest `pygame.Rect` object containing this `Circle`.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             Rect(circle.x - circle.r, circle.y - circle.r, circle.r * 2, circle.r * 2)
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.as_rect ##
-
-   .. method:: as_frect
-
-         | :sl:`returns the smallest FRect containing the circle`
-         | :sg:`as_frect() -> FRect`
-
-         Returns the smallest `pygame.FRect` object containing this `Circle`.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             FRect(circle.x - circle.r, circle.y - circle.r, circle.r * 2, circle.r * 2)
-
-         .. versionadded:: 2.5.0
-
-         .. ## Circle.as_frect ##
-
-   .. method:: copy
-
-         | :sl:`copies the circle`
-         | :sg:`copy() -> Circle`
-
-         Returns a copy of this `Circle`.
-
-         .. versionadded:: 2.4.0
-
-         .. ## Circle.copy ##
-
-   .. ## pygame.Circle ##
-
-
-.. class:: Line
-
-   | :sl:`pygame object for representing a line`
-   | :sg:`Line((ax, ay), (bx, by)) -> Line`
-   | :sg:`Line(ax, ay, bx, by) -> Line`
-
-   .. versionadded:: 2.5.2
-
-   The `Line` class provides many useful methods for collision testing, transformation and intersection.
-   A `Line` can be created from a combination of two pairs of coordinates that represent the start and end points.
-   Lines can also be created from python objects that are already a `Line` (effectively copying the line) or have an attribute named "line".
-
-   Specifically, to construct a `Line` you can pass the ax, ay, bx, and by values as separate
-   arguments or inside a sequence(list or tuple).
-
-   As a special case you can also pass in `pygame.Rect` / `pygame.FRect`, in which case the
-   line will be created with (x, y, width, height) as the start and end points.
-
-   You can create lines with the same start and end points, but beware that some methods may
-   not work as expected or error out.
-
-   Functions that require a `Line` argument may also accept these values as Lines:
-
-   ::
-
-      ((ax, ay), (bx, by))
-      (ax, ay, bx, by)
-      (vector2, vector2)
-
-   The `Line` class only stores the ax, ay, bx, and by attributes, everything else is calculated
-   on the fly based on them.
-
-   **Line Attributes**
-
-   ----
-
-   .. attribute:: ax
-
-         | :sl:`x coordinate of the start point of the line`
-         | :sg:`ax -> float`
-
-         The horizontal coordinate of the start point of the line. Reassigning it moves the line.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Line.ax ##
-
-   .. attribute:: ay
-
-         | :sl:`y coordinate of the start point of the line`
-         | :sg:`ay -> float`
-
-         The vertical coordinate of the start point of the line. Reassigning it moves the line.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Line.ay ##
-
-   .. attribute:: bx
-
-         | :sl:`x coordinate of the end point of the line`
-         | :sg:`bx -> float`
-
-         The horizontal coordinate of the end point of the line. Reassigning it moves the line.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Line.bx ##
-
-   .. attribute:: by
-
-         | :sl:`y coordinate of the end point of the line`
-         | :sg:`by -> float`
-
-         The vertical coordinate of the end point of the line. Reassigning it moves the line.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Line.by ##
-
-   .. attribute:: a
-
-         | :sl:`the first point of the line`
-         | :sg:`a -> (float, float)`
-
-         A tuple containing the `ax` and `ay` attributes representing the line's first point.
-         It can be reassigned to move the `Line`. If reassigned the `ax` and `ay` attributes
-         will be changed to produce a `Line` with matching first point position.
-         The `bx` and `by` attributes will not be affected.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Line.a ##
-
-   .. attribute:: b
-
-         | :sl:`the second point of the line`
-         | :sg:`b -> (float, float)`
-
-         A tuple containing `bx` and `by` attributes representing the line's second point.
-         It can be reassigned to move the `Line`. If reassigned the `bx` and `by` attributes
-         will be changed to produce a `Line` with matching second point position.
-         The `ax` and `ay` attributes will not be affected.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Line.b ##
-
-   .. attribute:: length
-
-         | :sl:`the length of the line`
-         | :sg:`length -> float`
-
-         The length of the line. Calculated using the `sqrt((bx-ax)**2 + (by-ay)**2)` formula.
-         This attribute is read-only, it cannot be reassigned. To change the line's length
-         use the `scale` method or change its `a` or `b` attributes.
-
-         .. versionadded:: 2.5.3
-
-         .. ## Line.length ##
-
-   **Line Methods**
-
-   ----
-
-   .. method:: copy
-
-         | :sl:`copies the line`
-         | :sg:`copy() -> Line`
-
-         Returns a copy of this `Line`.
-
-         .. versionadded:: 2.5.2
-
-         .. ## Line.copy ##
-
-   .. method:: move
-
-         | :sl:`moves the line by a given amount`
-         | :sg:`move((x, y)) -> Line`
-         | :sg:`move(x, y) -> Line`
-
-         Returns a new `Line` that is moved by the given offset. The original `Line` is
-         not modified.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             Line(line.ax + x, line.ay + y, line.bx + x, line.by + y)
-
-         .. versionadded:: 2.5.3
-
-      .. ## Line.move ##
-
-   .. method:: move_ip
-
-         | :sl:`moves the line by a given amount`
-         | :sg:`move_ip((x, y)) -> None`
-         | :sg:`move_ip(x, y) -> None`
-
-         Moves the `Line` by the given offset. The original `Line` is modified. Always returns
-         `None`.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             line.ax += x
-             line.ay += y
-             line.bx += x
-             line.by += y
-
-         .. versionadded:: 2.5.3
-
-      .. ## Line.move_ip ##
-
-   .. method:: update
-
-         | :sl:`updates the line's attributes`
-         | :sg:`update((ax, ay), (bx, by)) -> None`
-         | :sg:`update(ax, ay, bx, by) -> None`
-         | :sg:`update(line) -> None`
-
-         Updates the `Line`'s attributes. The original `Line` is modified. Always returns `None`.
-
-         This method is equivalent to the following code:
-
-         .. code-block:: python
-
-             line.ax = ax
-             line.ay = ay
-             line.bx = bx
-             line.by = by
-
-         .. versionadded:: 2.5.3
-
-      .. ## Line.update ##
-
-   .. method:: scale
-
-         | :sl:`scales the line by the given factor from the given origin`
-         | :sg:`scale(factor, origin) -> Line`
-         | :sg:`scale(factor_and_origin) -> Line`
-
-         Returns a new `Line` which is scaled by the given factor from the specified origin with 0.0 being
-         the starting point, 0.5 being the center and 1.0 being the end point.
-         The original `Line` is not modified.
-
-         .. versionadded:: 2.5.3
-
-      .. ## Line.scale ##
-
-   .. method:: scale_ip
-
-         | :sl:`scales the line by the given factor from the given origin in place`
-         | :sg:`scale_ip(factor, origin) -> None`
-         | :sg:`scale_ip(factor_and_origin) -> None`
-
-         Scales the `Line` by the given factor from the specified origin with 0.0 being
-         the starting point, 0.5 being the center and 1.0 being the end point.
-         The original `Line` is modified.
-         Always returns `None`.
-
-         .. versionadded:: 2.5.3
-
-      .. ## Line.scale_ip ##
-
-   .. method:: flip_ab
-
-         | :sl:`flips the line a and b points`
-         | :sg:`flip_ab() -> Line`
-
-         Returns a new `Line` that has the `a` and `b` points flipped.
-         The original `Line` is not modified.
-
-         .. versionadded:: 2.5.3
-
-      .. ## Line.flip_ab ##
-
-   .. method:: flip_ab_ip
-
-         | :sl:`flips the line a and b points, in place`
-         | :sg:`flip_ab_ip() -> None`
-
-         Flips the `Line`'s `a` and `b` points. The original `Line` is modified.
-         Always returns `None`.
-
-         .. versionadded:: 2.5.3
-
-      .. ## Line.flip_ab_ip ##
-
-   .. method:: project
-
-         | :sl:`projects the line onto the given line`
-         | :sg:`project(point: tuple[float, float], clamp=False) -> tuple[float, float]`
-
-         This method takes in a point and one boolean keyword argument clamp. It outputs an orthogonally projected point onto the line.
-         If clamp is `True` it makes sure that the outputted point will be on the line segment (which might not be orthogonal), and if it is `False` (the default) then any point on the infinitely extended line may be outputted.
-         This method can be used to find the closest point on a line to the given point. The output is the unique point on the line or line segment that is the smallest distance away from the given point.
-
-
-         .. figure:: code_examples/project.png
-            :alt: project method image
-
-            Example of how it projects the point onto the line. The red point is the point we want to project and the blue point is what you would get as a result.
-
-
-         .. figure:: code_examples/project_clamp.png
-            :alt: project clamp argument image
-
-            Example of what the clamp argument changes. If it is `True`, the point is bounded between the line segment ends.
-
-            WARNING:  If the line has no length (i.e. the start and end points are the same) then the returned point of this function will be the same point as both ends of the line.
-
-         .. versionadded:: 2.5.6
-
-      .. ## Line.project ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/gfxdraw.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/gfxdraw.rst.txt
index 9886ec9..28153a3 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/gfxdraw.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/gfxdraw.rst.txt
@@ -54,13 +54,13 @@ For example:
    ``pygame.gfxdraw`` wraps the primitives from the library called SDL_gfx,
    rather than using modified versions.
 
-.. versionaddedold:: 1.9.0
+.. versionadded:: 1.9.0
 
 
 .. function:: pixel
 
    | :sl:`draw a pixel`
-   | :sg:`pixel(surface, x, y, color, /) -> None`
+   | :sg:`pixel(surface, x, y, color) -> None`
 
    Draws a single pixel, at position (x ,y), on the given surface.
 
@@ -79,7 +79,7 @@ For example:
 .. function:: hline
 
    | :sl:`draw a horizontal line`
-   | :sg:`hline(surface, x1, x2, y, color, /) -> None`
+   | :sg:`hline(surface, x1, x2, y, color) -> None`
 
    Draws a straight horizontal line (``(x1, y)`` to ``(x2, y)``) on the given
    surface. There are no endcaps.
@@ -100,7 +100,7 @@ For example:
 .. function:: vline
 
    | :sl:`draw a vertical line`
-   | :sg:`vline(surface, x, y1, y2, color, /) -> None`
+   | :sg:`vline(surface, x, y1, y2, color) -> None`
 
    Draws a straight vertical line (``(x, y1)`` to ``(x, y2)``) on the given
    surface. There are no endcaps.
@@ -121,7 +121,7 @@ For example:
 .. function:: line
 
    | :sl:`draw a line`
-   | :sg:`line(surface, x1, y1, x2, y2, color, /) -> None`
+   | :sg:`line(surface, x1, y1, x2, y2, color) -> None`
 
    Draws a straight line (``(x1, y1)`` to ``(x2, y2)``) on the given surface.
    There are no endcaps.
@@ -143,7 +143,7 @@ For example:
 .. function:: rectangle
 
    | :sl:`draw a rectangle`
-   | :sg:`rectangle(surface, rect, color, /) -> None`
+   | :sg:`rectangle(surface, rect, color) -> None`
 
    Draws an unfilled rectangle on the given surface. For a filled rectangle use
    :meth:`box`.
@@ -167,7 +167,7 @@ For example:
 .. function:: box
 
    | :sl:`draw a filled rectangle`
-   | :sg:`box(surface, rect, color, /) -> None`
+   | :sg:`box(surface, rect, color) -> None`
 
    Draws a filled rectangle on the given surface. For an unfilled rectangle use
    :meth:`rectangle`.
@@ -197,7 +197,7 @@ For example:
 .. function:: circle
 
    | :sl:`draw a circle`
-   | :sg:`circle(surface, x, y, r, color, /) -> None`
+   | :sg:`circle(surface, x, y, r, color) -> None`
 
    Draws an unfilled circle on the given surface. For a filled circle use
    :meth:`filled_circle`.
@@ -218,7 +218,7 @@ For example:
 .. function:: aacircle
 
    | :sl:`draw an antialiased circle`
-   | :sg:`aacircle(surface, x, y, r, color, /) -> None`
+   | :sg:`aacircle(surface, x, y, r, color) -> None`
 
    Draws an unfilled antialiased circle on the given surface.
 
@@ -238,7 +238,7 @@ For example:
 .. function:: filled_circle
 
    | :sl:`draw a filled circle`
-   | :sg:`filled_circle(surface, x, y, r, color, /) -> None`
+   | :sg:`filled_circle(surface, x, y, r, color) -> None`
 
    Draws a filled circle on the given surface. For an unfilled circle use
    :meth:`circle`.
@@ -259,7 +259,7 @@ For example:
 .. function:: ellipse
 
    | :sl:`draw an ellipse`
-   | :sg:`ellipse(surface, x, y, rx, ry, color, /) -> None`
+   | :sg:`ellipse(surface, x, y, rx, ry, color) -> None`
 
    Draws an unfilled ellipse on the given surface. For a filled ellipse use
    :meth:`filled_ellipse`.
@@ -281,7 +281,7 @@ For example:
 .. function:: aaellipse
 
    | :sl:`draw an antialiased ellipse`
-   | :sg:`aaellipse(surface, x, y, rx, ry, color, /) -> None`
+   | :sg:`aaellipse(surface, x, y, rx, ry, color) -> None`
 
    Draws an unfilled antialiased ellipse on the given surface.
 
@@ -302,7 +302,7 @@ For example:
 .. function:: filled_ellipse
 
    | :sl:`draw a filled ellipse`
-   | :sg:`filled_ellipse(surface, x, y, rx, ry, color, /) -> None`
+   | :sg:`filled_ellipse(surface, x, y, rx, ry, color) -> None`
 
    Draws a filled ellipse on the given surface. For an unfilled ellipse use
    :meth:`ellipse`.
@@ -324,7 +324,7 @@ For example:
 .. function:: arc
 
    | :sl:`draw an arc`
-   | :sg:`arc(surface, x, y, r, start_angle, stop_angle, color, /) -> None`
+   | :sg:`arc(surface, x, y, r, start_angle, stop_angle, color) -> None`
 
    Draws an arc on the given surface. For an arc with its endpoints connected
    to its center use :meth:`pie`.
@@ -356,7 +356,7 @@ For example:
 .. function:: pie
 
    | :sl:`draw a pie`
-   | :sg:`pie(surface, x, y, r, start_angle, stop_angle, color, /) -> None`
+   | :sg:`pie(surface, x, y, r, start_angle, stop_angle, color) -> None`
 
    Draws an unfilled pie on the given surface. A pie is an :meth:`arc` with its
    endpoints connected to its center.
@@ -385,7 +385,7 @@ For example:
 .. function:: trigon
 
    | :sl:`draw a trigon/triangle`
-   | :sg:`trigon(surface, x1, y1, x2, y2, x3, y3, color, /) -> None`
+   | :sg:`trigon(surface, x1, y1, x2, y2, x3, y3, color) -> None`
 
    Draws an unfilled trigon (triangle) on the given surface. For a filled
    trigon use :meth:`filled_trigon`.
@@ -412,7 +412,7 @@ For example:
 .. function:: aatrigon
 
    | :sl:`draw an antialiased trigon/triangle`
-   | :sg:`aatrigon(surface, x1, y1, x2, y2, x3, y3, color, /) -> None`
+   | :sg:`aatrigon(surface, x1, y1, x2, y2, x3, y3, color) -> None`
 
    Draws an unfilled antialiased trigon (triangle) on the given surface.
 
@@ -438,7 +438,7 @@ For example:
 .. function:: filled_trigon
 
    | :sl:`draw a filled trigon/triangle`
-   | :sg:`filled_trigon(surface, x1, y1, x2, y2, x3, y3, color, /) -> None`
+   | :sg:`filled_trigon(surface, x1, y1, x2, y2, x3, y3, color) -> None`
 
    Draws a filled trigon (triangle) on the given surface. For an unfilled
    trigon use :meth:`trigon`.
@@ -465,12 +465,12 @@ For example:
 .. function:: polygon
 
    | :sl:`draw a polygon`
-   | :sg:`polygon(surface, points, color, /) -> None`
+   | :sg:`polygon(surface, points, color) -> None`
 
    Draws an unfilled polygon on the given surface. For a filled polygon use
    :meth:`filled_polygon`.
 
-   The adjacent points in the ``points`` argument, as well as the first
+   The adjacent coordinates in the ``points`` argument, as well as the first
    and last points, will be connected by line segments.
    e.g. For the points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will
    be drawn from ``(x1, y1)`` to ``(x2, y2)``, from ``(x2, y2)`` to
@@ -478,10 +478,10 @@ For example:
 
    :param Surface surface: surface to draw on
    :param points: a sequence of 3 or more (x, y) coordinates, where each
-      point in the sequence must be a
+      *coordinate* in the sequence must be a
       tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats (float values
       will be truncated)
-   :type points: tuple(point) or list(point)
+   :type points: tuple(coordinate) or list(coordinate)
    :param color: color to draw with, the alpha value is optional if using a
       tuple ``(RGB[A])``
    :type color: Color or tuple(int, int, int, [int])
@@ -490,7 +490,7 @@ For example:
    :rtype: NoneType
 
    :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
-   :raises IndexError: if ``len(point) < 2`` (each point must have
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
       at least 2 items)
 
    .. ## pygame.gfxdraw.polygon ##
@@ -498,11 +498,11 @@ For example:
 .. function:: aapolygon
 
    | :sl:`draw an antialiased polygon`
-   | :sg:`aapolygon(surface, points, color, /) -> None`
+   | :sg:`aapolygon(surface, points, color) -> None`
 
    Draws an unfilled antialiased polygon on the given surface.
 
-   The adjacent points in the ``points`` argument, as well as the first
+   The adjacent coordinates in the ``points`` argument, as well as the first
    and last points, will be connected by line segments.
    e.g. For the points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will
    be drawn from ``(x1, y1)`` to ``(x2, y2)``, from ``(x2, y2)`` to
@@ -510,10 +510,10 @@ For example:
 
    :param Surface surface: surface to draw on
    :param points: a sequence of 3 or more (x, y) coordinates, where each
-      point in the sequence must be a
+      *coordinate* in the sequence must be a
       tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats (float values
       will be truncated)
-   :type points: tuple(point) or list(point)
+   :type points: tuple(coordinate) or list(coordinate)
    :param color: color to draw with, the alpha value is optional if using a
       tuple ``(RGB[A])``
    :type color: Color or tuple(int, int, int, [int])
@@ -522,7 +522,7 @@ For example:
    :rtype: NoneType
 
    :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
-   :raises IndexError: if ``len(point) < 2`` (each point must have
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
       at least 2 items)
 
    .. ## pygame.gfxdraw.aapolygon ##
@@ -530,12 +530,12 @@ For example:
 .. function:: filled_polygon
 
    | :sl:`draw a filled polygon`
-   | :sg:`filled_polygon(surface, points, color, /) -> None`
+   | :sg:`filled_polygon(surface, points, color) -> None`
 
    Draws a filled polygon on the given surface. For an unfilled polygon use
    :meth:`polygon`.
 
-   The adjacent points in the ``points`` argument, as well as the first
+   The adjacent coordinates in the ``points`` argument, as well as the first
    and last points, will be connected by line segments.
    e.g. For the points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will
    be drawn from ``(x1, y1)`` to ``(x2, y2)``, from ``(x2, y2)`` to
@@ -543,10 +543,10 @@ For example:
 
    :param Surface surface: surface to draw on
    :param points: a sequence of 3 or more (x, y) coordinates, where each
-      point in the sequence must be a
+      *coordinate* in the sequence must be a
       tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats (float values
       will be truncated)`
-   :type points: tuple(point) or list(point)
+   :type points: tuple(coordinate) or list(coordinate)
    :param color: color to draw with, the alpha value is optional if using a
       tuple ``(RGB[A])``
    :type color: Color or tuple(int, int, int, [int])
@@ -555,7 +555,7 @@ For example:
    :rtype: NoneType
 
    :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
-   :raises IndexError: if ``len(point) < 2`` (each point must have
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
       at least 2 items)
 
    .. ## pygame.gfxdraw.filled_polygon ##
@@ -563,7 +563,7 @@ For example:
 .. function:: textured_polygon
 
    | :sl:`draw a textured polygon`
-   | :sg:`textured_polygon(surface, points, texture, tx, ty, /) -> None`
+   | :sg:`textured_polygon(surface, points, texture, tx, ty) -> None`
 
    Draws a textured polygon on the given surface. For better performance, the
    surface and the texture should have the same format.
@@ -572,7 +572,7 @@ For example:
    a :func:`pygame.Surface.blit` blit. Also, a per-pixel alpha texture cannot be
    used with an 8-bit per pixel destination.
 
-   The adjacent points in the ``points`` argument, as well as the first
+   The adjacent coordinates in the ``points`` argument, as well as the first
    and last points, will be connected by line segments.
    e.g. For the points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will
    be drawn from ``(x1, y1)`` to ``(x2, y2)``, from ``(x2, y2)`` to
@@ -580,10 +580,10 @@ For example:
 
    :param Surface surface: surface to draw on
    :param points: a sequence of 3 or more (x, y) coordinates, where each
-      point in the sequence must be a
+      *coordinate* in the sequence must be a
       tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats (float values
       will be truncated)
-   :type points: tuple(point) or list(point)
+   :type points: tuple(coordinate) or list(coordinate)
    :param Surface texture: texture to draw on the polygon
    :param int tx: x offset of the texture
    :param int ty: y offset of the texture
@@ -592,7 +592,7 @@ For example:
    :rtype: NoneType
 
    :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
-   :raises IndexError: if ``len(point) < 2`` (each point must have
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
       at least 2 items)
 
    .. ## pygame.gfxdraw.textured_polygon ##
@@ -600,16 +600,16 @@ For example:
 .. function:: bezier
 
    | :sl:`draw a Bezier curve`
-   | :sg:`bezier(surface, points, steps, color, /) -> None`
+   | :sg:`bezier(surface, points, steps, color) -> None`
 
    Draws a Bézier curve on the given surface.
 
    :param Surface surface: surface to draw on
    :param points: a sequence of 3 or more (x, y) coordinates used to form a
-      curve, where each point in the sequence must be a
+      curve, where each *coordinate* in the sequence must be a
       tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats (float values
       will be truncated)
-   :type points: tuple(point) or list(point)
+   :type points: tuple(coordinate) or list(coordinate)
    :param int steps: number of steps for the interpolation, the minimum is 2
    :param color: color to draw with, the alpha value is optional if using a
       tuple ``(RGB[A])``
@@ -620,12 +620,9 @@ For example:
 
    :raises ValueError: if ``steps < 2``
    :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
-   :raises IndexError: if ``len(point) < 2`` (each point must have
+   :raises IndexError: if ``len(coordinate) < 2`` (each coordinate must have
       at least 2 items)
 
-   .. note:: This function supports up to around 150-200 points before the algorithm
-             breaks down.
-
    .. ## pygame.gfxdraw.bezier ##
 
 .. ## pygame.gfxdraw ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/image.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/image.rst.txt
index 4fc0e74..ec2e4fc 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/image.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/image.rst.txt
@@ -3,5 +3,373 @@
 :mod:`pygame.image`
 ===================
 
-.. autopgmodule:: pygame.image
-   :members:
+.. module:: pygame.image
+   :synopsis: pygame module for loading and saving images
+
+| :sl:`pygame module for image transfer`
+
+The image module contains functions for loading and saving pictures, as well as
+transferring Surfaces to formats usable by other packages.
+
+Note that there is no Image class; an image is loaded as a Surface object. The
+Surface class allows manipulation (drawing lines, setting pixels, capturing
+regions, etc.).
+
+In the vast majority of installations, pygame is built to support extended
+formats, using the SDL_Image library behind the scenes. However, some
+installations may only support uncompressed ``BMP`` images. With full image
+support, the :func:`pygame.image.load()` function can load the following
+formats.
+
+   * ``BMP``
+
+   * ``GIF`` (non-animated)
+
+   * ``JPEG``
+
+   * ``LBM`` (and ``PBM``, ``PGM``, ``PPM``)
+
+   * ``PCX``
+
+   * ``PNG``
+   
+   * ``PNM``
+
+   * ``SVG`` (limited support, using Nano SVG)
+
+   * ``TGA`` (uncompressed)
+
+   * ``TIFF``
+
+   * ``WEBP``
+
+   * ``XPM``
+   
+   
+.. versionadded:: 2.0 Loading SVG, WebP, PNM
+
+Saving images only supports a limited set of formats. You can save to the
+following formats.
+
+   * ``BMP``
+
+   * ``JPEG``
+
+   * ``PNG``
+
+   * ``TGA``
+   
+
+``JPEG`` and ``JPG``, as well as ``TIF`` and ``TIFF`` refer to the same file format
+
+.. versionadded:: 1.8 Saving PNG and JPEG files.
+
+
+.. function:: load
+
+   | :sl:`load new image from a file (or file-like object)`
+   | :sg:`load(filename) -> Surface`
+   | :sg:`load(fileobj, namehint="") -> Surface`
+
+   Load an image from a file source. You can pass either a filename, a Python
+   file-like object, or a pathlib.Path.
+
+   Pygame will automatically determine the image type (e.g., ``GIF`` or bitmap)
+   and create a new Surface object from the data. In some cases it will need to
+   know the file extension (e.g., ``GIF`` images should end in ".gif"). If you
+   pass a raw file-like object, you may also want to pass the original filename
+   as the namehint argument.
+
+   The returned Surface will contain the same color format, colorkey and alpha
+   transparency as the file it came from. You will often want to call
+   :func:`pygame.Surface.convert()` with no arguments, to create a copy that
+   will draw more quickly on the screen.
+
+   For alpha transparency, like in .png images, use the
+   :func:`pygame.Surface.convert_alpha()` method after loading so that the
+   image has per pixel transparency.
+
+   Pygame may not always be built to support all image formats. At minimum it
+   will support uncompressed ``BMP``. If :func:`pygame.image.get_extended()`
+   returns ``True``, you should be able to load most images (including PNG, JPG
+   and GIF).
+
+   You should use :func:`os.path.join()` for compatibility.
+
+   ::
+
+     eg. asurf = pygame.image.load(os.path.join('data', 'bla.png'))
+
+   .. ## pygame.image.load ##
+
+.. function:: save
+
+   | :sl:`save an image to file (or file-like object)`
+   | :sg:`save(Surface, filename) -> None`
+   | :sg:`save(Surface, fileobj, namehint="") -> None`
+
+   This will save your Surface as either a ``BMP``, ``TGA``, ``PNG``, or
+   ``JPEG`` image. If the filename extension is unrecognized it will default to
+   ``TGA``. Both ``TGA``, and ``BMP`` file formats create uncompressed files.
+   You can pass a filename, a pathlib.Path or a Python file-like object.
+   For file-like object, the image is saved to ``TGA`` format unless
+   a namehint with a recognizable extension is passed in.
+
+   .. note:: When saving to a file-like object, it seems that for most formats,
+             the object needs to be flushed after saving to it to make loading
+             from it possible.
+
+   .. versionchanged:: 1.8 Saving PNG and JPEG files.
+   .. versionchanged:: 2.0.0
+                       The ``namehint`` parameter was added to make it possible
+                       to save other formats than ``TGA`` to a file-like object.
+                       Saving to a file-like object with JPEG is possible.
+
+   .. ## pygame.image.save ##
+
+.. function:: get_sdl_image_version
+
+   | :sl:`get version number of the SDL_Image library being used`
+   | :sg:`get_sdl_image_version(linked=True) -> None`
+   | :sg:`get_sdl_image_version(linked=True) -> (major, minor, patch)`
+
+   If pygame is built with extended image formats, then this function will
+   return the SDL_Image library's version number as a tuple of 3 integers
+   ``(major, minor, patch)``. If not, then it will return ``None``.
+
+   ``linked=True`` is the default behavior and the function will return the
+   version of the library that Pygame is linked against, while ``linked=False``
+   will return the version of the library that Pygame is compiled against.
+
+   .. versionadded:: 2.0.0
+
+   .. versionchanged:: 2.2.0 ``linked`` keyword argument added and default behavior changed from returning compiled version to returning linked version
+
+   .. ## pygame.image.get_sdl_image_version ##
+
+.. function:: get_extended
+
+   | :sl:`test if extended image formats can be loaded`
+   | :sg:`get_extended() -> bool`
+
+   If pygame is built with extended image formats this function will return
+   True. It is still not possible to determine which formats will be available,
+   but generally you will be able to load them all.
+
+   .. ## pygame.image.get_extended ##
+
+.. function:: tostring
+
+   | :sl:`transfer image to byte buffer`
+   | :sg:`tostring(Surface, format, flipped=False) -> bytes`
+
+   Creates a string of bytes that can be transferred with the ``fromstring``
+   or ``frombytes`` methods in other Python imaging packages. Some Python
+   image packages prefer their images in bottom-to-top format (PyOpenGL for
+   example). If you pass ``True`` for the flipped argument, the byte buffer
+   will be vertically flipped.
+
+   The format argument is a string of one of the following values. Note that
+   only 8-bit Surfaces can use the "P" format. The other formats will work for
+   any Surface. Also note that other Python image packages support more formats
+   than pygame.
+
+      * ``P``, 8-bit palettized Surfaces
+
+      * ``RGB``, 24-bit image
+
+      * ``RGBX``, 32-bit image with unused space
+
+      * ``RGBA``, 32-bit image with an alpha channel
+
+      * ``ARGB``, 32-bit image with alpha channel first
+      
+      * ``BGRA``, 32-bit image with alpha channel, red and blue channels swapped
+
+      * ``RGBA_PREMULT``, 32-bit image with colors scaled by alpha channel
+
+      * ``ARGB_PREMULT``, 32-bit image with colors scaled by alpha channel, alpha channel first
+
+   .. note:: it is preferred to use :func:`tobytes` as of pygame 2.1.3
+
+   .. versionadded:: 2.1.3 BGRA format
+   .. ## pygame.image.tostring ##
+
+.. function:: tobytes
+
+   | :sl:`transfer image to byte buffer`
+   | :sg:`tobytes(Surface, format, flipped=False) -> bytes`
+
+   Creates a string of bytes that can be transferred with the ``fromstring``
+   or ``frombytes`` methods in other Python imaging packages. Some Python
+   image packages prefer their images in bottom-to-top format (PyOpenGL for
+   example). If you pass ``True`` for the flipped argument, the byte buffer
+   will be vertically flipped.
+
+   The format argument is a string of one of the following values. Note that
+   only 8-bit Surfaces can use the "P" format. The other formats will work for
+   any Surface. Also note that other Python image packages support more formats
+   than pygame.
+
+      * ``P``, 8-bit palettized Surfaces
+
+      * ``RGB``, 24-bit image
+
+      * ``RGBX``, 32-bit image with unused space
+
+      * ``RGBA``, 32-bit image with an alpha channel
+
+      * ``ARGB``, 32-bit image with alpha channel first
+      
+      * ``BGRA``, 32-bit image with alpha channel, red and blue channels swapped      
+
+      * ``RGBA_PREMULT``, 32-bit image with colors scaled by alpha channel
+
+      * ``ARGB_PREMULT``, 32-bit image with colors scaled by alpha channel, alpha channel first
+   
+   .. note:: this function is an alias for :func:`tostring`. The use of this
+             function is recommended over :func:`tostring` as of pygame 2.1.3.
+             This function was introduced so it matches nicely with other 
+             libraries (PIL, numpy, etc), and with people's expectations.
+
+   .. versionadded:: 2.1.3 
+
+   .. ## pygame.image.tobytes ##
+
+
+.. function:: fromstring
+
+   | :sl:`create new Surface from a byte buffer`
+   | :sg:`fromstring(bytes, size, format, flipped=False) -> Surface`
+
+   This function takes arguments similar to :func:`pygame.image.tostring()`.
+   The size argument is a pair of numbers representing the width and height.
+   Once the new Surface is created it is independent from the memory of the
+   bytes passed in.
+
+   The bytes and format passed must compute to the exact size of image
+   specified. Otherwise a ``ValueError`` will be raised.
+
+   See the :func:`pygame.image.frombuffer()` method for a potentially faster
+   way to transfer images into pygame.
+
+   .. note:: it is preferred to use :func:`frombytes` as of pygame 2.1.3
+
+   .. ## pygame.image.fromstring ##
+
+.. function:: frombytes
+
+   | :sl:`create new Surface from a byte buffer`
+   | :sg:`frombytes(bytes, size, format, flipped=False) -> Surface`
+
+   This function takes arguments similar to :func:`pygame.image.tobytes()`.
+   The size argument is a pair of numbers representing the width and height.
+   Once the new Surface is created it is independent from the memory of the
+   bytes passed in.
+
+   The bytes and format passed must compute to the exact size of image
+   specified. Otherwise a ``ValueError`` will be raised.
+
+   See the :func:`pygame.image.frombuffer()` method for a potentially faster
+   way to transfer images into pygame.
+
+   .. note:: this function is an alias for :func:`fromstring`. The use of this
+             function is recommended over :func:`fromstring` as of pygame 2.1.3.
+             This function was introduced so it matches nicely with other 
+             libraries (PIL, numpy, etc), and with people's expectations.
+
+   .. versionadded:: 2.1.3 
+
+   .. ## pygame.image.frombytes ##
+
+.. function:: frombuffer
+
+   | :sl:`create a new Surface that shares data inside a bytes buffer`
+   | :sg:`frombuffer(buffer, size, format) -> Surface`
+
+   Create a new Surface that shares pixel data directly from a buffer. This
+   buffer can be bytes, a bytearray, a memoryview, a
+   :class:`pygame.BufferProxy`, or any object that supports the buffer protocol.
+   This method takes similar arguments to :func:`pygame.image.fromstring()`, but
+   is unable to vertically flip the source data.
+
+   This will run much faster than :func:`pygame.image.fromstring`, since no
+   pixel data must be allocated and copied.
+
+   It accepts the following 'format' arguments:
+
+      * ``P``, 8-bit palettized Surfaces
+
+      * ``RGB``, 24-bit image
+
+      * ``BGR``, 24-bit image, red and blue channels swapped.
+
+      * ``RGBX``, 32-bit image with unused space
+
+      * ``RGBA``, 32-bit image with an alpha channel
+
+      * ``ARGB``, 32-bit image with alpha channel first
+
+      * ``BGRA``, 32-bit image with alpha channel, red and blue channels swapped
+  
+   .. versionadded:: 2.1.3 BGRA format
+   .. ## pygame.image.frombuffer ##
+
+.. function:: load_basic
+
+   | :sl:`load new BMP image from a file (or file-like object)`
+   | :sg:`load_basic(file) -> Surface`
+
+   Load an image from a file source. You can pass either a filename or a Python
+   file-like object, or a pathlib.Path.
+
+   This function only supports loading "basic" image format, ie ``BMP``
+   format.
+   This function is always available, no matter how pygame was built.
+
+   .. ## pygame.image.load_basic ##
+
+.. function:: load_extended
+
+   | :sl:`load an image from a file (or file-like object)`
+   | :sg:`load_extended(filename) -> Surface`
+   | :sg:`load_extended(fileobj, namehint="") -> Surface`
+
+   This function is similar to :func:`pygame.image.load()`, except that this
+   function can only be used if pygame was built with extended image format
+   support.
+
+   .. versionchanged:: 2.0.1
+                       This function is always available, but raises an
+                       ``NotImplementedError`` if extended image formats are
+                       not supported.
+                       Previously, this function may or may not be
+                       available, depending on the state of extended image
+                       format support.
+
+   .. ## pygame.image.load_extended ##
+
+.. function:: save_extended
+
+   | :sl:`save a png/jpg image to file (or file-like object)`
+   | :sg:`save_extended(Surface, filename) -> None`
+   | :sg:`save_extended(Surface, fileobj, namehint="") -> None`
+
+   This will save your Surface as either a ``PNG`` or ``JPEG`` image.
+
+   In case the image is being saved to a file-like object, this function
+   uses the namehint argument to determine the format of the file being
+   saved. Saves to ``JPEG`` in case the namehint was not specified while
+   saving to a file-like object.
+
+   .. versionchanged:: 2.0.1
+                       This function is always available, but raises an
+                       ``NotImplementedError`` if extended image formats are
+                       not supported.
+                       Previously, this function may or may not be
+                       available, depending on the state of extended image
+                       format support.
+
+   .. ## pygame.image.save_extended ##
+
+.. ## pygame.image ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/joystick.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/joystick.rst.txt
index a91ad6b..dba5b20 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/joystick.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/joystick.rst.txt
@@ -85,7 +85,7 @@ variable. See :ref:`environment variables ` for more deta
    | :sl:`Returns the number of joysticks.`
    | :sg:`get_count() -> count`
 
-   Return the number of joystick devices on the system. The count will be ``0``
+   Return the number of joystick devices on the system. The count will be ``0`` 
    if there are no joysticks on the system.
 
    When you create Joystick objects using ``Joystick(id)``, you pass an integer
@@ -96,7 +96,7 @@ variable. See :ref:`environment variables ` for more deta
 .. class:: Joystick
 
    | :sl:`Create a new Joystick object.`
-   | :sg:`Joystick(id, /) -> Joystick`
+   | :sg:`Joystick(id) -> Joystick`
 
    Create a new joystick to access a physical device. The id argument must be a
    value from ``0`` to ``pygame.joystick.get_count() - 1``.
@@ -105,10 +105,7 @@ variable. See :ref:`environment variables ` for more deta
    Once the device is initialized the pygame event queue will start receiving
    events about its input.
 
-   .. versionchangedold:: 2.0.0 Joystick objects are now opened immediately on creation.
-
-   .. versionchanged:: 2.1.4 This class is also available through the ``pygame.Joystick``
-      alias.
+   .. versionchanged:: 2.0.0 Joystick objects are now opened immediately on creation.
 
    .. method:: init
 
@@ -118,10 +115,10 @@ variable. See :ref:`environment variables ` for more deta
       Initialize the joystick, if it has been closed. It is safe to call this
       even if the joystick is already initialized.
 
-      .. deprecatedold:: 2.0.0
+      .. deprecated:: 2.0.0
 
          In future it will not be possible to reinitialise a closed Joystick
-         object.
+         object. Will be removed in Pygame 2.1.
 
       .. ## Joystick.init ##
 
@@ -155,10 +152,10 @@ variable. See :ref:`environment variables ` for more deta
       value that was passed to the ``Joystick()`` constructor. This method can
       safely be called while the Joystick is not initialized.
 
-      .. deprecatedold:: 2.0.0
+      .. deprecated:: 2.0.0
 
          The original device index is not useful in pygame 2. Use
-         :meth:`.get_instance_id` instead.
+         :meth:`.get_instance_id` instead. Will be removed in Pygame 2.1.
 
    .. method:: get_instance_id() -> int
 
@@ -168,7 +165,7 @@ variable. See :ref:`environment variables ` for more deta
       Get the joystick instance ID. This matches the ``instance_id`` field
       that is given in joystick events.
 
-      .. versionaddedold:: 2.0.0dev11
+      .. versionadded:: 2.0.0dev11
 
    .. method:: get_guid() -> str
 
@@ -178,7 +175,7 @@ variable. See :ref:`environment variables ` for more deta
       Get the GUID string. This identifies the exact hardware of the joystick
       device.
 
-      .. versionaddedold:: 2.0.0dev11
+      .. versionadded:: 2.0.0dev11
 
    .. method:: get_power_level() -> str
 
@@ -190,7 +187,7 @@ variable. See :ref:`environment variables ` for more deta
       One of: ``empty``, ``low``, ``medium``, ``full``, ``wired``, ``max``, or
       ``unknown``.
 
-      .. versionaddedold:: 2.0.0dev11
+      .. versionadded:: 2.0.0dev11
 
       .. ## Joystick.get_id ##
 
@@ -215,13 +212,13 @@ variable. See :ref:`environment variables ` for more deta
       two for the position. Controls like rudders and throttles are treated as
       additional axes.
 
-      The ``pygame.JOYAXISMOTION`` events will be in the range from ``-1.0``
-      to ``1.0``. A value of ``0.0`` means the axis is centered. Gamepad devices
-      will usually be ``-1``, ``0``, or ``1`` with no values in between. Older
-      analog joystick axes will not always use the full ``-1`` to ``1`` range,
-      and the centered value will be some area around ``0``.
-
-      Analog joysticks usually have a bit of noise in their axis, which will
+      The ``pygame.JOYAXISMOTION`` events will be in the range from ``-1.0`` 
+      to ``1.0``. A value of ``0.0`` means the axis is centered. Gamepad devices 
+      will usually be ``-1``, ``0``, or ``1`` with no values in between. Older 
+      analog joystick axes will not always use the full ``-1`` to ``1`` range, 
+      and the centered value will be some area around ``0``. 
+      
+      Analog joysticks usually have a bit of noise in their axis, which will 
       generate a lot of rapid small motion events.
 
       .. ## Joystick.get_numaxes ##
@@ -229,12 +226,12 @@ variable. See :ref:`environment variables ` for more deta
    .. method:: get_axis
 
       | :sl:`get the current position of an axis`
-      | :sg:`get_axis(axis_number, /) -> float`
+      | :sg:`get_axis(axis_number) -> float`
 
       Returns the current position of a joystick axis. The value will range
-      from ``-1`` to ``1`` with a value of ``0`` being centered. You may want
-      to take into account some tolerance to handle jitter, and joystick drift
-      may keep the joystick from centering at ``0`` or using the full range of
+      from ``-1`` to ``1`` with a value of ``0`` being centered. You may want 
+      to take into account some tolerance to handle jitter, and joystick drift 
+      may keep the joystick from centering at ``0`` or using the full range of 
       position values.
 
       The axis number must be an integer from ``0`` to ``get_numaxes() - 1``.
@@ -261,7 +258,7 @@ variable. See :ref:`environment variables ` for more deta
    .. method:: get_ball
 
       | :sl:`get the relative position of a trackball`
-      | :sg:`get_ball(ball_number, /) -> x, y`
+      | :sg:`get_ball(ball_number) -> x, y`
 
       Returns the relative movement of a joystick button. The value is a ``x, y``
       pair holding the relative movement since the last call to get_ball.
@@ -286,7 +283,7 @@ variable. See :ref:`environment variables ` for more deta
    .. method:: get_button
 
       | :sl:`get the current button state`
-      | :sg:`get_button(button, /) -> bool`
+      | :sg:`get_button(button) -> bool`
 
       Returns the current state of a joystick button.
 
@@ -302,8 +299,8 @@ variable. See :ref:`environment variables ` for more deta
       input.
 
       The ``pygame.JOYHATMOTION`` event is generated when the hat changes
-      position. The ``position`` attribute for the event contains a pair of
-      values that are either ``-1``, ``0``, or ``1``. A position of ``(0, 0)``
+      position. The ``position`` attribute for the event contains a pair of 
+      values that are either ``-1``, ``0``, or ``1``. A position of ``(0, 0)`` 
       means the hat is centered.
 
       .. ## Joystick.get_numhats ##
@@ -311,15 +308,15 @@ variable. See :ref:`environment variables ` for more deta
    .. method:: get_hat
 
       | :sl:`get the position of a joystick hat`
-      | :sg:`get_hat(hat_number, /) -> x, y`
+      | :sg:`get_hat(hat_number) -> x, y`
 
       Returns the current position of a position hat. The position is given as
       two values representing the ``x`` and ``y`` position for the hat. ``(0, 0)``
       means centered. A value of ``-1`` means left/down and a value of ``1`` means
-      right/up: so ``(-1, 0)`` means left; ``(1, 0)`` means right; ``(0, 1)`` means
+      right/up: so ``(-1, 0)`` means left; ``(1, 0)`` means right; ``(0, 1)`` means 
       up; ``(1, 1)`` means upper-right; etc.
 
-      This value is digital, ``i.e.``, each coordinate can be ``-1``, ``0`` or ``1``
+      This value is digital, ``i.e.``, each coordinate can be ``-1``, ``0`` or ``1`` 
       but never in-between.
 
       The hat number must be between ``0`` and ``get_numhats() - 1``.
@@ -338,9 +335,9 @@ variable. See :ref:`environment variables ` for more deta
       playing, then it will be overwritten.
 
       Returns True if the rumble was played successfully or False if the
-      joystick does not support it.
+      joystick does not support it or :meth:`pygame.version.SDL` is below 2.0.9.
 
-      .. versionaddedold:: 2.0.2
+      .. versionadded:: 2.0.2
 
       .. ## Joystick.rumble ##
 
@@ -352,26 +349,10 @@ variable. See :ref:`environment variables ` for more deta
       Stops any rumble effect playing on the joystick. See
       :meth:`Joystick.rumble` for more information.
 
-      .. versionaddedold:: 2.0.2
+      .. versionadded:: 2.0.2
 
       .. ## Joystick.stop_rumble ##
 
-   .. method:: set_led
-
-      | :sl:`Set the LED color of the joystick`
-      | :sg:`set_led(color_arg) -> bool`
-
-      Set the color of the LED on the joystick. The argument is a
-      ``pygame.Color``-compatible value (alpha being ignored). The
-      joystick's LED, if it has one, will be set to the input color.
-      If the joystick does not have an addressable LED, then this
-      method will do nothing and return False. Returns True if the
-      LED was set successfully.
-
-      .. versionadded:: 2.5.6
-
-      .. ## Joystick.set_led ##
-
    .. ## pygame.joystick.Joystick ##
 
 .. ## pygame.joystick ##
@@ -400,75 +381,35 @@ Nintendo Switch Left Joy-Con (pygame 2.x)
 *****************************************
 
 The Nintendo Switch Left Joy-Con has 4 axes, 11 buttons, and 0 hats. The values for the 4 axes never change.
-The controller is recognized as "Wireless Gamepad".
-After SDL 2.24.0, The controller is recognized as "Nintendo Switch Joy-Con (L)".
+The controller is recognized as "Wireless Gamepad"
 
 
 * **Buttons**::
 
-                    After SDL 2.24.0         Before SDL 2.24.0
-    D-pad Up            Button 2                  Button 3
-    D-pad Down          Button 1                  Button 0
-    D-pad Left          Button 3                  Button 2
-    D-pad Right         Button 0                  Button 1
-    SL                  Button 9                  Button 4
-    SR                  Button 10                 Button 5
-    -                   Button 6                  Button 8
-    Stick In            Button 7                  Button 10
-    Capture             Button 5                  Button 13
-    L                   Button 17                 Button 14
-    ZL                  Button 19                 Button 15
-
-Reference : D-pad Up points toward SL and SR buttons.
+    D-pad Up        - Button 0
+    D-pad Down      - Button 1
+    D-pad Left      - Button 2
+    D-pad Right     - Button 3
+    SL              - Button 4
+    SR              - Button 5
+    -               - Button 8
+    Stick In        - Button 10
+    Capture         - Button 13
+    L               - Button 14
+    ZL              - Button 15
 
 * **Hat/JoyStick**::
 
-    Down -> Up      -    Axis 1                    Axis Y
-    Left -> Right   -    Axis 0                    Axis X
+    Down -> Up      - Y Axis
+    Left -> Right   - X Axis
 
 
 Nintendo Switch Right Joy-Con (pygame 2.x)
 ******************************************
 
 The Nintendo Switch Right Joy-Con has 4 axes, 11 buttons, and 0 hats. The values for the 4 axes never change.
-The controller is recognized as "Wireless Gamepad".
-After SDL 2.24.0, The controller is recognized as "Nintendo Switch Joy-Con (R)".
+The controller is recognized as "Wireless Gamepad"
 
-* **Buttons**::
-
-                  After SDL 2.24.0         Before SDL 2.24.0
-    A Button          Button 1                 Button 0
-    B Button          Button 3                 Button 2
-    X Button          Button 0                 Button 1
-    Y Button          Button 2                 Button 3
-    SL                Button 9                 Button 4
-    SR                Button 10                Button 5
-    +                 Button 6                 Button 9
-    Stick In          Button 7                 Button 11
-    Home              Button 5                 Button 12
-    R                 Button 16                Button 14
-    ZR                Button 18                Button 15
-
-* **Hat/JoyStick**::
-
-    Down -> Up      -  Axis 1                   Axis Y
-    Left -> Right   -  Axis 0                   Axis X
-
-Nintendo Switch Left/Right Joy-Con (after SDL **2.24.0**)
-*********************************************************
-This device is created, if Nintendo Switch Joy-con Left and Nintendo Switch Joy-con Right are connected (these two devices are removed).
-The Nintendo Switch Left/Right Joy-Con has 6 axes, 20 buttons, and 0 hats. The values for the 6 axes never change.
-The controller is recognized as "Nintendo Switch Joy-Con (L/R)".
-
-* **Left Stick**::
-
-    Left -> Right   - Axis 0
-    Up -> Down      - Axis 1
-
-* **Right Stick**::
-
-    Left -> Right   - Axis 2
-    Up -> Down      - Axis 3
 
 * **Buttons**::
 
@@ -476,22 +417,19 @@ The controller is recognized as "Nintendo Switch Joy-Con (L/R)".
     B Button        - Button 1
     X Button        - Button 2
     Y Button        - Button 3
-    - Button        - Button 4
-    Home Button     - Button 5
-    + Button        - Button 6
-    ZL              - Button ? Missing
-    ZR              - Button ? Missing
-    L. Stick In     - Button 9
-    R. Stick In     - Button 10
-    D-pad Up        - Button 11
-    D-pad Down      - Button 12
-    D-pad Left      - Button 13
-    D-pad Right     - Button 14
-    Capture Button  - Button 15
-    Right SR        - Button 16
-    Left SL         - Button 17
-    Right SL        - Button 18
-    Left SR         - Button 19
+    SL              - Button 4
+    SR              - Button 5
+    +               - Button 9
+    Stick In        - Button 11
+    Home            - Button 12
+    R               - Button 14
+    ZR              - Button 15
+
+* **Hat/JoyStick**::
+
+    Down -> Up      - Y Axis
+    Left -> Right   - X Axis
+
 
 Nintendo Switch Pro Controller (pygame 2.x)
 *******************************************
@@ -625,6 +563,52 @@ The controller is recognized as "PS4 Controller".
     D-pad Right     - Button 14
     Touch Pad Click - Button 15
 
+Playstation 5 Controller (pygame 2.x)
+*************************************
+
+The PlayStation 5 controller mapping has 6 axes, 13 buttons, and 1 hat.
+The controller is recognized as "Sony Interactive Entertainment Wireless Controller".
+
+* **Left Stick**::
+
+    Left -> Right   - Axis 0
+    Up   -> Down    - Axis 1
+
+* **Right Stick**::
+
+    Left -> Right   - Axis 3
+    Up   -> Down    - Axis 4
+
+* **Left Trigger**::
+
+    Out -> In       - Axis 2
+
+* **Right Trigger**::
+
+    Out -> In       - Axis 5
+
+* **Buttons**::
+
+    Cross Button    - Button 0
+    Circle Button   - Button 1
+    Square Button   - Button 2
+    Triangle Button - Button 3
+    Left Bumper     - Button 4
+    Right Bumper    - Button 5
+    Left Trigger    - Button 6
+    Right Trigger   - Button 7
+    Share Button    - Button 8
+    Options Button  - Button 9
+    PS Button       - Button 10
+    Left Stick in   - Button 11
+    Right Stick in  - Button 12
+
+* **Hat/D-pad**::
+
+    Down -> Up      - Y Axis
+    Left -> Right   - X Axis
+
+
 
 XBox 360 Controller (pygame 1.x)
 ********************************
@@ -710,3 +694,4 @@ The controller is recognized as "Wireless Controller".
 
     Down -> Up      - Y Axis
     Left -> Right   - X Axis
+
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/key.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/key.rst.txt
index 67b66c7..315b0fb 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/key.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/key.rst.txt
@@ -3,6 +3,453 @@
 :mod:`pygame.key`
 =================
 
-.. autopgmodule:: pygame.key
-   :members:
-   :exclude-members: ScancodeWrapper
+.. module:: pygame.key
+   :synopsis: pygame module to work with the keyboard
+
+| :sl:`pygame module to work with the keyboard`
+
+This module contains functions for dealing with the keyboard.
+
+The :mod:`pygame.event` queue gets ``pygame.KEYDOWN`` and ``pygame.KEYUP``
+events when the keyboard buttons are pressed and released. Both events have
+``key`` and ``mod`` attributes.
+
+   * ``key``: an :ref:`integer ID ` representing every key
+     on the keyboard
+   * ``mod``: a bitmask of all the :ref:`modifier keys `
+     that were in a pressed state when the event occurred
+
+The ``pygame.KEYDOWN`` event has the additional attributes ``unicode`` and
+``scancode``.
+
+   * ``unicode``: a single character string that is the fully translated
+     character entered, this takes into account the shift and composition keys
+   * ``scancode``: the platform-specific key code, which could be different from
+     keyboard to keyboard, but is useful for key selection of weird keys like
+     the multimedia keys
+
+.. versionadded:: 2.0.0
+    The ``pygame.TEXTINPUT`` event is preferred to the ``unicode`` attribute
+    of ``pygame.KEYDOWN``. The attribute ``text`` contains the input.
+
+
+.. _key-constants-label:
+
+The following is a list of all the constants (from :mod:`pygame.locals`) used to
+represent keyboard keys.
+
+Portability note: The integers for key constants differ between pygame 1 and 2.
+Always use key constants (``K_a``) rather than integers directly (``97``) so
+that your key handling code works well on both pygame 1 and pygame 2.
+
+
+::
+
+      pygame
+      Constant      ASCII   Description
+      ---------------------------------
+      K_BACKSPACE   \b      backspace
+      K_TAB         \t      tab
+      K_CLEAR               clear
+      K_RETURN      \r      return
+      K_PAUSE               pause
+      K_ESCAPE      ^[      escape
+      K_SPACE               space
+      K_EXCLAIM     !       exclaim
+      K_QUOTEDBL    "       quotedbl
+      K_HASH        #       hash
+      K_DOLLAR      $       dollar
+      K_AMPERSAND   &       ampersand
+      K_QUOTE               quote
+      K_LEFTPAREN   (       left parenthesis
+      K_RIGHTPAREN  )       right parenthesis
+      K_ASTERISK    *       asterisk
+      K_PLUS        +       plus sign
+      K_COMMA       ,       comma
+      K_MINUS       -       minus sign
+      K_PERIOD      .       period
+      K_SLASH       /       forward slash
+      K_0           0       0
+      K_1           1       1
+      K_2           2       2
+      K_3           3       3
+      K_4           4       4
+      K_5           5       5
+      K_6           6       6
+      K_7           7       7
+      K_8           8       8
+      K_9           9       9
+      K_COLON       :       colon
+      K_SEMICOLON   ;       semicolon
+      K_LESS        <       less-than sign
+      K_EQUALS      =       equals sign
+      K_GREATER     >       greater-than sign
+      K_QUESTION    ?       question mark
+      K_AT          @       at
+      K_LEFTBRACKET [       left bracket
+      K_BACKSLASH   \       backslash
+      K_RIGHTBRACKET ]      right bracket
+      K_CARET       ^       caret
+      K_UNDERSCORE  _       underscore
+      K_BACKQUOTE   `       grave
+      K_a           a       a
+      K_b           b       b
+      K_c           c       c
+      K_d           d       d
+      K_e           e       e
+      K_f           f       f
+      K_g           g       g
+      K_h           h       h
+      K_i           i       i
+      K_j           j       j
+      K_k           k       k
+      K_l           l       l
+      K_m           m       m
+      K_n           n       n
+      K_o           o       o
+      K_p           p       p
+      K_q           q       q
+      K_r           r       r
+      K_s           s       s
+      K_t           t       t
+      K_u           u       u
+      K_v           v       v
+      K_w           w       w
+      K_x           x       x
+      K_y           y       y
+      K_z           z       z
+      K_DELETE              delete
+      K_KP0                 keypad 0
+      K_KP1                 keypad 1
+      K_KP2                 keypad 2
+      K_KP3                 keypad 3
+      K_KP4                 keypad 4
+      K_KP5                 keypad 5
+      K_KP6                 keypad 6
+      K_KP7                 keypad 7
+      K_KP8                 keypad 8
+      K_KP9                 keypad 9
+      K_KP_PERIOD   .       keypad period
+      K_KP_DIVIDE   /       keypad divide
+      K_KP_MULTIPLY *       keypad multiply
+      K_KP_MINUS    -       keypad minus
+      K_KP_PLUS     +       keypad plus
+      K_KP_ENTER    \r      keypad enter
+      K_KP_EQUALS   =       keypad equals
+      K_UP                  up arrow
+      K_DOWN                down arrow
+      K_RIGHT               right arrow
+      K_LEFT                left arrow
+      K_INSERT              insert
+      K_HOME                home
+      K_END                 end
+      K_PAGEUP              page up
+      K_PAGEDOWN            page down
+      K_F1                  F1
+      K_F2                  F2
+      K_F3                  F3
+      K_F4                  F4
+      K_F5                  F5
+      K_F6                  F6
+      K_F7                  F7
+      K_F8                  F8
+      K_F9                  F9
+      K_F10                 F10
+      K_F11                 F11
+      K_F12                 F12
+      K_F13                 F13
+      K_F14                 F14
+      K_F15                 F15
+      K_NUMLOCK             numlock
+      K_CAPSLOCK            capslock
+      K_SCROLLOCK           scrollock
+      K_RSHIFT              right shift
+      K_LSHIFT              left shift
+      K_RCTRL               right control
+      K_LCTRL               left control
+      K_RALT                right alt
+      K_LALT                left alt
+      K_RMETA               right meta
+      K_LMETA               left meta
+      K_LSUPER              left Windows key
+      K_RSUPER              right Windows key
+      K_MODE                mode shift
+      K_HELP                help
+      K_PRINT               print screen
+      K_SYSREQ              sysrq
+      K_BREAK               break
+      K_MENU                menu
+      K_POWER               power
+      K_EURO                Euro
+      K_AC_BACK             Android back button
+
+
+.. _key-modifiers-label:
+
+The keyboard also has a list of modifier states (from :mod:`pygame.locals`) that
+can be assembled by bitwise-ORing them together.
+
+::
+
+      pygame
+      Constant      Description
+      -------------------------
+      KMOD_NONE     no modifier keys pressed
+      KMOD_LSHIFT   left shift
+      KMOD_RSHIFT   right shift
+      KMOD_SHIFT    left shift or right shift or both
+      KMOD_LCTRL    left control
+      KMOD_RCTRL    right control
+      KMOD_CTRL     left control or right control or both
+      KMOD_LALT     left alt
+      KMOD_RALT     right alt
+      KMOD_ALT      left alt or right alt or both
+      KMOD_LMETA    left meta
+      KMOD_RMETA    right meta
+      KMOD_META     left meta or right meta or both
+      KMOD_CAPS     caps lock
+      KMOD_NUM      num lock
+      KMOD_MODE     AltGr
+
+
+The modifier information is contained in the ``mod`` attribute of the
+``pygame.KEYDOWN`` and ``pygame.KEYUP`` events. The ``mod`` attribute is a
+bitmask of all the modifier keys that were in a pressed state when the event
+occurred. The modifier information can be decoded using a bitwise AND (except
+for ``KMOD_NONE``, which should be compared using equals ``==``). For example:
+
+::
+
+    for event in pygame.event.get():
+        if event.type == pygame.KEYDOWN or event.type == pygame.KEYUP:
+            if event.mod == pygame.KMOD_NONE:
+                print('No modifier keys were in a pressed state when this '
+                      'event occurred.')
+            else:
+                if event.mod & pygame.KMOD_LSHIFT:
+                    print('Left shift was in a pressed state when this event '
+                          'occurred.')
+                if event.mod & pygame.KMOD_RSHIFT:
+                    print('Right shift was in a pressed state when this event '
+                          'occurred.')
+                if event.mod & pygame.KMOD_SHIFT:
+                    print('Left shift or right shift or both were in a '
+                          'pressed state when this event occurred.')
+
+
+
+.. function:: get_focused
+
+   | :sl:`true if the display is receiving keyboard input from the system`
+   | :sg:`get_focused() -> bool`
+
+   Returns ``True`` when the display window has keyboard focus from the
+   system. If the display needs to ensure it does not lose keyboard focus, it
+   can use :func:`pygame.event.set_grab()` to grab all input.
+
+   .. ## pygame.key.get_focused ##
+
+.. function:: get_pressed
+
+   | :sl:`get the state of all keyboard buttons`
+   | :sg:`get_pressed() -> bools`
+
+   Returns a sequence of boolean values representing the state of every key on
+   the keyboard. Use the key constant values to index the array. A ``True``
+   value means that the button is pressed.
+
+   .. note::
+      Getting the list of pushed buttons with this function is not the proper
+      way to handle text entry from the user. There is no way to know the order
+      of keys pressed, and rapidly pushed keys can be completely unnoticed
+      between two calls to ``pygame.key.get_pressed()``. There is also no way to
+      translate these pushed keys into a fully translated character value. See
+      the ``pygame.KEYDOWN`` events on the :mod:`pygame.event` queue for this
+      functionality.
+   
+   .. versionadded:: 2.2.0
+      The collection of bools returned by ``get_pressed`` can not be iterated
+      over because the indexes of the internal tuple does not correspond to the 
+      keycodes.
+
+   .. versionadded:: 2.5.0
+      Iteration over the collection of bools returned by ``get_pressed`` is now
+      restored. However it still does not make sense to iterate over it. Currently.
+
+   .. ## pygame.key.get_pressed ##
+
+.. function:: get_mods
+
+   | :sl:`determine which modifier keys are being held`
+   | :sg:`get_mods() -> int`
+
+   Returns a single integer representing a bitmask of all the modifier keys
+   being held. Using bitwise operators you can test if specific
+   :ref:`modifier keys ` are pressed.
+
+   .. ## pygame.key.get_mods ##
+
+.. function:: set_mods
+
+   | :sl:`temporarily set which modifier keys are pressed`
+   | :sg:`set_mods(int) -> None`
+
+   Create a bitmask of the :ref:`modifier key constants `
+   you want to impose on your program.
+
+   .. ## pygame.key.set_mods ##
+
+.. function:: set_repeat
+
+   | :sl:`control how held keys are repeated`
+   | :sg:`set_repeat() -> None`
+   | :sg:`set_repeat(delay) -> None`
+   | :sg:`set_repeat(delay, interval) -> None`
+
+   When the keyboard repeat is enabled, keys that are held down will generate
+   multiple ``pygame.KEYDOWN`` events. The ``delay`` parameter is the number of
+   milliseconds before the first repeated ``pygame.KEYDOWN`` event will be sent.
+   After that, another ``pygame.KEYDOWN`` event will be sent every ``interval``
+   milliseconds. If a ``delay`` value is provided and an ``interval`` value is
+   not provided or is 0, then the ``interval`` will be set to the same value as
+   ``delay``.
+
+   To disable key repeat call this function with no arguments or with ``delay``
+   set to 0.
+
+   When pygame is initialized the key repeat is disabled.
+
+   :raises ValueError: if ``delay`` or ``interval`` is < 0
+
+   .. versionchanged:: 2.0.0 A ``ValueError`` is now raised (instead of a
+      ``pygame.error``) if ``delay`` or ``interval`` is < 0.
+
+   .. ## pygame.key.set_repeat ##
+
+.. function:: get_repeat
+
+   | :sl:`see how held keys are repeated`
+   | :sg:`get_repeat() -> (delay, interval)`
+
+   Get the ``delay`` and ``interval`` keyboard repeat values. Refer to
+   :func:`pygame.key.set_repeat()` for a description of these values.
+
+   .. versionadded:: 1.8
+
+   .. ## pygame.key.get_repeat ##
+
+.. function:: name
+
+   | :sl:`get the name of a key identifier`
+   | :sg:`name(key, use_compat=True) -> str`
+
+   Get the descriptive name of the button from a keyboard button id constant.
+   Returns an empty string (``""``) if the key is not found.
+
+   If ``use_compat`` argument is ``True`` (which is the default), this function
+   returns the legacy name of a key where applicable. The return value is
+   expected to be the same across different pygame versions (provided the
+   corresponding key constant exists and is unique). If the return value is
+   passed to the ``key_code`` function, the original constant will be returned.
+
+   **Experimental:** ``use_compat`` parameter still in development for testing and feedback. It may change.
+   `Please leave use_compat feedback with authors `_
+
+   If this argument is ``False``, the returned name may be prettier to display
+   and may cover a wider range of keys than with ``use_compat``, but there are
+   no guarantees that this name will be the same across different pygame
+   versions. If the name returned is passed to the ``key_code`` function, the
+   original constant is returned back (this is an implementation detail which
+   may change later, do not rely on this)
+
+   .. versionchanged:: 2.1.3 Added ``use_compat`` argument and guaranteed API stability for it
+
+   .. ## pygame.key.name ##
+
+.. function:: key_code
+
+   | :sl:`get the key identifier from a key name`
+   | :sg:`key_code(name=string) -> int`
+
+   Get the key identifier code from the descriptive name of the key. This
+   returns an integer matching one of the K_* keycodes. For example:
+
+   ::
+
+        >>> pygame.key.key_code("return") == pygame.K_RETURN
+        True
+        >>> pygame.key.key_code("0") == pygame.K_0
+        True
+        >>> pygame.key.key_code("space") == pygame.K_SPACE
+        True
+
+   :raises ValueError: if the key name is not known.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.key.key_code ##
+
+.. function:: start_text_input
+
+   | :sl:`start handling Unicode text input events`
+   | :sg:`start_text_input() -> None`
+
+   Start receiving ``pygame.TEXTEDITING`` and ``pygame.TEXTINPUT``
+   events. If applicable, show the on-screen keyboard or IME editor.
+
+   For many languages, key presses will automatically generate a
+   corresponding ``pygame.TEXTINPUT`` event. Special keys like
+   escape or function keys, and certain key combinations will not
+   generate ``pygame.TEXTINPUT`` events.
+
+   In other languages, entering a single symbol may require multiple
+   key presses, or a language-specific user interface. In this case,
+   ``pygame.TEXTINPUT`` events are preferable to ``pygame.KEYDOWN``
+   events for text input.
+
+   A ``pygame.TEXTEDITING`` event is received when an IME composition
+   is started or changed. It contains the composition ``text``, ``length``,
+   and editing ``start`` position within the composition (attributes
+   ``text``, ``length``, and ``start``, respectively).
+   When the composition is committed (or non-IME input is received),
+   a ``pygame.TEXTINPUT`` event is generated.
+
+   Text input events handling is on by default.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.key.start_text_input ##
+
+.. function:: stop_text_input
+
+   | :sl:`stop handling Unicode text input events`
+   | :sg:`stop_text_input() -> None`
+
+   Stop receiving ``pygame.TEXTEDITING`` and ``pygame.TEXTINPUT``
+   events. If an on-screen keyboard or IME editor was shown with
+   ``pygame.key.start_text_input()``, hide it again.
+
+   Text input events handling is on by default.
+
+   To avoid triggering the IME editor or the on-screen keyboard
+   when the user is holding down a key during gameplay, text input
+   should be disabled once text entry is finished, or when the user
+   clicks outside of a text box.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.key.stop_text_input ##
+
+.. function:: set_text_input_rect
+
+   | :sl:`controls the position of the candidate list`
+   | :sg:`set_text_input_rect(Rect) -> None`
+
+   This sets the rectangle used for typing with an IME.
+   It controls where the candidate list will open, if supported.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.key.set_text_input_rect ##
+
+.. ## pygame.key ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/locals.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/locals.rst.txt
index 7cfa370..091dbaa 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/locals.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/locals.rst.txt
@@ -14,7 +14,7 @@ can use ``pygame.locals`` to include only the pygame constants with a ``from
 pygame.locals import *``.
 
 Detailed descriptions of the various constants can be found throughout the
-pygame-ce documentation. Here are the locations of some of them.
+pygame documentation. Here are the locations of some of them.
 
    - The :mod:`pygame.display` module contains flags like ``FULLSCREEN`` used
      by :func:`pygame.display.set_mode`.
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mask.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mask.rst.txt
index f7b818a..f4365cf 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mask.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mask.rst.txt
@@ -3,6 +3,640 @@
 :mod:`pygame.mask`
 ==================
 
-.. autopgmodule:: pygame.mask
-   :members:
-   :exclude-members: MaskType
+.. module:: pygame.mask
+   :synopsis: pygame module for image masks.
+
+| :sl:`pygame module for image masks.`
+
+Useful for fast pixel perfect collision detection. A mask uses 1 bit per-pixel
+to store which parts collide.
+
+.. versionadded:: 1.8
+
+.. versionchanged:: 2.0.2 Mask functions now support keyword arguments.
+
+.. versionchanged:: 2.0.2 Mask functions that take positions or offsets now
+                    support :class:`pygame.math.Vector2` arguments.
+
+
+.. function:: from_surface
+
+   | :sl:`Creates a Mask from the given surface`
+   | :sg:`from_surface(surface) -> Mask`
+   | :sg:`from_surface(surface, threshold=127) -> Mask`
+
+   Creates a :class:`Mask` object from the given surface by setting all the
+   opaque pixels and not setting the transparent pixels.
+
+   If the surface uses a color-key, then it is used to decide which bits in
+   the resulting mask are set. All the pixels that are **not** equal to the
+   color-key are **set** and the pixels equal to the color-key are not set.
+
+   If a color-key is not used, then the alpha value of each pixel is used to
+   decide which bits in the resulting mask are set. All the pixels that have an
+   alpha value **greater than** the ``threshold`` parameter are **set** and the
+   pixels with an alpha value less than or equal to the ``threshold`` are
+   not set.
+
+   :param Surface surface: the surface to create the mask from
+   :param int threshold: (optional) the alpha threshold (default is 127) to
+      compare with each surface pixel's alpha value, if the ``surface`` is
+      color-keyed this parameter is ignored
+
+   :returns: a newly created :class:`Mask` object from the given surface
+   :rtype: Mask
+
+   .. note::
+      This function is used to create the masks for
+      :func:`pygame.sprite.collide_mask`.
+
+   .. ## pygame.mask.from_surface ##
+
+.. function:: from_threshold
+
+   | :sl:`Creates a mask by thresholding Surfaces`
+   | :sg:`from_threshold(surface, color) -> Mask`
+   | :sg:`from_threshold(surface, color, threshold=(0, 0, 0, 255), othersurface=None, palette_colors=1) -> Mask`
+
+   This is a more featureful method of getting a :class:`Mask` from a surface.
+
+   If the optional ``othersurface`` is not used, all the pixels **within** the
+   ``threshold`` of the ``color`` parameter are **set** in the resulting mask.
+
+   If the optional ``othersurface`` is used, every pixel in the first surface
+   that is **within** the ``threshold`` of the corresponding pixel in
+   ``othersurface`` is **set** in the resulting mask.
+
+   :param Surface surface: the surface to create the mask from
+   :param color: color used to check if the surface's pixels are within the
+      given ``threshold`` range, this parameter is ignored if the optional
+      ``othersurface`` parameter is supplied
+   :type color: Color or int or tuple(int, int, int, [int]) or list[int, int, int, [int]]
+   :param threshold: (optional) the threshold range used to check the difference
+      between two colors (default is ``(0, 0, 0, 255)``)
+   :type threshold: Color or int or tuple(int, int, int, [int]) or list[int, int, int, [int]]
+   :param Surface othersurface: (optional) used to check whether the pixels of
+      the first surface are within the given ``threshold`` range of the pixels
+      from this surface (default is ``None``)
+   :param int palette_colors: (optional) indicates whether to use the palette
+      colors or not, a nonzero value causes the palette colors to be used and a
+      0 causes them not to be used (default is 1)
+
+   :returns: a newly created :class:`Mask` object from the given surface
+   :rtype: Mask
+
+   .. ## pygame.mask.from_threshold ##
+
+.. class:: Mask
+
+   | :sl:`pygame object for representing 2D bitmasks`
+   | :sg:`Mask(size=(width, height)) -> Mask`
+   | :sg:`Mask(size=(width, height), fill=False) -> Mask`
+
+   A ``Mask`` object is used to represent a 2D bitmask. Each bit in
+   the mask represents a pixel. 1 is used to indicate a set bit and 0 is used
+   to indicate an unset bit. Set bits in a mask can be used to detect collisions
+   with other masks and their set bits.
+
+   A filled mask has all of its bits set to 1, conversely an
+   unfilled/cleared/empty mask has all of its bits set to 0. Masks can be
+   created unfilled (default) or filled by using the ``fill`` parameter. Masks
+   can also be cleared or filled using the :func:`pygame.mask.Mask.clear()` and
+   :func:`pygame.mask.Mask.fill()` methods respectively.
+
+   A mask's coordinates start in the top left corner at ``(0, 0)`` just like
+   :mod:`pygame.Surface`. Individual bits can be accessed using the
+   :func:`pygame.mask.Mask.get_at()` and :func:`pygame.mask.Mask.set_at()`
+   methods.
+
+   .. _mask-offset-label:
+
+   The methods :meth:`overlap`, :meth:`overlap_area`, :meth:`overlap_mask`,
+   :meth:`draw`, :meth:`erase`, and :meth:`convolve` use an offset parameter
+   to indicate the offset of another mask's top left corner from the calling
+   mask's top left corner. The calling mask's top left corner is considered to
+   be the origin ``(0, 0)``. Offsets are a sequence of two values
+   ``(x_offset, y_offset)``. Positive and negative offset values are supported.
+
+   ::
+
+                 0 to x (x_offset)
+                 :    :
+         0 ..... +----:---------+
+         to      |    :         |
+         y .......... +-----------+
+      (y_offset) |    | othermask |
+                 |    +-----------+
+                 | calling_mask |
+                 +--------------+
+
+   :param size: the dimensions of the mask (width and height)
+   :param bool fill: (optional) create an unfilled mask (default: ``False``) or
+      filled mask (``True``)
+
+   :returns: a newly created :class:`Mask` object
+   :rtype: Mask
+
+   .. versionchanged:: 2.0.0
+      Shallow copy support added. The :class:`Mask` class supports the special
+      method ``__copy__()`` and shallow copying via ``copy.copy(mask)``.
+   .. versionchanged:: 2.0.0 Subclassing support added. The :class:`Mask` class
+      can be used as a base class.
+   .. versionchanged:: 1.9.5 Added support for keyword arguments.
+   .. versionchanged:: 1.9.5 Added the optional keyword parameter ``fill``.
+   .. versionchanged:: 1.9.5 Added support for masks with a width and/or a
+      height of 0.
+
+   .. method:: copy
+
+      | :sl:`Returns a new copy of the mask`
+      | :sg:`copy() -> Mask`
+
+      :returns: a new copy of this mask, the new mask will have the same width,
+         height, and set/unset bits as the original
+      :rtype: Mask
+
+      .. note::
+         If a mask subclass needs to copy any instance specific attributes
+         then it should override the ``__copy__()`` method. The overridden
+         ``__copy__()`` method needs to call ``super().__copy__()`` and then
+         copy the required data as in the following example code.
+
+         ::
+
+            class SubMask(pygame.mask.Mask):
+                def __copy__(self):
+                    new_mask = super().__copy__()
+                    # Do any SubMask attribute copying here.
+                    return new_mask
+
+      .. versionadded:: 2.0.0
+
+      .. ## Mask.copy ##
+
+   .. method:: get_size
+
+      | :sl:`Returns the size of the mask`
+      | :sg:`get_size() -> (width, height)`
+
+      :returns: the size of the mask, (width, height)
+      :rtype: tuple(int, int)
+
+      .. ## Mask.get_size ##
+
+   .. method:: get_rect
+
+      | :sl:`Returns a Rect based on the size of the mask`
+      | :sg:`get_rect(\**kwargs) -> Rect`
+
+      Returns a new :func:`pygame.Rect` object based on the size of this mask.
+      The rect's default position will be ``(0, 0)`` and its default width and
+      height will be the same as this mask's. The rect's attributes can be
+      altered via :func:`pygame.Rect` attribute keyword arguments/values passed
+      into this method. As an example, ``a_mask.get_rect(center=(10, 5))`` would
+      create a :func:`pygame.Rect` based on the mask's size centered at the
+      given position.
+
+      :param dict kwargs: :func:`pygame.Rect` attribute keyword arguments/values
+         that will be applied to the rect
+
+      :returns: a new :func:`pygame.Rect` object based on the size of this mask
+         with any :func:`pygame.Rect` attribute keyword arguments/values applied
+         to it
+      :rtype: Rect
+
+      .. versionadded:: 2.0.0
+
+      .. ## Mask.get_rect ##
+
+   .. method:: get_at
+
+      | :sl:`Gets the bit at the given position`
+      | :sg:`get_at(pos) -> int`
+
+      :param pos: the position of the bit to get (x, y)
+
+      :returns: 1 if the bit is set, 0 if the bit is not set
+      :rtype: int
+
+      :raises IndexError: if the position is outside of the mask's bounds
+
+      .. ## Mask.get_at ##
+
+   .. method:: set_at
+
+      | :sl:`Sets the bit at the given position`
+      | :sg:`set_at(pos) -> None`
+      | :sg:`set_at(pos, value=1) -> None`
+
+      :param pos: the position of the bit to set (x, y)
+      :param int value: any nonzero int will set the bit to 1, 0 will set the
+         bit to 0 (default is 1)
+
+      :returns: ``None``
+      :rtype: NoneType
+
+      :raises IndexError: if the position is outside of the mask's bounds
+
+      .. ## Mask.set_at ##
+
+   .. method:: overlap
+
+      | :sl:`Returns the point of intersection`
+      | :sg:`overlap(other, offset) -> (x, y)`
+      | :sg:`overlap(other, offset) -> None`
+
+      Returns the first point of intersection encountered between this mask and
+      ``other``. A point of intersection is 2 overlapping set bits.
+
+      The current algorithm searches the overlapping area in
+      ``sizeof(unsigned long int) * CHAR_BIT`` bit wide column blocks (the value
+      of ``sizeof(unsigned long int) * CHAR_BIT`` is platform dependent, for
+      clarity it will be referred to as ``W``). Starting at the top left corner
+      it checks bits 0 to ``W - 1`` of the first row (``(0, 0)`` to
+      ``(W - 1, 0)``) then continues to the next row (``(0, 1)`` to
+      ``(W - 1, 1)``). Once this entire column block is checked, it continues to
+      the next one (``W`` to ``2 * W - 1``). This is repeated until it finds a
+      point of intersection or the entire overlapping area is checked.
+
+      :param Mask other: the other mask to overlap with this mask
+      :param offset: the offset of ``other`` from this mask, for more
+         details refer to the :ref:`Mask offset notes `
+
+      :returns: point of intersection or ``None`` if no intersection
+      :rtype: tuple(int, int) or NoneType
+
+      .. ## Mask.overlap ##
+
+   .. method:: overlap_area
+
+      | :sl:`Returns the number of overlapping set bits`
+      | :sg:`overlap_area(other, offset) -> numbits`
+
+      Returns the number of overlapping set bits between between this mask and
+      ``other``.
+
+      This can be useful for collision detection. An approximate collision
+      normal can be found by calculating the gradient of the overlapping area
+      through the finite difference.
+
+      ::
+
+         dx = mask.overlap_area(other, (x + 1, y)) - mask.overlap_area(other, (x - 1, y))
+         dy = mask.overlap_area(other, (x, y + 1)) - mask.overlap_area(other, (x, y - 1))
+
+      :param Mask other: the other mask to overlap with this mask
+      :param offset: the offset of ``other`` from this mask, for more
+         details refer to the :ref:`Mask offset notes `
+
+      :returns: the number of overlapping set bits
+      :rtype: int
+
+      .. ## Mask.overlap_area ##
+
+   .. method:: overlap_mask
+
+      | :sl:`Returns a mask of the overlapping set bits`
+      | :sg:`overlap_mask(other, offset) -> Mask`
+
+      Returns a :class:`Mask`, the same size as this mask, containing the
+      overlapping set bits between this mask and ``other``.
+
+      :param Mask other: the other mask to overlap with this mask
+      :param offset: the offset of ``other`` from this mask, for more
+         details refer to the :ref:`Mask offset notes `
+
+      :returns: a newly created :class:`Mask` with the overlapping bits set
+      :rtype: Mask
+
+      .. ## Mask.overlap_mask ##
+
+   .. method:: fill
+
+      | :sl:`Sets all bits to 1`
+      | :sg:`fill() -> None`
+
+      Sets all bits in the mask to 1.
+
+      :returns: ``None``
+      :rtype: NoneType
+
+      .. ## Mask.fill ##
+
+   .. method:: clear
+
+      | :sl:`Sets all bits to 0`
+      | :sg:`clear() -> None`
+
+      Sets all bits in the mask to 0.
+
+      :returns: ``None``
+      :rtype: NoneType
+
+      .. ## Mask.clear ##
+
+   .. method:: invert
+
+      | :sl:`Flips all the bits`
+      | :sg:`invert() -> None`
+
+      Flips all of the bits in the mask. All the set bits are cleared to 0 and
+      all the unset bits are set to 1.
+
+      :returns: ``None``
+      :rtype: NoneType
+
+      .. ## Mask.invert ##
+
+   .. method:: scale
+
+      | :sl:`Resizes a mask`
+      | :sg:`scale((width, height)) -> Mask`
+
+      Creates a new :class:`Mask` of the requested size with its bits scaled
+      from this mask.
+
+      :param size: the width and height (size) of the mask to create
+
+      :returns: a new :class:`Mask` object with its bits scaled from this mask
+      :rtype: Mask
+
+      :raises ValueError: if ``width < 0`` or ``height < 0``
+
+      .. ## Mask.scale ##
+
+   .. method:: draw
+
+      | :sl:`Draws a mask onto another`
+      | :sg:`draw(other, offset) -> None`
+
+      Performs a bitwise OR, drawing ``othermask`` onto this mask.
+
+      :param Mask other: the mask to draw onto this mask
+      :param offset: the offset of ``other`` from this mask, for more
+         details refer to the :ref:`Mask offset notes `
+
+      :returns: ``None``
+      :rtype: NoneType
+
+      .. ## Mask.draw ##
+
+   .. method:: erase
+
+      | :sl:`Erases a mask from another`
+      | :sg:`erase(other, offset) -> None`
+
+      Erases (clears) all bits set in ``other`` from this mask.
+
+      :param Mask other: the mask to erase from this mask
+      :param offset: the offset of ``other`` from this mask, for more
+         details refer to the :ref:`Mask offset notes `
+
+      :returns: ``None``
+      :rtype: NoneType
+
+      .. ## Mask.erase ##
+
+   .. method:: count
+
+      | :sl:`Returns the number of set bits`
+      | :sg:`count() -> bits`
+
+      :returns: the number of set bits in the mask
+      :rtype: int
+
+      .. ## Mask.count ##
+
+   .. method:: centroid
+
+      | :sl:`Returns the centroid of the set bits`
+      | :sg:`centroid() -> (x, y)`
+
+      Finds the centroid (the center mass of the set bits) for this mask.
+
+      :returns: a coordinate tuple indicating the centroid of the mask, it will
+         return ``(0, 0)`` if the mask has no bits set
+      :rtype: tuple(int, int)
+
+      .. ## Mask.centroid ##
+
+   .. method:: angle
+
+      | :sl:`Returns the orientation of the set bits`
+      | :sg:`angle() -> theta`
+
+      Finds the approximate orientation (from -90 to 90 degrees) of the set bits
+      in the mask. This works best if performed on a mask with only one
+      connected component.
+
+      :returns: the orientation of the set bits in the mask, it will return
+         ``0.0`` if the mask has no bits set
+      :rtype: float
+
+      .. note::
+         See :meth:`connected_component` for details on how a connected
+         component is calculated.
+
+      .. ## Mask.angle ##
+
+   .. method:: outline
+
+      | :sl:`Returns a list of points outlining an object`
+      | :sg:`outline() -> [(x, y), ...]`
+      | :sg:`outline(every=1) -> [(x, y), ...]`
+
+      Returns a list of points of the outline of the first connected component
+      encountered in the mask. To find a connected component, the mask is
+      searched per row (left to right) starting in the top left corner.
+
+      The ``every`` optional parameter skips set bits in the outline. For
+      example, setting it to 10 would return a list of every 10th set bit in the
+      outline.
+
+      :param int every: (optional) indicates the number of bits to skip over in
+         the outline (default is 1)
+
+      :returns: a list of points outlining the first connected component
+         encountered, an empty list is returned if the mask has no bits set
+      :rtype: list[tuple(int, int)]
+
+      .. note::
+         See :meth:`connected_component` for details on how a connected
+         component is calculated.
+
+      .. ## Mask.outline ##
+
+   .. method:: convolve
+
+      | :sl:`Returns the convolution of this mask with another mask`
+      | :sg:`convolve(other) -> Mask`
+      | :sg:`convolve(other, output=None, offset=(0, 0)) -> Mask`
+
+      Convolve this mask with the given ``other`` Mask.
+
+      :param Mask other: mask to convolve this mask with
+      :param output: (optional) mask for output (default is ``None``)
+      :type output: Mask or NoneType
+      :param offset: the offset of ``other`` from this mask, (default is
+         ``(0, 0)``)
+
+      :returns: a :class:`Mask` with the ``(i - offset[0], j - offset[1])`` bit
+         set, if shifting ``other`` (such that its bottom right corner is at
+         ``(i, j)``) causes it to overlap with this mask
+
+         If an ``output`` Mask is specified, the output is drawn onto it and
+         it is returned. Otherwise a mask of size ``(MAX(0, width + other mask's
+         width - 1), MAX(0, height + other mask's height - 1))`` is created and
+         returned.
+      :rtype: Mask
+
+      .. ## Mask.convolve ##
+
+   .. method:: connected_component
+
+      | :sl:`Returns a mask containing a connected component`
+      | :sg:`connected_component() -> Mask`
+      | :sg:`connected_component(pos) -> Mask`
+
+      A connected component is a group (1 or more) of connected set bits
+      (orthogonally and diagonally). The SAUF algorithm, which checks 8 point
+      connectivity, is used to find a connected component in the mask.
+
+      By default this method will return a :class:`Mask` containing the largest
+      connected component in the mask. Optionally, a bit coordinate can be
+      specified and the connected component containing it will be returned. If
+      the bit at the given location is not set, the returned :class:`Mask` will
+      be empty (no bits set).
+
+      :param pos: (optional) selects the connected component that contains the
+         bit at this position
+
+      :returns: a :class:`Mask` object (same size as this mask) with the largest
+         connected component from this mask, if this mask has no bits set then
+         an empty mask will be returned
+
+         If the ``pos`` parameter is provided then the mask returned will have
+         the connected component that contains this position. An empty mask will
+         be returned if the ``pos`` parameter selects an unset bit.
+      :rtype: Mask
+
+      :raises IndexError: if the optional ``pos`` parameter is outside of the
+         mask's bounds
+
+      .. ## Mask.connected_component ##
+
+   .. method:: connected_components
+
+      | :sl:`Returns a list of masks of connected components`
+      | :sg:`connected_components() -> [Mask, ...]`
+      | :sg:`connected_components(minimum=0) -> [Mask, ...]`
+
+      Provides a list containing a :class:`Mask` object for each connected
+      component.
+
+      :param int minimum: (optional) indicates the minimum number of bits (to
+	 filter out noise) per connected component (default is 0, which equates
+ 	 to no minimum and is equivalent to setting it to 1, as a connected
+         component must have at least 1 bit set)
+
+      :returns: a list containing a :class:`Mask` object for each connected
+         component, an empty list is returned if the mask has no bits set
+      :rtype: list[Mask]
+
+      .. note::
+         See :meth:`connected_component` for details on how a connected
+         component is calculated.
+
+      .. ## Mask.connected_components ##
+
+   .. method:: get_bounding_rects
+
+      | :sl:`Returns a list of bounding rects of connected components`
+      | :sg:`get_bounding_rects() -> [Rect, ...]`
+
+      Provides a list containing a bounding rect for each connected component.
+
+      :returns: a list containing a bounding rect for each connected component,
+         an empty list is returned if the mask has no bits set
+      :rtype: list[Rect]
+
+      .. note::
+         See :meth:`connected_component` for details on how a connected
+         component is calculated.
+
+      .. ## Mask.get_bounding_rects ##
+
+   .. method:: to_surface
+
+      | :sl:`Returns a surface with the mask drawn on it`
+      | :sg:`to_surface() -> Surface`
+      | :sg:`to_surface(surface=None, setsurface=None, unsetsurface=None, setcolor=(255, 255, 255, 255), unsetcolor=(0, 0, 0, 255), dest=(0, 0)) -> Surface`
+
+      Draws this mask on the given surface. Set bits (bits set to 1) and unset
+      bits (bits set to 0) can be drawn onto a surface.
+
+      :param surface: (optional) Surface to draw mask onto, if no surface is
+         provided one will be created (default is ``None``, which will cause a
+         surface with the parameters
+         ``Surface(size=mask.get_size(), flags=SRCALPHA, depth=32)`` to be
+         created, drawn on, and returned)
+      :type surface: Surface or None
+      :param setsurface: (optional) use this surface's color values to draw
+         set bits (default is ``None``), if this surface is smaller than the
+         mask any bits outside its bounds will use the ``setcolor`` value
+      :type setsurface: Surface or None
+      :param unsetsurface: (optional) use this surface's color values to draw
+         unset bits (default is ``None``), if this surface is smaller than the
+         mask any bits outside its bounds will use the ``unsetcolor`` value
+      :type unsetsurface: Surface or None
+      :param setcolor: (optional) color to draw set bits (default is
+         ``(255, 255, 255, 255)``, white), use ``None`` to skip drawing the set
+         bits, the ``setsurface`` parameter (if set) will takes precedence over
+         this parameter
+      :type setcolor: Color or str or int or tuple(int, int, int, [int]) or
+         list(int, int, int, [int]) or None
+      :param unsetcolor: (optional) color to draw unset bits (default is
+         ``(0, 0, 0, 255)``, black), use ``None`` to skip drawing the unset
+         bits, the ``unsetsurface`` parameter (if set) will takes precedence
+         over this parameter
+      :type unsetcolor: Color or str or int or tuple(int, int, int, [int]) or
+         list(int, int, int, [int]) or None
+      :param dest: (optional) surface destination of where to position the
+         topleft corner of the mask being drawn (default is ``(0, 0)``), if a
+         Rect is used as the ``dest`` parameter, its ``x`` and ``y`` attributes
+         will be used as the destination, **NOTE1:** rects with a negative width
+         or height value will not be normalized before using their ``x`` and
+         ``y`` values, **NOTE2:** this destination value is only used to
+         position the mask on the surface, it does not offset the ``setsurface``
+         and ``unsetsurface`` from the mask, they are always aligned with the
+         mask (i.e. position ``(0, 0)`` on the mask always corresponds to
+         position ``(0, 0)`` on the ``setsurface`` and ``unsetsurface``)
+      :type dest: Rect or tuple(int, int) or list(int, int) or Vector2(int, int)
+
+      :returns: the ``surface`` parameter (or a newly created surface if no
+         ``surface`` parameter was provided) with this mask drawn on it
+      :rtype: Surface
+
+      :raises ValueError: if the ``setsurface`` parameter or ``unsetsurface``
+         parameter does not have the same format (bytesize/bitsize/alpha) as
+         the ``surface`` parameter
+
+      .. note ::
+         To skip drawing the set bits, both ``setsurface`` and ``setcolor`` must
+         be ``None``. The ``setsurface`` parameter defaults to ``None``, but
+         ``setcolor`` defaults to a color value and therefore must be set to
+         ``None``.
+
+      .. note ::
+         To skip drawing the unset bits, both ``unsetsurface`` and
+         ``unsetcolor`` must be ``None``. The ``unsetsurface`` parameter
+         defaults to ``None``, but ``unsetcolor`` defaults to a color value and
+         therefore must be set to ``None``.
+
+      .. versionadded:: 2.0.0
+
+      .. ## Mask.to_surface ##
+
+   .. ## pygame.mask.Mask ##
+
+.. ## pygame.mask ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/math.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/math.rst.txt
index c460175..0f037d9 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/math.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/math.rst.txt
@@ -3,17 +3,100 @@
 :mod:`pygame.math`
 ==================
 
-.. autopgmodule:: pygame.math
+.. module:: pygame.math
+   :synopsis: pygame module for vector classes
 
-.. autopgfunction:: clamp
+| :sl:`pygame module for vector classes`
 
-.. autopgfunction:: lerp
+The pygame math module currently provides Vector classes in two and three
+dimensions, ``Vector2`` and ``Vector3`` respectively.
 
-.. autopgfunction:: invlerp
+They support the following numerical operations: ``vec + vec``, ``vec - vec``, 
+``vec * number``, ``number * vec``, ``vec / number``, ``vec // number``, ``vec += vec``, 
+``vec -= vec``, ``vec *= number``, ``vec /= number``, ``vec //= number``, ``round(vec, ndigits=0)``. 
 
-.. autopgfunction:: smoothstep
+All these operations will be performed elementwise.
+In addition ``vec * vec`` will perform a scalar-product (a.k.a. dot-product). 
+If you want to multiply every element from vector v with every element from 
+vector w you can use the elementwise method: ``v.elementwise() * w``
 
-.. autopgfunction:: remap
+The coordinates of a vector can be retrieved or set using attributes or
+subscripts
+
+::
+
+   v = pygame.Vector3()
+
+   v.x = 5
+   v[1] = 2 * v.x
+   print(v[1]) # 10
+
+   v.x == v[0]
+   v.y == v[1]
+   v.z == v[2]
+
+Multiple coordinates can be set using slices or swizzling
+
+::
+
+   v = pygame.Vector2()
+   v.xy = 1, 2
+   v[:] = 1, 2
+
+.. versionadded:: 1.9.2pre
+.. versionchanged:: 1.9.4 Removed experimental notice.
+.. versionchanged:: 1.9.4 Allow scalar construction like GLSL Vector2(2) == Vector2(2.0, 2.0)
+.. versionchanged:: 1.9.4 :mod:`pygame.math` import not required. More convenient ``pygame.Vector2`` and ``pygame.Vector3``.
+.. versionchanged:: 2.2.0 `round` returns a new vector with components rounded to the specified digits.
+
+.. function:: clamp
+
+   | :sl:`returns value clamped to min and max.`
+   | :sg:`clamp(value, min, max) -> float`
+
+   **Experimental:** feature still in development available for testing and feedback. It may change.
+   `Please leave clamp feedback with authors `_
+
+   Clamps a numeric ``value`` so that it's no lower than ``min``, and no higher
+   than ``max``.
+
+   .. versionadded:: 2.1.3
+
+   .. ## math.clamp ##
+
+.. function:: lerp
+
+   | :sl:`interpolates between two values by a weight.`
+   | :sg:`lerp(a, b, weight) -> float`
+
+   Linearly interpolates between ``a`` and ``b`` by ``weight`` using the formula ``a + (b-a) * weight``.
+   
+   If ``weight`` is ``0.5``, ``lerp`` will return the value half-way between ``a``
+   and ``b``. When ``a = 10`` and ``b = 20``, ``lerp(a, b, 0.5)`` will return ``15``. You
+   can think of weight as the percentage of interpolation from ``a`` to ``b``, ``0.0``
+   being 0% and ``1.0`` being 100%.
+
+   ``lerp`` can be used for many things. You could rotate a sprite by a weight with
+   ``angle = lerp(0, 360, weight)``. You could even scale an enemy's attack value
+   based on the level you're playing:
+
+   ::
+
+      FINAL_LEVEL = 10
+      current_level = 2
+
+      attack = lerp(10, 50, current_level/MAX_LEVEL) # 18
+
+   If you're on level 0, ``attack`` will be ``10``, if you're on level 10,
+   ``attack`` will be ``50``. If you're on level 5, the
+   result of ``current_level/MAX_LEVEL`` will be ``0.5``
+   which represents 50%, therefore ``attack`` will be ``30``, which is the midpoint of ``10`` and ``50``.
+
+   Raises a ValueError if ``weight`` is outside the range of ``[0, 1]``.
+
+   .. versionadded:: 2.1.3
+
+   .. ## math.lerp ##
 
 .. class:: Vector2
 
@@ -25,21 +108,23 @@
    | :sg:`Vector2(x, y) -> Vector2`
    | :sg:`Vector2((x, y)) -> Vector2`
 
-   .. versionchanged:: 2.1.3
-      Inherited methods of vector subclasses now correctly return an instance of the
+   Some general information about the ``Vector2`` class.
+
+   .. versionchanged:: 2.1.3 
+      Inherited methods of vector subclasses now correctly return an instance of the 
       subclass instead of the superclass
 
    .. method:: dot
 
       | :sl:`calculates the dot- or scalar-product with the other vector`
-      | :sg:`dot(Vector2, /) -> float`
+      | :sg:`dot(Vector2) -> float`
 
       .. ## Vector2.dot ##
 
    .. method:: cross
 
       | :sl:`calculates the cross- or vector-product`
-      | :sg:`cross(Vector2, /) -> float`
+      | :sg:`cross(Vector2) -> float`
 
       calculates the third component of the cross-product.
 
@@ -82,7 +167,7 @@
       | :sg:`length_squared() -> float`
 
       calculates the Euclidean length of the vector which follows from the
-      Pythagorean theorem: ``vec.length_squared() == vec.x**2 + vec.y**2``.
+      Pythagorean theorem: ``vec.length_squared() == vec.x**2 + vec.y**2``. 
       This is faster than ``vec.length()`` because it avoids the square root.
 
       .. ## Vector2.length_squared ##
@@ -92,9 +177,8 @@
       | :sl:`returns a vector with the same direction but length 1.`
       | :sg:`normalize() -> Vector2`
 
-      Returns a new vector that has ``length`` equal to ``1`` and the same
-      direction as self. If the vector is the zero vector (i.e. has length
-      ``0`` thus no direction) a ``ValueError`` is raised.
+      Returns a new vector that has ``length`` equal to ``1`` and the same 
+      direction as self.
 
       .. ## Vector2.normalize ##
 
@@ -103,19 +187,17 @@
       | :sl:`normalizes the vector in place so that its length is 1.`
       | :sg:`normalize_ip() -> None`
 
-      Normalizes the vector so that it has ``length`` equal to ``1``.
-      The direction of the vector is not changed. If the vector is the zero
-      vector (i.e. has length ``0`` thus no direction) a ``ValueError`` is
-      raised.
+      Normalizes the vector so that it has ``length`` equal to ``1``. 
+      The direction of the vector is not changed.
 
       .. ## Vector2.normalize_ip ##
 
    .. method:: is_normalized
 
       | :sl:`tests if the vector is normalized i.e. has length == 1.`
-      | :sg:`is_normalized() -> bool`
+      | :sg:`is_normalized() -> Bool`
 
-      Returns True if the vector has ``length`` equal to ``1``. Otherwise
+      Returns True if the vector has ``length`` equal to ``1``. Otherwise 
       it returns ``False``.
 
       .. ## Vector2.is_normalized ##
@@ -123,10 +205,10 @@
    .. method:: scale_to_length
 
       | :sl:`scales the vector to a given length.`
-      | :sg:`scale_to_length(float, /) -> None`
+      | :sg:`scale_to_length(float) -> None`
 
       Scales the vector so that it has the given length. The direction of the
-      vector is not changed. You can also scale to length ``0``. If the vector
+      vector is not changed. You can also scale to length ``0``. If the vector 
       is the zero vector (i.e. has length ``0`` thus no direction) a
       ``ValueError`` is raised.
 
@@ -135,7 +217,7 @@
    .. method:: reflect
 
       | :sl:`returns a vector reflected of a given normal.`
-      | :sg:`reflect(Vector2, /) -> Vector2`
+      | :sg:`reflect(Vector2) -> Vector2`
 
       Returns a new vector that points in the direction as if self would bounce
       of a surface characterized by the given surface normal. The length of the
@@ -146,7 +228,7 @@
    .. method:: reflect_ip
 
       | :sl:`reflect the vector of a given normal in place.`
-      | :sg:`reflect_ip(Vector2, /) -> None`
+      | :sg:`reflect_ip(Vector2) -> None`
 
       Changes the direction of self as if it would have been reflected of a
       surface with the given surface normal.
@@ -156,21 +238,24 @@
    .. method:: distance_to
 
       | :sl:`calculates the Euclidean distance to a given vector.`
-      | :sg:`distance_to(Vector2, /) -> float`
+      | :sg:`distance_to(Vector2) -> float`
 
       .. ## Vector2.distance_to ##
 
    .. method:: distance_squared_to
 
       | :sl:`calculates the squared Euclidean distance to a given vector.`
-      | :sg:`distance_squared_to(Vector2, /) -> float`
+      | :sg:`distance_squared_to(Vector2) -> float`
 
       .. ## Vector2.distance_squared_to ##
 
    .. method:: move_towards
 
       | :sl:`returns a vector moved toward the target by a given distance.`
-      | :sg:`move_towards(Vector2, float, /) -> Vector2`
+      | :sg:`move_towards(Vector2, float) -> Vector2`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave move_towards feedback with authors `_
 
       Returns a Vector which is moved towards the given Vector by a given
       distance and does not overshoot past its target Vector.
@@ -185,7 +270,10 @@
    .. method:: move_towards_ip
 
       | :sl:`moves the vector toward its target at a given distance.`
-      | :sg:`move_towards_ip(Vector2, float, /) -> None`
+      | :sg:`move_towards_ip(Vector2, float) -> None`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave move_towards_ip feedback with authors `_
 
       Moves itself toward the given Vector at a given distance and does not
       overshoot past its target Vector.
@@ -200,19 +288,19 @@
    .. method:: lerp
 
       | :sl:`returns a linear interpolation to the given vector.`
-      | :sg:`lerp(Vector2, float, /) -> Vector2`
+      | :sg:`lerp(Vector2, float) -> Vector2`
 
       Returns a Vector which is a linear interpolation between self and the
       given Vector. The second parameter determines how far between self and
-      other the result is going to be. It must be a value between ``0`` and
-      ``1``, where ``0`` means self and ``1`` means other will be returned.
+      other the result is going to be. It must be a value between ``0`` and ``1`` 
+      where ``0`` means self and ``1`` means other will be returned.
 
       .. ## Vector2.lerp ##
 
    .. method:: slerp
 
       | :sl:`returns a spherical interpolation to the given vector.`
-      | :sg:`slerp(Vector2, float, /) -> Vector2`
+      | :sg:`slerp(Vector2, float) -> Vector2`
 
       Calculates the spherical interpolation from self to the given Vector. The
       second argument - often called t - must be in the range ``[-1, 1]``. It
@@ -222,29 +310,6 @@
 
       .. ## Vector2.slerp ##
 
-   .. method:: smoothstep
-
-      | :sl:`returns a smooth interpolation to the given vector.`
-      | :sg:`smoothstep(Vector2, value, /) -> Vector2`
-
-      Returns a Vector which is a smooth interpolation between self and the
-      given Vector. This means that the interpolation follows an s-shaped curve, with
-      change happening more slowly near the limits (0.0 and 1.0) and faster in the middle.
-      The second parameter determines how far between the two vectors the result is going to be.
-      Value is clamped to ``[0, 1]``.
-
-      The formula is:
-
-      ``a * (1 - interp) + b * interp``
-
-      where:
-
-      ``interp = value * value * (3 - 2 * value)``
-
-      .. versionadded:: 2.4.0
-
-      .. ## Vector2.smoothstep ##
-
    .. method:: elementwise
 
       | :sl:`The next operation will be performed elementwise.`
@@ -257,7 +322,7 @@
    .. method:: rotate
 
       | :sl:`rotates a vector by a given angle in degrees.`
-      | :sg:`rotate(angle, /) -> Vector2`
+      | :sg:`rotate(angle) -> Vector2`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise by the given angle in degrees.
@@ -269,21 +334,21 @@
    .. method:: rotate_rad
 
       | :sl:`rotates a vector by a given angle in radians.`
-      | :sg:`rotate_rad(angle, /) -> Vector2`
+      | :sg:`rotate_rad(angle) -> Vector2`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise by the given angle in radians.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Vector2.rotate_rad ##
 
    .. method:: rotate_ip
 
       | :sl:`rotates the vector by a given angle in degrees in place.`
-      | :sg:`rotate_ip(angle, /) -> None`
+      | :sg:`rotate_ip(angle) -> None`
 
       Rotates the vector counterclockwise by the given angle in degrees. The
       length of the vector is not changed.
@@ -295,36 +360,36 @@
    .. method:: rotate_ip_rad
 
       | :sl:`rotates the vector by a given angle in radians in place.`
-      | :sg:`rotate_ip_rad(angle, /) -> None`
+      | :sg:`rotate_ip_rad(angle) -> None`
 
       DEPRECATED: Use rotate_rad_ip() instead.
 
-      .. versionaddedold:: 2.0.0
-      .. deprecatedold:: 2.1.1
+      .. versionadded:: 2.0.0
+      .. deprecated:: 2.1.1
 
       .. ## Vector2.rotate_rad_ip ##
 
    .. method:: rotate_rad_ip
 
       | :sl:`rotates the vector by a given angle in radians in place.`
-      | :sg:`rotate_rad_ip(angle, /) -> None`
+      | :sg:`rotate_rad_ip(angle) -> None`
 
       Rotates the vector counterclockwise by the given angle in radians. The
       length of the vector is not changed.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       .. ## Vector2.rotate_rad_ip ##
 
    .. method:: angle_to
 
       | :sl:`calculates the angle to a given vector in degrees.`
-      | :sg:`angle_to(Vector2, /) -> float`
+      | :sg:`angle_to(Vector2) -> float`
 
       Returns the angle from self to the passed ``Vector2`` that would rotate self
-      to be aligned with the passed ``Vector2`` without crossing over the negative
+      to be aligned with the passed ``Vector2`` without crossing over the negative 
       x-axis.
 
       .. figure:: code_examples/angle_to.png
@@ -339,34 +404,36 @@
       | :sl:`returns a tuple with radial distance and azimuthal angle.`
       | :sg:`as_polar() -> (r, phi)`
 
-      Returns a tuple ``(r, phi)`` where r is the radial distance, and phi
+      Returns a tuple ``(r, phi)`` where r is the radial distance, and phi 
       is the azimuthal angle.
 
       .. ## Vector2.as_polar ##
 
    .. method:: from_polar
 
-      | :sl:`Sets x and y from a polar coordinates tuple.`
-      | :sg:`from_polar((r, phi), /) -> None`
+      | :sl:`Creates a Vector2(x, y) or sets x and y from a polar coordinates tuple.`
+      | :sg:`Vector2.from_polar((r, phi)) -> Vector2`
+      | :sg:`Vector2().from_polar((r, phi)) -> None`
 
-      Sets x and y from a tuple (r, phi) where r is the radial distance, and
-      phi is the azimuthal angle.
+      If used from the class creates a Vector2(x,y), else sets x and y.
+      The values of x and y are defined from a tuple ``(r, phi)`` where r
+      is the radial distance, and phi is the azimuthal angle.
 
       .. ## Vector2.from_polar ##
 
    .. method:: project
 
       | :sl:`projects a vector onto another.`
-      | :sg:`project(Vector2, /) -> Vector2`
+      | :sg:`project(Vector2) -> Vector2`
 
-      Returns the projected vector. This is useful for collision detection in finding the components in a certain direction (e.g. in direction of the wall).
+      Returns the projected vector. This is useful for collision detection in finding the components in a certain direction (e.g. in direction of the wall). 
       For a more detailed explanation see `Wikipedia `_.
 
-      .. versionaddedold:: 2.0.2
+      .. versionadded:: 2.0.2
 
       .. ## Vector2.project ##
 
-
+   
    .. method:: copy
 
       | :sl:`Returns a copy of itself.`
@@ -374,19 +441,22 @@
 
       Returns a new Vector2 having the same dimensions.
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       .. ## Vector2.copy ##
-
+   
 
    .. method:: clamp_magnitude
 
       | :sl:`Returns a copy of a vector with the magnitude clamped between max_length and min_length.`
-      | :sg:`clamp_magnitude(max_length, /) -> Vector2`
-      | :sg:`clamp_magnitude(min_length, max_length, /) -> Vector2`
+      | :sg:`clamp_magnitude(max_length) -> Vector2`
+      | :sg:`clamp_magnitude(min_length, max_length) -> Vector2`
 
-      Returns a new copy of a vector with the magnitude clamped between
-      ``max_length`` and ``min_length``. If only one argument is passed, it is
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave clamp_magnitude feedback with authors `_
+
+      Returns a new copy of a vector with the magnitude clamped between 
+      ``max_length`` and ``min_length``. If only one argument is passed, it is 
       taken to be the ``max_length``
 
       This function raises ``ValueError`` if ``min_length`` is greater than
@@ -394,20 +464,17 @@
 
       .. versionadded:: 2.1.3
 
-      .. versionchanged:: 2.4.0 It is now possible to use ``clamp_magnitude`` on a zero-vector as long as ``min_length``
-         is unspecified or 0.
-
-      .. note::
-         Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ``ValueError``
-
       .. ## Vector2.clamp_magnitude ##
-
+   
 
    .. method:: clamp_magnitude_ip
 
       | :sl:`Clamps the vector's magnitude between max_length and min_length`
-      | :sg:`clamp_magnitude_ip(max_length, /) -> None`
-      | :sg:`clamp_magnitude_ip(min_length, max_length, /) -> None`
+      | :sg:`clamp_magnitude_ip(max_length) -> None`
+      | :sg:`clamp_magnitude_ip(min_length, max_length) -> None`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave clamp_magnitude_ip feedback with authors `_
 
       Clamps the vector's magnitude between ``max_length`` and ``min_length``.
       If only one argument is passed, it is taken to be the ``max_length``
@@ -417,12 +484,6 @@
 
       .. versionadded:: 2.1.3
 
-      .. versionchanged:: 2.4.0 It is now possible to use ``clamp_magnitude`` on a zero-vector as long as ``min_length``
-         is unspecified or 0.
-
-      .. note::
-         Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ``ValueError``
-
       .. ## Vector2.clamp_magnitude_ip ##
 
 
@@ -438,15 +499,15 @@
 
       Sets coordinates x and y in place.
 
-      .. versionaddedold:: 1.9.5
+      .. versionadded:: 1.9.5
 
       .. ## Vector2.update ##
 
-
+   
    .. attribute:: epsilon
-
+      
       | :sl:`Determines the tolerance of vector calculations.`
-
+      
       Both Vector classes have a value named ``epsilon`` that defaults to ``1e-6``.
       This value acts as a numerical margin in various methods to account for floating point
       arithmetic errors. Specifically, ``epsilon`` is used in the following places:
@@ -472,30 +533,9 @@
          print(v == u) # >> False
 
       You'll probably never have to change ``epsilon`` from the default value, but in rare situations you might
-      find that either the margin is too large or too small, in which case changing ``epsilon`` slightly
+      find that either the margin is too large or too small, in which case changing ``epsilon`` slightly 
       might help you out.
 
-   .. attribute:: angle
-
-      | :sl:`Gives the angle of the vector in degrees, relative to the X-axis, normalized to the interval [-180, 180].`
-
-      Read-only attribute representing the angle of the vector in degrees relative to the X-axis. This angle is normalized to
-      the interval [-180, 180].
-
-      Usage: Accessing `angle` provides the current angle of the vector in degrees within the predefined range of [-180, 180].
-
-      .. versionadded:: 2.5.5
-
-   .. attribute:: angle_rad
-
-      | :sl:`Gives the angle of the vector in radians, relative to the X-axis, normalized to the interval [-π, π].`
-
-      Read-only attribute representing the angle of the vector in radians relative to the X-axis. This value is equivalent
-      to the `angle` attribute converted to radians and is normalized to the interval [-π, π].
-
-      Usage: Accessing `angle_rad` provides the current angle of the vector in radians within the predefined range of [-π, π].
-
-      .. versionadded:: 2.5.5
 
    .. ## pygame.math.Vector2 ##
 
@@ -509,21 +549,23 @@
    | :sg:`Vector3(x, y, z) -> Vector3`
    | :sg:`Vector3((x, y, z)) -> Vector3`
 
-   .. versionchanged:: 2.1.3
-      Inherited methods of vector subclasses now correctly return an instance of the
+   Some general information about the Vector3 class.
+
+   .. versionchanged:: 2.1.3 
+      Inherited methods of vector subclasses now correctly return an instance of the 
       subclass instead of the superclass
 
    .. method:: dot
 
       | :sl:`calculates the dot- or scalar-product with the other vector`
-      | :sg:`dot(Vector3, /) -> float`
+      | :sg:`dot(Vector3) -> float`
 
       .. ## Vector3.dot ##
 
    .. method:: cross
 
       | :sl:`calculates the cross- or vector-product`
-      | :sg:`cross(Vector3, /) -> Vector3`
+      | :sg:`cross(Vector3) -> Vector3`
 
       calculates the cross-product.
 
@@ -545,7 +587,7 @@
       | :sg:`magnitude_squared() -> float`
 
       calculates the magnitude of the vector which follows from the
-      theorem:
+      theorem: 
       ``vec.magnitude_squared() == vec.x**2 + vec.y**2 + vec.z**2``.
       This is faster than ``vec.magnitude()`` because it avoids the
       square root.
@@ -558,7 +600,7 @@
       | :sg:`length() -> float`
 
       calculates the Euclidean length of the vector which follows from the
-      Pythagorean theorem:
+      Pythagorean theorem: 
       ``vec.length() == math.sqrt(vec.x**2 + vec.y**2 + vec.z**2)``
 
       .. ## Vector3.length ##
@@ -569,8 +611,8 @@
       | :sg:`length_squared() -> float`
 
       calculates the Euclidean length of the vector which follows from the
-      Pythagorean theorem:
-      ``vec.length_squared() == vec.x**2 + vec.y**2 + vec.z**2``.
+      Pythagorean theorem: 
+      ``vec.length_squared() == vec.x**2 + vec.y**2 + vec.z**2``. 
       This is faster than ``vec.length()`` because it avoids the square root.
 
       .. ## Vector3.length_squared ##
@@ -580,9 +622,8 @@
       | :sl:`returns a vector with the same direction but length 1.`
       | :sg:`normalize() -> Vector3`
 
-      Returns a new vector that has ``length`` equal to ``1`` and the same
-      direction as self. If the vector is the zero vector (i.e. has length
-      ``0`` thus no direction) a ``ValueError`` is raised.
+      Returns a new vector that has ``length`` equal to ``1`` and the same 
+      direction as self.
 
       .. ## Vector3.normalize ##
 
@@ -591,18 +632,17 @@
       | :sl:`normalizes the vector in place so that its length is 1.`
       | :sg:`normalize_ip() -> None`
 
-      Normalizes the vector so that it has ``length`` equal to ``1``. The
-      direction of the vector is not changed. If the vector is the zero vector
-      (i.e. has length ``0`` thus no direction) a ``ValueError`` is raised.
+      Normalizes the vector so that it has ``length`` equal to ``1``. The 
+      direction of the vector is not changed.
 
       .. ## Vector3.normalize_ip ##
 
    .. method:: is_normalized
 
       | :sl:`tests if the vector is normalized i.e. has length == 1.`
-      | :sg:`is_normalized() -> bool`
+      | :sg:`is_normalized() -> Bool`
 
-      Returns True if the vector has ``length`` equal to ``1``. Otherwise it
+      Returns True if the vector has ``length`` equal to ``1``. Otherwise it 
       returns ``False``.
 
       .. ## Vector3.is_normalized ##
@@ -610,10 +650,10 @@
    .. method:: scale_to_length
 
       | :sl:`scales the vector to a given length.`
-      | :sg:`scale_to_length(float, /) -> None`
+      | :sg:`scale_to_length(float) -> None`
 
       Scales the vector so that it has the given length. The direction of the
-      vector is not changed. You can also scale to length ``0``. If the vector
+      vector is not changed. You can also scale to length ``0``. If the vector 
       is the zero vector (i.e. has length ``0`` thus no direction) a
       ``ValueError`` is raised.
 
@@ -622,7 +662,7 @@
    .. method:: reflect
 
       | :sl:`returns a vector reflected of a given normal.`
-      | :sg:`reflect(Vector3, /) -> Vector3`
+      | :sg:`reflect(Vector3) -> Vector3`
 
       Returns a new vector that points in the direction as if self would bounce
       of a surface characterized by the given surface normal. The length of the
@@ -633,7 +673,7 @@
    .. method:: reflect_ip
 
       | :sl:`reflect the vector of a given normal in place.`
-      | :sg:`reflect_ip(Vector3, /) -> None`
+      | :sg:`reflect_ip(Vector3) -> None`
 
       Changes the direction of self as if it would have been reflected of a
       surface with the given surface normal.
@@ -643,21 +683,24 @@
    .. method:: distance_to
 
       | :sl:`calculates the Euclidean distance to a given vector.`
-      | :sg:`distance_to(Vector3, /) -> float`
+      | :sg:`distance_to(Vector3) -> float`
 
       .. ## Vector3.distance_to ##
 
    .. method:: distance_squared_to
 
       | :sl:`calculates the squared Euclidean distance to a given vector.`
-      | :sg:`distance_squared_to(Vector3, /) -> float`
+      | :sg:`distance_squared_to(Vector3) -> float`
 
       .. ## Vector3.distance_squared_to ##
 
    .. method:: move_towards
 
       | :sl:`returns a vector moved toward the target by a given distance.`
-      | :sg:`move_towards(Vector3, float, /) -> Vector3`
+      | :sg:`move_towards(Vector3, float) -> Vector3`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave move_towards feedback with authors `_
 
       Returns a Vector which is moved towards the given Vector by a given
       distance and does not overshoot past its target Vector.
@@ -672,7 +715,10 @@
    .. method:: move_towards_ip
 
       | :sl:`moves the vector toward its target at a given distance.`
-      | :sg:`move_towards_ip(Vector3, float, /) -> None`
+      | :sg:`move_towards_ip(Vector3, float) -> None`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave move_towards_ip feedback with authors `_
 
       Moves itself toward the given Vector at a given distance and does not
       overshoot past its target Vector.
@@ -687,11 +733,11 @@
    .. method:: lerp
 
       | :sl:`returns a linear interpolation to the given vector.`
-      | :sg:`lerp(Vector3, float, /) -> Vector3`
+      | :sg:`lerp(Vector3, float) -> Vector3`
 
       Returns a Vector which is a linear interpolation between self and the
-      given Vector. The second parameter determines how far between self and
-      other the result is going to be. It must be a value between ``0`` and
+      given Vector. The second parameter determines how far between self an
+      other the result is going to be. It must be a value between ``0`` and 
       ``1``, where ``0`` means self and ``1`` means other will be returned.
 
       .. ## Vector3.lerp ##
@@ -699,7 +745,7 @@
    .. method:: slerp
 
       | :sl:`returns a spherical interpolation to the given vector.`
-      | :sg:`slerp(Vector3, float, /) -> Vector3`
+      | :sg:`slerp(Vector3, float) -> Vector3`
 
       Calculates the spherical interpolation from self to the given Vector. The
       second argument - often called t - must be in the range ``[-1, 1]``. It
@@ -709,29 +755,6 @@
 
       .. ## Vector3.slerp ##
 
-   .. method:: smoothstep
-
-      | :sl:`returns a smooth interpolation to the given vector.`
-      | :sg:`smoothstep(Vector3, value, /) -> Vector3`
-
-      Returns a Vector which is a smooth interpolation between self and the
-      given Vector. This means that the interpolation follows an s-shaped curve, with
-      change happening more slowly near the limits (0.0 and 1.0) and faster in the middle.
-      The second parameter determines how far between the two vectors the result is going to be.
-      Value is clamped to ``[0, 1]``.
-
-      The formula is:
-
-      ``a * (1 - interp) + b * interp``
-
-      where:
-
-      ``interp = value * value * (3 - 2 * value)``
-
-      .. versionadded:: 2.4.0
-
-      .. ## Vector3.smoothstep ##
-
    .. method:: elementwise
 
       | :sl:`The next operation will be performed elementwise.`
@@ -744,7 +767,7 @@
    .. method:: rotate
 
       | :sl:`rotates a vector by a given angle in degrees.`
-      | :sg:`rotate(angle, Vector3, /) -> Vector3`
+      | :sg:`rotate(angle, Vector3) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise by the given angle in degrees around the given axis.
@@ -756,21 +779,21 @@
    .. method:: rotate_rad
 
       | :sl:`rotates a vector by a given angle in radians.`
-      | :sg:`rotate_rad(angle, Vector3, /) -> Vector3`
+      | :sg:`rotate_rad(angle, Vector3) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise by the given angle in radians around the given axis.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Vector3.rotate_rad ##
 
    .. method:: rotate_ip
 
       | :sl:`rotates the vector by a given angle in degrees in place.`
-      | :sg:`rotate_ip(angle, Vector3, /) -> None`
+      | :sg:`rotate_ip(angle, Vector3) -> None`
 
       Rotates the vector counterclockwise around the given axis by the given
       angle in degrees. The length of the vector is not changed.
@@ -782,33 +805,33 @@
    .. method:: rotate_ip_rad
 
       | :sl:`rotates the vector by a given angle in radians in place.`
-      | :sg:`rotate_ip_rad(angle, Vector3, /) -> None`
+      | :sg:`rotate_ip_rad(angle, Vector3) -> None`
 
       DEPRECATED: Use rotate_rad_ip() instead.
 
-      .. versionaddedold:: 2.0.0
-      .. deprecatedold:: 2.1.1
+      .. versionadded:: 2.0.0
+      .. deprecated:: 2.1.1
 
       .. ## Vector3.rotate_ip_rad ##
 
    .. method:: rotate_rad_ip
 
       | :sl:`rotates the vector by a given angle in radians in place.`
-      | :sg:`rotate_rad_ip(angle, Vector3, /) -> None`
+      | :sg:`rotate_rad_ip(angle, Vector3) -> None`
 
       Rotates the vector counterclockwise around the given axis by the given
       angle in radians. The length of the vector is not changed.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       .. ## Vector3.rotate_rad_ip ##
 
    .. method:: rotate_x
 
       | :sl:`rotates a vector around the x-axis by the angle in degrees.`
-      | :sg:`rotate_x(angle, /) -> Vector3`
+      | :sg:`rotate_x(angle) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise around the x-axis by the given angle in degrees.
@@ -820,21 +843,21 @@
    .. method:: rotate_x_rad
 
       | :sl:`rotates a vector around the x-axis by the angle in radians.`
-      | :sg:`rotate_x_rad(angle, /) -> Vector3`
+      | :sg:`rotate_x_rad(angle) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise around the x-axis by the given angle in radians.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Vector3.rotate_x_rad ##
 
    .. method:: rotate_x_ip
 
       | :sl:`rotates the vector around the x-axis by the angle in degrees in place.`
-      | :sg:`rotate_x_ip(angle, /) -> None`
+      | :sg:`rotate_x_ip(angle) -> None`
 
       Rotates the vector counterclockwise around the x-axis by the given angle
       in degrees. The length of the vector is not changed.
@@ -846,33 +869,33 @@
    .. method:: rotate_x_ip_rad
 
       | :sl:`rotates the vector around the x-axis by the angle in radians in place.`
-      | :sg:`rotate_x_ip_rad(angle, /) -> None`
+      | :sg:`rotate_x_ip_rad(angle) -> None`
 
       DEPRECATED: Use rotate_x_rad_ip() instead.
 
-      .. versionaddedold:: 2.0.0
-      .. deprecatedold:: 2.1.1
+      .. versionadded:: 2.0.0
+      .. deprecated:: 2.1.1
 
       .. ## Vector3.rotate_x_ip_rad ##
 
    .. method:: rotate_x_rad_ip
 
       | :sl:`rotates the vector around the x-axis by the angle in radians in place.`
-      | :sg:`rotate_x_rad_ip(angle, /) -> None`
+      | :sg:`rotate_x_rad_ip(angle) -> None`
 
       Rotates the vector counterclockwise around the x-axis by the given angle
       in radians. The length of the vector is not changed.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       .. ## Vector3.rotate_x_rad_ip ##
 
    .. method:: rotate_y
 
       | :sl:`rotates a vector around the y-axis by the angle in degrees.`
-      | :sg:`rotate_y(angle, /) -> Vector3`
+      | :sg:`rotate_y(angle) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise around the y-axis by the given angle in degrees.
@@ -884,21 +907,21 @@
    .. method:: rotate_y_rad
 
       | :sl:`rotates a vector around the y-axis by the angle in radians.`
-      | :sg:`rotate_y_rad(angle, /) -> Vector3`
+      | :sg:`rotate_y_rad(angle) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise around the y-axis by the given angle in radians.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Vector3.rotate_y_rad ##
 
    .. method:: rotate_y_ip
 
       | :sl:`rotates the vector around the y-axis by the angle in degrees in place.`
-      | :sg:`rotate_y_ip(angle, /) -> None`
+      | :sg:`rotate_y_ip(angle) -> None`
 
       Rotates the vector counterclockwise around the y-axis by the given angle
       in degrees. The length of the vector is not changed.
@@ -910,37 +933,33 @@
    .. method:: rotate_y_ip_rad
 
       | :sl:`rotates the vector around the y-axis by the angle in radians in place.`
-      | :sg:`rotate_y_ip_rad(angle, /) -> None`
+      | :sg:`rotate_y_ip_rad(angle) -> None`
 
       DEPRECATED: Use rotate_y_rad_ip() instead.
 
-      .. versionaddedold:: 2.0.0
-      .. deprecatedold:: 2.1.1
-      .. versionchanged:: 2.5.8
-         Fixed a regression introduced in 2.1.1 where this method incorrectly rotated
-         around the X-axis instead of the Y-axis. In versions prior to 2.1.1, rotation
-         around the Y-axis worked correctly.
+      .. versionadded:: 2.0.0
+      .. deprecated:: 2.1.1
 
       .. ## Vector3.rotate_y_ip_rad ##
 
    .. method:: rotate_y_rad_ip
 
       | :sl:`rotates the vector around the y-axis by the angle in radians in place.`
-      | :sg:`rotate_y_rad_ip(angle, /) -> None`
+      | :sg:`rotate_y_rad_ip(angle) -> None`
 
       Rotates the vector counterclockwise around the y-axis by the given angle
       in radians. The length of the vector is not changed.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       .. ## Vector3.rotate_y_rad_ip ##
 
    .. method:: rotate_z
 
       | :sl:`rotates a vector around the z-axis by the angle in degrees.`
-      | :sg:`rotate_z(angle, /) -> Vector3`
+      | :sg:`rotate_z(angle) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise around the z-axis by the given angle in degrees.
@@ -952,21 +971,21 @@
    .. method:: rotate_z_rad
 
       | :sl:`rotates a vector around the z-axis by the angle in radians.`
-      | :sg:`rotate_z_rad(angle, /) -> Vector3`
+      | :sg:`rotate_z_rad(angle) -> Vector3`
 
       Returns a vector which has the same length as self but is rotated
       counterclockwise around the z-axis by the given angle in radians.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.0.0
+      .. versionadded:: 2.0.0
 
       .. ## Vector3.rotate_z_rad ##
 
    .. method:: rotate_z_ip
 
       | :sl:`rotates the vector around the z-axis by the angle in degrees in place.`
-      | :sg:`rotate_z_ip(angle, /) -> None`
+      | :sg:`rotate_z_ip(angle) -> None`
 
       Rotates the vector counterclockwise around the z-axis by the given angle
       in degrees. The length of the vector is not changed.
@@ -978,37 +997,32 @@
    .. method:: rotate_z_ip_rad
 
       | :sl:`rotates the vector around the z-axis by the angle in radians in place.`
-      | :sg:`rotate_z_ip_rad(angle, /) -> None`
+      | :sg:`rotate_z_ip_rad(angle) -> None`
 
       DEPRECATED: Use rotate_z_rad_ip() instead.
-
-      .. versionaddedold:: 2.0.0
-      .. deprecatedold:: 2.1.1
-      .. versionchanged:: 2.5.8
-         Fixed a regression introduced in 2.1.1 where this method incorrectly rotated
-         around the X-axis instead of the Z-axis. In versions prior to 2.1.1, rotation
-         around the Z-axis worked correctly.
+      
+      .. deprecated:: 2.1.1
 
       .. ## Vector3.rotate_z_ip_rad ##
 
    .. method:: rotate_z_rad_ip
 
       | :sl:`rotates the vector around the z-axis by the angle in radians in place.`
-      | :sg:`rotate_z_rad_ip(angle, /) -> None`
+      | :sg:`rotate_z_rad_ip(angle) -> None`
 
       Rotates the vector counterclockwise around the z-axis by the given angle
       in radians. The length of the vector is not changed.
       (Note that due to pygame's inverted y coordinate system, the rotation
       will look clockwise if displayed).
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       .. ## Vector3.rotate_z_rad_ip ##
 
    .. method:: angle_to
 
       | :sl:`calculates the angle to a given vector in degrees.`
-      | :sg:`angle_to(Vector3, /) -> float`
+      | :sg:`angle_to(Vector3) -> float`
 
       Returns the angle between self and the given vector.
 
@@ -1026,10 +1040,12 @@
 
    .. method:: from_spherical
 
-      | :sl:`Sets x, y and z from a spherical coordinates 3-tuple.`
-      | :sg:`from_spherical((r, theta, phi), /) -> None`
+      | :sl:`Creates a Vector3(x, y, z) or sets x, y and z from a spherical coordinates 3-tuple.`
+      | :sg:`Vector3.from_spherical((r, theta, phi)) -> Vector3`
+      | :sg:`Vector3().from_spherical((r, theta, phi)) -> None`
 
-      Sets x, y and z from a tuple ``(r, theta, phi)`` where r is the radial
+      If used from the class creates a Vector3(x, y, z), else sets x, y, and z.
+      The values of x, y, and z are from a tuple ``(r, theta, phi)`` where r is the radial
       distance, theta is the inclination angle and phi is the azimuthal angle.
 
       .. ## Vector3.from_spherical ##
@@ -1037,15 +1053,15 @@
    .. method:: project
 
       | :sl:`projects a vector onto another.`
-      | :sg:`project(Vector3, /) -> Vector3`
+      | :sg:`project(Vector3) -> Vector3`
 
-      Returns the projected vector. This is useful for collision detection in finding the components in a certain direction (e.g. in direction of the wall).
+      Returns the projected vector. This is useful for collision detection in finding the components in a certain direction (e.g. in direction of the wall). 
       For a more detailed explanation see `Wikipedia `_.
 
-      .. versionaddedold:: 2.0.2
+      .. versionadded:: 2.0.2
 
       .. ## Vector3.project ##
-
+   
    .. method:: copy
 
       | :sl:`Returns a copy of itself.`
@@ -1053,7 +1069,7 @@
 
       Returns a new Vector3 having the same dimensions.
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       .. ## Vector3.copy ##
 
@@ -1061,11 +1077,14 @@
    .. method:: clamp_magnitude
 
       | :sl:`Returns a copy of a vector with the magnitude clamped between max_length and min_length.`
-      | :sg:`clamp_magnitude(max_length, /) -> Vector3`
-      | :sg:`clamp_magnitude(min_length, max_length, /) -> Vector3`
+      | :sg:`clamp_magnitude(max_length) -> Vector3`
+      | :sg:`clamp_magnitude(min_length, max_length) -> Vector3`
 
-      Returns a new copy of a vector with the magnitude clamped between
-      ``max_length`` and ``min_length``. If only one argument is passed, it is
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave clamp_magnitude feedback with authors `_
+
+      Returns a new copy of a vector with the magnitude clamped between 
+      ``max_length`` and ``min_length``. If only one argument is passed, it is 
       taken to be the ``max_length``
 
       This function raises ``ValueError`` if ``min_length`` is greater than
@@ -1073,20 +1092,17 @@
 
       .. versionadded:: 2.1.3
 
-      .. versionchanged:: 2.4.0 It is now possible to use ``clamp_magnitude`` on a zero-vector as long as ``min_length``
-         is unspecified or 0.
-
-      .. note::
-         Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ``ValueError``
-
       .. ## Vector3.clamp_magnitude ##
-
+   
 
    .. method:: clamp_magnitude_ip
 
       | :sl:`Clamps the vector's magnitude between max_length and min_length`
-      | :sg:`clamp_magnitude_ip(max_length, /) -> None`
-      | :sg:`clamp_magnitude_ip(min_length, max_length, /) -> None`
+      | :sg:`clamp_magnitude_ip(max_length) -> None`
+      | :sg:`clamp_magnitude_ip(min_length, max_length) -> None`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave clamp_magnitude_ip feedback with authors `_
 
       Clamps the vector's magnitude between ``max_length`` and ``min_length``.
       If only one argument is passed, it is taken to be the ``max_length``
@@ -1096,12 +1112,6 @@
 
       .. versionadded:: 2.1.3
 
-      .. versionchanged:: 2.4.0 It is now possible to use ``clamp_magnitude`` on a zero-vector as long as ``min_length``
-         is unspecified or 0.
-
-      .. note::
-         Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ``ValueError``
-
       .. ## Vector3.clamp_magnitude_ip ##
 
    .. method:: update
@@ -1116,16 +1126,16 @@
 
       Sets coordinates x, y, and z in place.
 
-      .. versionaddedold:: 1.9.5
+      .. versionadded:: 1.9.5
 
       .. ## Vector3.update ##
 
    .. attribute:: epsilon
 
       | :sl:`Determines the tolerance of vector calculations.`
-
+      
       With lengths within this number, vectors are considered equal. For more information see :attr:`pygame.math.Vector2.epsilon`
-
+            
    .. ##  ##
 
    .. ## pygame.math.Vector3 ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/midi.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/midi.rst.txt
index c0f5d8e..edc9f25 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/midi.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/midi.rst.txt
@@ -8,7 +8,7 @@
 
 | :sl:`pygame module for interacting with midi input and output.`
 
-.. versionaddedold:: 1.9.0
+.. versionadded:: 1.9.0
 
 The midi module can send output to midi devices and get input from midi
 devices. It can also list midi devices on the system.
@@ -23,7 +23,7 @@ future. The pyportmidi bindings are included with pygame.
 
 |
 
-.. versionaddedold:: 2.0.0
+.. versionadded:: 2.0.0
 
 These are pygame events (:mod:`pygame.event`) reserved for midi use. The
 ``MIDIIN`` event is used by :func:`pygame.midi.midis2events` when converting
@@ -71,7 +71,7 @@ midi events to pygame events.
    :returns: ``True`` if the :mod:`pygame.midi` module is currently initialized.
    :rtype: bool
 
-   .. versionaddedold:: 1.9.5
+   .. versionadded:: 1.9.5
 
    .. ## pygame.midi.get_init ##
 
@@ -218,7 +218,7 @@ midi events to pygame events.
 
       If no value is given, the pitch bend is returned to "no change".
 
-      .. versionaddedold:: 1.9.4
+      .. versionadded:: 1.9.4
 
    .. method:: write
 
@@ -439,7 +439,7 @@ midi events to pygame events.
 
        frequency_to_midi(27.5) == 21
 
-   .. versionaddedold:: 1.9.5
+   .. versionadded:: 1.9.5
 
    .. ## pygame.midi.frequency_to_midi ##
 
@@ -454,7 +454,7 @@ midi events to pygame events.
 
        midi_to_frequency(21) == 27.5
 
-   .. versionaddedold:: 1.9.5
+   .. versionadded:: 1.9.5
 
    .. ## pygame.midi.midi_to_frequency ##
 
@@ -469,7 +469,7 @@ midi events to pygame events.
 
        midi_to_ansi_note(21) == 'A0'
 
-   .. versionaddedold:: 1.9.5
+   .. versionadded:: 1.9.5
 
    .. ## pygame.midi.midi_to_ansi_note ##
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mixer.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mixer.rst.txt
index 5cb9e84..55aed07 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mixer.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mixer.rst.txt
@@ -9,7 +9,9 @@
 | :sl:`pygame module for loading and playing sounds`
 
 This module contains classes for loading Sound objects and controlling
-playback.
+playback. The mixer module is optional and depends on SDL_mixer. Your program
+should test that :mod:`pygame.mixer` is available and initialized before using
+it.
 
 The mixer module has a limited number of channels for playback of sounds.
 Usually programs tell pygame to start playing audio and it selects an available
@@ -28,7 +30,9 @@ streams the music from the files without loading music at once into memory.
 
 The mixer module must be initialized like other pygame modules, but it has some
 extra conditions. The ``pygame.mixer.init()`` function takes several optional
-arguments to control the playback rate and sample size.
+arguments to control the playback rate and sample size. Pygame will default to
+reasonable values, but pygame cannot perform Sound resampling, so the mixer
+should be initialized to match the values of your audio resources.
 
 ``NOTE``: For less laggy sound use a smaller buffer size. The default
 is set to reduce the chance of scratchy sounds on some computers. You can
@@ -36,26 +40,6 @@ change the default buffer by calling :func:`pygame.mixer.pre_init` before
 :func:`pygame.mixer.init` or :func:`pygame.init` is called. For example:
 ``pygame.mixer.pre_init(44100,-16,2, 1024)``
 
-The following file formats are supported
-
-   * ``WAV``
-
-   * ``MP3``
-
-   * ``OGG``
-
-   * ``FLAC``
-
-   * ``OPUS``
-
-   * ``WV`` (WavPack)
-
-   * ``MOD`` ("Module file" family of music file formats)
-
-   * ``MIDI`` (see the :func:`get_soundfont` and :func:`set_soundfont` methods)
-
-.. versionadded:: 2.5.0 Loading WV (Relies on SDL_mixer 2.8.0+)
-
 
 .. function:: init
 
@@ -64,7 +48,7 @@ The following file formats are supported
 
    Initialize the mixer module for Sound loading and playback. The default
    arguments can be overridden to provide specific audio mixing. Keyword
-   arguments are accepted. For backwards compatibility, argument values of
+   arguments are accepted. For backwards compatibility, argument values of 
    0 are replaced with the startup defaults, except for ``allowedchanges``,
    where -1 is used. (startup defaults may be changed by a :func:`pre_init` call).
 
@@ -75,9 +59,6 @@ The following file formats are supported
 
    The channels argument is used to specify whether to use mono or stereo. 1
    for mono and 2 for stereo.
-   ``NOTE``: The channels argument is not related to the number
-   of channels for playback of sounds, that you can get with the function
-   "get_num_channels" or set with the function "set_num_channels" (see below).
 
    The buffer argument controls the number of internal samples used in the
    sound mixer. The default value should work for most cases. It can be lowered
@@ -86,10 +67,6 @@ The following file formats are supported
    playback. The buffer size must be a power of two (if not it is rounded up to
    the next nearest power of 2).
 
-   The devicename parameter is the name of sound device to open for audio
-   playback. Allowed device names will vary based on the host system.
-   If left as ``None`` then a sensible default will be chosen for you.
-
    Some platforms require the :mod:`pygame.mixer` module to be initialized
    after the display modules have initialized. The top level ``pygame.init()``
    takes care of this automatically, but cannot pass any arguments to the mixer
@@ -100,7 +77,7 @@ The following file formats are supported
    what the hardware supports. For example a sound card may not
    support 16bit sound samples, so instead it will use 8bit samples internally.
    If AUDIO_ALLOW_FORMAT_CHANGE is supplied, then the requested format will
-   change to the closest that SDL supports.
+   change to the closest that SDL2 supports.
 
    Apart from 0, allowedchanged accepts the following constants ORed together:
 
@@ -113,13 +90,13 @@ The following file formats are supported
    you cannot change the playback arguments without first calling
    ``pygame.mixer.quit()``.
 
-   .. versionchangedold:: 1.8 The default ``buffersize`` changed from 1024 to 3072.
-   .. versionchangedold:: 1.9.1 The default ``buffersize`` changed from 3072 to 4096.
-   .. versionchangedold:: 2.0.0 The default ``buffersize`` changed from 4096 to 512.
-   .. versionchangedold:: 2.0.0 The default ``frequency`` changed from 22050 to 44100.
-   .. versionchangedold:: 2.0.0 ``size`` can be 32 (32-bit floats).
-   .. versionchangedold:: 2.0.0 ``channels`` can also be 4 or 6.
-   .. versionaddedold:: 2.0.0 ``allowedchanges``, ``devicename`` arguments added
+   .. versionchanged:: 1.8 The default ``buffersize`` changed from 1024 to 3072.
+   .. versionchanged:: 1.9.1 The default ``buffersize`` changed from 3072 to 4096.
+   .. versionchanged:: 2.0.0 The default ``buffersize`` changed from 4096 to 512. 
+   .. versionchanged:: 2.0.0 The default ``frequency`` changed from 22050 to 44100.
+   .. versionchanged:: 2.0.0 ``size`` can be 32 (32-bit floats).
+   .. versionchanged:: 2.0.0 ``channels`` can also be 4 or 6.
+   .. versionadded:: 2.0.0 ``allowedchanges``, ``devicename`` arguments added
 
    .. ## pygame.mixer.init ##
 
@@ -135,11 +112,11 @@ The following file formats are supported
    For backwards compatibility, argument values of 0 are replaced with the
    startup defaults, except for ``allowedchanges``, where -1 is used.
 
-   .. versionchangedold:: 1.8 The default ``buffersize`` changed from 1024 to 3072.
-   .. versionchangedold:: 1.9.1 The default ``buffersize`` changed from 3072 to 4096.
-   .. versionchangedold:: 2.0.0 The default ``buffersize`` changed from 4096 to 512.
-   .. versionchangedold:: 2.0.0 The default ``frequency`` changed from 22050 to 44100.
-   .. versionaddedold:: 2.0.0 ``allowedchanges``, ``devicename`` arguments added
+   .. versionchanged:: 1.8 The default ``buffersize`` changed from 1024 to 3072.
+   .. versionchanged:: 1.9.1 The default ``buffersize`` changed from 3072 to 4096.
+   .. versionchanged:: 2.0.0 The default ``buffersize`` changed from 4096 to 512. 
+   .. versionchanged:: 2.0.0 The default ``frequency`` changed from 22050 to 44100.
+   .. versionadded:: 2.0.0 ``allowedchanges``, ``devicename`` arguments added
 
    .. ## pygame.mixer.pre_init ##
 
@@ -157,25 +134,13 @@ The following file formats are supported
 .. function:: get_init
 
    | :sl:`test if the mixer is initialized`
-   | :sg:`get_init() -> (frequency, format, channels) | None`
+   | :sg:`get_init() -> (frequency, format, channels)`
 
    If the mixer is initialized, this returns the playback arguments it is
    using. If the mixer has not been initialized this returns ``None``.
 
    .. ## pygame.mixer.get_init ##
 
-.. function:: get_driver
-
-   | :sl:`get the name of the current audio backend driver`
-   | :sg:`get_driver() -> str`
-
-   Pygame chooses one of many available audio backend drivers when it is
-   initialized. This returns the internal name used for the backend. This
-   function is intended to be used for getting diagnostic/debugging information.
-   This can be controlled with ``SDL_AUDIODRIVER`` environment variable.
-
-   .. versionadded:: 2.5.0
-
 .. function:: stop
 
    | :sl:`stop playback of all sound channels`
@@ -207,7 +172,7 @@ The following file formats are supported
 .. function:: fadeout
 
    | :sl:`fade out the volume on all sounds before stopping`
-   | :sg:`fadeout(time, /) -> None`
+   | :sg:`fadeout(time) -> None`
 
    This will fade out the volume on all active channels over the time argument
    in milliseconds. After the sound is muted the playback will stop.
@@ -217,9 +182,9 @@ The following file formats are supported
 .. function:: set_num_channels
 
    | :sl:`set the total number of playback channels`
-   | :sg:`set_num_channels(count, /) -> None`
+   | :sg:`set_num_channels(count) -> None`
 
-   Sets the number of available playback channels for the mixer. The default value is 8.
+   Sets the number of available channels for the mixer. The default value is 8.
    The value can be increased or decreased. If the value is decreased, sounds
    playing on the truncated channels are stopped.
 
@@ -237,10 +202,10 @@ The following file formats are supported
 .. function:: set_reserved
 
    | :sl:`reserve channels from being automatically used`
-   | :sg:`set_reserved(count, /) -> count`
+   | :sg:`set_reserved(count) -> count`
 
    The mixer can reserve any number of channels that will not be automatically
-   selected for playback by Sounds. This means that whenever you play a Sound
+   selected for playback by Sounds. This means that whenever you play a Sound 
    without specifying a channel, a reserved channel will never be used. If sounds
    are currently playing on the reserved channels they will not be stopped.
 
@@ -256,7 +221,7 @@ The following file formats are supported
 .. function:: find_channel
 
    | :sl:`find an unused channel`
-   | :sg:`find_channel(force=False) -> Channel | None`
+   | :sg:`find_channel(force=False) -> Channel`
 
    This will find and return an inactive Channel object. If there are no
    inactive Channels this function will return ``None``. If there are no
@@ -265,50 +230,13 @@ The following file formats are supported
 
    .. ## pygame.mixer.find_channel ##
 
-.. function:: set_soundfont
-
-   | :sl:`set the soundfont for playing midi music`
-   | :sg:`set_soundfont(path, /) -> None`
-
-   This sets the soundfont file to be used in the playback of midi music.
-   The soundfont only affects the playback of ``MID``, ``MIDI``, and ``KAR`` file formats.
-   The optional ``path`` argument, a string (or multiple strings separated by a semi-colon),
-   must point to the soundfont file(s) to be searched for in order given if some
-   are missing. If ``path`` is an empty string or the default (``None``), any specified soundfont paths
-   will be cleared from the mixer.
-
-   Note on Windows, the mixer always uses the built-in soundfont instead of the one specified.
-
-   Function :func:`set_soundfont` calls underlying SDL_mixer function
-   ``Mix_SetSoundFonts``.
-
-   .. versionadded:: 2.3.1
-
-   .. ## pygame.mixer.set_soundfont ##
-
-.. function:: get_soundfont
-
-   | :sl:`get the soundfont for playing midi music`
-   | :sg:`get_soundfont() -> paths`
-
-   This gets the soundfont filepaths as a string (each path is separated by a semi-colon)
-   to be used in the playback of ``MID``, ``MIDI``, and ``KAR`` music file formats. If no
-   soundfont is specified, the return type is ``None``.
-
-   Function :func:`get_soundfont` calls underlying SDL_mixer function
-   ``Mix_GetSoundFonts``.
-
-   .. versionadded:: 2.3.1
-
-   .. ## pygame.mixer.get_soundfont ##
-
 .. function:: get_busy
 
    | :sl:`test if any sound is being mixed`
    | :sg:`get_busy() -> bool`
 
    Returns ``True`` if the mixer is busy mixing any channels. If the mixer is
-   idle or uninitialized then this returns ``False``.
+   idle then this return ``False``.
 
    .. ## pygame.mixer.get_busy ##
 
@@ -327,9 +255,9 @@ The following file formats are supported
    :rtype: tuple
 
    .. note::
-      The linked and compiled version numbers should be the same.
+      The linked and compile version numbers should be the same.
 
-   .. versionaddedold:: 2.0.0
+   .. versionadded:: 2.0.0
 
    .. ## pygame.mixer.get_sdl_mixer_version ##
 
@@ -350,11 +278,11 @@ The following file formats are supported
    the initialize arguments for the mixer. A Unicode string can only be a file
    pathname. A bytes object can be either a pathname or a buffer object.
    Use the 'file' or 'buffer' keywords to avoid ambiguity; otherwise Sound may
-   guess wrong. If the array keyword is used, the object is expected to export
+   guess wrong. If the array keyword is used, the object is expected to export 
    a new buffer interface (The object is checked for a buffer interface first.)
 
    The Sound object represents actual sound sample data. Methods that change
-   the state of the Sound object will impact all instances of the Sound playback.
+   the state of the Sound object will the all instances of the Sound playback.
    A Sound object also exports a new buffer interface.
 
    The Sound can be loaded from an ``OGG`` audio file or from an uncompressed
@@ -369,17 +297,10 @@ The following file formats are supported
    an exception when different. Also, source samples are truncated to fit the
    audio sample size. This will not change.
 
-   .. note:: ``bytes(Sound)`` and ``bytearray(Sound)`` make use of the buffer
-             interface, which is implemented internally by ``pygame.mixer.Sound``.
-             Because of this, there is no need to directly implement ``__bytes__``.
-
-   .. versionaddedold:: 1.8 ``pygame.mixer.Sound(buffer)``
-   .. versionaddedold:: 1.9.2
+   .. versionadded:: 1.8 ``pygame.mixer.Sound(buffer)``
+   .. versionadded:: 1.9.2
       :class:`pygame.mixer.Sound` keyword arguments and array interface support
-   .. versionaddedold:: 2.0.1 pathlib.Path support on Python 3.
-
-   .. versionchanged:: 2.5.2 This class is also available through the ``pygame.Sound``
-      alias.
+   .. versionadded:: 2.0.1 pathlib.Path support on Python 3.
 
    .. method:: play
 
@@ -420,7 +341,7 @@ The following file formats are supported
    .. method:: fadeout
 
       | :sl:`stop sound playback after fading out`
-      | :sg:`fadeout(time, /) -> None`
+      | :sg:`fadeout(time) -> None`
 
       This will stop playback of the sound after fading it out over the time
       argument in milliseconds. The Sound will fade and stop on all actively
@@ -431,7 +352,7 @@ The following file formats are supported
    .. method:: set_volume
 
       | :sl:`set the playback volume for this Sound`
-      | :sg:`set_volume(value, /) -> None`
+      | :sg:`set_volume(value) -> None`
 
       This will set the playback volume (loudness) for this Sound. This will
       immediately affect the Sound if it is playing. It will also affect any
@@ -442,25 +363,6 @@ The following file formats are supported
          | If value < 0.0, the volume will not be changed
          | If value > 1.0, the volume will be set to 1.0
 
-      .. note::
-         The values are internally converted and kept as integer values in range [0, 128], which means
-         that ``get_volume()`` may return a different volume than it was set to. For example,
-
-            >>> sound.set_volume(0.1)
-            >>> sound.get_volume()
-            0.09375
-
-         This is because when you ``set_volume(0.1)``, the volume is internally calculated like so
-
-            >>> int(0.1 * 128)
-            12
-
-         This means that some of the precision is lost, so when you retrieve it again using ``get_volume()``,
-         it is converted back to a ``float`` using that integer
-
-            >>> 12 / 128
-            0.09375
-
       .. ## Sound.set_volume ##
 
    .. method:: get_volume
@@ -468,10 +370,7 @@ The following file formats are supported
       | :sl:`get the playback volume`
       | :sg:`get_volume() -> value`
 
-      Return a value from 0.0 to 1.0 (inclusive) representing the volume for this Sound.
-
-      .. note::
-         See :func:`Sound.set_volume` for more information regarding the returned value
+      Return a value from 0.0 to 1.0 representing the volume for this Sound.
 
       .. ## Sound.get_volume ##
 
@@ -500,30 +399,10 @@ The following file formats are supported
 
       Return a copy of the Sound object buffer as a bytes.
 
-      .. versionaddedold:: 1.9.2
+      .. versionadded:: 1.9.2
 
       .. ## Sound.get_raw ##
 
-   .. method:: copy
-
-      | :sl:`return a new Sound object that is a deep copy of this Sound`
-      | :sg:`copy() -> Sound`
-      | :sg:`copy.copy(original_sound) -> Sound`
-
-      Return a new Sound object that is a deep copy of this Sound. The new Sound
-      will be just as if you loaded it from the same file on disk as you did the
-      original Sound. If the copy fails, a ``TypeError`` or :meth:`pygame.error`
-      exception will be raised.
-
-      If copying a subclass of ``mixer.Sound``, an instance of the same subclass
-      will be returned.
-
-      Also note that this functions as ``Sound.__copy__``.
-
-      .. versionadded:: 2.5.6
-
-      .. ## Sound.copy ##
-
    .. ## pygame.mixer.Sound ##
 
 .. class:: Channel
@@ -532,28 +411,12 @@ The following file formats are supported
    | :sg:`Channel(id) -> Channel`
 
    Return a Channel object for one of the current channels. The id must be a
-   value from 0 up to, but not including, ``pygame.mixer.get_num_channels()``.
+   value from 0 to the value of ``pygame.mixer.get_num_channels()``.
 
    The Channel object can be used to get fine control over the playback of
    Sounds. A channel can only playback a single Sound at time. Using channels
    is entirely optional since pygame can manage them by default.
 
-   .. versionchanged:: 2.1.4 This class is also available through the ``pygame.Channel``
-      alias.
-   .. versionchanged:: 2.4.0 It is now possible to create subclasses of ``pygame.mixer.Channel``
-
-   .. attribute:: id
-
-      | :sl:`get the channel id for the Channel object`
-      | :sg:`id -> int`
-
-      This simply returns the channel id used to create the ``Channel`` instance
-      as a read-only attribute
-
-      .. versionadded:: 2.4.0
-
-      .. ## Channel.id ##
-
    .. method:: play
 
       | :sl:`play a Sound on a specific Channel`
@@ -607,59 +470,28 @@ The following file formats are supported
    .. method:: fadeout
 
       | :sl:`stop playback after fading channel out`
-      | :sg:`fadeout(time, /) -> None`
+      | :sg:`fadeout(time) -> None`
 
       Stop playback of a channel after fading out the sound over the given time
       argument in milliseconds.
 
       .. ## Channel.fadeout ##
 
-   .. method:: set_source_location
-
-      | :sl:`set the position of a playing channel`
-      | :sg:`set_source_location(angle, distance, /) -> None`
-
-      Set the position (angle, distance) of a playing channel.
-
-      `angle`: Angle in degrees.
-
-      `distance`: Range from 0 to 255.
-
-      .. warning:: This function currently fails and raises a
-         :exc:`pygame.error` when using 7.1 surround sound.
-         By default, the mixer module will use what the hardware is best
-         suited for, so this leads to hardware specific exceptions when using
-         this function.
-
-         One way of avoiding this is only using :func:`set_source_location`
-         with forced stereo. For example:
-
-         ::
-
-            pygame.mixer.pre_init(
-               channels=2,
-               allowedchanges=pygame.AUDIO_ALLOW_FREQUENCY_CHANGE,
-            )
-            pygame.init()
-
-      .. versionadded:: 2.3.0
-
-      .. ## Channel.set_source_location ##
-
    .. method:: set_volume
 
       | :sl:`set the volume of a playing channel`
-      | :sg:`set_volume(value, /) -> None`
-      | :sg:`set_volume(left, right, /) -> None`
+      | :sg:`set_volume(value) -> None`
+      | :sg:`set_volume(left, right) -> None`
 
       Set the volume (loudness) of a playing sound. When a channel starts to
       play its volume value is reset. This only affects the current sound. The
-      value argument is in the range of 0.0 to 1.0 (inclusive).
+      value argument is between 0.0 and 1.0.
 
       If one argument is passed, it will be the volume of both speakers. If two
       arguments are passed and the mixer is in stereo mode, the first argument
       will be the volume of the left speaker and the second will be the volume
-      of the right speaker.
+      of the right speaker. (If the second argument is ``None``, the first
+      argument will be the volume of both speakers.)
 
       If the channel is playing a Sound on which ``set_volume()`` has also been
       called, both calls are taken into account. For example:
@@ -672,9 +504,6 @@ The following file formats are supported
           sound.set_volume(0.6)   # Now plays at 60% (previous value replaced).
           channel.set_volume(0.5) # Now plays at 30% (0.6 * 0.5).
 
-      .. note::
-         See :func:`Sound.set_volume` for more information regarding how the value is stored internally
-
       .. ## Channel.set_volume ##
 
    .. method:: get_volume
@@ -682,15 +511,11 @@ The following file formats are supported
       | :sl:`get the volume of the playing channel`
       | :sg:`get_volume() -> value`
 
-      Return the volume of the channel for the current playing sound
-      in the range of 0.0 to 1.0 (inclusive). This does
+      Return the volume of the channel for the current playing sound. This does
       not take into account stereo separation used by
       :meth:`Channel.set_volume`. The Sound object also has its own volume
       which is mixed with the channel.
 
-      .. note::
-         See :func:`Sound.set_volume` for more information regarding the returned value
-
       .. ## Channel.get_volume ##
 
    .. method:: get_busy
@@ -706,7 +531,7 @@ The following file formats are supported
    .. method:: get_sound
 
       | :sl:`get the currently playing Sound`
-      | :sg:`get_sound() -> Sound | None`
+      | :sg:`get_sound() -> Sound`
 
       Return the actual Sound object currently playing on this channel. If the
       channel is idle ``None`` is returned.
@@ -716,7 +541,7 @@ The following file formats are supported
    .. method:: queue
 
       | :sl:`queue a Sound object to follow the current`
-      | :sg:`queue(sound, /) -> None`
+      | :sg:`queue(Sound) -> None`
 
       When a Sound is queued on a Channel, it will begin playing immediately
       after the current Sound is finished. Each channel can only have a single
@@ -732,7 +557,7 @@ The following file formats are supported
    .. method:: get_queue
 
       | :sl:`return any Sound that is queued`
-      | :sg:`get_queue() -> Sound | None`
+      | :sg:`get_queue() -> Sound`
 
       If a Sound is already queued on this channel it will be returned. Once
       the queued sound begins playback it will no longer be on the queue.
@@ -743,7 +568,7 @@ The following file formats are supported
 
       | :sl:`have the channel send an event when playback stops`
       | :sg:`set_endevent() -> None`
-      | :sg:`set_endevent(type, /) -> None`
+      | :sg:`set_endevent(type) -> None`
 
       When an endevent is set for a channel, it will send an event to the
       pygame queue every time a sound finishes playing on that channel (not
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mouse.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mouse.rst.txt
index c45b6bb..dda6c7b 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mouse.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/mouse.rst.txt
@@ -3,5 +3,217 @@
 :mod:`pygame.mouse`
 ===================
 
-.. autopgmodule:: pygame.mouse
-   :members:
+.. module:: pygame.mouse
+   :synopsis: pygame module to work with the mouse
+
+| :sl:`pygame module to work with the mouse`
+
+The mouse functions can be used to get the current state of the mouse device.
+These functions can also alter the system cursor for the mouse.
+
+When the display mode is set, the event queue will start receiving mouse
+events. The mouse buttons generate ``pygame.MOUSEBUTTONDOWN`` and
+``pygame.MOUSEBUTTONUP`` events when they are pressed and released. These
+events contain a button attribute representing which button was pressed. The
+mouse wheel will generate ``pygame.MOUSEBUTTONDOWN`` and 
+``pygame.MOUSEBUTTONUP`` events when rolled. The button will be set to 4 
+when the wheel is rolled up, and to button 5 when the wheel is rolled down. 
+Whenever the mouse is moved it generates a ``pygame.MOUSEMOTION`` event. The 
+mouse movement is broken into small and accurate motion events. As the mouse 
+is moving many motion events will be placed on the queue. Mouse motion events 
+that are not properly cleaned from the event queue are the primary reason the 
+event queue fills up.
+
+If the mouse cursor is hidden, and input is grabbed to the current display the
+mouse will enter a virtual input mode, where the relative movements of the
+mouse will never be stopped by the borders of the screen. See the functions
+``pygame.mouse.set_visible()`` and ``pygame.event.set_grab()`` to get this
+configured.
+
+
+**Mouse Wheel Behavior in pygame 2**
+
+There is proper functionality for mouse wheel behaviour with pygame 2 supporting
+``pygame.MOUSEWHEEL`` events.  The new events support horizontal and vertical 
+scroll movements, with signed integer values representing the amount scrolled 
+(``x`` and ``y``), as well as ``flipped`` direction (the set positive and 
+negative values for each axis is flipped). Read more about SDL2 
+input-related changes here ``_
+
+In pygame 2, the mouse wheel functionality can be used by listening for the 
+``pygame.MOUSEWHEEL`` type of an event (Bear in mind they still emit 
+``pygame.MOUSEBUTTONDOWN`` events like in pygame 1.x, as well).
+When this event is triggered, a developer can access the appropriate ``Event`` object 
+with ``pygame.event.get()``. The object can be used to access data about the mouse 
+scroll, such as ``which`` (it will tell you what exact mouse device trigger the event).
+
+.. code-block:: python
+   :caption: Code example of mouse scroll (tested on 2.0.0.dev7)
+   :name: test.py
+
+   # Taken from husano896's PR thread (slightly modified)
+   import pygame
+   from pygame.locals import *
+   pygame.init()
+   screen = pygame.display.set_mode((640, 480))
+   clock = pygame.time.Clock()
+   
+   def main():
+      while True:
+         for event in pygame.event.get():
+               if event.type == QUIT:
+                  pygame.quit()
+                  return
+               elif event.type == MOUSEWHEEL:
+                  print(event) 
+                  print(event.x, event.y)
+                  print(event.flipped)
+                  print(event.which)
+                  # can access properties with 
+                  # proper notation(ex: event.y)
+         clock.tick(60)
+
+   # Execute game:
+   main()
+
+.. function:: get_pressed
+
+   | :sl:`get the state of the mouse buttons`
+   | :sg:`get_pressed(num_buttons=3) -> (button1, button2, button3)`
+   | :sg:`get_pressed(num_buttons=5) -> (button1, button2, button3, button4, button5)`
+
+   Returns a sequence of booleans representing the state of all the mouse
+   buttons. A true value means the mouse is currently being pressed at the time
+   of the call.
+
+   Note, to get all of the mouse events it is better to use either 
+   ``pygame.event.wait()`` or ``pygame.event.get()`` and check all of those 
+   events to see if they are ``MOUSEBUTTONDOWN``, ``MOUSEBUTTONUP``, or
+   ``MOUSEMOTION``.
+
+   Note, that on ``X11`` some X servers use middle button emulation. When you
+   click both buttons ``1`` and ``3`` at the same time a ``2`` button event 
+   can be emitted.
+
+   Note, remember to call ``pygame.event.get()`` before this function.
+   Otherwise it will not work as expected.
+
+   To support five button mice, an optional parameter ``num_buttons`` has been 
+   added in pygame 2. When this is set to ``5``, ``button4`` and ``button5`` 
+   are added to the returned tuple. Only ``3`` and ``5`` are valid values 
+   for this parameter.
+   
+   .. versionchanged:: 2.0.0 ``num_buttons`` argument added
+
+   .. ## pygame.mouse.get_pressed ##
+
+.. function:: get_pos
+
+   | :sl:`get the mouse cursor position`
+   | :sg:`get_pos() -> (x, y)`
+
+   Returns the ``x`` and ``y`` position of the mouse cursor. The position is
+   relative to the top-left corner of the display. The cursor position can be
+   located outside of the display window, but is always constrained to the
+   screen.
+
+   .. ## pygame.mouse.get_pos ##
+
+.. function:: get_rel
+
+   | :sl:`get the amount of mouse movement`
+   | :sg:`get_rel() -> (x, y)`
+
+   Returns the amount of movement in ``x`` and ``y`` since the previous call to
+   this function. The relative movement of the mouse cursor is constrained to
+   the edges of the screen, but see the virtual input mouse mode for a way
+   around this. Virtual input mode is described at the top of the page.
+
+   .. ## pygame.mouse.get_rel ##
+
+.. function:: set_pos
+
+   | :sl:`set the mouse cursor position`
+   | :sg:`set_pos([x, y]) -> None`
+
+   Set the current mouse position to arguments given. If the mouse cursor is
+   visible it will jump to the new coordinates. Moving the mouse will generate
+   a new ``pygame.MOUSEMOTION`` event.
+
+   .. ## pygame.mouse.set_pos ##
+
+.. function:: set_visible
+
+   | :sl:`hide or show the mouse cursor`
+   | :sg:`set_visible(bool) -> bool`
+
+   If the bool argument is true, the mouse cursor will be visible. This will
+   return the previous visible state of the cursor.
+
+   .. ## pygame.mouse.set_visible ##
+
+.. function:: get_visible
+
+   | :sl:`get the current visibility state of the mouse cursor`
+   | :sg:`get_visible() -> bool`
+
+   Get the current visibility state of the mouse cursor. ``True`` if the mouse is
+   visible, ``False`` otherwise.
+
+   .. versionadded:: 2.0.0
+
+   .. ## pygame.mouse.get_visible ##
+
+.. function:: get_focused
+
+   | :sl:`check if the display is receiving mouse input`
+   | :sg:`get_focused() -> bool`
+
+   Returns true when pygame is receiving mouse input events (or, in windowing
+   terminology, is "active" or has the "focus").
+
+   This method is most useful when working in a window. By contrast, in
+   full-screen mode, this method always returns true.
+
+   Note: under ``MS`` Windows, the window that has the mouse focus also has the
+   keyboard focus. But under X-Windows, one window can receive mouse events and
+   another receive keyboard events. ``pygame.mouse.get_focused()`` indicates
+   whether the pygame window receives mouse events.
+
+   .. ## pygame.mouse.get_focused ##
+
+.. function:: set_cursor
+
+   | :sl:`set the mouse cursor to a new cursor`
+   | :sg:`set_cursor(pygame.cursors.Cursor) -> None`
+   | :sg:`set_cursor(size, hotspot, xormasks, andmasks) -> None`
+   | :sg:`set_cursor(hotspot, surface) -> None`
+   | :sg:`set_cursor(constant) -> None`
+
+   Set the mouse cursor to something new. This function accepts either an explicit
+   ``Cursor`` object or arguments to create a ``Cursor`` object.
+
+   See :class:`pygame.cursors.Cursor` for help creating cursors and for examples.
+
+   .. versionchanged:: 2.0.1
+
+   .. ## pygame.mouse.set_cursor ##
+
+
+.. function:: get_cursor
+
+   | :sl:`get the current mouse cursor`
+   | :sg:`get_cursor() -> pygame.cursors.Cursor`
+
+   Get the information about the mouse system cursor. The return value contains
+   the same data as the arguments passed into :func:`pygame.mouse.set_cursor()`.
+
+   .. note:: Code that unpacked a get_cursor() call into 
+             ``size, hotspot, xormasks, andmasks`` will still work,
+	     assuming the call returns an old school type cursor.
+
+   .. versionchanged:: 2.0.1
+
+   .. ## pygame.mouse.get_cursor ##
+
+.. ## pygame.mouse ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/music.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/music.rst.txt
index ad50304..96a7b81 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/music.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/music.rst.txt
@@ -20,8 +20,6 @@ changed in pygame ``v2.0.2`` which got improved MP3 support. Consider using
 ``OGG`` file format for music as that can give slightly better compression than
 MP3 in most cases.
 
-For a complete list of supported file formats, see the :mod:`pygame.mixer` doc page.
-
 .. function:: load
 
    | :sl:`Load a music file for playback`
@@ -35,8 +33,7 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
    If you are loading from a file object, the namehint parameter can be used to specify
    the type of music data in the object. For example: :code:`load(fileobj, "ogg")`.
 
-   .. versionchangedold:: 2.0.2 Added optional ``namehint`` argument
-   .. versionchanged:: 2.2.0 Raises ``FileNotFoundError`` instead of :exc:`pygame.error` if file cannot be found
+   .. versionchanged:: 2.0.2 Added optional ``namehint`` argument
 
    .. ## pygame.mixer.music.load ##
 
@@ -47,7 +44,7 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
 
    This closes resources like files for any music that may be loaded.
 
-   .. versionaddedold:: 2.0.0
+   .. versionadded:: 2.0.0
 
    .. ## pygame.mixer.music.load ##
 
@@ -59,18 +56,18 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
 
    This will play the loaded music stream. If the music is already playing it
    will be restarted.
-
-   ``loops`` is an optional integer argument, which is ``0`` by default, which
-   indicates how many times to repeat the music. The music repeats indefinitely if
-   this argument is set to ``-1``.
-
-   ``start`` is an optional float argument, which is ``0.0`` by default, which
-   denotes the position in time from which the music starts playing. The starting
-   position depends on the format of the music played. ``MP3`` and ``OGG`` use
+   
+   ``loops`` is an optional integer argument, which is ``0`` by default, which 
+   indicates how many times to repeat the music. The music repeats indefinitely if 
+   this argument is set to ``-1``. 
+   
+   ``start`` is an optional float argument, which is ``0.0`` by default, which 
+   denotes the position in time from which the music starts playing. The starting 
+   position depends on the format of the music played. ``MP3`` and ``OGG`` use 
    the position as time in seconds. For ``MP3`` files the start time position
    selected may not be accurate as things like variable bit rate encoding and ID3
-   tags can throw off the timing calculations. For ``MOD``  music it is the pattern
-   order number. Passing a start position will raise a NotImplementedError if
+   tags can throw off the timing calculations. For ``MOD``  music it is the pattern 
+   order number. Passing a start position will raise a NotImplementedError if 
    the start position cannot be set.
 
    ``fade_ms`` is an optional integer argument, which is ``0`` by default,
@@ -78,8 +75,8 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
    will fade up from volume level ``0.0`` to full volume (or the volume level
    previously set by :func:`set_volume`). The sample may end before the fade-in
    is complete. If the music is already streaming ``fade_ms`` is ignored.
-
-   .. versionchangedold:: 2.0.0 Added optional ``fade_ms`` argument
+   
+   .. versionchanged:: 2.0.0 Added optional ``fade_ms`` argument
 
    .. ## pygame.mixer.music.play ##
 
@@ -90,7 +87,7 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
 
    Resets playback of the current music to the beginning. If :func:`pause` has
    previously been used to pause the music, the music will remain paused.
-
+   
    .. note:: :func:`rewind` supports a limited number of file types and notably
              ``WAV`` files are NOT supported. For unsupported file types use :func:`play`
              which will restart the music that's already playing (note that this
@@ -131,16 +128,16 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
 .. function:: fadeout
 
    | :sl:`stop music playback after fading out`
-   | :sg:`fadeout(time, /) -> None`
+   | :sg:`fadeout(time) -> None`
 
    Fade out and stop the currently playing music.
 
-   The ``time`` argument denotes the integer milliseconds for which the
+   The ``time`` argument denotes the integer milliseconds for which the 
    fading effect is generated.
 
-   Note, that this function blocks until the music has faded out. Calls
-   to :func:`fadeout` and :func:`set_volume` will have no effect during
-   this time. If an event was set using :func:`set_endevent` it will be
+   Note, that this function blocks until the music has faded out. Calls 
+   to :func:`fadeout` and :func:`set_volume` will have no effect during 
+   this time. If an event was set using :func:`set_endevent` it will be 
    called after the music has faded.
 
    .. ## pygame.mixer.music.fadeout ##
@@ -148,19 +145,16 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
 .. function:: set_volume
 
    | :sl:`set the music volume`
-   | :sg:`set_volume(volume, /) -> None`
+   | :sg:`set_volume(volume) -> None`
 
    Set the volume of the music playback.
-
-   The ``volume`` argument is a float between ``0.0`` and ``1.0`` that sets
+   
+   The ``volume`` argument is a float between ``0.0`` and ``1.0`` that sets 
    the volume level. When new music is loaded the volume is reset to full
    volume. If ``volume`` is a negative value it will be ignored and the
    volume will remain set at the current level. If the ``volume`` argument
    is greater than ``1.0``, the volume will be set to ``1.0``.
 
-   .. note::
-      See :func:`mixer.Sound.set_volume()` for more information regarding how the value is stored internally
-
    .. ## pygame.mixer.music.set_volume ##
 
 .. function:: get_volume
@@ -168,12 +162,9 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
    | :sl:`get the music volume`
    | :sg:`get_volume() -> value`
 
-   Returns the current volume for the mixer. The value will be between ``0.0``
+   Returns the current volume for the mixer. The value will be between ``0.0`` 
    and ``1.0``.
 
-   .. note::
-      See :func:`mixer.Sound.set_volume()` for more information regarding the returned value
-
    .. ## pygame.mixer.music.get_volume ##
 
 .. function:: get_busy
@@ -186,19 +177,19 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
    False when the music is paused. In pygame 1 it returns True when the music
    is paused.
 
-   .. versionchangedold:: 2.0.1 Returns False when music paused.
+   .. versionchanged:: 2.0.1 Returns False when music paused.
 
    .. ## pygame.mixer.music.get_busy ##
 
 .. function:: set_pos
 
    | :sl:`set position to play from`
-   | :sg:`set_pos(pos, /) -> None`
+   | :sg:`set_pos(pos) -> None`
 
    This sets the position in the music file where playback will start.
    The meaning of "pos", a float (or a number that can be converted to a float),
    depends on the music format.
-
+   
    For ``MOD`` files, pos is the integer pattern number in the module.
    For ``OGG`` it is the absolute position, in seconds, from
    the beginning of the sound. For ``MP3`` files, it is the relative position,
@@ -206,13 +197,13 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
    file, first call :func:`rewind`.
 
    Other file formats are unsupported. Newer versions of SDL_mixer have
-   better positioning support than earlier ones. A :exc:`pygame.error` is
-   raised if a particular format does not support positioning.
+   better positioning support than earlier ones. An SDLError is raised if a
+   particular format does not support positioning.
 
-   Function :func:`set_pos` calls underlying SDL_mixer function
+   Function :func:`set_pos` calls underlining SDL_mixer function
    ``Mix_SetMusicPosition``.
 
-   .. versionaddedold:: 1.9.2
+   .. versionadded:: 1.9.2
 
    .. ## pygame.mixer.music.set_pos ##
 
@@ -225,8 +216,6 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
    The returned time only represents how long the music has been playing; it
    does not take into account any starting position offsets.
 
-   Returns -1 if ``get_pos`` failed due to music not playing.
-
    .. ## pygame.mixer.music.get_pos ##
 
 .. function:: queue
@@ -253,8 +242,7 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
        pygame.mixer.music.play(5)        # Plays six times, not five!
        pygame.mixer.music.queue('mozart.ogg')
 
-   .. versionchangedold:: 2.0.2 Added optional ``namehint`` argument
-   .. versionchanged:: 2.2.0 Raises ``FileNotFoundError`` instead of :exc:`pygame.error` if file cannot be found
+   .. versionchanged:: 2.0.2 Added optional ``namehint`` argument
 
    .. ## pygame.mixer.music.queue ##
 
@@ -262,7 +250,7 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
 
    | :sl:`have the music send an event when playback stops`
    | :sg:`set_endevent() -> None`
-   | :sg:`set_endevent(type, /) -> None`
+   | :sg:`set_endevent(type) -> None`
 
    This causes pygame to signal (by means of the event queue) when the music is
    done playing. The argument determines the type of event that will be queued.
@@ -284,31 +272,3 @@ For a complete list of supported file formats, see the :mod:`pygame.mixer` doc p
    .. ## pygame.mixer.music.get_endevent ##
 
 .. ## pygame.mixer.music ##
-
-.. function:: get_metadata
-
-   | :sl:`get metadata of the specified or currently loaded music stream`
-   | :sg:`get_metadata() -> dict`
-   | :sg:`get_metadata(filename) -> dict`
-   | :sg:`get_metadata(fileobj, namehint="") -> dict`
-
-   If no arguments are passed returns a dictionary containing metadata
-   of the currently loaded music stream, raises an exception if a music stream is not loaded.
-   Available keys are ``"title"``, ``"album"``, ``"artist"``, ``"copyright"``.
-   Values are strings containing corresponding retrieved metadata.
-   If particular metadata was not found the value is an empty string.
-   Here is an example:
-   ``{'title': 'Small Tone', 'album': 'Tones', 'artist': 'Audacity Generator', 'copyright': ''}``
-
-   Refer to the :func:`pygame.mixer.music.load` function for arguments regarding specifying a file or a file-like object
-   whose metadata you want to retrieve. For this function all arguments are optional,
-   however, specifying only the ``namehint`` will raise an exception.
-
-   Since the underlying functionality was introduced in version 2.6.0 of SDL_mixer,
-   calling this function with an older version of SDL_mixer will return a dictionary
-   with all values being set to empty strings. You can find your version of SDL_mixer
-   by using :func:`pygame.mixer.get_sdl_mixer_version`.
-
-   .. versionadded:: 2.1.4
-
-   .. ## pygame.mixer.music.get_metadata ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelarray.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelarray.rst.txt
index a6ef356..9bdc38c 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelarray.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelarray.rst.txt
@@ -42,7 +42,7 @@
      if pxarray[0, 0] == surface.map_rgb((0, 0, 255)):
          ...
 
-   When assigning to a range of pixels, a non tuple sequence of colors or
+   When assigning to a range of of pixels, a non tuple sequence of colors or
    a PixelArray can be used as the value. For a sequence, the length must
    match the PixelArray width.
 
@@ -79,7 +79,7 @@
      pxarray[::2] = (0, 0, 0)                  # Same as [::2, :]
 
    During its lifetime, the PixelArray locks the surface, thus you explicitly
-   have to close() it once it's not used any more and the surface should perform
+   have to close() it once its not used any more and the surface should perform
    operations in the same scope. It is best to use it as a context manager
    using the with PixelArray(surf) as pixel_array: style. So it works on pypy too.
 
@@ -100,19 +100,19 @@
    copying is implemented it is suggested PixelArray to PixelArray copies be
    only between surfaces of identical format.
 
-   .. versionaddedold:: 1.9.4
+   .. versionadded:: 1.9.4
 
     - close() method was added. For explicitly cleaning up.
     - being able to use PixelArray as a context manager for cleanup.
     - both of these are useful for when working without reference counting (pypy).
 
-   .. versionaddedold:: 1.9.2
+   .. versionadded:: 1.9.2
 
     - array struct interface
     - transpose method
     - broadcasting for a length 1 dimension
 
-   .. versionchangedold:: 1.9.2
+   .. versionchanged:: 1.9.2
 
     - A 2D PixelArray can have a length 1 dimension.
       Only an integer index on a 2D PixelArray returns a 1D array.
@@ -120,27 +120,23 @@
       is a sequence of colors.
 
 
-   .. versionaddedold: 1.8.0
+   .. versionadded: 1.8.0
       Subscript support
 
-   .. versionaddedold: 1.8.1
+   .. versionadded: 1.8.1
       Methods :meth:`make_surface`, :meth:`replace`, :meth:`extract`, and
       :meth:`compare`
 
-   .. versionaddedold: 1.9.2
+   .. versionadded: 1.9.2
       Properties :attr:`itemsize`, :attr:`ndim`, :attr:`shape`,
       and :attr:`strides`
 
-   .. versionaddedold: 1.9.2
+   .. versionadded: 1.9.2
       Array struct interface
 
-   .. versionaddedold: 1.9.4
+   .. versionadded: 1.9.4
       Methods :meth:`close`
 
-   .. versionchanged:: 2.5.8
-      Fixed incorrect color matching and writing on 24-bit surfaces whose
-      byte layout did not match the platform default.
-
    .. attribute:: surface
 
       | :sl:`Gets the Surface the PixelArray uses.`
@@ -158,7 +154,7 @@
       This is the same as :meth:`Surface.get_bytesize` for the
       pixel array's surface.
 
-      .. versionaddedold:: 1.9.2
+      .. versionadded:: 1.9.2
 
    .. attribute:: ndim
 
@@ -167,7 +163,7 @@
 
       A pixel array can be 1 or 2 dimensional.
 
-      .. versionaddedold:: 1.9.2
+      .. versionadded:: 1.9.2
 
    .. attribute:: shape
 
@@ -177,7 +173,7 @@
       A tuple or length :attr:`ndim` giving the length of each
       dimension. Analogous to :meth:`Surface.get_size`.
 
-      .. versionaddedold:: 1.9.2
+      .. versionadded:: 1.9.2
 
    .. attribute:: strides
 
@@ -189,7 +185,7 @@
       of that index from the start of the array. A stride is negative
       for an array that has is inverted (has a negative step).
 
-      .. versionaddedold:: 1.9.2
+      .. versionadded:: 1.9.2
 
    .. method:: make_surface
 
@@ -205,7 +201,7 @@
         # Create a new surface flipped around the vertical axis.
         sf = pxarray[:,::-1].make_surface ()
 
-      .. versionaddedold:: 1.8.1
+      .. versionadded:: 1.8.1
 
       .. ## PixelArray.make_surface ##
 
@@ -226,11 +222,7 @@
       This is an in place operation that directly affects the pixels of the
       PixelArray.
 
-      .. versionaddedold:: 1.8.1
-
-      .. versionchanged:: 2.5.8
-         Fixed incorrect color matching and writing on 24-bit surfaces whose
-         byte layout did not match the platform default.
+      .. versionadded:: 1.8.1
 
       .. ## PixelArray.replace ##
 
@@ -249,7 +241,7 @@
       extraction to take pixels with a similar, but not exactly identical
       color, into account as well.
 
-      .. versionaddedold:: 1.8.1
+      .. versionadded:: 1.8.1
 
       .. ## PixelArray.extract ##
 
@@ -269,7 +261,7 @@
       comparison to mark pixels with a similar, but not exactly identical
       color, as white.
 
-      .. versionaddedold:: 1.8.1
+      .. versionadded:: 1.8.1
 
       .. ## PixelArray.compare ##
 
@@ -283,7 +275,7 @@
       If an array is one dimensional, then a length 1 x dimension is added,
       resulting in a 2D pixel array.
 
-      .. versionaddedold:: 1.9.2
+      .. versionadded:: 1.9.2
 
       .. ## PixelArray.transpose ##
 
@@ -295,7 +287,7 @@
       This method is for explicitly closing the PixelArray, and releasing
       a lock on the Surface.
 
-      .. versionaddedold:: 1.9.4
+      .. versionadded:: 1.9.4
 
       .. ## PixelArray.close ##
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelcopy.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelcopy.rst.txt
index f1c239f..dd8ecf7 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelcopy.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pixelcopy.rst.txt
@@ -3,5 +3,102 @@
 :mod:`pygame.pixelcopy`
 =======================
 
-.. autopgmodule:: pygame.pixelcopy
-   :members:
+.. module:: pygame.pixelcopy
+   :synopsis: pygame module for general pixel array copying
+
+| :sl:`pygame module for general pixel array copying`
+
+The ``pygame.pixelcopy`` module contains functions for copying between
+surfaces and objects exporting an array structure interface. It is a backend
+for :mod:`pygame.surfarray`, adding NumPy support. But pixelcopy is more
+general, and intended for direct use.
+
+The array struct interface exposes an array's data in a standard way.
+It was introduced in NumPy. In Python 2.7 and above it is replaced by the
+new buffer protocol, though the buffer protocol is still a work in progress.
+The array struct interface, on the other hand, is stable and works with earlier
+Python versions. So for now the array struct interface is the predominate way
+pygame handles array introspection.
+
+For 2d arrays of integer pixel values, the values are mapped to the
+pixel format of the related surface. To get the actual color of a pixel
+value use :meth:`pygame.Surface.unmap_rgb`. 2d arrays can only be used
+directly between surfaces having the same pixel layout.
+
+New in pygame 1.9.2.
+
+.. function:: surface_to_array
+
+   | :sl:`copy surface pixels to an array object`
+   | :sg:`surface_to_array(array, surface, kind='P', opaque=255, clear=0) -> None`
+
+   The surface_to_array function copies pixels from a Surface object
+   to a 2D or 3D array. Depending on argument ``kind`` and the target array
+   dimension, a copy may be raw pixel value, RGB, a color component slice,
+   or colorkey alpha transparency value. Recognized ``kind`` values are the
+   single character codes 'P', 'R', 'G', 'B', 'A', and 'C'. Kind codes are case
+   insensitive, so 'p' is equivalent to 'P'. The first two dimensions
+   of the target must be the surface size (w, h).
+
+   The default 'P' kind code does a direct raw integer pixel (mapped) value
+   copy to a 2D array and a 'RGB' pixel component (unmapped) copy to a 3D array
+   having shape (w, h, 3). For an 8 bit colormap surface this means the
+   table index is copied to a 2D array, not the table value itself. A 2D
+   array's item size must be at least as large as the surface's pixel
+   byte size. The item size of a 3D array must be at least one byte.
+
+   For the 'R', 'G', 'B', and 'A' copy kinds a single color component
+   of the unmapped surface pixels are copied to the target 2D array.
+   For kind 'A' and surfaces with source alpha (the surface was created with
+   the SRCALPHA flag), has a colorkey
+   (set with :meth:`Surface.set_colorkey() `),
+   or has a blanket alpha
+   (set with :meth:`Surface.set_alpha() `)
+   then the alpha values are those expected for a SDL surface.
+   If a surface has no explicit alpha value, then the target array
+   is filled with the value of the optional ``opaque`` surface_to_array
+   argument (default 255: not transparent).
+
+   Copy kind 'C' is a special case for alpha copy of a source surface
+   with colorkey. Unlike the 'A' color component copy, the ``clear``
+   argument value is used for colorkey matches, ``opaque`` otherwise.
+   By default, a match has alpha 0 (totally transparent), while everything
+   else is alpha 255 (totally opaque). It is a more general implementation
+   of :meth:`pygame.surfarray.array_colorkey`.
+
+   Specific to surface_to_array, a ValueError is raised for target arrays
+   with incorrect shape or item size. A TypeError is raised for an incorrect
+   kind code. Surface specific problems, such as locking, raise a pygame.error.
+
+   .. ## pygame.pixelcopy.surface_to_array ##
+
+.. function:: array_to_surface
+
+   | :sl:`copy an array object to a surface`
+   | :sg:`array_to_surface(, ) -> None`
+
+   See :func:`pygame.surfarray.blit_array`.
+
+   .. ## pygame.pixelcopy.array_to_surface ##
+
+.. function:: map_array
+
+   | :sl:`copy an array to another array, using surface format`
+   | :sg:`map_array(, , ) -> None`
+
+   Map an array of color element values - (w, h, ..., 3) - to an array of
+   pixels - (w, h) according to the format of .
+
+   .. ## pygame.pixelcopy.map_array ##
+
+.. function:: make_surface
+
+   | :sl:`Copy an array to a new surface`
+   | :sg:`pygame.pixelcopy.make_surface(array) -> Surface`
+
+   Create a new Surface that best resembles the data and format of the array.
+   The array can be 2D or 3D with any sized integer values.
+
+   .. ## pygame.pixelcopy.make_surface ##
+
+.. ## pygame.pixelcopy ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pygame.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pygame.rst.txt
index b6266f6..9a518fc 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pygame.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/pygame.rst.txt
@@ -21,15 +21,6 @@ imported. Be aware that some of the pygame modules are considered *optional*,
 and may not be available. In that case, pygame will provide a placeholder
 object instead of the module, which can be used to test for availability.
 
-.. data:: IS_CE
-
-   | :sl:`exists if current pygame is pygame-ce`
-   | :sg:`IS_CE = 1`
-
-   Use ``getattr(pygame, "IS_CE", False)`` to check if current pygame is pygame-ce
-
-   .. ## pygame.IS_CE ##
-
 .. function:: init
 
    | :sl:`initialize all imported pygame modules`
@@ -43,7 +34,7 @@ object instead of the module, which can be used to test for availability.
    fail.
 
    You may want to initialize the different modules separately to speed up your
-   program or to not use modules your game does not require.
+   program or remove the modules your game does not require.
 
    It is safe to call this ``init()`` more than once as repeated calls will have
    no effect. This is true even if you have ``pygame.quit()`` all the modules.
@@ -74,7 +65,7 @@ object instead of the module, which can be used to test for availability.
 
    Returns ``True`` if pygame is currently initialized.
 
-   .. versionaddedold:: 1.9.5
+   .. versionadded:: 1.9.5
 
    .. ## pygame.get_init ##
 
@@ -106,7 +97,7 @@ object instead of the module, which can be used to test for availability.
 .. function:: set_error
 
    | :sl:`set the current error message`
-   | :sg:`set_error(error_msg, /) -> None`
+   | :sg:`set_error(error_msg) -> None`
 
    SDL maintains an internal error message. This message will usually be
    given to you when :func:`pygame.error` is raised, so this function will
@@ -126,9 +117,9 @@ object instead of the module, which can be used to test for availability.
    It can be used to detect which features may or may not be
    available through pygame.
 
-   .. versionaddedold:: 1.7.0
+   .. versionadded:: 1.7.0
 
-   .. versionchanged:: 2.1.4 ``linked`` keyword argument added
+   .. versionchanged:: 2.2.0 ``linked`` keyword argument added
 
    .. ## pygame.get_sdl_version ##
 
@@ -140,14 +131,14 @@ object instead of the module, which can be used to test for availability.
    Returns the byte order of the SDL library. It returns ``1234`` for little
    endian byte order and ``4321`` for big endian byte order.
 
-   .. versionaddedold:: 1.8
+   .. versionadded:: 1.8
 
    .. ## pygame.get_sdl_byteorder ##
 
 .. function:: register_quit
 
    | :sl:`register a function to be called when pygame quits`
-   | :sg:`register_quit(callable, /) -> None`
+   | :sg:`register_quit(callable) -> None`
 
    When :func:`pygame.quit` is called, all registered quit functions are
    called. Pygame modules do this automatically when they are initializing, so
@@ -177,9 +168,7 @@ object instead of the module, which can be used to test for availability.
    This function is used in encoding file paths. Keyword arguments are
    supported.
 
-   This function is not needed for normal pygame-ce usage.
-
-   .. versionaddedold:: 1.9.2 (primarily for use in unit tests)
+   .. versionadded:: 1.9.2 (primarily for use in unit tests)
 
    .. ## pygame.encode_string ##
 
@@ -199,31 +188,10 @@ object instead of the module, which can be used to test for availability.
    codec as returned by ``sys.getfilesystemencoding()``. Keyword arguments are
    supported.
 
-   This function is not needed for normal pygame-ce usage.
-
-   .. versionaddedold:: 1.9.2 (primarily for use in unit tests)
+   .. versionadded:: 1.9.2 (primarily for use in unit tests)
 
    .. ## pygame.encode_file_path ##
 
-.. function:: print_debug_info
-
-   | :sl:`retrieves useful information for debugging and issue-reporting purposes`
-   | :sg:`print_debug_info(filename=None) -> None`
-
-   Constructs a string containing details on the system, the python interpreter,
-   the pygame version, and the linked and compiled versions of the libraries that
-   pygame wraps. If ``filename`` is ``None``, then the string is printed into the
-   console. Otherwise, the debug string is written to the specified file.
-
-   .. note::
-      If ``pygame.freetype`` has not been initialized with :func:`pygame.init` or :func:`pygame.freetype.init`,
-      then the linked and compiled versions of FreeType will be "Unk" since this information is not
-      available before initialization.
-
-   .. versionadded:: 2.1.4
-
-   .. ## pygame.print_debug_info ##
-
 
 :mod:`pygame.version`
 =====================
@@ -261,7 +229,7 @@ check which version of pygame has been imported.
            print('Warning, older version of pygame (%s)' %  pygame.version.ver)
            disable_advanced_features = True
 
-   .. versionaddedold:: 1.9.6 Attributes ``major``, ``minor``, and ``patch``.
+   .. versionadded:: 1.9.6 Attributes ``major``, ``minor``, and ``patch``.
 
    ::
 
@@ -269,11 +237,11 @@ check which version of pygame has been imported.
       vernum.minor == vernum[1]
       vernum.patch == vernum[2]
 
-   .. versionchangedold:: 1.9.6
+   .. versionchanged:: 1.9.6
       ``str(pygame.version.vernum)`` returns a string like ``"2.0.0"`` instead
       of ``"(2, 0, 0)"``.
 
-   .. versionchangedold:: 1.9.6
+   .. versionchanged:: 1.9.6
       ``repr(pygame.version.vernum)`` returns a string like
       ``"PygameVersion(major=2, minor=0, patch=0)"`` instead of ``"(2, 0, 0)"``.
 
@@ -288,13 +256,13 @@ check which version of pygame has been imported.
    package was built. If the identifier ends with a plus sign '+' then the
    package contains uncommitted changes. Please include this revision number
    in bug reports, especially for non-release pygame builds.
-
-   Important note: pygame development has moved to github, this variable is
+   
+   Important note: pygame development has moved to github, this variable is 
    obsolete now. As soon as development shifted to github, this variable started
-   returning an empty string ``""``.
+   returning an empty string ``""``. 
    It has always been returning an empty string since ``v1.9.5``.
-
-   .. versionchangedold:: 1.9.5
+   
+   .. versionchanged:: 1.9.5
       Always returns an empty string ``""``.
 
    .. ## pygame.version.rev ##
@@ -302,7 +270,7 @@ check which version of pygame has been imported.
 .. data:: SDL
 
    | :sl:`tupled integers of the SDL library version`
-   | :sg:`SDL = '(2, 26, 5)'`
+   | :sg:`SDL = '(2, 0, 12)'`
 
    This is the SDL library version represented as an extended tuple. It also has
    attributes 'major', 'minor' & 'patch' that can be accessed like this:
@@ -317,9 +285,9 @@ check which version of pygame has been imported.
    ::
 
     >>> pygame.version.SDL
-    SDLVersion(major=2, minor=26, patch=5)
+    SDLVersion(major=2, minor=0, patch=12)
 
-   .. versionaddedold:: 2.0.0
+   .. versionadded:: 2.0.0
 
    .. ## pygame.version.SDL ##
 
@@ -401,7 +369,7 @@ available. Must be set before calling :func:`pygame.display.set_mode()`.
 This makes pygame use the SDL2 blitter for all alpha
 blending. The SDL2 blitter is sometimes faster than
 the default blitter but uses a different formula so
-the final colors may differ. Must be set before
+the final colours may differ. Must be set before
 :func:`pygame.init()` is called.
 
 |
@@ -433,7 +401,7 @@ do this. Must be set before importing pygame.
 ::
 
  PYGAME_CAMERA -
- Set to "opencv"
+ Set to "opencv" or "vidcapture"
 
 Forces the library backend used in the camera
 module, overriding the platform defaults. Must
@@ -535,27 +503,3 @@ By default, when the window is not in focus, input devices do not get
 updated. However, using this environment variable it is possible to get
 joystick updates even when the window is in the background. Must be set
 before calling :func:`pygame.init()` or :func:`pygame.joystick.init()`.
-
-|
-
-::
-
- SDL_MOUSE_TOUCH_EVENTS
- Set to "1" to make mouse events also generate touch events.
-
-Useful for testing touch events on desktop platforms (e.g. with a trackpad)
-where this is set to 0 by default.
-
-|
-
-::
-
- "SDL_WINDOWS_DPI_AWARENESS"
- Set to "permonitorv2" on windows 10 (and later) to declare the pygame
- window DPI aware and ignore the desktop scaling, "permonitor" for
- windows 8.1 and later DPI awareness and "system" for windows Vista
- and later DPI awareness (not per monitor). Finally set it to "unaware",
- to have the pygame window scale with the desktop scaling.
-
-This hint only affects the windows platform, other platforms can control DPI awareness
-via a Window creation keyword parameter called "allow_high_dpi".
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/rect.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/rect.rst.txt
index 5e256c7..ce4e605 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/rect.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/rect.rst.txt
@@ -8,32 +8,18 @@
 .. class:: Rect
 
    | :sl:`pygame object for storing rectangular coordinates`
-   | :sg:`Rect(left, top, width, height, /) -> Rect`
-   | :sg:`Rect((left, top), (width, height), /) -> Rect`
-   | :sg:`Rect(object, /) -> Rect`
-   | :sg:`Rect() -> Rect`
-   | :sg:`FRect(left, top, width, height, /) -> FRect`
-   | :sg:`FRect((left, top), (width, height), /) -> FRect`
-   | :sg:`FRect(object, /) -> FRect`
-   | :sg:`FRect() -> FRect`
-
-   .. versionadded:: 2.2
-      Added ``FRect`` class that is functionally identical to ``Rect`` but uses
-      floats instead of integers, enabling fractional precision and avoiding
-      truncation error while being interchangeable with standard Rects.
+   | :sg:`Rect(left, top, width, height) -> Rect`
+   | :sg:`Rect((left, top), (width, height)) -> Rect`
+   | :sg:`Rect(object) -> Rect`
 
    Pygame uses Rect objects to store and manipulate rectangular areas. A Rect
    can be created from a combination of left, top, width, and height values.
-   Rects can also be created from python objects that are already a Rect or
+   Rects can also be created from Python objects that are already a Rect or
    have an attribute named "rect".
 
-   Any pygame function that requires a Rect argument also accepts any of these
+   Any Pygame function that requires a Rect argument also accepts any of these
    values to construct a Rect. This makes it easier to create Rects on the fly
-   as arguments to functions.
-
-   If no arguments are given, a zero Rect will be created (x=0, y=0, w=0, h=0).
-   This will only work when using the Rect/FRect class and not with functions
-   that require a Rect argument.
+   as arguments for functions.
 
    The Rect functions that change the position or size of a Rect return a new
    copy of the Rect with the affected changes. The original Rect is not
@@ -51,7 +37,7 @@
        topleft, bottomleft, topright, bottomright
        midtop, midleft, midbottom, midright
        center, centerx, centery
-       size, width, height, relcenter
+       size, width, height
        w,h
 
    All of these attributes can be assigned to:
@@ -61,7 +47,7 @@
        rect1.right = 10
        rect2.center = (20,30)
 
-   Assigning to size, width, height, or relcenter changes the dimensions of the rectangle;
+   Assigning to size, width or height changes the dimensions of the rectangle;
    all other assignments move the rectangle without resizing it. Notice that
    some attributes are integers and others are pairs of integers.
 
@@ -89,32 +75,13 @@
       r = Rect(0, 1, 2, 3)
       x, y, w, h = r
 
-   .. versionaddedold:: 1.9.2
+   .. versionadded:: 1.9.2
       The Rect class can be subclassed. Methods such as ``copy()`` and ``move()``
       will recognize this and return instances of the subclass.
       However, the subclass's ``__init__()`` method is not called,
       and ``__new__()`` is assumed to take no arguments. So these methods should be
       overridden if any extra attributes need to be copied.
 
-   .. versionadded:: 2.5.6
-      ``relcenter`` added to Rect / FRect. This will return a tuple containing half
-      the Rect's size; the center relative to the topleft of the Rect.
-      Setting it to a ``Point`` will modify the size of the rect to 2 times
-      the ``Point`` given. Below you can find a code example of how it should work:
-
-      .. code-block:: python
-
-         >>> my_rect = pygame.Rect(0, 0, 2, 2)
-         >>> my_rect.relcenter
-         (1, 1)
-         >>> my_rect.relcenter = (128, 128)
-         >>> my_rect.size
-         (256, 256)
-
-      Beware of non-integer relative centers! For Rects (but not FRects), ``relcenter``
-      will truncate the numbers in the returned tuple.
-
-
    .. method:: copy
 
       | :sl:`copy the rectangle`
@@ -129,7 +96,7 @@
    .. method:: move
 
       | :sl:`moves the rectangle`
-      | :sg:`move(x, y, /) -> Rect`
+      | :sg:`move(x, y) -> Rect`
 
       Returns a new rectangle that is moved by the given offset. The x and y
       arguments can be any integer value, positive or negative.
@@ -139,33 +106,16 @@
    .. method:: move_ip
 
       | :sl:`moves the rectangle, in place`
-      | :sg:`move_ip(x, y, /) -> None`
+      | :sg:`move_ip(x, y) -> None`
 
       Same as the ``Rect.move()`` method, but operates in place.
 
       .. ## Rect.move_ip ##
 
-   .. method:: move_to
-
-      | :sl:`moves the rectangle to the specified position`
-      | :sg:`move_to(**kwargs) -> Rect`
-
-      Returns a new rectangle that is moved to the given position and optionally resized.
-      You must provide keyword arguments to the method such as ``center``, ``left``,
-      ``midbottom``, ``size`` that correspond to the rectangle's attributes and the
-      method will return a new rectangle whose specified attributes are set to the given value.
-
-      It is similar to :meth:`Surface.get_rect` but instead of a calling it as a surface method
-      you call it as a rectangle method.
-
-      .. versionadded:: 2.4.0
-
-      .. ## Rect.move_to ##
-
    .. method:: inflate
 
       | :sl:`grow or shrink the rectangle size`
-      | :sg:`inflate(x, y, /) -> Rect`
+      | :sg:`inflate(x, y) -> Rect`
 
       Returns a new rectangle with the size changed by the given offset. The
       rectangle remains centered around its current center. Negative values
@@ -177,7 +127,7 @@
    .. method:: inflate_ip
 
       | :sl:`grow or shrink the rectangle size, in place`
-      | :sg:`inflate_ip(x, y, /) -> None`
+      | :sg:`inflate_ip(x, y) -> None`
 
       Same as the ``Rect.inflate()`` method, but operates in place.
 
@@ -186,53 +136,49 @@
    .. method:: scale_by
 
       | :sl:`scale the rectangle by given a multiplier`
-      | :sg:`scale_by(scale_by) -> Rect`
-      | :sg:`scale_by(x, y) -> Rect`
+      | :sg:`scale_by(scalar) -> Rect`
+      | :sg:`scale_by(scalex, scaley) -> Rect`
 
       Returns a new rectangle with the size scaled by the given multipliers.
-      The rectangle remains centered around its current center. A single
+      The rectangle remains centered around its current center. A single 
       scalar or separate width and height scalars are allowed. Values above
       one will increase the size of the rectangle, whereas values between
       zero and one will decrease the size of the rectangle.
 
-      .. versionadded:: 2.3.1
-
-      .. versionchanged:: 2.5.2 the argument ``scale_by`` can now be passed as a positional argument
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
 
       .. ## Rect.scale_by ##
 
    .. method:: scale_by_ip
 
       | :sl:`grow or shrink the rectangle size, in place`
-      | :sg:`scale_by_ip(scale_by) -> None`
-      | :sg:`scale_by_ip(x, y) -> None`
+      | :sg:`scale_by_ip(scalar) -> None`
+      | :sg:`scale_by_ip(scalex, scaley) -> None`
 
       Same as the ``Rect.scale_by()`` method, but operates in place.
 
-      .. versionadded:: 2.3.1
-
-      .. versionchanged:: 2.5.2 the argument ``scale_by`` can now be passed as a positional argument
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
 
       .. ## Rect.scale_by_ip ##
 
    .. method:: update
 
       | :sl:`sets the position and size of the rectangle`
-      | :sg:`update(left, top, width, height, /) -> None`
-      | :sg:`update((left, top), (width, height), /) -> None`
-      | :sg:`update(object, /) -> None`
+      | :sg:`update(left, top, width, height) -> None`
+      | :sg:`update((left, top), (width, height)) -> None`
+      | :sg:`update(object) -> None`
 
       Sets the position and size of the rectangle, in place. See
       parameters for :meth:`pygame.Rect` for the parameters of this function.
 
-      .. versionaddedold:: 2.0.1
+      .. versionadded:: 2.0.1
 
       .. ## Rect.update ##
 
    .. method:: clamp
 
       | :sl:`moves the rectangle inside another`
-      | :sg:`clamp(rect, /) -> Rect`
+      | :sg:`clamp(Rect) -> Rect`
 
       Returns a new rectangle that is moved to be completely inside the
       argument Rect. If the rectangle is too large to fit inside, it is
@@ -243,7 +189,7 @@
    .. method:: clamp_ip
 
       | :sl:`moves the rectangle inside another, in place`
-      | :sg:`clamp_ip(rect, /) -> None`
+      | :sg:`clamp_ip(Rect) -> None`
 
       Same as the ``Rect.clamp()`` method, but operates in place.
 
@@ -252,7 +198,7 @@
    .. method:: clip
 
       | :sl:`crops a rectangle inside another`
-      | :sg:`clip(rect, /) -> Rect`
+      | :sg:`clip(Rect) -> Rect`
 
       Returns a new rectangle that is cropped to be completely inside the
       argument Rect. If the two rectangles do not overlap to begin with, a Rect
@@ -263,14 +209,14 @@
    .. method:: clipline
 
       | :sl:`crops a line inside a rectangle`
-      | :sg:`clipline(x1, y1, x2, y2, /) -> ((cx1, cy1), (cx2, cy2))`
-      | :sg:`clipline(x1, y1, x2, y2, /) -> ()`
-      | :sg:`clipline((x1, y1), (x2, y2), /) -> ((cx1, cy1), (cx2, cy2))`
-      | :sg:`clipline((x1, y1), (x2, y2), /) -> ()`
-      | :sg:`clipline((x1, y1, x2, y2), /) -> ((cx1, cy1), (cx2, cy2))`
-      | :sg:`clipline((x1, y1, x2, y2), /) -> ()`
-      | :sg:`clipline(((x1, y1), (x2, y2)), /) -> ((cx1, cy1), (cx2, cy2))`
-      | :sg:`clipline(((x1, y1), (x2, y2)), /) -> ()`
+      | :sg:`clipline(x1, y1, x2, y2) -> ((cx1, cy1), (cx2, cy2))`
+      | :sg:`clipline(x1, y1, x2, y2) -> ()`
+      | :sg:`clipline((x1, y1), (x2, y2)) -> ((cx1, cy1), (cx2, cy2))`
+      | :sg:`clipline((x1, y1), (x2, y2)) -> ()`
+      | :sg:`clipline((x1, y1, x2, y2)) -> ((cx1, cy1), (cx2, cy2))`
+      | :sg:`clipline((x1, y1, x2, y2)) -> ()`
+      | :sg:`clipline(((x1, y1), (x2, y2))) -> ((cx1, cy1), (cx2, cy2))`
+      | :sg:`clipline(((x1, y1), (x2, y2))) -> ()`
 
       Returns the coordinates of a line that is cropped to be completely inside
       the rectangle. If the line does not overlap the rectangle, then an empty
@@ -315,14 +261,16 @@
          else:
              print("No clipping. The line is fully outside the rect.")
 
-      .. versionaddedold:: 2.0.0
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+
+      .. versionadded:: 2.0.0
 
       .. ## Rect.clipline ##
 
    .. method:: union
 
       | :sl:`joins two rectangles into one`
-      | :sg:`union(rect, /) -> Rect`
+      | :sg:`union(Rect) -> Rect`
 
       Returns a new rectangle that completely covers the area of the two
       provided rectangles. There may be area inside the new Rect that is not
@@ -333,7 +281,7 @@
    .. method:: union_ip
 
       | :sl:`joins two rectangles into one, in place`
-      | :sg:`union_ip(rect, /) -> None`
+      | :sg:`union_ip(Rect) -> None`
 
       Same as the ``Rect.union()`` method, but operates in place.
 
@@ -342,25 +290,29 @@
    .. method:: unionall
 
       | :sl:`the union of many rectangles`
-      | :sg:`unionall(rect_sequence, /) -> Rect`
+      | :sg:`unionall(Rect_sequence) -> Rect`
 
       Returns the union of one rectangle with a sequence of many rectangles.
 
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+
       .. ## Rect.unionall ##
 
    .. method:: unionall_ip
 
       | :sl:`the union of many rectangles, in place`
-      | :sg:`unionall_ip(rect_sequence, /) -> None`
+      | :sg:`unionall_ip(Rect_sequence) -> None`
 
       The same as the ``Rect.unionall()`` method, but operates in place.
 
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+
       .. ## Rect.unionall_ip ##
 
    .. method:: fit
 
       | :sl:`resize and move a rectangle with aspect ratio`
-      | :sg:`fit(rect, /) -> Rect`
+      | :sg:`fit(Rect) -> Rect`
 
       Returns a new rectangle that is moved and resized to fit another. The
       aspect ratio of the original Rect is preserved, so the new rectangle may
@@ -382,7 +334,7 @@
    .. method:: contains
 
       | :sl:`test if one rectangle is inside another`
-      | :sg:`contains(rect, /) -> bool`
+      | :sg:`contains(Rect) -> bool`
 
       Returns true when the argument is completely inside the Rect.
 
@@ -391,8 +343,8 @@
    .. method:: collidepoint
 
       | :sl:`test if a point is inside a rectangle`
-      | :sg:`collidepoint(x, y, /) -> bool`
-      | :sg:`collidepoint((x, y), /) -> bool`
+      | :sg:`collidepoint(x, y) -> bool`
+      | :sg:`collidepoint((x,y)) -> bool`
 
       Returns true if the given point is inside the rectangle. A point along
       the right or bottom edge is not considered to be inside the rectangle.
@@ -406,7 +358,7 @@
    .. method:: colliderect
 
       | :sl:`test if two rectangles overlap`
-      | :sg:`colliderect(rect, /) -> bool`
+      | :sg:`colliderect(Rect) -> bool`
 
       Returns true if any portion of either rectangle overlap (except the
       top+bottom or left+right edges).
@@ -420,18 +372,20 @@
    .. method:: collidelist
 
       | :sl:`test if one rectangle in a list intersects`
-      | :sg:`collidelist(list, /) -> index`
+      | :sg:`collidelist(list) -> index`
 
       Test whether the rectangle collides with any in a sequence of rectangles.
       The index of the first collision found is returned. If no collisions are
       found an index of -1 is returned.
 
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+
       .. ## Rect.collidelist ##
 
    .. method:: collidelistall
 
       | :sl:`test if all rectangles in a list intersect`
-      | :sg:`collidelistall(list, /) -> indices`
+      | :sg:`collidelistall(list) -> indices`
 
       Returns a list of all the indices that contain rectangles that collide
       with the Rect. If no intersecting rectangles are found, an empty list is
@@ -440,46 +394,46 @@
       Not only Rects are valid arguments, but these are all valid calls:
 
       .. code-block:: python
-          :linenos:
-
+    
           Rect = pygame.Rect
           r = Rect(0, 0, 10, 10)
-
+          
           list_of_rects = [Rect(1, 1, 1, 1), Rect(2, 2, 2, 2)]
           indices0 = r.collidelistall(list_of_rects)
-
+          
           list_of_lists = [[1, 1, 1, 1], [2, 2, 2, 2]]
           indices1 = r.collidelistall(list_of_lists)
-
+          
           list_of_tuples = [(1, 1, 1, 1), (2, 2, 2, 2)]
           indices2 = r.collidelistall(list_of_tuples)
-
+          
           list_of_double_tuples = [((1, 1), (1, 1)), ((2, 2), (2, 2))]
           indices3 = r.collidelistall(list_of_double_tuples)
-
+          
           class ObjectWithRectAttribute(object):
               def __init__(self, r):
                   self.rect = r
-
+          
           list_of_object_with_rect_attribute = [
               ObjectWithRectAttribute(Rect(1, 1, 1, 1)),
               ObjectWithRectAttribute(Rect(2, 2, 2, 2)),
           ]
           indices4 = r.collidelistall(list_of_object_with_rect_attribute)
-
+          
           class ObjectWithCallableRectAttribute(object):
               def __init__(self, r):
                   self._rect = r
-
+          
               def rect(self):
                   return self._rect
-
+          
           list_of_object_with_callable_rect = [
               ObjectWithCallableRectAttribute(Rect(1, 1, 1, 1)),
               ObjectWithCallableRectAttribute(Rect(2, 2, 2, 2)),
           ]
           indices5 = r.collidelistall(list_of_object_with_callable_rect)
 
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
 
       .. ## Rect.collidelistall ##
 
@@ -489,6 +443,9 @@
       | :sg:`collideobjects(rect_list) -> object`
       | :sg:`collideobjects(obj_list, key=func) -> object`
 
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave collideobjects feedback with authors `_
+
       Test whether the rectangle collides with any object in the sequence.
       The object of the first collision found is returned. If no collisions are
       found then ``None`` is returned
@@ -499,7 +456,6 @@
       of them.
 
       .. code-block:: python
-          :linenos:
 
           r = Rect(1, 1, 10, 10)
 
@@ -547,6 +503,9 @@
       | :sg:`collideobjectsall(rect_list) -> objects`
       | :sg:`collideobjectsall(obj_list, key=func) -> objects`
 
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave collideobjectsall feedback with authors `_
+
       Returns a list of all the objects that contain rectangles that collide
       with the Rect. If no intersecting objects are found, an empty list is
       returned.
@@ -557,7 +516,6 @@
       of them.
 
       .. code-block:: python
-          :linenos:
 
           r = Rect(1, 1, 10, 10)
 
@@ -604,14 +562,14 @@
    .. method:: collidedict
 
       | :sl:`test if one rectangle in a dictionary intersects`
-      | :sg:`collidedict(rect_dict) -> (key, value)`
-      | :sg:`collidedict(rect_dict) -> None`
-      | :sg:`collidedict(rect_dict, values=False) -> (key, value)`
-      | :sg:`collidedict(rect_dict, values=False) -> None`
+      | :sg:`collidedict(dict) -> (key, value)`
+      | :sg:`collidedict(dict) -> None`
+      | :sg:`collidedict(dict, use_values=0) -> (key, value)`
+      | :sg:`collidedict(dict, use_values=0) -> None`
 
       Returns the first key and value pair that intersects with the calling
       Rect object. If no collisions are found, ``None`` is returned. If
-      ``values`` is False (default) then the dict's keys will be used in the
+      ``use_values`` is 0 (default) then the dict's keys will be used in the
       collision detection, otherwise the dict's values will be used.
 
       .. note ::
@@ -619,22 +577,19 @@
          hashable), so they must be converted to a tuple.
          e.g. ``rect.collidedict({tuple(key_rect) : value})``
 
-      .. versionchanged:: 2.4.0
-         ``values`` is now accepted as a keyword argument. Type Stub updated
-         to use boolean ``True`` or ``False``, but any truthy or falsy value
-         will be valid.
-
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+      
       .. ## Rect.collidedict ##
 
    .. method:: collidedictall
 
       | :sl:`test if all rectangles in a dictionary intersect`
-      | :sg:`collidedictall(rect_dict) -> [(key, value), ...]`
-      | :sg:`collidedictall(rect_dict, values=False) -> [(key, value), ...]`
+      | :sg:`collidedictall(dict) -> [(key, value), ...]`
+      | :sg:`collidedictall(dict, use_values=0) -> [(key, value), ...]`
 
       Returns a list of all the key and value pairs that intersect with the
       calling Rect object. If no collisions are found an empty list is returned.
-      If ``values`` is False (default) then the dict's keys will be used in the
+      If ``use_values`` is 0 (default) then the dict's keys will be used in the
       collision detection, otherwise the dict's values will be used.
 
       .. note ::
@@ -642,11 +597,8 @@
          hashable), so they must be converted to a tuple.
          e.g. ``rect.collidedictall({tuple(key_rect) : value})``
 
-      .. versionchanged:: 2.4.0
-         ``values`` is now accepted as a keyword argument. Type Stub updated
-         to use boolean ``True`` or ``False``, but any truthy or falsy value
-         will be valid.
-
+      .. versionchanged:: 2.5.0 Added support for keyword arguments.
+      
       .. ## Rect.collidedictall ##
 
    .. ## pygame.Rect ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/scrap.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/scrap.rst.txt
index c2c6734..1aac5d0 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/scrap.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/scrap.rst.txt
@@ -3,10 +3,13 @@
 :mod:`pygame.scrap`
 ===================
 
-.. autopgmodule:: pygame.scrap
-   :members:
+.. module:: pygame.scrap
+   :synopsis: pygame module for clipboard support.
 
-**THE BELOW INFORMATION IS DEPRECATED IN PYGAME 2.2.0 AND WILL BE REMOVED IN THE FUTURE.**
+| :sl:`pygame module for clipboard support.`
+
+**EXPERIMENTAL!**: This API may change or disappear in later pygame releases. If
+you use this, your code may break with the next pygame release.
 
 The scrap module is for transferring data to/from the clipboard. This allows
 for cutting and pasting data between pygame and other applications. Some basic
@@ -14,33 +17,57 @@ data (MIME) types are defined and registered:
 
 ::
 
-  "text/plain"                 Plain text (also accessible via the SCRAP_TEXT constant)
-  "text/plain;charset=utf-8"   UTF-8 encoded text
+   pygame         string
+  constant        value        description
+  --------------------------------------------------
+  SCRAP_TEXT   "text/plain"    plain text
+  SCRAP_BMP    "image/bmp"     BMP encoded image data
+  SCRAP_PBM    "image/pbm"     PBM encoded image data
+  SCRAP_PPM    "image/ppm"     PPM encoded image data
+
+``pygame.SCRAP_PPM``, ``pygame.SCRAP_PBM`` and ``pygame.SCRAP_BMP`` are
+suitable for surface buffers to be shared with other applications.
+``pygame.SCRAP_TEXT`` is an alias for the plain text clipboard type.
+
+Depending on the platform, additional types are automatically registered when
+data is placed into the clipboard to guarantee a consistent sharing behaviour
+with other applications. The following listed types can be used as strings to
+be passed to the respective :mod:`pygame.scrap` module functions.
 
 For **Windows** platforms, these additional types are supported automatically
 and resolve to their internal definitions:
 
 ::
 
-  "image/bmp"                  BMP encoded image data (also accessible via the SCRAP_BMP constant)
+  "text/plain;charset=utf-8"   UTF-8 encoded text
   "audio/wav"                  WAV encoded audio
   "image/tiff"                 TIFF encoded image data
 
+For **X11** platforms, these additional types are supported automatically and
+resolve to their internal definitions:
 
-User defined types can be used on **Windows**, but the data might not be
-accessible by other applications unless they know what data type to look for.
+::
+
+  "text/plain;charset=utf-8"   UTF-8 encoded text
+  "UTF8_STRING"                UTF-8 encoded text
+  "COMPOUND_TEXT"              COMPOUND text
+
+User defined types can be used, but the data might not be accessible by other
+applications unless they know what data type to look for.
 Example: Data placed into the clipboard by
 ``pygame.scrap.put("my_data_type", byte_data)`` can only be accessed by
 applications which query the clipboard for the ``"my_data_type"`` data type.
 
 For an example of how the scrap module works refer to the examples page
 (:func:`pygame.examples.scrap_clipboard.main`) or the code directly in GitHub
-(`pygame/examples/scrap_clipboard.py `_).
+(`pygame/examples/scrap_clipboard.py `_).
 
-.. versionaddedold:: 1.8
+.. versionadded:: 1.8
 
 .. note::
-   Non-text data is only supported on Windows. On other platforms only text is supported.
+   The scrap module is currently only supported for Windows, X11 and Mac OS X.
+   On Mac OS X only text works at the moment - other types may be supported in
+   future releases.
 
 .. function:: init
 
@@ -54,8 +81,6 @@ For an example of how the scrap module works refer to the examples page
    .. note:: The scrap module requires :func:`pygame.display.set_mode()` be
       called before being initialized.
 
-   .. deprecated:: 2.2.0
-
    .. ## pygame.scrap.init ##
 
 .. function:: get_init
@@ -69,15 +94,14 @@ For an example of how the scrap module works refer to the examples page
       initialized, ``False`` otherwise
    :rtype: bool
 
-   .. versionaddedold:: 1.9.5
-   .. deprecated:: 2.2.0
+   .. versionadded:: 1.9.5
 
    .. ## pygame.scrap.get_init ##
 
 .. function:: get
 
    | :sl:`Gets the data for the specified type from the clipboard.`
-   | :sg:`get(type, /) -> bytes | None`
+   | :sg:`get(type) -> bytes | None`
 
    Retrieves the data for the specified type from the clipboard. The data is
    returned as a byte string and might need further processing (such as
@@ -89,8 +113,6 @@ For an example of how the scrap module works refer to the examples page
       no data for the given type is available
    :rtype: bytes | None
 
-   .. deprecated:: 2.2.0
-
    ::
 
      text = pygame.scrap.get(pygame.SCRAP_TEXT)
@@ -115,8 +137,6 @@ For an example of how the scrap module works refer to the examples page
       is no data in the clipboard an empty list is returned
    :rtype: list
 
-   .. deprecated:: 2.2.0
-
    ::
 
      for t in pygame.scrap.get_types():
@@ -129,13 +149,13 @@ For an example of how the scrap module works refer to the examples page
 .. function:: put
 
    | :sl:`Places data into the clipboard.`
-   | :sg:`put(type, data, /) -> None`
+   | :sg:`put(type, data) -> None`
 
    Places data for a given clipboard type into the clipboard. The data must
    be a string buffer. The type is a string identifying the type of data to be
    placed into the clipboard. This can be one of the predefined
-   ``pygame.SCRAP_BMP`` or ``pygame.SCRAP_TEXT`` values or a user defined
-   string identifier.
+   ``pygame.SCRAP_PBM``, ``pygame.SCRAP_PPM``, ``pygame.SCRAP_BMP`` or
+   ``pygame.SCRAP_TEXT`` values or a user defined string identifier.
 
    :param string type: type identifier of the data to be placed into the
       clipboard
@@ -144,8 +164,6 @@ For an example of how the scrap module works refer to the examples page
 
    :raises pygame.error: if unable to put the data into the clipboard
 
-   .. deprecated:: 2.2.0
-
    ::
 
      with open("example.bmp", "rb") as fp:
@@ -160,7 +178,7 @@ For an example of how the scrap module works refer to the examples page
 .. function:: contains
 
    | :sl:`Checks whether data for a given type is available in the clipboard.`
-   | :sg:`contains(type, /) -> bool`
+   | :sg:`contains(type) -> bool`
 
    Checks whether data for the given type is currently available in the
    clipboard.
@@ -171,8 +189,6 @@ For an example of how the scrap module works refer to the examples page
       clipboard, ``False`` otherwise
    :rtype: bool
 
-   .. deprecated:: 2.2.0
-
    ::
 
      if pygame.scrap.contains(pygame.SCRAP_TEXT):
@@ -194,8 +210,6 @@ For an example of how the scrap module works refer to the examples page
       application, ``False`` if the pygame application still owns the clipboard
    :rtype: bool
 
-   .. deprecated:: 2.2.0
-
    ::
 
      if pygame.scrap.lost():
@@ -206,7 +220,7 @@ For an example of how the scrap module works refer to the examples page
 .. function:: set_mode
 
    | :sl:`Sets the clipboard access mode.`
-   | :sg:`set_mode(mode, /) -> None`
+   | :sg:`set_mode(mode) -> None`
 
    Sets the access mode for the clipboard. This is only of interest for X11
    environments where clipboard modes ``pygame.SCRAP_SELECTION`` (for mouse
@@ -221,7 +235,6 @@ For an example of how the scrap module works refer to the examples page
    :raises ValueError: if the ``mode`` parameter is not
       ``pygame.SCRAP_CLIPBOARD`` or ``pygame.SCRAP_SELECTION``
 
-   .. deprecated:: 2.2.0
-
    .. ## pygame.scrap.set_mode ##
+
 .. ## pygame.scrap ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt
index 839a1f7..6c674f1 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt
@@ -8,6 +8,9 @@
 
 | :sl:`Pygame module to work with controllers.`
 
+.. note::
+   Use import pygame._sdl2.controller before using this module.
+
 This module offers control over common controller types like the dualshock 4 or
 the xbox 360 controllers: They have two analog sticks, two triggers, two shoulder buttons,
 a dpad, 4 buttons on the side, 2 (or 3) buttons in the middle.
@@ -19,7 +22,11 @@ always the leftmost button of the 4 buttons on the right.
 Controllers can generate the following events::
 
    CONTROLLERAXISMOTION, CONTROLLERBUTTONDOWN, CONTROLLERBUTTONUP,
-   CONTROLLERDEVICEREMAPPED, CONTROLLERDEVICEADDED, CONTROLLERDEVICEREMOVED,
+   CONTROLLERDEVICEREMAPPED, CONTROLLERDEVICEADDED, CONTROLLERDEVICEREMOVED
+
+Additionally if pygame is built with SDL 2.0.14 or higher the following events can also be generated
+(to get the version of sdl pygame is built with use :meth:`pygame.version.SDL`)::
+
    CONTROLLERTOUCHPADDOWN, CONTROLLERTOUCHPADMOTION, CONTROLLERTOUCHPADUP
 
 These events can be enabled/disabled by :meth:`pygame._sdl2.controller.set_eventstate`
@@ -29,7 +36,7 @@ events related to controllers.
 .. note::
    See the :mod:`pygame.joystick` for a more versatile but more advanced api.
 
-.. versionaddedold:: 2 This module requires SDL2.
+.. versionadded:: 2 This module requires SDL2.
 
 .. function:: init
 
@@ -68,7 +75,7 @@ events related to controllers.
     .. note::
         Controllers can still generate joystick events, which will not be toggled by this function.
 
-    .. versionchangedold:: 2.0.2: Changed return type from int to None
+    .. versionchanged:: 2.0.2: Changed return type from int to None
 
     .. ## pygame._sdl2.controller.set_eventstate ##
 
@@ -80,7 +87,7 @@ events related to controllers.
     Returns the current state of events related to controllers, True meaning
     events will be posted.
 
-    .. versionaddedold:: 2.0.2
+    .. versionadded:: 2.0.2
 
     .. ## pygame._sdl2.controller.get_eventstate ##
 
@@ -123,14 +130,6 @@ events related to controllers.
     ``pygame._sdl2.controller.from_joystick``. Controllers are
     initialized on creation.
 
-   .. method:: init
-
-      | :sl:`Initialize the Controller`
-      | :sg:`init() -> None`
-
-      Initialize a controller object. This should not be used much, since
-      Controllers are initialised on creation.
-
    .. method:: quit
 
       | :sl:`uninitialize the Controller`
@@ -224,7 +223,7 @@ events related to controllers.
       Returns a dict containing the mapping of the Controller. For more
       information see :meth:`Controller.set_mapping()`
 
-      .. versionchangedold:: 2.0.2: Return type changed from ``str`` to ``dict``
+      .. versionchanged:: 2.0.2: Return type changed from ``str`` to ``dict``
 
       .. ## Controller.get_mapping ##
 
@@ -233,7 +232,7 @@ events related to controllers.
       | :sl:`Assign a mapping to the controller`
       | :sg:`set_mapping(mapping) -> int`
 
-      Rebind buttons, axes, triggers and dpads. The mapping should be a
+      Rebind buttons, axes, triggers and dpads. The mapping should be a 
       dict containing all buttons, hats and axes. The easiest way to get this
       is to use the dict returned by :meth:`Controller.get_mapping`. To edit
       this mapping assign a value to the original button. The value of the
@@ -253,8 +252,8 @@ events related to controllers.
 
       The function will return 1 if a new mapping is added or 0 if an existing one is updated.
 
-      .. versionchangedold:: 2.0.2: Renamed from ``add_mapping`` to ``set_mapping``
-      .. versionchangedold:: 2.0.2: Argument type changed from ``str`` to ``dict``
+      .. versionchanged:: 2.0.2: Renamed from ``add_mapping`` to ``set_mapping``
+      .. versionchanged:: 2.0.2: Argument type changed from ``str`` to ``dict``
 
       .. ## Controller.set_mapping ##
 
@@ -270,9 +269,9 @@ events related to controllers.
       playing, then it will be overwritten.
 
       Returns True if the rumble was played successfully or False if the
-      controller does not support it.
+      controller does not support it or :meth:`pygame.version.SDL` is below 2.0.9.
 
-      .. versionaddedold:: 2.0.2
+      .. versionadded:: 2.0.2
 
       .. ## Controller.rumble ##
 
@@ -284,24 +283,8 @@ events related to controllers.
       Stops any rumble effect playing on the controller. See
       :meth:`Controller.rumble` for more information.
 
-      .. versionaddedold:: 2.0.2
+      .. versionadded:: 2.0.2
 
       .. ## Controller.stop_rumble ##
 
-   .. method:: set_led
-
-      | :sl:`Set the LED color of the controller`
-      | :sg:`set_led(color_arg) -> bool`
-
-      Set the color of the LED on the controller. The argument is a
-      ``pygame.Color``-compatible value (alpha being ignored). The
-      controller's LED, if it has one, will be set to the input color.
-      If the controller does not have an addressable LED, then this
-      method will do nothing and return False. Returns True if the
-      LED was set successfully.
-
-      .. versionadded:: 2.5.6
-
-      .. ## Controller.set_led ##
-
 .. ## pygame._sdl2.controller ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_video.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_video.rst.txt
index 19f2a65..e273363 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_video.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sdl2_video.rst.txt
@@ -7,543 +7,328 @@
    :synopsis: Experimental pygame module for porting new SDL video systems
 
 .. warning::
-   This module isn't ready for prime time yet, it's still in development.
-   These docs are primarily meant to help the pygame developers and
-   super-early adopters who are in communication with the developers.
-   This API will change.
+	This module isn't ready for prime time yet, it's still in development.
+        These docs are primarily meant to help the pygame developers and super-early adopters
+        who are in communication with the developers. This API will change.
 
 | :sl:`Experimental pygame module for porting new SDL video systems`
 
-.. class:: RendererDriverInfo
-
-   | :sl:`pygame object encapsulating Renderer driver information`
-
-   Attributes:
-
-   ::
-
-      name
-      flags
-      num_texture_formats
-      max_texture_width
-      max_texture_height
-
-.. function:: get_drivers
-
-   | :sl:`Yield info about the rendering drivers available for Renderer objects`
-   | :sg:`get_drivers() -> Iterator[RendererDriverInfo]`
-
-.. function:: get_grabbed_window
-
-   | :sl:`Get the window with input grab enabled`
-   | :sg:`get_grabbed_window() -> Window or None`
-
-   Gets the :class:`Window` with input grab enabled, if input is grabbed,
-   otherwise ``None`` is returned.
-
-
 .. class:: Window
 
    | :sl:`pygame object that represents a window`
+   | :sg:`Window(title="pygame", size=(640, 480), position=None, fullscreen=False, fullscreen_desktop=False, keywords) -> Window`
 
-   See :class:`pygame.Window`
+   .. classmethod:: from_display_module
+   
+      | :sl:`Creates window using window created by pygame.display.set_mode().`
+      | :sg:`from_display_module() -> Window`
 
-.. class:: Texture
+   .. classmethod:: from_window
 
-   | :sl:`pygame object that represents a texture`
-   | :sg:`Texture(renderer, size, depth=0, static=False, streaming=False, target=False, scale_quality=None) -> Texture`
+      | :sl:`Create Window from another window. Could be from another UI toolkit.`
+      | :sg:`from_window(other) -> Window`
 
-   Creates an empty texture.
+   .. attribute:: grab
 
-   :param Renderer renderer: The rendering context for the texture.
-   :param tuple size: The width and height for the texture.
-   :param int depth: The pixel format (``0`` to use the default).
-   :param bool static: Initialize the texture as static
-                       (changes rarely, not lockable).
-   :param bool streaming: Initialize the texture as streaming
-                          (changes frequently, lockable).
-   :param bool target: Initialize the texture as target
-                       (can be used as a rendering target).
-   :param int scale_quality: Set the texture scale quality. Can be ``0``
-                             (nearest pixel sampling), ``1``
-                             (linear filtering, supported by OpenGL and Direct3D)
-                             and ``2`` (anisotropic filtering, supported by Direct3D).
+      | :sl:`Gets or sets whether the mouse is confined to the window.`
+      | :sg:`grab -> bool`
 
-   One of ``static``, ``streaming``, or ``target`` can be set
-   to ``True``. If all are ``False``, then ``static`` is used.
+   .. attribute:: relative_mouse
 
+      | :sl:`Gets or sets the window's relative mouse motion state.`
+      | :sg:`relative_mouse -> bool`
 
-   :class:`Texture` objects provide a platform-agnostic API for working with GPU textures.
-   They are stored in GPU video memory (VRAM), and are therefore very fast to
-   rotate and resize when drawn onto a :class:`Renderer`
-   (an object that manages a rendering context inside a :class:`Window`) on most GPUs.
+   .. method:: set_windowed
 
-   Since textures are stored in GPU video memory, they aren't as easy to modify
-   as the image data of :class:`pygame.Surface` objects, which reside in RAM.
+      | :sl:`Enable windowed mode (exit fullscreen).`
+      | :sg:`set_windowed() -> None`
 
-   Textures can be modified in 2 ways:
+   .. method:: set_fullscreen
 
-      * By drawing other textures onto them, achieved by marking them as "target" textures and setting them as the rendering target of their Renderer object (if properly configured and supported).
+      | :sl:`Enter fullscreen.`
+      | :sg:`set_fullscreen(desktop=False) -> None`
 
-      * By updating them with a Surface.
+   .. attribute:: title
 
-      .. note::
-         A :class:`pygame.Surface`-to-:class:`Texture` update is generally
-         considered a slow operation, as it requires image data to be uploaded from
-         RAM to VRAM, which can have a notable overhead cost.
+      | :sl:`Gets or sets whether the window title.`
+      | :sg:`title -> string`
+
+   .. method:: destroy
+
+      | :sl:`Destroys the window.`
+      | :sg:`destroy() -> None`
+
+   .. method:: hide
+
+      | :sl:`Hide the window.`
+      | :sg:`hide() -> None`
+
+   .. method:: show
+
+      | :sl:`Show the window.`
+      | :sg:`show() -> None`
+
+   .. method:: focus
+
+      | :sl:`Raise the window above other windows and set the input focus. The "input_only" argument is only supported on X11.`
+      | :sg:`focus(input_only=False) -> None`
+
+   .. method:: restore
+
+      | :sl:`Restore the size and position of a minimized or maximized window.`
+      | :sg:`restore() -> None`
+
+   .. method:: maximize
+
+      | :sl:`Maximize the window.`
+      | :sg:`maximize() -> None`
+
+   .. method:: minimize
+
+      | :sl:`Minimize the window.`
+      | :sg:`maximize() -> None`
+
+   .. attribute:: resizable
+
+      | :sl:`Gets and sets whether the window is resizable.`
+      | :sg:`resizable -> bool`
+
+   .. attribute:: borderless
+
+      | :sl:`Add or remove the border from the window.`
+      | :sg:`borderless -> bool`
+
+   .. method:: set_icon
+
+      | :sl:`Set the icon for the window.`
+      | :sg:`set_icon(surface) -> None`
+
+   .. attribute:: id
+
+      | :sl:`Get the unique window ID. *Read-only*`
+      | :sg:`id -> int`
+
+   .. attribute:: size
+
+      | :sl:`Gets and sets the window size.`
+      | :sg:`size -> (int, int)`
+
+   .. attribute:: position
+
+      | :sl:`Gets and sets the window position.`
+      | :sg:`position -> (int, int) or WINDOWPOS_CENTERED or WINDOWPOS_UNDEFINED`	
+
+   .. attribute:: opacity
+
+      | :sl:`Gets and sets the window opacity. Between 0.0 (fully transparent) and 1.0 (fully opaque).`
+      | :sg:`opacity -> float`
+
+   .. attribute:: display_index
+
+      | :sl:`Get the index of the display that owns the window. *Read-only*`
+      | :sg:`display_index -> int`
+
+   .. method:: set_modal_for
+
+      | :sl:`Set the window as a modal for a parent window. This function is only supported on X11.`
+      | :sg:`set_modal_for(Window) -> None`
+
+.. class:: Texture	
+
+   | :sl:`pygame object that representing a Texture.`
+   | :sg:`Texture(renderer, size, depth=0, static=False, streaming=False, target=False) -> Texture`
+
+   .. staticmethod:: from_surface
+
+      | :sl:`Create a texture from an existing surface.`
+      | :sg:`from_surface(renderer, surface) -> Texture`
 
    .. attribute:: renderer
 
-      | :sl:`Get the renderer associated with the texture (**read-only**)`
+      | :sl:`Gets the renderer associated with the Texture. *Read-only*`
       | :sg:`renderer -> Renderer`
 
    .. attribute:: width
 
-      | :sl:`Get the width of the texture (**read-only**)`
+      | :sl:`Gets the width of the Texture. *Read-only*`
       | :sg:`width -> int`
 
    .. attribute:: height
 
-      | :sl:`Get the height of the texture (**read-only**)`
+      | :sl:`Gets the height of the Texture. *Read-only*`
       | :sg:`height -> int`
 
    .. attribute:: alpha
 
-      | :sl:`Get or set the additional alpha value multiplied into draw operations`
+      | :sl:`Gets and sets an additional alpha value multiplied into render copy operations.`
       | :sg:`alpha -> int`
 
    .. attribute:: blend_mode
 
-      | :sl:`Get or set the blend mode for texture drawing operations`
+      | :sl:`Gets and sets the blend mode for the Texture.`
       | :sg:`blend_mode -> int`
 
-      Gets or sets the blend mode for the texture's drawing operations.
-      Valid blend modes are any of the ``BLENDMODE_*`` constants or a custom one.
-
    .. attribute:: color
 
-      | :sl:`Get or set the additional color value multiplied into texture drawing operations`
-      | :sg:`color -> Color`
-
-   .. staticmethod:: from_surface
-
-      | :sl:`Create a texture from an existing surface`
-      | :sg:`from_surface(renderer, surface) -> Texture`
-
-      :param Renderer renderer: Rendering context for the texture.
-      :param Surface surface: The surface to create a texture from.
+      | :sl:`Gets and sets an additional color value multiplied into render copy operations.`
+      | :sg:`color -> color`
 
    .. method:: get_rect
 
-      | :sl:`Get the rectangular area of the texture`
+      | :sl:`Get the rectangular area of the texture.`
       | :sg:`get_rect(**kwargs) -> Rect`
 
-      Like :meth:`pygame.Surface.get_rect`, this method returns a **new**
-      :class:`pygame.Rect` covering the entire texture. It will always
-      have a ``topleft`` of ``(0, 0)`` with a ``width`` and ``height`` the same size as the
-      texture.
-
    .. method:: draw
 
-      | :sl:`Copy a portion of the texture to the rendering target`
+      | :sl:`Copy a portion of the texture to the rendering target.`
       | :sg:`draw(srcrect=None, dstrect=None, angle=0, origin=None, flip_x=False, flip_y=False) -> None`
 
-      :param srcrect: The source rectangle on the texture, or ``None`` for the
-                      entire texture.
-      :param dstrect: The destination rectangle on the rendering target, or
-                      ``None`` for the entire rendering target. The texture
-                      will be stretched to fill ``dstrect``.
-      :param float angle: The angle (in degrees) to rotate dstrect around
-                          (clockwise).
-      :param origin: The point around which dstrect will be rotated.
-                     If ``None``, it will equal the center:
-                     ``(dstrect.w/2, dstrect.h/2)``.
-      :param bool flip_x: Flip the drawn texture portion horizontally (x - axis).
-      :param bool flip_y: Flip the drawn texture portion vertically (y - axis).
-
-   .. method:: draw_triangle
-
-      | :sl:`Copy a triangle portion of the texture to the rendering target using the given coordinates`
-      | :sg:`draw_triangle(p1_xy, p2_xy, p3_xy, p1_uv=(0.0, 0.0), p2_uv=(1.0, 1.0), p3_uv=(0.0, 1.0), p1_mod=(255, 255, 255, 255), p2_mod=(255, 255, 255, 255), p3_mod=(255, 255, 255, 255)) -> None`
-
-      :param p1_xy: The first vertex coordinate on the rendering target.
-      :param p2_xy: The second vertex coordinate on the rendering target.
-      :param p3_xy: The third vertex coordinate on the rendering target.
-      :param p1_uv: The first UV coordinate of the triangle portion.
-      :param p2_uv: The second UV coordinate of the triangle portion.
-      :param p3_uv: The third UV coordinate of the triangle portion.
-      :param p1_mod: The first vertex color modulation.
-      :param p2_mod: The second vertex color modulation.
-      :param p3_mod: The third vertex color modulation.
-
-   .. method:: draw_quad
-
-      | :sl:`Copy a quad portion of the texture to the rendering target using the given coordinates`
-      | :sg:`draw_quad(p1_xy, p2_xy, p3_xy, p4_xy, p1_uv=(0.0, 0.0), p2_uv=(1.0, 0.0), p3_uv=(1.0, 1.0), p4_uv=(0.0, 1.0), p1_mod=(255, 255, 255, 255), p2_mod=(255, 255, 255, 255), p3_mod=(255, 255, 255, 255), p4_mod=(255, 255, 255, 255)) -> None`
-
-      :param p1_xy: The first vertex coordinate on the rendering target.
-      :param p2_xy: The second vertex coordinate on the rendering target.
-      :param p3_xy: The third vertex coordinate on the rendering target.
-      :param p4_xy: The fourth vertex coordinate on the rendering target.
-      :param p1_uv: The first UV coordinate of the quad portion.
-      :param p2_uv: The second UV coordinate of the quad portion.
-      :param p3_uv: The third UV coordinate of the quad portion.
-      :param p4_uv: The fourth UV coordinate of the quad portion.
-      :param p1_mod: The first vertex color modulation.
-      :param p2_mod: The second vertex color modulation.
-      :param p3_mod: The third vertex color modulation.
-      :param p4_mod: The fourth vertex color modulation.
-
    .. method:: update
 
-      | :sl:`Update the texture with Surface (slow operation, use sparingly)`
+      | :sl:`Update the texture with a Surface. WARNING: Slow operation, use sparingly.`
       | :sg:`update(surface, area=None) -> None`
 
-      :param Surface surface: The source surface.
-      :param area: The rectangular area of the texture to update.
-
-      .. note::
-         This is a fairly slow function, intended for use with static textures
-         that do not change often.
-
-         If the texture is intended to be updated often, it is preferred to create
-         the texture as streaming and use the locking functions.
-
-         While this function will work with streaming textures, for optimization
-         reasons you may not get the pixels back if you lock the texture afterward.
-
-
 .. class:: Image
 
-   | :sl:`pygame object that represents a portion of a texture`
-   | :sg:`Image(texture_or_image, srcrect=None) -> Image`
+   | :sl:`Easy way to use a portion of a Texture without worrying about srcrect all the time.`
+   | :sg:`Image(textureOrImage, srcrect=None) -> Image`
 
-   Creates an Image.
+   .. method:: get_rect
 
-   :param Texture | Image texture_or_image: The Texture or an existing Image
-                                            object to create the Image from.
-   :param srcrect: The rectangular portion of the Texture or Image object
-                   passed to ``texture_or_image``.
+      | :sl:`Get the rectangular area of the Image.`
+      | :sg:`get_rect() -> Rect`
 
-   An :class:`Image` object represents a portion of a :class:`Texture`. Specifically,
-   they can be used to store and manipulate arguments for :meth:`Texture.draw`
-   in a more user-friendly way.
+   .. method:: draw
+
+      | :sl:`Copy a portion of the Image to the rendering target.`
+      | :sg:`draw(srcrect=None, dstrect=None) -> None`
 
    .. attribute:: angle
 
-      | :sl:`Get and set the angle the Image draws itself with`
+      | :sl:`Gets and sets the angle the Image draws itself with.`
       | :sg:`angle -> float`
 
+   .. attribute:: origin
+
+      | :sl:`Gets and sets the origin. Origin=None means the Image will be rotated around its center.`
+      | :sg:`origin -> (float, float) or None.`
+
    .. attribute:: flip_x
 
-      | :sl:`Get or set whether the Image is flipped on the x axis`
+      | :sl:`Gets and sets whether the Image is flipped on the x axis.`
       | :sg:`flip_x -> bool`
 
    .. attribute:: flip_y
 
-      | :sl:`Get or set whether the Image is flipped on the y axis`
+      | :sl:`Gets and sets whether the Image is flipped on the y axis.`
       | :sg:`flip_y -> bool`
 
    .. attribute:: color
 
-      | :sl:`Get or set the Image color modifier`
+      | :sl:`Gets and sets the Image color modifier.`
       | :sg:`color -> Color`
 
    .. attribute:: alpha
 
-      | :sl:`Get or set the Image alpha modifier (0-255)`
+      | :sl:`Gets and sets the Image alpha modifier.`
       | :sg:`alpha -> float`
 
    .. attribute:: blend_mode
 
-      | :sl:`Get or set the blend mode for the Image`
+      | :sl:`Gets and sets the blend mode for the Image.`
       | :sg:`blend_mode -> int`
 
    .. attribute:: texture
 
-      | :sl:`Get or set the Texture the Image is based on`
+      | :sl:`Gets and sets the Texture the Image is based on.`
       | :sg:`texture -> Texture`
 
    .. attribute:: srcrect
 
-      | :sl:`Get or set the Rect the Image is based on`
+      | :sl:`Gets and sets the Rect the Image is based on.`
       | :sg:`srcrect -> Rect`
 
-   .. attribute:: origin
-
-      | :sl:`Get or set the Image's origin of rotation`
-      | :sg:`origin -> (float, float) or None`
-
-      Gets or sets the Image's origin of rotation, a 2D point relative to
-      the topleft coordinates of the Image's rectangular area.
-
-      An origin of ``None`` means no origin was set and the Image will be
-      rotated around its center.
-
-   .. method:: get_rect
-
-      | :sl:`Get the rectangular area of the Image`
-      | :sg:`get_rect() -> Rect`
-
-      .. note::
-         The returned :class:`Rect` object might contain position information
-         relative to the bounds of the :class:`Texture` or Image object it was
-         created from.
-
-   .. method:: draw
-
-      | :sl:`Copy a portion of the Image to the rendering target`
-      | :sg:`draw(srcrect=None, dstrect=None) -> None`
-
-      :param srcrect: Source rectangle specifying a sub-Image, or ``None`` for the
-                      entire Image.
-      :param dstrect: Destination rectangle or position on the render target,
-                      or ``None`` for entire target. The Image is stretched to
-                      fill dstrect.
-
-
 .. class:: Renderer
 
-   | :sl:`pygame object wrapping a 2D rendering context for a window`
+   | :sl:`Create a 2D rendering context for a window.`
    | :sg:`Renderer(window, index=-1, accelerated=-1, vsync=False, target_texture=False) -> Renderer`
 
-   Creates a 2D rendering context for a window.
-
-   :param Window window: The window onto which the rendering context should be
-                         placed.
-   :param int index: The index of rendering driver to initialize, or ``-1`` to init
-                     the first supporting the requested options.
-   :param int accelerated: If 1, the renderer uses hardware acceleration.
-                           if 0, the renderer is a software fallback.
-                           ``-1`` gives precedence to renderers using hardware
-                           acceleration.
-   :param bool vsync: If ``True`` :meth:`Renderer.present` is synchronized with
-                      the refresh rate.
-   :param bool target_texture: Whether the renderer should support setting
-                              :class:`Texture` objects as target textures, to
-                              enable drawing onto them.
-
-
-   :class:`Renderer` objects provide a cross-platform API for rendering 2D
-   graphics onto a :class:`Window`, by using either Metal (macOS), OpenGL
-   (macOS, Windows, Linux) or Direct3D (Windows) rendering drivers, depending
-   on what is set or is available on a system during their creation.
-
-   They can be used to draw both :class:`Texture` objects and simple points,
-   lines and rectangles (which are colored based on :attr:`Renderer.draw_color`).
-
-   If configured correctly and supported by an underlying rendering driver, Renderer
-   objects can have a :class:`Texture` object temporarily set as a target texture
-   (the Texture object must have been created with target texture usage support),
-   which allows those textures to be drawn onto.
-
-   To present drawn content onto the window, :meth:`Renderer.present` should be
-   called. :meth:`Renderer.clear` should be called to clear any drawn content
-   with the set Renderer draw color.
-
-   When things are drawn onto Renderer objects, an internal batching system is
-   used by default to batch those "draw calls" together, to have all of them be
-   processed in one go when :meth:`Renderer.present` is called. This is unlike
-   :class:`pygame.Surface` objects, on which modifications via blitting occur
-   immediately, but lends well to the behavior of GPUs, as draw calls can be
-   expensive on lower-end models.
-
-   .. attribute:: draw_blend_mode
-
-      | :sl:`Get or set the blend mode used for primitive drawing operations`
-      | :sg:`draw_blend_mode -> int`
-
-   .. attribute:: draw_color
-
-      | :sl:`Get or set the color used for primitive drawing operations`
-      | :sg:`draw_color -> Color`
-
-   .. attribute:: logical_size
-
-      | :sl:`Get or set the logical Renderer size (a device independent resolution for rendering)`
-      | :sg:`logical_size -> (int width, int height)`
-
-      Note: When the rendering target is the main window, and ``logical_size``
-      has not been set before, it will contain ``(0, 0)`` and not the size of
-      the window.
-
-   .. attribute:: scale
-
-      | :sl:`Get the drawing scale for the current rendering target`
-      | :sg:`scale -> (float, float)`
-
-   .. attribute:: target
-
-      | :sl:`Get or set the current rendering target`
-      | :sg:`target -> Texture or None`
-
-      Gets or sets the current rendering target.
-      A value of ``None`` means that no custom rendering target was set and the
-      Renderer's window will be used as the target.
-
    .. classmethod:: from_window
 
-      | :sl:`Create a Renderer from an existing window`
+      | :sl:`Easy way to create a Renderer.`
       | :sg:`from_window(window) -> Renderer`
 
+   .. attribute:: draw_blend_mode
+
+      | :sl:`Gets and sets the blend mode used by the drawing functions.`
+      | :sg:`draw_blend_mode -> int`   
+
+   .. attribute:: draw_color
+
+      | :sl:`Gets and sets the color used by the drawing functions.`
+      | :sg:`draw_color -> Color`
+
    .. method:: clear
 
-      | :sl:`Clear the current rendering target with the drawing color`
+      | :sl:`Clear the current rendering target with the drawing color.`
       | :sg:`clear() -> None`
 
    .. method:: present
 
-      | :sl:`Update the screen with any rendering performed since the previous call`
-      | :sg:`present() -> None`
-
-      Presents the composed backbuffer to the screen.
-      Updates the screen with any rendering performed since the previous call.
+      | :sl:`Updates the screen with any new rendering since previous call.`
+      | :sg:`present() -> None`	
 
    .. method:: get_viewport
 
-      | :sl:`Get the drawing area on the rendering target`
+      | :sl:`Returns the drawing area on the target.`
       | :sg:`get_viewport() -> Rect`
 
    .. method:: set_viewport
 
-      | :sl:`Set the drawing area on the rendering target`
+      | :sl:`Set the drawing area on the target. If area is None, the entire target will be used.`
       | :sg:`set_viewport(area) -> None`
 
-      :param area: A :class:`pygame.Rect` or tuple representing the
-                   drawing area on the target, or ``None`` to use the
-                   entire area of the current rendering target.
+   .. attribute:: logical_size
 
-   .. method:: coordinates_to_window
+      | :sl:`Gets and sets the logical size.`
+      | :sg:`logical_size -> (int width, int height)`
 
-      | :sl:`Translates renderer coordinates to window coordinates`
-      | :sg:`coordinates_to_window(point) -> (float, float)`
+   .. attribute:: scale
 
-      :param point: The coordinates in render space.
+      | :sl:`Gets and sets the scale.`
+      | :sg:`scale -> (float x_scale, float y_scale)`
 
-      .. versionadded:: 2.5.6
+   .. attribute:: target
 
-
-   .. method:: coordinates_from_window
-
-      | :sl:`Translates window coordinates to renderer coordinates`
-      | :sg:`coordinates_from_window(point) -> (float, float)`
-
-      :param point: The coordinates in window space.
-
-      .. versionadded:: 2.5.6
+      | :sl:`Gets and sets the render target. None represents the default target (the renderer).`
+      | :sg:`target -> Texture or None`
 
    .. method:: blit
 
-      | :sl:`Draw textures using a Surface-like API`
+      | :sl:`For compatibility purposes. Textures created by different Renderers cannot be shared!`
       | :sg:`blit(source, dest, area=None, special_flags=0)-> Rect`
 
-      For compatibility purposes. Draws :class:`Texture` objects onto the
-      Renderer using a method signature similar to :meth:`pygame.Surface.blit`.
-
-      :param source: A :class:`Texture` or :class:`Image` to draw.
-      :param dest: The drawing destination on the rendering target.
-      :param area: The portion of the source texture or image to draw from.
-      :param special_flags: have no effect at this moment.
-
-      .. note:: Textures created by different Renderers cannot shared with each other!
-
    .. method:: draw_line
 
-      | :sl:`Draw a line`
+      | :sl:`Draws a line.`
       | :sg:`draw_line(p1, p2) -> None`
 
-      :param p1: The line start point.
-      :param p2: The line end point.
-
    .. method:: draw_point
 
-      | :sl:`Draw a point`
+      | :sl:`Draws a point.`
       | :sg:`draw_point(point) -> None`
 
-      :param point: The point's coordinates.
-
    .. method:: draw_rect
 
-      | :sl:`Draw a rectangle outline`
+      | :sl:`Draws a rectangle.`
       | :sg:`draw_rect(rect)-> None`
 
-      :param rect: The :class:`pygame.Rect`-like rectangle to draw.
-
    .. method:: fill_rect
 
-      | :sl:`Draw a filled rectangle`
+      | :sl:`Fills a rectangle.`
       | :sg:`fill_rect(rect)-> None`
 
-      :param rect: The :class:`pygame.Rect`-like rectangle to draw.
-
-   .. method:: draw_triangle
-
-      | :sl:`Draw a triangle outline`
-      | :sg:`draw_triangle(p1, p2, p3) -> None`
-
-      :param p1: The first triangle point.
-      :param p2: The second triangle point.
-      :param p2: The third triangle point.
-
-   .. method:: fill_triangle
-
-      | :sl:`Draw a filled triangle`
-      | :sg:`fill_triangle(p1, p2, p3) -> None`
-
-      :param p1: The first triangle point.
-      :param p2: The second triangle point.
-      :param p2: The third triangle point.
-
-   .. method:: draw_quad
-
-      | :sl:`Draw a quad outline`
-      | :sg:`draw_quad(p1, p2, p3, p4) -> None`
-
-      :param p1: The first quad point.
-      :param p2: The second quad point.
-      :param p2: The third quad point.
-      :param p2: The fourth quad point.
-
-   .. method:: fill_quad
-
-      | :sl:`Draw a filled quad`
-      | :sg:`fill_quad(p1, p2, p3, p4) -> None`
-
-      :param p1: The first quad point.
-      :param p2: The second quad point.
-      :param p2: The third quad point.
-      :param p2: The fourth quad point.
-
    .. method:: to_surface
 
-      | :sl:`Read pixels from current rendering target and create a Surface (slow operation, use sparingly)`
-      | :sg:`to_surface(surface=None, area=None)-> Surface`
-
-      Read pixel data from the current rendering target and return a
-      :class:`pygame.Surface` containing it.
-
-      :param Surface surface: A :class:`pygame.Surface` object to read the pixel
-                              data into. It must be large enough to fit the area, otherwise
-                              ``ValueError`` is raised.
-                              If set to ``None``, a new surface will be created.
-      :param area: The area of the screen to read pixels from. The area is
-                   clipped to fit inside the viewport.
-                   If ``None``, the entire viewport is used.
-
-      .. note::
-         This is a very slow operation, due to the overhead of the VRAM to RAM
-         data transfer and the cost of creating a potentially large
-         :class:`pygame.Surface`. It should not be used frequently.
-
-   .. method:: compose_custom_blend_mode
-
-      | :sl:`Compose a custom blend mode`
-      | :sg:`compose_custom_blend_mode(color_mode, alpha_mode) -> int`
-
-      Compose a custom blend mode.
-      See https://wiki.libsdl.org/SDL2/SDL_ComposeCustomBlendMode for more information.
-
-      :param color_mode: A tuple ``(srcColorFactor, dstColorFactor, colorOperation)``
-      :param alpha_mode: A tuple ``(srcAlphaFactor, dstAlphaFactor, alphaOperation)``
-
-      :return: A blend mode to be used with :meth:`Renderer.set_draw_blend_mode` and :meth:`Texture.set_blend_mode`.
+      | :sl:`Read pixels from current render target and create a pygame.Surface. WARNING: Slow operation, use sparingly.`
+      | :sg:`to_surface(surface=None, area=None)-> Surface`
\ No newline at end of file
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sndarray.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sndarray.rst.txt
index deeca7e..2a17764 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sndarray.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sndarray.rst.txt
@@ -3,5 +3,93 @@
 :mod:`pygame.sndarray`
 ======================
 
-.. autopgmodule:: pygame.sndarray
-   :members:
+.. module:: pygame.sndarray
+   :synopsis: pygame module for accessing sound sample data
+
+| :sl:`pygame module for accessing sound sample data`
+
+Functions to convert between NumPy arrays and Sound objects. This
+module will only be functional when pygame can use the external NumPy
+package. If NumPy can't be imported, ``surfarray`` becomes a ``MissingModule``
+object.
+
+Sound data is made of thousands of samples per second, and each sample is the
+amplitude of the wave at a particular moment in time. For example, in 22-kHz
+format, element number 5 of the array is the amplitude of the wave after
+5/22000 seconds.
+
+The arrays are indexed by the ``X`` axis first, followed by the ``Y`` axis.
+Each sample is an 8-bit or 16-bit integer, depending on the data format. A
+stereo sound file has two values per sample, while a mono sound file only has
+one.
+
+.. function:: array
+
+   | :sl:`copy Sound samples into an array`
+   | :sg:`array(Sound) -> array`
+
+   Creates a new array for the sound data and copies the samples. The array
+   will always be in the format returned from ``pygame.mixer.get_init()``.
+
+   .. ## pygame.sndarray.array ##
+
+.. function:: samples
+
+   | :sl:`reference Sound samples into an array`
+   | :sg:`samples(Sound) -> array`
+
+   Creates a new array that directly references the samples in a Sound object.
+   Modifying the array will change the Sound. The array will always be in the
+   format returned from ``pygame.mixer.get_init()``.
+
+   .. ## pygame.sndarray.samples ##
+
+.. function:: make_sound
+
+   | :sl:`convert an array into a Sound object`
+   | :sg:`make_sound(array) -> Sound`
+
+   Create a new playable Sound object from an array. The mixer module must be
+   initialized and the array format must be similar to the mixer audio format.
+
+   .. ## pygame.sndarray.make_sound ##
+
+.. function:: use_arraytype
+
+   | :sl:`Sets the array system to be used for sound arrays`
+   | :sg:`use_arraytype (arraytype) -> None`
+
+   DEPRECATED: Uses the requested array type for the module functions. The
+   only supported arraytype is ``'numpy'``. Other values will raise ValueError.
+   Using this function will raise a ``DeprecationWarning``.
+   .. ## pygame.sndarray.use_arraytype ##
+
+.. function:: get_arraytype
+
+   | :sl:`Gets the currently active array type.`
+   | :sg:`get_arraytype () -> str`
+
+   DEPRECATED: Returns the currently active array type. This will be a value of the
+   ``get_arraytypes()`` tuple and indicates which type of array module is used
+   for the array creation. Using this function will raise a ``DeprecationWarning``.
+
+   .. versionadded:: 1.8
+
+   .. ## pygame.sndarray.get_arraytype ##
+
+.. function:: get_arraytypes
+
+   | :sl:`Gets the array system types currently supported.`
+   | :sg:`get_arraytypes () -> tuple`
+
+   DEPRECATED: Checks, which array systems are available and returns them as a tuple of
+   strings. The values of the tuple can be used directly in the
+   :func:`pygame.sndarray.use_arraytype` () method. If no supported array
+   system could be found, None will be returned.  Using this function will raise a
+   ``DeprecationWarning``.
+
+   .. versionadded:: 1.8
+
+   .. ## pygame.sndarray.get_arraytypes ##
+
+.. ## pygame.sndarray ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/special_flags_list.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/special_flags_list.rst.txt
deleted file mode 100644
index 25c495f..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/special_flags_list.rst.txt
+++ /dev/null
@@ -1,115 +0,0 @@
-.. include:: common.txt
-
-====================
-:mod:`special flags`
-====================
-
-What Are Special Flags?
-=======================
-
-    **Special flags are a means of controlling how a** :class:`Surface` **is drawn onto another**.
-    They can be used to create visual effects, such as glowing particles, or to perform surface
-    masking or manipulation.
-    They are used with the following methods:
-
-        - :meth:`pygame.Surface.blit`
-        - :meth:`pygame.Surface.blits`
-        - :meth:`pygame.Surface.fblits`
-        - :meth:`pygame.Surface.fill`
-
-    Specifically they are passed as the ``special_flags`` argument of these methods by using
-    ``pygame.BLEND_*`` constants and allow you to choose how the colors of the surfaces are
-    combined or blended together. Different flags can produce widely different results, so
-    it is important to experiment to understand how they work.
-
-    By default, surfaces are drawn without any special flags, meaning they will be drawn based
-    on their bit ``depth`` and ``colorkey``:
-
-        - If the ``Surface`` has a ``colorkey``, the pixels matching the ``colorkey`` will be transparent.
-
-        - If the ``Surface`` has a per-pixel or global alpha value, the alpha value will be used to blend the
-          pixels with the ``Surface`` below.
-
-        - If the ``Surface`` doesn't have a ``colorkey`` or alpha value, the pixels will be opaque, meaning
-          that the ``Surface`` will effectively overwrite the pixels of the ``Surface`` below.
-
-    The default drawing mode has its own flag: ``BLENDMODE_NONE`` (``0``).
-
-Special Flags List
-==================
-
-**Blending without Alpha Channel (RGB)**
-
-----
-
-    .. versionaddedold:: 1.8 / 1.8.1
-
-       - ``BLEND_ADD`` / ``BLEND_RGB_ADD``
-           Adds the source color channels to the destination color channels, clamped to a maximum of 255.
-           The result color is always a lighter color or the same color.
-
-       - ``BLEND_SUB`` / ``BLEND_RGB_SUB``
-           Subtracts the source color channels from the destination color channels, clamped to a minimum of 0.
-           The result color is always a darker color or the same color.
-
-       - ``BLEND_MULT`` / ``BLEND_RGB_MULT``
-           Multiplies the destination color channels by the source color channels, divided by 256 (or >> 8).
-           The result color is always a darker color or the same color.
-
-       - ``BLEND_MIN`` / ``BLEND_RGB_MIN``
-           Takes the minimum value between the source and destination color channels.
-
-       - ``BLEND_MAX`` / ``BLEND_RGB_MAX``
-           Takes the maximum value of each color channel
-
-**Blending with Alpha Channel (RGBA)**
-
-----
-
-    .. versionaddedold:: 1.8.1
-
-       - ``BLEND_RGBA_ADD``
-           Works like ``BLEND_RGB_ADD``, but also adds the alpha channel.
-
-       - ``BLEND_RGBA_SUB``
-           Works like ``BLEND_RGB_SUB``, but also subtracts the alpha channel.
-
-       - ``BLEND_RGBA_MULT``
-           Works like ``BLEND_RGB_MULT``, but also multiplies the alpha channel.
-
-       - ``BLEND_RGBA_MIN``
-           Works like ``BLEND_RGB_MIN``, but also minimizes the alpha channel.
-
-       - ``BLEND_RGBA_MAX``
-           Works like ``BLEND_RGB_MAX``, but also maximizes the alpha channel.
-
-**Special Alpha Blending (RGBA)**
-
-----
-
-    .. versionaddedold:: 1.9.2
-
-       - ``BLEND_PREMULTIPLIED``
-           Uses premultiplied alpha blending for slightly faster blits and more
-           accurate blending results when the color channels are already multiplied
-           by the surface alpha channel.
-           You should only use this blend mode if you previously premultiplied the Surface with
-           :meth:`pygame.Surface.premul_alpha()`, or if you know that the Surface was already
-           created or loaded in with premultiplied alpha colors. You can read more about the
-           advantages of `premultiplied alpha blending
-           here `_.
-
-    .. versionaddedold:: 2.0.0
-
-       - ``BLEND_ALPHA_SDL2``
-           Uses the SDL2 blitter for alpha blending, which may give slightly different
-           results compared to the default blitter used in Pygame 1. This algorithm uses
-           different approximations for alpha blending and supports Run-Length Encoding
-           (RLE) on alpha-blended surfaces.
-
-**Other (RGB / RGBA)**
-
-----
-
-       - ``BLENDMODE_NONE``
-           It's the default drawing mode. It's equivalent to not passing any special flags.
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sprite.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sprite.rst.txt
index 16583d9..85c75dc 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sprite.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/sprite.rst.txt
@@ -20,14 +20,15 @@ sprites. A game could create new types of Group classes that operate on
 specially customized Sprite instances they contain.
 
 The basic Group class can draw the Sprites it contains to a Surface. The
-``Group.draw()`` method requires that each Sprite have a ``Sprite.image``
-attribute and a ``Sprite.rect``. The ``Group.clear()`` method requires these
+``Group.draw()`` method requires that each Sprite have a ``Surface.image``
+attribute and a ``Surface.rect``. The ``Group.clear()`` method requires these
 same attributes, and can be used to erase all the Sprites with background.
-There are also more advanced Groups: ``pygame.sprite.RenderUpdates()``.
+There are also more advanced Groups: ``pygame.sprite.RenderUpdates()`` and
+``pygame.sprite.OrderedUpdates()``.
 
 Lastly, this module contains several collision functions. These help find
 sprites inside multiple groups that have intersecting bounding rectangles. To
-find the collisions, the Sprites are required to have a ``Sprite.rect``
+find the collisions, the Sprites are required to have a ``Surface.rect``
 attribute assigned.
 
 The groups are designed for high efficiency in removing and adding Sprites to
@@ -64,24 +65,24 @@ Sprites are not thread safe. So lock them yourself if using threads.
    adding the Sprite to Groups. For example:
 
    .. code-block:: python
-
+   
        class Block(pygame.sprite.Sprite):
-
-           # Constructor. Pass in the color of the block,
+            
+           # Constructor. Pass in the color of the block, 
            # and its x and y position
            def __init__(self, color, width, height):
               # Call the parent class (Sprite) constructor
-              pygame.sprite.Sprite.__init__(self)
-
+              pygame.sprite.Sprite.__init__(self) 
+        
               # Create an image of the block, and fill it with a color.
               # This could also be an image loaded from the disk.
               self.image = pygame.Surface([width, height])
               self.image.fill(color)
-
+        
               # Fetch the rectangle object that has the dimensions of the image
               # Update the position of this object by setting the values of rect.x and rect.y
-              self.rect = self.image.get_rect()
-
+              self.rect = self.image.get_rect()   
+      
    .. method:: update
 
       | :sl:`method to control sprite behavior`
@@ -91,7 +92,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
       convenient "hook" that you can override. This method is called by
       ``Group.update()`` with whatever arguments you give it.
 
-      There is no need to use this method if not using the convenience method
+      It is not necessary to use this method if not using the convenience method
       by the same name in the Group class.
 
       .. ## Sprite.update ##
@@ -148,6 +149,11 @@ Sprites are not thread safe. So lock them yourself if using threads.
 
    .. ## pygame.sprite.Sprite ##
 
+.. class:: WeakSprite
+
+   | :sl:`A subclass of Sprite that references its Groups weakly. This means that any group this belongs to that is not referenced anywhere else is garbage collected automatically.`
+   | :sg:`WeakSprite(*groups) -> WeakSprite`
+
 .. class:: DirtySprite
 
    | :sl:`A subclass of Sprite with more attributes and features.`
@@ -202,8 +208,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
 
    A simple container for Sprite objects. This class can be inherited to create
    containers with more specific behaviors. The constructor takes any number of
-   Sprite arguments to add to the Group. All sprites in groups are stored in the
-   order they were added to the group. The group supports the following
+   Sprite arguments to add to the Group. The group supports the following
    standard Python operations:
 
    ::
@@ -213,6 +218,9 @@ Sprites are not thread safe. So lock them yourself if using threads.
        bool    test if any Sprites are contained
        iter    iterate through all the Sprites
 
+   The Sprites in the Group are ordered only on python 3.6 and higher.
+   Below python 3.6 drawing and iterating over the Sprites is in no particular order.
+
    .. method:: sprites
 
       | :sl:`list of the Sprites this Group contains`
@@ -244,7 +252,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
       Add any number of Sprites to this Group. This will only add Sprites that
       are not already members of the Group.
 
-      Each sprite argument can also be an iterator containing Sprites.
+      Each sprite argument can also be a iterator containing Sprites.
 
       .. ## Group.add ##
 
@@ -256,7 +264,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
       Remove any number of Sprites from the Group. This will only remove
       Sprites that are already members of the Group.
 
-      Each sprite argument can also be an iterator containing Sprites.
+      Each sprite argument can also be a iterator containing Sprites.
 
       .. ## Group.remove ##
 
@@ -269,7 +277,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
       similar to using the "in" operator on the Group ("if sprite in group:
       ..."), which tests if a single Sprite belongs to a Group.
 
-      Each sprite argument can also be an iterator containing Sprites.
+      Each sprite argument can also be a iterator containing Sprites.
 
       .. ## Group.has ##
 
@@ -291,17 +299,16 @@ Sprites are not thread safe. So lock them yourself if using threads.
    .. method:: draw
 
       | :sl:`blit the Sprite images`
-      | :sg:`draw(Surface, bgd=None, special_flags=0) -> list[Rect]`
+      | :sg:`draw(Surface, bgsurf=None, special_flags=0) -> List[Rect]`
 
       Draws the contained Sprites to the Surface argument. This uses the
       ``Sprite.image`` attribute for the source surface, and ``Sprite.rect``
       for the position. ``special_flags`` is passed to ``Surface.blit()``.
-      ``bgd`` is unused in this method but ``LayeredDirty.draw()`` uses
+      ``bgsurf`` is unused in this method but ``LayeredDirty.draw()`` uses
       it.
 
-      The Group keeps sprites in the order they were added, they will be drawn in this order.
-
-      .. versionchanged:: 2.5.4 Added the ``bgd`` and ``special_flags`` arguments
+      The Group does not keep sprites in any order, so the draw order is
+      arbitrary.
 
       .. ## Group.draw ##
 
@@ -340,6 +347,27 @@ Sprites are not thread safe. So lock them yourself if using threads.
 
    .. ## pygame.sprite.Group ##
 
+.. class:: WeakDirtySprite
+
+   | :sl:`A subclass of WeakSprite and DirtySprite that combines the benefits of both classes.`
+   | :sg:`WeakDirtySprite(*groups) -> WeakDirtySprite`
+
+.. class:: RenderPlain
+
+   | :sl:`Same as pygame.sprite.Group`
+
+   This class is an alias to ``pygame.sprite.Group()``. It has no additional functionality.
+
+   .. ## pygame.sprite.RenderClear ##
+
+.. class:: RenderClear
+
+   | :sl:`Same as pygame.sprite.Group`
+
+   This class is an alias to ``pygame.sprite.Group()``. It has no additional functionality.
+
+   .. ## pygame.sprite.RenderClear ##
+
 .. class:: RenderUpdates
 
    | :sl:`Group sub-class that tracks dirty updates.`
@@ -351,29 +379,38 @@ Sprites are not thread safe. So lock them yourself if using threads.
    .. method:: draw
 
       | :sl:`blit the Sprite images and track changed areas`
-      | :sg:`draw(surface, bgd=None, special_flags=0) -> Rect_list`
+      | :sg:`draw(surface, bgsurf=None, special_flags=0) -> Rect_list`
 
       Draws all the Sprites to the surface, the same as ``Group.draw()``. This
       method also returns a list of Rectangular areas on the screen that have
       been changed. The returned changes include areas of the screen that have
       been affected by previous ``Group.clear()`` calls. ``special_flags`` is
-      passed to ``Surface.blit()``. ``bgd`` is unused in this method but
-      ``LayeredDirty.draw()`` uses it.
+      passed to ``Surface.blit()``.
 
       The returned Rect list should be passed to ``pygame.display.update()``.
       This will help performance on software driven display modes. This type of
       updating is usually only helpful on destinations with non-animating
       backgrounds.
 
-      .. versionchanged:: 2.5.4 Added the ``bgd`` and ``special_flags`` arguments
-
       .. ## RenderUpdates.draw ##
 
    .. ## pygame.sprite.RenderUpdates ##
 
+.. function:: OrderedUpdates
+
+   | :sl:`RenderUpdates sub-class that draws Sprites in order of addition.`
+   | :sg:`OrderedUpdates(*sprites) -> OrderedUpdates`
+
+   This class derives from ``pygame.sprite.RenderUpdates()``. It maintains the
+   order in which the Sprites were added to the Group for rendering. This makes
+   adding and removing Sprites from the Group a little slower than regular
+   Groups.
+
+   .. ## pygame.sprite.OrderedUpdates ##
+
 .. class:: LayeredUpdates
 
-   | :sl:`LayeredUpdates is a sprite group that handles layers and draws like RenderUpdates.`
+   | :sl:`LayeredUpdates is a sprite group that handles layers and draws like OrderedUpdates.`
    | :sg:`LayeredUpdates(*sprites, **kwargs) -> LayeredUpdates`
 
    This group is fully compatible with :class:`pygame.sprite.Sprite`.
@@ -387,7 +424,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
    has attribute layer nor \**kwarg then the default layer is used to add the
    sprites.
 
-   .. versionaddedold:: 1.8
+   .. versionadded:: 1.8
 
    .. method:: add
 
@@ -403,7 +440,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
 
    .. method:: sprites
 
-      | :sl:`returns an ordered list of sprites (first back, last top).`
+      | :sl:`returns a ordered list of sprites (first back, last top).`
       | :sg:`sprites() -> sprites`
 
       .. ## LayeredUpdates.sprites ##
@@ -411,9 +448,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
    .. method:: draw
 
       | :sl:`draw all sprites in the right order onto the passed surface.`
-      | :sg:`draw(surface, bgd=None, special_flags=0) -> Rect_list`
-
-      .. versionchanged:: 2.5.4 Added the ``bgd`` and ``special_flags`` arguments
+      | :sg:`draw(surface, bgsurf=None, special_flags=0) -> Rect_list`
 
       .. ## LayeredUpdates.draw ##
 
@@ -556,18 +591,18 @@ Sprites are not thread safe. So lock them yourself if using threads.
        _time_threshold: threshold time for switching between dirty rect mode
            and fullscreen mode, defaults to 1000./80  == 1000./fps
 
-   .. versionaddedold:: 1.8
+   .. versionadded:: 1.8
 
    .. method:: draw
 
       | :sl:`draw all sprites in the right order onto the passed surface.`
-      | :sg:`draw(surface, bgd=None, special_flags=None) -> Rect_list`
+      | :sg:`draw(surface, bgsurf=None, special_flags=None) -> Rect_list`
 
       You can pass the background too. If a background is already set, then the
-      bgd argument has no effect. ``special_flags`` is passed to
-      ``Surface.blit()``.
-
-      .. versionchanged:: 2.5.4 Added the ``special_flags`` argument
+      bgsurf argument has no effect. If present, the ``special_flags`` argument is
+      always passed to ``Surface.blit()``, overriding ``DirtySprite.blendmode``. 
+      If ``special_flags`` is not present, ``DirtySprite.blendmode`` is passed
+      to the ``Surface.blit()`` instead.
 
       .. ## LayeredDirty.draw ##
 
@@ -617,7 +652,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
 
       DEPRECATED: Use set_timing_threshold() instead.
 
-      .. deprecatedold:: 2.1.1
+      .. deprecated:: 2.1.1
 
       .. ## LayeredDirty.set_timing_treshold ##
 
@@ -631,7 +666,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
       method is taking so long to update the screen that the frame rate falls
       below 80 frames per second.
 
-      .. versionaddedold:: 2.1.1
+      .. versionadded:: 2.1.1
 
       :raises TypeError: if ``time_ms`` is not int or float
 
@@ -680,17 +715,17 @@ Sprites are not thread safe. So lock them yourself if using threads.
        collide_circle_ratio, collide_mask
 
    Example:
-
+   
    .. code-block:: python
 
     # See if the Sprite block has collided with anything in the Group block_list
     # The True flag will remove the sprite in block_list
-    blocks_hit_list = pygame.sprite.spritecollide(player, block_list, True)
-
+    blocks_hit_list = pygame.sprite.spritecollide(player, block_list, True)  
+     
     # Check the list of colliding sprites, and add one to the score for each one
     for block in blocks_hit_list:
         score +=1
-
+       
    .. ## pygame.sprite.spritecollide ##
 
 .. function:: collide_rect
@@ -703,7 +738,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
    callback function to the \*collide functions. Sprites must have a "rect"
    attributes.
 
-   .. versionaddedold:: 1.8
+   .. versionadded:: 1.8
 
    .. ## pygame.sprite.collide_rect ##
 
@@ -721,7 +756,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
    A ratio is a floating point number - 1.0 is the same size, 2.0 is twice as
    big, and 0.5 is half the size.
 
-   .. versionaddedold:: 1.8.1
+   .. versionadded:: 1.8.1
 
    .. ## pygame.sprite.collide_rect_ratio ##
 
@@ -738,7 +773,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
    \*collide functions. Sprites must have a "rect" and an optional "radius"
    attribute.
 
-   .. versionaddedold:: 1.8.1
+   .. versionadded:: 1.8.1
 
    .. ## pygame.sprite.collide_circle ##
 
@@ -765,7 +800,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
    the \*collide functions. Sprites must have a "rect" and an optional "radius"
    attribute.
 
-   .. versionaddedold:: 1.8.1
+   .. versionadded:: 1.8.1
 
    .. ## pygame.sprite.collide_circle_ratio ##
 
@@ -808,7 +843,7 @@ Sprites are not thread safe. So lock them yourself if using threads.
       collision
    :rtype: tuple(int, int) or NoneType
 
-   .. versionaddedold:: 1.8.0
+   .. versionadded:: 1.8.0
 
    .. ## pygame.sprite.collide_mask ##
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surface.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surface.rst.txt
index 47914f6..82466fc 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surface.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surface.rst.txt
@@ -5,6 +5,945 @@
 
 .. currentmodule:: pygame
 
-.. autopgclass:: Surface
-   :members:
-   :private-members: +_pixels_address
+.. class:: Surface
+
+   | :sl:`pygame object for representing images`
+   | :sg:`Surface((width, height), flags=0, depth=0, masks=None) -> Surface`
+   | :sg:`Surface((width, height), flags=0, Surface) -> Surface`
+
+   A pygame Surface is used to represent any image. The Surface has a fixed
+   resolution and pixel format. Surfaces with 8-bit pixels use a color palette
+   to map to 24-bit color.
+
+   Call :meth:`pygame.Surface()` to create a new image object. The Surface will
+   be cleared to all black. The only required arguments are the sizes. With no
+   additional arguments, the Surface will be created in a format that best
+   matches the display Surface.
+
+   The pixel format can be controlled by passing the bit depth or an existing
+   Surface. The flags argument is a bitmask of additional features for the
+   surface. You can pass any combination of these flags:
+
+   ::
+
+     HWSURFACE    (obsolete in pygame 2) creates the image in video memory
+     SRCALPHA     the pixel format will include a per-pixel alpha
+
+   Both flags are only a request, and may not be possible for all displays and
+   formats.
+
+   Advance users can combine a set of bitmasks with a depth value. The masks
+   are a set of 4 integers representing which bits in a pixel will represent
+   each color. Normal Surfaces should not require the masks argument.
+
+   Surfaces can have many extra attributes like alpha planes, colorkeys, source
+   rectangle clipping. These functions mainly effect how the Surface is blitted
+   to other Surfaces. The blit routines will attempt to use hardware
+   acceleration when possible, otherwise they will use highly optimized
+   software blitting methods.
+
+   There are three types of transparency supported in pygame: colorkeys,
+   surface alphas, and pixel alphas. Surface alphas can be mixed with
+   colorkeys, but an image with per pixel alphas cannot use the other modes.
+   Colorkey transparency makes a single color value transparent. Any pixels
+   matching the colorkey will not be drawn. The surface alpha value is a single
+   value that changes the transparency for the entire image. A surface alpha of
+   255 is opaque, and a value of 0 is completely transparent.
+
+   Per pixel alphas are different because they store a transparency value for
+   every pixel. This allows for the most precise transparency effects, but it
+   also the slowest. Per pixel alphas cannot be mixed with surface alpha and
+   colorkeys.
+
+   There is support for pixel access for the Surfaces. Pixel access on hardware
+   surfaces is slow and not recommended. Pixels can be accessed using the
+   :meth:`get_at()` and :meth:`set_at()` functions. These methods are fine for
+   simple access, but will be considerably slow when doing of pixel work with
+   them. If you plan on doing a lot of pixel level work, it is recommended to
+   use a :class:`pygame.PixelArray`, which gives an array like view of the
+   surface. For involved mathematical manipulations try the
+   :mod:`pygame.surfarray` module (It's quite quick, but requires NumPy.)
+
+   Any functions that directly access a surface's pixel data will need that
+   surface to be lock()'ed. These functions can :meth:`lock()` and
+   :meth:`unlock()` the surfaces themselves without assistance. But, if a
+   function will be called many times, there will be a lot of overhead for
+   multiple locking and unlocking of the surface. It is best to lock the
+   surface manually before making the function call many times, and then
+   unlocking when you are finished. All functions that need a locked surface
+   will say so in their docs. Remember to leave the Surface locked only while
+   necessary.
+
+   Surface pixels are stored internally as a single number that has all the
+   colors encoded into it. Use the :meth:`map_rgb()` and
+   :meth:`unmap_rgb()` to convert between individual red, green, and blue
+   values into a packed integer for that Surface.
+
+   Surfaces can also reference sections of other Surfaces. These are created
+   with the :meth:`subsurface()` method. Any change to either Surface will
+   effect the other.
+
+   Each Surface contains a clipping area. By default the clip area covers the
+   entire Surface. If it is changed, all drawing operations will only effect
+   the smaller area.
+
+   .. method:: blit
+
+      | :sl:`draw one image onto another`
+      | :sg:`blit(source, dest, area=None, special_flags=0) -> Rect`
+
+      Draws a source Surface onto this Surface. The draw can be positioned with
+      the dest argument. The dest argument can either be a pair of coordinates representing the position of
+      the upper left corner of the blit or a Rect, where the upper left corner of the rectangle will be used as the
+      position for the blit. The size of the destination rectangle does not
+      effect the blit.
+
+      An optional area rectangle can be passed as well. This represents a
+      smaller portion of the source Surface to draw.
+
+      .. versionadded:: 1.8
+         Optional ``special_flags``: ``BLEND_ADD``, ``BLEND_SUB``,
+         ``BLEND_MULT``, ``BLEND_MIN``, ``BLEND_MAX``.
+
+      .. versionadded:: 1.8.1
+         Optional ``special_flags``: ``BLEND_RGBA_ADD``, ``BLEND_RGBA_SUB``,
+         ``BLEND_RGBA_MULT``, ``BLEND_RGBA_MIN``, ``BLEND_RGBA_MAX``
+         ``BLEND_RGB_ADD``, ``BLEND_RGB_SUB``, ``BLEND_RGB_MULT``,
+         ``BLEND_RGB_MIN``, ``BLEND_RGB_MAX``.
+
+      .. versionadded:: 1.9.2
+         Optional ``special_flags``: ``BLEND_PREMULTIPLIED``
+
+      .. versionadded:: 2.0.0
+         Optional ``special_flags``:  ``BLEND_ALPHA_SDL2`` - Uses the SDL2 blitter for alpha blending,
+         this gives different results than the default blitter, which is modelled after SDL1, due to
+         different approximations used for the alpha blending formula. The SDL2 blitter also supports
+         RLE on alpha blended surfaces which the pygame one does not.
+
+      The return rectangle is the area of the affected pixels, excluding any
+      pixels outside the destination Surface, or outside the clipping area.
+
+      Pixel alphas will be ignored when blitting to an 8 bit Surface.
+
+      For a surface with colorkey or blanket alpha, a blit to self may give
+      slightly different colors than a non self-blit.
+
+      .. ## Surface.blit ##
+
+   .. method:: blits
+
+      | :sl:`draw many images onto another`
+      | :sg:`blits(blit_sequence=((source, dest), ...), doreturn=1) -> [Rect, ...] or None`
+      | :sg:`blits(((source, dest, area), ...)) -> [Rect, ...]`
+      | :sg:`blits(((source, dest, area, special_flags), ...)) -> [Rect, ...]`
+
+      Draws many surfaces onto this Surface. It takes a sequence as input,
+      with each of the elements corresponding to the ones of :meth:`blit()`.
+      It needs at minimum a sequence of (source, dest).
+
+      :param blit_sequence: a sequence of surfaces and arguments to blit them,
+         they correspond to the :meth:`blit()` arguments
+      :param doreturn: if ``True``, return a list of rects of the areas changed,
+         otherwise return ``None``
+
+      :returns: a list of rects of the areas changed if ``doreturn`` is
+         ``True``, otherwise ``None``
+      :rtype: list or None
+
+      New in pygame 1.9.4.
+
+      .. ## Surface.blits ##
+
+
+   .. method:: convert
+
+      | :sl:`change the pixel format of an image`
+      | :sg:`convert(Surface=None) -> Surface`
+      | :sg:`convert(depth, flags=0) -> Surface`
+      | :sg:`convert(masks, flags=0) -> Surface`
+
+      Creates a new copy of the Surface with the pixel format changed. The new
+      pixel format can be determined from another existing Surface. Otherwise
+      depth, flags, and masks arguments can be used, similar to the
+      :meth:`pygame.Surface()` call.
+
+      If no arguments are passed the new Surface will have the same pixel
+      format as the display Surface. This is always the fastest format for
+      blitting. It is a good idea to convert all Surfaces before they are
+      blitted many times.
+
+      The converted Surface will have no pixel alphas. They will be stripped if
+      the original had them. See :meth:`convert_alpha()` for preserving or
+      creating per-pixel alphas.
+
+      The new copy will have the same class as the copied surface. This lets
+      as Surface subclass inherit this method without the need to override,
+      unless subclass specific instance attributes also need copying.
+
+      .. ## Surface.convert ##
+
+   .. method:: convert_alpha
+
+      | :sl:`change the pixel format of an image including per pixel alphas`
+      | :sg:`convert_alpha(Surface) -> Surface`
+      | :sg:`convert_alpha() -> Surface`
+
+      Creates a new copy of the surface with the desired pixel format. The new
+      surface will be in a format suited for quick blitting to the given format
+      with per pixel alpha. If no surface is given, the new surface will be
+      optimized for blitting to the current display.
+
+      Unlike the :meth:`convert()` method, the pixel format for the new
+      image will not be exactly the same as the requested source, but it will
+      be optimized for fast alpha blitting to the destination.
+
+      As with :meth:`convert()` the returned surface has the same class as
+      the converted surface.
+
+      .. ## Surface.convert_alpha ##
+
+   .. method:: copy
+
+      | :sl:`create a new copy of a Surface`
+      | :sg:`copy() -> Surface`
+
+      Makes a duplicate copy of a Surface. The new surface will have the same
+      pixel formats, color palettes, transparency settings, and class as the
+      original. If a Surface subclass also needs to copy any instance specific
+      attributes then it should override ``copy()``.
+
+      .. ## Surface.copy ##
+
+   .. method:: fill
+
+      | :sl:`fill Surface with a solid color`
+      | :sg:`fill(color, rect=None, special_flags=0) -> Rect`
+
+      Fill the Surface with a solid color. If no rect argument is given the
+      entire Surface will be filled. The rect argument will limit the fill to a
+      specific area. The fill will also be contained by the Surface clip area.
+
+      The color argument can be either a ``RGB`` sequence, a ``RGBA`` sequence
+      or a mapped color index. If using ``RGBA``, the Alpha (A part of
+      ``RGBA``) is ignored unless the surface uses per pixel alpha (Surface has
+      the ``SRCALPHA`` flag).
+
+      .. versionadded:: 1.8
+         Optional ``special_flags``: ``BLEND_ADD``, ``BLEND_SUB``,
+         ``BLEND_MULT``, ``BLEND_MIN``, ``BLEND_MAX``.
+
+      .. versionadded:: 1.8.1
+         Optional ``special_flags``: ``BLEND_RGBA_ADD``, ``BLEND_RGBA_SUB``,
+         ``BLEND_RGBA_MULT``, ``BLEND_RGBA_MIN``, ``BLEND_RGBA_MAX``
+         ``BLEND_RGB_ADD``, ``BLEND_RGB_SUB``, ``BLEND_RGB_MULT``,
+         ``BLEND_RGB_MIN``, ``BLEND_RGB_MAX``.
+
+      This will return the affected Surface area.
+
+      .. ## Surface.fill ##
+
+   .. method:: scroll
+
+      | :sl:`Shift the surface image in place`
+      | :sg:`scroll(dx=0, dy=0) -> None`
+
+      Move the image by dx pixels right and dy pixels down. dx and dy may be
+      negative for left and up scrolls respectively. Areas of the surface that
+      are not overwritten retain their original pixel values. Scrolling is
+      contained by the Surface clip area. It is safe to have dx and dy values
+      that exceed the surface size.
+
+      .. versionadded:: 1.9
+
+      .. ## Surface.scroll ##
+
+   .. method:: set_colorkey
+
+      | :sl:`Set the transparent colorkey`
+      | :sg:`set_colorkey(Color, flags=0) -> None`
+      | :sg:`set_colorkey(None) -> None`
+
+      Set the current color key for the Surface. When blitting this Surface
+      onto a destination, any pixels that have the same color as the colorkey
+      will be transparent. The color can be an ``RGB`` color or a mapped color
+      integer. If ``None`` is passed, the colorkey will be unset.
+
+      The colorkey will be ignored if the Surface is formatted to use per pixel
+      alpha values. The colorkey can be mixed with the full Surface alpha
+      value.
+
+      The optional flags argument can be set to ``pygame.RLEACCEL`` to provide
+      better performance on non accelerated displays. An ``RLEACCEL`` Surface
+      will be slower to modify, but quicker to blit as a source.
+
+      .. ## Surface.set_colorkey ##
+
+   .. method:: get_colorkey
+
+      | :sl:`Get the current transparent colorkey`
+      | :sg:`get_colorkey() -> RGB or None`
+
+      Return the current colorkey value for the Surface. If the colorkey is not
+      set then ``None`` is returned.
+
+      .. ## Surface.get_colorkey ##
+
+   .. method:: set_alpha
+
+      | :sl:`set the alpha value for the full Surface image`
+      | :sg:`set_alpha(value, flags=0) -> None`
+      | :sg:`set_alpha(None) -> None`
+
+      Set the current alpha value for the Surface. When blitting this Surface
+      onto a destination, the pixels will be drawn slightly transparent. The
+      alpha value is an integer from 0 to 255, 0 is fully transparent and 255
+      is fully opaque. If ``None`` is passed for the alpha value, then alpha
+      blending will be disabled, including per-pixel alpha.
+
+      This value is different than the per pixel Surface alpha. For a surface
+      with per pixel alpha, blanket alpha is ignored and ``None`` is returned.
+
+      .. versionchanged:: 2.0 per-surface alpha can be combined with per-pixel
+                          alpha.
+
+      The optional flags argument can be set to ``pygame.RLEACCEL`` to provide
+      better performance on non accelerated displays. An ``RLEACCEL`` Surface
+      will be slower to modify, but quicker to blit as a source.
+
+      .. ## Surface.set_alpha ##
+
+   .. method:: get_alpha
+
+      | :sl:`get the current Surface transparency value`
+      | :sg:`get_alpha() -> int_value`
+
+      Return the current alpha value for the Surface.
+
+      .. ## Surface.get_alpha ##
+
+   .. method:: lock
+
+      | :sl:`lock the Surface memory for pixel access`
+      | :sg:`lock() -> None`
+
+      Lock the pixel data of a Surface for access. On accelerated Surfaces, the
+      pixel data may be stored in volatile video memory or nonlinear compressed
+      forms. When a Surface is locked the pixel memory becomes available to
+      access by regular software. Code that reads or writes pixel values will
+      need the Surface to be locked.
+
+      Surfaces should not remain locked for more than necessary. A locked
+      Surface can often not be displayed or managed by pygame.
+
+      Not all Surfaces require locking. The :meth:`mustlock()` method can
+      determine if it is actually required. There is no performance penalty for
+      locking and unlocking a Surface that does not need it.
+
+      All pygame functions will automatically lock and unlock the Surface data
+      as needed. If a section of code is going to make calls that will
+      repeatedly lock and unlock the Surface many times, it can be helpful to
+      wrap the block inside a lock and unlock pair.
+
+      It is safe to nest locking and unlocking calls. The surface will only be
+      unlocked after the final lock is released.
+
+      .. ## Surface.lock ##
+
+   .. method:: unlock
+
+      | :sl:`unlock the Surface memory from pixel access`
+      | :sg:`unlock() -> None`
+
+      Unlock the Surface pixel data after it has been locked. The unlocked
+      Surface can once again be drawn and managed by pygame. See the
+      :meth:`lock()` documentation for more details.
+
+      All pygame functions will automatically lock and unlock the Surface data
+      as needed. If a section of code is going to make calls that will
+      repeatedly lock and unlock the Surface many times, it can be helpful to
+      wrap the block inside a lock and unlock pair.
+
+      It is safe to nest locking and unlocking calls. The surface will only be
+      unlocked after the final lock is released.
+
+      .. ## Surface.unlock ##
+
+   .. method:: mustlock
+
+      | :sl:`test if the Surface requires locking`
+      | :sg:`mustlock() -> bool`
+
+      Returns ``True`` if the Surface is required to be locked to access pixel
+      data. Usually pure software Surfaces do not require locking. This method
+      is rarely needed, since it is safe and quickest to just lock all Surfaces
+      as needed.
+
+      All pygame functions will automatically lock and unlock the Surface data
+      as needed. If a section of code is going to make calls that will
+      repeatedly lock and unlock the Surface many times, it can be helpful to
+      wrap the block inside a lock and unlock pair.
+
+      .. ## Surface.mustlock ##
+
+   .. method:: get_locked
+
+      | :sl:`test if the Surface is current locked`
+      | :sg:`get_locked() -> bool`
+
+      Returns ``True`` when the Surface is locked. It doesn't matter how many
+      times the Surface is locked.
+
+      .. ## Surface.get_locked ##
+
+   .. method:: get_locks
+
+      | :sl:`Gets the locks for the Surface`
+      | :sg:`get_locks() -> tuple`
+
+      Returns the currently existing locks for the Surface.
+
+      .. ## Surface.get_locks ##
+
+   .. method:: get_at
+
+      | :sl:`get the color value at a single pixel`
+      | :sg:`get_at((x, y)) -> Color`
+
+      Return a copy of the ``RGBA`` Color value at the given pixel. If the
+      Surface has no per pixel alpha, then the alpha value will always be 255
+      (opaque). If the pixel position is outside the area of the Surface an
+      ``IndexError`` exception will be raised.
+
+      Getting and setting pixels one at a time is generally too slow to be used
+      in a game or realtime situation. It is better to use methods which
+      operate on many pixels at a time like with the blit, fill and draw
+      methods - or by using :mod:`pygame.surfarray`/:mod:`pygame.PixelArray`.
+
+      This function will temporarily lock and unlock the Surface as needed.
+
+      .. versionadded:: 1.9
+         Returning a Color instead of tuple. Use ``tuple(surf.get_at((x,y)))``
+         if you want a tuple, and not a Color. This should only matter if
+         you want to use the color as a key in a dict.
+
+      .. ## Surface.get_at ##
+
+   .. method:: set_at
+
+      | :sl:`set the color value for a single pixel`
+      | :sg:`set_at((x, y), Color) -> None`
+
+      Set the ``RGBA`` or mapped integer color value for a single pixel. If the
+      Surface does not have per pixel alphas, the alpha value is ignored.
+      Setting pixels outside the Surface area or outside the Surface clipping
+      will have no effect.
+
+      Getting and setting pixels one at a time is generally too slow to be used
+      in a game or realtime situation.
+
+      This function will temporarily lock and unlock the Surface as needed.
+
+      .. note:: If the surface is palettized, the pixel color will be set to the
+                most similar color in the palette.
+
+      .. ## Surface.set_at ##
+
+   .. method:: get_at_mapped
+
+      | :sl:`get the mapped color value at a single pixel`
+      | :sg:`get_at_mapped((x, y)) -> Color`
+
+      Return the integer value of the given pixel. If the pixel position is
+      outside the area of the Surface an ``IndexError`` exception will be
+      raised.
+
+      This method is intended for pygame unit testing. It unlikely has any use
+      in an application.
+
+      This function will temporarily lock and unlock the Surface as needed.
+
+      .. versionadded:: 1.9.2
+
+      .. ## Surface.get_at_mapped ##
+
+   .. method:: get_palette
+
+      | :sl:`get the color index palette for an 8-bit Surface`
+      | :sg:`get_palette() -> [RGB, RGB, RGB, ...]`
+
+      Return a list of up to 256 color elements that represent the indexed
+      colors used in an 8-bit Surface. The returned list is a copy of the
+      palette, and changes will have no effect on the Surface.
+
+      Returning a list of ``Color(with length 3)`` instances instead of tuples.
+
+      .. versionadded:: 1.9
+
+      .. ## Surface.get_palette ##
+
+   .. method:: get_palette_at
+
+      | :sl:`get the color for a single entry in a palette`
+      | :sg:`get_palette_at(index) -> RGB`
+
+      Returns the red, green, and blue color values for a single index in a
+      Surface palette. The index should be a value from 0 to 255.
+
+      .. versionadded:: 1.9
+         Returning ``Color(with length 3)`` instance instead of a tuple.
+
+      .. ## Surface.get_palette_at ##
+
+   .. method:: set_palette
+
+      | :sl:`set the color palette for an 8-bit Surface`
+      | :sg:`set_palette([RGB, RGB, RGB, ...]) -> None`
+
+      Set the full palette for an 8-bit Surface. This will replace the colors in
+      the existing palette. A partial palette can be passed and only the first
+      colors in the original palette will be changed.
+
+      This function has no effect on a Surface with more than 8-bits per pixel.
+
+      .. ## Surface.set_palette ##
+
+   .. method:: set_palette_at
+
+      | :sl:`set the color for a single index in an 8-bit Surface palette`
+      | :sg:`set_palette_at(index, RGB) -> None`
+
+      Set the palette value for a single entry in a Surface palette. The index
+      should be a value from 0 to 255.
+
+      This function has no effect on a Surface with more than 8-bits per pixel.
+
+      .. ## Surface.set_palette_at ##
+
+   .. method:: map_rgb
+
+      | :sl:`convert a color into a mapped color value`
+      | :sg:`map_rgb(Color) -> mapped_int`
+
+      Convert an ``RGBA`` color into the mapped integer value for this Surface.
+      The returned integer will contain no more bits than the bit depth of the
+      Surface. Mapped color values are not often used inside pygame, but can be
+      passed to most functions that require a Surface and a color.
+
+      See the Surface object documentation for more information about colors
+      and pixel formats.
+
+      .. ## Surface.map_rgb ##
+
+   .. method:: unmap_rgb
+
+      | :sl:`convert a mapped integer color value into a Color`
+      | :sg:`unmap_rgb(mapped_int) -> Color`
+
+      Convert an mapped integer color into the ``RGB`` color components for
+      this Surface. Mapped color values are not often used inside pygame, but
+      can be passed to most functions that require a Surface and a color.
+
+      See the Surface object documentation for more information about colors
+      and pixel formats.
+
+      .. ## Surface.unmap_rgb ##
+
+   .. method:: set_clip
+
+      | :sl:`set the current clipping area of the Surface`
+      | :sg:`set_clip(rect) -> None`
+      | :sg:`set_clip(None) -> None`
+
+      Each Surface has an active clipping area. This is a rectangle that
+      represents the only pixels on the Surface that can be modified. If
+      ``None`` is passed for the rectangle the full Surface will be available
+      for changes.
+
+      The clipping area is always restricted to the area of the Surface itself.
+      If the clip rectangle is too large it will be shrunk to fit inside the
+      Surface.
+
+      .. ## Surface.set_clip ##
+
+   .. method:: get_clip
+
+      | :sl:`get the current clipping area of the Surface`
+      | :sg:`get_clip() -> Rect`
+
+      Return a rectangle of the current clipping area. The Surface will always
+      return a valid rectangle that will never be outside the bounds of the
+      image. If the Surface has had ``None`` set for the clipping area, the
+      Surface will return a rectangle with the full area of the Surface.
+
+      .. ## Surface.get_clip ##
+
+   .. method:: subsurface
+
+      | :sl:`create a new surface that references its parent`
+      | :sg:`subsurface(Rect) -> Surface`
+
+      Returns a new Surface that shares its pixels with its new parent. The new
+      Surface is considered a child of the original. Modifications to either
+      Surface pixels will effect each other. Surface information like clipping
+      area and color keys are unique to each Surface.
+
+      The new Surface will inherit the palette, color key, and alpha settings
+      from its parent.
+
+      It is possible to have any number of subsurfaces and subsubsurfaces on
+      the parent. It is also possible to subsurface the display Surface if the
+      display mode is not hardware accelerated.
+
+      See :meth:`get_offset()` and :meth:`get_parent()` to learn more
+      about the state of a subsurface.
+
+      A subsurface will have the same class as the parent surface.
+
+      .. ## Surface.subsurface ##
+
+   .. method:: get_parent
+
+      | :sl:`find the parent of a subsurface`
+      | :sg:`get_parent() -> Surface`
+
+      Returns the parent Surface of a subsurface. If this is not a subsurface
+      then ``None`` will be returned.
+
+      .. ## Surface.get_parent ##
+
+   .. method:: get_abs_parent
+
+      | :sl:`find the top level parent of a subsurface`
+      | :sg:`get_abs_parent() -> Surface`
+
+      Returns the parent Surface of a subsurface. If this is not a subsurface
+      then this surface will be returned.
+
+      .. ## Surface.get_abs_parent ##
+
+   .. method:: get_offset
+
+      | :sl:`find the position of a child subsurface inside a parent`
+      | :sg:`get_offset() -> (x, y)`
+
+      Get the offset position of a child subsurface inside of a parent. If the
+      Surface is not a subsurface this will return (0, 0).
+
+      .. ## Surface.get_offset ##
+
+   .. method:: get_abs_offset
+
+      | :sl:`find the absolute position of a child subsurface inside its top level parent`
+      | :sg:`get_abs_offset() -> (x, y)`
+
+      Get the offset position of a child subsurface inside of its top level
+      parent Surface. If the Surface is not a subsurface this will return (0,
+      0).
+
+      .. ## Surface.get_abs_offset ##
+
+   .. method:: get_size
+
+      | :sl:`get the dimensions of the Surface`
+      | :sg:`get_size() -> (width, height)`
+
+      Return the width and height of the Surface in pixels.
+
+      .. ## Surface.get_size ##
+
+   .. method:: get_width
+
+      | :sl:`get the width of the Surface`
+      | :sg:`get_width() -> width`
+
+      Return the width of the Surface in pixels.
+
+      .. ## Surface.get_width ##
+
+   .. method:: get_height
+
+      | :sl:`get the height of the Surface`
+      | :sg:`get_height() -> height`
+
+      Return the height of the Surface in pixels.
+
+      .. ## Surface.get_height ##
+
+   .. method:: get_rect
+
+      | :sl:`get the rectangular area of the Surface`
+      | :sg:`get_rect(\**kwargs) -> Rect`
+
+      Returns a new rectangle covering the entire surface. This rectangle will
+      always start at (0, 0) with a width and height the same size as the image.
+
+      You can pass keyword argument values to this function. These named values
+      will be applied to the attributes of the Rect before it is returned. An
+      example would be ``mysurf.get_rect(center=(100, 100))`` to create a
+      rectangle for the Surface centered at a given position.
+
+      .. ## Surface.get_rect ##
+
+   .. method:: get_bitsize
+
+      | :sl:`get the bit depth of the Surface pixel format`
+      | :sg:`get_bitsize() -> int`
+
+      Returns the number of bits used to represent each pixel. This value may
+      not exactly fill the number of bytes used per pixel. For example a 15 bit
+      Surface still requires a full 2 bytes.
+
+      .. ## Surface.get_bitsize ##
+
+   .. method:: get_bytesize
+
+      | :sl:`get the bytes used per Surface pixel`
+      | :sg:`get_bytesize() -> int`
+
+      Return the number of bytes used per pixel.
+
+      .. ## Surface.get_bytesize ##
+
+   .. method:: get_flags
+
+      | :sl:`get the additional flags used for the Surface`
+      | :sg:`get_flags() -> int`
+
+      Returns a set of current Surface features. Each feature is a bit in the
+      flags bitmask. Typical flags are ``RLEACCEL``, ``SRCALPHA``, and
+      ``SRCCOLORKEY``.
+
+      Here is a more complete list of flags. A full list can be found in
+      ``SDL_video.h``
+
+      ::
+
+        SWSURFACE      0x00000000    # Surface is in system memory
+        HWSURFACE      0x00000001    # (obsolete in pygame 2) Surface is in video memory
+        ASYNCBLIT      0x00000004    # (obsolete in pygame 2) Use asynchronous blits if possible
+
+      See :func:`pygame.display.set_mode()` for flags exclusive to the
+      display surface.
+
+      Used internally (read-only)
+
+      ::
+
+        HWACCEL        0x00000100    # Blit uses hardware acceleration
+        SRCCOLORKEY    0x00001000    # Blit uses a source color key
+        RLEACCELOK     0x00002000    # Private flag
+        RLEACCEL       0x00004000    # Surface is RLE encoded
+        SRCALPHA       0x00010000    # Blit uses source alpha blending
+        PREALLOC       0x01000000    # Surface uses preallocated memory
+
+      .. ## Surface.get_flags ##
+
+   .. method:: get_pitch
+
+      | :sl:`get the number of bytes used per Surface row`
+      | :sg:`get_pitch() -> int`
+
+      Return the number of bytes separating each row in the Surface. Surfaces
+      in video memory are not always linearly packed. Subsurfaces will also
+      have a larger pitch than their real width.
+
+      This value is not needed for normal pygame usage.
+
+      .. ## Surface.get_pitch ##
+
+   .. method:: get_masks
+
+      | :sl:`the bitmasks needed to convert between a color and a mapped integer`
+      | :sg:`get_masks() -> (R, G, B, A)`
+
+      Returns the bitmasks used to isolate each color in a mapped integer.
+
+      This value is not needed for normal pygame usage.
+
+      .. ## Surface.get_masks ##
+
+   .. method:: set_masks
+
+      | :sl:`set the bitmasks needed to convert between a color and a mapped integer`
+      | :sg:`set_masks((r,g,b,a)) -> None`
+
+      This is not needed for normal pygame usage.
+
+      .. note:: Starting in pygame 2.0, the masks are read-only and
+         accordingly this method will raise a TypeError if called.
+
+      .. deprecated:: 2.0.0
+
+      .. versionadded:: 1.8.1
+
+      .. ## Surface.set_masks ##
+
+   .. method:: get_shifts
+
+      | :sl:`the bit shifts needed to convert between a color and a mapped integer`
+      | :sg:`get_shifts() -> (R, G, B, A)`
+
+      Returns the pixel shifts need to convert between each color and a mapped
+      integer.
+
+      This value is not needed for normal pygame usage.
+
+      .. ## Surface.get_shifts ##
+
+   .. method:: set_shifts
+
+      | :sl:`sets the bit shifts needed to convert between a color and a mapped integer`
+      | :sg:`set_shifts((r,g,b,a)) -> None`
+
+      This is not needed for normal pygame usage.
+
+      .. note:: Starting in pygame 2.0, the shifts are read-only and
+         accordingly this method will raise a TypeError if called.
+
+      .. deprecated:: 2.0.0
+
+      .. versionadded:: 1.8.1
+
+      .. ## Surface.set_shifts ##
+
+   .. method:: get_losses
+
+      | :sl:`the significant bits used to convert between a color and a mapped integer`
+      | :sg:`get_losses() -> (R, G, B, A)`
+
+      Return the least significant number of bits stripped from each color in a
+      mapped integer.
+
+      This value is not needed for normal pygame usage.
+
+      .. ## Surface.get_losses ##
+
+   .. method:: get_bounding_rect
+
+      | :sl:`find the smallest rect containing data`
+      | :sg:`get_bounding_rect(min_alpha = 1) -> Rect`
+
+      Returns the smallest rectangular region that contains all the pixels in
+      the surface that have an alpha value greater than or equal to the minimum
+      alpha value.
+
+      This function will temporarily lock and unlock the Surface as needed.
+
+      .. versionadded:: 1.8
+
+      .. ## Surface.get_bounding_rect ##
+
+   .. method:: get_view
+
+      | :sl:`return a buffer view of the Surface's pixels.`
+      | :sg:`get_view(='2') -> BufferProxy`
+
+      Return an object which exports a surface's internal pixel buffer as
+      a C level array struct, Python level array interface or a C level
+      buffer interface. The new buffer protocol is supported.
+
+      The kind argument is the length 1 string '0', '1', '2', '3',
+      'r', 'g', 'b', or 'a'. The letters are case insensitive;
+      'A' will work as well. The argument can be either a Unicode or byte (char)
+      string. The default is '2'.
+
+      '0' returns a contiguous unstructured bytes view. No surface shape
+      information is given. A ``ValueError`` is raised if the surface's pixels
+      are discontinuous.
+
+      '1' returns a (surface-width * surface-height) array of continuous
+      pixels. A ``ValueError`` is raised if the surface pixels are
+      discontinuous.
+
+      '2' returns a (surface-width, surface-height) array of raw pixels.
+      The pixels are surface-bytesize-d unsigned integers. The pixel format is
+      surface specific. The 3 byte unsigned integers of 24 bit surfaces are
+      unlikely accepted by anything other than other pygame functions.
+
+      '3' returns a (surface-width, surface-height, 3) array of ``RGB`` color
+      components. Each of the red, green, and blue components are unsigned
+      bytes. Only 24-bit and 32-bit surfaces are supported. The color
+      components must be in either ``RGB`` or ``BGR`` order within the pixel.
+
+      'r' for red, 'g' for green, 'b' for blue, and 'a' for alpha return a
+      (surface-width, surface-height) view of a single color component within a
+      surface: a color plane. Color components are unsigned bytes. Both 24-bit
+      and 32-bit surfaces support 'r', 'g', and 'b'. Only 32-bit surfaces with
+      ``SRCALPHA`` support 'a'.
+
+      The surface is locked only when an exposed interface is accessed.
+      For new buffer interface accesses, the surface is unlocked once the
+      last buffer view is released. For array interface and old buffer
+      interface accesses, the surface remains locked until the BufferProxy
+      object is released.
+
+      .. versionadded:: 1.9.2
+
+   .. method:: get_buffer
+
+      | :sl:`acquires a buffer object for the pixels of the Surface.`
+      | :sg:`get_buffer() -> BufferProxy`
+
+      Return a buffer object for the pixels of the Surface. The buffer can be
+      used for direct pixel access and manipulation. Surface pixel data is
+      represented as an unstructured block of memory, with a start address
+      and length in bytes. The data need not be contiguous. Any gaps are
+      included in the length, but otherwise ignored.
+
+      This method implicitly locks the Surface. The lock will be released when
+      the returned :mod:`pygame.BufferProxy` object is garbage collected.
+
+      .. versionadded:: 1.8
+
+      .. ## Surface.get_buffer ##
+
+   .. attribute:: _pixels_address
+
+      | :sl:`pixel buffer address`
+      | :sg:`_pixels_address -> int`
+
+      The starting address of the surface's raw pixel bytes.
+
+      .. versionadded:: 1.9.2
+
+   .. method:: premul_alpha
+
+      | :sl:`returns a copy of the surface with the RGB channels pre-multiplied by the alpha channel.`
+      | :sg:`premul_alpha() -> Surface`
+
+      **Experimental:** feature still in development available for testing and feedback. It may change.
+      `Please leave premul_alpha feedback with authors `_
+
+      Returns a copy of the initial surface with the red, green and blue color channels multiplied
+      by the alpha channel. This is intended to make it easier to work with the BLEND_PREMULTIPLED
+      blend mode flag of the blit() method. Surfaces which have called this method will only look
+      correct after blitting if the BLEND_PREMULTIPLED special flag is used.
+
+      It is worth noting that after calling this method, methods that return the colour of a pixel
+      such as get_at() will return the alpha multiplied colour values. It is not possible to fully
+      reverse an alpha multiplication of the colours in a surface as integer colour channel data
+      is generally reduced by the operation (e.g. 255 x 0 = 0, from there it is not possible to reconstruct
+      the original 255 from just the two remaining zeros in the colour and alpha channels).
+
+      If you call this method, and then call it again, it will multiply the colour channels by the alpha channel
+      twice. There are many possible ways to obtain a surface with the colour channels pre-multiplied by the
+      alpha channel in pygame, and it is not possible to tell the difference just from the information in the pixels.
+      It is completely possible to have two identical surfaces - one intended for pre-multiplied alpha blending and
+      one intended for normal blending. For this reason we do not store state on surfaces intended for pre-multiplied
+      alpha blending.
+
+      Surfaces without an alpha channel cannot use this method and will return an error if you use
+      it on them. It is best used on 32 bit surfaces (the default on most platforms) as the blitting
+      on these surfaces can be accelerated by SIMD versions of the pre-multiplied blitter.
+
+      In general pre-multiplied alpha blitting is faster then 'straight alpha' blitting and produces
+      superior results when blitting an alpha surface onto another surface with alpha - assuming both
+      surfaces contain pre-multiplied alpha colours.
+
+      .. versionadded:: 2.2.0
+
+      .. ## Surface.premul_alpha ##
+
+   .. ## pygame.Surface ##
+
+
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surfarray.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surfarray.rst.txt
index 0d8a2b0..c29723a 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surfarray.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/surfarray.rst.txt
@@ -30,13 +30,11 @@ specific pixel value of a color. Integer pixel values can only be used directly
 between surfaces with matching pixel layouts (see :class:`pygame.Surface`).
 
 All functions that refer to "array" will copy the surface information to a new
-NumPy array. All functions that refer to "pixels" will directly reference the
+numpy array. All functions that refer to "pixels" will directly reference the
 pixels from the surface and any changes performed to the array will make changes
 in the surface. As this last functions share memory with the surface, this one
 will be locked during the lifetime of the array.
 
-.. versionchanged:: 2.5.6 surfarray module is lazily loaded to avoid an expensive NumPy import when unnecessary
-
 .. function:: array2d
 
    | :sl:`Copy pixels into a 2d array`
@@ -151,7 +149,7 @@ will be locked during the lifetime of the array.
    the :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
    access method).
 
-   .. versionaddedold:: 2.0.2
+   .. versionadded:: 2.0.2
 
    .. ## pygame.surfarray.array_red ##
 
@@ -185,7 +183,7 @@ will be locked during the lifetime of the array.
    the :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
    access method).
 
-   .. versionaddedold:: 2.0.2
+   .. versionadded:: 2.0.2
 
    .. ## pygame.surfarray.array_green ##
 
@@ -219,7 +217,7 @@ will be locked during the lifetime of the array.
    the :meth:`pygame.Surface.lock` - lock the Surface memory for pixel
    access method).
 
-   .. versionaddedold:: 2.0.2
+   .. versionadded:: 2.0.2
 
    .. ## pygame.surfarray.array_blue ##
 
@@ -267,10 +265,6 @@ will be locked during the lifetime of the array.
    make_surface uses the array struct interface to acquire array properties,
    so is not limited to just NumPy arrays. See :mod:`pygame.pixelcopy`.
 
-   ``float32``, ``float64`` and (where available) ``float96`` NumPy arrays
-   are also accepted, but are first rounded to the nearest integer and
-   copied into a new array before creating the surface.
-
    New in pygame 1.9.2: array struct interface support.
 
    .. ## pygame.surfarray.make_surface ##
@@ -282,14 +276,8 @@ will be locked during the lifetime of the array.
 
    Directly copy values from an array into a Surface. This is faster than
    converting the array into a Surface and blitting. The array must be the same
-   dimensions as the Surface and will completely replace all pixel values.
-   Accepted array types are integer, ASCII character and record arrays, as
-   well as ``float32``, ``float64`` and (where available) ``float96`` NumPy
-   arrays.
-
-   Float arrays are first rounded to the nearest integer and copied into
-   a new array before blitting. This is significantly slower (on the order of 2x)
-   versus passing an integer array.
+   dimensions as the Surface and will completely replace all pixel values. Only
+   integer, ASCII character and record arrays are accepted.
 
    This function will temporarily lock the Surface as the new values are
    copied.
@@ -327,7 +315,7 @@ will be locked during the lifetime of the array.
    ``get_arraytypes()`` tuple and indicates which type of array module is used
    for the array creation. Using this function will raise a ``DeprecationWarning``.
 
-   .. versionaddedold:: 1.8
+   .. versionadded:: 1.8
 
    .. ## pygame.surfarray.get_arraytype ##
 
@@ -342,7 +330,7 @@ will be locked during the lifetime of the array.
    system could be found, None will be returned.  Using this function will raise a
    ``DeprecationWarning``.
 
-   .. versionaddedold:: 1.8
+   .. versionadded:: 1.8
 
    .. ## pygame.surfarray.get_arraytypes ##
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/system.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/system.rst.txt
deleted file mode 100644
index d2b74ad..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/system.rst.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-.. include:: common.txt
-
-:mod:`pygame.system`
-====================
-
-.. autopgmodule:: pygame.system
-    :members:
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/tests.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/tests.rst.txt
index a1af273..88184f6 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/tests.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/tests.rst.txt
@@ -20,7 +20,7 @@ correspond to the :func:`pygame.tests.run` arguments.
 
 The xxxx_test submodules of the tests package are unit test suites for
 individual parts of pygame. Each can also be run as a main program. This is
-useful if the test is interactive.
+useful if the test, such as cdrom_test, is interactive.
 
 For pygame development the test suite can be run from a pygame distribution
 root directory. Program ``run_tests.py`` is provided for convenience, though
@@ -29,12 +29,15 @@ test/go.py can be run directly.
 Module level tags control which modules are included in a unit test run. Tags
 are assigned to a unit test module with a corresponding _tags.py module.
 The tags module has the global __tags__, a list of tag names. For example,
-``controller_test.py`` has a tag variable containing a tags list that
-has the 'interactive' string. The 'interactive' tag indicates ``controller_test.py``
+``cdrom_test.py`` has a tag file ``cdrom_tags.py`` containing a tags list that
+has the 'interactive' string. The 'interactive' tag indicates ``cdrom_test.py``
 expects user input. It is excluded from a ``run_tests.py`` or
-``pygame.tests.go`` run. Two other tags that are excluded are 'ignore' and
-'subprocess_ignore'. These two tags indicate unit tests that will not run on a
-particular platform, or for which no corresponding pygame module is available.
+``pygame.tests.go`` run. 
+
+Two other tags that are excluded are 'ignore' and 'subprocess_ignore'. These
+two tags indicate unit tests that will not run on a particular platform, or
+for which no corresponding pygame module is available.
+
 The test runner will list each excluded module along with the tag responsible.
 
 .. function:: run
@@ -85,19 +88,21 @@ The test runner will list each excluded module along with the tag responsible.
    By default individual test modules are run in separate subprocesses. This
    recreates normal pygame usage where ``pygame.init()`` and ``pygame.quit()``
    are called only once per program execution, and avoids unfortunate
-   interactions between test modules. Also, a time limit is placed on test
-   execution, so frozen tests are killed when their time allotment expired. Use
-   the single process option if threading is not working properly or if tests
-   are taking too long. It is not guaranteed that all tests will pass in single
-   process mode.
+   interactions between test modules. 
+   
+   A time limit is placed on test execution ensuring that any frozen tests
+   processes are killed when their time allotment is expired. Use the single
+   process option if threading is not working properly or if tests are taking
+   too long. It is not guaranteed that all tests will pass in single process
+   mode.
 
    Tests are run in a randomized order if the randomize argument is True or a
    seed argument is provided. If no seed integer is provided then the system
-   time is used.
+   time is used for the randomization seed value.
 
    Individual test modules may have a __tags__ attribute, a list of tag strings
    used to selectively omit modules from a run. By default only 'interactive'
-   modules such as controller_test are ignored. An interactive module must be run
+   modules such as cdrom_test are ignored. An interactive module must be run
    from the console as a Python program.
 
    This function can only be called once per Python session. It is not
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/time.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/time.rst.txt
index 1f74178..59e0999 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/time.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/time.rst.txt
@@ -3,5 +3,163 @@
 :mod:`pygame.time`
 ==================
 
-.. autopgmodule:: pygame.time
-   :members:
+.. module:: pygame.time
+   :synopsis: pygame module for monitoring time
+
+| :sl:`pygame module for monitoring time`
+
+Times in pygame are represented in milliseconds (1/1000 seconds). Most
+platforms have a limited time resolution of around 10 milliseconds. This
+resolution, in milliseconds, is given in the ``TIMER_RESOLUTION`` constant.
+
+.. function:: get_ticks
+
+   | :sl:`get the time in milliseconds`
+   | :sg:`get_ticks() -> milliseconds`
+
+   Return the number of milliseconds since ``pygame.init()`` was called. Before
+   pygame is initialized this will always be 0.
+
+   .. ## pygame.time.get_ticks ##
+
+.. function:: wait
+
+   | :sl:`pause the program for an amount of time`
+   | :sg:`wait(milliseconds) -> time`
+
+   Will pause for a given number of milliseconds. This function sleeps the
+   process to share the processor with other programs. A program that waits for
+   even a few milliseconds will consume very little processor time. It is
+   slightly less accurate than the ``pygame.time.delay()`` function.
+
+   This returns the actual number of milliseconds used.
+
+   .. ## pygame.time.wait ##
+
+.. function:: delay
+
+   | :sl:`pause the program for an amount of time`
+   | :sg:`delay(milliseconds) -> time`
+
+   Will pause for a given number of milliseconds. This function will use the
+   processor (rather than sleeping) in order to make the delay more accurate
+   than ``pygame.time.wait()``.
+
+   This returns the actual number of milliseconds used.
+
+   .. ## pygame.time.delay ##
+
+.. function:: set_timer
+
+   | :sl:`repeatedly create an event on the event queue`
+   | :sg:`set_timer(event, millis) -> None`
+   | :sg:`set_timer(event, millis, loops=0) -> None`
+
+   Set an event to appear on the event queue every given number of milliseconds.
+   The first event will not appear until the amount of time has passed.
+
+   The ``event`` attribute can be a ``pygame.event.Event`` object or an integer
+   type that denotes an event.
+
+   ``loops`` is an integer that denotes the number of events posted. If 0 (default)
+   then the events will keep getting posted, unless explicitly stopped.
+
+   To disable the timer for such an event, call the function again with the same
+   event argument with ``millis`` argument set to 0.
+
+   It is also worth mentioning that a particular event type can only be put on a
+   timer once. In other words, there cannot be two timers for the same event type.
+   Setting an event timer for a particular event discards the old one for that
+   event type.
+
+   ``loops`` replaces the ``once`` argument, and this does not break backward
+   compatibility
+
+   .. versionadded:: 2.0.0.dev3 once argument added.
+   .. versionchanged:: 2.0.1 event argument supports ``pygame.event.Event`` object
+   .. versionadded:: 2.0.1 added loops argument to replace once argument
+
+   .. ## pygame.time.set_timer ##
+
+.. class:: Clock
+
+   | :sl:`create an object to help track time`
+   | :sg:`Clock() -> Clock`
+
+   Creates a new Clock object that can be used to track an amount of time. The
+   clock also provides several functions to help control a game's framerate.
+
+   .. method:: tick
+
+      | :sl:`update the clock`
+      | :sg:`tick(framerate=0) -> milliseconds`
+
+      This method should be called once per frame. It will compute how many
+      milliseconds have passed since the previous call.
+
+      If you pass the optional framerate argument the function will delay to
+      keep the game running slower than the given ticks per second. This can be
+      used to help limit the runtime speed of a game. By calling
+      ``Clock.tick(40)`` once per frame, the program will never run at more
+      than 40 frames per second.
+
+      Note that this function uses SDL_Delay function which is not accurate on
+      every platform, but does not use much CPU. Use tick_busy_loop if you want
+      an accurate timer, and don't mind chewing CPU.
+
+      .. ## Clock.tick ##
+
+   .. method:: tick_busy_loop
+
+      | :sl:`update the clock`
+      | :sg:`tick_busy_loop(framerate=0) -> milliseconds`
+
+      This method should be called once per frame. It will compute how many
+      milliseconds have passed since the previous call.
+
+      If you pass the optional framerate argument the function will delay to
+      keep the game running slower than the given ticks per second. This can be
+      used to help limit the runtime speed of a game. By calling
+      ``Clock.tick_busy_loop(40)`` once per frame, the program will never run at
+      more than 40 frames per second.
+
+      Note that this function uses :func:`pygame.time.delay`, which uses lots
+      of CPU in a busy loop to make sure that timing is more accurate.
+
+      .. versionadded:: 1.8
+
+      .. ## Clock.tick_busy_loop ##
+
+   .. method:: get_time
+
+      | :sl:`time used in the previous tick`
+      | :sg:`get_time() -> milliseconds`
+
+      The number of milliseconds that passed between the previous two calls to
+      ``Clock.tick()``.
+
+      .. ## Clock.get_time ##
+
+   .. method:: get_rawtime
+
+      | :sl:`actual time used in the previous tick`
+      | :sg:`get_rawtime() -> milliseconds`
+
+      Similar to ``Clock.get_time()``, but does not include any time used
+      while ``Clock.tick()`` was delaying to limit the framerate.
+
+      .. ## Clock.get_rawtime ##
+
+   .. method:: get_fps
+
+      | :sl:`compute the clock framerate`
+      | :sg:`get_fps() -> float`
+
+      Compute your game's framerate (in frames per second). It is computed by
+      averaging the last ten calls to ``Clock.tick()``.
+
+      .. ## Clock.get_fps ##
+
+   .. ## pygame.time.Clock ##
+
+.. ## pygame.time ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/touch.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/touch.rst.txt
index 2bdd0a1..320da05 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/touch.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/touch.rst.txt
@@ -8,7 +8,7 @@
 
 | :sl:`pygame module to work with touch input`
 
-.. versionaddedold:: 2 This module requires SDL2.
+.. versionadded:: 2 This module requires SDL2.
 
 .. function:: get_num_devices
 
@@ -44,15 +44,14 @@
 .. function:: get_finger
 
    | :sl:`get information about an active finger`
-   | :sg:`get_finger(touchid, index) -> dict | None`
+   | :sg:`get_finger(touchid, index) -> int`
 
    :param int touchid: The touch device id.
    :param int index: The index of the finger to return
                      information about, between 0 and the
                      :func:`number of active fingers `.
 
-   Return a dict for the finger ``index`` active on ``touchid``, or ``None`` if the
-   object does not exist.
+   Return a dict for the finger ``index`` active on ``touchid``.
    The dict contains these keys:
 
    ::
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/transform.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/transform.rst.txt
index 1be8b9d..91a3a8f 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/transform.rst.txt
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/transform.rst.txt
@@ -3,5 +3,323 @@
 :mod:`pygame.transform`
 =======================
 
-.. autopgmodule:: pygame.transform
-   :members:
+.. module:: pygame.transform
+   :synopsis: pygame module to transform surfaces
+
+| :sl:`pygame module to transform surfaces`
+
+A Surface transform is an operation that moves or resizes the pixels. All these
+functions take a Surface to operate on and return a new Surface with the
+results.
+
+Some of the transforms are considered destructive. These means every time they
+are performed they lose pixel data. Common examples of this are resizing and
+rotating. For this reason, it is better to re-transform the original surface
+than to keep transforming an image multiple times. (For example, suppose you
+are animating a bouncing spring which expands and contracts. If you applied the
+size changes incrementally to the previous images, you would lose detail.
+Instead, always begin with the original image and scale to the desired size.)
+
+.. versionchanged:: 2.0.2 transform functions now support keyword arguments.
+
+.. function:: flip
+
+   | :sl:`flip vertically and horizontally`
+   | :sg:`flip(surface, flip_x, flip_y) -> Surface`
+
+   This can flip a Surface either vertically, horizontally, or both.
+   The arguments ``flip_x`` and ``flip_y`` are booleans that control whether
+   to flip each axis. Flipping a Surface is non-destructive and returns a new
+   Surface with the same dimensions.
+
+   .. ## pygame.transform.flip ##
+
+.. function:: scale
+
+   | :sl:`resize to new resolution`
+   | :sg:`scale(surface, size, dest_surface=None) -> Surface`
+
+   Resizes the Surface to a new size, given as (width, height). 
+   This is a fast scale operation that does not sample the results.
+
+   An optional destination surface can be used, rather than have it create a
+   new one. This is quicker if you want to repeatedly scale something. However
+   the destination must be the same size as the size (width, height) passed in. Also
+   the destination surface must be the same format.
+
+   .. ## pygame.transform.scale ##
+
+.. function:: scale_by
+
+   | :sl:`resize to new resolution, using scalar(s)`
+   | :sg:`scale_by(surface, factor, dest_surface=None) -> Surface`
+
+   **Experimental:** feature still in development available for testing and feedback. It may change.
+   `Please leave scale_by feedback with authors `_
+
+   Same as :func:`scale()`, but scales by some factor, rather than taking
+   the new size explicitly. For example, :code:`transform.scale_by(surf, 3)`
+   will triple the size of the surface in both dimensions. Optionally, the
+   scale factor can be a sequence of two numbers, controlling x and y scaling
+   separately. For example, :code:`transform.scale_by(surf, (2, 1))` doubles
+   the image width but keeps the height the same.
+
+   .. versionadded:: 2.1.3
+
+   .. ## pygame.transform.scale_by ##
+
+.. function:: rotate
+
+   | :sl:`rotate an image`
+   | :sg:`rotate(surface, angle) -> Surface`
+
+   Unfiltered counterclockwise rotation. The angle argument represents degrees
+   and can be any floating point value. Negative angle amounts will rotate
+   clockwise.
+
+   Unless rotating by 90 degree increments, the image will be padded larger to
+   hold the new size. If the image has pixel alphas, the padded area will be
+   transparent. Otherwise pygame will pick a color that matches the Surface
+   colorkey or the topleft pixel value.
+
+   .. ## pygame.transform.rotate ##
+
+.. function:: rotozoom
+
+   | :sl:`filtered scale and rotation`
+   | :sg:`rotozoom(surface, angle, scale) -> Surface`
+
+   This is a combined scale and rotation transform. The resulting Surface will
+   be a filtered 32-bit Surface. The scale argument is a floating point value
+   that will be multiplied by the current resolution. The angle argument is a
+   floating point value that represents the counterclockwise degrees to rotate.
+   A negative rotation angle will rotate clockwise.
+
+   .. ## pygame.transform.rotozoom ##
+
+.. function:: scale2x
+
+   | :sl:`specialized image doubler`
+   | :sg:`scale2x(surface, dest_surface=None) -> Surface`
+
+   This will return a new image that is double the size of the original. It
+   uses the AdvanceMAME Scale2X algorithm which does a 'jaggie-less' scale of
+   bitmap graphics.
+
+   This really only has an effect on simple images with solid colors. On
+   photographic and antialiased images it will look like a regular unfiltered
+   scale.
+
+   An optional destination surface can be used, rather than have it create a
+   new one. This is quicker if you want to repeatedly scale something. However
+   the destination must be twice the size of the source surface passed in. Also
+   the destination surface must be the same format.
+
+   .. ## pygame.transform.scale2x ##
+
+.. function:: smoothscale
+
+   | :sl:`scale a surface to an arbitrary size smoothly`
+   | :sg:`smoothscale(surface, size, dest_surface=None) -> Surface`
+
+   Uses one of two different algorithms for scaling each dimension of the input
+   surface as required. For shrinkage, the output pixels are area averages of
+   the colors they cover. For expansion, a bilinear filter is used. For the
+   x86-64 and i686 architectures, optimized ``MMX`` routines are included and
+   will run much faster than other machine types. The size is a 2 number
+   sequence for (width, height). This function only works for 24-bit or 32-bit
+   surfaces. An exception will be thrown if the input surface bit depth is less
+   than 24.
+
+   .. versionadded:: 1.8
+
+   .. ## pygame.transform.smoothscale ##
+
+.. function:: smoothscale_by
+
+   | :sl:`resize to new resolution, using scalar(s)`
+   | :sg:`smoothscale_by(surface, factor, dest_surface=None) -> Surface`
+
+   **Experimental:** feature still in development available for testing and feedback. It may change.
+   `Please leave smoothscale_by feedback with authors `_
+
+   Same as :func:`smoothscale()`, but scales by some factor, rather than
+   taking the new size explicitly. For example,
+   :code:`transform.smoothscale_by(surf, 3)` will triple the size of the
+   surface in both dimensions. Optionally, the scale factor can be a sequence
+   of two numbers, controlling x and y scaling separately. For example,
+   :code:`transform.smoothscale_by(surf, (2, 1))` doubles the image width but
+   keeps the height the same.
+
+   .. versionadded:: 2.1.3
+
+   .. ## pygame.transform.smoothscale_by ##
+
+.. function:: get_smoothscale_backend
+
+   | :sl:`return smoothscale filter version in use: 'GENERIC', 'MMX', or 'SSE'`
+   | :sg:`get_smoothscale_backend() -> string`
+
+   Shows whether or not smoothscale is using ``MMX`` or ``SSE`` acceleration.
+   If no acceleration is available then "GENERIC" is returned. For a x86
+   processor the level of acceleration to use is determined at runtime.
+
+   This function is provided for pygame testing and debugging.
+
+   .. ## pygame.transform.get_smoothscale_backend ##
+
+.. function:: set_smoothscale_backend
+
+   | :sl:`set smoothscale filter version to one of: 'GENERIC', 'MMX', or 'SSE'`
+   | :sg:`set_smoothscale_backend(backend) -> None`
+
+   Sets smoothscale acceleration. Takes a string argument. A value of 'GENERIC'
+   turns off acceleration. 'MMX' uses ``MMX`` instructions only. 'SSE' allows
+   ``SSE`` extensions as well. A value error is raised if type is not
+   recognized or not supported by the current processor.
+
+   This function is provided for pygame testing and debugging. If smoothscale
+   causes an invalid instruction error then it is a pygame/SDL bug that should
+   be reported. Use this function as a temporary fix only.
+
+   .. ## pygame.transform.set_smoothscale_backend ##
+
+.. function:: chop
+
+   | :sl:`gets a copy of an image with an interior area removed`
+   | :sg:`chop(surface, rect) -> Surface`
+
+   Extracts a portion of an image. All vertical and horizontal pixels
+   surrounding the given rectangle area are removed. The corner areas (diagonal
+   to the rect) are then brought together. (The original image is not altered
+   by this operation.)
+
+   ``NOTE``: If you want a "crop" that returns the part of an image within a
+   rect, you can blit with a rect to a new surface or copy a subsurface.
+
+   .. ## pygame.transform.chop ##
+
+.. function:: laplacian
+
+   | :sl:`find edges in a surface`
+   | :sg:`laplacian(surface, dest_surface=None) -> Surface`
+
+   Finds the edges in a surface using the laplacian algorithm.
+
+   .. versionadded:: 1.8
+
+   .. ## pygame.transform.laplacian ##
+
+.. function:: average_surfaces
+
+   | :sl:`find the average surface from many surfaces.`
+   | :sg:`average_surfaces(surfaces, dest_surface=None, palette_colors=1) -> Surface`
+
+   Takes a sequence of surfaces and returns a surface with average colors from
+   each of the surfaces.
+
+   palette_colors - if true we average the colors in palette, otherwise we
+   average the pixel values. This is useful if the surface is actually
+   greyscale colors, and not palette colors.
+
+   Note, this function currently does not handle palette using surfaces
+   correctly.
+
+   .. versionadded:: 1.8
+   .. versionadded:: 1.9 ``palette_colors`` argument
+
+   .. ## pygame.transform.average_surfaces ##
+
+.. function:: average_color
+
+   | :sl:`finds the average color of a surface`
+   | :sg:`average_color(surface, rect=None, consider_alpha=False) -> Color`
+
+   Finds the average color of a Surface or a region of a surface specified by a
+   Rect, and returns it as a Color. If consider_alpha is set to True, then alpha is
+   taken into account (removing the black artifacts).
+
+   .. versionadded:: 2.1.2 ``consider_alpha`` argument
+
+   .. ## pygame.transform.average_color ##
+
+.. function:: grayscale
+
+   | :sl:`grayscale a surface`
+   | :sg:`grayscale(surface, dest_surface=None) -> Surface`
+
+   Returns a grayscaled version of the original surface using the luminosity formula which weights red, green and blue according to their wavelengths.
+
+   An optional destination surface can be passed which is faster than creating a new Surface.
+   This destination surface must have the same dimensions (width, height) and depth as the source Surface.
+
+   .. ## pygame.transform.grayscale ##
+
+.. function:: threshold
+
+   | :sl:`finds which, and how many pixels in a surface are within a threshold of a 'search_color' or a 'search_surf'.`
+   | :sg:`threshold(dest_surface, surface, search_color, threshold=(0,0,0,0), set_color=(0,0,0,0), set_behavior=1, search_surf=None, inverse_set=False) -> num_threshold_pixels`
+
+   This versatile function can be used for find colors in a 'surf' close to a 'search_color'
+   or close to colors in a separate 'search_surf'.
+
+   It can also be used to transfer pixels into a 'dest_surf' that match or don't match.
+
+   By default it sets pixels in the 'dest_surf' where all of the pixels NOT within the
+   threshold are changed to set_color. If inverse_set is optionally set to True,
+   the pixels that ARE within the threshold are changed to set_color.
+
+   If the optional 'search_surf' surface is given, it is used to threshold against
+   rather than the specified 'set_color'. That is, it will find each pixel in the
+   'surf' that is within the 'threshold' of the pixel at the same coordinates
+   of the 'search_surf'.
+
+   :param dest_surf: Surface we are changing. See 'set_behavior'.
+    Should be None if counting (set_behavior is 0).
+   :type dest_surf: pygame.Surface or None
+
+   :param pygame.Surface surf: Surface we are looking at.
+
+   :param pygame.Color search_color: Color we are searching for.
+
+   :param pygame.Color threshold: Within this distance from search_color (or search_surf).
+     You can use a threshold of (r,g,b,a) where the r,g,b can have different
+     thresholds. So you could use an r threshold of 40 and a blue threshold of 2
+     if you like.
+
+   :param set_color: Color we set in dest_surf.
+   :type set_color: pygame.Color or None
+
+   :param int set_behavior:
+    - set_behavior=1 (default). Pixels in dest_surface will be changed to 'set_color'.
+    - set_behavior=0 we do not change 'dest_surf', just count. Make dest_surf=None.
+    - set_behavior=2 pixels set in 'dest_surf' will be from 'surf'.
+
+   :param search_surf:
+    - search_surf=None (default). Search against 'search_color' instead.
+    - search_surf=Surface. Look at the color in 'search_surf' rather than using 'search_color'.
+   :type search_surf: pygame.Surface or None
+
+   :param bool inverse_set:
+     - False, default. Pixels outside of threshold are changed.
+     - True, Pixels within threshold are changed.
+
+   :rtype: int
+   :returns: The number of pixels that are within the 'threshold' in 'surf'
+     compared to either 'search_color' or `search_surf`.
+
+   :Examples:
+
+   See the threshold tests for a full of examples: https://github.com/pygame/pygame/blob/main/test/transform_test.py
+
+   .. literalinclude:: ../../../test/transform_test.py
+      :pyobject: TransformModuleTest.test_threshold_dest_surf_not_change
+
+
+   .. versionadded:: 1.8
+   .. versionchanged:: 1.9.4
+      Fixed a lot of bugs and added keyword arguments. Test your code.
+
+   .. ## pygame.transform.threshold ##
+
+.. ## pygame.transform ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/typing.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/typing.rst.txt
deleted file mode 100644
index bd08af9..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/typing.rst.txt
+++ /dev/null
@@ -1,79 +0,0 @@
-.. include:: common.txt
-
-:mod:`pygame.typing`
-====================
-
-.. module:: pygame.typing
-   :synopsis: pygame module providing common typehints
-
-| :sl:`pygame module providing common typehints`
-
-.. versionadded:: 2.5.2
-
-A lot of pygame functions and methods allow the user to provide different types
-for the same value like colors or points. This module exports the most common
-type aliases for proper typehint annotations.
-
-   .. data:: FileLike
-
-      An object representing a file. This includes both path-like
-      objects and file-like objects, i.e.:
-
-        * ``"my/string/path.txt"``
-        * ``open("my/file/path.txt")``
-        * ``pathlib.Path("my/pathlib/path.txt")``
-        * ``io.BytesIO(b"my data: \x00\x01")``
-        * ``b"my/bytes/path.txt"``
-        * Any object implementing the path protocol or file protocol.
-
-   .. data:: SequenceLike
-
-      A variant of the standard ``Sequence`` ABC only requiring ``__getitem__``
-      and ``__len__``. This includes custom sequences or builtin ones, i.e.:
-
-        * ``"abcdefg"``
-        * ``[a, b, c, d, ...]``
-        * ``(a, b, c, d, ...)``
-
-      Being a generic, subscribing it will signal further precision such as
-      ``SequenceLike[str]`` or ``SequenceLike[float]``.
-
-   .. data:: Point
-
-      A sequence of two numbers (floats or ints), i.e:
-
-        * ``pygame.Vector2(a, b)``
-        * ``[a, b]``
-        * ``(a, b)``
-
-   .. data:: IntPoint
-
-      A sequence of strictly two integers such as ``[a, b]`` or ``(a, b)``.
-
-   .. data:: ColorLike
-
-      An object representing a color such as a mapped integer, a string or
-      a sequence of three or four integers in range 0-255, types supported by
-      every function accepting a color argument. i.e.:
-
-        * ``pygame.Color(ColorLike)``
-        * ``(r, g, b)``
-        * ``(r, g, b, a)``
-        * ``[r, g, b, a]``
-        * ``"green"`` (:doc:`color_list`)
-        * ``"#rrggbbaa"``
-        * ``0`` (mapped color)
-
-   .. data:: RectLike
-
-      An object representing a rect such as a sequence of numbers or points
-      or an object with a rect attribute or a method returning a rect. These types
-      are supported by every function accepting a rect as argument. i.e.:
-
-        * ``(x, y, w, h)``
-        * ``(Point, Point)``
-        * ``pygame.Rect(RectLike)``
-        * Any object with a ``.rect`` attribute which is a ``RectLike`` or a function
-          returning a ``RectLike``
-
-.. ## pygame.typing ##
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/window.rst.txt b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/window.rst.txt
deleted file mode 100644
index 7d751ff..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_sources/ref/window.rst.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-.. include:: common.txt
-
-:mod:`pygame.Window`
-=====================
-
-.. currentmodule:: pygame
-
-.. autopgclass:: pygame.Window
-   :members:
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/basic.css b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/basic.css
index 7ebbd6d..f316efc 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/basic.css
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/basic.css
@@ -1,5 +1,12 @@
 /*
+ * basic.css
+ * ~~~~~~~~~
+ *
  * Sphinx stylesheet -- basic theme.
+ *
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
  */
 
 /* -- main layout ----------------------------------------------------------- */
@@ -108,11 +115,15 @@ img {
 /* -- search page ----------------------------------------------------------- */
 
 ul.search {
-    margin-top: 10px;
+    margin: 10px 0 0 20px;
+    padding: 0;
 }
 
 ul.search li {
-    padding: 5px 0;
+    padding: 5px 0 5px 20px;
+    background-image: url(file.png);
+    background-repeat: no-repeat;
+    background-position: 0 7px;
 }
 
 ul.search li a {
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/dark-theme-icon.svg b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/dark-theme-icon.svg
deleted file mode 100644
index bbf8868..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/dark-theme-icon.svg
+++ /dev/null
@@ -1,3 +0,0 @@
-
-    
-
\ No newline at end of file
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/doctools.js b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/doctools.js
index 0398ebb..4d67807 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/doctools.js
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/doctools.js
@@ -1,5 +1,12 @@
 /*
+ * doctools.js
+ * ~~~~~~~~~~~
+ *
  * Base JavaScript utilities for all Sphinx HTML documentation.
+ *
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
  */
 "use strict";
 
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/documentation_options.js b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/documentation_options.js
index de2da40..400c682 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/documentation_options.js
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/documentation_options.js
@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '2.5.8',
+    VERSION: '2.6.1',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/graphviz.css b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/graphviz.css
deleted file mode 100644
index 30f3837..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/graphviz.css
+++ /dev/null
@@ -1,12 +0,0 @@
-/*
- * Sphinx stylesheet -- graphviz extension.
- */
-
-img.graphviz {
-    border: 0;
-    max-width: 100%;
-}
-
-object.graphviz {
-    max-width: 100%;
-}
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/language_data.js b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/language_data.js
index c7fe6c6..367b8ed 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/language_data.js
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/language_data.js
@@ -1,6 +1,13 @@
 /*
+ * language_data.js
+ * ~~~~~~~~~~~~~~~~
+ *
  * This script contains the language-specific data used by searchtools.js,
  * namely the list of stopwords, stemmer, scorer and splitter.
+ *
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
  */
 
 var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"];
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/light-theme-icon.svg b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/light-theme-icon.svg
deleted file mode 100644
index fcc6150..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/light-theme-icon.svg
+++ /dev/null
@@ -1,3 +0,0 @@
-
-	
-
\ No newline at end of file
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame.css b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame.css
index 583967f..aed55f8 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame.css
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame.css
@@ -67,35 +67,17 @@ div.body table.matrix th.stub {
 /* Let a float element be beside a code block */
 div.highlight-python.notranslate {
     display: inline-block;
-    width: 100%;
 }
 
 /* -- page layout ----------------------------------------------------------- */
 
 body {
+    font-family: sans-serif;
     color: #000000;
     font-style: normal;
-    font-family: sans-serif;
-    background-color: #141414;
     text-decoration: none;
     text-align: left;
     border-style: none;
-    min-height: 100%;
-    display: flex;
-    flex-direction: column;
-}
-html {
-    background-color: #aaeebb;
-    height: 100vh;
-}
-html.dark-theme {
-    background-color: #1E1E1E;
-}
-html.dark-theme body {
-    color: #EEEEEE;
-}
-html:has(body.dark-theme) {
-    background-color: #1E1E1E;
 }
 
 div.header {
@@ -108,10 +90,7 @@ div.header > div {
     border-collapse: collapse;
     background-color: #6aee28;
 }
-.dark-theme div.header > div {
-    background-color: #141414;
-    border: none;
-}
+
 div.header .logo {
     background-color: #c2fc20;
     padding: 0.3em;
@@ -120,17 +99,12 @@ div.header .logo {
     align-items: center;
     justify-content: center;
     flex-direction: column;
-    min-width: 214px;
-}
-.dark-theme div.header .logo {
-    background-color: transparent;
-    border: none;
-    min-width: 214px;
 }
+
 div.header .logo img {
+    min-width: 200px;
+    min-height: 60px;
     border-style: none;
-    height: 80px;
-    min-width: 156px;
 }
 
 div.header .pagelinks {
@@ -153,137 +127,13 @@ div.header p.bottom {
 div.header .pagelinks a {
     text-decoration: underline;
 }
-.dark-theme div.header .pagelinks a {
-    text-decoration: none;
-}
 
 div.header .pagelinks a:hover {
     text-decoration: none;
 }
-.dark-theme div.header .pagelinks a:hover {
-    text-decoration: underline;
-}
-
-.pagelinks .top a {
-    color: #000000;
-    font-weight: 400;
-}
-.dark-theme .pagelinks .top a {
-    color: #EEEEEE;
-    font-size: 1.1rem;
-    font-weight: 600;
-}
-
-.pagelinks .bottom a {
-    font-weight: 400;
-    color: #000000;
-}
-.dark-theme .pagelinks .bottom a {
-    color: #2288ec;
-    font-size: 1.1rem;
-    font-weight: 600;
-}
-
-.dl .dt{
-    font-size: 1.1rem;
-    font-weight: 600;
-    color: #000000;
-}
-.dark-theme .dl .dt{
-    color: #EEEEEE;
-}
-
-.pagelinks .top{
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-}
-
-.pagelinks .top .nav-top-wrapper{
-    flex-grow: 1;
-}
-
-.pagelinks .bottom b{
-    color: #000000;
-}
-.dark-theme .pagelinks .bottom b{
-    color: #00ba10;
-}
-
-input[type="text"]{
-    background-color: #ffffff;
-    color: #000000;
-    font-size: 1rem;
-}
-.dark-theme input[type="text"]{
-    background-color: #292929;
-    color: #EEEEEE;
-    border-radius: ;
-    border: none;
-    padding: 0.3rem;
-}
-
-input[type="text"]:focus{
-    background-color: #ffffff;
-}
-.dark-theme input[type="text"]:focus{
-    background-color: #292929;
-}
-
-
-input[type="submit"]{
-    display: none;
-}
-
-.searchbar-form{
-    display: flex;
-    justify-content: space-between;
-    gap: 0.5rem;
-    justify-content: flex-end;
-}
-
-.searchbar-button{
-    background-color: transparent;
-    width: 24px;
-    position: relative;
-    top: 5px;
-    /* fill: ; */
-    cursor: pointer;
-}
-/*
-.dark-theme .searchbar-button{
-    fill: ;
-}
-*/
 
 div.document {
     background-color: #aaeebb;
-    overflow: hidden;
-    flex-grow: 1
-}
-.dark-theme div.document {
-    background-color: #1E1E1E;
-}
-
-.theme-icon {
-    cursor: pointer;
-    position: relative;
-    top: 2px;
-}
-/* Ignore this, gets rid of minor positionaning difference*/
-.theme-icon[data-theme="light-theme"] {
-    transform: translate(0, 2px);
-}
-.theme-icon[data-theme="dark-theme"] {
-    transform: translate(-4px, 2px);
-}
-
-/* Show the items when they are the same theme and not a theme-change icon */
-.light-theme *[data-theme="dark-theme"]{
-    display: none;
-}
-.dark-theme *[data-theme="light-theme"]{
-    display: none;
 }
 
 .flex-container {
@@ -291,13 +141,6 @@ div.document {
     flex-direction: row;
 }
 
-@media only screen and (max-width: 900px) {
-    .pagelinks .top{
-        flex-direction: column;
-        gap: 1rem;
-    }
-}
-
 @media only screen and (max-width: 680px) {
   .flex-container {
     flex-direction: column;
@@ -305,6 +148,7 @@ div.document {
 
   div.header .logo {
       border-right: none;
+      border-bottom: 3px solid black;
   }
 }
 
@@ -320,7 +164,7 @@ div.document {
 
 .toc td {
     display:block;
-    width: 200%;
+    width: min(200%, 100vw - 132px);
 }
 
 .toc td:last-child {
@@ -363,19 +207,13 @@ div.related {
     background-color: #6aee28;
     line-height: 30px;
     color: #000000;
-    font-size: 1rem;
-}
-.dark-theme div.related {
-    background-color: #141414;
-    color: #00ba10;
+    border-top: 3px solid black;
+    border-bottom: 3px solid black;
 }
 
 div.related a {
     color: #000000;
 }
-.dark-theme div.related a {
-    color: #00ba10;
-}
 
 div.sphinxsidebar {
 }
@@ -429,15 +267,9 @@ div.sphinxsidebar input {
 /* -- body styles ----------------------------------------------------------- */
 
 a {
+    color: #000000;
     background-color: transparent;
     text-decoration: underline;
-    color: #000000;
-    font-size: 1rem;
-}
-.dark-theme a {
-    color: #2288ec;
-    text-decoration: none;
-    font-weight: 600;
 }
 
 a:hover {
@@ -445,10 +277,6 @@ a:hover {
     background-color: transparent;
     text-decoration: none;
 }
-.dark-theme a:hover {
-    color: #2288ec;
-    text-decoration: underline;
-}
 
 p {
     margin: 0.5em 0;
@@ -468,7 +296,7 @@ dl.definition {
 }
 
 dt.title {
-    font-family: 'consolas', monospace;
+    font-family: monospace;
 }
 
 dt tt {
@@ -500,93 +328,7 @@ span.signature {
 }
 
 span.pre {
-    font-family: 'consolas', monospace;
-    color: #000000;
-}
-.dark-theme span.pre {
-    color: #00ba10;
-}
-
-a.reference.internal span.pre {
-    color: #000000;
-}
-.dark-theme a.reference.internal span.pre {
-    color: #2288ec;
-}
-
-a.tooltip.reference.internal span.pre {
-    color: #000000;
-}
-.dark-theme a.tooltip.reference.internal span.pre {
-    color: #00ba10;
-}
-
-dt code span.pre {
-    color: #000000;
-}
-.dark-theme dt code span.pre {
-    color: #e1cd62;
-}
-.dark-theme dt.title code span.pre {
-    color: #e1cd62;
-    font-size: 1.8rem;
-}
-
-/* Not sure if I need to enable this
-dt code {
-    background-color: transparent;
-}
-*/
-.dark-theme dt code {
-    background-color: transparent;
-}
-
-.highlight .o{
-    color: #242424;
-}
-.dark-theme .highlight .o{
-    color: #D4D4D4;
-}
-
-.highlight .c1{
-    color: #169d00;
-}
-.dark-theme .highlight .c1{
-    color: #169d00;
-}
-
-.highlight .kn, .highlight .k{
-    color: #DE6C90;
-}
-.dark-theme .highlight .kn, .dark-theme .highlight .k{
-    color: #DE6C90;
-}
-
-.highlight .n{
-    color: #333333;
-}
-.dark-theme .highlight .n{
-    color: #CBCBCB;
-}
-.dark-theme .highlight .hll{
-    background-color: #343434;
-}
-
-/* Doc strings */
-.highlight .sd{
-    color: #169d00;
-}
-.dark-theme .highlight .sd{
-    color: #169d00;
-}
-
-.dark-theme .highlight .nf,
-.dark-theme .highlight .fm {
-    color: #fee32d;
-}
-
-.dark-theme .highlight .nc {
-    color: #50b0fa; font-weight: bold
+    font-family: monospace;
 }
 
 code.download span.pre {
@@ -613,8 +355,6 @@ div.body h6 {
     font-weight: bold;
     margin: 1em 0 0.5em;
     text-align: left;
-    display: flex;
-    justify-content: center;
 }
 
 div.body h6 {
@@ -625,19 +365,8 @@ div.body h6 {
     line-height: 130%;
 }
 
-div.body h1 {
-    font-size: 1.5em; color: #000000;
-}
-.dark-theme div.body h1 {
-    color: #e1cd62;
-}
-div.body h2 {
-    font-size: 1.4em;
-    color: #000000;
-}
-.dark-theme div.body h2 {
-    color: #00b800;
-}
+div.body h1 { font-size: 1.5em; }
+div.body h2 { font-size: 1.4em; }
 div.body h3 { font-size: 1.3em; }
 div.body h4 { font-size: 1.2em; }
 div.body h5 { font-size: 1.1em; }
@@ -649,18 +378,11 @@ a.headerlink {
     padding: 0 4px 0 4px;
     text-decoration: none;
 }
-.dark-theme a.headerlink {
-    color: #68698b;
-}
 
 a.headerlink:hover {
     background-color: #68698b;
     color: white;
 }
-.dark-theme a.headerlink:hover {
-    background-color: #68698b;
-    color: white;
-}
 
 blockquote {
     margin-left: 2em;
@@ -685,7 +407,7 @@ p.admonition-title:after {
     content: ":";
 }
 
-dl.definition div.seealso {
+dl.definition div.note, dl.definition div.seealso {
     background: none;
     border: none;
 }
@@ -700,18 +422,13 @@ dl.definition .admonition-title {
 
 div.note {
     background-color: #eeeeee;
-    border: 1px solid #eeeeee;
+    border: 1px solid #ccc;
 }
 
 .note tt {
     background: #d6d6d6;
 }
 
-.dark-theme div.note {
-    background-color: #555349;
-    border: 1px solid #6e6b5e;
-}
-
 div.seealso {
     background-color: #ffc;
     border: 1px solid #ff6;
@@ -726,16 +443,9 @@ div.caution {
     border: 1px solid #aabb88;
 }
 
-.dark-theme div.caution {
-    background-color: rgb(255 25 25 / 30%);
-    border: 1px solid;
-    border-color: rgb(255 60 60);
-}
-
 div.warning {
-    background-color: #ffaec4;
+    background-color: #ffe4e4;
     border: 1px solid #f66;
-    color: #000;
 }
 
 .warning tt {
@@ -752,24 +462,6 @@ p.linklist {
 dt:target,
 span.highlighted {
     background-color: #c7c695;
-    padding-left: 0.4rem;
-}
-.dark-theme .section:target > h2,
-.dark-theme .section:target > h3,
-.dark-theme .section:target > h4,
-.dark-theme dt:target,
-.dark-theme span.highlighted {
-    background-color: #0E5114;
-    padding-left: 0.4rem;
-}
-
-code {
-    border-radius: 0.25em;
-    padding: 0 0.2em 0;
-    background-color: #eeffcc;
-}
-.dark-theme code {
-    background-color: #141414;
 }
 
 pre {
@@ -779,20 +471,15 @@ pre {
     border-right: none;
     color: #333333;
     display: block;
-    font-family: 'consolas', monospace;
+    font-family: monospace;
     line-height: 120%;
     margin-bottom: 1em;
     padding: 5px 5px 5px 15px;
     text-align: justify;
 }
-.dark-theme pre {
-    background-color: #141414;
-    color: #CBCBCB;
-}
 
 div.highlight pre {
     border: none;
-    white-space: pre;
 }
 
 ul.simple {
@@ -883,6 +570,7 @@ div.body span.codelineref {
 .py-class .pre,
 .reference.internal em {
     font-weight: bold;
+    background-color: #90ee90;
 }
 
 span.linenos {
@@ -918,10 +606,6 @@ div.example div.break {
 
 a.tooltip {
     text-decoration: underline;
-    color: #000000;
-}
-.dark-theme a.tooltip {
-    color: #00ba10;
 }
 
 a.tooltip:hover {
@@ -940,10 +624,6 @@ a.tooltip:hover {
     -webkit-box-shadow: 5px 5px rgba(0, 0, 0, 0.1);
     -moz-box-shadow: 5px 5px rgba(0, 0, 0, 0.1);
 }
-.dark-theme .tooltip-content {
-    background-color: #141414;
-    border: 1px solid #00ba10;
-}
 
 /* -- comments style --------------------------------------------------------- */
 
@@ -997,6 +677,10 @@ pre.commentContent {
 /* -- responsive design --------------------------------------------------------- */
 
 @media only screen and (max-width: 680px) {
+    /* Make tables be responsive-ish. */
+    table, thead, tbody, th, td, tr {
+        display: block;
+    }
 
     div.body img.inlined-right {
         float: none;
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_lofi.svg b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_lofi.svg
deleted file mode 100644
index 5169aad..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_lofi.svg
+++ /dev/null
@@ -1,289 +0,0 @@
-
-
-
-    
-        
-            
-        
-        
-            
-        
-    
-    
-        
-            
-        
-        
-            
-                
-            
-            
-                
-                
-                
-            
-            
-                
-                
-                
-                
-            
-            
-                
-                
-                
-            
-            
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-            
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-    
-    
-        
-        
-            
-        
-    
-    
-        
-            
-        
-        
-            
-        
-        
-            
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-            
-            
-                
-            
-        
-    
-    
-        
-            
-                
-            
-            
-                
-            
-        
-        
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-            
-        
-    
-
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_lofi.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_lofi.webp
deleted file mode 100644
index 48cddf2..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_lofi.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_logo.svg b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_logo.svg
deleted file mode 100644
index 609bc91..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_logo.svg
+++ /dev/null
@@ -1,289 +0,0 @@
-
-
-
-    
-        
-            
-        
-        
-            
-        
-    
-    
-        
-            
-        
-        
-            
-                
-            
-            
-                
-                
-                
-            
-            
-                
-                
-                
-                
-            
-            
-                
-                
-                
-            
-            
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-            
-            
-        
-    
-    
-        
-        
-            
-        
-    
-    
-        
-            
-        
-        
-            
-        
-        
-            
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-            
-            
-                
-            
-        
-    
-    
-        
-            
-                
-            
-            
-                
-            
-        
-        
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-            
-        
-    
-
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_logo.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_logo.webp
deleted file mode 100644
index d930bd1..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_logo.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered.svg b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered.svg
deleted file mode 100644
index 57d906c..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered.svg
+++ /dev/null
@@ -1,377 +0,0 @@
-
-
-
-    
-        
-            
-        
-        
-            
-        
-    
-    
-        
-            
-        
-        
-            
-                
-            
-            
-                
-                
-                
-            
-            
-                
-                
-                
-                
-            
-            
-                
-                
-                
-            
-            
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-            
-            
-        
-    
-    
-        
-        
-            
-        
-    
-    
-        
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-    
-    
-        
-            
-        
-        
-            
-        
-        
-            
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-                    
-                
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-            
-            
-                
-            
-        
-    
-    
-        
-            
-                
-            
-            
-                
-            
-        
-        
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-        
-        
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-                    
-                
-                
-                    
-                
-            
-            
-                
-            
-        
-    
-
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered.webp
deleted file mode 100644
index 65a3487..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered_lowres.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered_lowres.webp
deleted file mode 100644
index 10379a7..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_powered_lowres.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_tiny.webp b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_tiny.webp
deleted file mode 100644
index 0e652c0..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygame_ce_tiny.webp and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygments.css b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygments.css
index 5f2b0a2..0d49244 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygments.css
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/pygments.css
@@ -6,26 +6,26 @@ span.linenos.special { color: #000000; background-color: #ffffc0; padding-left:
 .highlight .hll { background-color: #ffffcc }
 .highlight { background: #eeffcc; }
 .highlight .c { color: #408090; font-style: italic } /* Comment */
-.highlight .err { border: 1px solid #F00 } /* Error */
+.highlight .err { border: 1px solid #FF0000 } /* Error */
 .highlight .k { color: #007020; font-weight: bold } /* Keyword */
-.highlight .o { color: #666 } /* Operator */
+.highlight .o { color: #666666 } /* Operator */
 .highlight .ch { color: #408090; font-style: italic } /* Comment.Hashbang */
 .highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
 .highlight .cp { color: #007020 } /* Comment.Preproc */
 .highlight .cpf { color: #408090; font-style: italic } /* Comment.PreprocFile */
 .highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
-.highlight .cs { color: #408090; background-color: #FFF0F0 } /* Comment.Special */
+.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
 .highlight .gd { color: #A00000 } /* Generic.Deleted */
 .highlight .ge { font-style: italic } /* Generic.Emph */
 .highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */
-.highlight .gr { color: #F00 } /* Generic.Error */
+.highlight .gr { color: #FF0000 } /* Generic.Error */
 .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
 .highlight .gi { color: #00A000 } /* Generic.Inserted */
-.highlight .go { color: #333 } /* Generic.Output */
-.highlight .gp { color: #C65D09; font-weight: bold } /* Generic.Prompt */
+.highlight .go { color: #333333 } /* Generic.Output */
+.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
 .highlight .gs { font-weight: bold } /* Generic.Strong */
 .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
-.highlight .gt { color: #04D } /* Generic.Traceback */
+.highlight .gt { color: #0044DD } /* Generic.Traceback */
 .highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
 .highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
 .highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
@@ -33,43 +33,43 @@ span.linenos.special { color: #000000; background-color: #ffffc0; padding-left:
 .highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
 .highlight .kt { color: #902000 } /* Keyword.Type */
 .highlight .m { color: #208050 } /* Literal.Number */
-.highlight .s { color: #4070A0 } /* Literal.String */
-.highlight .na { color: #4070A0 } /* Name.Attribute */
+.highlight .s { color: #4070a0 } /* Literal.String */
+.highlight .na { color: #4070a0 } /* Name.Attribute */
 .highlight .nb { color: #007020 } /* Name.Builtin */
-.highlight .nc { color: #0E84B5; font-weight: bold } /* Name.Class */
-.highlight .no { color: #60ADD5 } /* Name.Constant */
-.highlight .nd { color: #555; font-weight: bold } /* Name.Decorator */
-.highlight .ni { color: #D55537; font-weight: bold } /* Name.Entity */
+.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
+.highlight .no { color: #60add5 } /* Name.Constant */
+.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
+.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
 .highlight .ne { color: #007020 } /* Name.Exception */
-.highlight .nf { color: #06287E } /* Name.Function */
+.highlight .nf { color: #06287e } /* Name.Function */
 .highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
-.highlight .nn { color: #0E84B5; font-weight: bold } /* Name.Namespace */
+.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
 .highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
-.highlight .nv { color: #BB60D5 } /* Name.Variable */
+.highlight .nv { color: #bb60d5 } /* Name.Variable */
 .highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
-.highlight .w { color: #BBB } /* Text.Whitespace */
+.highlight .w { color: #bbbbbb } /* Text.Whitespace */
 .highlight .mb { color: #208050 } /* Literal.Number.Bin */
 .highlight .mf { color: #208050 } /* Literal.Number.Float */
 .highlight .mh { color: #208050 } /* Literal.Number.Hex */
 .highlight .mi { color: #208050 } /* Literal.Number.Integer */
 .highlight .mo { color: #208050 } /* Literal.Number.Oct */
-.highlight .sa { color: #4070A0 } /* Literal.String.Affix */
-.highlight .sb { color: #4070A0 } /* Literal.String.Backtick */
-.highlight .sc { color: #4070A0 } /* Literal.String.Char */
-.highlight .dl { color: #4070A0 } /* Literal.String.Delimiter */
-.highlight .sd { color: #4070A0; font-style: italic } /* Literal.String.Doc */
-.highlight .s2 { color: #4070A0 } /* Literal.String.Double */
-.highlight .se { color: #4070A0; font-weight: bold } /* Literal.String.Escape */
-.highlight .sh { color: #4070A0 } /* Literal.String.Heredoc */
-.highlight .si { color: #70A0D0; font-style: italic } /* Literal.String.Interpol */
-.highlight .sx { color: #C65D09 } /* Literal.String.Other */
+.highlight .sa { color: #4070a0 } /* Literal.String.Affix */
+.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
+.highlight .sc { color: #4070a0 } /* Literal.String.Char */
+.highlight .dl { color: #4070a0 } /* Literal.String.Delimiter */
+.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
+.highlight .s2 { color: #4070a0 } /* Literal.String.Double */
+.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
+.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
+.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
+.highlight .sx { color: #c65d09 } /* Literal.String.Other */
 .highlight .sr { color: #235388 } /* Literal.String.Regex */
-.highlight .s1 { color: #4070A0 } /* Literal.String.Single */
+.highlight .s1 { color: #4070a0 } /* Literal.String.Single */
 .highlight .ss { color: #517918 } /* Literal.String.Symbol */
 .highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
-.highlight .fm { color: #06287E } /* Name.Function.Magic */
-.highlight .vc { color: #BB60D5 } /* Name.Variable.Class */
-.highlight .vg { color: #BB60D5 } /* Name.Variable.Global */
-.highlight .vi { color: #BB60D5 } /* Name.Variable.Instance */
-.highlight .vm { color: #BB60D5 } /* Name.Variable.Magic */
+.highlight .fm { color: #06287e } /* Name.Function.Magic */
+.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
+.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
+.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
+.highlight .vm { color: #bb60d5 } /* Name.Variable.Magic */
 .highlight .il { color: #208050 } /* Literal.Number.Integer.Long */
\ No newline at end of file
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/script.js b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/script.js
deleted file mode 100644
index 0986d83..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/script.js
+++ /dev/null
@@ -1,32 +0,0 @@
-
-const htmlElement = document.documentElement;
-
-if (localStorage.getItem('theme') === null) {
-    localStorage.setItem('theme', 'light-theme');
-    htmlElement.classList.add('light-theme');
-} else {
-    htmlElement.classList.add(localStorage.getItem('theme'));
-}
-
-// Execute once the DOM is loaded
-document.addEventListener('DOMContentLoaded', () => {
-    const search_buttons = document.querySelectorAll('.searchbar-button');
-    const search_submit = document.querySelector('.searchbar-submit');
-
-    // When the icon is clicked, submit the search form
-    search_buttons.forEach((button) => {
-        button.addEventListener('click', () => {
-            search_submit.click();
-        });
-    });
-
-    const theme_icons = document.querySelectorAll('.theme-icon');
-    theme_icons.forEach((icon) => {
-        icon.addEventListener('click', () => {
-            const theme = icon.getAttribute('data-theme');
-            htmlElement.classList.add('light-theme', 'dark-theme');
-            htmlElement.classList.remove(theme);
-            localStorage.setItem('theme', htmlElement.classList[0]);
-        });
-    });
-});
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/searchbar-icon.svg b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/searchbar-icon.svg
deleted file mode 100644
index 653668d..0000000
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/searchbar-icon.svg
+++ /dev/null
@@ -1,3 +0,0 @@
-
-    
-
\ No newline at end of file
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/searchtools.js b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/searchtools.js
index 2c774d1..b08d58c 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/searchtools.js
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/searchtools.js
@@ -1,5 +1,12 @@
 /*
+ * searchtools.js
+ * ~~~~~~~~~~~~~~~~
+ *
  * Sphinx JavaScript utilities for the full-text search.
+ *
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
  */
 "use strict";
 
@@ -13,7 +20,7 @@ if (typeof Scorer === "undefined") {
     // and returns the new score.
     /*
     score: result => {
-      const [docname, title, anchor, descr, score, filename, kind] = result
+      const [docname, title, anchor, descr, score, filename] = result
       return score
     },
     */
@@ -40,14 +47,6 @@ if (typeof Scorer === "undefined") {
   };
 }
 
-// Global search result kind enum, used by themes to style search results.
-class SearchResultKind {
-    static get index() { return  "index"; }
-    static get object() { return "object"; }
-    static get text() { return "text"; }
-    static get title() { return "title"; }
-}
-
 const _removeChildren = (element) => {
   while (element && element.lastChild) element.removeChild(element.lastChild);
 };
@@ -65,13 +64,9 @@ const _displayItem = (item, searchTerms, highlightTerms) => {
   const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY;
   const contentRoot = document.documentElement.dataset.content_root;
 
-  const [docName, title, anchor, descr, score, _filename, kind] = item;
+  const [docName, title, anchor, descr, score, _filename] = item;
 
   let listItem = document.createElement("li");
-  // Add a class representing the item's type:
-  // can be used by a theme's CSS selector for styling
-  // See SearchResultKind for the class names.
-  listItem.classList.add(`kind-${kind}`);
   let requestUrl;
   let linkUrl;
   if (docBuilder === "dirhtml") {
@@ -120,10 +115,8 @@ const _finishSearch = (resultCount) => {
       "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories."
     );
   else
-    Search.status.innerText = Documentation.ngettext(
-      "Search finished, found one page matching the search query.",
-      "Search finished, found ${resultCount} pages matching the search query.",
-      resultCount,
+    Search.status.innerText = _(
+      "Search finished, found ${resultCount} page(s) matching the search query."
     ).replace('${resultCount}', resultCount);
 };
 const _displayNextItem = (
@@ -145,7 +138,7 @@ const _displayNextItem = (
   else _finishSearch(resultCount);
 };
 // Helper function used by query() to order search results.
-// Each input is an array of [docname, title, anchor, descr, score, filename, kind].
+// Each input is an array of [docname, title, anchor, descr, score, filename].
 // Order the results by score (in opposite order of appearance, since the
 // `_displayNextItem` function uses pop() to retrieve items) and then alphabetically.
 const _orderResultsByScoreThenName = (a, b) => {
@@ -255,7 +248,6 @@ const Search = {
     searchSummary.classList.add("search-summary");
     searchSummary.innerText = "";
     const searchList = document.createElement("ul");
-    searchList.setAttribute("role", "list");
     searchList.classList.add("search");
 
     const out = document.getElementById("search-results");
@@ -326,7 +318,7 @@ const Search = {
     const indexEntries = Search._index.indexentries;
 
     // Collect multiple result groups to be sorted separately and then ordered.
-    // Each is an array of [docname, title, anchor, descr, score, filename, kind].
+    // Each is an array of [docname, title, anchor, descr, score, filename].
     const normalResults = [];
     const nonMainIndexResults = [];
 
@@ -345,7 +337,6 @@ const Search = {
             null,
             score + boost,
             filenames[file],
-            SearchResultKind.title,
           ]);
         }
       }
@@ -363,7 +354,6 @@ const Search = {
             null,
             score,
             filenames[file],
-            SearchResultKind.index,
           ];
           if (isMain) {
             normalResults.push(result);
@@ -485,7 +475,6 @@ const Search = {
         descr,
         score,
         filenames[match[0]],
-        SearchResultKind.object,
       ]);
     };
     Object.keys(objects).forEach((prefix) =>
@@ -596,7 +585,6 @@ const Search = {
         null,
         score,
         filenames[file],
-        SearchResultKind.text,
       ]);
     }
     return results;
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/upstream_logos.zip b/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/upstream_logos.zip
deleted file mode 100644
index d3f5eb4..0000000
Binary files a/.venv/lib/python3.14/site-packages/pygame/docs/generated/_static/upstream_logos.zip and /dev/null differ
diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api.html
index 3eda0ef..6943f8e 100644
--- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api.html
+++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api.html
@@ -5,19 +5,17 @@
     
     
 
-    pygame C API — pygame-ce v2.5.8 documentation
-    
-    
-    
-    
-    
+    pygame C API — pygame v2.6.1 documentation
+    
+    
+    
+    
     
-    
     
     
     
     
-     
+     
     
 
     
@@ -25,30 +23,24 @@

src_c/include/ contains header files for applications @@ -130,7 +118,7 @@ headers used by pygame internally.




-Edit on GitHub +Edit on GitHub
@@ -149,14 +137,16 @@ headers used by pygame internally.

next |
  • - previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/base.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/base.html index 34f9dd4..9b3a162 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/base.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/base.html @@ -5,14 +5,12 @@ - High level API exported by pygame.base — pygame-ce v2.5.8 documentation - - - - - + High level API exported by pygame.base — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -209,8 +199,7 @@ No Python exceptions are raised.

    int pg_RGBAFromObj(PyObject *obj, Uint8 *RGBA)
    -

    You probably want to use the pg_RGBAFromObjEx() function instead of this.

    -

    Convert the color represented by object obj into a red, green, blue, alpha +

    Convert the color represented by object obj into a red, green, blue, alpha length 4 C array RGBA. The object must be a length 3 or 4 sequence of numbers having values between 0 and 255 inclusive. @@ -327,21 +316,13 @@ Argument screen may be NULL. This functions is called by pygame.display.set_mode().

    -
    -
    -PyObject *pgObject_getRectHelper(PyObject *rect, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames, char *type)
    -

    Return a rectangle covering the entire object. Rectangle will start at (0, 0) -with a width and height the same size as the object. You can pass keyword -arguments to be applied to the attributes of the rect before it is returned.

    -
    -


    -Edit on GitHub +Edit on GitHub
    @@ -362,13 +343,15 @@ arguments to be applied to the attributes of the rect before it is returned.

  • previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/bufferproxy.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/bufferproxy.html index 6d0acf7..3bb4abc 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/bufferproxy.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/bufferproxy.html @@ -5,14 +5,12 @@ - Class BufferProxy API exported by pygame.bufferproxy — pygame-ce v2.5.8 documentation - - - - - + Class BufferProxy API exported by pygame.bufferproxy — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -106,24 +96,24 @@

    src_c/bufferproxy.c

    This extension module defines Python type pygame.BufferProxypygame object to export a surface buffer through an array protocol.

    -

    Header file: src_c/include/pygame.h

    +

    Header file: src_c/include/pygame_bufferproxy.h

    -
    -PyTypeObject *pgBufferProxy_Type
    +
    +PyTypeObject *pgBufproxy_Type

    The pygame buffer proxy object type pygame.BufferProxy.

    -
    -int pgBufferProxy_Check(PyObject *x)
    +
    +int pgBufproxy_Check(PyObject *x)

    Return true if Python object x is a pygame.BufferProxy instance, false otherwise. This will return false on pygame.BufferProxy subclass instances as well.

    -
    -PyObject *pgBufferProxy_New(PyObject *obj, getbufferproc get_buffer)
    +
    +PyObject *pgBufproxy_New(PyObject *obj, getbufferproc get_buffer)

    Return a new pygame.BufferProxy instance. Argument obj is the Python object that has its data exposed. It may be NULL. @@ -133,16 +123,16 @@ On failure raise a Python error and return -

    -PyObject *pgBufferProxy_GetParent(PyObject *obj)
    +
    +PyObject *pgBufproxy_GetParent(PyObject *obj)

    Return the Python object wrapped by buffer proxy obj. Argument obj must not be NULL. On failure, raise a Python error and return NULL.

    -
    -int pgBufferProxy_Trip(PyObject *obj)
    +
    +int pgBufproxy_Trip(PyObject *obj)

    Cause the buffer proxy object obj to create a pg_buffer view of its parent. Argument obj must not be NULL. Return 0 on success, otherwise raise a Python error and return -1.

    @@ -154,7 +144,7 @@ Return 0

    -Edit on GitHub +Edit on GitHub
    @@ -175,13 +165,15 @@ Return 0 previous | - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/color.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/color.html index 55fe9f1..bbeaf95 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/color.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/color.html @@ -5,14 +5,12 @@ - Class Color API exported by pygame.color — pygame-ce v2.5.8 documentation - - - - - + Class Color API exported by pygame.color — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -105,7 +95,7 @@

    src_c/color.c

    -

    This extension module defines the Python type pygame.ColorPygame object for color representations..

    +

    This extension module defines the Python type pygame.Colorpygame object for color representations.

    Header file: src_c/include/pygame.h

    @@ -114,8 +104,8 @@
    -
    -int pgColor_CheckExact(PyObject *obj)
    +
    +int pgColor_Check(PyObject *obj)

    Return true if obj is an instance of type pgColor_Type, but not a pgColor_Type subclass instance. This macro does not check if obj is not NULL or indeed a Python type.

    @@ -124,7 +114,7 @@ This macro does not check if obj is not
    PyObject *pgColor_New(Uint8 rgba[])
    -

    Return a new pygame.Color instance from the four element array rgba. +

    Return a new pygame.Color instance for the the four element array rgba. On failure, raise a Python exception and return NULL.

    @@ -137,31 +127,13 @@ Argument length must be between NULL.

    -
    -
    -int pg_RGBAFromObjEx(PyObject *color, Uint8 rgba[], pgColorHandleFlags handle_flags)
    -

    Set the four element array rgba to the color represented by object color. -Return 1 on success, 0 otherwise and sets a python exception. -This in an extension of pg_RGBAFromObj() optimized for pgColor_Type -instances and tuples. It can also handle integer and string color inputs based -on handle_flags.

    -
    - -
    -
    -int pg_MappedColorFromObj(PyObject *val, SDL_Surface *surf, Uint32 *color, pgColorHandleFlags handle_flags)
    -

    Like above function, but returns mapped color instead. One notable point of difference is -the way in which ints are handled (this function directly interprets the int passed as the -mapped color on the surface surf`)

    -
    -



    -Edit on GitHub +Edit on GitHub
    @@ -182,13 +154,15 @@ mapped color on the surface previous | - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/display.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/display.html index 6c6a882..5095c0d 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/display.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/display.html @@ -5,14 +5,12 @@ - API exported by pygame.display — pygame-ce v2.5.8 documentation - - - - - + API exported by pygame.display — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -105,7 +95,7 @@

    src_c/display.c

    -

    This is the pygame.displayPygame module to control the display window and screen. extension module.

    +

    This is the pygame.displaypygame module to control the display window and screen extension module.

    Header file: src_c/include/pygame.h

    @@ -148,7 +138,7 @@ This macro does not check that x is not Edit on GitHub +Edit on GitHub
    @@ -169,13 +159,15 @@ This macro does not check that x is not previous | - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/event.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/event.html index eb0a5d1..a6c3d28 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/event.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/event.html @@ -5,14 +5,12 @@ - API exported by pygame.event — pygame-ce v2.5.8 documentation - - - - - + API exported by pygame.event — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -142,56 +132,19 @@ On failure raise a Python exception and return -
    -char *pgEvent_GetKeyDownInfo(void)
    -

    Return an array of bools (using char) of length SDL_NUM_SCANCODES -with the most recent key presses.

    +
    +PyObject *pgEvent_New2(int type, PyObject *dict)
    +

    Return a new pygame event instance of SDL type and with +attribute dictionary dict. +If dict is NULL an empty attribute dictionary is created. +On failure raise a Python exception and return NULL.

    -
    -char *pgEvent_GetKeyUpInfo(void)
    -

    Return an array of bools (using char) of length SDL_NUM_SCANCODES -with the most recent key releases.

    -
    - -
    -
    -char *pgEvent_GetMouseButtonDownInfo(void)
    -

    Return an array of bools (using char) of length 5 -with the most recent button presses.

    -
    - -
    -
    -char *pgEvent_GetMouseButtonUpInfo(void)
    -

    Return an array of bools (using char) of length 5 -with the most recent button releases.

    -
    - -
    -
    -int pg_post_event(Uint32 type, PyObject *dict)
    -

    Posts a pygame event that is an SDL_USEREVENT on the SDL side. This -function takes a python dict, which can be NULL too. -This function does not need GIL to be held if dict is NULL, but needs GIL -otherwise. Just like the SDL SDL_PushEvent function, returns 1 on -success, 0 if the event was not posted due to it being blocked, and -1 on -failure.

    -
    - -
    -
    -int pg_post_event_dictproxy(Uint32 type, pgEventDictProxy *dict_proxy)
    -

    Posts a pygame event that is an SDL_USEREVENT on the SDL side, can also -optionally take a dictproxy instance. Using this dictproxy API is especially -useful when multiple events that need to be posted share the same dict -attribute, like in the case of event timers. This way, the number of python -increfs and decrefs are reduced, and callers of this function don't need to -hold GIL for every event posted, the GIL only needs to be held during the -creation of the dictproxy instance, and when it is freed. -Just like the SDL SDL_PushEvent function, returns 1 on success, 0 if the -event was not posted due to it being blocked, and -1 on failure.

    +
    +int pgEvent_FillUserEvent(pgEventObject *e, SDL_Event *event)
    +

    Fill SDL event event with information from pygame user event instance e. +Return 0 on success, -1 otherwise.

    @@ -200,7 +153,7 @@ event was not posted due to it being blocked, and -1 on failure.




    -Edit on GitHub +Edit on GitHub
    @@ -221,13 +174,15 @@ event was not posted due to it being blocked, and -1 on failure.

  • previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/freetype.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/freetype.html index 087d060..fb6ff21 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/freetype.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/freetype.html @@ -5,18 +5,16 @@ - API exported by pygame._freetype — pygame-ce v2.5.8 documentation - - - - - + API exported by pygame._freetype — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
    @@ -151,7 +141,7 @@ or not a

    -Edit on GitHub +Edit on GitHub
    @@ -167,18 +157,20 @@ or not a modules |
  • - next |
  • previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/joystick.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/joystick.html deleted file mode 100644 index 0a90f6c..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/joystick.html +++ /dev/null @@ -1,167 +0,0 @@ - - - - - - - - API exported by pygame.joystick — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    src_c/joystick.c

    -

    The extension module pygame.joystickPygame module for interacting with joysticks, gamepads, and trackballs..

    -

    Header file: src_c/include/pygame.h

    -
    -
    -PyTypeObject *pgJoystick_Type
    -

    The Pygame joystick object type pygame.Joystick.

    -
    - -
    -
    -PyObject *pgJoystick_New(int id)
    -

    Return a new pygame.Joystick instance. -On failure, raise a Python exception and return NULL.

    -
    - -
    -
    -int pgJoystick_GetDeviceIndexByInstanceID(int instance_id)
    -

    Get the device index of a joystick by a instance id. -Return a device index. -On failure, it returns -1.

    -
    - -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/mixer.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/mixer.html index 20a8224..c784c4e 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/mixer.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/mixer.html @@ -5,19 +5,17 @@ - API exported by pygame.mixer — pygame-ce v2.5.8 documentation - - - - - + API exported by pygame.mixer — pygame v2.6.1 documentation + + + + - - +
    @@ -25,30 +23,24 @@
    @@ -184,7 +174,7 @@ A macro that does no Edit on GitHub +Edit on GitHub
    @@ -203,15 +193,17 @@ A macro that does no next |
  • - previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rect.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rect.html index e3352e2..98d10e9 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rect.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rect.html @@ -5,14 +5,12 @@ - Class Rect API exported by pygame.rect — pygame-ce v2.5.8 documentation - - - - - + Class Rect API exported by pygame.rect — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -105,7 +95,7 @@

    src_c/rect.c

    -

    This extension module defines Python type pygame.Rectpygame object for storing rectangular coordinates & pygame.FRect.

    +

    This extension module defines Python type pygame.Rectpygame object for storing rectangular coordinates.

    Header file: src_c/include/pygame.h

    @@ -118,41 +108,18 @@

    The Pygame rectangle type instance.

    -
    -
    -type pgFRectObject
    -
    -
    -SDL_FRect r
    -
    - -

    The Pygame rectangle type instance.

    -
    -
    PyTypeObject *pgRect_Type

    The Pygame rectangle object type pygame.Rect.

    -
    -
    -PyTypeObject *pgFRect_Type
    -

    The Pygame rectangle object type pygame.FRect.

    -
    -
    SDL_Rect pgRect_AsRect(PyObject *obj)

    A macro to access the SDL_Rect field of a pygame.Rect instance.

    -
    -
    -SDL_FRect pgFRect_AsRect(PyObject *obj)
    -

    A macro to access the SDL_FRect field of a pygame.FRect instance.

    -
    -
    PyObject *pgRect_New(SDL_Rect *r)
    @@ -160,13 +127,6 @@ On failure, raise a Python exception and return NULL.

    -
    -
    -PyObject *pgFRect_New(SDL_FRect *r)
    -

    Return a new pygame.FRect instance from the SDL_FRect r. -On failure, raise a Python exception and return NULL.

    -
    -
    PyObject *pgRect_New4(int x, int y, int w, int h)
    @@ -175,14 +135,6 @@ size (w, h). On failure raise a Python exception and return NULL.

    -
    -
    -PyObject *pgFRect_New4(float x, float y, float w, float h)
    -

    Return a new pygame.FRect instance with position (x, y) and -size (w, h). -On failure raise a Python exception and return NULL.

    -
    -
    SDL_Rect *pgRect_FromObject(PyObject *obj, SDL_Rect *temp)
    @@ -198,21 +150,6 @@ of the rectangle, else return NULL. No Python exceptions are raised.

    -
    -
    -SDL_FRect *pgFRect_FromObject(PyObject *obj, SDL_FRect *temp)
    -

    Translate a Python rectangle representation as a Pygame SDL_FRect. -A rectangle can be a length 4 sequence floats (x, y, w, h), -or a length 2 sequence of position (x, y) and size (w, h), -or a length 1 tuple containing a rectangle representation, -or have a method rect that returns a rectangle. -Pass a pointer to a locally declared SDL_FRect as temp. -Do not rely on this being filled in; use the function's return value instead. -On success, return a pointer to a SDL_FRect representation -of the rectangle, else return NULL. -No Python exceptions are raised.

    -
    -
    void pgRect_Normalize(SDL_Rect *rect)
    @@ -221,10 +158,9 @@ height) will be adjusted to have a positive size.

    -
    -void pgFRect_Normalize(SDL_FRect *rect)
    -

    Normalize the given rect. A rect with a negative size (negative width and/or -height) will be adjusted to have a positive size.

    +
    +int pgRect_Check(PyObject *obj)
    +

    A macro to check if obj is a pygame.Rect instance.

    @@ -233,7 +169,7 @@ height) will be adjusted to have a positive size.




    -Edit on GitHub +Edit on GitHub
    @@ -254,13 +190,15 @@ height) will be adjusted to have a positive size.

  • previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rwobject.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rwobject.html index d223a79..1c3a2a8 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rwobject.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/rwobject.html @@ -5,14 +5,12 @@ - API exported by pygame.rwobject — pygame-ce v2.5.8 documentation - - - - - + API exported by pygame.rwobject — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -140,6 +130,14 @@ On error raise a Python exception and return pgRWops_FromFileObject().

    +
    +
    +int pgRWops_ReleaseObject(SDL_RWops *context)
    +

    Free a SDL_RWops struct. If it is attached to a Python file-like object, decrement its +refcount. Otherwise, close the file handle. +Return 0 on success. On error, raise a Python exception and return a negative value.

    +
    +
    PyObject *pg_EncodeFilePath(PyObject *obj, PyObject *eclass)
    @@ -167,7 +165,7 @@ If obj is


    -Edit on GitHub +Edit on GitHub
    @@ -188,13 +186,15 @@ If obj is
  • previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/slots.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/slots.html index 7a2bd38..c4d3abc 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/slots.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/slots.html @@ -5,14 +5,12 @@ - Slots and c_api - Making functions and data available from other modules — pygame-ce v2.5.8 documentation - - - - - + Slots and c_api - Making functions and data available from other modules — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -128,7 +118,7 @@


    -Edit on GitHub +Edit on GitHub
    @@ -149,13 +139,15 @@
  • previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surface.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surface.html index 09314ad..99bd166 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surface.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surface.html @@ -5,14 +5,12 @@ - Class Surface API exported by pygame.surface — pygame-ce v2.5.8 documentation - - - - - + Class Surface API exported by pygame.surface — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -105,7 +95,7 @@

    src_c/surface.c

    -

    This extension module defines Python type pygame.SurfacePygame object for representing images..

    +

    This extension module defines Python type pygame.Surfacepygame object for representing images.

    Header file: src_c/include/pygame.h

    @@ -134,6 +124,14 @@ This is a macro. No check is made that x is not NULL.

    Return NULL on error.

    +
    +
    +pgSurfaceObject *pgSurface_New2(SDL_Surface *s, int owner)
    +

    Return a new new pygame surface instance for SDL surface s. +If owner is true, the surface will be freed when the python object is destroyed. +Return NULL on error.

    +
    +
    SDL_Surface *pgSurface_AsSurface(PyObject *x)
    @@ -145,9 +143,9 @@ Surface, instance.

    -int pgSurface_Blit(PyObject *dstobj, PyObject *srcobj, SDL_Rect *dstrect, SDL_Rect *srcrect, int blend_flags)
    +int pgSurface_Blit(PyObject *dstobj, PyObject *srcobj, SDL_Rect *dstrect, SDL_Rect *srcrect, int the_args)

    Blit the srcrect portion of Surface srcobj onto Surface dstobj at srcobj

    -

    Argument blend_flags indicates the type of blit to perform: +

    Argument the_args indicates the type of blit to perform: Normal blit (0), PYGAME_BLEND_ADD, PYGAME_BLEND_SUB, PYGAME_BLEND_SUB, PYGAME_BLEND_MULT, PYGAME_BLEND_MIN, PYGAME_BLEND_MAX, PYGAME_BLEND_RGBA_ADD, PYGAME_BLEND_RGBA_SUB, @@ -156,7 +154,7 @@ Normal blit (0dstrect is updated to the actual area on dstobj affected by the blit.

    The C version of the pygame.Surface.blit() method. -Return 0 on success, 1 on an exception.

    +Return 0 on success, -1 or -2` on an exception.

    @@ -165,7 +163,7 @@ Return 0

    -Edit on GitHub +Edit on GitHub
    @@ -186,13 +184,15 @@ Return 0 previous | - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surflock.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surflock.html index 9016b25..1e75d75 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surflock.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/surflock.html @@ -5,14 +5,12 @@ - API exported by pygame.surflock — pygame-ce v2.5.8 documentation - - - - - + API exported by pygame.surflock — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -106,8 +96,45 @@

    src_c/surflock.c

    This extension module implements SDL surface locking for the -pygame.SurfacePygame object for representing images. type.

    +pygame.Surfacepygame object for representing images type.

    Header file: src_c/include/pygame.h

    +
    +
    +type pgLifetimeLockObject
    +
    +
    +PyObject *surface
    +

    An SDL locked pygame surface.

    +
    + +
    +
    +PyObject *lockobj
    +

    The Python object which owns the lock on the surface. +This field does not own a reference to the object.

    +
    + +

    The lifetime lock type instance. +A lifetime lock pairs a locked pygame surface with +the Python object that locked the surface for modification. +The lock is removed automatically when the lifetime lock instance +is garbage collected.

    +
    + +
    +
    +PyTypeObject *pgLifetimeLock_Type
    +

    The pygame internal surflock lifetime lock object type.

    +
    + +
    +
    +int pgLifetimeLock_Check(PyObject *x)
    +

    Return true if Python object x is a pgLifetimeLock_Type instance, +false otherwise. +This will return false on pgLifetimeLock_Type subclass instances as well.

    +
    +
    void pgSurface_Prep(pgSurfaceObject *surfobj)
    @@ -150,13 +177,22 @@ and call to +
    +PyObject *pgSurface_LockLifetime(PyObject *surfobj, PyObject *lockobj)
    +

    Lock pygame surface surfobj for Python object lockobj and return a +new pgLifetimeLock_Type instance for the lock.

    +

    This function is not called anywhere within pygame. +It and pgLifetimeLock_Type are candidates for removal.

    +
    +



    -Edit on GitHub +Edit on GitHub
    @@ -177,13 +213,15 @@ and call to previous | - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/version.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/version.html index da3fe43..5e3d88c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/version.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/version.html @@ -5,18 +5,16 @@ - API exported by pygame.version — pygame-ce v2.5.8 documentation - - - - - + API exported by pygame.version — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
    @@ -107,7 +97,7 @@

    src_py/version.py

    Header file: src_c/include/pygame.h

    Version information can be retrieved at compile-time using these macros.

    -
    +

    New in pygame 1.9.5.

    @@ -144,7 +134,7 @@ to the specified version.




    -Edit on GitHub +Edit on GitHub
    @@ -160,18 +150,20 @@ to the specified version.

    modules |
  • - next |
  • previous |
  • - + - + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/window.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/window.html deleted file mode 100644 index 92d7265..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/c_api/window.html +++ /dev/null @@ -1,166 +0,0 @@ - - - - - - - - Class Window API exported by pygame.window — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    src_c/window.c

    -

    This extension module defines Python type pygame.WindowPygame object that represents a window..

    -

    Header file: src_c/include/pygame.h

    -
    -
    -type pgWindowObject
    -

    A pygame.window.Window instance.

    -
    - -
    -
    -PyTypeObject *pgWindow_Type
    -

    The pygame.window.Window Python type.

    -
    - -
    -
    -int pgWindow_Check(PyObject *x)
    -

    Return true if x is a pygame.window.Window instance

    -

    Will return false if x is not a subclass of Window. -This is a macro. No check is made that x is not NULL.

    -
    - -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/filepaths.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/filepaths.html index 4a4862e..0f015cb 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/filepaths.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/filepaths.html @@ -5,19 +5,17 @@ - File Path Function Arguments — pygame-ce v2.5.8 documentation - - - - - + File Path Function Arguments — pygame v2.6.1 documentation + + + + - - - + +
    @@ -25,30 +23,24 @@
    @@ -121,7 +111,7 @@ The exception types are function-dependent.




    -Edit on GitHub +Edit on GitHub
    @@ -137,17 +127,19 @@ The exception types are function-dependent.

    modules |
  • - next |
  • - previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/genindex.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/genindex.html index 4b0e714..1f90e1f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/genindex.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/genindex.html @@ -4,14 +4,12 @@ - Index — pygame-ce v2.5.8 documentation - - - - - + Index — pygame v2.6.1 documentation + + + + - @@ -25,7 +23,7 @@
  • modules |
  • - + @@ -62,8 +60,6 @@ | U | V | W - | X - | Y

    _

    @@ -73,7 +69,7 @@ @@ -82,17 +78,9 @@
  • aliens.main() (in module pygame.examples) -
  • -
  • align (pygame.font.Font attribute)
  • alive() (pygame.sprite.Sprite method)
  • @@ -125,17 +111,9 @@
  • (pygame._sdl2.video.Texture attribute)
  • -
  • always_on_top (pygame.Window attribute) -
  • angle (pygame._sdl2.video.Image attribute) - -
  • angle() (pygame.mask.Mask method) -
  • -
  • angle_rad (pygame.math.Vector2 attribute)
  • angle_to() (pygame.math.Vector2 method) @@ -153,8 +131,6 @@
  • (in module pygame.gfxdraw)
  • -
  • area (pygame.Circle attribute) -
  • array() (in module pygame.sndarray)
  • array2d() (in module pygame.surfarray) @@ -174,14 +150,10 @@
  • array_to_surface() (in module pygame.pixelcopy)
  • arraydemo.main() (in module pygame.examples) -
  • -
  • as_frect() (pygame.Circle method)
  • as_joystick() (pygame._sdl2.controller.Controller method)
  • as_polar() (pygame.math.Vector2 method) -
  • -
  • as_rect() (pygame.Circle method)
  • as_spherical() (pygame.math.Vector3 method)
  • @@ -192,10 +164,6 @@
  • average_color() (in module pygame.transform)
  • average_surfaces() (in module pygame.transform) -
  • -
  • ax (pygame.Line attribute) -
  • -
  • ay (pygame.Line attribute)
  • @@ -204,11 +172,7 @@
    -
  • blit_array() (in module pygame.surfarray) -
  • @@ -261,7 +217,7 @@
  • camera.main() (in module pygame.examples)
  • -
  • center (pygame.Circle attribute) +
  • CD (class in pygame.cdrom)
  • centroid() (pygame.mask.Mask method)
  • @@ -276,8 +232,6 @@
  • chimp.main() (in module pygame.examples)
  • chop() (in module pygame.transform) -
  • -
  • Circle (class in pygame)
  • circle() (in module pygame.draw) @@ -285,8 +239,6 @@
  • (in module pygame.gfxdraw)
  • -
  • circumference (pygame.Circle attribute) -
  • clamp() (in module pygame.math) + -
  • -
  • ColorLike (in module pygame.typing) -
  • colorspace() (in module pygame.camera)
  • compare() (pygame.PixelArray method)
  • compile() (in module pygame.cursors) -
  • -
  • compose_custom_blend_mode() (pygame._sdl2.video.Renderer method)
  • connected_component() (pygame.mask.Mask method)
  • @@ -408,8 +336,6 @@
  • contains() (in module pygame.scrap)
  • @@ -421,24 +347,14 @@
  • convolve() (pygame.mask.Mask method)
  • -
  • coordinates_from_window() (pygame._sdl2.video.Renderer method) -
  • -
  • coordinates_to_window() (pygame._sdl2.video.Renderer method) -
  • -
  • copy() (pygame.Circle method) +
  • copy() (pygame.cursors.Cursor method)
  • + + -

    E

    - - - - - - - - @@ -350,120 +332,85 @@ which case the set of names will be searched in order.

    - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - - - - - - - - - - - - - - - - - + - - - - - - - - - + - + - + - - - - - +
    -
  • fill_quad() (pygame._sdl2.video.Renderer method) -
  • fill_rect() (pygame._sdl2.video.Renderer method) -
  • -
  • fill_triangle() (pygame._sdl2.video.Renderer method)
  • filled_circle() (in module pygame.gfxdraw)
  • @@ -632,32 +532,20 @@
  • fixed_sizes (pygame.freetype.Font attribute)
  • fixed_width (pygame.freetype.Font attribute) -
  • -
  • flash() (pygame.Window method)
  • flip() (in module pygame.display)
  • -
  • flip_ab() (pygame.Line method) -
  • -
  • flip_ab_ip() (pygame.Line method) +
  • flip_x (pygame._sdl2.video.Image attribute)
    • -
    • flip_x (pygame._sdl2.video.Image attribute) -
    • flip_y (pygame._sdl2.video.Image attribute)
    • -
    • flood_fill() (in module pygame.draw) -
    • -
    • focus() (pygame.Window method) -
    • -
    • focused (pygame.Window property) +
    • focus() (pygame._sdl2.video.Window method)
    • Font (class in pygame.font) @@ -671,21 +559,9 @@
    • frequency_to_midi() (in module pygame.midi)
    • -
    • from_cmy() (pygame.Color class method) -
    • -
    • from_display_module() (pygame.Window class method) -
    • -
    • from_hex() (pygame.Color class method) -
    • -
    • from_hsla() (pygame.Color class method) -
    • -
    • from_hsva() (pygame.Color class method) -
    • -
    • from_i1i2i3() (pygame.Color class method) +
    • from_display_module() (pygame._sdl2.video.Window class method)
    • from_joystick() (pygame._sdl2.controller.Controller static method) -
    • -
    • from_normalized() (pygame.Color class method)
    • from_polar() (pygame.math.Vector2 method)
    • @@ -700,7 +576,11 @@
    • from_threshold() (in module pygame.mask)
    • from_window() (pygame._sdl2.video.Renderer class method) + +
    • frombuffer() (in module pygame.image)
    • frombytes() (in module pygame.image) @@ -714,12 +594,12 @@ - + - + - + - + - + - + - + - + - +
    • get_rel() (in module pygame.mouse) -
    • -
    • get_relative_mode() (in module pygame.mouse)
    • get_repeat() (in module pygame.key)
    • @@ -1082,8 +954,6 @@
    • get_smoothscale_backend() (in module pygame.transform)
    • get_sound() (pygame.mixer.Channel method) -
    • -
    • get_soundfont() (in module pygame.mixer)
    • get_sprite() (pygame.sprite.LayeredUpdates method)
    • @@ -1094,12 +964,6 @@
    • get_strikethrough() (pygame.font.Font method)
    • get_surface() (in module pygame.display) - -
    • -
    • get_text() (in module pygame.scrap)
    • get_ticks() (in module pygame.time)
    • @@ -1109,7 +973,11 @@
    • get_top_sprite() (pygame.sprite.LayeredUpdates method)
    • -
    • get_total_ram() (in module pygame.system) +
    • get_track_audio() (pygame.cdrom.CD method) +
    • +
    • get_track_length() (pygame.cdrom.CD method) +
    • +
    • get_track_start() (pygame.cdrom.CD method)
    • get_types() (in module pygame.scrap)
    • @@ -1132,8 +1000,6 @@
    • get_width() (pygame.Surface method) -
    • -
    • get_window_position() (in module pygame.display)
    • get_window_size() (in module pygame.display)
    • @@ -1145,9 +1011,7 @@
    • glcube.main() (in module pygame.examples)
    • -
    • grab_keyboard (pygame.Window attribute) -
    • -
    • grab_mouse (pygame.Window attribute) +
    • grab (pygame._sdl2.video.Window attribute)
    • grayscale() (in module pygame.transform) @@ -1169,11 +1033,7 @@

      H

      + + + + pygame module for cursor resources + pygame module to control the display window and screen + pygame module for drawing shapes + + + - - - + Enhanced pygame module for loading and rendering computer fonts + pygame module for loading and saving images + pygame module to work with the keyboard + pygame module for image masks. + pygame module for vector classes + pygame module to work with the mouse + pygame module for general pixel array copying + pygame module for accessing sound sample data - - - + pygame module for monitoring time - - - + pygame module to transform surfaces - + @@ -171,6 +161,16 @@ + + + + + + + + @@ -188,156 +188,195 @@
      -
    • is_vsync() (in module pygame.display) -
    • italic (pygame.font.Font attribute)
    • itemsize (pygame.PixelArray attribute) @@ -1304,12 +1142,10 @@ + -
      -
    • load_animation() (in module pygame.image) -
    • load_basic() (in module pygame.image)
    • load_extended() (in module pygame.image) -
    • -
    • load_sized_svg() (in module pygame.image)
    • load_xbm() (in module pygame.cursors)
    • @@ -1439,11 +1263,7 @@
    • match_font() (in module pygame.font)
    • -
    • maximize() (pygame.Window method) -
    • -
    • maximum_size (pygame.Window property) -
    • -
    • message_box() (in module pygame.display) +
    • maximize() (pygame._sdl2.video.Window method)
    • metrics() (pygame.font.Font method)
    • @@ -1457,9 +1277,7 @@
    • midis2events() (in module pygame.midi)
    • -
    • minimize() (pygame.Window method) -
    • -
    • minimum_size (pygame.Window property) +
    • minimize() (pygame._sdl2.video.Window method)
    • mode_ok() (in module pygame.display)
    • @@ -1476,6 +1294,8 @@
    • pygame._sdl2.video
    • pygame.camera +
    • +
    • pygame.cdrom
    • pygame.cursors
    • @@ -1486,12 +1306,12 @@
    • pygame.event
    • pygame.examples +
    • +
    • pygame.fastevent
    • pygame.font
    • pygame.freetype -
    • -
    • pygame.geometry
    • pygame.gfxdraw
    • @@ -1524,43 +1344,21 @@
    • pygame.sprite
    • pygame.surfarray -
    • -
    • pygame.system
    • pygame.tests
    • pygame.time
    • pygame.transform -
    • -
    • pygame.typing
    • pygame.version
    • -
    • premul_alpha_ip() (pygame.Surface method) -
    • present() (pygame._sdl2.video.Renderer method)
    • -
    • print_debug_info() (in module pygame) -
    • -
    • project() (pygame.Line method) +
    • project() (pygame.math.Vector2 method)
    • pump() (in module pygame.event) + +
    • put() (in module pygame.scrap) -
    • -
    • put_text() (in module pygame.scrap)
    • pygame @@ -2023,6 +1791,13 @@
    • +
    • + pygame.cdrom + +
    • @@ -2058,6 +1833,13 @@
    • +
    • + pygame.fastevent + +
    • @@ -2072,13 +1854,6 @@
    • -
    • - pygame.geometry - -
    • @@ -2191,13 +1966,6 @@
    • -
    • - pygame.system - -
    • @@ -2219,13 +1987,6 @@
    • -
    • - pygame.typing - -
    • @@ -2253,6 +2014,8 @@
    • -

      X

      - - -
      - -

      Y

      - - -
      -
      @@ -2974,12 +2665,12 @@
    • modules |
    • - + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/index.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/index.html index 883dcb5..d67c581 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/index.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/index.html @@ -5,15 +5,12 @@ - Pygame-ce Front Page — pygame-ce v2.5.8 documentation - - - - - + Pygame Front Page — pygame v2.6.1 documentation + + + + - - @@ -25,30 +22,24 @@
      @@ -102,20 +91,19 @@
      -
      -

      Pygame-ce Front Page

      +
      +

      Pygame Front Page

      Quick start

      -

      Welcome to pygame-ce! Once you've got pygame-ce installed -(pip install pygame-ce or pip3 install pygame-ce for most -people), the next question is how to get a game loop running. Pygame-ce, -unlike some other libraries, gives you full control of program +

      Welcome to pygame! Once you've got pygame installed (pip install pygame or +pip3 install pygame for most people), the next question is how to get a game +loop running. Pygame, unlike some other libraries, gives you full control of program execution. That freedom means it is easy to mess up in your initial steps.

      Here is a good example of a basic setup (opens the window, updates the screen, and handles events)--

      # Example file showing a basic pygame "game loop"
      -import pygame
      +import pygame
       
       # pygame setup
       pygame.init()
      @@ -146,7 +134,7 @@ execution. That freedom means it is easy to mess up in your initial steps.

      Here is a slightly more fleshed out example, which shows you how to move something (a circle in this case) around on screen--

      # Example file showing a circle moving on screen
      -import pygame
      +import pygame
       
       # pygame setup
       pygame.init()
      @@ -191,37 +179,16 @@ execution. That freedom means it is easy to mess up in your initial steps.

      For more in depth reference, check out the Tutorials -section below, or reference the API documentation by module.

      -
      -
      -

      Experimental modules

      -

      Experimental modules are work in progress, this is why you should refrain from relying on any features -provided by these modules, as they are subject to change or removal without prior notice. -If you want to test these experimental modules, you might want to understand how you import -them, this is how you can do it:

      -
      from pygame import experimental_module
      -# Or for specific modules like _sdl2.controller
      -from pygame._sdl2 import controller
      -# Or
      -import pygame.experimental_module
      -
      -
      -

      Don't forget to report us any problem with the experimental features on github so we can easily -turn them to stable API in the future ^^.

      -

      Below is currently the list of experimental modules :

      -
      -
      pygame.geometry

      Pygame module for the Circle, Line, and Polygon objects.

      -
      -
      pygame._sdl2.controller

      Pygame module to work with controllers.

      -
      -
      pygame.sdl2_video

      Pygame module for porting new SDL video systems.

      -
      -
      +section below, check out a video tutorial (I'm a fan of this one), or reference the API +documentation by module.

      Documents

      -
      Readme

      Basic information about pygame: what it is, who is involved, and where to find it.

      +
      Readme

      Basic information about pygame: what it is, who is involved, and where to find it.

      +
      +
      Install

      Steps needed to compile pygame on several platforms. +Also help on finding and installing prebuilt binaries for your system.

      File Path Function Arguments

      How pygame handles file system paths.

      @@ -235,63 +202,41 @@ Generally, if pygame is not changed, it can be used with any type of program.

      Tutorials

      - -
      - -
      -
      YouTube video by DaFluffyPotato.
      -
      -
      -
      -
      Newbie Guide

      A list of thirteen helpful tips for people to get comfortable using pygame.

      +
      Introduction to Pygame

      An introduction to the basics of pygame. +This is written for users of Python and appeared in volume two of the Py magazine.

      -
      Import and Initialize

      The beginning steps on importing and initializing pygame. +

      Import and Initialize

      The beginning steps on importing and initializing pygame. The pygame package is made of several modules. Some modules are not included on all platforms.

      -
      How do I move an Image?

      A basic tutorial that covers the concepts behind 2D computer animation. +

      How do I move an Image?

      A basic tutorial that covers the concepts behind 2D computer animation. Information about drawing and clearing objects to make them appear animated.

      -
      Chimp Tutorial, Line by Line

      The pygame examples include a simple program with an interactive fist and a chimpanzee. +

      Chimp Tutorial, Line by Line

      The pygame examples include a simple program with an interactive fist and a chimpanzee. This was inspired by the annoying flash banner of the early 2000s. This tutorial examines every line of code used in the example.

      -
      What is Premultiplied Alpha?

      An explanation of alpha compositing and the advantages of using premultiplied alpha.

      -
      -
      Sprite Module Introduction

      Pygame includes a higher level sprite module to help organize games. +

      Sprite Module Introduction

      Pygame includes a higher level sprite module to help organize games. The sprite module includes several classes that help manage details found in almost all games types. The Sprite classes are a bit more advanced than the regular pygame modules, and need more understanding to be properly used.

      -
      Introduction to Pygame

      An introduction to the basics of pygame. -This is written for users of Python and appeared in volume two of the Py magazine.

      -
      -
      Surfarray Introduction

      Pygame used the NumPy python module to allow efficient per pixel effects on images. +

      Surfarray Introduction

      Pygame used the NumPy python module to allow efficient per pixel effects on images. Using the surface arrays is an advanced feature that allows custom effects and filters. This also examines some of the simple effects from the pygame example, arraydemo.py.

      -
      Camera Module Introduction

      Pygame, as of 1.9, has a camera module that allows you to capture images, +

      Camera Module Introduction

      Pygame, as of 1.9, has a camera module that allows you to capture images, watch live streams, and do some basic computer vision. This tutorial covers those use cases.

      -
      Making Games Tutorial

      A large tutorial that covers the bigger topics needed to create an entire game.

      +
      Newbie Guide

      A list of thirteen helpful tips for people to get comfortable using pygame.

      -
      Display Modes

      Getting a display surface for the screen.

      +
      Making Games Tutorial

      A large tutorial that covers the bigger topics needed to create an entire game.

      -
      Tutorial de Pygame - Ejemplo del Chimpancé, Línea Por Línea

      Los ejemplos de pygame incluyen un sencillo programa con un puño interactivo y un chimpancé. -Está inspirado en el molesto banner de flash de principios de la década de 2000. -Este tutorial examina cada línea de código utilizada en el ejemplo.

      +
      Display Modes

      Getting a display surface for the screen.

      +
      +
      한국어 튜토리얼 (Korean Tutorial)

      빨간블록 검은블록

      @@ -356,10 +301,6 @@ Este tutorial examina cada línea de código utilizada en el ejemplo.

      pygame.transform

      Resize and move images.

      -
      pygame.typing

      Provide common typehints

      -
      -
      pygame.Window

      Pygame object that handles a window.

      -
      pygame C API

      The C api shared amongst pygame extension modules.

      Search Page

      Search pygame documents by keyword.

      @@ -371,7 +312,7 @@ Este tutorial examina cada línea de código utilizada en el ejemplo.




      -Edit on GitHub +Edit on GitHub
      @@ -389,12 +330,14 @@ Este tutorial examina cada línea de código utilizada en el ejemplo.

    • next |
    • - - + + + +
      \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/logos.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/logos.html index 16c6871..ee3ab76 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/logos.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/logos.html @@ -5,14 +5,12 @@ - Pygame CE Logos Page — pygame-ce v2.5.8 documentation - - - - - + Pygame Logos Page — pygame v2.6.1 documentation + + + + - @@ -24,30 +22,24 @@
      @@ -101,54 +91,44 @@
      -
      -
      -

      Pygame CE Logos

      +
      +
      +

      Pygame Logos

      These logos are available for use in your own game projects. -Please put them up wherever you see fit.

      -

      The pygame-ce logo and its variants were created by Mega-JC and kadir014 on June 30, 2024.

      -
      -_images/pygame_ce_logo.webp - -_images/pygame_ce_lofi.webp - -_images/pygame_ce_powered.webp - -_images/pygame_ce_tiny.webp -
      - -
      -_images/pygame_ce_powered_lowres.webp - -
      -
      -

      Upstream & legacy logos

      -

      The pygame logo was originally created -by TheCorruptor on July 29, 2001.

      -

      It was upscaled alongside its "LoFi" and "Powered" variants by Mega-JC on +Please put them up wherever you see fit. The logo was created +by TheCorruptor on July 29, 2001 and upscaled by Mega_JC on August 29, 2021.

      +_images/pygame_logo.png +_images/pygame_lofi.png + +_images/pygame_powered.png + +_images/pygame_tiny.png +
      +
      pygame_tiny.png - 214 x 60
      +
      +_images/pygame_powered_lowres.png +

      There is a higher resolution layered photoshop image -available here. (1.3 MB)

      +available here. (1.3 MB)

      +
      +

      Legacy logos

      -
      - -
      +

      legacy_logos.zip - 50.1 KB

      @@ -157,7 +137,7 @@ available Edit on GitHub +Edit on GitHub
      @@ -175,12 +155,14 @@ available previous | - - + + + +
      \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/py-modindex.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/py-modindex.html index 703d2e2..b708bed 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/py-modindex.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/py-modindex.html @@ -4,14 +4,12 @@ - Python Module Index — pygame-ce v2.5.8 documentation - - - - - + Python Module Index — pygame v2.6.1 documentation + + + + - @@ -28,7 +26,7 @@
    • modules |
    • - + @@ -69,21 +67,26 @@
          pygame.camera pygame module for camera use
          + pygame.cdrom + pygame module for audio cdrom control
          pygame.cursors - Pygame module for cursor resources.
          pygame.display - Pygame module to control the display window and screen.
          pygame.draw - Pygame module for drawing shapes.
          @@ -94,6 +97,12 @@     pygame.examples module of example programs
          + pygame.fastevent + pygame module for interacting with events and queues from multiple +threads.
          @@ -103,12 +112,7 @@     pygame.freetype - pygame module for loading and rendering computer fonts
          - pygame.geometry - pygame geometry module
          @@ -118,7 +122,7 @@     pygame.image - Pygame module for image transfer.
          @@ -128,7 +132,7 @@     pygame.key - Pygame module to work with the keyboard.
          @@ -138,12 +142,12 @@     pygame.mask - Pygame module for image masks.
          pygame.math - Pygame module for vector classes.
          @@ -163,12 +167,12 @@     pygame.mouse - Pygame module to work with the mouse.
          pygame.pixelcopy - Pygame module for general pixel array copying.
          @@ -178,7 +182,7 @@     pygame.sndarray - Pygame module for accessing sound sample data.
          @@ -189,11 +193,6 @@     pygame.surfarray pygame module for accessing surface pixel data using array interfaces
          - pygame.system - Pygame module to provide additional context about the system.
          @@ -203,17 +202,12 @@     pygame.time - Pygame module for monitoring time.
          pygame.transform - Pygame module to transform surfaces.
          - pygame.typing - pygame module providing common typehints
          @@ -244,12 +238,12 @@
    • modules |
    • - + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/bufferproxy.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/bufferproxy.html index f9fd0e6..d43b2f9 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/bufferproxy.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/bufferproxy.html @@ -5,19 +5,17 @@ - pygame.BufferProxy — pygame-ce v2.5.8 documentation - - - - - + pygame.BufferProxy — pygame v2.6.1 documentation + + + + - - +
      @@ -25,30 +23,24 @@
      @@ -108,7 +98,7 @@ pygame.BufferProxy
      pygame object to export a surface buffer through an array protocol
      -
      BufferProxy(parent) -> BufferProxy
      +
      BufferProxy(<parent>) -> BufferProxy
      @@ -185,10 +175,10 @@ parent.

      The BufferProxy class supports subclassing, instance variables, and weak references.

      -
      +

      New in pygame 1.8.0.

      -
      +

      Extended in pygame 1.9.2.

      @@ -197,7 +187,7 @@ references.

      Return wrapped exporting object.
      parent -> Surface
      -
      parent -> parent
      +
      parent -> <parent>

      The Surface which returned the BufferProxy object or the object passed to a BufferProxy call.

      @@ -250,7 +240,7 @@ If len(buffer)

      -Edit on GitHub +Edit on GitHub
      @@ -269,14 +259,16 @@ If len(buffer)next |
    • - previous |
    • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/camera.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/camera.html index df50201..d829f50 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/camera.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/camera.html @@ -5,18 +5,16 @@ - pygame.camera — pygame-ce v2.5.8 documentation - - - - - + pygame.camera — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
      @@ -138,17 +128,18 @@
      +
      +

      Note

      +

      Use import pygame.camera before using this module.

      +

      Pygame currently supports Linux (V4L2) and Windows (MSMF) cameras natively, with wider platform support available via an integrated OpenCV backend.

      -
      +

      New in pygame 2.0.2: Windows native camera support

      -
      +

      New in pygame 2.0.3: New OpenCV backends

      -
      -

      Changed in pygame-ce 2.3.0: Removed deprecated vidcapture backend

      -

      EXPERIMENTAL!: This API may change or disappear in later pygame releases. If you use this, your code will very likely break with the next pygame release.

      The Bayer to RGB function is based on:

      @@ -175,9 +166,7 @@ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
      -
      -

      New in pygame 1.9.0.

      -
      +

      New in pygame 1.9.0.

      pygame.camera.init()
      @@ -191,7 +180,7 @@ attempt to import third party modules, like OpenCV. If you want to override its backend choice, you can call pass the name of the backend you want into this function. More about backends in get_backends().

      -
      +

      Changed in pygame 2.0.3: Option to explicitly select backend

      @@ -212,19 +201,21 @@ _camera (MSMF) Windows Builtin, works on Windows 8+ Python3 _camera (V4L2) Linux Builtin OpenCV Any Uses `opencv-python` module, can't enumerate cameras OpenCV-Mac Mac Same as OpenCV, but has camera enumeration +VideoCapture Windows Uses abandoned `VideoCapture` module, can't enumerate + cameras, may be removed in the future

      There are two main differences among backends.

      The _camera backends are built in to pygame itself, and require no third -party imports. All the other backends do. For the OpenCV backend, -the module will need to be installed on your system.

      +party imports. All the other backends do. For the OpenCV and VideoCapture +backends, those modules need to be installed on your system.

      The other big difference is "camera enumeration." Some backends don't have a way to list out camera names, or even the number of cameras on the system. In these cases, list_cameras() will return something like [0]. If you know you have multiple cameras on the system, these backend ports will pass through a "camera index number" through if you use that as the device parameter.

      -
      +

      New in pygame 2.0.3.

      @@ -234,7 +225,7 @@ through if you use that as the pygame.camera.colorspace()
      Surface colorspace conversion
      -
      colorspace(surface, format, dest_surface = None, /) -> Surface
      +
      colorspace(Surface, format, DestSurface = None) -> Surface

      Allows for conversion from "RGB" to a destination colorspace of "HSV" or "YUV". The source and destination surfaces must be the same size and pixel @@ -408,7 +399,7 @@ the game from that of the camera without having to use threading.

      get_image()
      captures an image as a Surface
      -
      get_image(Surface = None, /) -> Surface
      +
      get_image(Surface = None) -> Surface

      Pulls an image off of the buffer as an RGB Surface. It can optionally reuse an existing Surface to save time. The bit-depth of the surface is @@ -437,7 +428,7 @@ bytes object




      -Edit on GitHub +Edit on GitHub
      @@ -453,17 +444,19 @@ bytes object

      modules |
    • - next |
    • previous |
    • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color.html index 1997d75..2f4dc2d 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color.html @@ -5,19 +5,17 @@ - pygame.Color — pygame-ce v2.5.8 documentation - - - - - + pygame.Color — pygame v2.6.1 documentation + + + + - - +
      @@ -25,30 +23,24 @@
      @@ -107,9 +97,10 @@
      pygame.Color
      -
      Pygame object for color representations.
      +
      pygame object for color representations
      +
      Color(r, g, b) -> Color
      Color(r, g, b, a=255) -> Color
      -
      Color(rgbvalue) -> Color
      +
      Color(color_value) -> Color
      @@ -153,46 +144,6 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -211,22 +162,22 @@ - + - + - + - +
      — Gets or sets the I1I2I3 representation of the Color.
      -—Gets or sets the normalized representation of the Color.
      -—Gets or sets the stringified hexadecimal representation of the Color.
      -—Returns a Color object from a CMY representation.
      -—Returns a Color object from an HSVA representation.
      -—Returns a Color object from an HSLA representation.
      -—Returns a Color object from a I1I2I3 representation.
      -—Returns a Color object from a Normalized representation.
      -—Returns a Color object from a Hexadecimal representation.
      —
      —Returns the grayscale of a Color.returns the grayscale of a Color
      —Returns a linear interpolation to the given Color.returns a linear interpolation to the given Color.
      —Returns a Color where the r,g,b components have been multiplied by the alpha.returns a Color where the r,g,b components have been multiplied by the alpha.
      —Sets the elements of the color.Sets the elements of the color
      @@ -239,12 +190,6 @@ Alpha defaults to 255 (fully opaque) when not given. The arithmetic operations and correct_gamma() method preserve subclasses. For the binary operators, the class of the returned color is that of the left hand color object of the operator.

      -

      Color objects support swizzling for their RGBA attributes, which allows -the creation of new color objects with the corresponding swizzled attributes -as its RGBA attributes. For example, color.bgra provides a shortcut to -doing Color(color.b, color.g, color.r, color.a). Swizzling with other than -4 attributes will return a tuple consisting of the corresponding elements -instead of a color object.

      Color objects support equality comparison with other color objects and 3 or 4 element tuples of integers. There was a bug in pygame 1.8.1 where the default alpha was 0, not 255 like previously.

      @@ -262,8 +207,8 @@ in the right hand color is 0, then the result is 0. For example:

      Use int(color) to return the immutable integer value of the color, usable as a dict key. This integer value differs from the mapped -pixel values of pygame.Surface.get_at_mapped()Get the mapped color value at a single pixel., -pygame.Surface.map_rgb()Convert a color into a mapped color value. and pygame.Surface.unmap_rgb()Convert a mapped integer color value into a Color.. +pixel values of pygame.Surface.get_at_mapped()get the mapped color value at a single pixel, +pygame.Surface.map_rgb()convert a color into a mapped color value and pygame.Surface.unmap_rgb()convert a mapped integer color value into a Color. It can be passed as a color_value argument to Color (useful with sets).

      See Named Colors for samples of the available named colors.

      @@ -279,40 +224,32 @@ default is 255

      list(int, int, int, [int])) --

      color value (see note below for the supported formats)

      Note

      -

      Supported color_value formats:

      -
      +
      +
      Supported color_value formats:
      - Color object: clones the given Color object
      -
      -
      - Color name: str: name of the color to use, e.g. 'red' (all the supported name strings can be found in the -Named Colors, with sample swatches)
      -
      -
      + Named Colors, with sample swatches)
      - HTML color format str: '#rrggbbaa' or '#rrggbb', where rr, gg, bb, and aa are 2-digit hex numbers in the range of 0 to 0xFF inclusive, the aa (alpha) value defaults to 0xFF if not provided
      -
      -
      - hex number str: '0xrrggbbaa' or '0xrrggbb', where rr, gg, bb, and aa are 2-digit hex numbers in the range of 0x00 to 0xFF inclusive, the aa (alpha) value defaults to 0xFF if not provided
      -
      -
      - int: int value of the color to use, using hex numbers can make this parameter more readable, e.g. 0xrrggbbaa, where rr, gg, bb, and aa are 2-digit hex numbers in the range of 0x00 to 0xFF inclusive, note that the aa (alpha) value is not optional for the int format and must be provided
      -
      -
      - tuple/list of int color values: (R, G, B, A) or (R, G, B), where R, G, B, and A are int values in the range of 0 to 255 inclusive, the A (alpha) value defaults to 255 if not provided
      + +

      @@ -325,27 +262,21 @@ provided
      -

      Changed in pygame-ce 2.5.6: bytes(Color(...)) (assuming bytes is -the built-in type) now returns a bytes object (of length 4) with the RGBA values of the color, -as opposed to Color being interpreted as an integer (think int(Color(...))) causing it -to return a bytes object filled with 0s the length of said integer.

      -
      -

      Changed in pygame 2.0.0: Support for tuples, lists, and Color objects when creating Color objects.

      -
      +

      Changed in pygame 1.9.2: Color objects export the C level array interface.

      -
      +

      Changed in pygame 1.9.0: Color objects support 4-element tuples of integers.

      -
      +

      Changed in pygame 1.8.1: New implementation of the class.

      -r: int
      +r
      Gets or sets the red value of the Color.
      r -> int
      @@ -355,7 +286,7 @@ to return a bytes
      -g: int
      +g
      Gets or sets the green value of the Color.
      g -> int
      @@ -365,7 +296,7 @@ to return a bytes
      -b: int
      +b
      Gets or sets the blue value of the Color.
      b -> int
      @@ -375,7 +306,7 @@ to return a bytes
      -a: int
      +a
      Gets or sets the alpha value of the Color.
      a -> int
      @@ -385,10 +316,10 @@ to return a bytes
      -cmy: tuple[float, float, float]
      +cmy
      Gets or sets the CMY representation of the Color.
      -
      cmy -> tuple[float, float, float]
      +
      cmy -> tuple

      The CMY representation of the Color. The CMY components are in the ranges C = [0, 1], M = [0, 1], Y = [0, 1]. Note that this @@ -400,10 +331,10 @@ differ slightly from what you might expect.

      -hsva: tuple[float, float, float, float]
      +hsva
      Gets or sets the HSVA representation of the Color.
      -
      hsva -> tuple[float, float, float, float]
      +
      hsva -> tuple

      The HSVA representation of the Color. The HSVA components are in the ranges H = [0, 360], S = [0, 100], V = [0, 100], A = [0, @@ -415,10 +346,10 @@ cause the HSV

      -hsla: tuple[float, float, float, float]
      +hsla
      Gets or sets the HSLA representation of the Color.
      -
      hsla -> tuple[float, float, float, float]
      +
      hsla -> tuple

      The HSLA representation of the Color. The HSLA components are in the ranges H = [0, 360], S = [0, 100], L = [0, 100], A = [0, @@ -430,10 +361,10 @@ cause the HSL

      -i1i2i3: tuple[float, float, float]
      +i1i2i3
      Gets or sets the I1I2I3 representation of the Color.
      -
      i1i2i3 -> tuple[float, float, float]
      +
      i1i2i3 -> tuple

      The I1I2I3 representation of the Color. The I1I2I3 components are in the ranges I1 = [0, 1], I2 = [-0.5, 0.5], I3 = [-0.5, @@ -444,139 +375,12 @@ may cause the I1I2I expect.

      -
      -
      -normalized: tuple[float, float, float, float]
      -
      -
      Gets or sets the normalized representation of the Color.
      -
      normalized -> tuple[float, float, float, float]
      -
      -

      The Normalized representation of the Color. The components of the Normalized -representation represent the basic RGBA values but normalized the -ranges of the values are r = [0, 1], g = [0, 1], b = [0, 1] -and a = [0, 1] respectively. Note that this will not return the absolutely exact -Normalized values for the set RGBA values in all cases. -Due to the RGB mapping from 0-255 and the Normalized mapping from 0-1 -rounding errors may cause the Normalized values to differ -slightly from what you might expect.

      -
      -

      New in pygame-ce 2.5.0.

      -
      -
      - -
      -
      -hex: str
      -
      -
      Gets or sets the stringified hexadecimal representation of the Color.
      -
      hex -> str
      -
      -

      The stringified hexadecimal representation of the Color. The hexadecimal string -is formatted as "#rrggbbaa" where rr, gg, bb, and aa are two digit hex numbers -in the range from 0x00 to 0xff.

      -

      Setting this property means changing the color channels in place. Both lowercase -and uppercase letters are allowed, the alpha can be omitted (defaults to 0xff) and -the string can start with either # or 0x.

      -
      -

      New in pygame-ce 2.5.4.

      -
      -
      - -
      -
      -classmethod from_cmy()
      -
      -
      Returns a Color object from a CMY representation.
      -
      from_cmy(object, /) -> Color
      -
      from_cmy(c, m, y, /) -> Color
      -
      -

      Creates a Color object from the given CMY components. Refer to Color.cmy -for more information.

      -
      -

      New in pygame-ce 2.3.1.

      -
      -
      - -
      -
      -classmethod from_hsva()
      -
      -
      Returns a Color object from an HSVA representation.
      -
      from_hsva(object, /) -> Color
      -
      from_hsva(h, s, v, a, /) -> Color
      -
      -

      Creates a Color object from the given HSVA components. Refer to Color.hsva -for more information.

      -
      -

      New in pygame-ce 2.3.1.

      -
      -
      - -
      -
      -classmethod from_hsla()
      -
      -
      Returns a Color object from an HSLA representation.
      -
      from_hsla(object, /) -> Color
      -
      from_hsla(h, s, l, a, /) -> Color
      -
      -

      Creates a Color object from the given HSLA components. Refer to Color.hsla -for more information.

      -
      -

      New in pygame-ce 2.3.1.

      -
      -
      - -
      -
      -classmethod from_i1i2i3()
      -
      -
      Returns a Color object from a I1I2I3 representation.
      -
      from_i1i2i3(object, /) -> Color
      -
      from_i1i2i3(i1, i2, i3, /) -> Color
      -
      -

      Creates a Color object from the given I1I2I3 components. Refer to Color.i1i2i3 -for more information.

      -
      -

      New in pygame-ce 2.3.1.

      -
      -
      - -
      -
      -classmethod from_normalized()
      -
      -
      Returns a Color object from a Normalized representation.
      -
      from_normalized(object, /) -> Color
      -
      from_normalized(r, g, b, a, /) -> Color
      -
      -

      Creates a Color object from the given Normalized components. Refer to Color.normalized -for more information.

      -
      -

      New in pygame-ce 2.5.0.

      -
      -
      - -
      -
      -classmethod from_hex()
      -
      -
      Returns a Color object from a Hexadecimal representation.
      -
      from_hex(hex, /) -> Color
      -
      -

      Creates a Color object from the given Hexadecimal components. Refer to Color.hex -for more information.

      -
      -

      New in pygame-ce 2.5.6.

      -
      -
      -
      normalize()
      Returns the normalized RGBA values of the Color.
      -
      normalize() -> tuple[float, float, float, float]
      +
      normalize() -> tuple

      Returns the normalized RGBA values of the Color as floating point values.

      @@ -587,7 +391,7 @@ values.

      correct_gamma()
      Applies a certain gamma value to the Color.
      -
      correct_gamma(gamma, /) -> Color
      +
      correct_gamma (gamma) -> Color

      Applies a certain gamma value to the Color and returns a new Color with the adjusted RGBA values.

      @@ -598,7 +402,7 @@ the adjusted RGBAset_length()
      Set the number of elements in the Color to 1,2,3, or 4.
      -
      set_length(length, /) -> None
      +
      set_length(len) -> None

      DEPRECATED: You may unpack the values you need like so, r, g, b, _ = pygame.Color(100, 100, 100) @@ -610,9 +414,9 @@ if you only want r and g

      is useful if you want to unpack to r,g,b and not r,g,b,a. If you want to get the length of a Color do len(acolor).

      -

      Deprecated since pygame-ce 2.1.3.

      +

      Deprecated since pygame 2.1.3.

      -
      +

      New in pygame 1.9.0.

      @@ -621,29 +425,25 @@ get the length of a Color do grayscale()
      -
      Returns the grayscale of a Color.
      +
      returns the grayscale of a Color
      grayscale() -> Color
      -

      Returns a new Color object which represents the grayscaled version of self, using the luminosity formula, -which weights red, green, and blue according to their relative contribution to perceived brightness.

      -
      -

      New in pygame-ce 2.1.4.

      -
      +

      Returns a Color which represents the grayscaled version of self using the luminosity formula which weights red, green and blue according to their wavelengths..

      lerp()
      -
      Returns a linear interpolation to the given Color.
      -
      lerp(color, amount) -> Color
      +
      returns a linear interpolation to the given Color.
      +
      lerp(Color, float) -> Color

      Returns a Color which is a linear interpolation between self and the given Color in RGBA space. The second parameter determines how far between self and other the result is going to be. It must be a value between 0 and 1 where 0 means self and 1 means other will be returned.

      -
      +

      New in pygame 2.0.1.

      @@ -652,16 +452,16 @@ other will be returned.

      premul_alpha()
      -
      Returns a Color where the r,g,b components have been multiplied by the alpha.
      +
      returns a Color where the r,g,b components have been multiplied by the alpha.
      premul_alpha() -> Color
      -

      Returns a new Color where each of the red, green and blue color +

      Returns a new Color where each of the red, green and blue colour channels have been multiplied by the alpha channel of the original color. The alpha channel remains unchanged.

      This is useful when working with the BLEND_PREMULTIPLIED blending mode -flag for pygame.Surface.blit()Draw another Surface onto this one., which assumes that all surfaces using +flag for pygame.Surface.blit()draw one image onto another, which assumes that all surfaces using it are using pre-multiplied alpha colors.

      -
      +

      New in pygame 2.0.0.

      @@ -670,13 +470,14 @@ it are using pre-multiplied alpha colors.

      update()
      -
      Sets the elements of the color.
      -
      update(r, g, b, a=255, /) -> None
      -
      update(rgbvalue, /) -> None
      +
      Sets the elements of the color
      +
      update(r, g, b) -> None
      +
      update(r, g, b, a=255) -> None
      +
      update(color_value) -> None
      -

      Sets the elements of the color. See parameters for pygame.Color()Pygame object for color representations. for the +

      Sets the elements of the color. See parameters for pygame.Color()pygame object for color representations for the parameters of this function. If the alpha value was not set it will not change.

      -
      +

      New in pygame 2.0.1.

      @@ -688,7 +489,7 @@ parameters of this function. If the alpha value was not set it will not change.<


      -Edit on GitHub +Edit on GitHub
      @@ -707,14 +508,16 @@ parameters of this function. If the alpha value was not set it will not change.< next |
    • - previous |
    • - - + + + +
      \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color_list.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color_list.html index 4cbb789..e00c9be 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color_list.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/color_list.html @@ -5,14 +5,12 @@ - Named Colors — pygame-ce v2.5.8 documentation - - - - - + Named Colors — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
      @@ -769,9 +759,9 @@ .yellow3 {background-color: #cdcd00; color: #cdcd00;} .yellow4 {background-color: #8b8b00; color: #8b8b00;} .yellowgreen {background-color: #9acd32; color: #9acd32;} -

      pygame.ColorPygame object for color representations. lets you specify any of these named colors when creating a new +

      pygame.Colorpygame object for color representations lets you specify any of these named colors when creating a new pygame.Color (taken from the -colordict module).

      +colordict module).

      @@ -2781,7 +2771,7 @@


      -Edit on GitHub +Edit on GitHub
      @@ -2802,12 +2792,14 @@
    • previous |
    • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/cursors.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/cursors.html index 0f8dc4e..32ae44d 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/cursors.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/cursors.html @@ -5,14 +5,12 @@ - pygame.cursors — pygame-ce v2.5.8 documentation - - - - - + pygame.cursors — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
      @@ -107,34 +97,34 @@
      pygame.cursors
      -
      Pygame module for cursor resources.
      +
      pygame module for cursor resources

      Name

      - + - + - +
      —Create binary cursor data from simple strings.create binary cursor data from simple strings
      —Load cursor data from an XBM file.load cursor data from an XBM file
      —Pygame object representing a cursor.pygame object representing a cursor

      Pygame offers control over the system hardware cursor. Pygame supports black and white cursors (bitmap cursors), as well as system variant cursors and color cursors. -You control the cursor with functions inside pygame.mousePygame module to work with the mouse..

      +You control the cursor with functions inside pygame.mousepygame module to work with the mouse.

      This cursors module contains functions for loading and decoding various cursor formats. These allow you to easily store your cursors in external files or directly as encoded python strings.

      -

      The module includes several standard cursors. The pygame.mouse.set_cursor()Set the mouse cursor to a new cursor. +

      The module includes several standard cursors. The pygame.mouse.set_cursor()set the mouse cursor to a new cursor function takes several arguments. All those arguments have been stored in a single tuple you can call like this:

      >>> pygame.mouse.set_cursor(*pygame.cursors.arrow)
      @@ -148,7 +138,6 @@ single tuple you can call like this:

    • pygame.cursors.broken_x

    • pygame.cursors.tri_left

    • pygame.cursors.tri_right

    • -
    • pygame.cursors.ball

    • This module also contains a few cursors as formatted strings. You'll need to @@ -166,20 +155,20 @@ The example call would look like this:

    • pygame.cursors.sizer_x_strings

    • pygame.cursors.sizer_y_strings

    • pygame.cursors.sizer_xy_strings

    • -
    • pygame.cursors.textmarker_strings

    • +
    • pygame.cursor.textmarker_strings

    • pygame.cursors.compile()
      -
      Create binary cursor data from simple strings.
      -
      compile(strings, black='X', white='.', xor='o') -> tuple
      +
      create binary cursor data from simple strings
      +
      compile(strings, black='X', white='.', xor='o') -> data, mask

      A sequence of strings can be used to create binary cursor data for the system cursor. This returns the binary data in the form of two tuples. Those can be passed as the third and fourth arguments respectively of the -pygame.mouse.set_cursor()Set the mouse cursor to a new cursor. function.

      +pygame.mouse.set_cursor()set the mouse cursor to a new cursor function.

      If you are creating your own cursor strings, you can use any value represent the black and white pixels. Some system allow you to set a special toggle color for the system color, this is also called the xor color. If the system @@ -221,8 +210,9 @@ An example set of cursor strings looks like this

      pygame.cursors.load_xbm()
      -
      Load cursor data from an XBM file.
      -
      load_xbm(curs, mask) -> tuple
      +
      load cursor data from an XBM file
      +
      load_xbm(cursorfile) -> cursor_args
      +
      load_xbm(cursorfile, maskfile) -> cursor_args

      This loads cursors for a simple subset of XBM files. XBM files are traditionally used to store cursors on UNIX systems, they are an ASCII @@ -230,7 +220,7 @@ format used to represent simple images.

      Sometimes the black and white color values will be split into two separate XBM files. You can pass a second maskfile argument to load the two images into a single cursor.

      -

      The curs and mask arguments can either be filenames or file-like +

      The cursorfile and maskfile arguments can either be filenames or file-like object with the readlines method.

      The return value cursor_args can be passed directly to the pygame.mouse.set_cursor() function.

      @@ -240,28 +230,29 @@ object with the readlines method.

      pygame.cursors.Cursor
      -
      Pygame object representing a cursor.
      -
      Cursor(constant=...) -> Cursor
      -
      Cursor(cursor) -> Cursor
      +
      pygame object representing a cursor
      Cursor(size, hotspot, xormasks, andmasks) -> Cursor
      Cursor(hotspot, surface) -> Cursor
      +
      Cursor(constant) -> Cursor
      +
      Cursor(Cursor) -> Cursor
      +
      Cursor() -> Cursor
      - + - + - +
      —Copy the current cursor.copy the current cursor
      —Get the cursor type.Gets the cursor type
      —Get the cursor data.Gets the cursor data
      @@ -274,7 +265,7 @@ Finally you can create a color cursor, which displays a pygame

      Creating a system cursor

      Choose a constant from this list, pass it into pygame.cursors.Cursor(constant), and you're good to go. Be advised that not all systems support every system -cursor, and you may get a substitution instead. For example, on macOS, +cursor, and you may get a substitution instead. For example, on MacOS, WAIT/WAITARROW should show up as an arrow, and SIZENWSE/SIZENESW/SIZEALL should show up as a closed hand. And on Wayland, every SIZE cursor should show up as a hand.

      @@ -301,14 +292,13 @@ show up as a hand.

      Creating a cursor without passing arguments

      -

      In addition to the cursor constants available and described above, you can -also call pygame.cursors.Cursor(), and your cursor is ready (doing that -is the same as calling pygame.cursors.Cursor(pygame.SYSTEM_CURSOR_ARROW). -Doing one of those calls actually creates a system cursor using the default -native image.

      +

      In addition to the cursor constants available and described above, +you can also call pygame.cursors.Cursor(), and your cursor is ready (doing that is the same as +calling pygame.cursors.Cursor(pygame.SYSTEM_CURSOR_ARROW). +Doing one of those calls actually creates a system cursor using the default native image.

      Creating a color cursor

      To create a color cursor, create a Cursor from a hotspot and a surface. -hotspot are (x,y) coordinates that determine where in the cursor the exact point is. +hotspot is an (x,y) coordinate that determines where in the cursor the exact point is. The hotspot position must be within the bounds of the surface.

      Creating a bitmap cursor

      When the mouse cursor is visible, it will be displayed as a black and white @@ -322,17 +312,14 @@ is at.

      xormasks is a sequence of bytes containing the cursor xor data masks. Lastly andmasks, a sequence of bytes containing the cursor bitmask data. To create these variables, we can make use of the -pygame.cursors.compile()Create binary cursor data from simple strings. function.

      +pygame.cursors.compile()create binary cursor data from simple strings function.

      Width and height must be a multiple of 8, and the mask arrays must be the correct size for the given width and height. Otherwise an exception is raised.

      -
      -

      New in pygame 2.0.1.

      -
      copy()
      -
      Copy the current cursor.
      +
      copy the current cursor
      copy() -> Cursor

      Returns a new Cursor object with the same data and hotspot as the original.

      @@ -340,71 +327,74 @@ correct size for the given width and height. Otherwise an exception is raised.
      -type: Literal['system', 'color', 'bitmap']
      +type
      -
      Get the cursor type.
      -
      type -> Literal['system', 'color', 'bitmap']
      +
      Gets the cursor type
      +
      type -> string

      The type will be "system", "bitmap", or "color".

      -data: tuple[int] | tuple[tuple[int, int], tuple[int, int], tuple[int, Ellipsis], tuple[int, Ellipsis]] | tuple[pygame.typing.IntPoint, pygame.surface.Surface]
      +data
      -
      Get the cursor data.
      -
      data -> ...
      +
      Gets the cursor data
      +
      data -> tuple

      Returns the data that was used to create this cursor object, wrapped up in a tuple.

      +
      +

      New in pygame 2.0.1.

      +

      Example code for creating and settings cursors. (Click the mouse to switch cursor)

      # pygame setup
      -import pygame
      +import pygame as pg
       
      -pygame.init()
      -screen = pygame.display.set_mode([600, 400])
      -pygame.display.set_caption("Example code for the cursors module")
      +pg.init()
      +screen = pg.display.set_mode([600, 400])
      +pg.display.set_caption("Example code for the cursors module")
       
       # create a system cursor
      -system = pygame.cursors.Cursor(pygame.SYSTEM_CURSOR_NO)
      +system = pg.cursors.Cursor(pg.SYSTEM_CURSOR_NO)
       
       # create bitmap cursors
      -bitmap_1 = pygame.cursors.Cursor(*pygame.cursors.arrow)
      -bitmap_2 = pygame.cursors.Cursor(
      -    (24, 24), (0, 0), *pygame.cursors.compile(pygame.cursors.thickarrow_strings)
      +bitmap_1 = pg.cursors.Cursor(*pg.cursors.arrow)
      +bitmap_2 = pg.cursors.Cursor(
      +    (24, 24), (0, 0), *pg.cursors.compile(pg.cursors.thickarrow_strings)
       )
       
       # create a color cursor
      -surf = pygame.Surface((40, 40)) # you could also load an image
      +surf = pg.Surface((40, 40)) # you could also load an image
       surf.fill((120, 50, 50))        # and use that as your surface
      -color = pygame.cursors.Cursor((20, 20), surf)
      +color = pg.cursors.Cursor((20, 20), surf)
       
       cursors = [system, bitmap_1, bitmap_2, color]
       cursor_index = 0
       
      -pygame.mouse.set_cursor(cursors[cursor_index])
      +pg.mouse.set_cursor(cursors[cursor_index])
       
      -clock = pygame.time.Clock()
      +clock = pg.time.Clock()
       going = True
       while going:
           clock.tick(60)
           screen.fill((0, 75, 30))
      -    pygame.display.flip()
      +    pg.display.flip()
       
      -    for event in pygame.event.get():
      -        if event.type == pygame.QUIT or (event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE):
      +    for event in pg.event.get():
      +        if event.type == pg.QUIT or (event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE):
                   going = False
       
               # if the mouse is clicked it will switch to a new cursor
      -        if event.type == pygame.MOUSEBUTTONDOWN:
      +        if event.type == pg.MOUSEBUTTONDOWN:
                   cursor_index += 1
                   cursor_index %= len(cursors)
      -            pygame.mouse.set_cursor(cursors[cursor_index])
      +            pg.mouse.set_cursor(cursors[cursor_index])
       
      -pygame.quit()
      +pg.quit()
       
      @@ -414,7 +404,7 @@ correct size for the given width and height. Otherwise an exception is raised.

      -Edit on GitHub +Edit on GitHub
      @@ -435,12 +425,14 @@ correct size for the given width and height. Otherwise an exception is raised. previous | - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/display.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/display.html index 52155db..111166b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/display.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/display.html @@ -5,14 +5,12 @@ - pygame.display — pygame-ce v2.5.8 documentation - - - - - + pygame.display — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
      @@ -107,149 +97,139 @@
      pygame.display
      -
      Pygame module to control the display window and screen.
      +
      pygame module to control the display window and screen
      - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - - - - - - - - + @@ -259,32 +239,7 @@ - - - - - - - - - - - - - - - - - - - - - +
      —Initialize the display module.Initialize the display module
      —Uninitialize the display module.Uninitialize the display module
      —Returns True if the display module has been initialized.Returns True if the display module has been initialized
      —Initialize a window or screen for display.Initialize a window or screen for display
      —Get a reference to the currently set display surface.Get a reference to the currently set display surface
      —Update the full display Surface to the screen.Update the full display Surface to the screen
      —Update all, or a portion, of the display. For non-OpenGL displays.Update portions of the screen for software displays
      —Get the name of the pygame display backend.Get the name of the pygame display backend
      —Create a video display information object.Create a video display information object
      —Get information about the current windowing system.Get information about the current windowing system
      —Get sizes of active desktops.Get sizes of active desktops
      —Get list of available fullscreen modes.Get list of available fullscreen modes
      —Pick the best color depth for a display mode.Pick the best color depth for a display mode
      —Get the value for an OpenGL flag for the current display.Get the value for an OpenGL flag for the current display
      —Request an OpenGL display attribute for the display mode.Request an OpenGL display attribute for the display mode
      —Returns True when the display is active on the screen.Returns True when the display is active on the screen
      —Iconify the display surface.Iconify the display surface
      —Switch between fullscreen and windowed displays.Switch between fullscreen and windowed displays
      —Change the hardware gamma ramps.Change the hardware gamma ramps
      —Change the hardware gamma ramps with a custom lookup.Change the hardware gamma ramps with a custom lookup
      —Change the system image for the display window.Change the system image for the display window
      —Set the current window caption.Set the current window caption
      —Get the current window caption.Get the current window caption
      —Set the display color palette for indexed displays.Set the display color palette for indexed displays
      —Return the number of displays.Return the number of displays
      —Return the size of the window or screen.
      -—Return the position of the window or screen.
      -—Set the current window position.Return the size of the window or screen
      —Set whether the screensaver may run.
      -—Returns True if the pygame window created by pygame.display.set_mode() is in full-screen mode.
      -—Returns True if vertical synchronisation for pygame.display.flip() and pygame.display.update() is enabled.
      -—Returns the screen refresh rate or 0 if unknown.
      -—Returns the screen refresh rates for all displays (in windowed mode).
      -—Create a native GUI message box.Set whether the screensaver may run
      @@ -316,12 +271,11 @@ automatically switch to operate on the new display.

      When the display mode is set, several events are placed on the pygame event queue. pygame.QUIT is sent when the user has requested the program to shut down. The window will receive pygame.ACTIVEEVENT events as the display -gains and loses input focus. If the display is set to be resizable with the -pygame.RESIZABLE flag, pygame.VIDEORESIZE event(s) will be sent when the -user adjusts the window dimensions. Depending on your platform, this may be -multiple gradual events or one event at the end (Windows). Hardware displays -that draw direct to the screen will get pygame.VIDEOEXPOSE events when -portions of the window must be redrawn.

      +gains and loses input focus. If the display is set with the +pygame.RESIZABLE flag, pygame.VIDEORESIZE events will be sent when the +user adjusts the window dimensions. Hardware displays that draw direct to the +screen will get pygame.VIDEOEXPOSE events when portions of the window must +be redrawn.

      A new windowevent API was introduced in pygame 2.0.1. Check event module docs for more information on that

      Some display environments have an option for automatically stretching all @@ -334,7 +288,7 @@ required).

      pygame.display.init()
      -
      Initialize the display module.
      +
      Initialize the display module
      init() -> None

      Initializes the pygame display module. The display module cannot do anything @@ -346,33 +300,22 @@ permissions of current user. Before the display module is initialized the environment variable SDL_VIDEODRIVER can be set to control which backend is used. The systems with multiple choices are listed here.

      Windows : windib, directx
      -Unix    : x11, dga, fbcon, directfb, ggi, vgl, svgalib, aalib, wayland
      +Unix    : x11, dga, fbcon, directfb, ggi, vgl, svgalib, aalib
       
      -
      -
      Note:
      -

      On wayland desktops, pygame-ce may choose to use the X11 video driver to run on Xwayland. -This behaviour is determined by the SDL library and might change in the future, so it's suggested -to account for this and not rely on the default behavior. The Wayland video driver can be forced -by setting the SDL_VIDEODRIVER environment variable to "wayland"

      -
      -

      On some platforms it is possible to embed the pygame display into an already existing window. To do this, the environment variable SDL_WINDOWID must be set to a string containing the window id or handle. The environment variable is checked when the pygame display is initialized. Be aware that there can be many strange side effects when running in an embedded display.

      It is harmless to call this more than once, repeated calls have no effect.

      -
      -

      Changed in pygame-ce 2.5.0: the manylinux wheels distributed by us now support the wayland videodriver

      -
      pygame.display.quit()
      -
      Uninitialize the display module.
      +
      Uninitialize the display module
      quit() -> None

      This will shut down the entire display module. This means any active @@ -385,22 +328,22 @@ program exits.

      pygame.display.get_init()
      -
      Returns True if the display module has been initialized.
      +
      Returns True if the display module has been initialized
      get_init() -> bool
      -

      Returns True if the pygame.displayPygame module to control the display window and screen. module is currently initialized.

      +

      Returns True if the pygame.displaypygame module to control the display window and screen module is currently initialized.

      pygame.display.set_mode()
      -
      Initialize a window or screen for display.
      +
      Initialize a window or screen for display
      set_mode(size=(0, 0), flags=0, depth=0, display=0, vsync=0) -> Surface
      -

      This will create a window or display output and return a display Surface. -The arguments passed in are requests for a display type. The actual created -display will be the best possible match supported by the system.

      +

      This function will create a display Surface. The arguments passed in are +requests for a display type. The actual created display will be the best +possible match supported by the system.

      Note that calling this function implicitly initializes pygame.display, if it was not initialized before.

      The size argument is a pair of numbers representing the width and @@ -408,13 +351,15 @@ height. The flags argument is a collection of additional options. The depth argument represents the number of bits to use for color.

      The Surface that gets returned can be drawn to like a regular Surface but changes will eventually be seen on the monitor.

      -

      If no size is passed or is set to (0, 0), the created Surface will have -the same size as the current screen resolution. If only the width or height -are set to 0, the Surface will have the same width or height as the -screen resolution.

      -

      Since pygame 2, the depth argument is ignored, in favour of the best -and fastest one. It also raises a deprecation warning since pygame-ce -2.4.0 if the passed in depth is not 0 or the one pygame selects.

      +

      If no size is passed or is set to (0, 0) and pygame uses SDL +version 1.2.10 or above, the created Surface will have the same size as the +current screen resolution. If only the width or height are set to 0, the +Surface will have the same width or height as the screen resolution. Using a +SDL version prior to 1.2.10 will raise an exception.

      +

      It is usually best to not pass the depth argument. It will default to the +best and fastest color depth for the system. If your game requires a +specific color format you can control the depth with this argument. Pygame +will emulate an unavailable color depth which can be slow.

      When requesting fullscreen display modes, sometimes an exact match for the requested size cannot be made. In these situations pygame will select the closest compatible match. The returned surface will still always match @@ -433,62 +378,30 @@ flags you will want to choose from:

      pygame.DOUBLEBUF only applicable with OPENGL pygame.HWSURFACE (obsolete in pygame 2) hardware accelerated, only in FULLSCREEN pygame.OPENGL create an OpenGL-renderable display -pygame.RESIZABLE display window should be sizeable +pygame.RESIZABLE display window should be resizeable pygame.NOFRAME display window will have no border or controls pygame.SCALED resolution depends on desktop size and scale graphics pygame.SHOWN window is opened in visible mode (default) pygame.HIDDEN window is opened in hidden mode
      -
      +

      New in pygame 2.0.0: SCALED, SHOWN and HIDDEN

      -
      -

      New in pygame 2.0.0: vsync parameter

      -

      By setting the vsync parameter to 1, it is possible to get a display -with vertical sync at a constant frame rate determined by the monitor and -graphics drivers. Subsequent calls to pygame.display.flip()Update the full display Surface to the screen. or -pygame.display.update()Update all, or a portion, of the display. For non-OpenGL displays. will block (i.e. wait) until the screen -has refreshed, in order to prevent "screen tearing" -<https://en.wikipedia.org/wiki/Screen_tearing>.

      -

      Be careful when using this feature together with pygame.time.Clock or -pygame.time.delay()Pause the program for an amount of time., as multiple forms of waiting and frame rate -limiting may interact to cause skipped frames.

      -

      The request only works when graphics acceleration is available on the -system. The exact behaviour depends on the hardware and driver -configuration. When vsync is requested, but unavailable, -set_mode() may raise an exception.

      -

      Setting the vsync parameter to -1 in conjunction with OPENGL -will request the OpenGL-specific feature "adaptive vsync" <https://www.khronos.org/opengl/wiki/Swap_Interval#Adaptive_Vsync>.

      -

      Here is an example usage of a call +with vertical sync, but you are not guaranteed to get one. The request only +works at all for calls to set_mode() with the pygame.OPENGL or +pygame.SCALED flags set, and is still not guaranteed even with one of +those set. What you get depends on the hardware and driver configuration +of the system pygame is running on. Here is an example usage of a call to set_mode() that may give you a display with vsync:

      flags = pygame.OPENGL | pygame.FULLSCREEN
      -try:
      -    window_surface = pygame.display.set_mode((1920, 1080), flags, vsync=1)
      -    vsync_success=True
      -except pygame.error:
      -    window_surface = pygame.display.set_mode((1920, 1080), flags)
      -    vsync_success=False
      +window_surface = pygame.display.set_mode((1920, 1080), flags, vsync=1)
       
      -
      -

      New in pygame 2.0.0: vsync parameter

      -
      -
      -

      Changed in pygame-ce 2.2.0: passing vsync can raise an exception

      -
      -
      -

      Changed in pygame-ce 2.2.0: explicit request for "adaptive vsync"

      -
      -
      -

      Changed in pygame-ce 2.2.0: vsync=1 does not require SCALED or OPENGL

      -
      -
      -

      Deprecated since pygame-ce 2.4.0: The depth argument is ignored, and will be set to the optimal value

      -
      -
      -

      Changed in pygame-ce 2.5.0: No longer emits warning when running on xwayland, see pygame.display.init()Initialize the display module. for details on running on wayland directly

      +

      Vsync behaviour is considered experimental, and may change in future releases.

      +
      +

      New in pygame 2.0.0: vsync

      Basic example:

      # Open a window on the screen
      @@ -500,11 +413,11 @@ to set_mode()The display index 0 means the default display is used. If no display
       index argument is provided, the default display can be overridden with an
       environment variable.

      -
      +

      Changed in pygame 1.9.5: display argument added

      -

      Changed in pygame-ce 2.1.3: pygame now ensures that subsequent calls to this function clears the +

      Changed in pygame 2.1.3: pygame now ensures that subsequent calls to this function clears the window to black. On older versions, this was an implementation detail on the major platforms this function was tested with.

      @@ -514,8 +427,8 @@ on the major platforms this function was tested with.

      pygame.display.get_surface()
      -
      Get a reference to the currently set display surface.
      -
      get_surface() -> Surface | None
      +
      Get a reference to the currently set display surface
      +
      get_surface() -> Surface

      Return a reference to the currently set display Surface. If no display mode has been set this will return None.

      @@ -525,10 +438,12 @@ has been set this will return None.

      pygame.display.flip()
      -
      Update the full display Surface to the screen.
      +
      Update the full display Surface to the screen
      flip() -> None
      -

      This will update the contents of the entire display.

      +

      This will update the contents of the entire display. If your display mode is +using the flags pygame.HWSURFACE and pygame.DOUBLEBUF on pygame 1, +this will wait for a vertical retrace and swap the surfaces.

      When using an pygame.OPENGL display mode this will perform a gl buffer swap.

      @@ -537,61 +452,45 @@ swap.

      pygame.display.update()
      -
      Update all, or a portion, of the display. For non-OpenGL displays.
      -
      update() -> None
      -
      update(rectangle, /) -> None
      -
      update(rectangles, /) -> None
      -
      update(x, y, w, h, /) -> None
      -
      update(xy, wh, /) -> None
      +
      Update portions of the screen for software displays
      +
      update(rectangle=None) -> None
      +
      update(rectangle_list) -> None
      -

      For non OpenGL display Surfaces, this function is very similar to -pygame.display.flip() with an optional parameter that allows only -portions of the display surface to be updated, instead of the entire area. -If no argument is passed it updates the entire Surface area like -pygame.display.flip().

      -
      -

      Note

      -

      calling display.update(None) means no part of the window is -updated. Whereas display.update() means the whole window is -updated.

      -
      -

      You can pass the function a single rectangle, or an iterable of rectangles. -Generally you do not want to pass an iterable of rectangles as there is a -performance cost per rectangle passed to the function. On modern hardware, -after a very small number of rectangles passed in, the per-rectangle cost -will exceed the saving of updating less pixels. In most applications it is -simply more efficient to update the entire display surface at once, it also -means you do not need to keep track of a list of rectangles for each call -to update.

      -

      If passing an iterable of rectangles it is safe to include None -values in the list, which will be skipped.

      +

      This function is like an optimized version of pygame.display.flip() for +software displays. It allows only a portion of the screen to be updated, +instead of the entire area. If no argument is passed it updates the entire +Surface area like pygame.display.flip().

      +

      Note that calling display.update(None) means no part of the window is +updated. Whereas display.update() means the whole window is updated.

      +

      You can pass the function a single rectangle, or a sequence of rectangles. +It is more efficient to pass many rectangles at once than to call update +multiple times with single or a partial list of rectangles. If passing a +sequence of rectangles it is safe to include None values in the list, which +will be skipped.

      This call cannot be used on pygame.OPENGL displays and will generate an exception.

      -
      -

      Changed in pygame-ce 2.5.1: Added support for passing an iterable, previously only sequence was allowed

      -
      pygame.display.get_driver()
      -
      Get the name of the pygame display backend.
      -
      get_driver() -> str
      +
      Get the name of the pygame display backend
      +
      get_driver() -> name

      Pygame chooses one of many available display backends when it is initialized. This returns the internal name used for the display backend. This can be used to provide limited information about what display capabilities might be accelerated. See the SDL_VIDEODRIVER flags in -pygame.display.init() to see some of the common options.

      +pygame.display.set_mode() to see some of the common options.

      pygame.display.Info()
      -
      Create a video display information object.
      -
      Info() -> _VidInfo
      +
      Create a video display information object
      +
      Info() -> VideoInfo

      Creates a simple object containing several attributes to describe the current graphics environment. If this is called before @@ -599,48 +498,42 @@ current graphics environment. If this is called before the default display mode. This can also be called after setting the display mode to verify specific display options were satisfied. The VidInfo object has several attributes:

      -
      hw:         1 if the display is hardware accelerated
      -wm:         1 if windowed display modes can be used
      -video_mem:  The megabytes of video memory on the display.
      -            This is 0 if unknown
      -bitsize:    Number of bits used to store each pixel
      -bytesize:   Number of bytes used to store each pixel
      -masks:      Four values used to pack RGBA values into pixels
      -shifts:     Four values used to pack RGBA values into pixels
      -losses:     Four values used to pack RGBA values into pixels
      -blit_hw:    1 if hardware Surface blitting is accelerated
      -blit_hw_CC: 1 if hardware Surface colorkey blitting is accelerated
      -blit_hw_A:  1 if hardware Surface pixel alpha blitting is
      -            accelerated
      -blit_sw:    1 if software Surface blitting is accelerated
      -blit_sw_CC: 1 if software Surface colorkey blitting is
      -            accelerated
      -blit_sw_A:  1 if software Surface pixel alpha blitting is
      -            accelerated
      -current_h, current_w:  Height and width of the current video
      -            mode, or of the desktop mode if called before
      -            the display.set_mode is called. They are -1 on error.
      -pixel_format: The pixel format of the display Surface as a string.
      -            E.g PIXELFORMAT_RGB888.
      +
      hw:         1 if the display is hardware accelerated
      +wm:         1 if windowed display modes can be used
      +video_mem:  The megabytes of video memory on the display. This is 0 if
      +            unknown
      +bitsize:    Number of bits used to store each pixel
      +bytesize:   Number of bytes used to store each pixel
      +masks:      Four values used to pack RGBA values into pixels
      +shifts:     Four values used to pack RGBA values into pixels
      +losses:     Four values used to pack RGBA values into pixels
      +blit_hw:    1 if hardware Surface blitting is accelerated
      +blit_hw_CC: 1 if hardware Surface colorkey blitting is accelerated
      +blit_hw_A:  1 if hardware Surface pixel alpha blitting is accelerated
      +blit_sw:    1 if software Surface blitting is accelerated
      +blit_sw_CC: 1 if software Surface colorkey blitting is accelerated
      +blit_sw_A:  1 if software Surface pixel alpha blitting is accelerated
      +current_h, current_w:  Height and width of the current video mode, or
      +            of the desktop mode if called before the display.set_mode
      +            is called. (current_h, current_w are available since
      +            SDL 1.2.10, and pygame 1.8.0). They are -1 on error, or if
      +            an old SDL is being used.
       
      -
      -

      Changed in pygame-ce 2.4.0: pixel_format attribute added.

      -
      pygame.display.get_wm_info()
      -
      Get information about the current windowing system.
      -
      get_wm_info() -> dict[str, int]
      +
      Get information about the current windowing system
      +
      get_wm_info() -> dict

      Creates a dictionary filled with string keys. The strings and values are arbitrarily created by the system. Some systems may have no information and an empty dictionary will be returned. Most platforms will return a "window" key with the value set to the system id for the current display.

      -
      +

      New in pygame 1.7.1.

      @@ -649,8 +542,8 @@ key with the value set to the system id for the current display.

      pygame.display.get_desktop_sizes()
      -
      Get sizes of active desktops.
      -
      get_desktop_sizes() -> list[tuple[int, int]]
      +
      Get sizes of active desktops
      +
      get_desktop_sizes() -> list

      This function returns the sizes of the currently configured virtual desktops as a list of (x, y) tuples of integers.

      @@ -662,7 +555,7 @@ but the desktop size configured in the operating system.

      to respect the resolution configured by the operating system in fullscreen mode, this function should be used to replace many use cases of pygame.display.list_modes() whenever applicable.

      -
      +

      New in pygame 2.0.0.

      @@ -671,8 +564,8 @@ mode, this function should be used to replace many use cases of
      pygame.display.list_modes()
      -
      Get list of available fullscreen modes.
      -
      list_modes(depth=0, flags=FULLSCREEN, display=0) -> list[tuple[int, int]]
      +
      Get list of available fullscreen modes
      +
      list_modes(depth=0, flags=pygame.FULLSCREEN, display=0) -> list

      This function returns a list of possible sizes for a specified color depth. The return value will be an empty list if no display modes are @@ -695,7 +588,7 @@ use pygame.display. resolution. Developers are strongly advised to default to the current physical monitor resolution unless the user explicitly requests a different one (e.g. in an options menu or configuration file).

      -
      +

      Changed in pygame 1.9.5: display argument added

      @@ -704,8 +597,8 @@ one (e.g. in an options menu or configuration file).

      pygame.display.mode_ok()
      -
      Pick the best color depth for a display mode.
      -
      mode_ok(size, flags=0, depth=0, display=0) -> int
      +
      Pick the best color depth for a display mode
      +
      mode_ok(size, flags=0, depth=0, display=0) -> depth

      This function uses the same arguments as pygame.display.set_mode(). It is used to determine if a requested display mode is available. It will @@ -716,7 +609,7 @@ multiple display depths. If passed it will hint to which depth is a better match.

      The function will return 0 if the passed display flags cannot be set.

      The display index 0 means the default display is used.

      -
      +

      Changed in pygame 1.9.5: display argument added

      @@ -725,20 +618,23 @@ match.

      pygame.display.gl_get_attribute()
      -
      Get the value for an OpenGL flag for the current display.
      -
      gl_get_attribute(flag, /) -> int
      +
      Get the value for an OpenGL flag for the current display
      +
      gl_get_attribute(flag) -> value

      After calling pygame.display.set_mode() with the pygame.OPENGL flag, it is a good idea to check the value of any requested OpenGL attributes. See pygame.display.gl_set_attribute() for a list of valid flags.

      +
      +

      Changed in pygame 2.5.0: Added support for keyword arguments.

      +
      pygame.display.gl_set_attribute()
      -
      Request an OpenGL display attribute for the display mode.
      -
      gl_set_attribute(flag, value, /) -> None
      +
      Request an OpenGL display attribute for the display mode
      +
      gl_set_attribute(flag, value) -> None

      When calling pygame.display.set_mode() with the pygame.OPENGL flag, Pygame automatically handles setting the OpenGL attributes like color and @@ -749,7 +645,7 @@ This must be called before -

      The OPENGL flags are

      +

      The OPENGL flags are:

      GL_ALPHA_SIZE, GL_DEPTH_SIZE, GL_STENCIL_SIZE, GL_ACCUM_RED_SIZE,
       GL_ACCUM_GREEN_SIZE,  GL_ACCUM_BLUE_SIZE, GL_ACCUM_ALPHA_SIZE,
       GL_MULTISAMPLEBUFFERS, GL_MULTISAMPLESAMPLES, GL_STEREO
      @@ -758,8 +654,8 @@ one than requested.

      GL_MULTISAMPLEBUFFERS

      Whether to enable multisampling anti-aliasing. -Defaults to 0 (disabled). -Set GL_MULTISAMPLESAMPLES to a value +Defaults to 0 (disabled).

      +

      Set GL_MULTISAMPLESAMPLES to a value above 0 to control the amount of anti-aliasing. A typical value is 2 or 3.

      @@ -779,7 +675,10 @@ A typical value is 2 or 3.

      Minimum bit size of the frame buffer. Defaults to 0.

      -
      +
      +

      Changed in pygame 2.5.0: Added support for keyword arguments.

      +
      +

      New in pygame 2.0.0: Additional attributes:

      GL_ACCELERATED_VISUAL,
      @@ -811,11 +710,11 @@ By default, both are allowed.

      pygame.display.get_active()
      -
      Returns True when the display is active on the screen.
      +
      Returns True when the display is active on the screen
      get_active() -> bool

      Returns True when the display Surface is considered actively -renderable on the screen and may be visible to the user. This is +renderable on the screen and may be visible to the user. This is the default state immediately after pygame.display.set_mode(). This method may return True even if the application is fully hidden behind another application window.

      @@ -840,7 +739,7 @@ for APIs related to input focus.

      pygame.display.iconify()
      -
      Iconify the display surface.
      +
      Iconify the display surface
      iconify() -> bool

      Request the window for the display surface be iconified or hidden. Not all @@ -856,7 +755,7 @@ window has been iconified. Additionally, the event queue also receives a

      pygame.display.toggle_fullscreen()
      -
      Switch between fullscreen and windowed displays.
      +
      Switch between fullscreen and windowed displays
      toggle_fullscreen() -> int

      Switches the display window between windowed and fullscreen modes. @@ -881,9 +780,9 @@ pygame 2 it is the most reliable method to switch to and from fullscreen.

      Note

      toggle_fullscreen() doesn't work on Windows -unless the window size is in pygame.display.list_modes()Get list of available fullscreen modes. or +unless the window size is in pygame.display.list_modes()Get list of available fullscreen modes or the window is created with the flag pygame.SCALED. -See issue #1221.

      +See issue #2380.

      @@ -891,8 +790,8 @@ See pygame.display.set_gamma()
      -
      Change the hardware gamma ramps.
      -
      set_gamma(red, green=..., blue=..., /) -> bool
      +
      Change the hardware gamma ramps
      +
      set_gamma(red, green=None, blue=None) -> bool

      DEPRECATED: This functionality will go away in SDL3.

      Set the red, green, and blue gamma values on the display hardware. If the @@ -902,7 +801,7 @@ it will return True

      A gamma value of 1.0 creates a linear color table. Lower values will darken the display and higher values will brighten.

      -

      Deprecated since pygame-ce 2.1.4.

      +

      Deprecated since pygame 2.2.0.

      @@ -910,8 +809,8 @@ darken the display and higher values will brighten.

      pygame.display.set_gamma_ramp()
      -
      Change the hardware gamma ramps with a custom lookup.
      -
      set_gamma_ramp(red, green, blue, /) -> bool
      +
      Change the hardware gamma ramps with a custom lookup
      +
      set_gamma_ramp(red, green, blue) -> bool

      DEPRECATED: This functionality will go away in SDL3.

      Set the red, green, and blue gamma ramps with an explicit lookup table. Each @@ -919,7 +818,7 @@ argument should be sequence of 256 integers. The integers should range between 0 and 0xffff. Not all systems and hardware support gamma ramps, if the function succeeds it will return True.

      -

      Deprecated since pygame-ce 2.1.4.

      +

      Deprecated since pygame 2.2.0.

      @@ -927,8 +826,8 @@ ramps, if the function succeeds it will return pygame.display.set_icon()
      -
      Change the system image for the display window.
      -
      set_icon(surface, /) -> None
      +
      Change the system image for the display window
      +
      set_icon(Surface) -> None

      Sets the runtime icon the system will use to represent the display window. All windows default to a simple pygame logo for the window icon.

      @@ -946,22 +845,25 @@ the icon before the display mode is set.

      pygame.display.set_caption()
      -
      Set the current window caption.
      -
      set_caption(title, icontitle=None, /) -> None
      +
      Set the current window caption
      +
      set_caption(title, icontitle=None) -> None

      If the display has a window title, this function will change the name on the window. In pygame 1.x, some systems supported an alternate shorter title to be used for minimized displays, but in pygame 2 icontitle does nothing.

      +
      +

      Changed in pygame 2.5.0: Added support for keyword arguments.

      +
      pygame.display.get_caption()
      -
      Get the current window caption.
      -
      get_caption() -> tuple[str, str]
      +
      Get the current window caption
      +
      get_caption() -> (title, icontitle)
      -

      Returns the title and icontitle of the display window. In pygame 2.x +

      Returns the title and icontitle for the display window. In pygame 2.x these will always be the same value.

      @@ -969,26 +871,29 @@ these will always be the same value.

      pygame.display.set_palette()
      -
      Set the display color palette for indexed displays.
      -
      set_palette(palette, /) -> None
      +
      Set the display color palette for indexed displays
      +
      set_palette(palette=None) -> None

      This will change the video display color palette for 8-bit displays. This does not change the palette for the actual display Surface, only the palette that is used to display the Surface. If no palette argument is passed, the system default palette will be restored. The palette is a sequence of RGB triplets.

      +
      +

      Changed in pygame 2.5.0: Added support for keyword arguments.

      +
      pygame.display.get_num_displays()
      -
      Return the number of displays.
      +
      Return the number of displays
      get_num_displays() -> int

      Returns the number of available displays. This is always 1 if pygame.get_sdl_version()get the version number of SDL returns a major version number below 2.

      -
      +

      New in pygame 1.9.5.

      @@ -997,58 +902,16 @@ system default palette will be restored. The palette is a sequence of
      pygame.display.get_window_size()
      -
      Return the size of the window or screen.
      -
      get_window_size() -> tuple[int, int]
      +
      Return the size of the window or screen
      +
      get_window_size() -> tuple
      -

      Returns the size of the window initialized with pygame.display.set_mode()Initialize a window or screen for display.. +

      Returns the size of the window initialized with pygame.display.set_mode()Initialize a window or screen for display. This may differ from the size of the display surface if SCALED is used.

      -
      +

      New in pygame 2.0.0.

      -
      -
      -pygame.display.get_window_position()
      -
      -
      Return the position of the window or screen.
      -
      get_window_position() -> tuple[int, int]
      -
      -

      Returns the position of the window initialized with pygame.display.set_mode()Initialize a window or screen for display.. -The position will change when the user moves the window or when the -position is set manually with pygame.display.set_window_position()Set the current window position.. -Coordinates could be negative or outside the desktop size bounds. The -position is relative to the topleft of the primary monitor and the y coordinate -ignores the window frame.

      -
      -

      New in pygame-ce 2.5.0.

      -
      -
      - -
      -
      -pygame.display.set_window_position()
      -
      -
      Set the current window position.
      -
      set_window_position(position) -> None
      -
      -

      Sets the position of the window initialized with pygame.display.set_mode()Initialize a window or screen for display.. -This differs from updating environment variables as this function can be -called after the display has been initialised. The position is expected to -be relative to the topleft of the primary monitor. The y coordinate will -ignore the window frame (y = 0 means the frame is hidden). The user will -still be able to move the window after this call. See also -pygame.display.get_window_position()Return the position of the window or screen..

      -
      -

      Note

      -

      This function is not supported on some video drivers (like wayland) -and a pygame.errorstandard pygame exception exception may be raised in such cases.

      -
      -
      -

      New in pygame-ce 2.5.0.

      -
      -
      -
      pygame.display.get_allow_screensaver()
      @@ -1056,17 +919,17 @@ and a Return whether the screensaver is allowed to run.
      get_allow_screensaver() -> bool
      -

      Return whether screensaver is allowed to run whilst the app is running. Default -is False. By default pygame does not allow the screensaver during game -play.

      +

      Return whether screensaver is allowed to run whilst the app is running. +Default is False. +By default pygame does not allow the screensaver during game play.

      -
      +

      New in pygame 2.0.0.

      @@ -1075,8 +938,8 @@ caveats with screensaver support.

      pygame.display.set_allow_screensaver()
      -
      Set whether the screensaver may run.
      -
      set_allow_screensaver(value=True) -> None
      +
      Set whether the screensaver may run
      +
      set_allow_screensaver(bool) -> None

      Change whether screensavers should be allowed whilst the app is running. The default value of the argument to the function is True. @@ -1091,110 +954,17 @@ or 1

      Disabling screensaver is subject to platform support. When platform support is absent, this function will silently appear to work even though the screensaver state -is unchanged. The lack of feedback is due to SDL not +is unchanged. The lack of feedback is due to SDL not providing any supported method for determining whether -it supports changing the screensaver state.

      +it supports changing the screensaver state. +SDL_HINT_VIDEO_ALLOW_SCREENSAVER is available in SDL 2.0.2 or later. +SDL1.2 does not implement this.

      -
      +

      New in pygame 2.0.0.

      -
      -
      -pygame.display.is_fullscreen()
      -
      -
      Returns True if the pygame window created by pygame.display.set_mode() is in full-screen mode.
      -
      is_fullscreen() -> bool
      -
      -

      Edge cases: -If the window is in windowed mode, but maximized, this will return False. -If the window is in "borderless fullscreen" mode, this will return True.

      -
      -

      New in pygame-ce 2.2.0.

      -
      -
      - -
      -
      -pygame.display.is_vsync()
      -
      -
      Returns True if vertical synchronisation for pygame.display.flip() and pygame.display.update() is enabled.
      -
      is_vsync() -> bool
      -
      -
      -

      New in pygame-ce 2.2.0.

      -
      -
      - -
      -
      -pygame.display.get_current_refresh_rate()
      -
      -
      Returns the screen refresh rate or 0 if unknown.
      -
      get_current_refresh_rate() -> int
      -
      -

      The screen refresh rate for the current window. In windowed mode, this -should be equal to the refresh rate of the desktop the window is on.

      -

      If no window is open, an exception is raised.

      -

      When a constant refresh rate cannot be determined, 0 is returned.

      -
      -

      New in pygame-ce 2.2.0.

      -
      -
      - -
      -
      -pygame.display.get_desktop_refresh_rates()
      -
      -
      Returns the screen refresh rates for all displays (in windowed mode).
      -
      get_desktop_refresh_rates() -> list[int]
      -
      -

      If the current window is in full-screen mode, the actual refresh rate for -that window can differ.

      -

      This is safe to call when no window is open (i.e. before any calls to -pygame.display.set_mode()Initialize a window or screen for display.

      -

      When a constant refresh rate cannot be determined, 0 is returned for that -desktop.

      -
      -

      New in pygame-ce 2.2.0.

      -
      -
      - -
      -
      -pygame.display.message_box()
      -
      -
      Create a native GUI message box.
      -
      message_box(title, message=None, message_type='info', parent_window=None, buttons=('OK', ), return_button=0, escape_button=None) -> int
      -
      -
      -
      Parameters:
      -
        -
      • title (str) -- A title string.

      • -
      • message (str) -- A message string. If this parameter is set to None, the message will be the title.

      • -
      • message_type (str) -- Set the type of message_box, could be "info", "warn" or "error".

      • -
      • parent_window (pygame.WindowPygame object that represents a window.) -- The parent window of the message box.

      • -
      • buttons (tuple) -- An optional sequence of button name strings to show to the user.

      • -
      • return_button (int) -- Button index to use if the return key is hit, 0 by default.

      • -
      • escape_button (int) -- Button index to use if the escape key is hit, None for no button linked by default.

      • -
      -
      -
      Returns:
      -

      The index of the button that was pushed.

      -
      -
      -

      This function should be called on the thread that set_mode() is called. -It will block execution of that thread until the user clicks a button or -closes the message_box.

      -

      This function may be called at any time, even before pygame.init().

      -

      Negative values of return_button and escape_button are allowed -just like standard Python list indexing.

      -
      -

      New in pygame-ce 2.4.0.

      -
      -
      - @@ -1202,7 +972,7 @@ just like standard Python list indexing.




      -Edit on GitHub +Edit on GitHub
      @@ -1223,12 +993,14 @@ just like standard Python list indexing.

    • previous |
    • - - + + + +
      \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/draw.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/draw.html index e768ade..7f8ddd7 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/draw.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/draw.html @@ -5,14 +5,12 @@ - pygame.draw — pygame-ce v2.5.8 documentation - - - - - + pygame.draw — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
      @@ -107,64 +97,54 @@
      pygame.draw
      -
      Pygame module for drawing shapes.
      +
      pygame module for drawing shapes
      - + - + - + - - + - - + - - + - - + - - + - - - - - - - - - - +
      —Draw a rectangle.draw a rectangle
      —Draw a polygon.draw a polygon
      —Draw a circle.draw a circle
      +
      —Draw an antialiased circle.draw an ellipse
      +
      —Draw an ellipse.draw an elliptical arc
      +
      —Draw an elliptical arc.draw a straight line
      +
      —Draw a straight line.draw multiple contiguous straight line segments
      +
      —Draw multiple contiguous straight line segments.draw a straight antialiased line
      +
      —Draw a straight antialiased line.
      -—Draw multiple contiguous straight antialiased line segments.
      -—Fill an enclosed, same color area, on a surface.draw multiple contiguous straight antialiased line segments
      @@ -177,15 +157,24 @@ will be filled (solid).

      constrained to that area. The functions return a rectangle representing the bounding area of changed pixels. This bounding rectangle is the 'minimum' bounding box that encloses the affected area.

      -

      All the drawing functions accept a color argument that is compatible with -pygame.typing.ColorLike.

      +

      All the drawing functions accept a color argument that can be one of the +following formats:

      +
      +
      +

      A color's alpha value will be written directly into the surface (if the surface contains pixel alphas), but the draw function will not draw transparently.

      These functions temporarily lock the surface they are operating on. Many sequential drawing calls can be sped up by locking and unlocking the surface -object around the draw calls (see pygame.Surface.lock()Lock the Surface memory for pixel access. and -pygame.Surface.unlock()Unlock the Surface memory from pixel access.).

      +object around the draw calls (see pygame.Surface.lock()lock the Surface memory for pixel access and +pygame.Surface.unlock()unlock the Surface memory from pixel access).

      Note

      See the pygame.gfxdrawpygame module for drawing shapes module for alternative draw methods.

      @@ -194,15 +183,16 @@ object around the draw calls (see pygame.draw.rect()
      -
      Draw a rectangle.
      -
      rect(surface, color, rect, width=0, border_radius=-1, border_top_left_radius=-1, border_top_right_radius=-1, border_bottom_left_radius=-1, border_bottom_right_radius=-1) -> Rect
      +
      draw a rectangle
      +
      rect(surface, color, rect) -> Rect
      +
      rect(surface, color, rect, width=0, border_radius=0, border_top_left_radius=-1, border_top_right_radius=-1, border_bottom_left_radius=-1, border_bottom_right_radius=-1) -> Rect

      Draws a rectangle on the given surface.

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • rect (Rect) -- rectangle to draw, position and dimensions

      • width (int) --

        (optional) used for line thickness or to indicate that @@ -216,6 +206,11 @@ of the rect<


      +
      +

      Changed in pygame 2.1.1: Drawing rects with width now draws the width correctly inside the +rect's area, rather than using an internal call to draw.lines(), +which had half the width spill outside the rect area.

      +

    • border_radius (int) -- (optional) used for drawing rectangle with rounded corners. The supported range is [0, min(height, width) / 2], with 0 representing a rectangle @@ -250,27 +245,23 @@ parameter and its width and height will be 0

      Note

      -

      The pygame.Surface.fill()Fill Surface with a solid color. method works just as well for drawing +

      The pygame.Surface.fill()fill Surface with a solid color method works just as well for drawing filled rectangles and can be hardware accelerated on some platforms.

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      -
      +

      Changed in pygame 2.0.0.dev8: Added support for border radius.

      -
      -

      Changed in pygame 2.1.1: Drawing rects with width now draws the width correctly inside the -rect's area, rather than using an internal call to draw.lines(), -which had half the width spill outside the rect area.

      -
      pygame.draw.polygon()
      -
      Draw a polygon.
      +
      draw a polygon
      +
      polygon(surface, color, points) -> Rect
      polygon(surface, color, points, width=0) -> Rect

      Draws a polygon on the given surface.

      @@ -278,10 +269,10 @@ which had half the width spill outside the rect area.

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • -
      • points (tuple(point) or list(point)) -- a sequence of 3 or more (x, y) coordinates that make up the -vertices of the polygon, each point in the sequence must be a +

      • points (tuple(coordinate) or list(coordinate)) -- a sequence of 3 or more (x, y) coordinates that make up the +vertices of the polygon, each coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats, e.g. [(x1, y1), (x2, y2), (x3, y3)]

      • width (int) --

        (optional) used for line thickness or to indicate that @@ -298,7 +289,7 @@ the polygon is to be filled

        When using width values > 1, the edge lines will grow outside the original boundary of the polygon. For more details on how the thickness for edge lines grow, refer to the width notes -of the pygame.draw.line()Draw a straight line. function.

        +of the pygame.draw.line()draw a straight line function.

    • @@ -325,7 +316,7 @@ contain number pairs

      Note

      For an aapolygon, use aalines() with closed=True.

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      @@ -334,15 +325,16 @@ contain number pairs

      pygame.draw.circle()
      -
      Draw a circle.
      -
      circle(surface, color, center, radius, width=0, draw_top_right=False, draw_top_left=False, draw_bottom_left=False, draw_bottom_right=False) -> Rect
      +
      draw a circle
      +
      circle(surface, color, center, radius) -> Rect
      +
      circle(surface, color, center, radius, width=0, draw_top_right=None, draw_top_left=None, draw_bottom_left=None, draw_bottom_right=None) -> Rect

      Draws a circle on the given surface.

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • center (tuple(int or float, int or float) or list(int or float, int or float) or Vector2(int or float, int or float)) -- center point of the circle as a sequence of 2 ints/floats, @@ -375,7 +367,8 @@ of the circle will be drawn

      • of the circle will be drawn

        -
        If any quadrants are set to True, only they will be drawn, otherwise the entire circle will be drawn.
        +
        if any of the draw_circle_part is True then it will draw all circle parts that have the True
        +
        value, otherwise it will draw the entire circle.

        @@ -396,96 +389,24 @@ values will be truncated) and its width and height will be 0

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments. Nothing is drawn when the radius is 0 (a pixel at the center coordinates used to be drawn when the radius equaled 0). Floats, and Vector2 are accepted for the center param. The drawing algorithm was improved to look more like a circle.

      -
      +

      Changed in pygame 2.0.0.dev8: Added support for drawing circle quadrants.

      -
      -
      -pygame.draw.aacircle()
      -
      -
      Draw an antialiased circle.
      -
      aacircle(surface, color, center, radius, width=0, draw_top_right=False, draw_top_left=False, draw_bottom_left=False, draw_bottom_right=False) -> Rect
      -
      -

      Draws an antialiased circle on the given surface. -Uses Xiaolin Wu Circle Algorithm. -Adapted from: https://cgg.mff.cuni.cz/~pepca/ref/WU.pdf

      -
      -
      Parameters:
      -
        -
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a -tuple (RGB[A])

      • -
      • center (tuple(int or float, int or float) or -list(int or float, int or float) or Vector2(int or float, int or float)) -- center point of the circle as a sequence of 2 ints/floats, -e.g. (x, y)

      • -
      • radius (int or float) -- radius of the circle, measured from the center parameter, -nothing will be drawn if the radius is less than 1

      • -
      • width (int) --

        (optional) used for line thickness or to indicate that -the circle is to be filled

        -
        -
        -
        if width == 0, (default) fill the circle
        -
        if width > 0, used for line thickness
        -
        if width < 0, nothing will be drawn
        -

        -
        -
        -

        Note

        -

        When using width values > 1, the edge lines will only grow -inward.

        -
        -
        -

      • -
      • draw_top_right (bool) -- (optional) if this is set to True then the top right corner -of the circle will be drawn

      • -
      • draw_top_left (bool) -- (optional) if this is set to True then the top left corner -of the circle will be drawn

      • -
      • draw_bottom_left (bool) -- (optional) if this is set to True then the bottom left corner -of the circle will be drawn

      • -
      • draw_bottom_right (bool) --

        (optional) if this is set to True then the bottom right corner -of the circle will be drawn

        -
        -
        -
        If any quadrants are set to True, only they will be drawn, otherwise the entire circle will be drawn.
        -
        -
        -

      • -
      -
      -
      Returns:
      -

      a rect bounding the changed pixels, if nothing is drawn the -bounding rect's position will be the center parameter value (float -values will be truncated) and its width and height will be 0

      -
      -
      Return type:
      -

      Rect

      -
      -
      Raises:
      -
        -
      • TypeError -- if center is not a sequence of two numbers

      • -
      • TypeError -- if radius is not a number

      • -
      -
      -
      -
      -

      New in pygame-ce 2.5.0.

      -
      -
      -
      pygame.draw.ellipse()
      -
      Draw an ellipse.
      +
      draw an ellipse
      +
      ellipse(surface, color, rect) -> Rect
      ellipse(surface, color, rect, width=0) -> Rect

      Draws an ellipse on the given surface.

      @@ -493,7 +414,7 @@ values will be truncated) and its width and height will be 0

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • rect (Rect) -- rectangle to indicate the position and dimensions of the ellipse, the ellipse will be centered inside the rectangle and bounded @@ -526,7 +447,7 @@ parameter and its width and height will be 0

        Rect

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      @@ -535,7 +456,8 @@ parameter and its width and height will be 0

      pygame.draw.arc()
      -
      Draw an elliptical arc.
      +
      draw an elliptical arc
      +
      arc(surface, color, rect, start_angle, stop_angle) -> Rect
      arc(surface, color, rect, start_angle, stop_angle, width=1) -> Rect

      Draws an elliptical arc on the given surface.

      @@ -546,7 +468,7 @@ the start_angleParameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • rect (Rect) -- rectangle to indicate the position and dimensions of the ellipse which the arc will be based on, the ellipse will be centered @@ -564,6 +486,7 @@ to the stop_anglestart_angle the above start_angle < stop_angle case applies, otherwise nothing will be drawn

      if start_angle == stop_angle, nothing will be drawn
      +

      @@ -593,7 +516,7 @@ parameter and its width and height will be 0

      Rect

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      @@ -602,7 +525,8 @@ parameter and its width and height will be 0

      pygame.draw.line()
      -
      Draw a straight line.
      +
      draw a straight line
      +
      line(surface, color, start_pos, end_pos) -> Rect
      line(surface, color, start_pos, end_pos, width=1) -> Rect

      Draws a straight line on the given surface. There are no endcaps. For thick @@ -611,7 +535,7 @@ lines the ends are squared off.

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • start_pos (tuple(int or float, int or float) or list(int or float, int or float) or Vector2(int or float, int or float)) -- start position of the line, (x, y)

      • @@ -621,6 +545,7 @@ tuple (RGB[A])
        if width >= 1, used for line thickness (default is 1)
        if width < 1, nothing will be drawn
        +

      Note

      @@ -651,7 +576,7 @@ values will be truncated) and its width and height will be 0

      two numbers

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      @@ -660,7 +585,8 @@ two numbers

      pygame.draw.lines()
      -
      Draw multiple contiguous straight line segments.
      +
      draw multiple contiguous straight line segments
      +
      lines(surface, color, closed, points) -> Rect
      lines(surface, color, closed, points, width=1) -> Rect

      Draws a sequence of contiguous straight lines on the given surface. There are @@ -670,14 +596,14 @@ Drawing thick lines with sharp corners can have undesired looking results.

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • closed (bool) -- if True an additional line segment is drawn between the first and last points in the points sequence

      • -
      • points (tuple(point) or list(point)) -- a sequence of 2 or more (x, y) coordinates, where each -point in the sequence must be a +

      • points (tuple(coordinate) or list(coordinate)) -- a sequence of 2 or more (x, y) coordinates, where each +coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats and adjacent -points will be connected by a line segment, e.g. for the +coordinates will be connected by a line segment, e.g. for the points [(x1, y1), (x2, y2), (x3, y3)] a line segment will be drawn from (x1, y1) to (x2, y2) and from (x2, y2) to (x3, y3), additionally if the closed parameter is True another line segment @@ -686,6 +612,7 @@ will be drawn from

        if width >= 1, used for line thickness (default is 1)
        if width < 1, nothing will be drawn
        +

        Note

        @@ -712,7 +639,7 @@ contain number pairs

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      @@ -721,11 +648,77 @@ contain number pairs

      pygame.draw.aaline()
      -
      Draw a straight antialiased line.
      -
      aaline(surface, color, start_pos, end_pos, width=1) -> Rect
      +
      draw a straight antialiased line
      +
      aaline(surface, color, start_pos, end_pos) -> Rect
      +
      aaline(surface, color, start_pos, end_pos, blend=1) -> Rect
      -

      Draws a straight antialiased line on the given surface. There are no endcaps. -For thick lines the ends are squared off.

      +

      Draws a straight antialiased line on the given surface.

      +

      The line has a thickness of one pixel and the endpoints have a height and +width of one pixel each.

      +
      +
      The way a line and its endpoints are drawn:

      If both endpoints are equal, only a single pixel is drawn (after +rounding floats to nearest integer).

      +

      Otherwise if the line is not steep (i.e. if the length along the x-axis +is greater than the height along the y-axis):

      +
      +

      For each endpoint:

      +
      +

      If x, the endpoint's x-coordinate, is a whole number find +which pixels would be covered by it and draw them.

      +

      Otherwise:

      +
      +

      Calculate the position of the nearest point with a whole number +for its x-coordinate, when extending the line past the +endpoint.

      +

      Find which pixels would be covered and how much by that point.

      +

      If the endpoint is the left one, multiply the coverage by (1 - +the decimal part of x).

      +

      Otherwise multiply the coverage by the decimal part of x.

      +

      Then draw those pixels.

      +
      +
      e.g.:
      +
      The left endpoint of the line ((1, 1.3), (5, 3)) would +cover 70% of the pixel (1, 1) and 30% of the pixel +(1, 2) while the right one would cover 100% of the +pixel (5, 3).
      +
      The left endpoint of the line ((1.2, 1.4), (4.6, 3.1)) +would cover 56% (i.e. 0.8 * 70%) of the pixel (1, 1) +and 24% (i.e. 0.8 * 30%) of the pixel (1, 2) while +the right one would cover 42% (i.e. 0.6 * 70%) of the +pixel (5, 3) and 18% (i.e. 0.6 * 30%) of the pixel +(5, 4) while the right
      +
      +
      +
      +
      +
      +

      Then for each point between the endpoints, along the line, whose +x-coordinate is a whole number:

      +
      +

      Find which pixels would be covered and how much by that point and +draw them.

      +
      +
      e.g.:
      +
      The points along the line ((1, 1), (4, 2.5)) would be +(2, 1.5) and (3, 2) and would cover 50% of the pixel +(2, 1), 50% of the pixel (2, 2) and 100% of the pixel +(3, 2).
      +
      The points along the line ((1.2, 1.4), (4.6, 3.1)) would +be (2, 1.8) (covering 20% of the pixel (2, 1) and 80% +of the pixel (2, 2)), (3, 2.3) (covering 70% of the +pixel (3, 2) and 30% of the pixel (3, 3)) and (4, +2.8) (covering 20% of the pixel (2, 1) and 80% of the +pixel (2, 2))
      +
      +
      +
      +
      +
      +

      Otherwise do the same for steep lines as for non-steep lines except +along the y-axis instead of the x-axis (using y instead of x, +top instead of left and bottom instead of right).

      +
      +

      Note

      Regarding float values for coordinates, a point with coordinate @@ -741,18 +734,14 @@ pixel (2,2)<

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • start_pos (tuple(int or float, int or float) or list(int or float, int or float) or Vector2(int or float, int or float)) -- start position of the line, (x, y)

      • end_pos (tuple(int or float, int or float) or list(int or float, int or float) or Vector2(int or float, int or float)) -- end position of the line, (x, y)

      • -
      • width (int) --

        (optional) used for line thickness

        -
        -
        if width >= 1, used for line thickness (default is 1)
        -
        if width < 1, a line of width == 1 will be drawn
        -
        -

      • +
      • blend (int) -- (optional) (deprecated) if non-zero (default) the line will be blended +with the surface's existing pixel shades, otherwise it will overwrite them

      Returns:
      @@ -768,28 +757,18 @@ values will be truncated) and its width and height will be 0

      two numbers

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      -
      -

      Changed in pygame-ce 2.4.0: Removed deprecated 'blend' argument

      -
      -
      -

      Changed in pygame-ce 2.5.0: blend argument re-added for backcompat, but will -do nothing different and always raise a deprecation exception when used.

      -
      -
      -

      Changed in pygame-ce 2.5.6: Added width in place of the deprecated -blend argument in a way that doesn't break backcompat too much.

      -
      pygame.draw.aalines()
      -
      Draw multiple contiguous straight antialiased line segments.
      +
      draw multiple contiguous straight antialiased line segments
      aalines(surface, color, closed, points) -> Rect
      +
      aalines(surface, color, closed, points, blend=1) -> Rect

      Draws a sequence of contiguous straight antialiased lines on the given surface.

      @@ -797,18 +776,21 @@ surface.

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike) -- color to draw with, the alpha value is optional if using a +

      • color (Color or int or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a tuple (RGB[A])

      • closed (bool) -- if True an additional line segment is drawn between the first and last points in the points sequence

      • -
      • points (tuple(point) or list(point)) -- a sequence of 2 or more (x, y) coordinates, where each -point in the sequence must be a +

      • points (tuple(coordinate) or list(coordinate)) -- a sequence of 2 or more (x, y) coordinates, where each +coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats and adjacent -points will be connected by a line segment, e.g. for the +coordinates will be connected by a line segment, e.g. for the points [(x1, y1), (x2, y2), (x3, y3)] a line segment will be drawn from (x1, y1) to (x2, y2) and from (x2, y2) to (x3, y3), additionally if the closed parameter is True another line segment will be drawn from (x3, y3) to (x1, y1)

      • +
      • blend (int) -- (optional) (deprecated) if non-zero (default) each line will be blended +with the surface's existing pixel shades, otherwise the pixels will be +overwritten

      Returns:
      @@ -828,50 +810,9 @@ contain number pairs

      -
      +

      Changed in pygame 2.0.0: Added support for keyword arguments.

      -
      -

      Changed in pygame-ce 2.4.0: Removed deprecated blend argument

      -
      -
      -

      Changed in pygame-ce 2.5.0: blend argument re-added for backcompat, but will -always raise a deprecation exception when used

      -
      - - -
      -
      -pygame.draw.flood_fill()
      -
      -
      Fill an enclosed, same color area, on a surface.
      -
      flood_fill(surface, color, start_pos) -> Rect
      -
      -

      Replace the color of a cluster of connected same-color pixels, beginning -from the starting position, with a repeating pattern or solid single color.

      -
      -
      Parameters:
      -
        -
      • surface (Surface) -- surface to draw on

      • -
      • color (pygame.typing.ColorLike or a pattern to fill with, as a Surface) -- color, or surface pattern, to draw with. The alpha value is optional if using a -tuple (RGB[A])

      • -
      • start_pos (tuple(int or float, int or float) or -list(int or float, int or float) or Vector2(int or float, int or float)) -- starting position as a sequence of 2 ints/floats, -e.g. (x, y)

      • -
      -
      -
      Returns:
      -

      a rect bounding the changed pixels, if nothing is drawn the -bounding rect's position will be the position of the starting point -and its width and height will be 0

      -
      -
      Return type:
      -

      Rect

      -
      -
      -
      -

      New in pygame-ce 2.5.6.

      -
      @@ -880,8 +821,8 @@ and its width and height will be 0

      Example code for draw module.

      -
      import pygame
      -from math import pi
      +
      import pygame
      +from math import pi
       
       # Initialize pygame
       pygame.init()
      @@ -912,10 +853,6 @@ and its width and height will be 0

      # 5 pixels wide. Uses (r, g, b) color - medium sea green. pygame.draw.line(screen, (60, 179, 113), [0, 0], [50, 30], 5) - # Draw on the screen a green antialiased line from (0, 25) to (50, 55) - # 5 pixels wide. Uses (r, g, b) color - medium sea green. - pygame.draw.aaline(screen, (60, 179, 113), [0, 25], [50, 55], 5) - # Draw on the screen a green line from (0, 50) to (50, 80) # Because it is an antialiased line, it is 1 pixel wide. # Uses (r, g, b) color - medium sea green. @@ -964,15 +901,6 @@ and its width and height will be 0

      # Draw a circle pygame.draw.circle(screen, "blue", [60, 250], 40) - # Draw an antialiased circle with 3 pixels wide line - pygame.draw.aacircle(screen, "green", [340, 250], 40, 3) - - # Draw an antialiased top right circle quadrant with 4 pixels wide line - pygame.draw.aacircle(screen, "red", [340, 250], 20, 4, draw_top_right=True) - - # Draw an antialiased bottom left filled circle quadrant - pygame.draw.aacircle(screen, "blue", [340, 250], 20, draw_bottom_left=True) - # Draw only one circle quadrant pygame.draw.circle(screen, "blue", [250, 250], 40, 0, draw_top_right=True) pygame.draw.circle(screen, "red", [250, 250], 40, 30, draw_top_left=True) @@ -994,7 +922,7 @@ and its width and height will be 0




      -Edit on GitHub +Edit on GitHub
      @@ -1015,12 +943,14 @@ and its width and height will be 0

    • previous |
    • - - + + + +
      \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/event.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/event.html index eb5dc33..8cb120f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/event.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/event.html @@ -5,14 +5,12 @@ - pygame.event — pygame-ce v2.5.8 documentation - - - - - + pygame.event — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
      @@ -149,7 +139,7 @@
      —control which events are blocked on the queuecontrol which events are allowed on the queue
      — test if the program is sharing input devices
      +—grab enables capture of system keyboard shortcuts like Alt+Tab or the Meta/Super key.
      +—get the current keyboard grab state
      —
      -

      Event queue

      -

      Pygame handles all its event messaging through an event queue. The functions in +

      Pygame handles all its event messaging through an event queue. The routines in this module help you manage that event queue. The input queue is heavily -dependent on the video system (pygame.displayPygame module to control the display window and screen. or pygame.WindowPygame object that represents a window.). -If a window has not been created, the event queue may not work properly.

      +dependent on the pygame.displaypygame module to control the display window and screen module. If the display has not been +initialized and a video mode not set, the event queue may not work properly.

      The event queue has an upper limit on the number of events it can hold. When the queue becomes full new events are quietly dropped. To prevent lost events, especially input events which signal a quit command, your program must handle -events every frame (with pygame.event.get()get events from the queue, pygame.event.pump()internally process pygame event handlers, -pygame.event.wait()wait for a single event from the queue, pygame.event.peek()test if event types are waiting on the queue or -pygame.event.clear()remove all events from the queue).

      -
      -

      Note

      -

      Not handling events may cause the system to decide the program is -frozen (not responding).

      -
      -

      Events of input devices

      +events every frame (with pygame.event.get(), pygame.event.pump(), +pygame.event.wait(), pygame.event.peek() or pygame.event.clear()) +and process them. Not handling events may cause your system to decide your +program has locked up. To speed up queue processing use +pygame.event.set_blocked()control which events are allowed on the queue to limit which events get queued.

      To get the state of various input devices, you can forego the event queue and access the input devices directly with their appropriate modules: -pygame.mousePygame module to work with the mouse., pygame.keyPygame module to work with the keyboard., and pygame.joystickPygame module for interacting with joysticks, gamepads, and trackballs.. However, -the event queue still needs to be running internally to enable this; programs -still need to use functions like pygame.event.get()get events from the queue or -pygame.event.pump()internally process pygame event handlers periodically. Note: Joysticks will not send any -events until the device has been initialized.

      -

      Event objects

      +pygame.mousepygame module to work with the mouse, pygame.keypygame module to work with the keyboard, and pygame.joystickPygame module for interacting with joysticks, gamepads, and trackballs.. If you use +this method, remember that pygame requires some form of communication with the +system window manager and other parts of the platform. To keep pygame in sync +with the system, you will need to call pygame.event.pump()internally process pygame event handlers to keep +everything current. Usually, this should be called once per game loop. +Note: Joysticks will not send any events until the device has been initialized.

      The event queue contains pygame.event.Eventpygame object for representing events event objects. There are a variety of ways to access the queued events, from simply -checking for the existence of events, to popping them off of the event queue.

      +checking for the existence of events, to grabbing them directly off the stack. +The event queue also offers some simple filtering which can slightly help +performance by blocking certain event types from the queue. Use +pygame.event.set_allowed()control which events are allowed on the queue and pygame.event.set_blocked()control which events are allowed on the queue to +change this filtering. By default, all event types can be placed on the queue.

      All pygame.event.Eventpygame object for representing events instances contain an event type identifier and attributes specific to that event type. The event type identifier is -accessible as the pygame.event.Event.typeevent type identifier. property. An event type's -specific attributes can be accessed directly as an attribute on the event -object.

      -

      Users can create their own new events (or emulate system events) by -instantiating pygame.event.Event()pygame object for representing events themselves, usually paired -with pygame.event.post()place a new event on the queue.

      -

      Events support equality and inequality comparisons. Two events are equal if -they are the same type and have identical attribute values.

      -

      Custom events and debugging

      +accessible as the pygame.event.Event.typeevent type identifier. property. Any of the +event specific attributes can be accessed through the +pygame.event.Event.__dict__event attribute dictionary attribute or directly as an attribute +of the event object (as member lookups are passed through to the object's +dictionary values). The event object has no method functions. Users can create +their own new events with the pygame.event.Event()pygame object for representing events function.

      The event type identifier is in between the values of NOEVENT and NUMEVENTS. User defined events should have a value in the inclusive range -of USEREVENT to NUMEVENTS - 1. User defined events should reserve -a custom event number with pygame.event.custom_type()make custom user event type.

      +of USEREVENT to NUMEVENTS - 1. User defined events can get a custom +event number with pygame.event.custom_type()make custom user event type. +It is recommended all user events follow this system.

      +

      Events support equality and inequality comparisons. Two events are equal if +they are the same type and have identical attribute values.

      While debugging and experimenting, you can print an event object for a quick -display of its type and members.

      -

      Event types and attributes

      +display of its type and members. The function pygame.event.event_name()get the string name from an event id +can be used to get a string representing the name of the event type.

      Events that come from the system will have a guaranteed set of member -attributes based on the type. The following are lists of event types with their -specific attributes and notes.

      -

      You can also find a list of constants for keyboard keys -here.

      -
      Event type                 Attributes/Notes
      -
      -QUIT
      -USEREVENT                  (Starting type of the user defined
      -                            event types)
      -
      -KEYDOWN                    key, mod, unicode, scancode, window(1)
      -KEYUP                      key, mod, unicode, scancode, window(1)
      -
      -MOUSEMOTION                pos, rel, buttons, touch(2), window(1)
      -MOUSEBUTTONUP              pos, button, touch(2), clicks(3), window(1)
      -MOUSEBUTTONDOWN            pos, button, touch(2), clicks(3), window(1)
      -MOUSEWHEEL                 which, flipped, x, y, touch(2), precise_x,
      -                            precise_y, window(1), pos(5)
      -
      -JOYAXISMOTION              instance_id, axis, value (deprecated: joy)
      -JOYBALLMOTION              instance_id, ball, rel (deprecated: joy)
      -JOYHATMOTION               instance_id, hat, value (deprecated: joy)
      -JOYBUTTONUP                instance_id, button (deprecated: joy)
      -JOYBUTTONDOWN              instance_id, button (deprecated: joy)
      -CONTROLLERDEVICEADDED      device_index
      -JOYDEVICEADDED             device_index
      -CONTROLLERDEVICEREMOVED    instance_id
      -JOYDEVICEREMOVED           instance_id
      -CONTROLLERDEVICEREMAPPED   instance_id
      -
      -(Use the window event API instead of legacy events)
      -ACTIVEEVENT                gain, state (Legacy event)
      -VIDEORESIZE                size, w, h  (Legacy event)
      -VIDEOEXPOSE                            (Legacy event)
      -
      -AUDIODEVICEADDED           which, iscapture
      -AUDIODEVICEREMOVED         which, iscapture
      -
      -FINGERMOTION               touch_id, finger_id, x, y, dx, dy, window(1)
      -FINGERDOWN                 touch_id, finger_id, x, y, dx, dy, window(1)
      -FINGERUP                   touch_id, finger_id, x, y, dx, dy, window(1)
      -MULTIGESTURE               touch_id, x, y, pinched, rotated, num_fingers
      -
      -TEXTEDITING(4)             text, start(4), length(4), window(1)
      -TEXTINPUT(4)               text, window(1)
      -
      -DROPFILE                   window(1), file (Path of the file dropped
      -                            on the window)
      -DROPBEGIN                  window(1)
      -DROPCOMPLETE               window(1)
      -DROPTEXT                   window(1)
      -
      -MIDIIN                     (Reserved for pygame.midi use)
      -MIDIOUT                    (Reserved for pygame.midi use)
      -
      -KEYMAPCHANGED              (Keymap change due to language/keyboard
      -                            layout change)
      -CLIPBOARDUPDATE            (Partially experimental)
      -LOCALECHANGED
      -
      -RENDER_TARGETS_RESET
      -RENDER_DEVICE_RESET
      +attributes based on the type. The following is a list of event types with their
      +specific attributes.

      +
      QUIT              none
      +ACTIVEEVENT       gain, state
      +KEYDOWN           key, mod, unicode, scancode
      +KEYUP             key, mod, unicode, scancode
      +MOUSEMOTION       pos, rel, buttons, touch
      +MOUSEBUTTONUP     pos, button, touch
      +MOUSEBUTTONDOWN   pos, button, touch
      +JOYAXISMOTION     joy (deprecated), instance_id, axis, value
      +JOYBALLMOTION     joy (deprecated), instance_id, ball, rel
      +JOYHATMOTION      joy (deprecated), instance_id, hat, value
      +JOYBUTTONUP       joy (deprecated), instance_id, button
      +JOYBUTTONDOWN     joy (deprecated), instance_id, button
      +VIDEORESIZE       size, w, h
      +VIDEOEXPOSE       none
      +USEREVENT         code
       
      +
      +

      Changed in pygame 2.0.0: The joy attribute was deprecated, instance_id was added.

      +
      +
      +

      Changed in pygame 2.0.1: The unicode attribute was added to KEYUP event.

      +
      +

      Note that ACTIVEEVENT, VIDEORESIZE and VIDEOEXPOSE are considered +as "legacy" events, the use of pygame2 WINDOWEVENT API is recommended over +the use of this older API.

      +

      You can also find a list of constants for keyboard keys +here.

      +

      A keyboard event occurs when a key is pressed (KEYDOWN) and when a key is released (KEYUP) +The key attribute of keyboard events contains the value of what key was pressed or released. +The mod attribute contains information about the state of keyboard modifiers (SHIFT, CTRL, ALT, etc.). +The unicode attribute stores the 16-bit unicode value of the key that was pressed or released. +The scancode attribute represents the physical location of a key on the keyboard.

      +

      The ACTIVEEVENT contains information about the application gaining or losing focus. The gain attribute +will be 1 if the mouse enters the window, otherwise gain will be 0. The state attribute will have a +value of SDL_APPMOUSEFOCUS if mouse focus was gained/lost, SDL_APPINPUTFOCUS if the application loses +or gains keyboard focus, or SDL_APPACTIVE if the application is minimized (gain will be 0) or restored.


      -

      (1): if a pygame.WindowPygame object that represents a window. instance exists for the window that the event -occurred in, the window attribute of these events will be that instance, -otherwise it will be None.

      -

      (2): The touch attribute of MOUSE events indicates whether or not the -events were generated by a touch input device, and not a real mouse. You might -want to ignore such events, if your application already handles FINGERMOTION, -FINGERDOWN and FINGERUP events.

      -

      (3): The clicks attribute of the MOUSEBUTTONDOWN and MOUSEBUTTONUP -events indicate the number of clicks occurring in rapid succession, e.g. 1 -for single-click, 2 for double-click, etc. Note that double, triple, or -more clicks will still fire mouse events for each individual click, with a -progressively increasing clicks attribute.

      -

      (4): The start attribute of the TEXTEDITING event is the cursor position, -in UTF-8 characters, where the new typing will be inserted into the editing text, -while the length attribute is the number of UTF-8 characters that will be -replaced by the new typing.

      -

      These TEXT* events are useful to implement inputs/languages that require composition, -provided by the system's IME (Input Method Editor). The TEXTINPUT event is only -fired when the text is confirmed.

      -

      (5): Position information was added to MOUSEWHEEL events in SDL 2.26.0. If -pygame was built on a version lower than that, the pos attribute is None.

      +

      When compiled with SDL2, pygame has these additional events and their +attributes.

      +
      AUDIODEVICEADDED   which, iscapture (SDL backend >= 2.0.4)
      +AUDIODEVICEREMOVED which, iscapture (SDL backend >= 2.0.4)
      +FINGERMOTION       touch_id, finger_id, x, y, dx, dy
      +FINGERDOWN         touch_id, finger_id, x, y, dx, dy
      +FINGERUP           touch_id, finger_id, x, y, dx, dy
      +MOUSEWHEEL         which, flipped, x, y, touch, precise_x, precise_y
      +MULTIGESTURE       touch_id, x, y, pinched, rotated, num_fingers
      +TEXTEDITING        text, start, length
      +TEXTINPUT          text
      +
      +
      +
      +

      New in pygame 1.9.5.

      +
      +
      +

      Changed in pygame 2.0.2: Fixed amount horizontal scroll (x, positive to the right and negative to the left).

      +
      +
      +

      Changed in pygame 2.0.2: The touch attribute was added to all the MOUSE events.

      +
      +

      The touch attribute of MOUSE events indicates whether or not the events were generated +by a touch input device, and not a real mouse. You might want to ignore such events, if your application +already handles FINGERMOTION, FINGERDOWN and FINGERUP events.

      +
      +

      New in pygame 2.1.3: Added precise_x and precise_y to MOUSEWHEEL events

      +
      +

      MOUSEWHEEL event occurs whenever the mouse wheel is moved. +The which attribute determines if the event was generated from a touch input device vs an actual +mousewheel. +The preciseX attribute contains a float with the amount scrolled horizontally (positive to the right, +negative to the left). +The preciseY attribute contains a float with the amount scrolled vertically (positive away from user, +negative towards user). +The flipped attribute determines if the values in x and y will be opposite or not. If SDL_MOUSEWHEEL_FLIPPED +is defined, the direction of x and y will be opposite.

      +

      TEXTEDITING event is triggered when a user activates an input method via hotkey or selecting an +input method in a GUI and starts typing

      +

      The which attribute for AUDIODEVICE* events is an integer representing the index for new audio +devices that are added. AUDIODEVICE* events are used to update audio settings or device list.


      -

      Here is a list of the new window events.

      -

      All window events have a window attribute corresponding to the -pygame.WindowPygame object that represents a window. that generated them.

      -
      Event type             Short description and additional attributes
      +

      Many new events were introduced in pygame 2.

      +

      pygame can recognize text or files dropped in its window. If a file +is dropped, DROPFILE event will be sent, file will be its path. +The DROPTEXT event is only supported on X11.

      +

      MIDIIN and MIDIOUT are events reserved for pygame.midipygame module for interacting with midi input and output. use. +MIDI* events differ from AUDIODEVICE* events in that AUDIODEVICE +events are triggered when there is a state change related to an audio +input/output device.

      +

      pygame 2 also supports controller hot-plugging

      +
      Event name               Attributes and notes
      +
      +DROPFILE                 file
      +DROPBEGIN                (SDL backend >= 2.0.5)
      +DROPCOMPLETE             (SDL backend >= 2.0.5)
      +DROPTEXT                 text (SDL backend >= 2.0.5)
      +MIDIIN
      +MIDIOUT
      +CONTROLLERDEVICEADDED    device_index
      +JOYDEVICEADDED           device_index
      +CONTROLLERDEVICEREMOVED  instance_id
      +JOYDEVICEREMOVED         instance_id
      +CONTROLLERDEVICEREMAPPED instance_id
      +KEYMAPCHANGED            (SDL backend >= 2.0.4)
      +CLIPBOARDUPDATE
      +RENDER_TARGETS_RESET     (SDL backend >= 2.0.2)
      +RENDER_DEVICE_RESET      (SDL backend >= 2.0.4)
      +LOCALECHANGED            (SDL backend >= 2.0.14)
      +
      +
      +

      Also in this version, instance_id attributes were added to joystick events, +and the joy attribute was deprecated.

      +

      KEYMAPCHANGED is a type of an event sent when keymap changes due to a +system event such as an input language or keyboard layout change.

      +

      CLIPBOARDUPDATE is an event sent when clipboard changes. This can still +be considered as an experimental feature, some kinds of clipboard changes might +not trigger this event.

      +

      LOCALECHANGED is an event sent when user locale changes

      +
      +

      New in pygame 2.0.0.

      +
      +
      +

      New in pygame 2.1.3: KEYMAPCHANGED, CLIPBOARDUPDATE, +RENDER_TARGETS_RESET, RENDER_DEVICE_RESET and LOCALECHANGED

      +
      +
      +

      +
      +

      Since pygame 2.0.1, there are a new set of events, called window events. +Here is a list of all window events, along with a short description

      +
      Event type                Short description
       
       WINDOWSHOWN            Window became shown
       WINDOWHIDDEN           Window became hidden
       WINDOWEXPOSED          Window got updated by some external event
      -WINDOWMOVED            Window got moved        (x, y attributes)
      -WINDOWSIZECHANGED      Window size has changed (x, y attributes)
      -WINDOWRESIZED          Window got resized by the user/window manager
      -                        (x, y attributes)
      +WINDOWMOVED            Window got moved
      +WINDOWRESIZED          Window got resized
      +WINDOWSIZECHANGED      Window changed its size
       WINDOWMINIMIZED        Window was minimized
       WINDOWMAXIMIZED        Window was maximized
       WINDOWRESTORED         Window was restored
      @@ -346,51 +385,37 @@ pygame was built on a version lower than that, the WINDOWFOCUSGAINED      Window gained focus
       WINDOWFOCUSLOST        Window lost focus
       WINDOWCLOSE            Window was closed
      -WINDOWTAKEFOCUS        Window was offered focus
      -WINDOWHITTEST          Window has a special hit test
      -WINDOWICCPROFCHANGED   Window ICC profile changed
      -                        (SDL backend >= 2.0.18)
      -WINDOWDISPLAYCHANGED   Window moved on a new display (display_index
      -                        attribute. SDL backend >= 2.0.18)
      +WINDOWTAKEFOCUS        Window was offered focus (SDL backend >= 2.0.5)
      +WINDOWHITTEST          Window has a special hit test (SDL backend >= 2.0.5)
      +WINDOWICCPROFCHANGED   Window ICC profile changed (SDL backend >= 2.0.18)
      +WINDOWDISPLAYCHANGED   Window moved on a new display (SDL backend >= 2.0.18)
       
      +

      WINDOWMOVED, WINDOWRESIZED and WINDOWSIZECHANGED have x and +y attributes, WINDOWDISPLAYCHANGED has a display_index attribute. +All windowevents have a window attribute.

      +
      +

      New in pygame 2.0.1.

      +
      +
      +

      New in pygame 2.1.3: WINDOWICCPROFCHANGED and WINDOWDISPLAYCHANGED

      +

      -

      On Android, the following events can be generated:

      -
      Event type                Short description
      +

      On Android, the following events can be generated

      +
      Event type                 Short description
       
       APP_TERMINATING           OS is terminating the application
      -APP_LOWMEMORY             OS is low on memory (try to free memory)
      +APP_LOWMEMORY             OS is low on memory, try to free memory if possible
       APP_WILLENTERBACKGROUND   Application is entering background
       APP_DIDENTERBACKGROUND    Application entered background
       APP_WILLENTERFOREGROUND   Application is entering foreground
       APP_DIDENTERFOREGROUND    Application entered foreground
       
      -
      -

      -
      -
      -

      Changed in pygame 2.0.0: The joy attribute was deprecated, instance_id was added.

      -
      -
      -

      New in pygame 2.0.1: Window events and the unicode attribute for KEYUP events.

      -
      -
      -

      New in pygame 2.0.2: The touch attribute was added to all the MOUSE events.

      -
      -

      New in pygame-ce 2.1.3: Android events, precise_x and precise_y to MOUSEWHEEL events, -KEYMAPCHANGED, CLIPBOARDUPDATE, LOCALECHANGED, WINDOWICCPROFCHANGED, -WINDOWDISPLAYCHANGED, RENDER_TARGETS_RESET, and RENDER_DEVICE_RESET.

      -
      -
      -

      New in pygame-ce 2.5.7: The clicks attribute was added to MOUSEBUTTONDOWN -and MOUSEBUTTONUP events.

      -
      -
      -

      New in pygame-ce 2.5.8: The pos attribute was added to MOUSEWHEEL events.

      +

      New in pygame 2.1.3.


      @@ -415,7 +440,7 @@ you fail to make a call to the event queue for too long, the system may decide your program has locked up.

      Caution

      -

      This function should only be called in the thread that initialized pygame.displayPygame module to control the display window and screen..

      +

      This function should only be called in the thread that initialized pygame.displaypygame module to control the display window and screen.

      @@ -438,10 +463,10 @@ None.

      If you are only taking specific events from the queue, be aware that the queue could eventually fill up with the events you are not interested.

      If pump is True (the default), then pygame.event.pump()internally process pygame event handlers will be called.

      -
      +

      Changed in pygame 1.9.5: Added pump argument

      -
      +

      Changed in pygame 2.0.2: Added exclude argument

      @@ -458,7 +483,7 @@ of type pygame.NOEV is removed from the queue.

      Caution

      -

      This function should only be called in the thread that initialized pygame.displayPygame module to control the display window and screen..

      +

      This function should only be called in the thread that initialized pygame.displaypygame module to control the display window and screen.

      @@ -477,12 +502,12 @@ if no events enter the queue in -
      +

      Changed in pygame 2.0.0.dev13: Added timeout argument

      Caution

      -

      This function should only be called in the thread that initialized pygame.displayPygame module to control the display window and screen..

      +

      This function should only be called in the thread that initialized pygame.displaypygame module to control the display window and screen.

      @@ -497,14 +522,9 @@ system with other applications.

      Returns True if there are any events of the given type waiting on the queue. If a sequence of event types is passed, this will return True if any of those events are on the queue.

      -

      When eventtype is not passed or None, this function will return True if -there's any event on the queue, and return False if the queue is empty.

      If pump is True (the default), then pygame.event.pump()internally process pygame event handlers will be called.

      -
      -

      Changed in pygame 1.9.5: Added pump argument

      -
      -

      Changed in pygame-ce 2.5.3: no longer mistakenly returns an event when eventtype is None or not passed.

      +

      Changed in pygame 1.9.5: Added pump argument

      @@ -520,7 +540,7 @@ there's any event on the queue, and return pygame.event.get()get events from the queue except None is returned. It can be slightly more efficient when clearing a full event queue.

      If pump is True (the default), then pygame.event.pump()internally process pygame event handlers will be called.

      -
      +

      Changed in pygame 1.9.5: Added pump argument

      @@ -530,21 +550,24 @@ is returned. It can be slightly more efficient when clearing a full event queue. pygame.event.event_name()
      get the string name from an event id
      -
      event_name(type, /) -> string
      +
      event_name(type) -> string

      Returns a string representing the name (in CapWords style) of the given event type.

      "UserEvent" is returned for all values in the user event id range. "Unknown" is returned when the event type does not exist.

      +
      +

      Changed in pygame 2.5.0: Added support for keyword arguments.

      +
      pygame.event.set_blocked()
      -
      control which events are blocked on the queue
      -
      set_blocked(type, /) -> None
      -
      set_blocked(typelist, /) -> None
      +
      control which events are allowed on the queue
      +
      set_blocked(type) -> None
      +
      set_blocked(typelist) -> None
      set_blocked(None) -> None

      The given event types are not allowed to appear on the event queue. By @@ -559,8 +582,8 @@ from being placed on the queue.

      pygame.event.set_allowed()
      control which events are allowed on the queue
      -
      set_allowed(type, /) -> None
      -
      set_allowed(typelist, /) -> None
      +
      set_allowed(type) -> None
      +
      set_allowed(typelist) -> None
      set_allowed(None) -> None

      The given event types are allowed to appear on the event queue. By default, @@ -575,8 +598,8 @@ to be placed on the queue.

      pygame.event.get_blocked()
      test if a type of event is blocked from the queue
      -
      get_blocked(type, /) -> bool
      -
      get_blocked(typelist, /) -> bool
      +
      get_blocked(type) -> bool
      +
      get_blocked(typelist) -> bool

      Returns True if the given event type is blocked from the queue. If a sequence of event types is passed, this will return True if any of those @@ -588,7 +611,7 @@ event types are blocked.

      pygame.event.set_grab()
      control the sharing of input devices with other applications
      -
      set_grab(bool, /) -> None
      +
      set_grab(bool) -> None

      When your program runs in a windowed environment, it will share the mouse and keyboard devices with other applications that have focus. If your @@ -608,24 +631,47 @@ doing other things on their system.

      Returns True when the input events are grabbed for this application.

      +
      +
      +pygame.event.set_keyboard_grab()
      +
      +
      grab enables capture of system keyboard shortcuts like Alt+Tab or the Meta/Super key.
      +
      set_keyboard_grab(bool) -> None
      +
      +

      Keyboard grab enables capture of system keyboard shortcuts like Alt+Tab or the Meta/Super key. +Note that not all system keyboard shortcuts can be captured by applications (one example is Ctrl+Alt+Del on Windows). +This is primarily intended for specialized applications such as VNC clients or VM frontends. Normal games should not use keyboard grab.

      +
      +

      New in pygame 2.5.0.

      +
      +
      + +
      +
      +pygame.event.get_keyboard_grab()
      +
      +
      get the current keyboard grab state
      +
      get_keyboard_grab() -> bool
      +
      +

      Returns True when keyboard grab is enabled.

      +
      +

      New in pygame 2.5.0.

      +
      +
      +
      pygame.event.post()
      place a new event on the queue
      -
      post(event, /) -> bool
      +
      post(Event) -> bool

      Places the given event at the end of the event queue.

      This is usually used for placing custom events on the event queue. Any type of event can be posted, and the events posted can have any attributes.

      -

      When this event is received on the event queue, it will be a shallow copy of -the event object posted by this function; the dict attribute of both events -will be a reference to the same dict object in memory. Modifications on one -dict can affect another, use deepcopy operations on the dict object if you -don't want this behaviour.

      This returns a boolean on whether the event was posted or not. Blocked events cannot be posted, and this function returns False if you try to post them.

      -
      +

      Changed in pygame 2.0.1: returns a boolean, previously returned None

      @@ -637,9 +683,9 @@ cannot be posted, and this function returns make custom user event type
      custom_type() -> int
      -

      Reserves an event slot for use in a custom event userevent and returns the integer that the event slot is reserved to.

      +

      Reserves a pygame.USEREVENT for a custom use.

      If too many events are made a pygame.errorstandard pygame exception is raised.

      -
      +

      New in pygame 2.0.0.dev3.

      @@ -670,10 +716,6 @@ cannot be posted, and this function returns -

      Changed in pygame-ce 2.1.4: This class is also available through the pygame.Event -alias.

      -

      Note

      From version 2.1.3 EventType is an alias for Event. Beforehand, @@ -690,7 +732,7 @@ the latter could be deprecated in a future version.

      Read-only. The event type identifier. For user created event objects, this is the type argument passed to -pygame.event.Event()pygame object for representing events.

      +pygame.event.Event()pygame object for representing events.

      For example, some predefined event identifiers are QUIT and MOUSEMOTION.

      @@ -708,7 +750,7 @@ objects, this is the key, and mod

      -
      +

      New in pygame 1.9.2: Mutable attributes.

      @@ -720,7 +762,7 @@ objects, this is the Edit on GitHub +Edit on GitHub
      @@ -741,12 +783,14 @@ objects, this is the previous |
    • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/examples.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/examples.html index 0348e1c..6e2061c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/examples.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/examples.html @@ -5,18 +5,16 @@ - pygame.examples — pygame-ce v2.5.8 documentation - - - - - + pygame.examples — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
      @@ -265,7 +255,7 @@ called (see below). Finally, the easiest way is to use the python -m option:

      pygame/examples/data subdirectory.

      You can find where the example files are installed by using the following commands inside the python interpreter.

      -
      >>> import pygame.examples.scaletest
      +
      >>> import pygame.examples.scaletest
       >>> pygame.examples.scaletest.__file__
       '/usr/lib/python2.6/site-packages/pygame/examples/scaletest.py'
       
      @@ -274,7 +264,7 @@ commands inside the python interpreter.

      For example on Windows it might be in 'C:/Python26/Lib/site-packages/pygame/examples/' On Mac OS X it might be in '/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/site-packages/pygame/examples/'

      You can also run the examples in the python interpreter by calling each modules main() function.

      -
      >>> import pygame.examples.scaletest
      +
      >>> import pygame.examples.scaletest
       >>> pygame.examples.scaletest.main()
       
      @@ -353,7 +343,7 @@ render fonts with the font module

      freetype_misc.main() -> None

      A showcase of rendering features the pygame.freetype.FontCreate a new Font instance from a supported font file. -class provides in addition to those available with pygame.font.FontCreate a new Font object from a file.. +class provides in addition to those available with pygame.font.Fontcreate a new Font object from a file. It is a demonstration of direct to surface rendering, with vertical text and rotated text, opaque text and semi transparent text, horizontally stretched text and vertically stretched text.

      @@ -513,8 +503,8 @@ lots of sprites moving around.

      How to use pygame with no windowing system, like on headless servers.

      Thumbnail generation with scaling is an example of what you can do with pygame.

      -

      NOTE: the pygame scale function uses SIMD acceleration if available, -and can be run in multiple threads.

      +

      NOTE: the pygame scale function uses MMX/SSE if available, and can be +run in multiple threads.

      If headless_no_windows_needed.py is run as a program it takes the following command line arguments:

      -scale inputimage outputimage new_width new_height
      @@ -531,7 +521,7 @@ following command line arguments:

      joystick.main() -> None

      A demo showing full joystick support.

      -
      +

      New in pygame 2.0.2.

      @@ -679,7 +669,7 @@ be paused and rewound to the beginning.




      -Edit on GitHub +Edit on GitHub
      @@ -695,17 +685,19 @@ be paused and rewound to the beginning.

      modules |
    • - next |
    • previous |
    • - - + + + +
      \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/font.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/font.html index f2858d5..e1d99c9 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/font.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/font.html @@ -5,19 +5,17 @@ - pygame.font — pygame-ce v2.5.8 documentation - - - - - + pygame.font — pygame v2.6.1 documentation + + + + - - +
      @@ -25,30 +23,24 @@
      @@ -114,47 +104,47 @@
      —Initialize the font module.initialize the font module
      —Uninitialize the font module.uninitialize the font module
      —True if the font module is initialized.true if the font module is initialized
      —Get the filename of the default font.get the filename of the default font
      —Gets SDL_ttf version.gets SDL_ttf version
      —Get all available fonts.get all available fonts
      —Find a specific font on the system.find a specific font on the system
      —Create a Font object from the system fonts.create a Font object from the system fonts
      —Create a new Font object from a file.create a new Font object from a file
      @@ -163,8 +153,8 @@ This module is built on top of the SDL_ttf library, which comes with all normal pygame installations.

      Most of the work done with fonts are done by using the actual Font objects. The module by itself only has routines to support the creation of Font objects -with pygame.font.Font()Create a new Font object from a file..

      -

      You can load fonts from the system by using the pygame.font.SysFont()Create a Font object from the system fonts. +with pygame.font.Font()create a new Font object from a file.

      +

      You can load fonts from the system by using the pygame.font.SysFont()create a Font object from the system fonts function. There are a few other functions to help look up the system fonts.

      Pygame comes with a builtin default font, freesansbold. This can always be accessed by passing None as the font name.

      @@ -174,7 +164,7 @@ accessed by passing Font.render().

      Before pygame 2.0.3, this character space restriction can be avoided by -using the pygame.freetypepygame module for loading and rendering computer fonts based pygame.ftfont to emulate the Font +using the pygame.freetypeEnhanced pygame module for loading and rendering computer fonts based pygame.ftfont to emulate the Font module. This can be used by defining the environment variable PYGAME_FREETYPE before the first import of pygamethe top level pygame package. Since the problem pygame.ftfont solves no longer exists, it will likely be removed in the future.

      @@ -182,7 +172,7 @@ solves no longer exists, it will likely be removed in the future.

      pygame.font.init()
      -
      Initialize the font module.
      +
      initialize the font module
      init() -> None

      This method is called automatically by pygame.init(). It initializes the @@ -195,20 +185,19 @@ work.

      pygame.font.quit()
      -
      Uninitialize the font module.
      +
      uninitialize the font module
      quit() -> None

      Manually uninitialize SDL_ttf's font system. This is called automatically by pygame.quit().

      It is safe to call this function even if font is currently not initialized.

      -

      Previously created font objects will be invalid after the font module is quit.

      pygame.font.get_init()
      -
      True if the font module is initialized.
      +
      true if the font module is initialized
      get_init() -> bool

      Test if the font module is initialized or not.

      @@ -218,8 +207,8 @@ work.

      pygame.font.get_default_font()
      -
      Get the filename of the default font.
      -
      get_default_font() -> str
      +
      get the filename of the default font
      +
      get_default_font() -> string

      Return the filename of the system font. This is not the full path to the file. This file can usually be found in the same directory as the font @@ -230,16 +219,18 @@ module, but it can also be bundled in separate archives.

      pygame.font.get_sdl_ttf_version()
      -
      Gets SDL_ttf version.
      -
      get_sdl_ttf_version(linked=True) -> tuple[int, int, int]
      +
      gets SDL_ttf version
      +
      get_sdl_ttf_version(linked=True) -> (major, minor, patch)
      -

      Returns a tuple of integers that identify SDL_ttf's version, -(major, minor, patch). SDL_ttf is the underlying font rendering library, -written in C, on which pygame's font module depends. If 'linked' is True -(the default), the function returns the version of the linked TTF library. -Otherwise this function returns the version of TTF pygame was compiled with.

      +

      Experimental: feature still in development available for testing and feedback. It may change. +Please leave get_sdl_ttf_version feedback with authors

      +

      Returns a tuple of integers that identify SDL_ttf's version. +SDL_ttf is the underlying font rendering library, written in C, +on which pygame's font module depends. If 'linked' is True (the default), +the function returns the version of the linked TTF library. +Otherwise this function returns the version of TTF pygame was compiled with

      -

      New in pygame-ce 2.1.3.

      +

      New in pygame 2.1.3.

      @@ -247,15 +238,15 @@ Otherwise this function returns the version of TTF pygame was compiled with.

      pygame.font.get_fonts()
      -
      Get all available fonts.
      -
      get_fonts() -> list[str]
      +
      get all available fonts
      +
      get_fonts() -> list of strings

      Returns a list of all the fonts available on the system. The names of the fonts will be set to lowercase with all spaces and punctuation removed. This works on most systems, but some will return an empty list if they cannot find fonts.

      -

      Changed in pygame-ce 2.1.3: Checks through user fonts instead of just global fonts for Windows.

      +

      Changed in pygame 2.1.3: Checks through user fonts instead of just global fonts for Windows.

      @@ -263,8 +254,8 @@ find fonts.

      pygame.font.match_font()
      -
      Find a specific font on the system.
      -
      match_font(name, bold=False, italic=False) -> str | None
      +
      find a specific font on the system
      +
      match_font(name, bold=False, italic=False) -> path

      Returns the full path to a font file on the system. If bold or italic are set to true, this will attempt to find the correct family of font.

      @@ -272,15 +263,16 @@ set to true, this will attempt to find the correct family of font.

      comma-separated font names, or a bytes of comma-separated font names, in which case the set of names will be searched in order. If none of the given names are found, None is returned.

      -
      +

      New in pygame 2.0.1: Accept an iterable of font names.

      -

      Changed in pygame-ce 2.1.3: Checks through user fonts instead of just global fonts for Windows.

      +

      Changed in pygame 2.1.3: Checks through user fonts instead of just global fonts for Windows.

      Example:

      -
      >>> pygame.font.match_font('Arial')
      -'C:\WINDOWS\Fonts\arial.ttf'
      +
      print pygame.font.match_font('bitstreamverasans')
      +# output is: /usr/share/fonts/truetype/ttf-bitstream-vera/Vera.ttf
      +# (but only if you have Vera on your system)
       
      @@ -289,7 +281,7 @@ If none of the given names are found, None is returned.

      pygame.font.SysFont()
      -
      Create a Font object from the system fonts.
      +
      create a Font object from the system fonts
      SysFont(name, size, bold=False, italic=False) -> Font

      Return a new Font object that is loaded from the system fonts. The font will @@ -300,11 +292,11 @@ fall back on loading the default pygame font.

      The font name can also be an iterable of font names, a string of comma-separated font names, or a bytes of comma-separated font names, in which case the set of names will be searched in order.

      -
      +

      New in pygame 2.0.1: Accept an iterable of font names.

      -

      Changed in pygame-ce 2.1.3: Checks through user fonts instead of just global fonts for Windows.

      +

      Changed in pygame 2.1.3: Checks through user fonts instead of just global fonts for Windows.

      @@ -312,9 +304,9 @@ which case the set of names will be searched in order.

      pygame.font.Font
      -
      Create a new Font object from a file.
      -
      Font(filename=None, size=20) -> Font
      -
      Font(filename, size) -> Font
      +
      create a new Font object from a file
      +
      Font(file_path=None, size=12) -> Font
      +
      Font(file_path, size) -> Font
      Font(pathlib.Path, size) -> Font
      Font(object, size) -> Font
      @@ -325,16 +317,6 @@ which case the set of names will be searched in order.

    — Gets or sets whether the font should be rendered in (faked) bold.
    -—Gets the font's name.
    -—Gets the font's style_name.
    — — Gets or sets whether the font should be rendered with a strikethrough.
    +
    —Gets or sets how rendered text is aligned when given a wrap length.draw text on a new Surface
    +
    —Gets or sets the font's point size.determine the amount of space needed to render text
    +
    —Gets or sets the font's outline thickness (pixels).control if text is rendered with an underline
    +
    —Draw text on a new Surface.check if text will be rendered with an underline
    +
    —Determine the amount of space needed to render text.control if text is rendered with a strikethrough
    +
    —Control if text is rendered with an underline.check if text will be rendered with a strikethrough
    +
    —Check if text will be rendered with an underline.enable fake rendering of bold text
    +
    —Control if text is rendered with a strikethrough.check if text will be rendered bold
    +
    —Check if text will be rendered with a strikethrough.enable fake rendering of italic text
    +
    —Enable fake rendering of bold text.gets the metrics for each character in the passed string
    +
    —Check if text will be rendered bold.check if the text will be rendered italic
    +
    —Enable fake rendering of italic text.
    -—Gets the metrics for each character in the passed string.
    -—Check if the text will be rendered italic.
    -—Get the line space of the font text.
    -—Set the line space of the font text.get the line space of the font text
    —Get the height of the font.
    -—Set the point size of the font.
    -—Get the point size of the font.get the height of the font
    —Get the ascent of the font.get the ascent of the font
    —Get the descent of the font.get the descent of the font
    —Set the script code for text shaping.
    -—Set the script direction for text shaping.set the script code for text shaping
    @@ -471,18 +418,11 @@ which case the set of names will be searched in order.

    the height of the font in pixels. If the filename is None the pygame default font will be loaded. If a font cannot be loaded from the arguments given an exception will be raised. Once the font is created the size cannot -be changed.

    +be changed. If no arguments are given then the default font will be used and +a font size of 12 is used.

    Font objects are mainly used to render text into new Surface objects. The render can emulate bold or italic features, but it is better to load from a font with actual italic or bold glyphs.

    -
    -

    Changed in pygame-ce 2.1.4: If no arguments are given then the default font will be used and -a font size of 20 is used.

    -
    -
    -

    Changed in pygame-ce 2.1.4: This class is also available through the pygame.Font -alias.

    -
    bold
    @@ -497,43 +437,11 @@ font types. If possible load the font from a real bold font file. While bold, the font will have a different width than when normal. This can be mixed with the italic, underline and strikethrough modes.

    -
    +

    New in pygame 2.0.0.

    -
    -
    -name
    -
    -
    Gets the font's name.
    -
    name -> str
    -
    -

    Read only. Returns the font's name.

    -
    -

    New in pygame-ce 2.2.

    -
    -
    - -
    -
    -style_name
    -
    -
    Gets the font's style_name.
    -
    style_name -> str
    -
    -

    Read only. Returns the font's style name. Style names are arbitrary, can be an empty string. -Here are some examples:

    -
    -

    'Black', 'Bold', 'Bold Italic', 'BoldOblique', 'Book', 'BookOblique', 'Condensed', 'Condensed Oblique', -'ExtraLight', 'Italic', 'Light', 'LightOblique', 'Medium', 'MediumOblique', 'Oblique', 'Regular', -'Semibold', 'Semilight', 'Slanted'

    -
    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    -
    italic
    @@ -548,7 +456,7 @@ on many font types. If possible load the font from a real italic font file. While italic the font will have a different width than when normal. This can be mixed with the bold, underline and strikethrough modes.

    -
    +

    New in pygame 2.0.0.

    @@ -565,7 +473,7 @@ strikethrough modes.

    underline. The underline is always one pixel thick, regardless of font size. This can be mixed with the bold, italic and strikethrough modes.

    -
    +

    New in pygame 2.0.0.

    @@ -583,76 +491,7 @@ strikethrough. The strikethrough is always one pixel thick, regardless of font size. This can be mixed with the bold, italic and underline modes.

    -

    New in pygame-ce 2.1.3.

    -
    - - -
    -
    -align
    -
    -
    Gets or sets how rendered text is aligned when given a wrap length.
    -
    align -> int
    -
    -

    Can be set to pygame.FONT_LEFT, pygame.FONT_RIGHT, or -pygame.FONT_CENTER. This controls the text alignment behavior for the -font. Defaults to pygame.FONT_LEFT.

    -

    Requires pygame built with SDL_ttf 2.20.0, as all official pygame -distributions are.

    -
    -

    New in pygame-ce 2.1.4.

    -
    -
    - -
    -
    -point_size
    -
    -
    Gets or sets the font's point size.
    -
    point_size -> int
    -
    -

    Returns the point size of the font. Will not be accurate upon initializing -the font object when the font name is initialized as None.

    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    - -
    -
    -outline
    -
    -
    Gets or sets the font's outline thickness (pixels).
    -
    outline -> int
    -
    -

    The outline value of the font.

    -

    When set to 0, the font will be drawn normally. When positive, -the text will be drawn as a hollow outline. The outline grows in all -directions a number of pixels equal to the value set. Negative values -are not allowed.

    -

    This can be drawn underneath unoutlined text to create a text outline -effect. For example:

    -
    def render_outlined(
    -    font: pygame.Font,
    -    text: str,
    -    text_color: pygame.typing.ColorLike,
    -    outline_color: pygame.typing.ColorLike,
    -    outline_width: int,
    -) -> pygame.Surface:
    -    old_outline = font.outline
    -    if old_outline != 0:
    -        font.outline = 0
    -    base_text_surf = font.render(text, True, text_color)
    -    font.outline = outline_width
    -    outlined_text_surf = font.render(text, True, outline_color)
    -
    -    outlined_text_surf.blit(base_text_surf, (outline_width, outline_width))
    -    font.outline = old_outline
    -    return outlined_text_surf
    -
    -
    -
    -

    New in pygame-ce 2.5.7.

    +

    New in pygame 2.1.3.

    @@ -660,26 +499,24 @@ effect. For example:

    render()
    -
    Draw text on a new Surface.
    -
    render(text, antialias, color, bgcolor=None, wraplength=0) -> Surface
    +
    draw text on a new Surface
    +
    render(text, antialias, color, background=None) -> Surface

    This creates a new Surface with the specified text rendered on it. pygame.fontpygame module for loading and rendering fonts provides no way to directly draw text on an existing Surface: instead you must use Font.render() to create an image (Surface) of the text, then blit this image onto another Surface.

    -

    Null characters ('x00') raise a TypeError. Both Unicode and char (byte) +

    The text can only be a single line: newline characters are not rendered. +Null characters ('x00') raise a TypeError. Both Unicode and char (byte) strings are accepted. For Unicode strings only UCS-2 characters ('\u0001' to '\uFFFF') were previously supported and any greater unicode codepoint would raise a UnicodeError. Now, characters in the UCS-4 range are supported. For char strings a LATIN1 encoding is assumed. The antialias argument is a boolean: if True the characters will have smooth edges. The color argument is the color of the text -[e.g.: (0,0,255) for blue]. The optional bgcolor argument is a color -to use for the text background. If bgcolor is None the area outside -the text will be transparent.

    -

    The wraplength argument describes the width (in pixels) a line of text -should be before wrapping to a new line. See -pygame.font.Font.alignGets or sets how rendered text is aligned when given a wrap length. for line-alignment settings.

    +[e.g.: (0,0,255) for blue]. The optional background argument is a color +to use for the text background. If no background is passed the area +outside the text will be transparent.

    The Surface returned will be of the dimensions required to hold the text. (the same as those returned by Font.size()). If an empty string is passed for the text, a blank surface will be returned that is zero pixel wide and @@ -696,37 +533,28 @@ screen) will always have a solid background, and the text is antialiased, you can improve performance by specifying the background color. This will cause the resulting image to maintain transparency information by colorkey rather than (much less efficient) alpha values.

    +

    If you render '\n' an unknown char will be rendered. Usually a +rectangle. Instead you need to handle newlines yourself.

    Font rendering is not thread safe: only a single thread can render text at any time.

    -
    +

    Changed in pygame 2.0.3: Rendering UCS4 unicode works and does not raise an exception. Use if hasattr(pygame.font, "UCS4"): to see if pygame supports rendering UCS4 unicode including more languages and emoji.

    -
    -

    Changed in pygame-ce 2.1.4: newline characters now will break text into -multiple lines.

    -
    -
    -

    New in pygame-ce 2.1.4: wraplength parameter

    -
    -
    -

    Changed in pygame-ce 2.3.0: now supports keyword arguments.

    -
    size()
    -
    Determine the amount of space needed to render text.
    -
    size(text, /) -> tuple[int, int]
    +
    determine the amount of space needed to render text
    +
    size(text) -> (width, height)
    -

    Returns the dimensions (width, height) needed to render the text. -This can be used to help determine the positioning needed for text -before it is rendered. It can also be used for word wrapping and other -layout effects.

    +

    Returns the dimensions needed to render the text. This can be used to +help determine the positioning needed for text before it is rendered. It +can also be used for word wrapping and other layout effects.

    Be aware that most fonts use kerning which adjusts the widths for specific letter pairs. For example, the width for "ae" will not always match the width for "a" + "e".

    @@ -736,8 +564,8 @@ match the width for "a" + "e".

    set_underline()
    -
    Control if text is rendered with an underline.
    -
    set_underline(value, /) -> None
    +
    control if text is rendered with an underline
    +
    set_underline(bool) -> None

    When enabled, all rendered fonts will include an underline. The underline is always one pixel thick, regardless of font size. This can be mixed @@ -752,22 +580,24 @@ with the bold, italic and strikethrough modes.

    get_underline()
    -
    Check if text will be rendered with an underline.
    +
    check if text will be rendered with an underline
    get_underline() -> bool

    Return True when the font underline is enabled.

    -
    +
    +

    Note

    This is the same as the underline attribute.

    +
    set_strikethrough()
    -
    Control if text is rendered with a strikethrough.
    -
    set_strikethrough(value, /) -> None
    +
    control if text is rendered with a strikethrough
    +
    set_strikethrough(bool) -> None

    When enabled, all rendered fonts will include a strikethrough. The strikethrough is always one pixel thick, regardless of font size. @@ -777,7 +607,7 @@ This can be mixed with the bold, italic and underline modes.

    This is the same as the strikethrough attribute.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -785,25 +615,27 @@ This can be mixed with the bold, italic and underline modes.

    get_strikethrough()
    -
    Check if text will be rendered with a strikethrough.
    +
    check if text will be rendered with a strikethrough
    get_strikethrough() -> bool

    Return True when the font strikethrough is enabled.

    -
    +
    +

    Note

    This is the same as the strikethrough attribute.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    +
    set_bold()
    -
    Enable fake rendering of bold text.
    -
    set_bold(value, /) -> None
    +
    enable fake rendering of bold text
    +
    set_bold(bool) -> None

    Enables the bold rendering of text. This is a fake stretching of the font that doesn't look good on many font types. If possible load the font from @@ -820,7 +652,7 @@ strikethrough modes.

    get_bold()
    -
    Check if text will be rendered bold.
    +
    check if text will be rendered bold
    get_bold() -> bool

    Return True when the font bold rendering mode is enabled.

    @@ -834,8 +666,8 @@ strikethrough modes.

    set_italic()
    -
    Enable fake rendering of italic text.
    -
    set_italic(value, /) -> None
    +
    enable fake rendering of italic text
    +
    set_italic(bool) -> None

    Enables fake rendering of italic text. This is a fake skewing of the font that doesn't look good on many font types. If possible load the font from @@ -852,8 +684,8 @@ strikethrough modes.

    metrics()
    -
    Gets the metrics for each character in the passed string.
    -
    metrics(text, /) -> list
    +
    gets the metrics for each character in the passed string
    +
    metrics(text) -> list

    The list contains tuples for each character, which contain the minimum X offset, the maximum X offset, the minimum Y offset, the @@ -861,17 +693,13 @@ maximum Y -

    -

    Changed in pygame-ce 2.5.4: This function now supports all unicode codepoints. -Previously, only a subset that was representable in UCS-2 was supported.

    -
    get_italic()
    -
    Check if the text will be rendered italic.
    +
    check if the text will be rendered italic
    get_italic() -> bool

    Return True when the font italic rendering mode is enabled.

    @@ -885,82 +713,30 @@ Previously, only a subset that was representable in UCS-2 was supported.

    get_linesize()
    -
    Get the line space of the font text.
    +
    get the line space of the font text
    get_linesize() -> int

    Return the height in pixels for a line of text with the font. When rendering multiple lines of text this is the recommended amount of space between lines.

    -

    See also set_linesize().

    -
    - -
    -
    -set_linesize()
    -
    -
    Set the line space of the font text.
    -
    set_linesize(linesize, /) -> None
    -
    -

    Set the height in pixels for a line of text with the font. When rendering -multiple lines of text this refers to the amount of space between lines. -The value must be non-negative.

    -

    See also get_linesize().

    -
    -

    New in pygame-ce 2.5.4.

    -
    get_height()
    -
    Get the height of the font.
    +
    get the height of the font
    get_height() -> int

    Return the height in pixels of the actual rendered text. This is the average size for each glyph in the font.

    -
    -
    -set_point_size()
    -
    -
    Set the point size of the font.
    -
    set_point_size(val, /) -> None
    -
    -
    -

    Note

    -

    This is the same as the point_size attribute.

    -
    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    - -
    -
    -get_point_size()
    -
    -
    Get the point size of the font.
    -
    get_point_size() -> int
    -
    -

    Returns the point size of the font. Will not be accurate upon -initializing the font object when the font name is initialized -as None.

    -
    -

    Note

    -

    This is the same as the point_size attribute.

    -
    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    -
    get_ascent()
    -
    Get the ascent of the font.
    +
    get the ascent of the font
    get_ascent() -> int

    Return the height in pixels for the font ascent. The ascent is the number @@ -971,7 +747,7 @@ of pixels from the font baseline to the top of the font.

    get_descent()
    -
    Get the descent of the font.
    +
    get the descent of the font
    get_descent() -> int

    Return the height in pixels for the font descent. The descent is the @@ -982,45 +758,19 @@ number of pixels from the font baseline to the bottom of the font.

    set_script()
    -
    Set the script code for text shaping.
    -
    set_script(script_code, /) -> None
    +
    set the script code for text shaping
    +
    set_script(str) -> None
    -

    Sets the script used by HarfBuzz text shaping, taking a 4 character +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave feedback with authors

    +

    Sets the script used by harfbuzz text shaping, taking a 4 character script code as input. For example, Hindi is written in the Devanagari script, for which the script code is "Deva". See the full list of script codes in ISO 15924.

    This method requires pygame built with SDL_ttf 2.20.0 or above. Otherwise the method will raise a pygame.error.

    -

    New in pygame-ce 2.1.4.

    -
    -
    - -
    -
    -set_direction()
    -
    -
    Set the script direction for text shaping.
    -
    set_direction(direction) -> None
    -
    -

    Sets the font direction for HarfBuzz text rendering, taking in an integer -between 0 and 3 (inclusive) as input. There are convenient constants defined -for use in this method.

    -
      -
    • pygame.DIRECTION_LTR is for left-to-right text

    • -
    • pygame.DIRECTION_RTL is for right-to-left text

    • -
    • pygame.DIRECTION_TTB is for top-to-bottom text

    • -
    • pygame.DIRECTION_BTT is for bottom-to-top text

    • -
    -

    This method requires pygame built with SDL_ttf 2.20.0 or above. Otherwise the -method will raise a pygame.error.

    -
    -

    Note

    -

    multiline renders with render() do not play nicely with top-to-bottom -or bottom-to-top rendering.

    -
    -
    -

    New in pygame-ce 2.1.4.

    +

    New in pygame 2.2.0.

    @@ -1033,7 +783,7 @@ or bottom-to-top rendering.




    -Edit on GitHub +Edit on GitHub
    @@ -1052,14 +802,16 @@ or bottom-to-top rendering.

    next |
  • - previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/freetype.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/freetype.html index bcb2c9d..029cfcd 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/freetype.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/freetype.html @@ -5,18 +5,16 @@ - pygame.freetype — pygame-ce v2.5.8 documentation - - - - - + pygame.freetype — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
    @@ -107,7 +97,7 @@
    pygame.freetype
    -
    pygame module for loading and rendering computer fonts
    +
    Enhanced pygame module for loading and rendering computer fonts
    @@ -173,17 +163,14 @@
    -

    The pygame.freetype module is an alternative to pygame.fontpygame module for loading and rendering fonts. -It is implemented directly on the FreeType 2 library, and is not -backward compatible with pygame.fontpygame module for loading and rendering fonts. pygame.fontpygame module for loading and rendering fonts -relies on the SDL_ttf library, and due to the SDL_ttf team's efforts, -pygame.font is now the better supported of our font modules. -In new code, the use of pygame.fontpygame module for loading and rendering fonts is encouraged. -pygame.font, unlike pygame.freetype, has support for multiline text, -text shaping for global writing systems, and rendering emoji with color.

    -

    The pygame.ftfont module exists as a limited version of -the pygame.fontpygame module for loading and rendering fonts API, running on top of pygame.freetype. -Many of the recently added font features do not work on it.

    +

    The pygame.freetype module is a replacement for pygame.fontpygame module for loading and rendering fonts. +It has all of the functionality of the original, plus many new features. +Yet is has absolutely no dependencies on the SDL_ttf library. +It is implemented directly on the FreeType 2 library. +The pygame.freetype module is not itself backward compatible with +pygame.fontpygame module for loading and rendering fonts. +Instead, use the pygame.ftfont module as a drop-in replacement +for pygame.fontpygame module for loading and rendering fonts.

    All font file formats supported by FreeType can be rendered by pygame.freetype, namely TTF, Type1, CFF, OpenType, SFNT, PCF, FNT, BDF, PFR and Type42 fonts. @@ -216,11 +203,11 @@ The freetype automatically when loaded. This module must be imported explicitly to be used.

    -
    import pygame
    -import pygame.freetype
    +
    import pygame
    +import pygame.freetype
     
    -
    +

    New in pygame 1.9.2: freetype

    @@ -249,7 +236,7 @@ returns the compiled version of FreeType.

    It will not compile with the original FreeType 1.0. Hence, the first element of the tuple will always be "2".

    -

    Changed in pygame-ce 2.1.4: linked keyword argument added and default behavior changed from returning compiled version to returning linked version

    +

    Changed in pygame 2.2.0: linked keyword argument added and default behavior changed from returning compiled version to returning linked version

    @@ -295,7 +282,7 @@ initialized yet.

    get_init() -> bool

    Returns True if the pygame.freetype module is currently initialized.

    -
    +

    New in pygame 1.9.5.

    @@ -337,7 +324,7 @@ The default is 72 DPI.

    pygame.freetype.set_default_resolution()
    Set the default pixel size in dots per inch for the module
    -
    set_default_resolution(resolution, /)
    +
    set_default_resolution([resolution])

    Set the default pixel size, in dots per inch, for the module. If the optional argument is omitted or zero the resolution is reset to 72 DPI.

    @@ -358,7 +345,7 @@ this will fall back on loading the default pygame font.

    The font name can also be an iterable of font names, a string of comma-separated font names, or a bytes of comma-separated font names, in which case the set of names will be searched in order.

    -
    +

    New in pygame 2.0.1: Accept an iterable of font names.

    @@ -390,192 +377,187 @@ but can also be bundled in a separate archive.

    — Proper font name. - - -— -Gets the font's style_name. - - + — Font file path - + — The default point size used in rendering - + — Return the size and offset of rendered text - + — Return the glyph metrics for the given text - + — The unscaled height of the font in font units - + — The unscaled ascent of the font in font units - + — The unscaled descent of the font in font units - + — The scaled ascent of the font in pixels - + — The scaled descent of the font in pixels - + — The scaled height of the font in pixels - + — The scaled bounding box height of the font in pixels - + — return the available sizes of embedded bitmaps - + — Return rendered text as a surface - + — Render text onto an existing surface - + — Return rendered text as a string of bytes - + — Render text into an array of ints - + — The font's style flags - + — The state of the font's underline style flag - + — The state of the font's strong style flag - + — The state of the font's oblique style flag - + — The state of the font's wide style flag - + — The strength associated with the strong or wide font styles - + — Adjustment factor for the underline position - + — Gets whether the font is fixed-width - + — the number of available bitmap sizes for the font - + — Gets whether the font is scalable - + — allow the use of embedded bitmaps in an outline font file - + — Font anti-aliasing mode - + — Character kerning mode - + — Font vertical mode - + — text rotation in degrees counterclockwise - + — default foreground color - + — default background color - + — Font render to text origin mode - + — padded boundary mode - + — Enable UCS-4 mode - + — Pixel resolution in dots per inch @@ -614,25 +596,6 @@ to treat Unicode text as UCS-4, with no surrogate pairs. See recorded in the font file.

    -
    -
    -style_name
    -
    -
    Gets the font's style_name.
    -
    style_name -> str
    -
    -

    Read only. Returns the font's style name. Style names are arbitrary, can be an empty string. -Here are some examples:

    -
    -

    'Black', 'Bold', 'Bold Italic', 'BoldOblique', 'Book', 'BookOblique', 'Condensed', 'Condensed Oblique', -'ExtraLight', 'Italic', 'Light', 'LightOblique', 'Medium', 'MediumOblique', 'Oblique', 'Regular', -'Semibold', 'Semilight', 'Slanted'

    -
    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    -
    path
    @@ -759,7 +722,7 @@ bottom of the bounding box.

    get_sized_ascender()
    The scaled ascent of the font in pixels
    -
    get_sized_ascender(size=0, /) -> int
    +
    get_sized_ascender(<size>=0) -> int

    Return the number of units from the font's baseline to the top of the bounding box. It is not adjusted for strong or rotation.

    @@ -770,9 +733,9 @@ bounding box. It is not adjusted for strong or rotation.

    get_sized_descender()
    The scaled descent of the font in pixels
    -
    get_sized_descender(size=0, /) -> int
    +
    get_sized_descender(<size>=0) -> int
    -

    Return the number of pixels from the font's baseline to the bottom of the +

    Return the number of pixels from the font's baseline to the top of the bounding box. It is not adjusted for strong or rotation.

    @@ -781,7 +744,7 @@ bounding box. It is not adjusted for strong or rotation.

    get_sized_height()
    The scaled height of the font in pixels
    -
    get_sized_height(size=0, /) -> int
    +
    get_sized_height(<size>=0) -> int

    Returns the height of the font. This is the average value of all glyphs in the font. It is not adjusted for strong or rotation.

    @@ -792,7 +755,7 @@ glyphs in the font. It is not adjusted for strong or rotation.

    get_sized_glyph_height()
    The scaled bounding box height of the font in pixels
    -
    get_sized_glyph_height(size=0, /) -> int
    +
    get_sized_glyph_height(<size>=0) -> int

    Return the glyph bounding box height of the font in pixels. This is the average value of all glyphs in the font. @@ -851,7 +814,7 @@ See Render text onto an existing surface

    render_to(surf, dest, text, fgcolor=None, bgcolor=None, style=STYLE_DEFAULT, rotation=0, size=0) -> Rect
    -

    Renders the string text to the pygame.SurfacePygame object for representing images. surf, +

    Renders the string text to the pygame.Surfacepygame object for representing images surf, at position dest, a (x, y) surface coordinate pair. If either x or y is not an integer it is converted to one if possible. Any sequence where the first two items are x and y positional elements @@ -874,7 +837,7 @@ passed to a previous render_raw(), or render_raw_to() call. Primarily, this feature is an aid to using render_to() in combination with get_rect(). An example:

    -
    def word_wrap(surf, text, font, color=(0, 0, 0)):
    +
    def word_wrap(surf, text, font, color=(0, 0, 0)):
         font.origin = True
         words = text.split(' ')
         width, height = surf.get_size()
    @@ -1018,7 +981,7 @@ AttributeError. If the font object is inactive, as returned by
     

    Gets or sets whether the font will be stretched horizontally when drawing text. It produces a result similar to -pygame.font.FontCreate a new Font object from a file.'s bold. This style not available for +pygame.font.Fontcreate a new Font object from a file's bold. This style not available for rotated text.

    @@ -1034,7 +997,7 @@ strong or wide transformations, as a fraction of the untransformed size. For the wide style only the horizontal dimension is increased. For strong text both the horizontal and vertical dimensions are enlarged. A wide style of strength 0.08333 ( 1/12 ) is -equivalent to the pygame.font.FontCreate a new Font object from a file. bold style. +equivalent to the pygame.font.Fontcreate a new Font object from a file bold style. The default is 0.02778 ( 1/36 ).

    The strength style is only supported for scalable (outline) fonts. An attempt to set this property on a bitmap font will raise an @@ -1054,7 +1017,7 @@ font's underline offset to adjust the underline position. A negative value turns an underline into a strike-through or overline. It is multiplied with the ascender. Accepted values range between -2.0 and 2.0 inclusive. A value of 0.5 closely matches Tango underlining. A value of -1.0 mimics pygame.font.FontCreate a new Font object from a file. underlining.

    +1.0 mimics pygame.font.Fontcreate a new Font object from a file underlining.

    @@ -1196,7 +1159,7 @@ unset and text will render with a transparent background by default. Applies to render() and render_to().

    -
    +

    New in pygame 2.0.0.

    @@ -1264,7 +1227,7 @@ support.




    -Edit on GitHub +Edit on GitHub
    @@ -1280,17 +1243,19 @@ support.

    modules |
  • - next |
  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/geometry.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/geometry.html deleted file mode 100644 index 5d0e1eb..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/geometry.html +++ /dev/null @@ -1,1236 +0,0 @@ - - - - - - - - pygame.geometry — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -
    -pygame.geometry
    -
    -

    Warning

    -

    Experimental Module

    -

    This module is a work in progress. Refrain from relying on any features provided by -this module, as they are subject to change or removal without prior notice.

    -
    - - - - - - - - - - - -
    -—pygame object for representing a circle
    -—pygame object for representing a line
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    -
    pygame module for the Circle, Line, and Polygon objects
    -
    -
    -
    -pygame.Circle
    -
    -
    pygame object for representing a circle
    -
    Circle((x, y), radius) -> Circle
    -
    Circle(x, y, radius) -> Circle
    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -—center x coordinate of the circle
    -—center y coordinate of the circle
    -—radius of the circle
    -—radius of the circle squared
    -—x and y coordinates of the center of the circle
    -—diameter of the circle
    -—area of the circle
    -—circumference of the circle
    -—top coordinate of the circle
    -—bottom coordinate of the circle
    -—left coordinate of the circle
    -—right coordinate of the circle
    -—tests if a point is inside the circle
    -—tests if a circle collides with this circle
    -—tests if a rectangle collides with this circle
    -—tests if a shape or point collides with this circle
    -—test if a list of objects collide with the circle
    -—test if all objects in a list collide with the circle
    -—tests if a shape or point is inside the circle
    -—moves the circle by a given amount
    -—moves the circle by a given amount, in place
    -—finds intersections between the circle and a shape
    -—updates the circle position and radius
    -—rotates the circle
    -—rotates the circle in place
    -—returns the smallest Rect containing the circle
    -—returns the smallest FRect containing the circle
    -—copies the circle
    -

    The Circle class provides many useful methods for collision testing, transformation and intersection. -A Circle can be created from a combination of a pair of coordinates that represent -the center of the circle and a radius. Circles can also be created from python objects that -are already a Circle (effectively copying the circle) or have an attribute named "circle".

    -

    Specifically, to construct a circle you can pass the x, y, and radius values as separate -arguments or inside a sequence(list or tuple).

    -

    Functions that require a Circle argument may also accept these values as Circles:

    -
    ((x, y), radius)
    -(x, y, radius)
    -(vector2, radius)
    -
    -
    -

    The Circle class only stores the x, y and r attributes, everything else is calculated -on the fly based on them.

    -

    Circle Attributes

    -
    -
    -
    -x
    -
    -
    center x coordinate of the circle
    -
    x -> float
    -
    -

    The horizontal coordinate of the center of the circle. Reassigning it moves the circle.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -y
    -
    -
    center y coordinate of the circle
    -
    y -> float
    -
    -

    The vertical coordinate of the center of the circle. Reassigning it moves the circle.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -r
    -
    -
    radius of the circle
    -
    r -> float
    -
    -

    Represents the size of the circle. It can't be negative. Reassigning it scales the circle.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    -

    Changed in pygame-ce 2.5.1: It is now allowed to create degenerate circles with \(r = 0\).

    -
    -
    - -
    -
    -r_sqr
    -
    -
    radius of the circle squared
    -
    r_sqr -> float
    -
    -

    It's equivalent to \(r^2\). It can't be negative. Reassigning it changes the radius to \(r = \sqrt{r_{sqr}}\).

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -center
    -
    -
    x and y coordinates of the center of the circle
    -
    center -> (float, float)
    -
    -

    A tuple containing the circle's x and y coordinates representing its center. -Reassigning it moves the circle to the new position.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -diameter
    -
    -
    diameter of the circle
    -
    diameter -> float
    -
    -

    It's equivalent to \(2 \cdot r\). It can't be negative. Reassigning it -changes the radius to \(r = \frac{d}{2}\).

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -area
    -
    -
    area of the circle
    -
    area -> float
    -
    -

    It's equivalent to \(\pi \cdot r^2\). It can't be negative. Reassigning it -changes the radius to \(r = \sqrt{\frac{area}{\pi}}\) producing a circle with matching area.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -circumference
    -
    -
    circumference of the circle
    -
    circumference -> float
    -
    -

    It's equivalent to \(2 \cdot \pi \cdot r\). It can't be negative. Reassigning it -changes the radius to \(r = \frac{circumference}{2\pi}\) producing a circle with -matching circumference.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -top
    -
    -
    top coordinate of the circle
    -
    top -> (float, float)
    -
    -

    A tuple containing the x and y coordinates that represent the top -of the circle. -Reassigning it moves the circle to the new position. The radius will not be affected.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -bottom
    -
    -
    bottom coordinate of the circle
    -
    bottom -> (float, float)
    -
    -

    A tuple containing the x and y coordinates that represent the bottom -of the circle. -Reassigning it moves the circle to the new position. The radius will not be affected.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -left
    -
    -
    left coordinate of the circle
    -
    left -> (float, float)
    -
    -

    A tuple containing the x and y coordinates that represent the left -of the circle. -Reassigning it moves the circle to the new position. The radius will not be affected.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -right
    -
    -
    right coordinate of the circle
    -
    right -> (float, float)
    -
    -

    A tuple containing the x and y coordinates that represent the right -of the circle. -Reassigning it moves the circle to the new position. The radius will not be affected.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -

    Circle Methods

    -
    -
    -
    -collidepoint()
    -
    -
    tests if a point is inside the circle
    -
    collidepoint((x, y), /) -> bool
    -
    collidepoint(x, y, /) -> bool
    -
    collidepoint(vector2, /) -> bool
    -
    -

    Returns True if the given point is inside this Circle (edge included), False otherwise. -It takes a tuple of (x, y) coordinates, two separate x and y coordinates, or a Vector2 -object as its argument.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -collidecircle()
    -
    -
    tests if a circle collides with this circle
    -
    collidecircle(circle, /) -> bool
    -
    collidecircle(x, y, radius, /) -> bool
    -
    collidecircle((x, y), radius, /) -> bool
    -
    collidecircle(vector2, radius, /) -> bool
    -
    -

    Returns True if the given circle intersects with this Circle, False otherwise. -It takes either a Circle object, a tuple of (x, y) coordinates and a radius, or separate x and y -coordinates and a radius as its argument.

    -
    -

    Note

    -

    Calling this method with this circle as the argument will always return True.

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -colliderect()
    -
    -
    tests if a rectangle collides with this circle
    -
    colliderect(rect, /) -> bool
    -
    colliderect((x, y, width, height), /) -> bool
    -
    colliderect(x, y, width, height, /) -> bool
    -
    colliderect((x, y), (width, height), /) -> bool
    -
    colliderect(vector2, (width, height), /) -> bool
    -
    -

    Returns True if the given rectangle intersects with this Circle, False otherwise. -Takes either a Rect object, a tuple of (x, y, width, height) coordinates, or separate -x, y coordinates and width, height as its argument.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -collideswith()
    -
    -
    tests if a shape or point collides with this circle
    -
    collideswith(circle, /) -> bool
    -
    collideswith(rect, /) -> bool
    -
    collideswith((x, y), /) -> bool
    -
    collideswith(vector2, /) -> bool
    -
    -

    Returns True if the given shape or point intersects with this Circle, False otherwise. -The shape can be a Circle, Rect, FRect.

    -
    -

    Note

    -

    The shape argument must be an actual shape object (Circle, Rect, or FRect). -You can't pass a tuple or list of coordinates representing the shape (except for a point), -because the shape type can't be determined from the coordinates alone.

    -
    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -collidelist()
    -
    -
    test if a list of objects collide with the circle
    -
    collidelist(colliders) -> int
    -
    -

    The collidelist method tests whether a given list of shapes or points collides -(overlaps) with this Circle object. The function takes in a single argument, which -must be a list of Circle, Rect, FRect, or a point. The function returns the index -of the first shape or point in the list that collides with the Circle object, or --1 if there is no collision.

    -
    -

    Note

    -

    The shapes must be actual shape objects, such as Circle, Rect or FRect -instances. It is not possible to pass a tuple or list of coordinates representing -the shape as an argument (except for a point), because the shape type can't be -determined from the coordinates alone.

    -
    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -collidelistall()
    -
    -
    test if all objects in a list collide with the circle
    -
    collidelistall(colliders) -> list
    -
    -

    The collidelistall method tests whether a given list of shapes or points collides -(overlaps) with this Circle object. The function takes in a single argument, which -must be a list of Circle, Rect, FRect, or a point. The function returns a list -containing the indices of all the shapes or points in the list that collide with -the Circle object, or an empty list if there is no collision.

    -
    -

    Note

    -

    The shapes must be actual shape objects, such as Circle, Rect or FRect -instances. It is not possible to pass a tuple or list of coordinates representing -the shape as an argument (except for a point), because the shape type can't be -determined from the coordinates alone.

    -
    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -contains()
    -
    -
    tests if a shape or point is inside the circle
    -
    contains(circle, /) -> bool
    -
    contains(rect, /) -> bool
    -
    contains((x, y), /) -> bool
    -
    contains(vector2, /) -> bool
    -
    -

    Returns True if the shape or point is completely contained within this Circle, False otherwise. -The shape can be a Circle, Rect, FRect.

    -
    -

    Note

    -

    The shape argument must be an actual shape object (Circle, Rect, or FRect). -You can't pass a tuple or list of coordinates representing the shape (except for a point), -because the shape type can't be determined from the coordinates alone.

    -
    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -move()
    -
    -
    moves the circle by a given amount
    -
    move((x, y), /) -> Circle
    -
    move(x, y, /) -> Circle
    -
    move(vector2, /) -> Circle
    -
    -

    Returns a copy of this Circle moved by the given amounts. -Takes either a tuple of (x, y) coordinates, two separate x and y coordinates, -or a Vector2 object as its argument.

    -

    This method is equivalent to the following code:

    -
    Circle((circle.x + x, circle.y + y), circle.r)
    -
    -
    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -move_ip()
    -
    -
    moves the circle by a given amount, in place
    -
    move_ip((x, y), /) -> None
    -
    move_ip(x, y, /) -> None
    -
    move_ip(vector2, /) -> None
    -
    -

    Moves this Circle in place by the given amounts. -Takes the same types of arguments as move() and it always returns None.

    -

    This method is equivalent to the following code:

    -
    circle.x += x
    -circle.y += y
    -
    -
    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -intersect()
    -
    -
    -
    finds intersections between the circle and a shape
    -
    intersect(circle, /) -> list
    -
    -
    -

    Finds and returns a list of intersection points between the circle and another shape. -The other shape must be a Circle object. -If the circle does not intersect or has infinite intersections, an empty list is returned.

    -
    -

    Note

    -
    -

    The shape argument must be an instance of the Circle class. -Passing a tuple or list of coordinates representing the shape is not supported, -as the type of shape cannot be determined from coordinates alone.

    -
    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    -
    - -
    -
    -update()
    -
    -
    updates the circle position and radius
    -
    update((x, y), radius, /) -> None
    -
    update(x, y, radius, /) -> None
    -
    update(vector2, radius, /) -> None
    -
    -

    Sets the position and radius of this Circle to the provided values. -It always returns None.

    -

    This method is equivalent to the following code:

    -
    circle.x = x
    -circle.y = y
    -circle.r = radius
    -
    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -rotate()
    -
    -
    rotates the circle
    -
    rotate(angle, rotation_point=Circle.center, /) -> Circle
    -
    rotate(angle, /) -> Circle
    -
    -

    Returns a copy of this Circle rotated by the specified angle (in degrees) around a point. -Positive angles rotate the circle clockwise, counter-clockwise otherwise. -The rotation point is optional and defaults to the circle's center.

    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -rotate_ip()
    -
    -
    rotates the circle in place
    -
    rotate_ip(angle, rotation_point=Circle.center, /) -> None
    -
    rotate_ip(angle, /) -> None
    -
    -

    Rotates the circle by a specified angle (in degrees) around a point. -Positive angles rotate the circle clockwise, counter-clockwise otherwise. -The rotation point is optional and defaults to the circle's center.

    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -as_rect()
    -
    -
    returns the smallest Rect containing the circle
    -
    as_rect() -> Rect
    -
    -

    Returns the smallest pygame.Rect object containing this Circle.

    -

    This method is equivalent to the following code:

    -
    Rect(circle.x - circle.r, circle.y - circle.r, circle.r * 2, circle.r * 2)
    -
    -
    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -as_frect()
    -
    -
    returns the smallest FRect containing the circle
    -
    as_frect() -> FRect
    -
    -

    Returns the smallest pygame.FRect object containing this Circle.

    -

    This method is equivalent to the following code:

    -
    FRect(circle.x - circle.r, circle.y - circle.r, circle.r * 2, circle.r * 2)
    -
    -
    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -copy()
    -
    -
    copies the circle
    -
    copy() -> Circle
    -
    -

    Returns a copy of this Circle.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    - -
    -
    -pygame.Line
    -
    -
    pygame object for representing a line
    -
    Line((ax, ay), (bx, by)) -> Line
    -
    Line(ax, ay, bx, by) -> Line
    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -—x coordinate of the start point of the line
    -—y coordinate of the start point of the line
    -—x coordinate of the end point of the line
    -—y coordinate of the end point of the line
    -—the first point of the line
    -—the second point of the line
    -—the length of the line
    -—copies the line
    -—moves the line by a given amount
    -—moves the line by a given amount
    -—updates the line's attributes
    -—scales the line by the given factor from the given origin
    -—scales the line by the given factor from the given origin in place
    -—flips the line a and b points
    -—flips the line a and b points, in place
    -—projects the line onto the given line
    -
    -

    New in pygame-ce 2.5.2.

    -
    -

    The Line class provides many useful methods for collision testing, transformation and intersection. -A Line can be created from a combination of two pairs of coordinates that represent the start and end points. -Lines can also be created from python objects that are already a Line (effectively copying the line) or have an attribute named "line".

    -

    Specifically, to construct a Line you can pass the ax, ay, bx, and by values as separate -arguments or inside a sequence(list or tuple).

    -

    As a special case you can also pass in pygame.Rect / pygame.FRect, in which case the -line will be created with (x, y, width, height) as the start and end points.

    -

    You can create lines with the same start and end points, but beware that some methods may -not work as expected or error out.

    -

    Functions that require a Line argument may also accept these values as Lines:

    -
    ((ax, ay), (bx, by))
    -(ax, ay, bx, by)
    -(vector2, vector2)
    -
    -
    -

    The Line class only stores the ax, ay, bx, and by attributes, everything else is calculated -on the fly based on them.

    -

    Line Attributes

    -
    -
    -
    -ax
    -
    -
    x coordinate of the start point of the line
    -
    ax -> float
    -
    -

    The horizontal coordinate of the start point of the line. Reassigning it moves the line.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -ay
    -
    -
    y coordinate of the start point of the line
    -
    ay -> float
    -
    -

    The vertical coordinate of the start point of the line. Reassigning it moves the line.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -bx
    -
    -
    x coordinate of the end point of the line
    -
    bx -> float
    -
    -

    The horizontal coordinate of the end point of the line. Reassigning it moves the line.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -by
    -
    -
    y coordinate of the end point of the line
    -
    by -> float
    -
    -

    The vertical coordinate of the end point of the line. Reassigning it moves the line.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -a
    -
    -
    the first point of the line
    -
    a -> (float, float)
    -
    -

    A tuple containing the ax and ay attributes representing the line's first point. -It can be reassigned to move the Line. If reassigned the ax and ay attributes -will be changed to produce a Line with matching first point position. -The bx and by attributes will not be affected.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -b
    -
    -
    the second point of the line
    -
    b -> (float, float)
    -
    -

    A tuple containing bx and by attributes representing the line's second point. -It can be reassigned to move the Line. If reassigned the bx and by attributes -will be changed to produce a Line with matching second point position. -The ax and ay attributes will not be affected.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -length
    -
    -
    the length of the line
    -
    length -> float
    -
    -

    The length of the line. Calculated using the sqrt((bx-ax)**2 + (by-ay)**2) formula. -This attribute is read-only, it cannot be reassigned. To change the line's length -use the scale method or change its a or b attributes.

    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    - -

    Line Methods

    -
    -
    -
    -copy()
    -
    -
    copies the line
    -
    copy() -> Line
    -
    -

    Returns a copy of this Line.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -move()
    -
    -
    -
    moves the line by a given amount
    -
    move((x, y)) -> Line
    -
    move(x, y) -> Line
    -
    -

    Returns a new Line that is moved by the given offset. The original Line is -not modified.

    -

    This method is equivalent to the following code:

    -
    Line(line.ax + x, line.ay + y, line.bx + x, line.by + y)
    -
    -
    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    -
    - -
    -
    -move_ip()
    -
    -
    -
    moves the line by a given amount
    -
    move_ip((x, y)) -> None
    -
    move_ip(x, y) -> None
    -
    -

    Moves the Line by the given offset. The original Line is modified. Always returns -None.

    -

    This method is equivalent to the following code:

    -
    line.ax += x
    -line.ay += y
    -line.bx += x
    -line.by += y
    -
    -
    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    -
    - -
    -
    -update()
    -
    -
    -
    updates the line's attributes
    -
    update((ax, ay), (bx, by)) -> None
    -
    update(ax, ay, bx, by) -> None
    -
    update(line) -> None
    -
    -

    Updates the Line's attributes. The original Line is modified. Always returns None.

    -

    This method is equivalent to the following code:

    -
    line.ax = ax
    -line.ay = ay
    -line.bx = bx
    -line.by = by
    -
    -
    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    -
    - -
    -
    -scale()
    -
    -
    -
    scales the line by the given factor from the given origin
    -
    scale(factor, origin) -> Line
    -
    scale(factor_and_origin) -> Line
    -
    -

    Returns a new Line which is scaled by the given factor from the specified origin with 0.0 being -the starting point, 0.5 being the center and 1.0 being the end point. -The original Line is not modified.

    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    -
    - -
    -
    -scale_ip()
    -
    -
    -
    scales the line by the given factor from the given origin in place
    -
    scale_ip(factor, origin) -> None
    -
    scale_ip(factor_and_origin) -> None
    -
    -

    Scales the Line by the given factor from the specified origin with 0.0 being -the starting point, 0.5 being the center and 1.0 being the end point. -The original Line is modified. -Always returns None.

    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    -
    - -
    -
    -flip_ab()
    -
    -
    -
    flips the line a and b points
    -
    flip_ab() -> Line
    -
    -

    Returns a new Line that has the a and b points flipped. -The original Line is not modified.

    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    -
    - -
    -
    -flip_ab_ip()
    -
    -
    -
    flips the line a and b points, in place
    -
    flip_ab_ip() -> None
    -
    -

    Flips the Line's a and b points. The original Line is modified. -Always returns None.

    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    -
    - -
    -
    -project()
    -
    -
    -
    projects the line onto the given line
    -
    project(point: tuple[float, float], clamp=False) -> tuple[float, float]
    -
    -

    This method takes in a point and one boolean keyword argument clamp. It outputs an orthogonally projected point onto the line. -If clamp is True it makes sure that the outputted point will be on the line segment (which might not be orthogonal), and if it is False (the default) then any point on the infinitely extended line may be outputted. -This method can be used to find the closest point on a line to the given point. The output is the unique point on the line or line segment that is the smallest distance away from the given point.

    -
    -project method image -
    -

    Example of how it projects the point onto the line. The red point is the point we want to project and the blue point is what you would get as a result.

    -
    -
    -
    -project clamp argument image -
    -

    Example of what the clamp argument changes. If it is True, the point is bounded between the line segment ends.

    -
    -

    WARNING: If the line has no length (i.e. the start and end points are the same) then the returned point of this function will be the same point as both ends of the line.

    -
    -
    -
    -
    -

    New in pygame-ce 2.5.6.

    -
    -
    -
    - -
    - -
    - -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/gfxdraw.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/gfxdraw.html index bf027ce..1c74953 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/gfxdraw.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/gfxdraw.html @@ -5,19 +5,17 @@ - pygame.gfxdraw — pygame-ce v2.5.8 documentation - - - - - + pygame.gfxdraw — pygame v2.6.1 documentation + + + + - - +
    @@ -25,30 +23,24 @@
    @@ -227,8 +217,8 @@ you use this, your code may break with the next pygame release.

    The pygame package does not import gfxdraw automatically when loaded, so it must imported explicitly to be used.

    -
    import pygame
    -import pygame.gfxdraw
    +
    import pygame
    +import pygame.gfxdraw
     

    For all functions the arguments are strictly positional and integers are @@ -236,7 +226,7 @@ accepted for coordinates and radii. The -

  • a pygame.ColorPygame object for color representations. object

  • +
  • a pygame.Colorpygame object for color representations object

  • an (RGB) triplet (tuple/list)

  • an (RGBA) quadruplet (tuple/list)

  • @@ -260,13 +250,13 @@ the call.

    Note

    -

    See the pygame.drawPygame module for drawing shapes. module for alternative draw methods. -The pygame.gfxdraw module differs from the pygame.drawPygame module for drawing shapes. module in +

    See the pygame.drawpygame module for drawing shapes module for alternative draw methods. +The pygame.gfxdraw module differs from the pygame.drawpygame module for drawing shapes module in the API it uses and the different draw functions available. pygame.gfxdraw wraps the primitives from the library called SDL_gfx, rather than using modified versions.

    -
    +

    New in pygame 1.9.0.

    @@ -274,7 +264,7 @@ rather than using modified versions.

    pygame.gfxdraw.pixel()
    draw a pixel
    -
    pixel(surface, x, y, color, /) -> None
    +
    pixel(surface, x, y, color) -> None

    Draws a single pixel, at position (x ,y), on the given surface.

    @@ -301,7 +291,7 @@ tuple (RGB[A])pygame.gfxdraw.hline()
    draw a horizontal line
    -
    hline(surface, x1, x2, y, color, /) -> None
    +
    hline(surface, x1, x2, y, color) -> None

    Draws a straight horizontal line ((x1, y) to (x2, y)) on the given surface. There are no endcaps.

    @@ -330,7 +320,7 @@ tuple (RGB[A])pygame.gfxdraw.vline()
    draw a vertical line
    -
    vline(surface, x, y1, y2, color, /) -> None
    +
    vline(surface, x, y1, y2, color) -> None

    Draws a straight vertical line ((x, y1) to (x, y2)) on the given surface. There are no endcaps.

    @@ -359,7 +349,7 @@ tuple (RGB[A])pygame.gfxdraw.line()
    draw a line
    -
    line(surface, x1, y1, x2, y2, color, /) -> None
    +
    line(surface, x1, y1, x2, y2, color) -> None

    Draws a straight line ((x1, y1) to (x2, y2)) on the given surface. There are no endcaps.

    @@ -389,7 +379,7 @@ tuple (RGB[A])pygame.gfxdraw.rectangle()
    draw a rectangle
    -
    rectangle(surface, rect, color, /) -> None
    +
    rectangle(surface, rect, color) -> None

    Draws an unfilled rectangle on the given surface. For a filled rectangle use box().

    @@ -422,7 +412,7 @@ values will not be included as part of the drawing.

    pygame.gfxdraw.box()
    draw a filled rectangle
    -
    box(surface, rect, color, /) -> None
    +
    box(surface, rect, color) -> None

    Draws a filled rectangle on the given surface. For an unfilled rectangle use rectangle().

    @@ -450,8 +440,8 @@ values will not be included as part of the drawing.

    Note

    -

    The pygame.Surface.fill()Fill Surface with a solid color. method works just as well for drawing -filled rectangles. In fact pygame.Surface.fill()Fill Surface with a solid color. can be hardware +

    The pygame.Surface.fill()fill Surface with a solid color method works just as well for drawing +filled rectangles. In fact pygame.Surface.fill()fill Surface with a solid color can be hardware accelerated on some platforms with both software and hardware display modes.

    @@ -462,7 +452,7 @@ modes.

    pygame.gfxdraw.circle()
    draw a circle
    -
    circle(surface, x, y, r, color, /) -> None
    +
    circle(surface, x, y, r, color) -> None

    Draws an unfilled circle on the given surface. For a filled circle use filled_circle().

    @@ -491,7 +481,7 @@ tuple (RGB[A])pygame.gfxdraw.aacircle()
    draw an antialiased circle
    -
    aacircle(surface, x, y, r, color, /) -> None
    +
    aacircle(surface, x, y, r, color) -> None

    Draws an unfilled antialiased circle on the given surface.

    @@ -519,7 +509,7 @@ tuple (RGB[A])pygame.gfxdraw.filled_circle()
    draw a filled circle
    -
    filled_circle(surface, x, y, r, color, /) -> None
    +
    filled_circle(surface, x, y, r, color) -> None

    Draws a filled circle on the given surface. For an unfilled circle use circle().

    @@ -548,7 +538,7 @@ tuple (RGB[A])pygame.gfxdraw.ellipse()
    draw an ellipse
    -
    ellipse(surface, x, y, rx, ry, color, /) -> None
    +
    ellipse(surface, x, y, rx, ry, color) -> None

    Draws an unfilled ellipse on the given surface. For a filled ellipse use filled_ellipse().

    @@ -578,7 +568,7 @@ tuple (RGB[A])pygame.gfxdraw.aaellipse()
    draw an antialiased ellipse
    -
    aaellipse(surface, x, y, rx, ry, color, /) -> None
    +
    aaellipse(surface, x, y, rx, ry, color) -> None

    Draws an unfilled antialiased ellipse on the given surface.

    @@ -607,7 +597,7 @@ tuple (RGB[A])pygame.gfxdraw.filled_ellipse()
    draw a filled ellipse
    -
    filled_ellipse(surface, x, y, rx, ry, color, /) -> None
    +
    filled_ellipse(surface, x, y, rx, ry, color) -> None

    Draws a filled ellipse on the given surface. For an unfilled ellipse use ellipse().

    @@ -637,7 +627,7 @@ tuple (RGB[A])pygame.gfxdraw.arc()
    draw an arc
    -
    arc(surface, x, y, r, start_angle, stop_angle, color, /) -> None
    +
    arc(surface, x, y, r, start_angle, stop_angle, color) -> None

    Draws an arc on the given surface. For an arc with its endpoints connected to its center use pie().

    @@ -667,7 +657,7 @@ tuple (RGB[A])

    Note

    -

    This function uses degrees while the pygame.draw.arc()Draw an elliptical arc. function +

    This function uses degrees while the pygame.draw.arc()draw an elliptical arc function uses radians.

    @@ -677,7 +667,7 @@ uses radians.

    pygame.gfxdraw.pie()
    draw a pie
    -
    pie(surface, x, y, r, start_angle, stop_angle, color, /) -> None
    +
    pie(surface, x, y, r, start_angle, stop_angle, color) -> None

    Draws an unfilled pie on the given surface. A pie is an arc() with its endpoints connected to its center.

    @@ -713,7 +703,7 @@ tuple (RGB[A])pygame.gfxdraw.trigon()
    draw a trigon/triangle
    -
    trigon(surface, x1, y1, x2, y2, x3, y3, color, /) -> None
    +
    trigon(surface, x1, y1, x2, y2, x3, y3, color) -> None

    Draws an unfilled trigon (triangle) on the given surface. For a filled trigon use filled_trigon().

    @@ -747,7 +737,7 @@ tuple (RGB[A])pygame.gfxdraw.aatrigon()
    draw an antialiased trigon/triangle
    -
    aatrigon(surface, x1, y1, x2, y2, x3, y3, color, /) -> None
    +
    aatrigon(surface, x1, y1, x2, y2, x3, y3, color) -> None

    Draws an unfilled antialiased trigon (triangle) on the given surface.

    An aatrigon can also be drawn using aapolygon() e.g. @@ -780,7 +770,7 @@ tuple (RGB[A])pygame.gfxdraw.filled_trigon()

    draw a filled trigon/triangle
    -
    filled_trigon(surface, x1, y1, x2, y2, x3, y3, color, /) -> None
    +
    filled_trigon(surface, x1, y1, x2, y2, x3, y3, color) -> None

    Draws a filled trigon (triangle) on the given surface. For an unfilled trigon use trigon().

    @@ -814,11 +804,11 @@ tuple (RGB[A])pygame.gfxdraw.polygon()
    draw a polygon
    -
    polygon(surface, points, color, /) -> None
    +
    polygon(surface, points, color) -> None

    Draws an unfilled polygon on the given surface. For a filled polygon use filled_polygon().

    -

    The adjacent points in the points argument, as well as the first +

    The adjacent coordinates in the points argument, as well as the first and last points, will be connected by line segments. e.g. For the points [(x1, y1), (x2, y2), (x3, y3)] a line segment will be drawn from (x1, y1) to (x2, y2), from (x2, y2) to @@ -827,8 +817,8 @@ be drawn from (x1,<

    Parameters:
    • surface (Surface) -- surface to draw on

    • -
    • points (tuple(point) or list(point)) -- a sequence of 3 or more (x, y) coordinates, where each -point in the sequence must be a +

    • points (tuple(coordinate) or list(coordinate)) -- a sequence of 3 or more (x, y) coordinates, where each +coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats (float values will be truncated)

    • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a @@ -844,7 +834,7 @@ tuple (RGB[A])Raises:

      • ValueError -- if len(points) < 3 (must have at least 3 points)

      • -
      • IndexError -- if len(point) < 2 (each point must have +

      • IndexError -- if len(coordinate) < 2 (each coordinate must have at least 2 items)

      @@ -856,10 +846,10 @@ at least 2 items)

    • pygame.gfxdraw.aapolygon()
      draw an antialiased polygon
      -
      aapolygon(surface, points, color, /) -> None
      +
      aapolygon(surface, points, color) -> None

      Draws an unfilled antialiased polygon on the given surface.

      -

      The adjacent points in the points argument, as well as the first +

      The adjacent coordinates in the points argument, as well as the first and last points, will be connected by line segments. e.g. For the points [(x1, y1), (x2, y2), (x3, y3)] a line segment will be drawn from (x1, y1) to (x2, y2), from (x2, y2) to @@ -868,8 +858,8 @@ be drawn from (x1,<

      Parameters:
      • surface (Surface) -- surface to draw on

      • -
      • points (tuple(point) or list(point)) -- a sequence of 3 or more (x, y) coordinates, where each -point in the sequence must be a +

      • points (tuple(coordinate) or list(coordinate)) -- a sequence of 3 or more (x, y) coordinates, where each +coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats (float values will be truncated)

      • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a @@ -885,7 +875,7 @@ tuple (RGB[A])Raises:

        • ValueError -- if len(points) < 3 (must have at least 3 points)

        • -
        • IndexError -- if len(point) < 2 (each point must have +

        • IndexError -- if len(coordinate) < 2 (each coordinate must have at least 2 items)

        @@ -897,11 +887,11 @@ at least 2 items)

      • pygame.gfxdraw.filled_polygon()
        draw a filled polygon
        -
        filled_polygon(surface, points, color, /) -> None
        +
        filled_polygon(surface, points, color) -> None

        Draws a filled polygon on the given surface. For an unfilled polygon use polygon().

        -

        The adjacent points in the points argument, as well as the first +

        The adjacent coordinates in the points argument, as well as the first and last points, will be connected by line segments. e.g. For the points [(x1, y1), (x2, y2), (x3, y3)] a line segment will be drawn from (x1, y1) to (x2, y2), from (x2, y2) to @@ -910,8 +900,8 @@ be drawn from (x1,<

        Parameters:
        • surface (Surface) -- surface to draw on

        • -
        • points (tuple(point) or list(point)) -- a sequence of 3 or more (x, y) coordinates, where each -point in the sequence must be a +

        • points (tuple(coordinate) or list(coordinate)) -- a sequence of 3 or more (x, y) coordinates, where each +coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats (float values will be truncated)`

        • color (Color or tuple(int, int, int, [int])) -- color to draw with, the alpha value is optional if using a @@ -927,7 +917,7 @@ tuple (RGB[A])Raises:

          • ValueError -- if len(points) < 3 (must have at least 3 points)

          • -
          • IndexError -- if len(point) < 2 (each point must have +

          • IndexError -- if len(coordinate) < 2 (each coordinate must have at least 2 items)

          @@ -939,14 +929,14 @@ at least 2 items)

        • pygame.gfxdraw.textured_polygon()
          draw a textured polygon
          -
          textured_polygon(surface, points, texture, tx, ty, /) -> None
          +
          textured_polygon(surface, points, texture, tx, ty) -> None

          Draws a textured polygon on the given surface. For better performance, the surface and the texture should have the same format.

          A per-pixel alpha texture blit to a per-pixel alpha surface will differ from -a pygame.Surface.blit()Draw another Surface onto this one. blit. Also, a per-pixel alpha texture cannot be +a pygame.Surface.blit()draw one image onto another blit. Also, a per-pixel alpha texture cannot be used with an 8-bit per pixel destination.

          -

          The adjacent points in the points argument, as well as the first +

          The adjacent coordinates in the points argument, as well as the first and last points, will be connected by line segments. e.g. For the points [(x1, y1), (x2, y2), (x3, y3)] a line segment will be drawn from (x1, y1) to (x2, y2), from (x2, y2) to @@ -955,8 +945,8 @@ be drawn from (x1,<

          Parameters:
          • surface (Surface) -- surface to draw on

          • -
          • points (tuple(point) or list(point)) -- a sequence of 3 or more (x, y) coordinates, where each -point in the sequence must be a +

          • points (tuple(coordinate) or list(coordinate)) -- a sequence of 3 or more (x, y) coordinates, where each +coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats (float values will be truncated)

          • texture (Surface) -- texture to draw on the polygon

          • @@ -973,7 +963,7 @@ will be truncated)

            Raises:
            • ValueError -- if len(points) < 3 (must have at least 3 points)

            • -
            • IndexError -- if len(point) < 2 (each point must have +

            • IndexError -- if len(coordinate) < 2 (each coordinate must have at least 2 items)

            @@ -985,15 +975,15 @@ at least 2 items)

            pygame.gfxdraw.bezier()
            draw a Bezier curve
            -
            bezier(surface, points, steps, color, /) -> None
            +
            bezier(surface, points, steps, color) -> None

            Draws a Bézier curve on the given surface.

            Parameters:
            • surface (Surface) -- surface to draw on

            • -
            • points (tuple(point) or list(point)) -- a sequence of 3 or more (x, y) coordinates used to form a -curve, where each point in the sequence must be a +

            • points (tuple(coordinate) or list(coordinate)) -- a sequence of 3 or more (x, y) coordinates used to form a +curve, where each coordinate in the sequence must be a tuple/list/pygame.math.Vector2a 2-Dimensional Vector of 2 ints/floats (float values will be truncated)

            • steps (int) -- number of steps for the interpolation, the minimum is 2

            • @@ -1011,16 +1001,11 @@ tuple (RGB[A])
              • ValueError -- if steps < 2

              • ValueError -- if len(points) < 3 (must have at least 3 points)

              • -
              • IndexError -- if len(point) < 2 (each point must have +

              • IndexError -- if len(coordinate) < 2 (each coordinate must have at least 2 items)

            -
            -

            Note

            -

            This function supports up to around 150-200 points before the algorithm -breaks down.

            -
    @@ -1030,7 +1015,7 @@ breaks down.




    -Edit on GitHub +Edit on GitHub
    @@ -1049,14 +1034,16 @@ breaks down.

    next |
  • - previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/image.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/image.html index 66c731e..1ab7b6b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/image.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/image.html @@ -5,14 +5,12 @@ - pygame.image — pygame-ce v2.5.8 documentation - - - - - + pygame.image — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,79 +97,69 @@
    pygame.image
    -
    Pygame module for image transfer.
    +
    pygame module for image transfer
    - - - - - - - - - + - + - + - + - + - + - + - + - + - + - + - +
    —Load new image from a file (or file-like object).
    -—Load an SVG image from a file (or file-like object) with the given size.
    -—Load an animation (GIF/WEBP) from a file (or file-like object) as a list of frames.load new image from a file (or file-like object)
    —Save an image to file (or file-like object).save an image to file (or file-like object)
    —Get version number of the SDL_Image library being used.get version number of the SDL_Image library being used
    —Test if extended image formats can be loaded.test if extended image formats can be loaded
    —Transfer image to byte buffer.transfer image to byte buffer
    —Transfer image to byte buffer.transfer image to byte buffer
    —Create new Surface from a byte buffer.create new Surface from a byte buffer
    —Create new Surface from a byte buffer.create new Surface from a byte buffer
    —Create a new Surface that shares data inside a bytes buffer.create a new Surface that shares data inside a bytes buffer
    —Load new BMP image from a file (or file-like object).load new BMP image from a file (or file-like object)
    —Load an image from a file (or file-like object).load an image from a file (or file-like object)
    —Save a png/jpg image to file (or file-like object).save a png/jpg image to file (or file-like object)
    @@ -191,31 +171,26 @@ regions, etc.).

    In the vast majority of installations, pygame is built to support extended formats, using the SDL_Image library behind the scenes. However, some installations may only support uncompressed BMP images. With full image -support, the pygame.image.load()Load new image from a file (or file-like object). function can load the following +support, the pygame.image.load()load new image from a file (or file-like object) function can load the following formats.

    • BMP

    • GIF (non-animated)

    • JPEG

    • -
    • LBM

    • +
    • LBM (and PBM, PGM, PPM)

    • PCX

    • PNG

    • -
    • PNM (PBM, PGM, PPM)

    • -
    • QOI

    • +
    • PNM

    • SVG (limited support, using Nano SVG)

    • TGA (uncompressed)

    • TIFF

    • WEBP

    • XPM

    • -
    • XCF

    -
    -

    New in pygame 2.0.0: Loading SVG, WebP, PNM

    -
    -

    New in pygame-ce 2.4.0: Loading QOI (Relies on SDL_Image 2.6.0+)

    +

    New in pygame 2.0: Loading SVG, WebP, PNM

    Saving images only supports a limited set of formats. You can save to the following formats.

    @@ -227,16 +202,17 @@ following formats.

  • TGA

  • -

    JPEG and JPG, as well as TIF and TIFF refer to the same file format.

    -
    +

    JPEG and JPG, as well as TIF and TIFF refer to the same file format

    +

    New in pygame 1.8: Saving PNG and JPEG files.

    pygame.image.load()
    -
    Load new image from a file (or file-like object).
    -
    load(file, namehint='') -> Surface
    +
    load new image from a file (or file-like object)
    +
    load(filename) -> Surface
    +
    load(fileobj, namehint="") -> Surface

    Load an image from a file source. You can pass either a filename, a Python file-like object, or a pathlib.Path.

    @@ -247,77 +223,28 @@ pass a raw file-like object, you may also want to pass the original filename as the namehint argument.

    The returned Surface will contain the same color format, colorkey and alpha transparency as the file it came from. You will often want to call -pygame.Surface.convert()Change the pixel format of a Surface. with no arguments, to create a copy that +pygame.Surface.convert()change the pixel format of an image with no arguments, to create a copy that will draw more quickly on the screen.

    For alpha transparency, like in .png images, use the -pygame.Surface.convert_alpha()Change the pixel format of a Surface including per pixel alphas. method after loading so that the +pygame.Surface.convert_alpha()change the pixel format of an image including per pixel alphas method after loading so that the image has per pixel transparency.

    Pygame may not always be built to support all image formats. At minimum it -will support uncompressed BMP. If pygame.image.get_extended()Test if extended image formats can be loaded. +will support uncompressed BMP. If pygame.image.get_extended()test if extended image formats can be loaded returns True, you should be able to load most images (including PNG, JPG and GIF).

    You should use os.path.join() for compatibility.

    -
    surf = pygame.image.load(os.path.join('data', 'bla.png'))
    +
    eg. asurf = pygame.image.load(os.path.join('data', 'bla.png'))
     
    -
    -

    Changed in pygame-ce 2.2.0: Now supports keyword arguments.

    -
    -
    - -
    -
    -pygame.image.load_sized_svg()
    -
    -
    Load an SVG image from a file (or file-like object) with the given size.
    -
    load_sized_svg(file, size) -> Surface
    -
    -

    This function rasterizes the input SVG at the size specified by the size -argument. The file argument can be either a filename, a Python file-like -object, or a pathlib.Path.

    -

    The usage of this function for handling SVGs is recommended, as calling the -regular load function and then scaling the returned surface would not -preserve the quality that an SVG can provide.

    -

    It is to be noted that this function does not return a surface whose -dimensions exactly match the size argument. This function preserves -aspect ratio, so the returned surface could be smaller along at most one -dimension.

    -

    This function requires SDL_image 2.6.0 or above. If pygame was compiled with -an older version, pygame.error will be raised when this function is -called.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -pygame.image.load_animation()
    -
    -
    Load an animation (GIF/WEBP) from a file (or file-like object) as a list of frames.
    -
    load_animation(file, namehint='') -> list[tuple[Surface, float]]
    -
    -

    Load an animation (GIF/WEBP) from a file source. You can pass either a -filename, a Python file-like object, or a pathlib.Path. If you pass a raw -file-like object, you may also want to pass the original filename as the -namehint argument so that the file extension can be used to infer the file -format.

    -

    This returns a list of tuples (corresponding to every frame of the animation), -where each tuple is a (surface, delay in milliseconds) pair for that frame.

    -

    This function requires SDL_image 2.6.0 or above. If pygame was compiled with -an older version, pygame.error will be raised when this function is -called.

    -
    -

    New in pygame-ce 2.5.4.

    -
    pygame.image.save()
    -
    Save an image to file (or file-like object).
    -
    save(surface, file, namehint='') -> None
    +
    save an image to file (or file-like object)
    +
    save(Surface, filename) -> None
    +
    save(Surface, fileobj, namehint="") -> None

    This will save your Surface as either a BMP, TGA, PNG, or JPEG image. If the filename extension is unrecognized it will default to @@ -331,25 +258,23 @@ a namehint with a recognizable extension is passed in.

    the object needs to be flushed after saving to it to make loading from it possible.

    -
    +

    Changed in pygame 1.8: Saving PNG and JPEG files.

    -
    +

    Changed in pygame 2.0.0: The namehint parameter was added to make it possible to save other formats than TGA to a file-like object. Saving to a file-like object with JPEG is possible.

    -
    -

    Changed in pygame-ce 2.2.0: Now supports keyword arguments.

    -
    pygame.image.get_sdl_image_version()
    -
    Get version number of the SDL_Image library being used.
    -
    get_sdl_image_version(linked=True) -> tuple[int, int, int] | None
    +
    get version number of the SDL_Image library being used
    +
    get_sdl_image_version(linked=True) -> None
    +
    get_sdl_image_version(linked=True) -> (major, minor, patch)

    If pygame is built with extended image formats, then this function will return the SDL_Image library's version number as a tuple of 3 integers @@ -357,13 +282,11 @@ return the SDL_Image library's version number as a tuple of 3 integers

    linked=True is the default behavior and the function will return the version of the library that Pygame is linked against, while linked=False will return the version of the library that Pygame is compiled against.

    -
    +

    New in pygame 2.0.0.

    -

    Changed in pygame-ce 2.1.4: linked keyword argument added and default -behavior changed from returning compiled version to returning linked -version

    +

    Changed in pygame 2.2.0: linked keyword argument added and default behavior changed from returning compiled version to returning linked version

    @@ -371,7 +294,7 @@ version

    pygame.image.get_extended()
    -
    Test if extended image formats can be loaded.
    +
    test if extended image formats can be loaded
    get_extended() -> bool

    If pygame is built with extended image formats this function will return @@ -383,24 +306,10 @@ but generally you will be able to load them all.

    pygame.image.tostring()
    -
    Transfer image to byte buffer.
    -
    tostring(surface, format, flipped=False, pitch=-1) -> bytes
    +
    transfer image to byte buffer
    +
    tostring(Surface, format, flipped=False) -> bytes
    -

    DEPRECATED: This function has the same functionality as tobytes(), -which is preferred and should be used.

    -
    -

    Deprecated since pygame-ce 2.3.0.

    -
    -
    - -
    -
    -pygame.image.tobytes()
    -
    -
    Transfer image to byte buffer.
    -
    tobytes(surface, format, flipped=False, pitch=-1) -> bytes
    -
    -

    Creates a bytes object that can be transferred with the fromstring +

    Creates a string of bytes that can be transferred with the fromstring or frombytes methods in other Python imaging packages. Some Python image packages prefer their images in bottom-to-top format (PyOpenGL for example). If you pass True for the flipped argument, the byte buffer @@ -417,66 +326,35 @@ than pygame.

  • RGBA, 32-bit image with an alpha channel

  • ARGB, 32-bit image with alpha channel first

  • BGRA, 32-bit image with alpha channel, red and blue channels swapped

  • -
  • ABGR, 32-bit image with alpha channel, reverse order

  • RGBA_PREMULT, 32-bit image with colors scaled by alpha channel

  • ARGB_PREMULT, 32-bit image with colors scaled by alpha channel, alpha channel first

  • -

    The 'pitch' argument can be used to specify the pitch/stride per horizontal line -of the image in bytes. It must be equal to or greater than how many bytes -the pixel data of each horizontal line in the image bytes occupies without any -extra padding. By default, it is -1, which means that the pitch/stride is -the same size as how many bytes the pure pixel data of each horizontal line takes.

    Note

    -

    The use of this function is recommended over tostring() as of pygame 2.1.3. -This function was introduced so it matches nicely with other -libraries (PIL, NumPy, etc), and with people's expectations.

    +

    it is preferred to use tobytes() as of pygame 2.1.3

    -

    New in pygame-ce 2.1.3.

    -
    -
    -

    Changed in pygame-ce 2.2.0: Now supports keyword arguments.

    -
    -
    -

    Changed in pygame-ce 2.5.0: Added a 'pitch' argument.

    -
    -
    -

    Changed in pygame-ce 2.5.1: Added support for ABGR image format

    +

    New in pygame 2.1.3: BGRA format

    -
    -pygame.image.fromstring()
    +
    +pygame.image.tobytes()
    -
    Create new Surface from a byte buffer.
    -
    fromstring(bytes, size, format, flipped=False, pitch=-1) -> Surface
    +
    transfer image to byte buffer
    +
    tobytes(Surface, format, flipped=False) -> bytes
    -

    DEPRECATED: This function has the same functionality as frombytes(), -which is preferred and should be used.

    -
    -

    Deprecated since pygame-ce 2.3.0.

    -
    -
    - -
    -
    -pygame.image.frombytes()
    -
    -
    Create new Surface from a byte buffer.
    -
    frombytes(bytes, size, format, flipped=False, pitch=-1) -> Surface
    -
    -

    This function takes arguments similar to pygame.image.tobytes()Transfer image to byte buffer.. -The size argument is a pair of numbers representing the width and height. -Once the new Surface is created it is independent from the memory of the -bytes passed in.

    -

    The bytes and format passed must compute to the exact size of image -specified. Otherwise a ValueError will be raised.

    +

    Creates a string of bytes that can be transferred with the fromstring +or frombytes methods in other Python imaging packages. Some Python +image packages prefer their images in bottom-to-top format (PyOpenGL for +example). If you pass True for the flipped argument, the byte buffer +will be vertically flipped.

    The format argument is a string of one of the following values. Note that only 8-bit Surfaces can use the "P" format. The other formats will work for -any Surface.

    +any Surface. Also note that other Python image packages support more formats +than pygame.

    • P, 8-bit palettized Surfaces

    • @@ -485,27 +363,67 @@ any Surface.

    • RGBA, 32-bit image with an alpha channel

    • ARGB, 32-bit image with alpha channel first

    • BGRA, 32-bit image with alpha channel, red and blue channels swapped

    • -
    • ABGR, 32-bit image with alpha channel, reverse order

    • +
    • RGBA_PREMULT, 32-bit image with colors scaled by alpha channel

    • +
    • ARGB_PREMULT, 32-bit image with colors scaled by alpha channel, alpha channel first

    -

    The 'pitch' argument can be used to specify the pitch/stride per horizontal line -of the image bytes in bytes. It must be equal to or greater than how many bytes -the pixel data of each horizontal line in the image bytes occupies without any -extra padding. By default, it is -1, which means that the pitch/stride is -the same size as how many bytes the pure pixel data of each horizontal line takes.

    -

    See the pygame.image.frombuffer()Create a new Surface that shares data inside a bytes buffer. method for a potentially faster +

    +

    Note

    +

    this function is an alias for tostring(). The use of this +function is recommended over tostring() as of pygame 2.1.3. +This function was introduced so it matches nicely with other +libraries (PIL, numpy, etc), and with people's expectations.

    +
    +
    +

    New in pygame 2.1.3.

    +
    +
    + +
    +
    +pygame.image.fromstring()
    +
    +
    create new Surface from a byte buffer
    +
    fromstring(bytes, size, format, flipped=False) -> Surface
    +
    +

    This function takes arguments similar to pygame.image.tostring()transfer image to byte buffer. +The size argument is a pair of numbers representing the width and height. +Once the new Surface is created it is independent from the memory of the +bytes passed in.

    +

    The bytes and format passed must compute to the exact size of image +specified. Otherwise a ValueError will be raised.

    +

    See the pygame.image.frombuffer()create a new Surface that shares data inside a bytes buffer method for a potentially faster way to transfer images into pygame.

    Note

    -

    The use of this function is recommended over fromstring() as of pygame 2.1.3. +

    it is preferred to use frombytes() as of pygame 2.1.3

    +
    +
    + +
    +
    +pygame.image.frombytes()
    +
    +
    create new Surface from a byte buffer
    +
    frombytes(bytes, size, format, flipped=False) -> Surface
    +
    +

    This function takes arguments similar to pygame.image.tobytes()transfer image to byte buffer. +The size argument is a pair of numbers representing the width and height. +Once the new Surface is created it is independent from the memory of the +bytes passed in.

    +

    The bytes and format passed must compute to the exact size of image +specified. Otherwise a ValueError will be raised.

    +

    See the pygame.image.frombuffer()create a new Surface that shares data inside a bytes buffer method for a potentially faster +way to transfer images into pygame.

    +
    +

    Note

    +

    this function is an alias for fromstring(). The use of this +function is recommended over fromstring() as of pygame 2.1.3. This function was introduced so it matches nicely with other -libraries (PIL, NumPy, etc), and with people's expectations.

    +libraries (PIL, numpy, etc), and with people's expectations.

    -

    New in pygame-ce 2.1.3.

    -
    -
    -

    New in pygame-ce 2.1.4: Added a 'pitch' argument and support for keyword arguments.

    +

    New in pygame 2.1.3.

    @@ -513,15 +431,15 @@ libraries (PIL, NumPy, etc), and with people's expectations.

    pygame.image.frombuffer()
    -
    Create a new Surface that shares data inside a bytes buffer.
    -
    frombuffer(buffer, size, format, pitch=-1) -> Surface
    +
    create a new Surface that shares data inside a bytes buffer
    +
    frombuffer(buffer, size, format) -> Surface

    Create a new Surface that shares pixel data directly from a buffer. This buffer can be bytes, a bytearray, a memoryview, a pygame.BufferProxypygame object to export a surface buffer through an array protocol, or any object that supports the buffer protocol. -This method takes similar arguments to pygame.image.frombytes()Create new Surface from a byte buffer., but +This method takes similar arguments to pygame.image.fromstring()create new Surface from a byte buffer, but is unable to vertically flip the source data.

    -

    This will run much faster than pygame.image.frombytes()Create new Surface from a byte buffer., since no +

    This will run much faster than pygame.image.fromstring()create new Surface from a byte buffer, since no pixel data must be allocated and copied.

    It accepts the following 'format' arguments:

    @@ -535,16 +453,8 @@ pixel data must be allocated and copied.

  • BGRA, 32-bit image with alpha channel, red and blue channels swapped

  • -

    The 'pitch' argument can be used to specify the pitch/stride per horizontal line -of the image buffer in bytes. It must be equal to or greater than how many bytes -the pixel data of each horizontal line in the image buffer occupies without any -extra padding. By default, it is -1, which means that the pitch/stride is -the same size as how many bytes the pure pixel data of each horizontal line takes.

    -

    New in pygame-ce 2.1.3: BGRA format

    -
    -
    -

    New in pygame-ce 2.1.4: Added a 'pitch' argument and support for keyword arguments.

    +

    New in pygame 2.1.3: BGRA format

    @@ -552,33 +462,34 @@ the same size as how many bytes the pure pixel data of each horizontal line take
    pygame.image.load_basic()
    -
    Load new BMP image from a file (or file-like object).
    -
    load_basic(file, /) -> Surface
    +
    load new BMP image from a file (or file-like object)
    +
    load_basic(file) -> Surface

    Load an image from a file source. You can pass either a filename or a Python file-like object, or a pathlib.Path.

    This function only supports loading "basic" image format, ie BMP -format. This function is always available, no matter how pygame was built.

    +format. +This function is always available, no matter how pygame was built.

    pygame.image.load_extended()
    -
    Load an image from a file (or file-like object).
    -
    load_extended(file, namehint='') -> Surface
    -
    -

    This function is similar to pygame.image.load()Load new image from a file (or file-like object)., except that this -function will raise a NotImplementedError if pygame was built without -extended image format support.

    -
    -

    Changed in pygame 2.0.1: This function is always available, but raises an -NotImplementedError if extended image formats are not supported. -Previously, this function may or may not be available, depending on the -state of extended image format support.

    +
    load an image from a file (or file-like object)
    +
    load_extended(filename) -> Surface
    +
    load_extended(fileobj, namehint="") -> Surface
    +

    This function is similar to pygame.image.load()load new image from a file (or file-like object), except that this +function can only be used if pygame was built with extended image format +support.

    -

    Changed in pygame-ce 2.2.0: Now supports keyword arguments.

    +

    Changed in pygame 2.0.1: This function is always available, but raises an +NotImplementedError if extended image formats are +not supported. +Previously, this function may or may not be +available, depending on the state of extended image +format support.

    @@ -586,22 +497,22 @@ state of extended image format support.

    pygame.image.save_extended()
    -
    Save a png/jpg image to file (or file-like object).
    -
    save_extended(surface, file, namehint='') -> None
    +
    save a png/jpg image to file (or file-like object)
    +
    save_extended(Surface, filename) -> None
    +
    save_extended(Surface, fileobj, namehint="") -> None

    This will save your Surface as either a PNG or JPEG image.

    In case the image is being saved to a file-like object, this function uses the namehint argument to determine the format of the file being saved. Saves to JPEG in case the namehint was not specified while saving to a file-like object.

    -
    -

    Changed in pygame 2.0.1: This function is always available, but raises an -NotImplementedError if extended image formats are not supported. -Previously, this function may or may not be available, depending on the -state of extended image format support.

    -
    -

    Changed in pygame-ce 2.2.0: Now supports keyword arguments.

    +

    Changed in pygame 2.0.1: This function is always available, but raises an +NotImplementedError if extended image formats are +not supported. +Previously, this function may or may not be +available, depending on the state of extended image +format support.

    @@ -612,7 +523,7 @@ state of extended image format support.




    -Edit on GitHub +Edit on GitHub
    @@ -633,12 +544,14 @@ state of extended image format support.

  • previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/joystick.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/joystick.html index 4f03866..5fc9703 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/joystick.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/joystick.html @@ -5,14 +5,12 @@ - pygame.joystick — pygame-ce v2.5.8 documentation - - - - - + pygame.joystick — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -222,7 +212,7 @@ that must be lower than this count.

    pygame.joystick.Joystick
    Create a new Joystick object.
    -
    Joystick(id, /) -> Joystick
    +
    Joystick(id) -> Joystick
    @@ -316,11 +306,6 @@ that must be lower than this count.

    - - - -
    — Stop any rumble effect playing
    -—Set the LED color of the joystick

    Create a new joystick to access a physical device. The id argument must be a @@ -328,12 +313,8 @@ value from 0

    Joysticks are initialised on creation and are shut down when deallocated. Once the device is initialized the pygame event queue will start receiving events about its input.

    -
    -

    Changed in pygame 2.0.0: Joystick objects are now opened immediately on creation.

    -
    -

    Changed in pygame-ce 2.1.4: This class is also available through the pygame.Joystick -alias.

    +

    Changed in pygame 2.0.0: Joystick objects are now opened immediately on creation.

    @@ -344,9 +325,9 @@ alias.

    Initialize the joystick, if it has been closed. It is safe to call this even if the joystick is already initialized.

    -
    +

    Deprecated since pygame 2.0.0: In future it will not be possible to reinitialise a closed Joystick -object.

    +object. Will be removed in Pygame 2.1.

    @@ -382,9 +363,9 @@ receive events from the device.

    Returns the original device index for this device. This is the same value that was passed to the Joystick() constructor. This method can safely be called while the Joystick is not initialized.

    -
    +

    Deprecated since pygame 2.0.0: The original device index is not useful in pygame 2. Use -get_instance_id() instead.

    +get_instance_id() instead. Will be removed in Pygame 2.1.

    @@ -397,7 +378,7 @@ safely be called while the Joystick is not initialized.

    Get the joystick instance ID. This matches the instance_id field that is given in joystick events.

    -
    +

    New in pygame 2.0.0dev11.

    @@ -411,7 +392,7 @@ that is given in joystick events.

    Get the GUID string. This identifies the exact hardware of the joystick device.

    -
    +

    New in pygame 2.0.0dev11.

    @@ -426,7 +407,7 @@ device.

    Get a string giving the power status of the device.

    One of: empty, low, medium, full, wired, max, or unknown.

    -
    +

    New in pygame 2.0.0dev11.

    @@ -468,7 +449,7 @@ generate a lot of rapid small motion events.

    get_axis()
    get the current position of an axis
    -
    get_axis(axis_number, /) -> float
    +
    get_axis(axis_number) -> float

    Returns the current position of a joystick axis. The value will range from -1 to 1 with a value of 0 being centered. You may want @@ -499,7 +480,7 @@ rolled. It will report the amount of movement on the trackball.

    get_ball()
    get the relative position of a trackball
    -
    get_ball(ball_number, /) -> x, y
    +
    get_ball(ball_number) -> x, y

    Returns the relative movement of a joystick button. The value is a x, y pair holding the relative movement since the last call to get_ball.

    @@ -524,7 +505,7 @@ event when they are pressed and released.

    get_button()
    get the current button state
    -
    get_button(button, /) -> bool
    +
    get_button(button) -> bool

    Returns the current state of a joystick button.

    @@ -550,7 +531,7 @@ means the hat is centered.

    get_hat()
    get the position of a joystick hat
    -
    get_hat(hat_number, /) -> x, y
    +
    get_hat(hat_number) -> x, y

    Returns the current position of a position hat. The position is given as two values representing the x and y position for the hat. (0, 0) @@ -575,8 +556,8 @@ to 0 will play the effect until another one overwrites it or Joystick.stop_rumble() is called. If an effect is already playing, then it will be overwritten.

    Returns True if the rumble was played successfully or False if the -joystick does not support it.

    -
    +joystick does not support it or pygame.version.SDL()tupled integers of the SDL library version is below 2.0.9.

    +

    New in pygame 2.0.2.

    @@ -590,26 +571,8 @@ joystick does not support it.

    Stops any rumble effect playing on the joystick. See Joystick.rumble() for more information.

    -
    -

    New in pygame 2.0.2.

    -
    - - -
    -
    -set_led()
    -
    -
    Set the LED color of the joystick
    -
    set_led(color_arg) -> bool
    -
    -

    Set the color of the LED on the joystick. The argument is a -pygame.Color-compatible value (alpha being ignored). The -joystick's LED, if it has one, will be set to the input color. -If the joystick does not have an addressable LED, then this -method will do nothing and return False. Returns True if the -LED was set successfully.

    -

    New in pygame-ce 2.5.6.

    +

    New in pygame 2.0.2.

    @@ -622,29 +585,48 @@ LED was set successfully.

    Example code for joystick module.

    -
    import pygame
    +
    import pygame
     
     pygame.init()
     
     
    -def indent(text, indentation_level=0):
    -    return ("    " * indentation_level) + text
    +# This is a simple class that will help us print to the screen.
    +# It has nothing to do with the joysticks, just outputting the
    +# information.
    +class TextPrint:
    +    def __init__(self):
    +        self.reset()
    +        self.font = pygame.font.Font(None, 25)
    +
    +    def tprint(self, screen, text):
    +        text_bitmap = self.font.render(text, True, (0, 0, 0))
    +        screen.blit(text_bitmap, (self.x, self.y))
    +        self.y += self.line_height
    +
    +    def reset(self):
    +        self.x = 10
    +        self.y = 10
    +        self.line_height = 15
    +
    +    def indent(self):
    +        self.x += 10
    +
    +    def unindent(self):
    +        self.x -= 10
     
     
    -def main():
    -    # Set the size of the screen (width, height), and name the window.
    -    size = (500, 700)
    -    screen = pygame.display.set_mode(size)
    +def main():
    +    # Set the width and height of the screen (width, height), and name the window.
    +    screen = pygame.display.set_mode((500, 700))
         pygame.display.set_caption("Joystick example")
     
         # Used to manage how fast the screen updates.
    -    clock = pygame.Clock()
    +    clock = pygame.time.Clock()
     
         # Get ready to print.
    -    font = pygame.font.SysFont(None, 25)
    -    wraplength = size[0] - 20
    +    text_print = TextPrint()
     
    -    # This dict can be left as-is, since pygame-ce will generate a
    +    # This dict can be left as-is, since pygame will generate a
         # pygame.JOYDEVICEADDED event for every joystick connected
         # at the start of the program.
         joysticks = {}
    @@ -674,82 +656,73 @@ LED was set successfully.

    # joystick, filling up the list without needing to create them manually. joy = pygame.joystick.Joystick(event.device_index) joysticks[joy.get_instance_id()] = joy - print(f"Joystick {joy.get_instance_id()} connected") + print(f"Joystick {joy.get_instance_id()} connencted") if event.type == pygame.JOYDEVICEREMOVED: - if event.instance_id in joysticks: - del joysticks[event.instance_id] - print(f"Joystick {event.instance_id} disconnected") - else: - print( - f"Tried to disconnect Joystick {event.instance_id}, " - "but couldn't find it in the joystick list" - ) + del joysticks[event.instance_id] + print(f"Joystick {event.instance_id} disconnected") # Drawing step # First, clear the screen to white. Don't put other drawing commands # above this, or they will be erased with this command. screen.fill((255, 255, 255)) - indentation = 0 - lines = [] + text_print.reset() # Get count of joysticks. joystick_count = pygame.joystick.get_count() - lines.append(indent(f"Number of joysticks: {joystick_count}", indentation)) - indentation += 1 + + text_print.tprint(screen, f"Number of joysticks: {joystick_count}") + text_print.indent() # For each joystick: for joystick in joysticks.values(): jid = joystick.get_instance_id() - lines.append(indent(f"Joystick {jid}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Joystick {jid}") + text_print.indent() # Get the name from the OS for the controller/joystick. name = joystick.get_name() - lines.append(indent(f"Joystick name: {name}", indentation)) + text_print.tprint(screen, f"Joystick name: {name}") guid = joystick.get_guid() - lines.append(indent(f"GUID: {guid}", indentation)) + text_print.tprint(screen, f"GUID: {guid}") power_level = joystick.get_power_level() - lines.append(indent(f"Joystick's power level: {power_level}", indentation)) + text_print.tprint(screen, f"Joystick's power level: {power_level}") # Usually axis run in pairs, up/down for one, and left/right for # the other. Triggers count as axes. axes = joystick.get_numaxes() - lines.append(indent(f"Number of axes: {axes}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Number of axes: {axes}") + text_print.indent() for i in range(axes): axis = joystick.get_axis(i) - lines.append(indent(f"Axis {i} value: {axis:>6.3f}", indentation)) - indentation -= 1 + text_print.tprint(screen, f"Axis {i} value: {axis:>6.3f}") + text_print.unindent() buttons = joystick.get_numbuttons() - lines.append(indent(f"Number of buttons: {buttons}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Number of buttons: {buttons}") + text_print.indent() for i in range(buttons): button = joystick.get_button(i) - lines.append(indent(f"Button {i:>2} value: {button}", indentation)) - indentation -= 1 + text_print.tprint(screen, f"Button {i:>2} value: {button}") + text_print.unindent() hats = joystick.get_numhats() - lines.append(indent(f"Number of hats: {hats}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Number of hats: {hats}") + text_print.indent() # Hat position. All or nothing for direction, not a float like # get_axis(). Position is a tuple of int values (x, y). for i in range(hats): hat = joystick.get_hat(i) - lines.append(indent(f"Hat {i} value: {str(hat)}", indentation)) - indentation -= 2 + text_print.tprint(screen, f"Hat {i} value: {str(hat)}") + text_print.unindent() - # draw the accumulated text - screen.blit( - font.render("\n".join(lines), True, "black", "white", wraplength), (10, 10) - ) + text_print.unindent() # Go ahead and update the screen with what we've drawn. pygame.display.flip() @@ -775,31 +748,26 @@ between pygame 1 and pygame 2. Below are a couple of mappings for three popular

    Nintendo Switch Left Joy-Con (pygame 2.x)

    The Nintendo Switch Left Joy-Con has 4 axes, 11 buttons, and 0 hats. The values for the 4 axes never change. -The controller is recognized as "Wireless Gamepad". -After SDL 2.24.0, The controller is recognized as "Nintendo Switch Joy-Con (L)".

    +The controller is recognized as "Wireless Gamepad"

    • Buttons:

      -
                      After SDL 2.24.0         Before SDL 2.24.0
      -D-pad Up            Button 2                  Button 3
      -D-pad Down          Button 1                  Button 0
      -D-pad Left          Button 3                  Button 2
      -D-pad Right         Button 0                  Button 1
      -SL                  Button 9                  Button 4
      -SR                  Button 10                 Button 5
      --                   Button 6                  Button 8
      -Stick In            Button 7                  Button 10
      -Capture             Button 5                  Button 13
      -L                   Button 17                 Button 14
      -ZL                  Button 19                 Button 15
      +
      D-pad Up        - Button 0
      +D-pad Down      - Button 1
      +D-pad Left      - Button 2
      +D-pad Right     - Button 3
      +SL              - Button 4
      +SR              - Button 5
      +-               - Button 8
      +Stick In        - Button 10
      +Capture         - Button 13
      +L               - Button 14
      +ZL              - Button 15
       
    • -
    -

    Reference : D-pad Up points toward SL and SR buttons.

    -
    • Hat/JoyStick:

      -
      Down -> Up      -    Axis 1                    Axis Y
      -Left -> Right   -    Axis 0                    Axis X
      +
      Down -> Up      - Y Axis
      +Left -> Right   - X Axis
       
    • @@ -808,72 +776,26 @@ After SDL 2.24.0, The controller is recognized as "Nintendo Switch Joy-Con

      Nintendo Switch Right Joy-Con (pygame 2.x)

      The Nintendo Switch Right Joy-Con has 4 axes, 11 buttons, and 0 hats. The values for the 4 axes never change. -The controller is recognized as "Wireless Gamepad". -After SDL 2.24.0, The controller is recognized as "Nintendo Switch Joy-Con (R)".

      +The controller is recognized as "Wireless Gamepad"

      • Buttons:

        -
                      After SDL 2.24.0         Before SDL 2.24.0
        -A Button          Button 1                 Button 0
        -B Button          Button 3                 Button 2
        -X Button          Button 0                 Button 1
        -Y Button          Button 2                 Button 3
        -SL                Button 9                 Button 4
        -SR                Button 10                Button 5
        -+                 Button 6                 Button 9
        -Stick In          Button 7                 Button 11
        -Home              Button 5                 Button 12
        -R                 Button 16                Button 14
        -ZR                Button 18                Button 15
        +
        A Button        - Button 0
        +B Button        - Button 1
        +X Button        - Button 2
        +Y Button        - Button 3
        +SL              - Button 4
        +SR              - Button 5
        ++               - Button 9
        +Stick In        - Button 11
        +Home            - Button 12
        +R               - Button 14
        +ZR              - Button 15
         
      • Hat/JoyStick:

        -
        Down -> Up      -  Axis 1                   Axis Y
        -Left -> Right   -  Axis 0                   Axis X
        -
        -
        -
      • -
      -
      -
      -

      Nintendo Switch Left/Right Joy-Con (after SDL 2.24.0)

      -

      This device is created, if Nintendo Switch Joy-con Left and Nintendo Switch Joy-con Right are connected (these two devices are removed). -The Nintendo Switch Left/Right Joy-Con has 6 axes, 20 buttons, and 0 hats. The values for the 6 axes never change. -The controller is recognized as "Nintendo Switch Joy-Con (L/R)".

      -
        -
      • Left Stick:

        -
        Left -> Right   - Axis 0
        -Up -> Down      - Axis 1
        -
        -
        -
      • -
      • Right Stick:

        -
        Left -> Right   - Axis 2
        -Up -> Down      - Axis 3
        -
        -
        -
      • -
      • Buttons:

        -
        A Button        - Button 0
        -B Button        - Button 1
        -X Button        - Button 2
        -Y Button        - Button 3
        -- Button        - Button 4
        -Home Button     - Button 5
        -+ Button        - Button 6
        -ZL              - Button ? Missing
        -ZR              - Button ? Missing
        -L. Stick In     - Button 9
        -R. Stick In     - Button 10
        -D-pad Up        - Button 11
        -D-pad Down      - Button 12
        -D-pad Left      - Button 13
        -D-pad Right     - Button 14
        -Capture Button  - Button 15
        -Right SR        - Button 16
        -Left SL         - Button 17
        -Right SL        - Button 18
        -Left SR         - Button 19
        +
        Down -> Up      - Y Axis
        +Left -> Right   - X Axis
         
      • @@ -1027,6 +949,58 @@ The controller is recognized as "PS4 Controller".

      +
      +

      Playstation 5 Controller (pygame 2.x)

      +

      The PlayStation 5 controller mapping has 6 axes, 13 buttons, and 1 hat. +The controller is recognized as "Sony Interactive Entertainment Wireless Controller".

      +
        +
      • Left Stick:

        +
        Left -> Right   - Axis 0
        +Up   -> Down    - Axis 1
        +
        +
        +
      • +
      • Right Stick:

        +
        Left -> Right   - Axis 3
        +Up   -> Down    - Axis 4
        +
        +
        +
      • +
      • Left Trigger:

        +
        Out -> In       - Axis 2
        +
        +
        +
      • +
      • Right Trigger:

        +
        Out -> In       - Axis 5
        +
        +
        +
      • +
      • Buttons:

        +
        Cross Button    - Button 0
        +Circle Button   - Button 1
        +Square Button   - Button 2
        +Triangle Button - Button 3
        +Left Bumper     - Button 4
        +Right Bumper    - Button 5
        +Left Trigger    - Button 6
        +Right Trigger   - Button 7
        +Share Button    - Button 8
        +Options Button  - Button 9
        +PS Button       - Button 10
        +Left Stick in   - Button 11
        +Right Stick in  - Button 12
        +
        +
        +
      • +
      • Hat/D-pad:

        +
        Down -> Up      - Y Axis
        +Left -> Right   - X Axis
        +
        +
        +
      • +
      +

      XBox 360 Controller (pygame 1.x)

      The Xbox 360 controller mapping has 5 axes, 10 buttons, and 1 hat. @@ -1129,7 +1103,7 @@ The controller is recognized as "Wireless Controller".




      -Edit on GitHub +Edit on GitHub
    @@ -1150,12 +1124,14 @@ The controller is recognized as "Wireless Controller".

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/key.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/key.html index 5e618b7..01a0a5e 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/key.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/key.html @@ -5,14 +5,12 @@ - pygame.key — pygame-ce v2.5.8 documentation - - - - - + pygame.key — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,74 +97,64 @@
    pygame.key
    -
    Pygame module to work with the keyboard.
    +
    pygame module to work with the keyboard
    - + - - - - - - - - - + - + - + - + - + - + - + - + - + - +
    —True if the display is receiving keyboard input from the system.true if the display is receiving keyboard input from the system
    —Get the state of all keyboard buttons.
    -—Returns a ScancodeWrapper containing the most recent key presses.
    -—Returns a ScancodeWrapper containing the most recent key releases.get the state of all keyboard buttons
    —Determine which modifier keys are being held.determine which modifier keys are being held
    —Temporarily set which modifier keys are pressed.temporarily set which modifier keys are pressed
    —Control how held keys are repeated.control how held keys are repeated
    —See how held keys are repeated.see how held keys are repeated
    —Get the name of a key identifier.get the name of a key identifier
    —Get the key identifier from a key name.get the key identifier from a key name
    —Start handling Unicode text input events.start handling Unicode text input events
    —Stop handling Unicode text input events.stop handling Unicode text input events
    —Controls the position of the candidate list.controls the position of the candidate list
    @@ -201,7 +181,7 @@ keyboard to keyboard, but is useful for key selection of weird keys like the multimedia keys

    -
    +

    New in pygame 2.0.0: The pygame.TEXTINPUT event is preferred to the unicode attribute of pygame.KEYDOWN. The attribute text contains the input.

    @@ -398,7 +378,7 @@ for KMOD_NONE pygame.key.get_focused()
    -
    True if the display is receiving keyboard input from the system.
    +
    true if the display is receiving keyboard input from the system
    get_focused() -> bool

    Returns True when the display window has keyboard focus from the @@ -410,8 +390,8 @@ can use pygame.key.get_pressed()

    -
    Get the state of all keyboard buttons.
    -
    get_pressed() -> ScancodeWrapper
    +
    get the state of all keyboard buttons
    +
    get_pressed() -> bools

    Returns a sequence of boolean values representing the state of every key on the keyboard. Use the key constant values to index the array. A True @@ -426,78 +406,14 @@ translate these pushed keys into a fully translated character value. See the pygame.KEYDOWN events on the pygame.eventpygame module for interacting with events and queues queue for this functionality.

    -
    -

    Changed in pygame-ce 2.1.4: The collection of bools returned by get_pressed can not be iterated +

    +

    New in pygame 2.2.0: The collection of bools returned by get_pressed can not be iterated over because the indexes of the internal tuple does not correspond to the keycodes.

    - - -
    -
    -pygame.key.get_just_pressed()
    -
    -
    Returns a ScancodeWrapper containing the most recent key presses.
    -
    get_just_pressed() -> ScancodeWrapper
    -
    -

    Returns a mapping from key codes to booleans indicating which keys were -newly pressed as of the last time events were processed. This can be used -as a convenience function to detect keys that were pressed "this frame."

    -

    The result of this function is updated when new events are processed, -e.g. in pygame.event.get()get events from the queue or pygame.event.pump()internally process pygame event handlers.

    -

    A key can be marked as "just pressed" even if it is not currently pressed -according to pygame.key.get_pressed()Get the state of all keyboard buttons., if it was pressed and released -again during the same frame. Multiple presses and releases of the same key -are not distinguished from a single press with this function.

    - -
    -

    Note

    -

    If you require getting the key presses in order, use the event queue -KEYDOWN events

    -
    -
    if pygame.key.get_just_pressed()[pygame.K_b]:
    -   print("B key just pressed")
    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -pygame.key.get_just_released()
    -
    -
    Returns a ScancodeWrapper containing the most recent key releases.
    -
    get_just_released() -> ScancodeWrapper
    -
    -

    Returns a mapping from key codes to booleans indicating which keys were -newly released as of the last time events were processed. This can be used -as a convenience function to detect keys that were released "this frame."

    -

    The result of this function is updated when new events are processed, -e.g. in pygame.event.get()get events from the queue or pygame.event.pump()internally process pygame event handlers.

    -

    A key can be marked as "just released" even if it is currently pressed -according to pygame.key.get_pressed()Get the state of all keyboard buttons., if it was released and pressed -again during the same frame. Multiple releases and presses of the same key -are not distinguished from a single release with this function.

    - -
    -

    Note

    -

    If you require getting the key releases in order, use the event queue -KEYUP events.

    -
    -
    if pygame.key.get_just_released()[pygame.K_b]:
    -   print("B key just released")
    -
    -
    -
    -

    New in pygame-ce 2.4.0.

    +

    New in pygame 2.5.0: Iteration over the collection of bools returned by get_pressed is now +restored. However it still does not make sense to iterate over it. Currently.

    @@ -505,7 +421,7 @@ are not distinguished from a single release with this function.

    pygame.key.get_mods()
    -
    Determine which modifier keys are being held.
    +
    determine which modifier keys are being held
    get_mods() -> int

    Returns a single integer representing a bitmask of all the modifier keys @@ -517,8 +433,8 @@ being held. Using bitwise operators you can test if specific

    pygame.key.set_mods()
    -
    Temporarily set which modifier keys are pressed.
    -
    set_mods(mods, /) -> None
    +
    temporarily set which modifier keys are pressed
    +
    set_mods(int) -> None

    Create a bitmask of the modifier key constants you want to impose on your program.

    @@ -528,8 +444,10 @@ you want to impose on your program.

    pygame.key.set_repeat()
    -
    Control how held keys are repeated.
    -
    set_repeat(delay=0, interval=0, /) -> None
    +
    control how held keys are repeated
    +
    set_repeat() -> None
    +
    set_repeat(delay) -> None
    +
    set_repeat(delay, interval) -> None

    When the keyboard repeat is enabled, keys that are held down will generate multiple pygame.KEYDOWN events. The delay parameter is the number of @@ -546,7 +464,7 @@ set to 0.

    ValueError -- if delay or interval is < 0

    -
    +

    Changed in pygame 2.0.0: A ValueError is now raised (instead of a pygame.error) if delay or interval is < 0.

    @@ -556,12 +474,12 @@ set to 0.

    pygame.key.get_repeat()
    -
    See how held keys are repeated.
    -
    get_repeat() -> tuple[int, int]
    +
    see how held keys are repeated
    +
    get_repeat() -> (delay, interval)

    Get the delay and interval keyboard repeat values. Refer to -pygame.key.set_repeat()Control how held keys are repeated. for a description of these values.

    -
    +pygame.key.set_repeat()control how held keys are repeated for a description of these values.

    +

    New in pygame 1.8.

    @@ -570,7 +488,7 @@ set to 0.

    pygame.key.name()
    -
    Get the name of a key identifier.
    +
    get the name of a key identifier
    name(key, use_compat=True) -> str

    Get the descriptive name of the button from a keyboard button id constant. @@ -580,6 +498,8 @@ returns the legacy name of a key where applicable. The return value is expected to be the same across different pygame versions (provided the corresponding key constant exists and is unique). If the return value is passed to the key_code function, the original constant will be returned.

    +

    Experimental: use_compat parameter still in development for testing and feedback. It may change. +Please leave use_compat feedback with authors

    If this argument is False, the returned name may be prettier to display and may cover a wider range of keys than with use_compat, but there are no guarantees that this name will be the same across different pygame @@ -587,7 +507,7 @@ versions. If the name returned is passed to the -

    Changed in pygame-ce 2.1.3: Added use_compat argument and guaranteed API stability for it

    +

    Changed in pygame 2.1.3: Added use_compat argument and guaranteed API stability for it

    @@ -595,8 +515,8 @@ may change later, do not rely on this)

    pygame.key.key_code()
    -
    Get the key identifier from a key name.
    -
    key_code(name) -> int
    +
    get the key identifier from a key name
    +
    key_code(name=string) -> int

    Get the key identifier code from the descriptive name of the key. This returns an integer matching one of the K_* keycodes. For example:

    @@ -613,7 +533,7 @@ returns an integer matching one of the K_* keycodes. For example:

    ValueError -- if the key name is not known.

    -
    +

    New in pygame 2.0.0.

    @@ -622,7 +542,7 @@ returns an integer matching one of the K_* keycodes. For example:

    pygame.key.start_text_input()
    -
    Start handling Unicode text input events.
    +
    start handling Unicode text input events
    start_text_input() -> None

    Start receiving pygame.TEXTEDITING and pygame.TEXTINPUT @@ -642,11 +562,7 @@ and editing startpygame.TEXTINPUT event is generated.

    Text input events handling is on by default.

    - -
    +

    New in pygame 2.0.0.

    @@ -655,18 +571,18 @@ a pygame.TEXTINPUT<
    pygame.key.stop_text_input()
    -
    Stop handling Unicode text input events.
    +
    stop handling Unicode text input events
    stop_text_input() -> None

    Stop receiving pygame.TEXTEDITING and pygame.TEXTINPUT events. If an on-screen keyboard or IME editor was shown with -pygame.key.start_text_input()Start handling Unicode text input events., hide it again.

    +pygame.key.start_text_input(), hide it again.

    Text input events handling is on by default.

    To avoid triggering the IME editor or the on-screen keyboard when the user is holding down a key during gameplay, text input should be disabled once text entry is finished, or when the user clicks outside of a text box.

    -
    +

    New in pygame 2.0.0.

    @@ -675,12 +591,12 @@ clicks outside of a text box.

    pygame.key.set_text_input_rect()
    -
    Controls the position of the candidate list.
    -
    set_text_input_rect(rect, /) -> None
    +
    controls the position of the candidate list
    +
    set_text_input_rect(Rect) -> None

    This sets the rectangle used for typing with an IME. It controls where the candidate list will open, if supported.

    -
    +

    New in pygame 2.0.0.

    @@ -692,7 +608,7 @@ It controls where the candidate list will open, if supported.




    -Edit on GitHub +Edit on GitHub
    @@ -713,12 +629,14 @@ It controls where the candidate list will open, if supported.

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/locals.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/locals.html index cfca1d0..6ffbbbf 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/locals.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/locals.html @@ -5,14 +5,12 @@ - pygame.locals — pygame-ce v2.5.8 documentation - - - - - + pygame.locals — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -114,16 +104,16 @@ automatically placed in the pygame module namespace. However, an application can use pygame.locals to include only the pygame constants with a from pygame.locals import *.

    Detailed descriptions of the various constants can be found throughout the -pygame-ce documentation. Here are the locations of some of them.

    +pygame documentation. Here are the locations of some of them.

    @@ -133,7 +123,7 @@ the KEYDOWN<


    -Edit on GitHub +Edit on GitHub
    @@ -154,12 +144,14 @@ the KEYDOWN<
  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mask.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mask.html index 874e132..2ee1626 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mask.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mask.html @@ -5,14 +5,12 @@ - pygame.mask — pygame-ce v2.5.8 documentation - - - - - + pygame.mask — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,36 +97,36 @@
    pygame.mask
    -
    Pygame module for image masks.
    +
    pygame module for image masks.
    - + - + - +
    —Creates a Mask from the given surface.Creates a Mask from the given surface
    —Creates a mask by thresholding Surfaces.Creates a mask by thresholding Surfaces
    —Pygame object for representing 2D bitmasks.pygame object for representing 2D bitmasks

    Useful for fast pixel perfect collision detection. A mask uses 1 bit per-pixel to store which parts collide.

    -
    +

    New in pygame 1.8.

    -
    +

    Changed in pygame 2.0.2: Mask functions now support keyword arguments.

    -
    +

    Changed in pygame 2.0.2: Mask functions that take positions or offsets now support pygame.math.Vector2a 2-Dimensional Vector arguments.

    @@ -144,7 +134,8 @@ support pygame.mask.from_surface()
    -
    Creates a Mask from the given surface.
    +
    Creates a Mask from the given surface
    +
    from_surface(surface) -> Mask
    from_surface(surface, threshold=127) -> Mask

    Creates a Mask object from the given surface by setting all the @@ -184,7 +175,8 @@ color-keyed this parameter is ignored

    pygame.mask.from_threshold()
    -
    Creates a mask by thresholding Surfaces.
    +
    Creates a mask by thresholding Surfaces
    +
    from_threshold(surface, color) -> Mask
    from_threshold(surface, color, threshold=(0, 0, 0, 255), othersurface=None, palette_colors=1) -> Mask

    This is a more featureful method of getting a Mask from a surface.

    @@ -197,10 +189,10 @@ that is within the <
    Parameters:
    • surface (Surface) -- the surface to create the mask from

    • -
    • color (pygame.typing.ColorLike) -- color used to check if the surface's pixels are within the +

    • color (Color or int or tuple(int, int, int, [int]) or list[int, int, int, [int]]) -- color used to check if the surface's pixels are within the given threshold range, this parameter is ignored if the optional othersurface parameter is supplied

    • -
    • threshold (pygame.typing.ColorLike) -- (optional) the threshold range used to check the difference +

    • threshold (Color or int or tuple(int, int, int, [int]) or list[int, int, int, [int]]) -- (optional) the threshold range used to check the difference between two colors (default is (0, 0, 0, 255))

    • othersurface (Surface) -- (optional) used to check whether the pixels of the first surface are within the given threshold range of the pixels @@ -223,125 +215,126 @@ colors or not, a nonzero value causes the palette colors to be used and a

      pygame.mask.Mask
      -
      Pygame object for representing 2D bitmasks.
      -
      Mask(size, fill=False) -> Mask
      +
      pygame object for representing 2D bitmasks
      +
      Mask(size=(width, height)) -> Mask
      +
      Mask(size=(width, height), fill=False) -> Mask
      - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - +
      —Returns a new copy of the mask.Returns a new copy of the mask
      —Returns the size of the mask.Returns the size of the mask
      —Returns a Rect based on the size of the mask.Returns a Rect based on the size of the mask
      —Gets the bit at the given position.Gets the bit at the given position
      —Sets the bit at the given position.Sets the bit at the given position
      —Returns the point of intersection.Returns the point of intersection
      —Returns the number of overlapping set bits.Returns the number of overlapping set bits
      —Returns a mask of the overlapping set bits.Returns a mask of the overlapping set bits
      —Sets all bits to 1.Sets all bits to 1
      —Sets all bits to 0.Sets all bits to 0
      —Flips all the bits.Flips all the bits
      —Resizes a mask.Resizes a mask
      —Draws a mask onto another.Draws a mask onto another
      —Erases a mask from another.Erases a mask from another
      —Returns the number of set bits.Returns the number of set bits
      —Returns the centroid of the set bits.Returns the centroid of the set bits
      —Returns the orientation of the set bits.Returns the orientation of the set bits
      —Returns a list of points outlining an object.Returns a list of points outlining an object
      —Returns the convolution of this mask with another mask.Returns the convolution of this mask with another mask
      —Returns a mask containing a connected component.Returns a mask containing a connected component
      —Returns a list of masks of connected components.Returns a list of masks of connected components
      —Returns a list of bounding rects of connected components.Returns a list of bounding rects of connected components
      —Returns a surface with the mask drawn on it.Returns a surface with the mask drawn on it
      @@ -352,11 +345,11 @@ with other masks and their set bits.

      A filled mask has all of its bits set to 1, conversely an unfilled/cleared/empty mask has all of its bits set to 0. Masks can be created unfilled (default) or filled by using the fill parameter. Masks -can also be cleared or filled using the pygame.mask.Mask.clear()Sets all bits to 0. and -pygame.mask.Mask.fill()Sets all bits to 1. methods respectively.

      +can also be cleared or filled using the pygame.mask.Mask.clear()Sets all bits to 0 and +pygame.mask.Mask.fill()Sets all bits to 1 methods respectively.

      A mask's coordinates start in the top left corner at (0, 0) just like -pygame.SurfacePygame object for representing images.. Individual bits can be accessed using the -pygame.mask.Mask.get_at()Gets the bit at the given position. and pygame.mask.Mask.set_at()Sets the bit at the given position. +pygame.Surfacepygame object for representing images. Individual bits can be accessed using the +pygame.mask.Mask.get_at()Gets the bit at the given position and pygame.mask.Mask.set_at()Sets the bit at the given position methods.

      The methods overlap(), overlap_area(), overlap_mask(), draw(), erase(), and convolve() use an offset parameter @@ -390,21 +383,21 @@ filled mask (True

      Mask

      -
      +

      Changed in pygame 2.0.0: Shallow copy support added. The Mask class supports the special method __copy__() and shallow copying via copy.copy(mask).

      -
      +

      Changed in pygame 2.0.0: Subclassing support added. The Mask class can be used as a base class.

      -
      +

      Changed in pygame 1.9.5: Added support for keyword arguments.

      -
      +

      Changed in pygame 1.9.5: Added the optional keyword parameter fill.

      -
      +

      Changed in pygame 1.9.5: Added support for masks with a width and/or a height of 0.

      @@ -412,7 +405,7 @@ height of 0.

      copy()
      -
      Returns a new copy of the mask.
      +
      Returns a new copy of the mask
      copy() -> Mask
      @@ -430,15 +423,15 @@ height, and set/unset bits as the original

      then it should override the __copy__() method. The overridden __copy__() method needs to call super().__copy__() and then copy the required data as in the following example code.

      -
      class SubMask(pygame.mask.Mask):
      -    def __copy__(self):
      +
      class SubMask(pygame.mask.Mask):
      +    def __copy__(self):
               new_mask = super().__copy__()
               # Do any SubMask attribute copying here.
               return new_mask
       
      -
      +

      New in pygame 2.0.0.

      @@ -447,8 +440,8 @@ copy the required data as in the following example code.

      get_size()
      -
      Returns the size of the mask.
      -
      get_size() -> tuple[int, int]
      +
      Returns the size of the mask
      +
      get_size() -> (width, height)
      Returns:
      @@ -464,31 +457,31 @@ copy the required data as in the following example code.

      get_rect()
      -
      Returns a Rect based on the size of the mask.
      +
      Returns a Rect based on the size of the mask
      get_rect(**kwargs) -> Rect
      -

      Returns a new pygame.Rectpygame object for storing rectangular coordinates object based on the size of this mask. +

      Returns a new pygame.Rect()pygame object for storing rectangular coordinates object based on the size of this mask. The rect's default position will be (0, 0) and its default width and height will be the same as this mask's. The rect's attributes can be -altered via pygame.Rectpygame object for storing rectangular coordinates attribute keyword arguments/values passed +altered via pygame.Rect()pygame object for storing rectangular coordinates attribute keyword arguments/values passed into this method. As an example, a_mask.get_rect(center=(10, 5)) would -create a pygame.Rectpygame object for storing rectangular coordinates based on the mask's size centered at the +create a pygame.Rect()pygame object for storing rectangular coordinates based on the mask's size centered at the given position.

      Parameters:
      -

      kwargs (dict) -- pygame.Rectpygame object for storing rectangular coordinates attribute keyword arguments/values +

      kwargs (dict) -- pygame.Rect()pygame object for storing rectangular coordinates attribute keyword arguments/values that will be applied to the rect

      Returns:
      -

      A new pygame.Rectpygame object for storing rectangular coordinates object based on the size of this mask -with any pygame.Rectpygame object for storing rectangular coordinates attribute keyword arguments/values applied +

      a new pygame.Rect()pygame object for storing rectangular coordinates object based on the size of this mask +with any pygame.Rect()pygame object for storing rectangular coordinates attribute keyword arguments/values applied to it

      Return type:

      Rect

      -
      +

      New in pygame 2.0.0.

      @@ -497,7 +490,7 @@ to it

      get_at()
      -
      Gets the bit at the given position.
      +
      Gets the bit at the given position
      get_at(pos) -> int
      @@ -520,7 +513,8 @@ to it

      set_at()
      -
      Sets the bit at the given position.
      +
      Sets the bit at the given position
      +
      set_at(pos) -> None
      set_at(pos, value=1) -> None
      @@ -547,8 +541,9 @@ bit to 0 (default is 1)

    • overlap()
      -
      Returns the point of intersection.
      -
      overlap(other, offset) -> tuple[int, int] | None
      +
      Returns the point of intersection
      +
      overlap(other, offset) -> (x, y)
      +
      overlap(other, offset) -> None

      Returns the first point of intersection encountered between this mask and other. A point of intersection is 2 overlapping set bits.

      @@ -582,10 +577,10 @@ details refer to the overlap_area()
      -
      Returns the number of overlapping set bits.
      -
      overlap_area(other, offset) -> int
      +
      Returns the number of overlapping set bits
      +
      overlap_area(other, offset) -> numbits
      -

      Returns the number of overlapping set bits between this mask and +

      Returns the number of overlapping set bits between between this mask and other.

      This can be useful for collision detection. An approximate collision normal can be found by calculating the gradient of the overlapping area @@ -615,7 +610,7 @@ details refer to the overlap_mask()

      -
      Returns a mask of the overlapping set bits.
      +
      Returns a mask of the overlapping set bits
      overlap_mask(other, offset) -> Mask

      Returns a Mask, the same size as this mask, containing the @@ -641,7 +636,7 @@ details refer to the fill()

      -
      Sets all bits to 1.
      +
      Sets all bits to 1
      fill() -> None

      Sets all bits in the mask to 1.

      @@ -659,7 +654,7 @@ details refer to the clear()
      -
      Sets all bits to 0.
      +
      Sets all bits to 0
      clear() -> None

      Sets all bits in the mask to 0.

      @@ -677,7 +672,7 @@ details refer to the invert()
      -
      Flips all the bits.
      +
      Flips all the bits
      invert() -> None

      Flips all of the bits in the mask. All the set bits are cleared to 0 and @@ -696,14 +691,14 @@ all the unset bits are set to 1.

      scale()
      -
      Resizes a mask.
      -
      scale(scale) -> Mask
      +
      Resizes a mask
      +
      scale((width, height)) -> Mask

      Creates a new Mask of the requested size with its bits scaled from this mask.

      Parameters:
      -

      scale -- the width and height (size) of the mask to create

      +

      size -- the width and height (size) of the mask to create

      Returns:

      a new Mask object with its bits scaled from this mask

      @@ -721,10 +716,10 @@ from this mask.

      draw()
      -
      Draws a mask onto another.
      +
      Draws a mask onto another
      draw(other, offset) -> None
      -

      Performs a bitwise OR, drawing other onto this mask.

      +

      Performs a bitwise OR, drawing othermask onto this mask.

      Parameters:
        @@ -746,7 +741,7 @@ details refer to the erase()
        -
        Erases a mask from another.
        +
        Erases a mask from another
        erase(other, offset) -> None

        Erases (clears) all bits set in other from this mask.

        @@ -771,8 +766,8 @@ details refer to the count()
        -
        Returns the number of set bits.
        -
        count() -> int
        +
        Returns the number of set bits
        +
        count() -> bits
        Returns:
        @@ -788,8 +783,8 @@ details refer to the centroid()
        -
        Returns the centroid of the set bits.
        -
        centroid() -> tuple[int, int]
        +
        Returns the centroid of the set bits
        +
        centroid() -> (x, y)

        Finds the centroid (the center mass of the set bits) for this mask.

        @@ -807,8 +802,8 @@ return (0, <
        angle()
        -
        Returns the orientation of the set bits.
        -
        angle() -> float
        +
        Returns the orientation of the set bits
        +
        angle() -> theta

        Finds the approximate orientation (from -90 to 90 degrees) of the set bits in the mask. This works best if performed on a mask with only one @@ -833,8 +828,9 @@ component is calculated.

        outline()
        -
        Returns a list of points outlining an object.
        -
        outline(every=1) -> list[tuple[int, int]]
        +
        Returns a list of points outlining an object
        +
        outline() -> [(x, y), ...]
        +
        outline(every=1) -> [(x, y), ...]

        Returns a list of points of the outline of the first connected component encountered in the mask. To find a connected component, the mask is @@ -866,7 +862,8 @@ component is calculated.

        convolve()
        -
        Returns the convolution of this mask with another mask.
        +
        Returns the convolution of this mask with another mask
        +
        convolve(other) -> Mask
        convolve(other, output=None, offset=(0, 0)) -> Mask

        Convolve this mask with the given other Mask.

        @@ -899,8 +896,9 @@ returned.

        connected_component()
        -
        Returns a mask containing a connected component.
        -
        connected_component(pos=...) -> Mask
        +
        Returns a mask containing a connected component
        +
        connected_component() -> Mask
        +
        connected_component(pos) -> Mask

        A connected component is a group (1 or more) of connected set bits (orthogonally and diagonally). The SAUF algorithm, which checks 8 point @@ -938,8 +936,9 @@ mask's bounds

        connected_components()
        -
        Returns a list of masks of connected components.
        -
        connected_components(minimum=0) -> list[Mask]
        +
        Returns a list of masks of connected components
        +
        connected_components() -> [Mask, ...]
        +
        connected_components(minimum=0) -> [Mask, ...]

        Provides a list containing a Mask object for each connected component.

        @@ -969,8 +968,8 @@ component is calculated.

        get_bounding_rects()
        -
        Returns a list of bounding rects of connected components.
        -
        get_bounding_rects() -> list[Rect]
        +
        Returns a list of bounding rects of connected components
        +
        get_bounding_rects() -> [Rect, ...]

        Provides a list containing a bounding rect for each connected component.

        @@ -993,8 +992,9 @@ component is calculated.

        to_surface()
        -
        Returns a surface with the mask drawn on it.
        -
        to_surface(surface=None, setsurface=None, unsetsurface=None, setcolor=(255, 255, 255, 255), unsetcolor=(0, 0, 0, 255), dest=(0, 0), area=None) -> Surface
        +
        Returns a surface with the mask drawn on it
        +
        to_surface() -> Surface
        +
        to_surface(surface=None, setsurface=None, unsetsurface=None, setcolor=(255, 255, 255, 255), unsetcolor=(0, 0, 0, 255), dest=(0, 0)) -> Surface

        Draws this mask on the given surface. Set bits (bits set to 1) and unset bits (bits set to 0) can be drawn onto a surface.

        @@ -1012,11 +1012,13 @@ mask any bits outside its bounds will use the Surface or None) -- (optional) use this surface's color values to draw unset bits (default is None), if this surface is smaller than the mask any bits outside its bounds will use the unsetcolor value

        -
      • setcolor (pygame.typing.ColorLike or None) -- (optional) color to draw set bits (default is +

      • setcolor (Color or str or int or tuple(int, int, int, [int]) or +list(int, int, int, [int]) or None) -- (optional) color to draw set bits (default is (255, 255, 255, 255), white), use None to skip drawing the set bits, the setsurface parameter (if set) will takes precedence over this parameter

      • -
      • unsetcolor (pygame.typing.ColorLike or None) -- (optional) color to draw unset bits (default is +

      • unsetcolor (Color or str or int or tuple(int, int, int, [int]) or +list(int, int, int, [int]) or None) -- (optional) color to draw unset bits (default is (0, 0, 0, 255), black), use None to skip drawing the unset bits, the unsetsurface parameter (if set) will takes precedence over this parameter

      • @@ -1030,13 +1032,6 @@ position the mask on the surface, it does not offset the unsetsurface from the mask, they are always aligned with the mask (i.e. position (0, 0) on the mask always corresponds to position (0, 0) on the setsurface and unsetsurface)

        -
      • area (Rect or rect-like object) -- (optional) rectangular portion of the mask to draw. It can be a -rect-like object (a Rect, a tuple or a list with 4 numbers or an object with a -rect attribute, etc) or it can be None (the default) in which case it will use the -entire mask. If the given rect protrudes outside the bounds of the mask (as returned -by get_rect()), it will get clipped to fit those boundaries. If the final rect -is smaller than the mask and no destination surface is given, the returned surface -will have the same size as this final rect.

      Returns:
      @@ -1066,12 +1061,9 @@ be NoneNone, but unsetcolor defaults to a color value and therefore must be set to None.

    -
    +

    New in pygame 2.0.0.

    -
    -

    Changed in pygame-ce 2.5.6: Added the area keyword argument.

    -
    @@ -1083,7 +1075,7 @@ therefore must be set to

    -Edit on GitHub +Edit on GitHub
    @@ -1104,12 +1096,14 @@ therefore must be set to previous | - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/math.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/math.html index 8efb517..df8d956 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/math.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/math.html @@ -5,14 +5,12 @@ - pygame.math — pygame-ce v2.5.8 documentation - - - - - + pygame.math — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,41 +97,26 @@
    pygame.math
    -
    Pygame module for vector classes.
    +
    pygame module for vector classes
    - + - + - - - - - - - - - - - - - - @@ -170,77 +145,40 @@ subscripts

    v.z==v[2] -

    Multiple coordinates can be set and retrieved using slices or swizzling.

    +

    Multiple coordinates can be set using slices or swizzling

    v = pygame.Vector2()
     v.xy = 1, 2
     v[:] = 1, 2
    -print(v)  # Vector2(1, 2)
    -print(v.x)  # 1.0
    -print(v.y)  # 2.0
    -print(v.xy)  # Vector2(1, 2)
    -print(v.yx)  # Vector2(2, 1)
    -print(v.xyyx)  # (1.0, 2.0, 2.0, 1.0)
     
    -

    Note above, that swizzling with 2 components will return a Vector2 instance, -swizzling with 3 components will return a Vector3 instance, and swizzles of 4 -or more components will result in a tuple. But since vectors support the -iterator protocol, they can be unpacked, or converted to lists or tuples.

    -
    v = Vector2(1, 2)
    -print(*v)  # 1.0 2.0
    -print(tuple(v))  # (1.0, 2.0)
    -print(tuple(v.yx))  # (2.0, 1.0)
    -
    -
    -

    A vector can be converted to other data types using the built-in constructors

    -
    v = pygame.Vector2(1, 2)
    -
    -list(v) == [1.0, 2.0]
    -tuple(v) == (1.0, 2.0)
    -set(v) == {1.0, 2.0}
    -
    -
    -

    Conversion can be combined with swizzling or slicing to create a new order

    -
    v = pygame.Vector3(1, 2, 3)
    -
    -list(v.xz) == [1.0, 3.0]
    -list(v.zyx) == [3.0, 2.0, 1.0]
    -list(v.yyy) == [2.0, 2.0, 2.0]
    -tuple(v.xyyzzz) == (1.0, 2.0, 2.0, 3.0, 3.0, 3.0)
    -tuple(v.zxyxzzyx) == (3.0, 1.0, 2.0, 1.0, 3.0, 3.0, 2.0, 1.0)
    -set(v.yxzxzyzxyx) == {1.0, 2.0, 3.0} # sets remove duplicates
    -
    -list(v[:]) == [1.0, 2.0, 3.0]
    -tuple(v[::-1]) == (3.0, 2.0, 1.0)
    -set(v[1:3]) == {2.0, 3.0}
    -
    -
    -
    +

    New in pygame 1.9.2pre.

    -
    +

    Changed in pygame 1.9.4: Removed experimental notice.

    -
    +

    Changed in pygame 1.9.4: Allow scalar construction like GLSL Vector2(2) == Vector2(2.0, 2.0)

    -
    -

    Changed in pygame 1.9.4: pygame.mathPygame module for vector classes. import not required. More convenient pygame.Vector2 and pygame.Vector3.

    +
    +

    Changed in pygame 1.9.4: pygame.mathpygame module for vector classes import not required. More convenient pygame.Vector2 and pygame.Vector3.

    -

    Changed in pygame-ce 2.1.4: round returns a new vector with components rounded to the specified digits.

    +

    Changed in pygame 2.2.0: round returns a new vector with components rounded to the specified digits.

    pygame.math.clamp()
    -
    Returns value clamped to min and max.
    -
    clamp(value, min, max, /) -> float
    +
    returns value clamped to min and max.
    +
    clamp(value, min, max) -> float
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave clamp feedback with authors

    Clamps a numeric value so that it's no lower than min, and no higher than max.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -248,88 +186,30 @@ than max pygame.math.lerp()
    -
    Returns value linearly interpolated between a and b.
    -
    lerp(a, b, value, do_clamp=True, /) -> float
    +
    interpolates between two values by a weight.
    +
    lerp(a, b, weight) -> float
    -

    Returns a number which is a linear interpolation between a -and b. The third parameter determines how far between a and -b the result is going to be. -If do_clamp is false, value is not clamped to [0, 1], -allowing extrapolation outside the range [a, b].

    -

    The formula is:

    -

    a + (b - a) * value.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    +

    Linearly interpolates between a and b by weight using the formula a + (b-a) * weight.

    +

    If weight is 0.5, lerp will return the value half-way between a +and b. When a = 10 and b = 20, lerp(a, b, 0.5) will return 15. You +can think of weight as the percentage of interpolation from a to b, 0.0 +being 0% and 1.0 being 100%.

    +

    lerp can be used for many things. You could rotate a sprite by a weight with +angle = lerp(0, 360, weight). You could even scale an enemy's attack value +based on the level you're playing:

    +
    FINAL_LEVEL = 10
    +current_level = 2
     
    -
    -
    -pygame.math.invlerp()
    -
    -
    Returns value inverse interpolated between a and b.
    -
    invlerp(a, b, value, /) -> float
    -
    -

    Returns a number which is an inverse interpolation between a -and b. The third parameter value is the result of the linear interpolation -between a and b with a certain coefficient. In other words, this coefficient -will be the result of this function. -If b and a are equal, it raises a ValueError.

    -

    The formula is:

    -

    (v - a)/(b - a).

    -

    This is an example explaining what is above :

    -
    >>> a = 10
    ->>> b = 20
    ->>> pygame.math.invlerp(10, 20, 11.5)
    -0.15
    ->>> pygame.math.lerp(10, 20, 0.15)
    -11.5
    +attack = lerp(10, 50, current_level/MAX_LEVEL) # 18
     
    +

    If you're on level 0, attack will be 10, if you're on level 10, +attack will be 50. If you're on level 5, the +result of current_level/MAX_LEVEL will be 0.5 +which represents 50%, therefore attack will be 30, which is the midpoint of 10 and 50.

    +

    Raises a ValueError if weight is outside the range of [0, 1].

    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -pygame.math.smoothstep()
    -
    -
    Returns value smoothly interpolated between a and b.
    -
    smoothstep(a, b, value, /) -> float
    -
    -

    Returns a number which is a smooth interpolation between a -and b. This means that the interpolation follows an s-shaped curve, with -change happening more slowly near the limits (0.0 and 1.0) and faster in the middle. -The third parameter determines how far between a and -b the result is going to be. Value is clamped to [0, 1].

    -

    The formula is:

    -

    a * (1 - interp) + b * interp

    -

    where:

    -

    interp = value * value * (3 - 2 * value)

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -pygame.math.remap()
    -
    -
    Remaps value from given input range to given output range.
    -
    remap(i_min, i_max, o_min, o_max, value, /) -> float
    -
    -

    Returns a number which is the value remapped from [i_min, i_max] range to -[o_min, o_max] range. -If i_min and i_max are equal, it raises a ValueError.

    -

    Example:

    -
    >>> value = 50
    ->>> pygame.math.remap(0, 100, 0, 200, value)
    -100.0
    -
    -
    -
    -

    New in pygame-ce 2.5.0.

    +

    New in pygame 2.1.3.

    @@ -437,100 +317,86 @@ If i_min—
    - - - - - - - - - - - - - - + - - - - - - - - - - - - - -
    —Returns value clamped to min and max.returns value clamped to min and max.
    —Returns value linearly interpolated between a and b.interpolates between two values by a weight.
    -—Returns value inverse interpolated between a and b.
    -—Returns value smoothly interpolated between a and b.
    -—Remaps value from given input range to given output range.
    +
    — a 2-Dimensional Vector
    +
    — a 3-Dimensional Vector returns a spherical interpolation to the given vector.
    -—returns a smooth interpolation to the given vector.
    +
    — The next operation will be performed elementwise.
    +
    — rotates a vector by a given angle in degrees.
    +
    — rotates a vector by a given angle in radians.
    +
    — rotates the vector by a given angle in degrees in place.
    +
    — rotates the vector by a given angle in radians in place.
    +
    — rotates the vector by a given angle in radians in place.
    +
    — calculates the angle to a given vector in degrees.
    +
    — returns a tuple with radial distance and azimuthal angle.
    +
    —Sets x and y from a polar coordinates tuple.Creates a Vector2(x, y) or sets x and y from a polar coordinates tuple.
    +
    — projects a vector onto another.
    +
    — Returns a copy of itself.
    +
    — Returns a copy of a vector with the magnitude clamped between max_length and min_length.
    +
    — Clamps the vector's magnitude between max_length and min_length
    +
    — Sets the coordinates of the vector.
    +
    — Determines the tolerance of vector calculations.
    -—Gives the angle of the vector in degrees, relative to the X-axis, normalized to the interval [-180, 180].
    -—Gives the angle of the vector in radians, relative to the X-axis, normalized to the interval [-π, π].
    +

    Some general information about the Vector2 class.

    -

    Changed in pygame-ce 2.1.3: Inherited methods of vector subclasses now correctly return an instance of the +

    Changed in pygame 2.1.3: Inherited methods of vector subclasses now correctly return an instance of the subclass instead of the superclass

    @@ -538,7 +404,7 @@ subclass instead of the superclass

    dot()
    calculates the dot- or scalar-product with the other vector
    -
    dot(Vector2, /) -> float
    +
    dot(Vector2) -> float
    @@ -547,7 +413,7 @@ subclass instead of the superclass

    cross()
    calculates the cross- or vector-product
    -
    cross(Vector2, /) -> float
    +
    cross(Vector2) -> float

    calculates the third component of the cross-product.

    @@ -606,8 +472,7 @@ This is faster than normalize() -> Vector2

    Returns a new vector that has length equal to 1 and the same -direction as self. If the vector is the zero vector (i.e. has length -0 thus no direction) a ValueError is raised.

    +direction as self.

    @@ -618,9 +483,7 @@ direction as self. If the vector is the zero vector (i.e. has length
    normalize_ip() -> None

    Normalizes the vector so that it has length equal to 1. -The direction of the vector is not changed. If the vector is the zero -vector (i.e. has length 0 thus no direction) a ValueError is -raised.

    +The direction of the vector is not changed.

    @@ -628,7 +491,7 @@ raised.

    is_normalized()
    tests if the vector is normalized i.e. has length == 1.
    -
    is_normalized() -> bool
    +
    is_normalized() -> Bool

    Returns True if the vector has length equal to 1. Otherwise it returns False.

    @@ -639,7 +502,7 @@ it returns Falsescale_to_length()
    scales the vector to a given length.
    -
    scale_to_length(float, /) -> None
    +
    scale_to_length(float) -> None

    Scales the vector so that it has the given length. The direction of the vector is not changed. You can also scale to length 0. If the vector @@ -652,7 +515,7 @@ is the zero vector (i.e. has length < reflect()

    returns a vector reflected of a given normal.
    -
    reflect(Vector2, /) -> Vector2
    +
    reflect(Vector2) -> Vector2

    Returns a new vector that points in the direction as if self would bounce of a surface characterized by the given surface normal. The length of the @@ -664,7 +527,7 @@ new vector is the same as self's.

    reflect_ip()
    reflect the vector of a given normal in place.
    -
    reflect_ip(Vector2, /) -> None
    +
    reflect_ip(Vector2) -> None

    Changes the direction of self as if it would have been reflected of a surface with the given surface normal.

    @@ -675,7 +538,7 @@ surface with the given surface normal.

    distance_to()
    calculates the Euclidean distance to a given vector.
    -
    distance_to(Vector2, /) -> float
    +
    distance_to(Vector2) -> float
    @@ -684,7 +547,7 @@ surface with the given surface normal.

    distance_squared_to()
    calculates the squared Euclidean distance to a given vector.
    -
    distance_squared_to(Vector2, /) -> float
    +
    distance_squared_to(Vector2) -> float
    @@ -693,15 +556,17 @@ surface with the given surface normal.

    move_towards()
    returns a vector moved toward the target by a given distance.
    -
    move_towards(Vector2, float, /) -> Vector2
    +
    move_towards(Vector2, float) -> Vector2
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave move_towards feedback with authors

    Returns a Vector which is moved towards the given Vector by a given distance and does not overshoot past its target Vector. The first parameter determines the target Vector, while the second parameter determines the delta distance. If the distance is in the negatives, then it will move away from the target Vector.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -710,15 +575,17 @@ negatives, then it will move away from the target Vector.

    move_towards_ip()
    moves the vector toward its target at a given distance.
    -
    move_towards_ip(Vector2, float, /) -> None
    +
    move_towards_ip(Vector2, float) -> None
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave move_towards_ip feedback with authors

    Moves itself toward the given Vector at a given distance and does not overshoot past its target Vector. The first parameter determines the target Vector, while the second parameter determines the delta distance. If the distance is in the negatives, then it will move away from the target Vector.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -727,12 +594,12 @@ negatives, then it will move away from the target Vector.

    lerp()
    returns a linear interpolation to the given vector.
    -
    lerp(Vector2, float, /) -> Vector2
    +
    lerp(Vector2, float) -> Vector2

    Returns a Vector which is a linear interpolation between self and the given Vector. The second parameter determines how far between self and -other the result is going to be. It must be a value between 0 and -1, where 0 means self and 1 means other will be returned.

    +other the result is going to be. It must be a value between 0 and 1 +where 0 means self and 1 means other will be returned.

    @@ -740,7 +607,7 @@ other the result is going to be. It must be a value between slerp()
    returns a spherical interpolation to the given vector.
    -
    slerp(Vector2, float, /) -> Vector2
    +
    slerp(Vector2, float) -> Vector2

    Calculates the spherical interpolation from self to the given Vector. The second argument - often called t - must be in the range [-1, 1]. It @@ -749,27 +616,6 @@ If a negative value is given the interpolation will not take the complement of the shortest path.

    -
    -
    -smoothstep()
    -
    -
    returns a smooth interpolation to the given vector.
    -
    smoothstep(Vector2, value, /) -> Vector2
    -
    -

    Returns a Vector which is a smooth interpolation between self and the -given Vector. This means that the interpolation follows an s-shaped curve, with -change happening more slowly near the limits (0.0 and 1.0) and faster in the middle. -The second parameter determines how far between the two vectors the result is going to be. -Value is clamped to [0, 1].

    -

    The formula is:

    -

    a * (1 - interp) + b * interp

    -

    where:

    -

    interp = value * value * (3 - 2 * value)

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    -
    elementwise()
    @@ -785,7 +631,7 @@ Value is clamped to rotate()
    rotates a vector by a given angle in degrees.
    -
    rotate(angle, /) -> Vector2
    +
    rotate(angle) -> Vector2

    Returns a vector which has the same length as self but is rotated counterclockwise by the given angle in degrees. @@ -798,13 +644,13 @@ will look clockwise if displayed).

    rotate_rad()
    rotates a vector by a given angle in radians.
    -
    rotate_rad(angle, /) -> Vector2
    +
    rotate_rad(angle) -> Vector2

    Returns a vector which has the same length as self but is rotated counterclockwise by the given angle in radians. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.0.0.

    @@ -814,7 +660,7 @@ will look clockwise if displayed).

    rotate_ip()
    rotates the vector by a given angle in degrees in place.
    -
    rotate_ip(angle, /) -> None
    +
    rotate_ip(angle) -> None

    Rotates the vector counterclockwise by the given angle in degrees. The length of the vector is not changed. @@ -827,13 +673,13 @@ will look clockwise if displayed).

    rotate_ip_rad()
    rotates the vector by a given angle in radians in place.
    -
    rotate_ip_rad(angle, /) -> None
    +
    rotate_ip_rad(angle) -> None

    DEPRECATED: Use rotate_rad_ip() instead.

    -
    +

    New in pygame 2.0.0.

    -
    +

    Deprecated since pygame 2.1.1.

    @@ -843,13 +689,13 @@ will look clockwise if displayed).

    rotate_rad_ip()
    rotates the vector by a given angle in radians in place.
    -
    rotate_rad_ip(angle, /) -> None
    +
    rotate_rad_ip(angle) -> None

    Rotates the vector counterclockwise by the given angle in radians. The length of the vector is not changed. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.1.1.

    @@ -859,15 +705,15 @@ will look clockwise if displayed).

    angle_to()
    calculates the angle to a given vector in degrees.
    -
    angle_to(Vector2, /) -> float
    +
    angle_to(Vector2) -> float

    Returns the angle from self to the passed Vector2 that would rotate self to be aligned with the passed Vector2 without crossing over the negative x-axis.

    -
    +
    angle_to image
    -

    Example demonstrating the angle returned

    +

    Example demonstrating the angle returned

    @@ -887,11 +733,13 @@ is the azimuthal angle.

    from_polar()
    -
    Sets x and y from a polar coordinates tuple.
    -
    from_polar((r, phi), /) -> None
    +
    Creates a Vector2(x, y) or sets x and y from a polar coordinates tuple.
    +
    Vector2.from_polar((r, phi)) -> Vector2
    +
    Vector2().from_polar((r, phi)) -> None
    -

    Sets x and y from a tuple (r, phi) where r is the radial distance, and -phi is the azimuthal angle.

    +

    If used from the class creates a Vector2(x,y), else sets x and y. +The values of x and y are defined from a tuple (r, phi) where r +is the radial distance, and phi is the azimuthal angle.

    @@ -899,11 +747,11 @@ phi is the azimuthal angle.

    project()
    projects a vector onto another.
    -
    project(Vector2, /) -> Vector2
    +
    project(Vector2) -> Vector2

    Returns the projected vector. This is useful for collision detection in finding the components in a certain direction (e.g. in direction of the wall). For a more detailed explanation see Wikipedia.

    -
    +

    New in pygame 2.0.2.

    @@ -916,7 +764,7 @@ For a more detailed explanation see copy() -> Vector2

    Returns a new Vector2 having the same dimensions.

    -
    +

    New in pygame 2.1.1.

    @@ -926,24 +774,18 @@ For a more detailed explanation see
    clamp_magnitude()
    Returns a copy of a vector with the magnitude clamped between max_length and min_length.
    -
    clamp_magnitude(max_length, /) -> Vector2
    -
    clamp_magnitude(min_length, max_length, /) -> Vector2
    +
    clamp_magnitude(max_length) -> Vector2
    +
    clamp_magnitude(min_length, max_length) -> Vector2
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave clamp_magnitude feedback with authors

    Returns a new copy of a vector with the magnitude clamped between max_length and min_length. If only one argument is passed, it is taken to be the max_length

    This function raises ValueError if min_length is greater than max_length, or if either of these values are negative.

    -

    New in pygame-ce 2.1.3.

    -
    -
    -

    Changed in pygame-ce 2.4.0: It is now possible to use clamp_magnitude on a zero-vector as long as min_length -is unspecified or 0.

    -
    -
    -

    Note

    -

    Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ValueError

    +

    New in pygame 2.1.3.

    @@ -952,23 +794,17 @@ is unspecified or 0.

    clamp_magnitude_ip()
    Clamps the vector's magnitude between max_length and min_length
    -
    clamp_magnitude_ip(max_length, /) -> None
    -
    clamp_magnitude_ip(min_length, max_length, /) -> None
    +
    clamp_magnitude_ip(max_length) -> None
    +
    clamp_magnitude_ip(min_length, max_length) -> None
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave clamp_magnitude_ip feedback with authors

    Clamps the vector's magnitude between max_length and min_length. If only one argument is passed, it is taken to be the max_length

    This function raises ValueError if min_length is greater than max_length, or if either of these values are negative.

    -

    New in pygame-ce 2.1.3.

    -
    -
    -

    Changed in pygame-ce 2.4.0: It is now possible to use clamp_magnitude on a zero-vector as long as min_length -is unspecified or 0.

    -
    -
    -

    Note

    -

    Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ValueError

    +

    New in pygame 2.1.3.

    @@ -985,7 +821,7 @@ is unspecified or 0.

    update((x, y)) -> None

    Sets coordinates x and y in place.

    -
    +

    New in pygame 1.9.5.

    @@ -1025,34 +861,6 @@ find that either the margin is too large or too small, in which case changing -
    -
    -angle
    -
    -
    Gives the angle of the vector in degrees, relative to the X-axis, normalized to the interval [-180, 180].
    -
    -

    Read-only attribute representing the angle of the vector in degrees relative to the X-axis. This angle is normalized to -the interval [-180, 180].

    -

    Usage: Accessing angle provides the current angle of the vector in degrees within the predefined range of [-180, 180].

    -
    -

    New in pygame-ce 2.5.5.

    -
    -
    - -
    -
    -angle_rad
    -
    -
    Gives the angle of the vector in radians, relative to the X-axis, normalized to the interval [-π, π].
    -
    -

    Read-only attribute representing the angle of the vector in radians relative to the X-axis. This value is equivalent -to the angle attribute converted to radians and is normalized to the interval [-π, π].

    -

    Usage: Accessing angle_rad provides the current angle of the vector in radians within the predefined range of [-π, π].

    -
    -

    New in pygame-ce 2.5.5.

    -
    -
    -
    @@ -1159,165 +967,161 @@ to the angle attribute converted to radians and is normalized to th — returns a spherical interpolation to the given vector. - - -— -returns a smooth interpolation to the given vector. - - + — The next operation will be performed elementwise. - + — rotates a vector by a given angle in degrees. - + — rotates a vector by a given angle in radians. - + — rotates the vector by a given angle in degrees in place. - + — rotates the vector by a given angle in radians in place. - + — rotates the vector by a given angle in radians in place. - + — rotates a vector around the x-axis by the angle in degrees. - + — rotates a vector around the x-axis by the angle in radians. - + — rotates the vector around the x-axis by the angle in degrees in place. - + — rotates the vector around the x-axis by the angle in radians in place. - + — rotates the vector around the x-axis by the angle in radians in place. - + — rotates a vector around the y-axis by the angle in degrees. - + — rotates a vector around the y-axis by the angle in radians. - + — rotates the vector around the y-axis by the angle in degrees in place. - + — rotates the vector around the y-axis by the angle in radians in place. - + — rotates the vector around the y-axis by the angle in radians in place. - + — rotates a vector around the z-axis by the angle in degrees. - + — rotates a vector around the z-axis by the angle in radians. - + — rotates the vector around the z-axis by the angle in degrees in place. - + — rotates the vector around the z-axis by the angle in radians in place. - + — rotates the vector around the z-axis by the angle in radians in place. - + — calculates the angle to a given vector in degrees. - + — returns a tuple with radial distance, inclination and azimuthal angle. - + — -Sets x, y and z from a spherical coordinates 3-tuple. +Creates a Vector3(x, y, z) or sets x, y and z from a spherical coordinates 3-tuple. - + — projects a vector onto another. - + — Returns a copy of itself. - + — Returns a copy of a vector with the magnitude clamped between max_length and min_length. - + — Clamps the vector's magnitude between max_length and min_length - + — Sets the coordinates of the vector. - + — Determines the tolerance of vector calculations. +

    Some general information about the Vector3 class.

    -

    Changed in pygame-ce 2.1.3: Inherited methods of vector subclasses now correctly return an instance of the +

    Changed in pygame 2.1.3: Inherited methods of vector subclasses now correctly return an instance of the subclass instead of the superclass

    @@ -1325,7 +1129,7 @@ subclass instead of the superclass

    dot()
    calculates the dot- or scalar-product with the other vector
    -
    dot(Vector3, /) -> float
    +
    dot(Vector3) -> float
    @@ -1334,7 +1138,7 @@ subclass instead of the superclass

    cross()
    calculates the cross- or vector-product
    -
    cross(Vector3, /) -> Vector3
    +
    cross(Vector3) -> Vector3

    calculates the cross-product.

    @@ -1397,8 +1201,7 @@ This is faster than normalize() -> Vector3

    Returns a new vector that has length equal to 1 and the same -direction as self. If the vector is the zero vector (i.e. has length -0 thus no direction) a ValueError is raised.

    +direction as self.

    @@ -1409,8 +1212,7 @@ direction as self. If the vector is the zero vector (i.e. has length
    normalize_ip() -> None

    Normalizes the vector so that it has length equal to 1. The -direction of the vector is not changed. If the vector is the zero vector -(i.e. has length 0 thus no direction) a ValueError is raised.

    +direction of the vector is not changed.

    @@ -1418,7 +1220,7 @@ direction of the vector is not changed. If the vector is the zero vector is_normalized()
    tests if the vector is normalized i.e. has length == 1.
    -
    is_normalized() -> bool
    +
    is_normalized() -> Bool

    Returns True if the vector has length equal to 1. Otherwise it returns False.

    @@ -1429,7 +1231,7 @@ returns Falsescale_to_length()
    scales the vector to a given length.
    -
    scale_to_length(float, /) -> None
    +
    scale_to_length(float) -> None

    Scales the vector so that it has the given length. The direction of the vector is not changed. You can also scale to length 0. If the vector @@ -1442,7 +1244,7 @@ is the zero vector (i.e. has length < reflect()

    returns a vector reflected of a given normal.
    -
    reflect(Vector3, /) -> Vector3
    +
    reflect(Vector3) -> Vector3

    Returns a new vector that points in the direction as if self would bounce of a surface characterized by the given surface normal. The length of the @@ -1454,7 +1256,7 @@ new vector is the same as self's.

    reflect_ip()
    reflect the vector of a given normal in place.
    -
    reflect_ip(Vector3, /) -> None
    +
    reflect_ip(Vector3) -> None

    Changes the direction of self as if it would have been reflected of a surface with the given surface normal.

    @@ -1465,7 +1267,7 @@ surface with the given surface normal.

    distance_to()
    calculates the Euclidean distance to a given vector.
    -
    distance_to(Vector3, /) -> float
    +
    distance_to(Vector3) -> float
    @@ -1474,7 +1276,7 @@ surface with the given surface normal.

    distance_squared_to()
    calculates the squared Euclidean distance to a given vector.
    -
    distance_squared_to(Vector3, /) -> float
    +
    distance_squared_to(Vector3) -> float
    @@ -1483,15 +1285,17 @@ surface with the given surface normal.

    move_towards()
    returns a vector moved toward the target by a given distance.
    -
    move_towards(Vector3, float, /) -> Vector3
    +
    move_towards(Vector3, float) -> Vector3
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave move_towards feedback with authors

    Returns a Vector which is moved towards the given Vector by a given distance and does not overshoot past its target Vector. The first parameter determines the target Vector, while the second parameter determines the delta distance. If the distance is in the negatives, then it will move away from the target Vector.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -1500,15 +1304,17 @@ negatives, then it will move away from the target Vector.

    move_towards_ip()
    moves the vector toward its target at a given distance.
    -
    move_towards_ip(Vector3, float, /) -> None
    +
    move_towards_ip(Vector3, float) -> None
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave move_towards_ip feedback with authors

    Moves itself toward the given Vector at a given distance and does not overshoot past its target Vector. The first parameter determines the target Vector, while the second parameter determines the delta distance. If the distance is in the negatives, then it will move away from the target Vector.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -1517,10 +1323,10 @@ negatives, then it will move away from the target Vector.

    lerp()
    returns a linear interpolation to the given vector.
    -
    lerp(Vector3, float, /) -> Vector3
    +
    lerp(Vector3, float) -> Vector3

    Returns a Vector which is a linear interpolation between self and the -given Vector. The second parameter determines how far between self and +given Vector. The second parameter determines how far between self an other the result is going to be. It must be a value between 0 and 1, where 0 means self and 1 means other will be returned.

    @@ -1530,7 +1336,7 @@ other the result is going to be. It must be a value between slerp
    ()
    returns a spherical interpolation to the given vector.
    -
    slerp(Vector3, float, /) -> Vector3
    +
    slerp(Vector3, float) -> Vector3

    Calculates the spherical interpolation from self to the given Vector. The second argument - often called t - must be in the range [-1, 1]. It @@ -1539,27 +1345,6 @@ If a negative value is given the interpolation will not take the complement of the shortest path.

    -
    -
    -smoothstep()
    -
    -
    returns a smooth interpolation to the given vector.
    -
    smoothstep(Vector3, value, /) -> Vector3
    -
    -

    Returns a Vector which is a smooth interpolation between self and the -given Vector. This means that the interpolation follows an s-shaped curve, with -change happening more slowly near the limits (0.0 and 1.0) and faster in the middle. -The second parameter determines how far between the two vectors the result is going to be. -Value is clamped to [0, 1].

    -

    The formula is:

    -

    a * (1 - interp) + b * interp

    -

    where:

    -

    interp = value * value * (3 - 2 * value)

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    -
    elementwise()
    @@ -1575,7 +1360,7 @@ Value is clamped to rotate()
    rotates a vector by a given angle in degrees.
    -
    rotate(angle, Vector3, /) -> Vector3
    +
    rotate(angle, Vector3) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise by the given angle in degrees around the given axis. @@ -1588,13 +1373,13 @@ will look clockwise if displayed).

    rotate_rad()
    rotates a vector by a given angle in radians.
    -
    rotate_rad(angle, Vector3, /) -> Vector3
    +
    rotate_rad(angle, Vector3) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise by the given angle in radians around the given axis. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.0.0.

    @@ -1604,7 +1389,7 @@ will look clockwise if displayed).

    rotate_ip()
    rotates the vector by a given angle in degrees in place.
    -
    rotate_ip(angle, Vector3, /) -> None
    +
    rotate_ip(angle, Vector3) -> None

    Rotates the vector counterclockwise around the given axis by the given angle in degrees. The length of the vector is not changed. @@ -1617,13 +1402,13 @@ will look clockwise if displayed).

    rotate_ip_rad()
    rotates the vector by a given angle in radians in place.
    -
    rotate_ip_rad(angle, Vector3, /) -> None
    +
    rotate_ip_rad(angle, Vector3) -> None

    DEPRECATED: Use rotate_rad_ip() instead.

    -
    +

    New in pygame 2.0.0.

    -
    +

    Deprecated since pygame 2.1.1.

    @@ -1633,13 +1418,13 @@ will look clockwise if displayed).

    rotate_rad_ip()
    rotates the vector by a given angle in radians in place.
    -
    rotate_rad_ip(angle, Vector3, /) -> None
    +
    rotate_rad_ip(angle, Vector3) -> None

    Rotates the vector counterclockwise around the given axis by the given angle in radians. The length of the vector is not changed. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.1.1.

    @@ -1649,7 +1434,7 @@ will look clockwise if displayed).

    rotate_x()
    rotates a vector around the x-axis by the angle in degrees.
    -
    rotate_x(angle, /) -> Vector3
    +
    rotate_x(angle) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise around the x-axis by the given angle in degrees. @@ -1662,13 +1447,13 @@ will look clockwise if displayed).

    rotate_x_rad()
    rotates a vector around the x-axis by the angle in radians.
    -
    rotate_x_rad(angle, /) -> Vector3
    +
    rotate_x_rad(angle) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise around the x-axis by the given angle in radians. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.0.0.

    @@ -1678,7 +1463,7 @@ will look clockwise if displayed).

    rotate_x_ip()
    rotates the vector around the x-axis by the angle in degrees in place.
    -
    rotate_x_ip(angle, /) -> None
    +
    rotate_x_ip(angle) -> None

    Rotates the vector counterclockwise around the x-axis by the given angle in degrees. The length of the vector is not changed. @@ -1691,13 +1476,13 @@ will look clockwise if displayed).

    rotate_x_ip_rad()
    rotates the vector around the x-axis by the angle in radians in place.
    -
    rotate_x_ip_rad(angle, /) -> None
    +
    rotate_x_ip_rad(angle) -> None

    DEPRECATED: Use rotate_x_rad_ip() instead.

    -
    +

    New in pygame 2.0.0.

    -
    +

    Deprecated since pygame 2.1.1.

    @@ -1707,13 +1492,13 @@ will look clockwise if displayed).

    rotate_x_rad_ip()
    rotates the vector around the x-axis by the angle in radians in place.
    -
    rotate_x_rad_ip(angle, /) -> None
    +
    rotate_x_rad_ip(angle) -> None

    Rotates the vector counterclockwise around the x-axis by the given angle in radians. The length of the vector is not changed. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.1.1.

    @@ -1723,7 +1508,7 @@ will look clockwise if displayed).

    rotate_y()
    rotates a vector around the y-axis by the angle in degrees.
    -
    rotate_y(angle, /) -> Vector3
    +
    rotate_y(angle) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise around the y-axis by the given angle in degrees. @@ -1736,13 +1521,13 @@ will look clockwise if displayed).

    rotate_y_rad()
    rotates a vector around the y-axis by the angle in radians.
    -
    rotate_y_rad(angle, /) -> Vector3
    +
    rotate_y_rad(angle) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise around the y-axis by the given angle in radians. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.0.0.

    @@ -1752,7 +1537,7 @@ will look clockwise if displayed).

    rotate_y_ip()
    rotates the vector around the y-axis by the angle in degrees in place.
    -
    rotate_y_ip(angle, /) -> None
    +
    rotate_y_ip(angle) -> None

    Rotates the vector counterclockwise around the y-axis by the given angle in degrees. The length of the vector is not changed. @@ -1765,20 +1550,15 @@ will look clockwise if displayed).

    rotate_y_ip_rad()
    rotates the vector around the y-axis by the angle in radians in place.
    -
    rotate_y_ip_rad(angle, /) -> None
    +
    rotate_y_ip_rad(angle) -> None

    DEPRECATED: Use rotate_y_rad_ip() instead.

    -
    +

    New in pygame 2.0.0.

    -
    +

    Deprecated since pygame 2.1.1.

    -
    -

    Changed in pygame-ce 2.5.8: Fixed a regression introduced in 2.1.1 where this method incorrectly rotated -around the X-axis instead of the Y-axis. In versions prior to 2.1.1, rotation -around the Y-axis worked correctly.

    -
    @@ -1786,13 +1566,13 @@ around the Y-axis worked correctly.

    rotate_y_rad_ip()
    rotates the vector around the y-axis by the angle in radians in place.
    -
    rotate_y_rad_ip(angle, /) -> None
    +
    rotate_y_rad_ip(angle) -> None

    Rotates the vector counterclockwise around the y-axis by the given angle in radians. The length of the vector is not changed. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.1.1.

    @@ -1802,7 +1582,7 @@ will look clockwise if displayed).

    rotate_z()
    rotates a vector around the z-axis by the angle in degrees.
    -
    rotate_z(angle, /) -> Vector3
    +
    rotate_z(angle) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise around the z-axis by the given angle in degrees. @@ -1815,13 +1595,13 @@ will look clockwise if displayed).

    rotate_z_rad()
    rotates a vector around the z-axis by the angle in radians.
    -
    rotate_z_rad(angle, /) -> Vector3
    +
    rotate_z_rad(angle) -> Vector3

    Returns a vector which has the same length as self but is rotated counterclockwise around the z-axis by the given angle in radians. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.0.0.

    @@ -1831,7 +1611,7 @@ will look clockwise if displayed).

    rotate_z_ip()
    rotates the vector around the z-axis by the angle in degrees in place.
    -
    rotate_z_ip(angle, /) -> None
    +
    rotate_z_ip(angle) -> None

    Rotates the vector counterclockwise around the z-axis by the given angle in degrees. The length of the vector is not changed. @@ -1844,20 +1624,12 @@ will look clockwise if displayed).

    rotate_z_ip_rad()
    rotates the vector around the z-axis by the angle in radians in place.
    -
    rotate_z_ip_rad(angle, /) -> None
    +
    rotate_z_ip_rad(angle) -> None

    DEPRECATED: Use rotate_z_rad_ip() instead.

    -
    -

    New in pygame 2.0.0.

    -
    -
    +

    Deprecated since pygame 2.1.1.

    -
    -

    Changed in pygame-ce 2.5.8: Fixed a regression introduced in 2.1.1 where this method incorrectly rotated -around the X-axis instead of the Z-axis. In versions prior to 2.1.1, rotation -around the Z-axis worked correctly.

    -
    @@ -1865,13 +1637,13 @@ around the Z-axis worked correctly.

    rotate_z_rad_ip()
    rotates the vector around the z-axis by the angle in radians in place.
    -
    rotate_z_rad_ip(angle, /) -> None
    +
    rotate_z_rad_ip(angle) -> None

    Rotates the vector counterclockwise around the z-axis by the given angle in radians. The length of the vector is not changed. (Note that due to pygame's inverted y coordinate system, the rotation will look clockwise if displayed).

    -
    +

    New in pygame 2.1.1.

    @@ -1881,7 +1653,7 @@ will look clockwise if displayed).

    angle_to()
    calculates the angle to a given vector in degrees.
    -
    angle_to(Vector3, /) -> float
    +
    angle_to(Vector3) -> float

    Returns the angle between self and the given vector.

    @@ -1901,10 +1673,12 @@ the inclination angle and phi is the azimuthal angle.

    from_spherical()
    -
    Sets x, y and z from a spherical coordinates 3-tuple.
    -
    from_spherical((r, theta, phi), /) -> None
    +
    Creates a Vector3(x, y, z) or sets x, y and z from a spherical coordinates 3-tuple.
    +
    Vector3.from_spherical((r, theta, phi)) -> Vector3
    +
    Vector3().from_spherical((r, theta, phi)) -> None
    -

    Sets x, y and z from a tuple (r, theta, phi) where r is the radial +

    If used from the class creates a Vector3(x, y, z), else sets x, y, and z. +The values of x, y, and z are from a tuple (r, theta, phi) where r is the radial distance, theta is the inclination angle and phi is the azimuthal angle.

    @@ -1913,11 +1687,11 @@ distance, theta is the inclination angle and phi is the azimuthal angle.

    project()
    projects a vector onto another.
    -
    project(Vector3, /) -> Vector3
    +
    project(Vector3) -> Vector3

    Returns the projected vector. This is useful for collision detection in finding the components in a certain direction (e.g. in direction of the wall). For a more detailed explanation see Wikipedia.

    -
    +

    New in pygame 2.0.2.

    @@ -1930,7 +1704,7 @@ For a more detailed explanation see copy() -> Vector3

    Returns a new Vector3 having the same dimensions.

    -
    +

    New in pygame 2.1.1.

    @@ -1940,24 +1714,18 @@ For a more detailed explanation see
    clamp_magnitude()
    Returns a copy of a vector with the magnitude clamped between max_length and min_length.
    -
    clamp_magnitude(max_length, /) -> Vector3
    -
    clamp_magnitude(min_length, max_length, /) -> Vector3
    +
    clamp_magnitude(max_length) -> Vector3
    +
    clamp_magnitude(min_length, max_length) -> Vector3
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave clamp_magnitude feedback with authors

    Returns a new copy of a vector with the magnitude clamped between max_length and min_length. If only one argument is passed, it is taken to be the max_length

    This function raises ValueError if min_length is greater than max_length, or if either of these values are negative.

    -

    New in pygame-ce 2.1.3.

    -
    -
    -

    Changed in pygame-ce 2.4.0: It is now possible to use clamp_magnitude on a zero-vector as long as min_length -is unspecified or 0.

    -
    -
    -

    Note

    -

    Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ValueError

    +

    New in pygame 2.1.3.

    @@ -1966,23 +1734,17 @@ is unspecified or 0.

    clamp_magnitude_ip()
    Clamps the vector's magnitude between max_length and min_length
    -
    clamp_magnitude_ip(max_length, /) -> None
    -
    clamp_magnitude_ip(min_length, max_length, /) -> None
    +
    clamp_magnitude_ip(max_length) -> None
    +
    clamp_magnitude_ip(min_length, max_length) -> None
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave clamp_magnitude_ip feedback with authors

    Clamps the vector's magnitude between max_length and min_length. If only one argument is passed, it is taken to be the max_length

    This function raises ValueError if min_length is greater than max_length, or if either of these values are negative.

    -

    New in pygame-ce 2.1.3.

    -
    -
    -

    Changed in pygame-ce 2.4.0: It is now possible to use clamp_magnitude on a zero-vector as long as min_length -is unspecified or 0.

    -
    -
    -

    Note

    -

    Before pygame-ce 2.4.0, attempting to clamp a zero vector would always raise a ValueError

    +

    New in pygame 2.1.3.

    @@ -1999,7 +1761,7 @@ is unspecified or 0.

    update((x, y, z)) -> None

    Sets coordinates x, y, and z in place.

    -
    +

    New in pygame 1.9.5.

    @@ -2022,7 +1784,7 @@ is unspecified or 0.




    -Edit on GitHub +Edit on GitHub
    @@ -2043,12 +1805,14 @@ is unspecified or 0.

  • previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/midi.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/midi.html index 42c2d08..e70e387 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/midi.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/midi.html @@ -5,14 +5,12 @@ - pygame.midi — pygame-ce v2.5.8 documentation - - - - - + pygame.midi — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -188,7 +178,7 @@ -
    +

    New in pygame 1.9.0.

    The midi module can send output to midi devices and get input from midi @@ -201,7 +191,7 @@ future. The pyportmidi bindings are included with pygame.


    -
    +

    New in pygame 2.0.0.

    These are pygame events (pygame.eventpygame module for interacting with events and queues) reserved for midi use. The @@ -255,7 +245,7 @@ be called automatically when your program exits.

    bool

    -
    +

    New in pygame 1.9.5.

    @@ -502,7 +492,7 @@ typically a semitone higher, and -8192 is 1 whole tone lower (though the musical range corresponding to the pitch bend range can also be changed in some synthesizers).

    If no value is given, the pitch bend is returned to "no change".

    -
    +

    New in pygame 1.9.4.

    @@ -749,7 +739,7 @@ required).

    frequency_to_midi(27.5) == 21
     
    -
    +

    New in pygame 1.9.5.

    @@ -765,7 +755,7 @@ required).

    midi_to_frequency(21) == 27.5
     
    -
    +

    New in pygame 1.9.5.

    @@ -781,7 +771,7 @@ required).

    midi_to_ansi_note(21) == 'A0'
     
    -
    +

    New in pygame 1.9.5.

    @@ -802,7 +792,7 @@ required).




    -Edit on GitHub +Edit on GitHub
    @@ -823,12 +813,14 @@ required).

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mixer.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mixer.html index dbb881d..3e20bab 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mixer.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mixer.html @@ -5,14 +5,12 @@ - pygame.mixer — pygame-ce v2.5.8 documentation - - - - - + pygame.mixer — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -131,77 +121,62 @@ — test if the mixer is initialized - - -— -get the name of the current audio backend driver - - + — stop playback of all sound channels - + — temporarily stop playback of all sound channels - + — resume paused playback of sound channels - + — fade out the volume on all sounds before stopping - + — set the total number of playback channels - + — get the total number of playback channels - + — reserve channels from being automatically used - + — find an unused channel - - -— -set the soundfont for playing midi music - - - -— -get the soundfont for playing midi music - - + — test if any sound is being mixed - + — get the mixer's SDL version - + — Create a new Sound object from a file or buffer object - + — Create a Channel object for controlling playback @@ -209,7 +184,9 @@

    This module contains classes for loading Sound objects and controlling -playback.

    +playback. The mixer module is optional and depends on SDL_mixer. Your program +should test that pygame.mixerpygame module for loading and playing sounds is available and initialized before using +it.

    The mixer module has a limited number of channels for playback of sounds. Usually programs tell pygame to start playing audio and it selects an available channel automatically. The default is 8 simultaneous channels, but complex @@ -224,28 +201,14 @@ module for playing long running music. Unlike mixer module, the music module streams the music from the files without loading music at once into memory.

    The mixer module must be initialized like other pygame modules, but it has some extra conditions. The pygame.mixer.init() function takes several optional -arguments to control the playback rate and sample size.

    +arguments to control the playback rate and sample size. Pygame will default to +reasonable values, but pygame cannot perform Sound resampling, so the mixer +should be initialized to match the values of your audio resources.

    NOTE: For less laggy sound use a smaller buffer size. The default is set to reduce the chance of scratchy sounds on some computers. You can change the default buffer by calling pygame.mixer.pre_init()preset the mixer init arguments before pygame.mixer.init()initialize the mixer module or pygame.init()initialize all imported pygame modules is called. For example: pygame.mixer.pre_init(44100,-16,2, 1024)

    -

    The following file formats are supported

    -
    -
      -
    • WAV

    • -
    • MP3

    • -
    • OGG

    • -
    • FLAC

    • -
    • OPUS

    • -
    • WV (WavPack)

    • -
    • MOD ("Module file" family of music file formats)

    • -
    • MIDI (see the get_soundfont() and set_soundfont() methods)

    • -
    -
    -
    -

    New in pygame-ce 2.5.0: Loading WV (Relies on SDL_mixer 2.8.0+)

    -
    pygame.mixer.init()
    @@ -263,19 +226,13 @@ If the value is negative then signed sample values will be used. Positive values mean unsigned audio samples will be used. An invalid value raises an exception.

    The channels argument is used to specify whether to use mono or stereo. 1 -for mono and 2 for stereo. -NOTE: The channels argument is not related to the number -of channels for playback of sounds, that you can get with the function -"get_num_channels" or set with the function "set_num_channels" (see below).

    +for mono and 2 for stereo.

    The buffer argument controls the number of internal samples used in the sound mixer. The default value should work for most cases. It can be lowered to reduce latency, but sound dropout may occur. It can be raised to larger values to ensure playback never skips, but it will impose latency on sound playback. The buffer size must be a power of two (if not it is rounded up to the next nearest power of 2).

    -

    The devicename parameter is the name of sound device to open for audio -playback. Allowed device names will vary based on the host system. -If left as None then a sensible default will be chosen for you.

    Some platforms require the pygame.mixerpygame module for loading and playing sounds module to be initialized after the display modules have initialized. The top level pygame.init() takes care of this automatically, but cannot pass any arguments to the mixer @@ -285,7 +242,7 @@ the proper defaults before the toplevel init is used.

    what the hardware supports. For example a sound card may not support 16bit sound samples, so instead it will use 8bit samples internally. If AUDIO_ALLOW_FORMAT_CHANGE is supplied, then the requested format will -change to the closest that SDL supports.

    +change to the closest that SDL2 supports.

    Apart from 0, allowedchanged accepts the following constants ORed together:

      @@ -298,25 +255,25 @@ change to the closest that SDL supports.

      It is safe to call this more than once, but after the mixer is initialized you cannot change the playback arguments without first calling pygame.mixer.quit().

      -
      +

      Changed in pygame 1.8: The default buffersize changed from 1024 to 3072.

      -
      +

      Changed in pygame 1.9.1: The default buffersize changed from 3072 to 4096.

      -
      +

      Changed in pygame 2.0.0: The default buffersize changed from 4096 to 512.

      -
      +

      Changed in pygame 2.0.0: The default frequency changed from 22050 to 44100.

      -
      +

      Changed in pygame 2.0.0: size can be 32 (32-bit floats).

      -
      +

      Changed in pygame 2.0.0: channels can also be 4 or 6.

      -
      +

      New in pygame 2.0.0: allowedchanges, devicename arguments added

    @@ -334,19 +291,19 @@ way to set custom mixer playback values is to call pygame.mixer.pre_init() before calling the top level pygame.init(). For backwards compatibility, argument values of 0 are replaced with the startup defaults, except for allowedchanges, where -1 is used.

    -
    +

    Changed in pygame 1.8: The default buffersize changed from 1024 to 3072.

    -
    +

    Changed in pygame 1.9.1: The default buffersize changed from 3072 to 4096.

    -
    +

    Changed in pygame 2.0.0: The default buffersize changed from 4096 to 512.

    -
    +

    Changed in pygame 2.0.0: The default frequency changed from 22050 to 44100.

    -
    +

    New in pygame 2.0.0: allowedchanges, devicename arguments added

    @@ -368,28 +325,12 @@ reinitialized later.

    pygame.mixer.get_init()
    test if the mixer is initialized
    -
    get_init() -> (frequency, format, channels) | None
    +
    get_init() -> (frequency, format, channels)

    If the mixer is initialized, this returns the playback arguments it is using. If the mixer has not been initialized this returns None.

    -
    -
    -pygame.mixer.get_driver()
    -
    -
    get the name of the current audio backend driver
    -
    get_driver() -> str
    -
    -

    Pygame chooses one of many available audio backend drivers when it is -initialized. This returns the internal name used for the backend. This -function is intended to be used for getting diagnostic/debugging information. -This can be controlled with SDL_AUDIODRIVER environment variable.

    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    -
    pygame.mixer.stop()
    @@ -426,7 +367,7 @@ playback can later be resumed with pygame.mixer.fadeout()
    fade out the volume on all sounds before stopping
    -
    fadeout(time, /) -> None
    +
    fadeout(time) -> None

    This will fade out the volume on all active channels over the time argument in milliseconds. After the sound is muted the playback will stop.

    @@ -437,9 +378,9 @@ in milliseconds. After the sound is muted the playback will stop.

    pygame.mixer.set_num_channels()
    set the total number of playback channels
    -
    set_num_channels(count, /) -> None
    +
    set_num_channels(count) -> None
    -

    Sets the number of available playback channels for the mixer. The default value is 8. +

    Sets the number of available channels for the mixer. The default value is 8. The value can be increased or decreased. If the value is decreased, sounds playing on the truncated channels are stopped.

    @@ -459,7 +400,7 @@ playing on the truncated channels are stopped.

    pygame.mixer.set_reserved()
    reserve channels from being automatically used
    -
    set_reserved(count, /) -> count
    +
    set_reserved(count) -> count

    The mixer can reserve any number of channels that will not be automatically selected for playback by Sounds. This means that whenever you play a Sound @@ -477,7 +418,7 @@ depending on the number of channels previously allocated.

    pygame.mixer.find_channel()
    find an unused channel
    -
    find_channel(force=False) -> Channel | None
    +
    find_channel(force=False) -> Channel

    This will find and return an inactive Channel object. If there are no inactive Channels this function will return None. If there are no @@ -485,44 +426,6 @@ inactive channels and the force argument is -

    -pygame.mixer.set_soundfont()
    -
    -
    set the soundfont for playing midi music
    -
    set_soundfont(path, /) -> None
    -
    -

    This sets the soundfont file to be used in the playback of midi music. -The soundfont only affects the playback of MID, MIDI, and KAR file formats. -The optional path argument, a string (or multiple strings separated by a semi-colon), -must point to the soundfont file(s) to be searched for in order given if some -are missing. If path is an empty string or the default (None), any specified soundfont paths -will be cleared from the mixer.

    -

    Note on Windows, the mixer always uses the built-in soundfont instead of the one specified.

    -

    Function set_soundfont() calls underlying SDL_mixer function -Mix_SetSoundFonts.

    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    - -
    -
    -pygame.mixer.get_soundfont()
    -
    -
    get the soundfont for playing midi music
    -
    get_soundfont() -> paths
    -
    -

    This gets the soundfont filepaths as a string (each path is separated by a semi-colon) -to be used in the playback of MID, MIDI, and KAR music file formats. If no -soundfont is specified, the return type is None.

    -

    Function get_soundfont() calls underlying SDL_mixer function -Mix_GetSoundFonts.

    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    -
    pygame.mixer.get_busy()
    @@ -531,7 +434,7 @@ soundfont is specified, the return type is get_busy() -> bool

    Returns True if the mixer is busy mixing any channels. If the mixer is -idle or uninitialized then this returns False.

    +idle then this return False.

    @@ -558,9 +461,9 @@ depending on the li

    Note

    -

    The linked and compiled version numbers should be the same.

    +

    The linked and compile version numbers should be the same.

    -
    +

    New in pygame 2.0.0.

    @@ -621,11 +524,6 @@ depending on the li — return a bytestring copy of the Sound samples. - - -— -return a new Sound object that is a deep copy of this Sound -

    Load a new sound buffer from a filename, a python file object or a readable @@ -636,7 +534,7 @@ Use the 'file' or 'buffer' keywords to avoid ambiguity; otherwise Sound may guess wrong. If the array keyword is used, the object is expected to export a new buffer interface (The object is checked for a buffer interface first.)

    The Sound object represents actual sound sample data. Methods that change -the state of the Sound object will impact all instances of the Sound playback. +the state of the Sound object will the all instances of the Sound playback. A Sound object also exports a new buffer interface.

    The Sound can be loaded from an OGG audio file or from an uncompressed WAV.

    @@ -647,25 +545,15 @@ for NumPy arrays, in that sample sign and byte order are ignored. This will change, either by correctly handling sign and byte order, or by raising an exception when different. Also, source samples are truncated to fit the audio sample size. This will not change.

    -
    -

    Note

    -

    bytes(Sound) and bytearray(Sound) make use of the buffer -interface, which is implemented internally by pygame.mixer.Sound. -Because of this, there is no need to directly implement __bytes__.

    -
    -
    +

    New in pygame 1.8: pygame.mixer.Sound(buffer)

    -
    +

    New in pygame 1.9.2: pygame.mixer.SoundCreate a new Sound object from a file or buffer object keyword arguments and array interface support

    -
    +

    New in pygame 2.0.1: pathlib.Path support on Python 3.

    -
    -

    Changed in pygame-ce 2.5.2: This class is also available through the pygame.Sound -alias.

    -
    play()
    @@ -705,7 +593,7 @@ fade-in is complete.

    fadeout()
    stop sound playback after fading out
    -
    fadeout(time, /) -> None
    +
    fadeout(time) -> None

    This will stop playback of the sound after fading it out over the time argument in milliseconds. The Sound will fade and stop on all actively @@ -717,7 +605,7 @@ playing channels.

    set_volume()
    set the playback volume for this Sound
    -
    set_volume(value, /) -> None
    +
    set_volume(value) -> None

    This will set the playback volume (loudness) for this Sound. This will immediately affect the Sound if it is playing. It will also affect any @@ -732,27 +620,6 @@ future playback of this Sound.

    -
    -

    Note

    -

    The values are internally converted and kept as integer values in range [0, 128], which means -that get_volume() may return a different volume than it was set to. For example,

    -
    >>> sound.set_volume(0.1)
    ->>> sound.get_volume()
    -0.09375
    -
    -
    -

    This is because when you set_volume(0.1), the volume is internally calculated like so

    -
    >>> int(0.1 * 128)
    -12
    -
    -
    -

    This means that some of the precision is lost, so when you retrieve it again using get_volume(), -it is converted back to a float using that integer

    -
    >>> 12 / 128
    -0.09375
    -
    -
    -
    @@ -762,11 +629,7 @@ it is converted back to a get the playback volume
    get_volume() -> value
    -

    Return a value from 0.0 to 1.0 (inclusive) representing the volume for this Sound.

    -
    -

    Note

    -

    See Sound.set_volume() for more information regarding the returned value

    -
    +

    Return a value from 0.0 to 1.0 representing the volume for this Sound.

    @@ -797,28 +660,8 @@ it is converted back to a get_raw() -> bytes

    Return a copy of the Sound object buffer as a bytes.

    -
    -

    New in pygame 1.9.2.

    -
    - - -
    -
    -copy()
    -
    -
    return a new Sound object that is a deep copy of this Sound
    -
    copy() -> Sound
    -
    copy.copy(original_sound) -> Sound
    -
    -

    Return a new Sound object that is a deep copy of this Sound. The new Sound -will be just as if you loaded it from the same file on disk as you did the -original Sound. If the copy fails, a TypeError or pygame.error()standard pygame exception -exception will be raised.

    -

    If copying a subclass of mixer.Sound, an instance of the same subclass -will be returned.

    -

    Also note that this functions as Sound.__copy__.

    -

    New in pygame-ce 2.5.6.

    +

    New in pygame 1.9.2.

    @@ -833,41 +676,31 @@ will be returned.

    - - - - - - - - - - - - - @@ -911,31 +744,10 @@ will be returned.

    -—get the channel id for the Channel object
    +
    — play a Sound on a specific Channel
    +
    — stop playback on a Channel
    +
    — temporarily stop playback of a channel
    +
    — resume pause playback of a channel
    +
    — stop playback after fading channel out
    -—set the position of a playing channel
    —

    Return a Channel object for one of the current channels. The id must be a -value from 0 up to, but not including, pygame.mixer.get_num_channels().

    +value from 0 to the value of pygame.mixer.get_num_channels().

    The Channel object can be used to get fine control over the playback of Sounds. A channel can only playback a single Sound at time. Using channels is entirely optional since pygame can manage them by default.

    -
    -

    Changed in pygame-ce 2.1.4: This class is also available through the pygame.Channel -alias.

    -
    -
    -

    Changed in pygame-ce 2.4.0: It is now possible to create subclasses of pygame.mixer.Channel

    -
    -
    -
    -id
    -
    -
    get the channel id for the Channel object
    -
    id -> int
    -
    -

    This simply returns the channel id used to create the Channel instance -as a read-only attribute

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    -
    play()
    @@ -992,59 +804,28 @@ a later time with C fadeout()
    stop playback after fading channel out
    -
    fadeout(time, /) -> None
    +
    fadeout(time) -> None

    Stop playback of a channel after fading out the sound over the given time argument in milliseconds.

    -
    -
    -set_source_location()
    -
    -
    set the position of a playing channel
    -
    set_source_location(angle, distance, /) -> None
    -
    -

    Set the position (angle, distance) of a playing channel.

    -

    angle: Angle in degrees.

    -

    distance: Range from 0 to 255.

    -
    -

    Warning

    -

    This function currently fails and raises a -pygame.errorstandard pygame exception when using 7.1 surround sound. -By default, the mixer module will use what the hardware is best -suited for, so this leads to hardware specific exceptions when using -this function.

    -

    One way of avoiding this is only using set_source_location() -with forced stereo. For example:

    -
    pygame.mixer.pre_init(
    -   channels=2,
    -   allowedchanges=pygame.AUDIO_ALLOW_FREQUENCY_CHANGE,
    -)
    -pygame.init()
    -
    -
    -
    -
    -

    New in pygame-ce 2.3.0.

    -
    -
    -
    set_volume()
    set the volume of a playing channel
    -
    set_volume(value, /) -> None
    -
    set_volume(left, right, /) -> None
    +
    set_volume(value) -> None
    +
    set_volume(left, right) -> None

    Set the volume (loudness) of a playing sound. When a channel starts to play its volume value is reset. This only affects the current sound. The -value argument is in the range of 0.0 to 1.0 (inclusive).

    +value argument is between 0.0 and 1.0.

    If one argument is passed, it will be the volume of both speakers. If two arguments are passed and the mixer is in stereo mode, the first argument will be the volume of the left speaker and the second will be the volume -of the right speaker.

    +of the right speaker. (If the second argument is None, the first +argument will be the volume of both speakers.)

    If the channel is playing a Sound on which set_volume() has also been called, both calls are taken into account. For example:

    sound = pygame.mixer.Sound("s.wav")
    @@ -1054,10 +835,6 @@ called, both calls are taken into account. For example:

    channel.set_volume(0.5) # Now plays at 30% (0.6 * 0.5).
    -
    -

    Note

    -

    See Sound.set_volume() for more information regarding how the value is stored internally

    -
    @@ -1067,15 +844,10 @@ called, both calls are taken into account. For example:

    get the volume of the playing channel
    get_volume() -> value
    -

    Return the volume of the channel for the current playing sound -in the range of 0.0 to 1.0 (inclusive). This does +

    Return the volume of the channel for the current playing sound. This does not take into account stereo separation used by Channel.set_volume(). The Sound object also has its own volume which is mixed with the channel.

    -
    -

    Note

    -

    See Sound.set_volume() for more information regarding the returned value

    -
    @@ -1094,7 +866,7 @@ is idle this returns get_sound()
    get the currently playing Sound
    -
    get_sound() -> Sound | None
    +
    get_sound() -> Sound

    Return the actual Sound object currently playing on this channel. If the channel is idle None is returned.

    @@ -1105,7 +877,7 @@ channel is idle Non queue()
    queue a Sound object to follow the current
    -
    queue(sound, /) -> None
    +
    queue(Sound) -> None

    When a Sound is queued on a Channel, it will begin playing immediately after the current Sound is finished. Each channel can only have a single @@ -1121,7 +893,7 @@ begin playing immediately.

    get_queue()
    return any Sound that is queued
    -
    get_queue() -> Sound | None
    +
    get_queue() -> Sound

    If a Sound is already queued on this channel it will be returned. Once the queued sound begins playback it will no longer be on the queue.

    @@ -1133,7 +905,7 @@ the queued sound begins playback it will no longer be on the queue.

    have the channel send an event when playback stops
    set_endevent() -> None
    -
    set_endevent(type, /) -> None
    +
    set_endevent(type) -> None

    When an endevent is set for a channel, it will send an event to the pygame queue every time a sound finishes playing on that channel (not @@ -1171,7 +943,7 @@ playback of a Sound. If there is no endevent the function returns


    -Edit on GitHub +Edit on GitHub
    @@ -1192,12 +964,14 @@ playback of a Sound. If there is no endevent the function returns
  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mouse.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mouse.html index 8def537..3d0fc29 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mouse.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/mouse.html @@ -5,14 +5,12 @@ - pygame.mouse — pygame-ce v2.5.8 documentation - - - - - + pygame.mouse — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,74 +97,54 @@
    pygame.mouse
    -
    Pygame module to work with the mouse.
    +
    pygame module to work with the mouse
    - - - - - - - - - + - + - + - + - + - + - + - + - - - - - - - - - +
    —Get the state of the mouse buttons.
    -—Get the most recently pressed buttons.
    -—Get the most recently released buttons.get the state of the mouse buttons
    —Get the mouse cursor position.get the mouse cursor position
    —Get the amount of mouse movement.get the amount of mouse movement
    —Set the mouse cursor position.set the mouse cursor position
    —Hide or show the mouse cursor.hide or show the mouse cursor
    —Get the current visibility state of the mouse cursor.get the current visibility state of the mouse cursor
    —Check if the display is receiving mouse input.check if the display is receiving mouse input
    —Set the mouse cursor to a new cursor.set the mouse cursor to a new cursor
    —Get the current mouse cursor.
    -—Query whether relative mouse mode is enabled.
    -—Set relative mouse mode.get the current mouse cursor
    @@ -213,26 +183,26 @@ scroll, such as whi
    Code example of mouse scroll (tested on 2.0.0.dev7)
    # Taken from husano896's PR thread (slightly modified)
    -import pygame
    -from pygame.locals import *
    +import pygame
    +from pygame.locals import *
     pygame.init()
     screen = pygame.display.set_mode((640, 480))
     clock = pygame.time.Clock()
     
    -def main():
    -    while True:
    -        for event in pygame.event.get():
    +def main():
    +   while True:
    +      for event in pygame.event.get():
                 if event.type == QUIT:
    -                pygame.quit()
    -                return
    +               pygame.quit()
    +               return
                 elif event.type == MOUSEWHEEL:
    -                print(event)
    -                print(event.x, event.y)
    -                print(event.flipped)
    -                print(event.which)
    -                # can access properties with
    -                # proper notation(ex: event.y)
    -        clock.tick(60)
    +               print(event)
    +               print(event.x, event.y)
    +               print(event.flipped)
    +               print(event.which)
    +               # can access properties with
    +               # proper notation(ex: event.y)
    +      clock.tick(60)
     
     # Execute game:
     main()
    @@ -243,95 +213,28 @@ scroll, such as whi
     
    pygame.mouse.get_pressed()
    -
    Get the state of the mouse buttons.
    -
    get_pressed(num_buttons=3, desktop=False) -> tuple[bool, bool, bool]
    -
    get_pressed(num_buttons, desktop=False) -> tuple
    +
    get the state of the mouse buttons
    +
    get_pressed(num_buttons=3) -> (button1, button2, button3)
    +
    get_pressed(num_buttons=5) -> (button1, button2, button3, button4, button5)

    Returns a sequence of booleans representing the state of all the mouse buttons. A true value means the mouse is currently being pressed at the time of the call.

    -

    To get all of the mouse events it is better to use either +

    Note, to get all of the mouse events it is better to use either pygame.event.wait() or pygame.event.get() and check all of those events to see if they are MOUSEBUTTONDOWN, MOUSEBUTTONUP, or -MOUSEMOTION. Remember to call pygame.event.get() or pygame.event.pump() -before this function, otherwise it will not work as expected.

    +MOUSEMOTION.

    +

    Note, that on X11 some X servers use middle button emulation. When you +click both buttons 1 and 3 at the same time a 2 button event +can be emitted.

    +

    Note, remember to call pygame.event.get() before this function. +Otherwise it will not work as expected.

    To support five button mice, an optional parameter num_buttons has been added in pygame 2. When this is set to 5, button4 and button5 are added to the returned tuple. Only 3 and 5 are valid values for this parameter.

    -

    If the desktop argument is True the mouse state will be correct even -if the window has no focus. In addition since it queries the OS it does not depend -on the last event pump while being slightly slower.

    -
    -

    Note

    -

    On X11 some X servers use middle button emulation. When you -click both buttons 1 and 3 at the same time a 2 button event -can be emitted.

    -
    -
    -

    Warning

    -

    Due to design constraints it is impossible to retrieve the desktop -mouse state on Wayland. The normal mouse state is returned instead.

    -
    -
    -

    Changed in pygame 2.0.0: num_buttons argument added

    -
    -

    Changed in pygame-ce 2.5.2: Added the desktop argument

    -
    -
    - -
    -
    -pygame.mouse.get_just_pressed()
    -
    -
    Get the most recently pressed buttons.
    -
    get_just_pressed() -> tuple
    -
    -

    Very similar to pygame.mouse.get_pressed()Get the state of the mouse buttons., returning a tuple -of length 5 with the important difference that the buttons are -True only in the frame they start being pressed. This can be convenient -for checking the buttons pressed "this frame", but for more precise results -and correct ordering prefer using the pygame.MOUSEBUTTONDOWN event.

    -

    The result of this function is updated when new events are processed, -e.g. in pygame.event.get()get events from the queue or pygame.event.pump()internally process pygame event handlers.

    - -
    if pygame.mouse.get_just_pressed()[0]:
    -   print("LMB just pressed")
    -
    -
    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -pygame.mouse.get_just_released()
    -
    -
    Get the most recently released buttons.
    -
    get_just_released() -> tuple
    -
    -

    Similar to pygame.mouse.get_pressed()Get the state of the mouse buttons., returning a tuple -of length 5 with the important difference that the buttons are -True only in the frame they stop being pressed. This can be convenient -for checking the buttons released "this frame", but for more precise results -and correct ordering prefer using the pygame.MOUSEBUTTONUP event.

    -

    The result of this function is updated when new events are processed, -e.g. in pygame.event.get()get events from the queue or pygame.event.pump()internally process pygame event handlers.

    - -
    if pygame.mouse.get_just_released()[0]:
    -   print("LMB just released")
    -
    -
    -
    -

    New in pygame-ce 2.5.0.

    +

    Changed in pygame 2.0.0: num_buttons argument added

    @@ -339,31 +242,21 @@ e.g. in pygame.mouse.get_pos()
    -
    Get the mouse cursor position.
    -
    get_pos(desktop=False) -> tuple[int, int]
    -
    -

    By default returns the x and y position of the mouse cursor. The position -is relative to the top-left corner of the display. The cursor position can be -located outside of the display window, but is always constrained to the screen.

    -

    If the desktop argument is True, the position will be instead relative to the -top-left corner of the primary monitor. The position might be negative or exceed -the desktop bounds if multiple monitors are present.

    -
    -

    Warning

    -

    Due to design constraints it is impossible to retrieve the desktop -mouse state on Wayland. The relative mouse position is returned instead.

    -
    -
    -

    Changed in pygame-ce 2.5.2: Added the desktop argument

    +
    get the mouse cursor position
    +
    get_pos() -> (x, y)
    +

    Returns the x and y position of the mouse cursor. The position is +relative to the top-left corner of the display. The cursor position can be +located outside of the display window, but is always constrained to the +screen.

    pygame.mouse.get_rel()
    -
    Get the amount of mouse movement.
    -
    get_rel() -> tuple[int, int]
    +
    get the amount of mouse movement
    +
    get_rel() -> (x, y)

    Returns the amount of movement in x and y since the previous call to this function. The relative movement of the mouse cursor is constrained to @@ -375,9 +268,8 @@ around this. Virtual input mode is described at the top of the page.

    pygame.mouse.set_pos()
    -
    Set the mouse cursor position.
    -
    set_pos(pos, /) -> None
    -
    set_pos(x, y, /) -> None
    +
    set the mouse cursor position
    +
    set_pos([x, y]) -> None

    Set the current mouse position to arguments given. If the mouse cursor is visible it will jump to the new coordinates. Moving the mouse will generate @@ -388,8 +280,8 @@ a new pygame.MOUSEM

    pygame.mouse.set_visible()
    -
    Hide or show the mouse cursor.
    -
    set_visible(value, /) -> int
    +
    hide or show the mouse cursor
    +
    set_visible(bool) -> bool

    If the bool argument is true, the mouse cursor will be visible. This will return the previous visible state of the cursor.

    @@ -399,12 +291,12 @@ return the previous visible state of the cursor.

    pygame.mouse.get_visible()
    -
    Get the current visibility state of the mouse cursor.
    +
    get the current visibility state of the mouse cursor
    get_visible() -> bool

    Get the current visibility state of the mouse cursor. True if the mouse is visible, False otherwise.

    -
    +

    New in pygame 2.0.0.

    @@ -413,7 +305,7 @@ visible, False pygame.mouse.get_focused()
    -
    Check if the display is receiving mouse input.
    +
    check if the display is receiving mouse input
    get_focused() -> bool

    Returns true when pygame is receiving mouse input events (or, in windowing @@ -430,16 +322,16 @@ whether the pygame window receives mouse events.

    pygame.mouse.set_cursor()
    -
    Set the mouse cursor to a new cursor.
    -
    set_cursor(cursor) -> None
    +
    set the mouse cursor to a new cursor
    +
    set_cursor(pygame.cursors.Cursor) -> None
    set_cursor(size, hotspot, xormasks, andmasks) -> None
    set_cursor(hotspot, surface) -> None
    set_cursor(constant) -> None

    Set the mouse cursor to something new. This function accepts either an explicit Cursor object or arguments to create a Cursor object.

    -

    See pygame.cursors.CursorPygame object representing a cursor. for help creating cursors and for examples.

    -
    +

    See pygame.cursors.Cursorpygame object representing a cursor for help creating cursors and for examples.

    +

    Changed in pygame 2.0.1.

    @@ -448,56 +340,19 @@ whether the pygame window receives mouse events.

    pygame.mouse.get_cursor()
    -
    Get the current mouse cursor.
    -
    get_cursor() -> Cursor
    +
    get the current mouse cursor
    +
    get_cursor() -> pygame.cursors.Cursor

    Get the information about the mouse system cursor. The return value contains -the same data as the arguments passed into pygame.mouse.set_cursor()Set the mouse cursor to a new cursor..

    +the same data as the arguments passed into pygame.mouse.set_cursor()set the mouse cursor to a new cursor.

    Note

    Code that unpacked a get_cursor() call into size, hotspot, xormasks, andmasks will still work, assuming the call returns an old school type cursor.

    -
    -

    Changed in pygame 2.0.1.

    -
    -
    - -
    -
    -pygame.mouse.get_relative_mode()
    -
    -
    Query whether relative mouse mode is enabled.
    -
    get_relative_mode() -> bool
    -
    -

    Query whether relative mouse mode is enabled.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -pygame.mouse.set_relative_mode()
    -
    -
    Set relative mouse mode.
    -
    set_relative_mode(enable, /) -> None
    -
    -

    Sets the relative mouse mode state. -While the mouse is in relative mode, the cursor is hidden, -the mouse position is constrained to the window, and pygame -will report continuous relative mouse motion even if the -mouse is at the edge of the window.

    -

    This function will flush any pending mouse motion."

    -

    Calling pygame.mouse.set_visible()Hide or show the mouse cursor. with argument -True will exit relative mouse mode.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -

    Changed in pygame-ce 2.5.6: calling this function before calling -pygame.display.set_mode()Initialize a window or screen for display. is deprecated and may error in the future.

    +

    Changed in pygame 2.0.1.

    @@ -508,7 +363,7 @@ mouse is at the edge of the window.




    -Edit on GitHub +Edit on GitHub
    @@ -529,12 +384,14 @@ mouse is at the edge of the window.

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/music.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/music.html index e9bfa45..5fbe0ea 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/music.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/music.html @@ -5,18 +5,16 @@ - pygame.mixer.music — pygame-ce v2.5.8 documentation - - - - - + pygame.mixer.music — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
    @@ -191,11 +181,6 @@ — get the event a channel sends when playback stops - - -— -get metadata of the specified or currently loaded music stream -

    The music module is closely tied to pygame.mixerpygame module for loading and playing sounds. Use the music module @@ -207,7 +192,6 @@ only supports a single music stream at once.

    changed in pygame v2.0.2 which got improved MP3 support. Consider using OGG file format for music as that can give slightly better compression than MP3 in most cases.

    -

    For a complete list of supported file formats, see the pygame.mixerpygame module for loading and playing sounds doc page.

    pygame.mixer.music.load()
    @@ -221,11 +205,8 @@ a music stream is already playing it will be stopped. This does not start the music playing.

    If you are loading from a file object, the namehint parameter can be used to specify the type of music data in the object. For example: load(fileobj, "ogg").

    -
    -

    Changed in pygame 2.0.2: Added optional namehint argument

    -
    -

    Changed in pygame-ce 2.2.0: Raises FileNotFoundError instead of pygame.errorstandard pygame exception if file cannot be found

    +

    Changed in pygame 2.0.2: Added optional namehint argument

    @@ -237,7 +218,7 @@ the type of music data in the object. For example: unload() -> None

    This closes resources like files for any music that may be loaded.

    -
    +

    New in pygame 2.0.0.

    @@ -267,7 +248,7 @@ which denotes the period of time (in milliseconds) over which the music will fade up from volume level 0.0 to full volume (or the volume level previously set by set_volume()). The sample may end before the fade-in is complete. If the music is already streaming fade_ms is ignored.

    -
    +

    Changed in pygame 2.0.0: Added optional fade_ms argument

    @@ -328,7 +309,7 @@ It won't unload the music.

    pygame.mixer.music.fadeout()
    stop music playback after fading out
    -
    fadeout(time, /) -> None
    +
    fadeout(time) -> None

    Fade out and stop the currently playing music.

    The time argument denotes the integer milliseconds for which the @@ -344,7 +325,7 @@ called after the music has faded.

    pygame.mixer.music.set_volume()
    set the music volume
    -
    set_volume(volume, /) -> None
    +
    set_volume(volume) -> None

    Set the volume of the music playback.

    The volume argument is a float between 0.0 and 1.0 that sets @@ -352,10 +333,6 @@ the volume level. When new music is loaded the volume is reset to full volume. If volume is a negative value it will be ignored and the volume will remain set at the current level. If the volume argument is greater than 1.0, the volume will be set to 1.0.

    -
    -

    Note

    -

    See mixer.Sound.set_volume() for more information regarding how the value is stored internally

    -
    @@ -367,10 +344,6 @@ is greater than 1.0

    Returns the current volume for the mixer. The value will be between 0.0 and 1.0.

    -
    -

    Note

    -

    See mixer.Sound.set_volume() for more information regarding the returned value

    -
    @@ -384,7 +357,7 @@ and 1.0 -
    +

    Changed in pygame 2.0.1: Returns False when music paused.

    @@ -394,7 +367,7 @@ is paused.

    pygame.mixer.music.set_pos()
    set position to play from
    -
    set_pos(pos, /) -> None
    +
    set_pos(pos) -> None

    This sets the position in the music file where playback will start. The meaning of "pos", a float (or a number that can be converted to a float), @@ -405,11 +378,11 @@ the beginning of the sound. For MP3 file, first call rewind().

    Other file formats are unsupported. Newer versions of SDL_mixer have -better positioning support than earlier ones. A pygame.errorstandard pygame exception is -raised if a particular format does not support positioning.

    -

    Function set_pos() calls underlying SDL_mixer function +better positioning support than earlier ones. An SDLError is raised if a +particular format does not support positioning.

    +

    Function set_pos() calls underlining SDL_mixer function Mix_SetMusicPosition.

    -
    +

    New in pygame 1.9.2.

    @@ -424,7 +397,6 @@ raised if a particular format does not support positioning.

    This gets the number of milliseconds that the music has been playing for. The returned time only represents how long the music has been playing; it does not take into account any starting position offsets.

    -

    Returns -1 if get_pos failed due to music not playing.

    @@ -449,11 +421,8 @@ Mozart once:

    pygame.mixer.music.queue('mozart.ogg')
    -
    -

    Changed in pygame 2.0.2: Added optional namehint argument

    -
    -

    Changed in pygame-ce 2.2.0: Raises FileNotFoundError instead of pygame.errorstandard pygame exception if file cannot be found

    +

    Changed in pygame 2.0.2: Added optional namehint argument

    @@ -463,7 +432,7 @@ Mozart once:

    have the music send an event when playback stops
    set_endevent() -> None
    -
    set_endevent(type, /) -> None
    +
    set_endevent(type) -> None

    This causes pygame to signal (by means of the event queue) when the music is done playing. The argument determines the type of event that will be queued.

    @@ -483,34 +452,6 @@ argument.

    there is no endevent the function returns pygame.NOEVENT.

    -
    -
    -pygame.mixer.music.get_metadata()
    -
    -
    get metadata of the specified or currently loaded music stream
    -
    get_metadata() -> dict
    -
    get_metadata(filename) -> dict
    -
    get_metadata(fileobj, namehint="") -> dict
    -
    -

    If no arguments are passed returns a dictionary containing metadata -of the currently loaded music stream, raises an exception if a music stream is not loaded. -Available keys are "title", "album", "artist", "copyright". -Values are strings containing corresponding retrieved metadata. -If particular metadata was not found the value is an empty string. -Here is an example: -{'title': 'Small Tone', 'album': 'Tones', 'artist': 'Audacity Generator', 'copyright': ''}

    -

    Refer to the pygame.mixer.music.load()Load a music file for playback function for arguments regarding specifying a file or a file-like object -whose metadata you want to retrieve. For this function all arguments are optional, -however, specifying only the namehint will raise an exception.

    -

    Since the underlying functionality was introduced in version 2.6.0 of SDL_mixer, -calling this function with an older version of SDL_mixer will return a dictionary -with all values being set to empty strings. You can find your version of SDL_mixer -by using pygame.mixer.get_sdl_mixer_version()get the mixer's SDL version.

    -
    -

    New in pygame-ce 2.1.4.

    -
    -
    - @@ -518,7 +459,7 @@ by using Edit on GitHub +Edit on GitHub
    @@ -534,17 +475,19 @@ by using modules |
  • - next |
  • previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelarray.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelarray.html index 59fa354..f25d725 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelarray.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelarray.html @@ -5,19 +5,17 @@ - pygame.PixelArray — pygame-ce v2.5.8 documentation - - - - - + pygame.PixelArray — pygame v2.6.1 documentation + + + + - - +
    @@ -25,30 +23,24 @@
    @@ -177,10 +167,10 @@ for assignment. A pixel array sliced on a single column or row returns a one dimensional pixel array. Arithmetic and other operations are not supported. A pixel array can be safely assigned to itself. Finally, pixel arrays export an array struct interface, allowing -them to interact with pygame.pixelcopyPygame module for general pixel array copying. methods and NumPy +them to interact with pygame.pixelcopypygame module for general pixel array copying methods and NumPy arrays.

    A PixelArray pixel item can be assigned a raw integer values, a -pygame.ColorPygame object for color representations. instance, or a (r, g, b[, a]) tuple.

    +pygame.Colorpygame object for color representations instance, or a (r, g, b[, a]) tuple.

    pxarray[x, y] = 0xFF00FF
     pxarray[x, y] = pygame.Color(255, 0, 255)
     pxarray[x, y] = (255, 0, 255)
    @@ -196,7 +186,7 @@ PixelArray was created.

    ...
    -

    When assigning to a range of pixels, a non tuple sequence of colors or +

    When assigning to a range of of pixels, a non tuple sequence of colors or a PixelArray can be used as the value. For a sequence, the length must match the PixelArray width.

    pxarray[a:b] = 0xFF00FF                   # set all pixels to 0xFF00FF
    @@ -226,7 +216,7 @@ instead of iterating over the x or y axis. The

    During its lifetime, the PixelArray locks the surface, thus you explicitly -have to close() it once it's not used any more and the surface should perform +have to close() it once its not used any more and the surface should perform operations in the same scope. It is best to use it as a context manager using the with PixelArray(surf) as pixel_array: style. So it works on pypy too.

    A simple : slice index for the column can be omitted.

    @@ -243,7 +233,7 @@ This should change in later pygame releases, where format conversions are performed for all pixel sizes. To avoid code breakage when full mapped copying is implemented it is suggested PixelArray to PixelArray copies be only between surfaces of identical format.

    -
    +

    New in pygame 1.9.4:

    • close() method was added. For explicitly cleaning up.

    • @@ -251,7 +241,7 @@ only between surfaces of identical format.

    • both of these are useful for when working without reference counting (pypy).

    -
    +

    New in pygame 1.9.2:

    • array struct interface

    • @@ -259,7 +249,7 @@ only between surfaces of identical format.

    • broadcasting for a length 1 dimension

    -
    +

    Changed in pygame 1.9.2:

    • A 2D PixelArray can have a length 1 dimension. @@ -268,10 +258,6 @@ Only an integer index on a 2D PixelArray returns a 1D array.

    • is a sequence of colors.

    -
    -

    Changed in pygame-ce 2.5.8: Fixed incorrect color matching and writing on 24-bit surfaces whose -byte layout did not match the platform default.

    -
    surface
    @@ -291,7 +277,7 @@ byte layout did not match the platform default.

    This is the same as Surface.get_bytesize() for the pixel array's surface.

    -
    +

    New in pygame 1.9.2.

    @@ -304,7 +290,7 @@ pixel array's surface.

    ndim -> int

    A pixel array can be 1 or 2 dimensional.

    -
    +

    New in pygame 1.9.2.

    @@ -318,7 +304,7 @@ pixel array's surface.

    A tuple or length ndim giving the length of each dimension. Analogous to Surface.get_size().

    -
    +

    New in pygame 1.9.2.

    @@ -334,7 +320,7 @@ dimension. Analogous to +

    New in pygame 1.9.2.

    @@ -353,7 +339,7 @@ original Surface.

    sf = pxarray[:,::-1].make_surface ()
    -
    +

    New in pygame 1.8.1.

    @@ -374,13 +360,9 @@ replacement to take pixels with a similar, but not exactly identical color, into account as well.

    This is an in place operation that directly affects the pixels of the PixelArray.

    -
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelcopy.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelcopy.html index e0d0627..b79ebe8 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelcopy.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pixelcopy.html @@ -5,14 +5,12 @@ - pygame.pixelcopy — pygame-ce v2.5.8 documentation - - - - - + pygame.pixelcopy — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,29 +97,29 @@
    pygame.pixelcopy
    -
    Pygame module for general pixel array copying.
    +
    pygame module for general pixel array copying
    - + - + - + - +
    —Copy surface pixels to an array object.copy surface pixels to an array object
    —Copy an array object to a surface.copy an array object to a surface
    —Copy an array to another array, using surface format.copy an array to another array, using surface format
    —Copy an array to a new surface.Copy an array to a new surface
    @@ -145,14 +135,14 @@ Python versions. So for now the array struct interface is the predominate way pygame handles array introspection.

    For 2d arrays of integer pixel values, the values are mapped to the pixel format of the related surface. To get the actual color of a pixel -value use pygame.Surface.unmap_rgb()Convert a mapped integer color value into a Color.. 2d arrays can only be used +value use pygame.Surface.unmap_rgb()convert a mapped integer color value into a Color. 2d arrays can only be used directly between surfaces having the same pixel layout.

    New in pygame 1.9.2.

    pygame.pixelcopy.surface_to_array()
    -
    Copy surface pixels to an array object.
    +
    copy surface pixels to an array object
    surface_to_array(array, surface, kind='P', opaque=255, clear=0) -> None

    The surface_to_array function copies pixels from a Surface object @@ -194,8 +184,8 @@ kind code. Surface specific problems, such as locking, raise a pygame.error.

    pygame.pixelcopy.array_to_surface()
    -
    Copy an array object to a surface.
    -
    array_to_surface(surface, array, /) -> None
    +
    copy an array object to a surface
    +
    array_to_surface(<surface>, <array>) -> None

    See pygame.surfarray.blit_array()Blit directly from a array values.

    @@ -204,8 +194,8 @@ kind code. Surface specific problems, such as locking, raise a pygame.error.

    pygame.pixelcopy.map_array()
    -
    Copy an array to another array, using surface format.
    -
    map_array(array1, array2, surface, /) -> None
    +
    copy an array to another array, using surface format
    +
    map_array(<array>, <array>, <surface>) -> None

    Map an array of color element values - (w, h, ..., 3) - to an array of pixels - (w, h) according to the format of <surface>.

    @@ -215,8 +205,8 @@ pixels - (w, h) according to the format of <surface>.

    pygame.pixelcopy.make_surface()
    -
    Copy an array to a new surface.
    -
    make_surface(array, /) -> Surface
    +
    Copy an array to a new surface
    +
    pygame.pixelcopy.make_surface(array) -> Surface

    Create a new Surface that best resembles the data and format of the array. The array can be 2D or 3D with any sized integer values.

    @@ -229,7 +219,7 @@ The array can be 2D or 3D with any sized integer values.




    -Edit on GitHub +Edit on GitHub
    @@ -250,12 +240,14 @@ The array can be 2D or 3D with any sized integer values.

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pygame.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pygame.html index 1c9206b..4b932a5 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pygame.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/pygame.html @@ -5,14 +5,12 @@ - pygame — pygame-ce v2.5.8 documentation - - - - - + pygame — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -111,71 +101,61 @@
    - - - - - - - - - - - - - - - - - - -
    -—exists if current pygame is pygame-ce
    +
    — initialize all imported pygame modules
    +
    — uninitialize all pygame modules
    +
    — returns True if pygame is currently initialized
    +
    — standard pygame exception
    +
    — get the current error message
    +
    — set the current error message
    +
    — get the version number of SDL
    +
    — get the byte order of SDL
    +
    — register a function to be called when pygame quits
    +
    — Encode a Unicode or bytes object
    +
    — Encode a Unicode or bytes object as a file system path
    -—retrieves useful information for debugging and issue-reporting purposes

    The pygame package represents the top-level package for others to use. Pygame @@ -188,16 +168,6 @@ inside a module named -

    -pygame.IS_CE
    -
    -
    exists if current pygame is pygame-ce
    -
    IS_CE = 1
    -
    -

    Use getattr(pygame, "IS_CE", False) to check if current pygame is pygame-ce

    -
    -
    pygame.init()
    @@ -212,7 +182,7 @@ but init() functions for individual modules will raise exceptions when they fail.

    You may want to initialize the different modules separately to speed up your -program or to not use modules your game does not require.

    +program or remove the modules your game does not require.

    It is safe to call this init() more than once as repeated calls will have no effect. This is true even if you have pygame.quit() all the modules.

    @@ -244,7 +214,7 @@ your program end in the same way a normal Python program will end.

    get_init() -> bool

    Returns True if pygame is currently initialized.

    -
    +

    New in pygame 1.9.5.

    @@ -280,7 +250,7 @@ rarely be needed.

    pygame.set_error()
    set the current error message
    -
    set_error(error_msg, /) -> None
    +
    set_error(error_msg) -> None

    SDL maintains an internal error message. This message will usually be given to you when pygame.error()standard pygame exception is raised, so this function will @@ -300,11 +270,11 @@ is linked against while +

    New in pygame 1.7.0.

    -

    Changed in pygame-ce 2.1.4: linked keyword argument added

    +

    Changed in pygame 2.2.0: linked keyword argument added

    @@ -317,7 +287,7 @@ available through pygame.

    Returns the byte order of the SDL library. It returns 1234 for little endian byte order and 4321 for big endian byte order.

    -
    +

    New in pygame 1.8.

    @@ -327,7 +297,7 @@ endian byte order and pygame.register_quit()
    register a function to be called when pygame quits
    -
    register_quit(callable, /) -> None
    +
    register_quit(callable) -> None

    When pygame.quit()uninitialize all pygame modules is called, all registered quit functions are called. Pygame modules do this automatically when they are initializing, so @@ -353,8 +323,7 @@ encoding error. The default is

    This function is used in encoding file paths. Keyword arguments are supported.

    -

    This function is not needed for normal pygame-ce usage.

    -
    +

    New in pygame 1.9.2: (primarily for use in unit tests)

    @@ -374,31 +343,8 @@ encoding error. The default is This function is used to encode file paths in pygame. Encoding is to the codec as returned by sys.getfilesystemencoding(). Keyword arguments are supported.

    -

    This function is not needed for normal pygame-ce usage.

    -
    -

    New in pygame 1.9.2: (primarily for use in unit tests)

    -
    - - -
    -
    -pygame.print_debug_info()
    -
    -
    retrieves useful information for debugging and issue-reporting purposes
    -
    print_debug_info(filename=None) -> None
    -
    -

    Constructs a string containing details on the system, the python interpreter, -the pygame version, and the linked and compiled versions of the libraries that -pygame wraps. If filename is None, then the string is printed into the -console. Otherwise, the debug string is written to the specified file.

    -
    -

    Note

    -

    If pygame.freetype has not been initialized with pygame.init()initialize all imported pygame modules or pygame.freetype.init()Initialize the underlying FreeType library., -then the linked and compiled versions of FreeType will be "Unk" since this information is not -available before initialization.

    -
    -

    New in pygame-ce 2.1.4.

    +

    New in pygame 1.9.2: (primarily for use in unit tests)

    @@ -464,7 +410,7 @@ would look like this:

    disable_advanced_features = True
    -
    +

    New in pygame 1.9.6: Attributes major, minor, and patch.

    vernum.major == vernum[0]
    @@ -472,11 +418,11 @@ would look like this:

    vernum.patch == vernum[2]
    -
    +

    Changed in pygame 1.9.6: str(pygame.version.vernum) returns a string like "2.0.0" instead of "(2, 0, 0)".

    -
    +

    Changed in pygame 1.9.6: repr(pygame.version.vernum) returns a string like "PygameVersion(major=2, minor=0, patch=0)" instead of "(2, 0, 0)".

    @@ -497,7 +443,7 @@ in bug reports, especially for non-release pygame builds.

    obsolete now. As soon as development shifted to github, this variable started returning an empty string "". It has always been returning an empty string since v1.9.5.

    -
    +

    Changed in pygame 1.9.5: Always returns an empty string "".

    @@ -507,7 +453,7 @@ It has always been returning an empty string since pygame.version.SDL
    tupled integers of the SDL library version
    -
    SDL = '(2, 26, 5)'
    +
    SDL = '(2, 0, 12)'

    This is the SDL library version represented as an extended tuple. It also has attributes 'major', 'minor' & 'patch' that can be accessed like this:

    @@ -517,10 +463,10 @@ attributes 'major', 'minor' & 'patch' that can be accessed like this:

    printing the whole thing returns a string like this:

    >>> pygame.version.SDL
    -SDLVersion(major=2, minor=26, patch=5)
    +SDLVersion(major=2, minor=0, patch=12)
     
    -
    +

    New in pygame 2.0.0.

    @@ -530,12 +476,12 @@ attributes 'major', 'minor' & 'patch' that can be accessed like this:

    range of the library's functionality. Some of the variables are from pygame itself, while others come from the underlying C SDL library that pygame uses.

    In python, environment variables are usually set in code like this:

    -
    import os
    +
    import os
     os.environ['NAME_OF_ENVIRONMENT_VARIABLE'] = 'value_to_set'
     

    Or to preserve users ability to override the variable:

    -
    import os
    +
    import os
     os.environ['ENV_VAR'] = os.environ.get('ENV_VAR', 'value')
     
    @@ -566,8 +512,8 @@ and others can simply be set right before the area of code they control is run.<

    This sets the display where pygame will open its window or screen. The value set here will be used if set before -calling pygame.display.set_mode()Initialize a window or screen for display., and as long as no -'display' parameter is passed into pygame.display.set_mode()Initialize a window or screen for display..

    +calling pygame.display.set_mode()Initialize a window or screen for display, and as long as no +'display' parameter is passed into pygame.display.set_mode()Initialize a window or screen for display.


    @@ -578,7 +524,7 @@ calling pygame.display.set_mode()Initialize a window or screen for display..

    +available. Must be set before calling pygame.display.set_mode()Initialize a window or screen for display.


    @@ -589,7 +535,7 @@ available. Must be set before calling This makes pygame use the SDL2 blitter for all alpha blending. The SDL2 blitter is sometimes faster than the default blitter but uses a different formula so -the final colors may differ. Must be set before +the final colours may differ. Must be set before pygame.init()initialize all imported pygame modules is called.


    @@ -617,7 +563,7 @@ do this. Must be set before importing pygame.


    PYGAME_CAMERA -
    -Set to "opencv"
    +Set to "opencv" or "vidcapture"
     

    Forces the library backend used in the camera @@ -644,7 +590,7 @@ For Pygame 2, some selected environment variables are listed below.

    This will make the pygame window open in the centre of the display. -Must be set before calling pygame.display.set_mode()Initialize a window or screen for display..

    +Must be set before calling pygame.display.set_mode()Initialize a window or screen for display.


    @@ -653,7 +599,7 @@ Must be set before calling pygame.display.set_mode()Initialize a window or screen for display..

    +the display. Must be set before calling pygame.display.set_mode()Initialize a window or screen for display.


    @@ -664,7 +610,7 @@ the display. Must be set before calling On some platforms there are multiple video drivers available and this allows users to pick between them. More information is available here. Must be set before -calling pygame.init()initialize all imported pygame modules or pygame.display.init()Initialize the display module..

    +calling pygame.init()initialize all imported pygame modules or pygame.display.init()Initialize the display module.


    @@ -709,28 +655,6 @@ on KDE linux. This variable is only used on x11/linux platforms.

    updated. However, using this environment variable it is possible to get joystick updates even when the window is in the background. Must be set before calling pygame.init()initialize all imported pygame modules or pygame.joystick.init()Initialize the joystick module..

    -
    -

    -
    -
    SDL_MOUSE_TOUCH_EVENTS
    -Set to "1" to make mouse events also generate touch events.
    -
    -
    -

    Useful for testing touch events on desktop platforms (e.g. with a trackpad) -where this is set to 0 by default.

    -
    -

    -
    -
    "SDL_WINDOWS_DPI_AWARENESS"
    -Set to "permonitorv2" on windows 10 (and later) to declare the pygame
    -window DPI aware and ignore the desktop scaling, "permonitor" for
    -windows 8.1 and later DPI awareness and "system" for windows Vista
    -and later DPI awareness (not per monitor). Finally set it to "unaware",
    -to have the pygame window scale with the desktop scaling.
    -
    -
    -

    This hint only affects the windows platform, other platforms can control DPI awareness -via a Window creation keyword parameter called "allow_high_dpi".

    @@ -738,7 +662,7 @@ via a Window creation keyword parameter called "allow_high_dpi".




    -Edit on GitHub +Edit on GitHub
    @@ -759,12 +683,14 @@ via a Window creation keyword parameter called "allow_high_dpi".

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/rect.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/rect.html index ed197bd..336228e 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/rect.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/rect.html @@ -5,14 +5,12 @@ - pygame.Rect — pygame-ce v2.5.8 documentation - - - - - + pygame.Rect — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -108,14 +98,9 @@ pygame.Rect
    pygame object for storing rectangular coordinates
    -
    Rect(left, top, width, height, /) -> Rect
    -
    Rect((left, top), (width, height), /) -> Rect
    -
    Rect(object, /) -> Rect
    -
    Rect() -> Rect
    -
    FRect(left, top, width, height, /) -> FRect
    -
    FRect((left, top), (width, height), /) -> FRect
    -
    FRect(object, /) -> FRect
    -
    FRect() -> FRect
    +
    Rect(left, top, width, height) -> Rect
    +
    Rect((left, top), (width, height)) -> Rect
    +
    Rect(object) -> Rect
    @@ -134,148 +119,135 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    — moves the rectangle, in place
    -—moves the rectangle to the specified position
    +
    — grow or shrink the rectangle size
    +
    — grow or shrink the rectangle size, in place
    +
    — scale the rectangle by given a multiplier
    +
    — grow or shrink the rectangle size, in place
    +
    — sets the position and size of the rectangle
    +
    — moves the rectangle inside another
    +
    — moves the rectangle inside another, in place
    +
    — crops a rectangle inside another
    +
    — crops a line inside a rectangle
    +
    — joins two rectangles into one
    +
    — joins two rectangles into one, in place
    +
    — the union of many rectangles
    +
    — the union of many rectangles, in place
    +
    — resize and move a rectangle with aspect ratio
    +
    — correct negative sizes
    +
    — test if one rectangle is inside another
    +
    — test if a point is inside a rectangle
    +
    — test if two rectangles overlap
    +
    — test if one rectangle in a list intersects
    +
    — test if all rectangles in a list intersect
    +
    — test if any object in a list intersects
    +
    — test if all objects in a list intersect
    +
    — test if one rectangle in a dictionary intersects
    +
    — test if all rectangles in a dictionary intersect
    -
    -

    New in pygame-ce 2.2: Added FRect class that is functionally identical to Rect but uses -floats instead of integers, enabling fractional precision and avoiding -truncation error while being interchangeable with standard Rects.

    -

    Pygame uses Rect objects to store and manipulate rectangular areas. A Rect can be created from a combination of left, top, width, and height values. -Rects can also be created from python objects that are already a Rect or +Rects can also be created from Python objects that are already a Rect or have an attribute named "rect".

    -

    Any pygame function that requires a Rect argument also accepts any of these +

    Any Pygame function that requires a Rect argument also accepts any of these values to construct a Rect. This makes it easier to create Rects on the fly -as arguments to functions.

    -

    If no arguments are given, a zero Rect will be created (x=0, y=0, w=0, h=0). -This will only work when using the Rect/FRect class and not with functions -that require a Rect argument.

    +as arguments for functions.

    The Rect functions that change the position or size of a Rect return a new copy of the Rect with the affected changes. The original Rect is not modified. Some methods have an alternate "in-place" version that returns @@ -288,7 +260,7 @@ align the Rect:

    topleft, bottomleft, topright, bottomright midtop, midleft, midbottom, midright center, centerx, centery -size, width, height, relcenter +size, width, height w,h
    @@ -297,7 +269,7 @@ align the Rect:

    rect2.center = (20,30) -

    Assigning to size, width, height, or relcenter changes the dimensions of the rectangle; +

    Assigning to size, width or height changes the dimensions of the rectangle; all other assignments move the rectangle without resizing it. Notice that some attributes are integers and others are pairs of integers.

    If a Rect has a nonzero width or height, it will return True for a @@ -318,29 +290,13 @@ overlap, and rect1. x, y, w, h = r -

    +

    New in pygame 1.9.2: The Rect class can be subclassed. Methods such as copy() and move() will recognize this and return instances of the subclass. However, the subclass's __init__() method is not called, and __new__() is assumed to take no arguments. So these methods should be overridden if any extra attributes need to be copied.

    -
    -

    New in pygame-ce 2.5.6: relcenter added to Rect / FRect. This will return a tuple containing half -the Rect's size; the center relative to the topleft of the Rect. -Setting it to a Point will modify the size of the rect to 2 times -the Point given. Below you can find a code example of how it should work:

    -
    >>> my_rect = pygame.Rect(0, 0, 2, 2)
    ->>> my_rect.relcenter
    -(1, 1)
    ->>> my_rect.relcenter = (128, 128)
    ->>> my_rect.size
    -(256, 256)
    -
    -
    -

    Beware of non-integer relative centers! For Rects (but not FRects), relcenter -will truncate the numbers in the returned tuple.

    -
    copy()
    @@ -357,7 +313,7 @@ will truncate the numbers in the returned tuple.

    move()
    moves the rectangle
    -
    move(x, y, /) -> Rect
    +
    move(x, y) -> Rect

    Returns a new rectangle that is moved by the given offset. The x and y arguments can be any integer value, positive or negative.

    @@ -368,35 +324,17 @@ arguments can be any integer value, positive or negative.

    move_ip()
    moves the rectangle, in place
    -
    move_ip(x, y, /) -> None
    +
    move_ip(x, y) -> None

    Same as the Rect.move() method, but operates in place.

    -
    -
    -move_to()
    -
    -
    moves the rectangle to the specified position
    -
    move_to(**kwargs) -> Rect
    -
    -

    Returns a new rectangle that is moved to the given position and optionally resized. -You must provide keyword arguments to the method such as center, left, -midbottom, size that correspond to the rectangle's attributes and the -method will return a new rectangle whose specified attributes are set to the given value.

    -

    It is similar to Surface.get_rect() but instead of a calling it as a surface method -you call it as a rectangle method.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    -
    inflate()
    grow or shrink the rectangle size
    -
    inflate(x, y, /) -> Rect
    +
    inflate(x, y) -> Rect

    Returns a new rectangle with the size changed by the given offset. The rectangle remains centered around its current center. Negative values @@ -409,7 +347,7 @@ too small(< 2 > -2), center will be off.

    inflate_ip()
    grow or shrink the rectangle size, in place
    -
    inflate_ip(x, y, /) -> None
    +
    inflate_ip(x, y) -> None

    Same as the Rect.inflate() method, but operates in place.

    @@ -419,19 +357,16 @@ too small(< 2 > -2), center will be off.

    scale_by()
    scale the rectangle by given a multiplier
    -
    scale_by(scale_by) -> Rect
    -
    scale_by(x, y) -> Rect
    +
    scale_by(scalar) -> Rect
    +
    scale_by(scalex, scaley) -> Rect

    Returns a new rectangle with the size scaled by the given multipliers. The rectangle remains centered around its current center. A single scalar or separate width and height scalars are allowed. Values above one will increase the size of the rectangle, whereas values between zero and one will decrease the size of the rectangle.

    -
    -

    New in pygame-ce 2.3.1.

    -
    -

    Changed in pygame-ce 2.5.2: the argument scale_by can now be passed as a positional argument

    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    @@ -440,15 +375,12 @@ zero and one will decrease the size of the rectangle.

    scale_by_ip()
    grow or shrink the rectangle size, in place
    -
    scale_by_ip(scale_by) -> None
    -
    scale_by_ip(x, y) -> None
    +
    scale_by_ip(scalar) -> None
    +
    scale_by_ip(scalex, scaley) -> None

    Same as the Rect.scale_by() method, but operates in place.

    -
    -

    New in pygame-ce 2.3.1.

    -
    -

    Changed in pygame-ce 2.5.2: the argument scale_by can now be passed as a positional argument

    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    @@ -457,13 +389,13 @@ zero and one will decrease the size of the rectangle.

    update()
    sets the position and size of the rectangle
    -
    update(left, top, width, height, /) -> None
    -
    update((left, top), (width, height), /) -> None
    -
    update(object, /) -> None
    +
    update(left, top, width, height) -> None
    +
    update((left, top), (width, height)) -> None
    +
    update(object) -> None

    Sets the position and size of the rectangle, in place. See parameters for pygame.Rect()pygame object for storing rectangular coordinates for the parameters of this function.

    -
    +

    New in pygame 2.0.1.

    @@ -473,7 +405,7 @@ parameters for clamp()
    moves the rectangle inside another
    -
    clamp(rect, /) -> Rect
    +
    clamp(Rect) -> Rect

    Returns a new rectangle that is moved to be completely inside the argument Rect. If the rectangle is too large to fit inside, it is @@ -485,7 +417,7 @@ centered inside the argument Rect, but its size is not changed.

    clamp_ip()
    moves the rectangle inside another, in place
    -
    clamp_ip(rect, /) -> None
    +
    clamp_ip(Rect) -> None

    Same as the Rect.clamp() method, but operates in place.

    @@ -495,7 +427,7 @@ centered inside the argument Rect, but its size is not changed.

    clip()
    crops a rectangle inside another
    -
    clip(rect, /) -> Rect
    +
    clip(Rect) -> Rect

    Returns a new rectangle that is cropped to be completely inside the argument Rect. If the two rectangles do not overlap to begin with, a Rect @@ -507,14 +439,14 @@ with 0 size is returned.

    clipline()
    crops a line inside a rectangle
    -
    clipline(x1, y1, x2, y2, /) -> ((cx1, cy1), (cx2, cy2))
    -
    clipline(x1, y1, x2, y2, /) -> ()
    -
    clipline((x1, y1), (x2, y2), /) -> ((cx1, cy1), (cx2, cy2))
    -
    clipline((x1, y1), (x2, y2), /) -> ()
    -
    clipline((x1, y1, x2, y2), /) -> ((cx1, cy1), (cx2, cy2))
    -
    clipline((x1, y1, x2, y2), /) -> ()
    -
    clipline(((x1, y1), (x2, y2)), /) -> ((cx1, cy1), (cx2, cy2))
    -
    clipline(((x1, y1), (x2, y2)), /) -> ()
    +
    clipline(x1, y1, x2, y2) -> ((cx1, cy1), (cx2, cy2))
    +
    clipline(x1, y1, x2, y2) -> ()
    +
    clipline((x1, y1), (x2, y2)) -> ((cx1, cy1), (cx2, cy2))
    +
    clipline((x1, y1), (x2, y2)) -> ()
    +
    clipline((x1, y1, x2, y2)) -> ((cx1, cy1), (cx2, cy2))
    +
    clipline((x1, y1, x2, y2)) -> ()
    +
    clipline(((x1, y1), (x2, y2))) -> ((cx1, cy1), (cx2, cy2))
    +
    clipline(((x1, y1), (x2, y2))) -> ()

    Returns the coordinates of a line that is cropped to be completely inside the rectangle. If the line does not overlap the rectangle, then an empty @@ -567,7 +499,10 @@ line. See example code below.

    print("No clipping. The line is fully outside the rect.")
    -
    +
    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    +
    +

    New in pygame 2.0.0.

    @@ -577,7 +512,7 @@ line. See example code below.

    union()
    joins two rectangles into one
    -
    union(rect, /) -> Rect
    +
    union(Rect) -> Rect

    Returns a new rectangle that completely covers the area of the two provided rectangles. There may be area inside the new Rect that is not @@ -589,7 +524,7 @@ covered by the originals.

    union_ip()
    joins two rectangles into one, in place
    -
    union_ip(rect, /) -> None
    +
    union_ip(Rect) -> None

    Same as the Rect.union() method, but operates in place.

    @@ -599,9 +534,12 @@ covered by the originals.

    unionall()
    the union of many rectangles
    -
    unionall(rect_sequence, /) -> Rect
    +
    unionall(Rect_sequence) -> Rect

    Returns the union of one rectangle with a sequence of many rectangles.

    +
    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    +
    @@ -609,9 +547,12 @@ covered by the originals.

    unionall_ip()
    the union of many rectangles, in place
    -
    unionall_ip(rect_sequence, /) -> None
    +
    unionall_ip(Rect_sequence) -> None

    The same as the Rect.unionall() method, but operates in place.

    +
    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    +
    @@ -619,7 +560,7 @@ covered by the originals.

    fit()
    resize and move a rectangle with aspect ratio
    -
    fit(rect, /) -> Rect
    +
    fit(Rect) -> Rect

    Returns a new rectangle that is moved and resized to fit another. The aspect ratio of the original Rect is preserved, so the new rectangle may @@ -643,7 +584,7 @@ swapped.

    contains()
    test if one rectangle is inside another
    -
    contains(rect, /) -> bool
    +
    contains(Rect) -> bool

    Returns true when the argument is completely inside the Rect.

    @@ -653,8 +594,8 @@ swapped.

    collidepoint()
    test if a point is inside a rectangle
    -
    collidepoint(x, y, /) -> bool
    -
    collidepoint((x, y), /) -> bool
    +
    collidepoint(x, y) -> bool
    +
    collidepoint((x,y)) -> bool

    Returns true if the given point is inside the rectangle. A point along the right or bottom edge is not considered to be inside the rectangle.

    @@ -670,7 +611,7 @@ method can be used.

    colliderect()
    test if two rectangles overlap
    -
    colliderect(rect, /) -> bool
    +
    colliderect(Rect) -> bool

    Returns true if any portion of either rectangle overlap (except the top+bottom or left+right edges).

    @@ -686,11 +627,14 @@ method can be used.

    collidelist()
    test if one rectangle in a list intersects
    -
    collidelist(list, /) -> index
    +
    collidelist(list) -> index

    Test whether the rectangle collides with any in a sequence of rectangles. The index of the first collision found is returned. If no collisions are found an index of -1 is returned.

    +
    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    +
    @@ -698,51 +642,54 @@ found an index of -1 is returned.

    collidelistall()
    test if all rectangles in a list intersect
    -
    collidelistall(list, /) -> indices
    +
    collidelistall(list) -> indices

    Returns a list of all the indices that contain rectangles that collide with the Rect. If no intersecting rectangles are found, an empty list is returned.

    Not only Rects are valid arguments, but these are all valid calls:

    -
     1Rect = pygame.Rect
    - 2r = Rect(0, 0, 10, 10)
    - 3
    - 4list_of_rects = [Rect(1, 1, 1, 1), Rect(2, 2, 2, 2)]
    - 5indices0 = r.collidelistall(list_of_rects)
    - 6
    - 7list_of_lists = [[1, 1, 1, 1], [2, 2, 2, 2]]
    - 8indices1 = r.collidelistall(list_of_lists)
    - 9
    -10list_of_tuples = [(1, 1, 1, 1), (2, 2, 2, 2)]
    -11indices2 = r.collidelistall(list_of_tuples)
    -12
    -13list_of_double_tuples = [((1, 1), (1, 1)), ((2, 2), (2, 2))]
    -14indices3 = r.collidelistall(list_of_double_tuples)
    -15
    -16class ObjectWithRectAttribute(object):
    -17    def __init__(self, r):
    -18        self.rect = r
    -19
    -20list_of_object_with_rect_attribute = [
    -21    ObjectWithRectAttribute(Rect(1, 1, 1, 1)),
    -22    ObjectWithRectAttribute(Rect(2, 2, 2, 2)),
    -23]
    -24indices4 = r.collidelistall(list_of_object_with_rect_attribute)
    -25
    -26class ObjectWithCallableRectAttribute(object):
    -27    def __init__(self, r):
    -28        self._rect = r
    -29
    -30    def rect(self):
    -31        return self._rect
    -32
    -33list_of_object_with_callable_rect = [
    -34    ObjectWithCallableRectAttribute(Rect(1, 1, 1, 1)),
    -35    ObjectWithCallableRectAttribute(Rect(2, 2, 2, 2)),
    -36]
    -37indices5 = r.collidelistall(list_of_object_with_callable_rect)
    +
    Rect = pygame.Rect
    +r = Rect(0, 0, 10, 10)
    +
    +list_of_rects = [Rect(1, 1, 1, 1), Rect(2, 2, 2, 2)]
    +indices0 = r.collidelistall(list_of_rects)
    +
    +list_of_lists = [[1, 1, 1, 1], [2, 2, 2, 2]]
    +indices1 = r.collidelistall(list_of_lists)
    +
    +list_of_tuples = [(1, 1, 1, 1), (2, 2, 2, 2)]
    +indices2 = r.collidelistall(list_of_tuples)
    +
    +list_of_double_tuples = [((1, 1), (1, 1)), ((2, 2), (2, 2))]
    +indices3 = r.collidelistall(list_of_double_tuples)
    +
    +class ObjectWithRectAttribute(object):
    +    def __init__(self, r):
    +        self.rect = r
    +
    +list_of_object_with_rect_attribute = [
    +    ObjectWithRectAttribute(Rect(1, 1, 1, 1)),
    +    ObjectWithRectAttribute(Rect(2, 2, 2, 2)),
    +]
    +indices4 = r.collidelistall(list_of_object_with_rect_attribute)
    +
    +class ObjectWithCallableRectAttribute(object):
    +    def __init__(self, r):
    +        self._rect = r
    +
    +    def rect(self):
    +        return self._rect
    +
    +list_of_object_with_callable_rect = [
    +    ObjectWithCallableRectAttribute(Rect(1, 1, 1, 1)),
    +    ObjectWithCallableRectAttribute(Rect(2, 2, 2, 2)),
    +]
    +indices5 = r.collidelistall(list_of_object_with_callable_rect)
     
    +
    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    +
    @@ -753,6 +700,8 @@ returned.

    collideobjects(rect_list) -> object
    collideobjects(obj_list, key=func) -> object
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave collideobjects feedback with authors

    Test whether the rectangle collides with any object in the sequence. The object of the first collision found is returned. If no collisions are found then None is returned

    @@ -760,45 +709,45 @@ found then Nonelambda obj: obj.rectangle. If an object has multiple attributes of type Rect then key could return one of them.

    -
     1r = Rect(1, 1, 10, 10)
    - 2
    - 3rects = [
    - 4    Rect(1, 1, 10, 10),
    - 5    Rect(5, 5, 10, 10),
    - 6    Rect(15, 15, 1, 1),
    - 7    Rect(2, 2, 1, 1),
    - 8]
    - 9
    -10result = r.collideobjects(rects)  # -> <rect(1, 1, 10, 10)>
    -11print(result)
    -12
    -13class ObjectWithSomRectAttribute:
    -14    def __init__(self, name, collision_box, draw_rect):
    -15        self.name = name
    -16        self.draw_rect = draw_rect
    -17        self.collision_box = collision_box
    -18
    -19    def __repr__(self):
    -20        return f'<{self.__class__.__name__}("{self.name}", {list(self.collision_box)}, {list(self.draw_rect)})>'
    -21
    -22objects = [
    -23    ObjectWithSomRectAttribute("A", Rect(15, 15, 1, 1), Rect(150, 150, 50, 50)),
    -24    ObjectWithSomRectAttribute("B", Rect(1, 1, 10, 10), Rect(300, 300, 50, 50)),
    -25    ObjectWithSomRectAttribute("C", Rect(5, 5, 10, 10), Rect(200, 500, 50, 50)),
    -26]
    -27
    -28# collision = r.collideobjects(objects) # this does not work because the items in the list are no Rect like object
    -29collision = r.collideobjects(
    -30    objects, key=lambda o: o.collision_box
    -31)  # -> <ObjectWithSomRectAttribute("B", [1, 1, 10, 10], [300, 300, 50, 50])>
    -32print(collision)
    -33
    -34screen_rect = r.collideobjects(objects, key=lambda o: o.draw_rect)  # -> None
    -35print(screen_rect)
    +
    r = Rect(1, 1, 10, 10)
    +
    +rects = [
    +    Rect(1, 1, 10, 10),
    +    Rect(5, 5, 10, 10),
    +    Rect(15, 15, 1, 1),
    +    Rect(2, 2, 1, 1),
    +]
    +
    +result = r.collideobjects(rects)  # -> <rect(1, 1, 10, 10)>
    +print(result)
    +
    +class ObjectWithSomRectAttribute:
    +    def __init__(self, name, collision_box, draw_rect):
    +        self.name = name
    +        self.draw_rect = draw_rect
    +        self.collision_box = collision_box
    +
    +    def __repr__(self):
    +        return f'<{self.__class__.__name__}("{self.name}", {list(self.collision_box)}, {list(self.draw_rect)})>'
    +
    +objects = [
    +    ObjectWithSomRectAttribute("A", Rect(15, 15, 1, 1), Rect(150, 150, 50, 50)),
    +    ObjectWithSomRectAttribute("B", Rect(1, 1, 10, 10), Rect(300, 300, 50, 50)),
    +    ObjectWithSomRectAttribute("C", Rect(5, 5, 10, 10), Rect(200, 500, 50, 50)),
    +]
    +
    +# collision = r.collideobjects(objects) # this does not work because the items in the list are no Rect like object
    +collision = r.collideobjects(
    +    objects, key=lambda o: o.collision_box
    +)  # -> <ObjectWithSomRectAttribute("B", [1, 1, 10, 10], [300, 300, 50, 50])>
    +print(collision)
    +
    +screen_rect = r.collideobjects(objects, key=lambda o: o.draw_rect)  # -> None
    +print(screen_rect)
     
    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -810,6 +759,8 @@ of them.

    collideobjectsall(rect_list) -> objects
    collideobjectsall(obj_list, key=func) -> objects
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave collideobjectsall feedback with authors

    Returns a list of all the objects that contain rectangles that collide with the Rect. If no intersecting objects are found, an empty list is returned.

    @@ -817,47 +768,47 @@ returned.

    as input and returning a rect like object e.g. lambda obj: obj.rectangle. If an object has multiple attributes of type Rect then key could return one of them.

    -
     1r = Rect(1, 1, 10, 10)
    - 2
    - 3rects = [
    - 4    Rect(1, 1, 10, 10),
    - 5    Rect(5, 5, 10, 10),
    - 6    Rect(15, 15, 1, 1),
    - 7    Rect(2, 2, 1, 1),
    - 8]
    - 9
    -10result = r.collideobjectsall(
    -11    rects
    -12)  # -> [<rect(1, 1, 10, 10)>, <rect(5, 5, 10, 10)>, <rect(2, 2, 1, 1)>]
    -13print(result)
    -14
    -15class ObjectWithSomRectAttribute:
    -16    def __init__(self, name, collision_box, draw_rect):
    -17        self.name = name
    -18        self.draw_rect = draw_rect
    -19        self.collision_box = collision_box
    -20
    -21    def __repr__(self):
    -22        return f'<{self.__class__.__name__}("{self.name}", {list(self.collision_box)}, {list(self.draw_rect)})>'
    -23
    -24objects = [
    -25    ObjectWithSomRectAttribute("A", Rect(1, 1, 10, 10), Rect(300, 300, 50, 50)),
    -26    ObjectWithSomRectAttribute("B", Rect(5, 5, 10, 10), Rect(200, 500, 50, 50)),
    -27    ObjectWithSomRectAttribute("C", Rect(15, 15, 1, 1), Rect(150, 150, 50, 50)),
    -28]
    -29
    -30# collisions = r.collideobjectsall(objects) # this does not work because ObjectWithSomRectAttribute is not a Rect like object
    -31collisions = r.collideobjectsall(
    -32    objects, key=lambda o: o.collision_box
    -33)  # -> [<ObjectWithSomRectAttribute("A", [1, 1, 10, 10], [300, 300, 50, 50])>, <ObjectWithSomRectAttribute("B", [5, 5, 10, 10], [200, 500, 50, 50])>]
    -34print(collisions)
    -35
    -36screen_rects = r.collideobjectsall(objects, key=lambda o: o.draw_rect)  # -> []
    -37print(screen_rects)
    +
    r = Rect(1, 1, 10, 10)
    +
    +rects = [
    +    Rect(1, 1, 10, 10),
    +    Rect(5, 5, 10, 10),
    +    Rect(15, 15, 1, 1),
    +    Rect(2, 2, 1, 1),
    +]
    +
    +result = r.collideobjectsall(
    +    rects
    +)  # -> [<rect(1, 1, 10, 10)>, <rect(5, 5, 10, 10)>, <rect(2, 2, 1, 1)>]
    +print(result)
    +
    +class ObjectWithSomRectAttribute:
    +    def __init__(self, name, collision_box, draw_rect):
    +        self.name = name
    +        self.draw_rect = draw_rect
    +        self.collision_box = collision_box
    +
    +    def __repr__(self):
    +        return f'<{self.__class__.__name__}("{self.name}", {list(self.collision_box)}, {list(self.draw_rect)})>'
    +
    +objects = [
    +    ObjectWithSomRectAttribute("A", Rect(1, 1, 10, 10), Rect(300, 300, 50, 50)),
    +    ObjectWithSomRectAttribute("B", Rect(5, 5, 10, 10), Rect(200, 500, 50, 50)),
    +    ObjectWithSomRectAttribute("C", Rect(15, 15, 1, 1), Rect(150, 150, 50, 50)),
    +]
    +
    +# collisions = r.collideobjectsall(objects) # this does not work because ObjectWithSomRectAttribute is not a Rect like object
    +collisions = r.collideobjectsall(
    +    objects, key=lambda o: o.collision_box
    +)  # -> [<ObjectWithSomRectAttribute("A", [1, 1, 10, 10], [300, 300, 50, 50])>, <ObjectWithSomRectAttribute("B", [5, 5, 10, 10], [200, 500, 50, 50])>]
    +print(collisions)
    +
    +screen_rects = r.collideobjectsall(objects, key=lambda o: o.draw_rect)  # -> []
    +print(screen_rects)
     
    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -866,14 +817,14 @@ of them.

    collidedict()
    test if one rectangle in a dictionary intersects
    -
    collidedict(rect_dict) -> (key, value)
    -
    collidedict(rect_dict) -> None
    -
    collidedict(rect_dict, values=False) -> (key, value)
    -
    collidedict(rect_dict, values=False) -> None
    +
    collidedict(dict) -> (key, value)
    +
    collidedict(dict) -> None
    +
    collidedict(dict, use_values=0) -> (key, value)
    +
    collidedict(dict, use_values=0) -> None

    Returns the first key and value pair that intersects with the calling Rect object. If no collisions are found, None is returned. If -values is False (default) then the dict's keys will be used in the +use_values is 0 (default) then the dict's keys will be used in the collision detection, otherwise the dict's values will be used.

    Note

    @@ -882,9 +833,7 @@ hashable), so they must be converted to a tuple. e.g. rect.collidedict({tuple(key_rect) : value})

    -

    Changed in pygame-ce 2.4.0: values is now accepted as a keyword argument. Type Stub updated -to use boolean True or False, but any truthy or falsy value -will be valid.

    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    @@ -893,12 +842,12 @@ will be valid.

    collidedictall()
    test if all rectangles in a dictionary intersect
    -
    collidedictall(rect_dict) -> [(key, value), ...]
    -
    collidedictall(rect_dict, values=False) -> [(key, value), ...]
    +
    collidedictall(dict) -> [(key, value), ...]
    +
    collidedictall(dict, use_values=0) -> [(key, value), ...]

    Returns a list of all the key and value pairs that intersect with the calling Rect object. If no collisions are found an empty list is returned. -If values is False (default) then the dict's keys will be used in the +If use_values is 0 (default) then the dict's keys will be used in the collision detection, otherwise the dict's values will be used.

    Note

    @@ -907,9 +856,7 @@ hashable), so they must be converted to a tuple. e.g. rect.collidedictall({tuple(key_rect) : value})

    -

    Changed in pygame-ce 2.4.0: values is now accepted as a keyword argument. Type Stub updated -to use boolean True or False, but any truthy or falsy value -will be valid.

    +

    Changed in pygame 2.5.0: Added support for keyword arguments.

    @@ -920,7 +867,7 @@ will be valid.




    -Edit on GitHub +Edit on GitHub
    @@ -941,12 +888,14 @@ will be valid.

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/scrap.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/scrap.html index 62de99e..97df7b7 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/scrap.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/scrap.html @@ -5,14 +5,12 @@ - pygame.scrap — pygame-ce v2.5.8 documentation - - - - - + pygame.scrap — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -111,57 +101,42 @@
    - - - - - - - - - - - - - - - - - - - - @@ -170,98 +145,55 @@
    -—Places text into the clipboard.
    -—Gets text from the clipboard.
    -—Checks if text is in the clipboard.
    +
    — Initializes the scrap module.
    +
    — Returns True if the scrap module is currently initialized.
    +
    — Gets the data for the specified type from the clipboard.
    +
    — Gets a list of the available clipboard types.
    +
    — Places data into the clipboard.
    +
    — Checks whether data for a given type is available in the clipboard.
    +
    — Indicates if the clipboard ownership has been lost by the pygame application.
    +
    — Sets the clipboard access mode.

    EXPERIMENTAL!: This API may change or disappear in later pygame releases. If you use this, your code may break with the next pygame release.

    -

    The scrap module is for transferring data to/from the clipboard. This allows for -transferring of strings between pygame and other applications. Currently, only strings -are supported with the scrap.put_text, scrap.get_text, and scrap.has_text -functions. All other functions are deprecated as of pygame 2.2.0 and will be removed -in a future release of pygame.

    -
    -

    Note

    -

    scrap.put_text, scrap.get_text, and scrap.has_text use the same -clipboard as the rest of the current API, but only strings are compatible with the -new API as of right now.

    -
    -
    -
    -pygame.scrap.put_text()
    -
    -
    Places text into the clipboard.
    -
    put_text(text, /) -> None
    -
    -

    Places the input text into the clipboard. The data should be a string. -This is the same clipboard as the legacy scrap API when using SCRAP_TEXT.

    -
    -
    Raises:
    -

    pygame.errorstandard pygame exception -- if video mode has not been set_mode

    -
    -
    -
    -

    Note

    -

    pygame.display.set_mode() should be called before using the scrap module

    -
    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    - -
    -
    -pygame.scrap.get_text()
    -
    -
    Gets text from the clipboard.
    -
    get_text() -> str
    -
    -

    Gets text from the clipboard and returns it. If the clipboard is empty, -returns an empty string. This is the same clipboard as the legacy scrap -API when using SCRAP_TEXT.

    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    - -
    -
    -pygame.scrap.has_text()
    -
    -
    Checks if text is in the clipboard.
    -
    has_text() -> bool
    -
    -

    Returns True if the clipboard has a string, otherwise returns False. -This is the same clipboard as the legacy scrap API when using SCRAP_TEXT.

    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    - -

    THE BELOW INFORMATION IS DEPRECATED IN PYGAME 2.2.0 AND WILL BE REMOVED IN THE FUTURE.

    The scrap module is for transferring data to/from the clipboard. This allows for cutting and pasting data between pygame and other applications. Some basic data (MIME) types are defined and registered:

    -
    "text/plain"                 Plain text (also accessible via the SCRAP_TEXT constant)
    -"text/plain;charset=utf-8"   UTF-8 encoded text
    +
     pygame         string
    +constant        value        description
    +--------------------------------------------------
    +SCRAP_TEXT   "text/plain"    plain text
    +SCRAP_BMP    "image/bmp"     BMP encoded image data
    +SCRAP_PBM    "image/pbm"     PBM encoded image data
    +SCRAP_PPM    "image/ppm"     PPM encoded image data
     
    +

    pygame.SCRAP_PPM, pygame.SCRAP_PBM and pygame.SCRAP_BMP are +suitable for surface buffers to be shared with other applications. +pygame.SCRAP_TEXT is an alias for the plain text clipboard type.

    +

    Depending on the platform, additional types are automatically registered when +data is placed into the clipboard to guarantee a consistent sharing behaviour +with other applications. The following listed types can be used as strings to +be passed to the respective pygame.scrappygame module for clipboard support. module functions.

    For Windows platforms, these additional types are supported automatically and resolve to their internal definitions:

    -
    "image/bmp"                  BMP encoded image data (also accessible via the SCRAP_BMP constant)
    +
    "text/plain;charset=utf-8"   UTF-8 encoded text
     "audio/wav"                  WAV encoded audio
     "image/tiff"                 TIFF encoded image data
     
    -

    User defined types can be used on Windows, but the data might not be -accessible by other applications unless they know what data type to look for. +

    For X11 platforms, these additional types are supported automatically and +resolve to their internal definitions:

    +
    "text/plain;charset=utf-8"   UTF-8 encoded text
    +"UTF8_STRING"                UTF-8 encoded text
    +"COMPOUND_TEXT"              COMPOUND text
    +
    +
    +

    User defined types can be used, but the data might not be accessible by other +applications unless they know what data type to look for. Example: Data placed into the clipboard by pygame.scrap.put("my_data_type", byte_data) can only be accessed by applications which query the clipboard for the "my_data_type" data type.

    For an example of how the scrap module works refer to the examples page (pygame.examples.scrap_clipboard.main()access the clipboard) or the code directly in GitHub -(pygame/examples/scrap_clipboard.py).

    -
    +(pygame/examples/scrap_clipboard.py).

    +

    New in pygame 1.8.

    Note

    -

    Non-text data is only supported on Windows. On other platforms only text is supported.

    +

    The scrap module is currently only supported for Windows, X11 and Mac OS X. +On Mac OS X only text works at the moment - other types may be supported in +future releases.

    @@ -278,12 +210,9 @@ applications which query the clipboard for the

    Note

    -

    The scrap module requires pygame.display.set_mode()Initialize a window or screen for display. be +

    The scrap module requires pygame.display.set_mode()Initialize a window or screen for display be called before being initialized.

    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    @@ -303,12 +232,9 @@ initialized, False<

    bool

    -
    +

    New in pygame 1.9.5.

    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    @@ -316,7 +242,7 @@ initialized, False< pygame.scrap.get()
    Gets the data for the specified type from the clipboard.
    -
    get(type, /) -> bytes | None
    +
    get(type) -> bytes | None

    Retrieves the data for the specified type from the clipboard. The data is returned as a byte string and might need further processing (such as @@ -333,9 +259,6 @@ no data for the given type is available

    bytes | None

    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    text = pygame.scrap.get(pygame.SCRAP_TEXT)
     if text:
         print("There is text in the clipboard.")
    @@ -365,9 +288,6 @@ is no data in the clipboard an empty list is returned

    list

    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    for t in pygame.scrap.get_types():
         if "text" in t:
             # There is some content with the word "text" in its type string.
    @@ -381,13 +301,13 @@ is no data in the clipboard an empty list is returned

    pygame.scrap.put()
    Places data into the clipboard.
    -
    put(type, data, /) -> None
    +
    put(type, data) -> None

    Places data for a given clipboard type into the clipboard. The data must be a string buffer. The type is a string identifying the type of data to be placed into the clipboard. This can be one of the predefined -pygame.SCRAP_BMP or pygame.SCRAP_TEXT values or a user defined -string identifier.

    +pygame.SCRAP_PBM, pygame.SCRAP_PPM, pygame.SCRAP_BMP or +pygame.SCRAP_TEXT values or a user defined string identifier.

    Parameters:
    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    with open("example.bmp", "rb") as fp:
         pygame.scrap.put(pygame.SCRAP_BMP, fp.read())
     # The image data is now on the clipboard for other applications to access
    @@ -418,7 +335,7 @@ clipboard

    pygame.scrap.contains()
    Checks whether data for a given type is available in the clipboard.
    -
    contains(type, /) -> bool
    +
    contains(type) -> bool

    Checks whether data for the given type is currently available in the clipboard.

    @@ -434,9 +351,6 @@ clipboard, False

    bool

    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    if pygame.scrap.contains(pygame.SCRAP_TEXT):
         print("There is text in the clipboard.")
     if pygame.scrap.contains("own_data_type"):
    @@ -463,9 +377,6 @@ application, False<
     

    bool

    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    if pygame.scrap.lost():
         print("The clipboard is in use by another application.")
     
    @@ -477,7 +388,7 @@ application, False< pygame.scrap.set_mode()
    Sets the clipboard access mode.
    -
    set_mode(mode, /) -> None
    +
    set_mode(mode) -> None

    Sets the access mode for the clipboard. This is only of interest for X11 environments where clipboard modes pygame.SCRAP_SELECTION (for mouse @@ -495,9 +406,6 @@ effect when used on X11 platforms)

    pygame.SCRAP_CLIPBOARD or pygame.SCRAP_SELECTION

    -
    -

    Deprecated since pygame-ce 2.2.0.

    -
    @@ -507,7 +415,7 @@ effect when used on X11 platforms)




    -Edit on GitHub +Edit on GitHub
    @@ -528,12 +436,14 @@ effect when used on X11 platforms)

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_controller.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_controller.html index 74a6509..3ddb419 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_controller.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_controller.html @@ -5,14 +5,12 @@ - pygame._sdl2.controller — pygame-ce v2.5.8 documentation - - - - - + pygame._sdl2.controller — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -158,6 +148,10 @@ +
    +

    Note

    +

    Use import pygame._sdl2.controller before using this module.

    +

    This module offers control over common controller types like the dualshock 4 or the xbox 360 controllers: They have two analog sticks, two triggers, two shoulder buttons, a dpad, 4 buttons on the side, 2 (or 3) buttons in the middle.

    @@ -166,8 +160,12 @@ they always refer to the same buttons. For example
    CONTROLLERAXISMOTION, CONTROLLERBUTTONDOWN, CONTROLLERBUTTONUP,
    -CONTROLLERDEVICEREMAPPED, CONTROLLERDEVICEADDED, CONTROLLERDEVICEREMOVED,
    -CONTROLLERTOUCHPADDOWN, CONTROLLERTOUCHPADMOTION, CONTROLLERTOUCHPADUP
    +CONTROLLERDEVICEREMAPPED, CONTROLLERDEVICEADDED, CONTROLLERDEVICEREMOVED
    +
    +
    +

    Additionally if pygame is built with SDL 2.0.14 or higher the following events can also be generated +(to get the version of sdl pygame is built with use pygame.version.SDL()tupled integers of the SDL library version):

    +
    CONTROLLERTOUCHPADDOWN, CONTROLLERTOUCHPADMOTION, CONTROLLERTOUCHPADUP
     

    These events can be enabled/disabled by pygame._sdl2.controller.set_eventstate()Sets the current state of events related to controllers @@ -177,7 +175,7 @@ events related to controllers.

    Note

    See the pygame.joystickPygame module for interacting with joysticks, gamepads, and trackballs. for a more versatile but more advanced api.

    -
    +

    New in pygame 2: This module requires SDL2.

    @@ -224,7 +222,7 @@ events related to controllers.

    Note

    Controllers can still generate joystick events, which will not be toggled by this function.

    -
    +

    Changed in pygame 2.0.2:: Changed return type from int to None

    @@ -238,7 +236,7 @@ events related to controllers.

    Returns the current state of events related to controllers, True meaning events will be posted.

    -
    +

    New in pygame 2.0.2.

    @@ -290,84 +288,63 @@ initialized on creation.

    - - - - - - - - - - - - - - - - - - -
    -—Initialize the Controller
    +
    — uninitialize the Controller
    +
    — check if the Controller is initialized
    +
    — Create a Controller from a pygame.joystick.Joystick object
    +
    — Check if the Controller has been opened and is currently connected.
    +
    — Returns a pygame.joystick.Joystick() object
    +
    — Get the current state of a joystick axis
    +
    — Get the current state of a button
    +
    — Get the mapping assigned to the controller
    +
    — Assign a mapping to the controller
    +
    — Start a rumbling effect
    +
    — Stop any rumble effect playing
    -—Set the LED color of the controller
    -
    -
    -init()
    -
    -
    Initialize the Controller
    -
    init() -> None
    -
    -

    Initialize a controller object. This should not be used much, since -Controllers are initialised on creation.

    -
    -
    quit()
    @@ -468,7 +445,7 @@ The button argument must be one of the following constants:

    Returns a dict containing the mapping of the Controller. For more information see Controller.set_mapping()

    -
    +

    Changed in pygame 2.0.2:: Return type changed from str to dict

    @@ -498,10 +475,10 @@ dictionary must be a button, hat or axis represented in the following way:

    The function will return 1 if a new mapping is added or 0 if an existing one is updated.

    -
    +

    Changed in pygame 2.0.2:: Renamed from add_mapping to set_mapping

    -
    +

    Changed in pygame 2.0.2:: Argument type changed from str to dict

    @@ -519,8 +496,8 @@ to 0 will play the effect until another one overwrites it or Controller.stop_rumble() is called. If an effect is already playing, then it will be overwritten.

    Returns True if the rumble was played successfully or False if the -controller does not support it.

    -
    +controller does not support it or pygame.version.SDL()tupled integers of the SDL library version is below 2.0.9.

    +

    New in pygame 2.0.2.

    @@ -534,26 +511,8 @@ controller does not support it.

    Stops any rumble effect playing on the controller. See Controller.rumble() for more information.

    -
    -

    New in pygame 2.0.2.

    -
    - - -
    -
    -set_led()
    -
    -
    Set the LED color of the controller
    -
    set_led(color_arg) -> bool
    -
    -

    Set the color of the LED on the controller. The argument is a -pygame.Color-compatible value (alpha being ignored). The -controller's LED, if it has one, will be set to the input color. -If the controller does not have an addressable LED, then this -method will do nothing and return False. Returns True if the -LED was set successfully.

    -

    New in pygame-ce 2.5.6.

    +

    New in pygame 2.0.2.

    @@ -566,7 +525,7 @@ LED was set successfully.




    -Edit on GitHub +Edit on GitHub
    @@ -587,12 +546,14 @@ LED was set successfully.

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_video.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_video.html index 026dd48..f0a952a 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_video.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sdl2_video.html @@ -5,14 +5,12 @@ - pygame.sdl2_video — pygame-ce v2.5.8 documentation - - - - - + pygame.sdl2_video — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -109,214 +99,446 @@

    Warning

    This module isn't ready for prime time yet, it's still in development. -These docs are primarily meant to help the pygame developers and -super-early adopters who are in communication with the developers. -This API will change.

    +These docs are primarily meant to help the pygame developers and super-early adopters +who are in communication with the developers. This API will change.

    - - - - - - - - - - - - - - - + - - + - - +
    -—pygame object encapsulating Renderer driver information
    -—Yield info about the rendering drivers available for Renderer objects
    -—Get the window with input grab enabled
    +
    — pygame object that represents a window
    +
    —pygame object that represents a texturepygame object that representing a Texture.
    +
    —pygame object that represents a portion of a textureEasy way to use a portion of a Texture without worrying about srcrect all the time.
    +
    —pygame object wrapping a 2D rendering context for a windowCreate a 2D rendering context for a window.
    Experimental pygame module for porting new SDL video systems
    -
    -
    -pygame._sdl2.video.RendererDriverInfo
    -
    -
    pygame object encapsulating Renderer driver information
    -
    -

    Attributes:

    -
    name
    -flags
    -num_texture_formats
    -max_texture_width
    -max_texture_height
    -
    -
    -
    - -
    -
    -pygame._sdl2.video.get_drivers()
    -
    -
    Yield info about the rendering drivers available for Renderer objects
    -
    get_drivers() -> Iterator[RendererDriverInfo]
    -
    -
    - -
    -
    -pygame._sdl2.video.get_grabbed_window()
    -
    -
    Get the window with input grab enabled
    -
    get_grabbed_window() -> Window or None
    -
    -

    Gets the Window with input grab enabled, if input is grabbed, -otherwise None is returned.

    -
    -
    pygame._sdl2.video.Window
    pygame object that represents a window
    +
    Window(title="pygame", size=(640, 480), position=None, fullscreen=False, fullscreen_desktop=False, keywords) -> Window
    -

    See pygame.WindowPygame object that represents a window.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +—Creates window using window created by pygame.display.set_mode().
    +—Create Window from another window. Could be from another UI toolkit.
    +—Gets or sets whether the mouse is confined to the window.
    +—Gets or sets the window's relative mouse motion state.
    +—Enable windowed mode (exit fullscreen).
    +—Enter fullscreen.
    +—Gets or sets whether the window title.
    +—Destroys the window.
    +—Hide the window.
    +—Show the window.
    +—Raise the window above other windows and set the input focus. The "input_only" argument is only supported on X11.
    +—Restore the size and position of a minimized or maximized window.
    +—Maximize the window.
    +—Minimize the window.
    +—Gets and sets whether the window is resizable.
    +—Add or remove the border from the window.
    +—Set the icon for the window.
    +—Get the unique window ID. *Read-only*
    +—Gets and sets the window size.
    +—Gets and sets the window position.
    +—Gets and sets the window opacity. Between 0.0 (fully transparent) and 1.0 (fully opaque).
    +—Get the index of the display that owns the window. *Read-only*
    +—Set the window as a modal for a parent window. This function is only supported on X11.
    +
    +
    +classmethod from_display_module()
    +
    +
    Creates window using window created by pygame.display.set_mode().
    +
    from_display_module() -> Window
    +
    +
    + +
    +
    +classmethod from_window()
    +
    +
    Create Window from another window. Could be from another UI toolkit.
    +
    from_window(other) -> Window
    +
    +
    + +
    +
    +grab
    +
    +
    Gets or sets whether the mouse is confined to the window.
    +
    grab -> bool
    +
    +
    + +
    +
    +relative_mouse
    +
    +
    Gets or sets the window's relative mouse motion state.
    +
    relative_mouse -> bool
    +
    +
    + +
    +
    +set_windowed()
    +
    +
    Enable windowed mode (exit fullscreen).
    +
    set_windowed() -> None
    +
    +
    + +
    +
    +set_fullscreen()
    +
    +
    Enter fullscreen.
    +
    set_fullscreen(desktop=False) -> None
    +
    +
    + +
    +
    +title
    +
    +
    Gets or sets whether the window title.
    +
    title -> string
    +
    +
    + +
    +
    +destroy()
    +
    +
    Destroys the window.
    +
    destroy() -> None
    +
    +
    + +
    +
    +hide()
    +
    +
    Hide the window.
    +
    hide() -> None
    +
    +
    + +
    +
    +show()
    +
    +
    Show the window.
    +
    show() -> None
    +
    +
    + +
    +
    +focus()
    +
    +
    Raise the window above other windows and set the input focus. The "input_only" argument is only supported on X11.
    +
    focus(input_only=False) -> None
    +
    +
    + +
    +
    +restore()
    +
    +
    Restore the size and position of a minimized or maximized window.
    +
    restore() -> None
    +
    +
    + +
    +
    +maximize()
    +
    +
    Maximize the window.
    +
    maximize() -> None
    +
    +
    + +
    +
    +minimize()
    +
    +
    Minimize the window.
    +
    maximize() -> None
    +
    +
    + +
    +
    +resizable
    +
    +
    Gets and sets whether the window is resizable.
    +
    resizable -> bool
    +
    +
    + +
    +
    +borderless
    +
    +
    Add or remove the border from the window.
    +
    borderless -> bool
    +
    +
    + +
    +
    +set_icon()
    +
    +
    Set the icon for the window.
    +
    set_icon(surface) -> None
    +
    +
    + +
    +
    +id
    +
    +
    Get the unique window ID. *Read-only*
    +
    id -> int
    +
    +
    + +
    +
    +size
    +
    +
    Gets and sets the window size.
    +
    size -> (int, int)
    +
    +
    + +
    +
    +position
    +
    +
    Gets and sets the window position.
    +
    position -> (int, int) or WINDOWPOS_CENTERED or WINDOWPOS_UNDEFINED
    +
    +
    + +
    +
    +opacity
    +
    +
    Gets and sets the window opacity. Between 0.0 (fully transparent) and 1.0 (fully opaque).
    +
    opacity -> float
    +
    +
    + +
    +
    +display_index
    +
    +
    Get the index of the display that owns the window. *Read-only*
    +
    display_index -> int
    +
    +
    + +
    +
    +set_modal_for()
    +
    +
    Set the window as a modal for a parent window. This function is only supported on X11.
    +
    set_modal_for(Window) -> None
    +
    +
    +
    pygame._sdl2.video.Texture
    -
    pygame object that represents a texture
    -
    Texture(renderer, size, depth=0, static=False, streaming=False, target=False, scale_quality=None) -> Texture
    +
    pygame object that representing a Texture.
    +
    Texture(renderer, size, depth=0, static=False, streaming=False, target=False) -> Texture
    - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - + - +
    -—Get the renderer associated with the texture (**read-only**)
    -—Get the width of the texture (**read-only**)
    -—Get the height of the texture (**read-only**)
    -—Get or set the additional alpha value multiplied into draw operations
    -—Get or set the blend mode for texture drawing operations
    -—Get or set the additional color value multiplied into texture drawing operations
    —Create a texture from an existing surfaceCreate a texture from an existing surface.
    +—Gets the renderer associated with the Texture. *Read-only*
    +—Gets the width of the Texture. *Read-only*
    +—Gets the height of the Texture. *Read-only*
    +—Gets and sets an additional alpha value multiplied into render copy operations.
    +—Gets and sets the blend mode for the Texture.
    +—Gets and sets an additional color value multiplied into render copy operations.
    —Get the rectangular area of the textureGet the rectangular area of the texture.
    —Copy a portion of the texture to the rendering target
    -—Copy a triangle portion of the texture to the rendering target using the given coordinates
    -—Copy a quad portion of the texture to the rendering target using the given coordinatesCopy a portion of the texture to the rendering target.
    —Update the texture with Surface (slow operation, use sparingly)Update the texture with a Surface. WARNING: Slow operation, use sparingly.
    -

    Creates an empty texture.

    -
    -
    Parameters:
    -
      -
    • renderer (Renderer) -- The rendering context for the texture.

    • -
    • size (tuple) -- The width and height for the texture.

    • -
    • depth (int) -- The pixel format (0 to use the default).

    • -
    • static (bool) -- Initialize the texture as static -(changes rarely, not lockable).

    • -
    • streaming (bool) -- Initialize the texture as streaming -(changes frequently, lockable).

    • -
    • target (bool) -- Initialize the texture as target -(can be used as a rendering target).

    • -
    • scale_quality (int) -- Set the texture scale quality. Can be 0 -(nearest pixel sampling), 1 -(linear filtering, supported by OpenGL and Direct3D) -and 2 (anisotropic filtering, supported by Direct3D).

    • -
    -
    -
    -

    One of static, streaming, or target can be set -to True. If all are False, then static is used.

    -

    Texture objects provide a platform-agnostic API for working with GPU textures. -They are stored in GPU video memory (VRAM), and are therefore very fast to -rotate and resize when drawn onto a Renderer -(an object that manages a rendering context inside a Window) on most GPUs.

    -

    Since textures are stored in GPU video memory, they aren't as easy to modify -as the image data of pygame.SurfacePygame object for representing images. objects, which reside in RAM.

    -

    Textures can be modified in 2 ways:

    -
    -
      -
    • By drawing other textures onto them, achieved by marking them as "target" textures and setting them as the rendering target of their Renderer object (if properly configured and supported).

    • -
    • By updating them with a Surface.

    • -
    -
    -

    Note

    -

    A pygame.SurfacePygame object for representing images.-to-Texture update is generally -considered a slow operation, as it requires image data to be uploaded from -RAM to VRAM, which can have a notable overhead cost.

    +
    +
    +static from_surface()
    +
    +
    Create a texture from an existing surface.
    +
    from_surface(renderer, surface) -> Texture
    -
    +
    +
    renderer
    -
    Get the renderer associated with the texture (**read-only**)
    +
    Gets the renderer associated with the Texture. *Read-only*
    renderer -> Renderer
    @@ -325,7 +547,7 @@ RAM to VRAM, which can have a notable overhead cost.

    width
    -
    Get the width of the texture (**read-only**)
    +
    Gets the width of the Texture. *Read-only*
    width -> int
    @@ -334,7 +556,7 @@ RAM to VRAM, which can have a notable overhead cost.

    height
    -
    Get the height of the texture (**read-only**)
    +
    Gets the height of the Texture. *Read-only*
    height -> int
    @@ -343,7 +565,7 @@ RAM to VRAM, which can have a notable overhead cost.

    alpha
    -
    Get or set the additional alpha value multiplied into draw operations
    +
    Gets and sets an additional alpha value multiplied into render copy operations.
    alpha -> int
    @@ -352,154 +574,45 @@ RAM to VRAM, which can have a notable overhead cost.

    blend_mode
    -
    Get or set the blend mode for texture drawing operations
    +
    Gets and sets the blend mode for the Texture.
    blend_mode -> int
    -

    Gets or sets the blend mode for the texture's drawing operations. -Valid blend modes are any of the BLENDMODE_* constants or a custom one.

    color
    -
    Get or set the additional color value multiplied into texture drawing operations
    -
    color -> Color
    +
    Gets and sets an additional color value multiplied into render copy operations.
    +
    color -> color
    -
    -
    -static from_surface()
    -
    -
    Create a texture from an existing surface
    -
    from_surface(renderer, surface) -> Texture
    -
    -
    -
    Parameters:
    -
      -
    • renderer (Renderer) -- Rendering context for the texture.

    • -
    • surface (Surface) -- The surface to create a texture from.

    • -
    -
    -
    -
    -
    get_rect()
    -
    Get the rectangular area of the texture
    +
    Get the rectangular area of the texture.
    get_rect(**kwargs) -> Rect
    -

    Like pygame.Surface.get_rect()Get the rectangular area of the Surface., this method returns a new -pygame.Rectpygame object for storing rectangular coordinates covering the entire texture. It will always -have a topleft of (0, 0) with a width and height the same size as the -texture.

    draw()
    -
    Copy a portion of the texture to the rendering target
    +
    Copy a portion of the texture to the rendering target.
    draw(srcrect=None, dstrect=None, angle=0, origin=None, flip_x=False, flip_y=False) -> None
    -
    -
    Parameters:
    -
      -
    • srcrect -- The source rectangle on the texture, or None for the -entire texture.

    • -
    • dstrect -- The destination rectangle on the rendering target, or -None for the entire rendering target. The texture -will be stretched to fill dstrect.

    • -
    • angle (float) -- The angle (in degrees) to rotate dstrect around -(clockwise).

    • -
    • origin -- The point around which dstrect will be rotated. -If None, it will equal the center: -(dstrect.w/2, dstrect.h/2).

    • -
    • flip_x (bool) -- Flip the drawn texture portion horizontally (x - axis).

    • -
    • flip_y (bool) -- Flip the drawn texture portion vertically (y - axis).

    • -
    -
    -
    -
    - -
    -
    -draw_triangle()
    -
    -
    Copy a triangle portion of the texture to the rendering target using the given coordinates
    -
    draw_triangle(p1_xy, p2_xy, p3_xy, p1_uv=(0.0, 0.0), p2_uv=(1.0, 1.0), p3_uv=(0.0, 1.0), p1_mod=(255, 255, 255, 255), p2_mod=(255, 255, 255, 255), p3_mod=(255, 255, 255, 255)) -> None
    -
    -
    -
    Parameters:
    -
      -
    • p1_xy -- The first vertex coordinate on the rendering target.

    • -
    • p2_xy -- The second vertex coordinate on the rendering target.

    • -
    • p3_xy -- The third vertex coordinate on the rendering target.

    • -
    • p1_uv -- The first UV coordinate of the triangle portion.

    • -
    • p2_uv -- The second UV coordinate of the triangle portion.

    • -
    • p3_uv -- The third UV coordinate of the triangle portion.

    • -
    • p1_mod -- The first vertex color modulation.

    • -
    • p2_mod -- The second vertex color modulation.

    • -
    • p3_mod -- The third vertex color modulation.

    • -
    -
    -
    -
    - -
    -
    -draw_quad()
    -
    -
    Copy a quad portion of the texture to the rendering target using the given coordinates
    -
    draw_quad(p1_xy, p2_xy, p3_xy, p4_xy, p1_uv=(0.0, 0.0), p2_uv=(1.0, 0.0), p3_uv=(1.0, 1.0), p4_uv=(0.0, 1.0), p1_mod=(255, 255, 255, 255), p2_mod=(255, 255, 255, 255), p3_mod=(255, 255, 255, 255), p4_mod=(255, 255, 255, 255)) -> None
    -
    -
    -
    Parameters:
    -
      -
    • p1_xy -- The first vertex coordinate on the rendering target.

    • -
    • p2_xy -- The second vertex coordinate on the rendering target.

    • -
    • p3_xy -- The third vertex coordinate on the rendering target.

    • -
    • p4_xy -- The fourth vertex coordinate on the rendering target.

    • -
    • p1_uv -- The first UV coordinate of the quad portion.

    • -
    • p2_uv -- The second UV coordinate of the quad portion.

    • -
    • p3_uv -- The third UV coordinate of the quad portion.

    • -
    • p4_uv -- The fourth UV coordinate of the quad portion.

    • -
    • p1_mod -- The first vertex color modulation.

    • -
    • p2_mod -- The second vertex color modulation.

    • -
    • p3_mod -- The third vertex color modulation.

    • -
    • p4_mod -- The fourth vertex color modulation.

    • -
    -
    -
    update()
    -
    Update the texture with Surface (slow operation, use sparingly)
    +
    Update the texture with a Surface. WARNING: Slow operation, use sparingly.
    update(surface, area=None) -> None
    -
    -
    Parameters:
    -
      -
    • surface (Surface) -- The source surface.

    • -
    • area -- The rectangular area of the texture to update.

    • -
    -
    -
    -
    -

    Note

    -

    This is a fairly slow function, intended for use with static textures -that do not change often.

    -

    If the texture is intended to be updated often, it is preferred to create -the texture as streaming and use the locking functions.

    -

    While this function will work with streaming textures, for optimization -reasons you may not get the pixels back if you lock the texture afterward.

    -
    @@ -508,96 +621,109 @@ reasons you may not get the pixels back if you lock the texture afterward.

    pygame._sdl2.video.Image
    -
    pygame object that represents a portion of a texture
    -
    Image(texture_or_image, srcrect=None) -> Image
    +
    Easy way to use a portion of a Texture without worrying about srcrect all the time.
    +
    Image(textureOrImage, srcrect=None) -> Image
    + + + + + + + + - + - - + - - + - - + - - + - - + - - + - - + - - - - - - - - - - +
    +—Get the rectangular area of the Image.
    +—Copy a portion of the Image to the rendering target.
    —Get and set the angle the Image draws itself withGets and sets the angle the Image draws itself with.
    +
    —Get or set whether the Image is flipped on the x axisGets and sets the origin. Origin=None means the Image will be rotated around its center.
    +
    —Get or set whether the Image is flipped on the y axisGets and sets whether the Image is flipped on the x axis.
    +
    —Get or set the Image color modifierGets and sets whether the Image is flipped on the y axis.
    +
    —Get or set the Image alpha modifier (0-255)Gets and sets the Image color modifier.
    +
    —Get or set the blend mode for the ImageGets and sets the Image alpha modifier.
    +
    —Get or set the Texture the Image is based onGets and sets the blend mode for the Image.
    +
    —Get or set the Rect the Image is based onGets and sets the Texture the Image is based on.
    +
    —Get or set the Image's origin of rotation
    -—Get the rectangular area of the Image
    -—Copy a portion of the Image to the rendering targetGets and sets the Rect the Image is based on.
    -

    Creates an Image.

    -
    -
    Parameters:
    -
      -
    • texture_or_image (Texture | Image) -- The Texture or an existing Image -object to create the Image from.

    • -
    • srcrect -- The rectangular portion of the Texture or Image object -passed to texture_or_image.

    • -
    -
    -
    -

    An Image object represents a portion of a Texture. Specifically, -they can be used to store and manipulate arguments for Texture.draw() -in a more user-friendly way.

    +
    +
    +get_rect()
    +
    +
    Get the rectangular area of the Image.
    +
    get_rect() -> Rect
    +
    +
    + +
    +
    +draw()
    +
    +
    Copy a portion of the Image to the rendering target.
    +
    draw(srcrect=None, dstrect=None) -> None
    +
    +
    +
    angle
    -
    Get and set the angle the Image draws itself with
    +
    Gets and sets the angle the Image draws itself with.
    angle -> float
    +
    +
    +origin
    +
    +
    Gets and sets the origin. Origin=None means the Image will be rotated around its center.
    +
    origin -> (float, float) or None.
    +
    +
    +
    flip_x
    -
    Get or set whether the Image is flipped on the x axis
    +
    Gets and sets whether the Image is flipped on the x axis.
    flip_x -> bool
    @@ -606,7 +732,7 @@ in a more user-friendly way.

    flip_y
    -
    Get or set whether the Image is flipped on the y axis
    +
    Gets and sets whether the Image is flipped on the y axis.
    flip_y -> bool
    @@ -615,7 +741,7 @@ in a more user-friendly way.

    color
    -
    Get or set the Image color modifier
    +
    Gets and sets the Image color modifier.
    color -> Color
    @@ -624,7 +750,7 @@ in a more user-friendly way.

    alpha
    -
    Get or set the Image alpha modifier (0-255)
    +
    Gets and sets the Image alpha modifier.
    alpha -> float
    @@ -633,7 +759,7 @@ in a more user-friendly way.

    blend_mode
    -
    Get or set the blend mode for the Image
    +
    Gets and sets the blend mode for the Image.
    blend_mode -> int
    @@ -642,7 +768,7 @@ in a more user-friendly way.

    texture
    -
    Get or set the Texture the Image is based on
    +
    Gets and sets the Texture the Image is based on.
    texture -> Texture
    @@ -651,231 +777,118 @@ in a more user-friendly way.

    srcrect
    -
    Get or set the Rect the Image is based on
    +
    Gets and sets the Rect the Image is based on.
    srcrect -> Rect
    -
    -
    -origin
    -
    -
    Get or set the Image's origin of rotation
    -
    origin -> (float, float) or None
    -
    -

    Gets or sets the Image's origin of rotation, a 2D point relative to -the topleft coordinates of the Image's rectangular area.

    -

    An origin of None means no origin was set and the Image will be -rotated around its center.

    -
    - -
    -
    -get_rect()
    -
    -
    Get the rectangular area of the Image
    -
    get_rect() -> Rect
    -
    -
    -

    Note

    -

    The returned Rect object might contain position information -relative to the bounds of the Texture or Image object it was -created from.

    -
    -
    - -
    -
    -draw()
    -
    -
    Copy a portion of the Image to the rendering target
    -
    draw(srcrect=None, dstrect=None) -> None
    -
    -
    -
    Parameters:
    -
      -
    • srcrect -- Source rectangle specifying a sub-Image, or None for the -entire Image.

    • -
    • dstrect -- Destination rectangle or position on the render target, -or None for entire target. The Image is stretched to -fill dstrect.

    • -
    -
    -
    -
    -
    pygame._sdl2.video.Renderer
    -
    pygame object wrapping a 2D rendering context for a window
    +
    Create a 2D rendering context for a window.
    Renderer(window, index=-1, accelerated=-1, vsync=False, target_texture=False) -> Renderer
    - - + - - + - - + - - + - - + - - + - - + - - + - - + - - - - - - - - - - + - + - + - + - + - - - - - - - - - - - - - - - - - + - - - - - +
    +
    —Get or set the blend mode used for primitive drawing operationsEasy way to create a Renderer.
    +
    —Get or set the color used for primitive drawing operationsGets and sets the blend mode used by the drawing functions.
    +
    —Get or set the logical Renderer size (a device independent resolution for rendering)Gets and sets the color used by the drawing functions.
    +
    —Get the drawing scale for the current rendering targetClear the current rendering target with the drawing color.
    +
    —Get or set the current rendering targetUpdates the screen with any new rendering since previous call.
    +
    —Create a Renderer from an existing windowReturns the drawing area on the target.
    +
    —Clear the current rendering target with the drawing colorSet the drawing area on the target. If area is None, the entire target will be used.
    +
    —Update the screen with any rendering performed since the previous callGets and sets the logical size.
    +
    —Get the drawing area on the rendering targetGets and sets the scale.
    +
    —Set the drawing area on the rendering target
    -—Translates renderer coordinates to window coordinates
    -—Translates window coordinates to renderer coordinatesGets and sets the render target. None represents the default target (the renderer).
    —Draw textures using a Surface-like APIFor compatibility purposes. Textures created by different Renderers cannot be shared!
    —Draw a lineDraws a line.
    —Draw a pointDraws a point.
    —Draw a rectangle outlineDraws a rectangle.
    —Draw a filled rectangle
    -—Draw a triangle outline
    -—Draw a filled triangle
    -—Draw a quad outline
    -—Draw a filled quadFills a rectangle.
    —Read pixels from current rendering target and create a Surface (slow operation, use sparingly)
    -—Compose a custom blend modeRead pixels from current render target and create a pygame.Surface. WARNING: Slow operation, use sparingly.
    -

    Creates a 2D rendering context for a window.

    -
    -
    Parameters:
    -
      -
    • window (Window) -- The window onto which the rendering context should be -placed.

    • -
    • index (int) -- The index of rendering driver to initialize, or -1 to init -the first supporting the requested options.

    • -
    • accelerated (int) -- If 1, the renderer uses hardware acceleration. -if 0, the renderer is a software fallback. --1 gives precedence to renderers using hardware -acceleration.

    • -
    • vsync (bool) -- If True Renderer.present() is synchronized with -the refresh rate.

    • -
    • target_texture (bool) -- Whether the renderer should support setting -Texture objects as target textures, to -enable drawing onto them.

    • -
    -
    -
    -

    Renderer objects provide a cross-platform API for rendering 2D -graphics onto a Window, by using either Metal (macOS), OpenGL -(macOS, Windows, Linux) or Direct3D (Windows) rendering drivers, depending -on what is set or is available on a system during their creation.

    -

    They can be used to draw both Texture objects and simple points, -lines and rectangles (which are colored based on Renderer.draw_color).

    -

    If configured correctly and supported by an underlying rendering driver, Renderer -objects can have a Texture object temporarily set as a target texture -(the Texture object must have been created with target texture usage support), -which allows those textures to be drawn onto.

    -

    To present drawn content onto the window, Renderer.present() should be -called. Renderer.clear() should be called to clear any drawn content -with the set Renderer draw color.

    -

    When things are drawn onto Renderer objects, an internal batching system is -used by default to batch those "draw calls" together, to have all of them be -processed in one go when Renderer.present() is called. This is unlike -pygame.SurfacePygame object for representing images. objects, on which modifications via blitting occur -immediately, but lends well to the behavior of GPUs, as draw calls can be -expensive on lower-end models.

    +
    +
    +classmethod from_window()
    +
    +
    Easy way to create a Renderer.
    +
    from_window(window) -> Renderer
    +
    +
    +
    draw_blend_mode
    -
    Get or set the blend mode used for primitive drawing operations
    +
    Gets and sets the blend mode used by the drawing functions.
    draw_blend_mode -> int
    @@ -884,58 +897,16 @@ expensive on lower-end models.

    draw_color
    -
    Get or set the color used for primitive drawing operations
    +
    Gets and sets the color used by the drawing functions.
    draw_color -> Color
    -
    -
    -logical_size
    -
    -
    Get or set the logical Renderer size (a device independent resolution for rendering)
    -
    logical_size -> (int width, int height)
    -
    -

    Note: When the rendering target is the main window, and logical_size -has not been set before, it will contain (0, 0) and not the size of -the window.

    -
    - -
    -
    -scale
    -
    -
    Get the drawing scale for the current rendering target
    -
    scale -> (float, float)
    -
    -
    - -
    -
    -target
    -
    -
    Get or set the current rendering target
    -
    target -> Texture or None
    -
    -

    Gets or sets the current rendering target. -A value of None means that no custom rendering target was set and the -Renderer's window will be used as the target.

    -
    - -
    -
    -classmethod from_window()
    -
    -
    Create a Renderer from an existing window
    -
    from_window(window) -> Renderer
    -
    -
    -
    clear()
    -
    Clear the current rendering target with the drawing color
    +
    Clear the current rendering target with the drawing color.
    clear() -> None
    @@ -944,18 +915,16 @@ Renderer's window will be used as the target.

    present()
    -
    Update the screen with any rendering performed since the previous call
    +
    Updates the screen with any new rendering since previous call.
    present() -> None
    -

    Presents the composed backbuffer to the screen. -Updates the screen with any rendering performed since the previous call.

    get_viewport()
    -
    Get the drawing area on the rendering target
    +
    Returns the drawing area on the target.
    get_viewport() -> Rect
    @@ -964,49 +933,35 @@ Updates the screen with any rendering performed since the previous call.

    set_viewport()
    -
    Set the drawing area on the rendering target
    +
    Set the drawing area on the target. If area is None, the entire target will be used.
    set_viewport(area) -> None
    -
    -
    Parameters:
    -

    area -- A pygame.Rectpygame object for storing rectangular coordinates or tuple representing the -drawing area on the target, or None to use the -entire area of the current rendering target.

    -
    -
    -
    -
    -coordinates_to_window()
    +
    +
    +logical_size
    -
    Translates renderer coordinates to window coordinates
    -
    coordinates_to_window(point) -> (float, float)
    -
    -
    -
    Parameters:
    -

    point -- The coordinates in render space.

    -
    -
    -
    -

    New in pygame-ce 2.5.6.

    +
    Gets and sets the logical size.
    +
    logical_size -> (int width, int height)
    -
    -
    -coordinates_from_window()
    +
    +
    +scale
    -
    Translates window coordinates to renderer coordinates
    -
    coordinates_from_window(point) -> (float, float)
    +
    Gets and sets the scale.
    +
    scale -> (float x_scale, float y_scale)
    -
    -
    Parameters:
    -

    point -- The coordinates in window space.

    -
    -
    -
    -

    New in pygame-ce 2.5.6.

    +
    + +
    +
    +target
    +
    +
    Gets and sets the render target. None represents the default target (the renderer).
    +
    target -> Texture or None
    @@ -1014,210 +969,54 @@ entire area of the current rendering target.

    blit()
    -
    Draw textures using a Surface-like API
    +
    For compatibility purposes. Textures created by different Renderers cannot be shared!
    blit(source, dest, area=None, special_flags=0)-> Rect
    -

    For compatibility purposes. Draws Texture objects onto the -Renderer using a method signature similar to pygame.Surface.blit()Draw another Surface onto this one..

    -
    -
    Parameters:
    -
      -
    • source -- A Texture or Image to draw.

    • -
    • dest -- The drawing destination on the rendering target.

    • -
    • area -- The portion of the source texture or image to draw from.

    • -
    • special_flags -- have no effect at this moment.

    • -
    -
    -
    -
    -

    Note

    -

    Textures created by different Renderers cannot shared with each other!

    -
    draw_line()
    -
    Draw a line
    +
    Draws a line.
    draw_line(p1, p2) -> None
    -
    -
    Parameters:
    -
      -
    • p1 -- The line start point.

    • -
    • p2 -- The line end point.

    • -
    -
    -
    draw_point()
    -
    Draw a point
    +
    Draws a point.
    draw_point(point) -> None
    -
    -
    Parameters:
    -

    point -- The point's coordinates.

    -
    -
    draw_rect()
    -
    Draw a rectangle outline
    +
    Draws a rectangle.
    draw_rect(rect)-> None
    -
    -
    Parameters:
    -

    rect -- The pygame.Rectpygame object for storing rectangular coordinates-like rectangle to draw.

    -
    -
    fill_rect()
    -
    Draw a filled rectangle
    +
    Fills a rectangle.
    fill_rect(rect)-> None
    -
    -
    Parameters:
    -

    rect -- The pygame.Rectpygame object for storing rectangular coordinates-like rectangle to draw.

    -
    -
    -
    - -
    -
    -draw_triangle()
    -
    -
    Draw a triangle outline
    -
    draw_triangle(p1, p2, p3) -> None
    -
    -
    -
    Parameters:
    -
      -
    • p1 -- The first triangle point.

    • -
    • p2 -- The second triangle point.

    • -
    • p2 -- The third triangle point.

    • -
    -
    -
    -
    - -
    -
    -fill_triangle()
    -
    -
    Draw a filled triangle
    -
    fill_triangle(p1, p2, p3) -> None
    -
    -
    -
    Parameters:
    -
      -
    • p1 -- The first triangle point.

    • -
    • p2 -- The second triangle point.

    • -
    • p2 -- The third triangle point.

    • -
    -
    -
    -
    - -
    -
    -draw_quad()
    -
    -
    Draw a quad outline
    -
    draw_quad(p1, p2, p3, p4) -> None
    -
    -
    -
    Parameters:
    -
      -
    • p1 -- The first quad point.

    • -
    • p2 -- The second quad point.

    • -
    • p2 -- The third quad point.

    • -
    • p2 -- The fourth quad point.

    • -
    -
    -
    -
    - -
    -
    -fill_quad()
    -
    -
    Draw a filled quad
    -
    fill_quad(p1, p2, p3, p4) -> None
    -
    -
    -
    Parameters:
    -
      -
    • p1 -- The first quad point.

    • -
    • p2 -- The second quad point.

    • -
    • p2 -- The third quad point.

    • -
    • p2 -- The fourth quad point.

    • -
    -
    -
    to_surface()
    -
    Read pixels from current rendering target and create a Surface (slow operation, use sparingly)
    +
    Read pixels from current render target and create a pygame.Surface. WARNING: Slow operation, use sparingly.
    to_surface(surface=None, area=None)-> Surface
    -

    Read pixel data from the current rendering target and return a -pygame.SurfacePygame object for representing images. containing it.

    -
    -
    Parameters:
    -
      -
    • surface (Surface) -- A pygame.SurfacePygame object for representing images. object to read the pixel -data into. It must be large enough to fit the area, otherwise -ValueError is raised. -If set to None, a new surface will be created.

    • -
    • area -- The area of the screen to read pixels from. The area is -clipped to fit inside the viewport. -If None, the entire viewport is used.

    • -
    -
    -
    -
    -

    Note

    -

    This is a very slow operation, due to the overhead of the VRAM to RAM -data transfer and the cost of creating a potentially large -pygame.SurfacePygame object for representing images.. It should not be used frequently.

    -
    -
    - -
    -
    -compose_custom_blend_mode()
    -
    -
    Compose a custom blend mode
    -
    compose_custom_blend_mode(color_mode, alpha_mode) -> int
    -
    -

    Compose a custom blend mode. -See https://wiki.libsdl.org/SDL2/SDL_ComposeCustomBlendMode for more information.

    -
    -
    Parameters:
    -
      -
    • color_mode -- A tuple (srcColorFactor, dstColorFactor, colorOperation)

    • -
    • alpha_mode -- A tuple (srcAlphaFactor, dstAlphaFactor, alphaOperation)

    • -
    -
    -
    Returns:
    -

    A blend mode to be used with Renderer.set_draw_blend_mode() and Texture.set_blend_mode().

    -
    -
    @@ -1229,7 +1028,7 @@ See Edit on GitHub +Edit on GitHub
    @@ -1250,12 +1049,14 @@ See previous | - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sndarray.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sndarray.html index ab805ad..b53d15c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sndarray.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sndarray.html @@ -5,18 +5,16 @@ - pygame.sndarray — pygame-ce v2.5.8 documentation - - - - - + pygame.sndarray — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
    @@ -107,29 +97,29 @@
    pygame.sndarray
    -
    Pygame module for accessing sound sample data.
    +
    pygame module for accessing sound sample data
    - + - + - + - + @@ -145,7 +135,7 @@
    —Copy Sound samples into an array.copy Sound samples into an array
    —Reference Sound samples into an array.reference Sound samples into an array
    —Convert an array into a Sound object.convert an array into a Sound object
    —Sets the array system to be used for sound arrays.Sets the array system to be used for sound arrays

    Functions to convert between NumPy arrays and Sound objects. This module will only be functional when pygame can use the external NumPy -package. If NumPy can't be imported, sndarray becomes a MissingModule +package. If NumPy can't be imported, surfarray becomes a MissingModule object.

    Sound data is made of thousands of samples per second, and each sample is the amplitude of the wave at a particular moment in time. For example, in 22-kHz @@ -155,15 +145,12 @@ format, element number 5 of the array is the amplitude of the wave after Each sample is an 8-bit or 16-bit integer, depending on the data format. A stereo sound file has two values per sample, while a mono sound file only has one.

    -
    -

    Changed in pygame-ce 2.5.6: sndarray module is lazily loaded to avoid an expensive NumPy import when unnecessary

    -
    pygame.sndarray.array()
    -
    Copy Sound samples into an array.
    -
    array(sound) -> numpy.ndarray
    +
    copy Sound samples into an array
    +
    array(Sound) -> array

    Creates a new array for the sound data and copies the samples. The array will always be in the format returned from pygame.mixer.get_init().

    @@ -173,8 +160,8 @@ will always be in the format returned from pygame.sndarray.samples()
    -
    Reference Sound samples into an array.
    -
    samples(sound) -> numpy.ndarray
    +
    reference Sound samples into an array
    +
    samples(Sound) -> array

    Creates a new array that directly references the samples in a Sound object. Modifying the array will change the Sound. The array will always be in the @@ -185,7 +172,7 @@ format returned from pygame.sndarray.make_sound()

    -
    Convert an array into a Sound object.
    +
    convert an array into a Sound object
    make_sound(array) -> Sound

    Create a new playable Sound object from an array. The mixer module must be @@ -196,12 +183,13 @@ initialized and the array format must be similar to the mixer audio format.

    pygame.sndarray.use_arraytype()
    -
    Sets the array system to be used for sound arrays.
    -
    use_arraytype(arraytype) -> None
    +
    Sets the array system to be used for sound arrays
    +
    use_arraytype (arraytype) -> None

    DEPRECATED: Uses the requested array type for the module functions. The only supported arraytype is 'numpy'. Other values will raise ValueError. -Using this function will raise a DeprecationWarning.

    +Using this function will raise a DeprecationWarning. +.. ## pygame.sndarray.use_arraytype ##

    @@ -209,12 +197,12 @@ Using this function will raise a pygame.sndarray.get_arraytype()
    Gets the currently active array type.
    -
    get_arraytype() -> str
    +
    get_arraytype () -> str

    DEPRECATED: Returns the currently active array type. This will be a value of the get_arraytypes() tuple and indicates which type of array module is used for the array creation. Using this function will raise a DeprecationWarning.

    -
    +

    New in pygame 1.8.

    @@ -224,13 +212,14 @@ for the array creation. Using this function will raise a pygame.sndarray.get_arraytypes()
    Gets the array system types currently supported.
    -
    get_arraytypes() -> tuple[str]
    +
    get_arraytypes () -> tuple
    -

    DEPRECATED: Checks which array systems are available and returns them as a tuple of +

    DEPRECATED: Checks, which array systems are available and returns them as a tuple of strings. The values of the tuple can be used directly in the -pygame.sndarray.use_arraytype()Sets the array system to be used for sound arrays. method. Using this function will -raise a DeprecationWarning.

    -
    +pygame.sndarray.use_arraytype()Sets the array system to be used for sound arrays () method. If no supported array +system could be found, None will be returned. Using this function will raise a +DeprecationWarning.

    +

    New in pygame 1.8.

    @@ -242,7 +231,7 @@ raise a Deprecation


    -Edit on GitHub +Edit on GitHub
    @@ -258,17 +247,19 @@ raise a Deprecation modules |
  • - next |
  • previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/special_flags_list.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/special_flags_list.html deleted file mode 100644 index d63f3ab..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/special_flags_list.html +++ /dev/null @@ -1,292 +0,0 @@ - - - - - - - - special flags — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    What Are Special Flags?

    -
    -

    Special flags are a means of controlling how a Surface is drawn onto another. -They can be used to create visual effects, such as glowing particles, or to perform surface -masking or manipulation. -They are used with the following methods:

    -
    -
    -

    Specifically they are passed as the special_flags argument of these methods by using -pygame.BLEND_* constants and allow you to choose how the colors of the surfaces are -combined or blended together. Different flags can produce widely different results, so -it is important to experiment to understand how they work.

    -

    By default, surfaces are drawn without any special flags, meaning they will be drawn based -on their bit depth and colorkey:

    -
    -
      -
    • If the Surface has a colorkey, the pixels matching the colorkey will be transparent.

    • -
    • If the Surface has a per-pixel or global alpha value, the alpha value will be used to blend the -pixels with the Surface below.

    • -
    • If the Surface doesn't have a colorkey or alpha value, the pixels will be opaque, meaning -that the Surface will effectively overwrite the pixels of the Surface below.

    • -
    -
    -

    The default drawing mode has its own flag: BLENDMODE_NONE (0).

    -
    -
    -
    -

    Special Flags List

    -

    Blending without Alpha Channel (RGB)

    -
    -
    -
    -

    New in pygame 1.8: / 1.8.1

    -
      -
    • -
      BLEND_ADD / BLEND_RGB_ADD

      Adds the source color channels to the destination color channels, clamped to a maximum of 255. -The result color is always a lighter color or the same color.

      -
      -
      -
    • -
    • -
      BLEND_SUB / BLEND_RGB_SUB

      Subtracts the source color channels from the destination color channels, clamped to a minimum of 0. -The result color is always a darker color or the same color.

      -
      -
      -
    • -
    • -
      BLEND_MULT / BLEND_RGB_MULT

      Multiplies the destination color channels by the source color channels, divided by 256 (or >> 8). -The result color is always a darker color or the same color.

      -
      -
      -
    • -
    • -
      BLEND_MIN / BLEND_RGB_MIN

      Takes the minimum value between the source and destination color channels.

      -
      -
      -
    • -
    • -
      BLEND_MAX / BLEND_RGB_MAX

      Takes the maximum value of each color channel

      -
      -
      -
    • -
    -
    -
    -

    Blending with Alpha Channel (RGBA)

    -
    -
    -
    -

    New in pygame 1.8.1:

    -
      -
    • -
      BLEND_RGBA_ADD

      Works like BLEND_RGB_ADD, but also adds the alpha channel.

      -
      -
      -
    • -
    • -
      BLEND_RGBA_SUB

      Works like BLEND_RGB_SUB, but also subtracts the alpha channel.

      -
      -
      -
    • -
    • -
      BLEND_RGBA_MULT

      Works like BLEND_RGB_MULT, but also multiplies the alpha channel.

      -
      -
      -
    • -
    • -
      BLEND_RGBA_MIN

      Works like BLEND_RGB_MIN, but also minimizes the alpha channel.

      -
      -
      -
    • -
    • -
      BLEND_RGBA_MAX

      Works like BLEND_RGB_MAX, but also maximizes the alpha channel.

      -
      -
      -
    • -
    -
    -
    -

    Special Alpha Blending (RGBA)

    -
    -
    -
    -

    New in pygame 1.9.2:

    - -
    -
    -

    New in pygame 2.0.0:

    -
      -
    • -
      BLEND_ALPHA_SDL2

      Uses the SDL2 blitter for alpha blending, which may give slightly different -results compared to the default blitter used in Pygame 1. This algorithm uses -different approximations for alpha blending and supports Run-Length Encoding -(RLE) on alpha-blended surfaces.

      -
      -
      -
    • -
    -
    -
    -

    Other (RGB / RGBA)

    -
    -
    -
      -
    • -
      BLENDMODE_NONE

      It's the default drawing mode. It's equivalent to not passing any special flags.

      -
      -
      -
    • -
    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sprite.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sprite.html index 82dc088..e5a53da 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sprite.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/sprite.html @@ -5,19 +5,17 @@ - pygame.sprite — pygame-ce v2.5.8 documentation - - - - - + pygame.sprite — pygame v2.6.1 documentation + + + + - - +
    @@ -25,30 +23,24 @@
    @@ -116,72 +106,97 @@ — Simple base class for visible game objects. - + + +— +A subclass of Sprite that references its Groups weakly. This means that any group this belongs to that is not referenced anywhere else is garbage collected automatically. + + — A subclass of Sprite with more attributes and features. - + — A container class to hold and manage multiple Sprite objects. + + +— +A subclass of WeakSprite and DirtySprite that combines the benefits of both classes. + + + +— +Same as pygame.sprite.Group + + + +— +Same as pygame.sprite.Group + — Group sub-class that tracks dirty updates. - + — -LayeredUpdates is a sprite group that handles layers and draws like RenderUpdates. +RenderUpdates sub-class that draws Sprites in order of addition. - + + +— +LayeredUpdates is a sprite group that handles layers and draws like OrderedUpdates. + + — LayeredDirty group is for DirtySprite objects. Subclasses LayeredUpdates. - + — Group container that holds a single sprite. - + — Find sprites in a group that intersect another sprite. - + — Collision detection between two sprites, using rects. - + — Collision detection between two sprites, using rects scaled to a ratio. - + — Collision detection between two sprites, using circles. - + — Collision detection between two sprites, using circles scaled to a ratio. - + — Collision detection between two sprites, using masks. - + — Find all sprites that collide between two groups. - + — Simple test if a sprite intersects anything in a group. @@ -198,13 +213,14 @@ of objects in the game. There is also a base Group class that simply stores sprites. A game could create new types of Group classes that operate on specially customized Sprite instances they contain.

    The basic Group class can draw the Sprites it contains to a Surface. The -Group.draw() method requires that each Sprite have a Sprite.image -attribute and a Sprite.rect. The Group.clear() method requires these +Group.draw() method requires that each Sprite have a Surface.image +attribute and a Surface.rect. The Group.clear() method requires these same attributes, and can be used to erase all the Sprites with background. -There are also more advanced Groups: pygame.sprite.RenderUpdates().

    +There are also more advanced Groups: pygame.sprite.RenderUpdates() and +pygame.sprite.OrderedUpdates().

    Lastly, this module contains several collision functions. These help find sprites inside multiple groups that have intersecting bounding rectangles. To -find the collisions, the Sprites are required to have a Sprite.rect +find the collisions, the Sprites are required to have a Surface.rect attribute assigned.

    The groups are designed for high efficiency in removing and adding Sprites to them. They also allow cheap testing to see if a Sprite already exists in a @@ -269,11 +285,11 @@ override the Sprite instances to be added to.

    When subclassing the Sprite, be sure to call the base initializer before adding the Sprite to Groups. For example:

    -
    class Block(pygame.sprite.Sprite):
    +
    class Block(pygame.sprite.Sprite):
     
         # Constructor. Pass in the color of the block,
         # and its x and y position
    -    def __init__(self, color, width, height):
    +    def __init__(self, color, width, height):
            # Call the parent class (Sprite) constructor
            pygame.sprite.Sprite.__init__(self)
     
    @@ -297,7 +313,7 @@ adding the Sprite to Groups. For example:

    The default implementation of this method does nothing; it's just a convenient "hook" that you can override. This method is called by Group.update() with whatever arguments you give it.

    -

    There is no need to use this method if not using the convenience method +

    It is not necessary to use this method if not using the convenience method by the same name in the Group class.

    @@ -358,6 +374,15 @@ to Groups.

    +
    +
    +pygame.sprite.WeakSprite
    +
    +
    A subclass of Sprite that references its Groups weakly. This means that any group this belongs to that is not referenced anywhere else is garbage collected automatically.
    +
    WeakSprite(*groups) -> WeakSprite
    +
    +
    +
    pygame.sprite.DirtySprite
    @@ -384,7 +409,7 @@ to Groups.

    visible = 1

    normally 1, if set to 0 it will not be repainted
    -(you must set it dirty too to be erased from screen)
    +(you must set it dirty too to be erased from screen)
     

    layer = 0

    @@ -452,8 +477,7 @@ to Groups.

    A simple container for Sprite objects. This class can be inherited to create containers with more specific behaviors. The constructor takes any number of -Sprite arguments to add to the Group. All sprites in groups are stored in the -order they were added to the group. The group supports the following +Sprite arguments to add to the Group. The group supports the following standard Python operations:

    in      test if a Sprite is contained
     len     the number of Sprites contained
    @@ -461,6 +485,8 @@ standard Python operations:

    iter iterate through all the Sprites
    +

    The Sprites in the Group are ordered only on python 3.6 and higher. +Below python 3.6 drawing and iterating over the Sprites is in no particular order.

    sprites()
    @@ -495,7 +521,7 @@ the same arguments as the Group class's.

    Add any number of Sprites to this Group. This will only add Sprites that are not already members of the Group.

    -

    Each sprite argument can also be an iterator containing Sprites.

    +

    Each sprite argument can also be a iterator containing Sprites.

    @@ -507,7 +533,7 @@ are not already members of the Group.

    Remove any number of Sprites from the Group. This will only remove Sprites that are already members of the Group.

    -

    Each sprite argument can also be an iterator containing Sprites.

    +

    Each sprite argument can also be a iterator containing Sprites.

    @@ -520,7 +546,7 @@ Sprites that are already members of the Group.

    Return True if the Group contains all of the given sprites. This is similar to using the "in" operator on the Group ("if sprite in group: ..."), which tests if a single Sprite belongs to a Group.

    -

    Each sprite argument can also be an iterator containing Sprites.

    +

    Each sprite argument can also be a iterator containing Sprites.

    @@ -543,17 +569,15 @@ methods.

    draw()
    blit the Sprite images
    -
    draw(Surface, bgd=None, special_flags=0) -> list[Rect]
    +
    draw(Surface, bgsurf=None, special_flags=0) -> List[Rect]

    Draws the contained Sprites to the Surface argument. This uses the Sprite.image attribute for the source surface, and Sprite.rect for the position. special_flags is passed to Surface.blit(). -bgd is unused in this method but LayeredDirty.draw() uses +bgsurf is unused in this method but LayeredDirty.draw() uses it.

    -

    The Group keeps sprites in the order they were added, they will be drawn in this order.

    -
    -

    Changed in pygame-ce 2.5.4: Added the bgd and special_flags arguments

    -
    +

    The Group does not keep sprites in any order, so the draw order is +arbitrary.

    @@ -571,7 +595,7 @@ destination Surface. However, it can also be a callback function that takes two arguments; the destination Surface and an area to clear. The background callback function will be called several times each clear.

    Here is an example callback that will clear the Sprites with solid red:

    -
    def clear_callback(surf, rect):
    +
    def clear_callback(surf, rect):
         color = 255, 0, 0
         surf.fill(color, rect)
     
    @@ -590,6 +614,33 @@ background callback function will be called several times each clear.

    +
    +
    +pygame.sprite.WeakDirtySprite
    +
    +
    A subclass of WeakSprite and DirtySprite that combines the benefits of both classes.
    +
    WeakDirtySprite(*groups) -> WeakDirtySprite
    +
    +
    + +
    +
    +pygame.sprite.RenderPlain
    +
    +
    Same as pygame.sprite.Group
    +
    +

    This class is an alias to pygame.sprite.Group(). It has no additional functionality.

    +
    + +
    +
    +pygame.sprite.RenderClear
    +
    +
    Same as pygame.sprite.Group
    +
    +

    This class is an alias to pygame.sprite.Group(). It has no additional functionality.

    +
    +
    pygame.sprite.RenderUpdates
    @@ -613,30 +664,39 @@ background callback function will be called several times each clear.

    draw()
    blit the Sprite images and track changed areas
    -
    draw(surface, bgd=None, special_flags=0) -> Rect_list
    +
    draw(surface, bgsurf=None, special_flags=0) -> Rect_list

    Draws all the Sprites to the surface, the same as Group.draw(). This method also returns a list of Rectangular areas on the screen that have been changed. The returned changes include areas of the screen that have been affected by previous Group.clear() calls. special_flags is -passed to Surface.blit(). bgd is unused in this method but -LayeredDirty.draw() uses it.

    +passed to Surface.blit().

    The returned Rect list should be passed to pygame.display.update(). This will help performance on software driven display modes. This type of updating is usually only helpful on destinations with non-animating backgrounds.

    -
    -

    Changed in pygame-ce 2.5.4: Added the bgd and special_flags arguments

    -
    +
    +
    +pygame.sprite.OrderedUpdates()
    +
    +
    RenderUpdates sub-class that draws Sprites in order of addition.
    +
    OrderedUpdates(*sprites) -> OrderedUpdates
    +
    +

    This class derives from pygame.sprite.RenderUpdates(). It maintains the +order in which the Sprites were added to the Group for rendering. This makes +adding and removing Sprites from the Group a little slower than regular +Groups.

    +
    +
    pygame.sprite.LayeredUpdates
    -
    LayeredUpdates is a sprite group that handles layers and draws like RenderUpdates.
    +
    LayeredUpdates is a sprite group that handles layers and draws like OrderedUpdates.
    LayeredUpdates(*sprites, **kwargs) -> LayeredUpdates
    @@ -649,7 +709,7 @@ backgrounds.

    - + @@ -731,7 +791,7 @@ If the **kwarg contains 'layer' then the sprites passed will be added to that layer (overriding the sprite.layer attribute). If neither sprite has attribute layer nor **kwarg then the default layer is used to add the sprites.

    -
    +

    New in pygame 1.8.

    @@ -751,7 +811,7 @@ passed then the spr
    sprites()
    -
    returns an ordered list of sprites (first back, last top).
    +
    returns a ordered list of sprites (first back, last top).
    sprites() -> sprites
    @@ -761,10 +821,7 @@ passed then the spr draw()
    draw all sprites in the right order onto the passed surface.
    -
    draw(surface, bgd=None, special_flags=0) -> Rect_list
    -
    -
    -

    Changed in pygame-ce 2.5.4: Added the bgd and special_flags arguments

    +
    draw(surface, bgsurf=None, special_flags=0) -> Rect_list
    @@ -966,7 +1023,7 @@ additional attributes through kwargs:

    and fullscreen mode, defaults to 1000./80 == 1000./fps
    -
    +

    New in pygame 1.8.

    @@ -974,14 +1031,13 @@ additional attributes through kwargs:

    draw()
    draw all sprites in the right order onto the passed surface.
    -
    draw(surface, bgd=None, special_flags=None) -> Rect_list
    +
    draw(surface, bgsurf=None, special_flags=None) -> Rect_list

    You can pass the background too. If a background is already set, then the -bgd argument has no effect. special_flags is passed to -Surface.blit().

    -
    -

    Changed in pygame-ce 2.5.4: Added the special_flags argument

    -
    +bgsurf argument has no effect. If present, the special_flags argument is +always passed to Surface.blit(), overriding DirtySprite.blendmode. +If special_flags is not present, DirtySprite.blendmode is passed +to the Surface.blit() instead.

    @@ -1039,7 +1095,7 @@ bgd argument has no effect. set_timing_treshold(time_ms) -> None

    DEPRECATED: Use set_timing_threshold() instead.

    -
    +

    Deprecated since pygame 2.1.1.

    @@ -1055,7 +1111,7 @@ bgd argument has no effect. -
    +

    New in pygame 2.1.1.

    @@ -1127,7 +1183,7 @@ which will be used to calculate the collision.

    function to calculate the collision. Intended to be passed as a collided callback function to the *collide functions. Sprites must have a "rect" attributes.

    -
    +

    New in pygame 1.8.

    @@ -1145,7 +1201,7 @@ scaled version of the sprites rects.

    collided callback function to the *collide functions.

    A ratio is a floating point number - 1.0 is the same size, 2.0 is twice as big, and 0.5 is half the size.

    -
    +

    New in pygame 1.8.1.

    @@ -1164,7 +1220,7 @@ enough to completely enclose the sprites rect as given by the "rect" attribute. Intended to be passed as a collided callback function to the *collide functions. Sprites must have a "rect" and an optional "radius" attribute.

    -
    +

    New in pygame 1.8.1.

    @@ -1190,7 +1246,7 @@ that is big enough to completely enclose the sprites rect as given by the "rect" attribute. Intended to be passed as a collided callback function to the *collide functions. Sprites must have a "rect" and an optional "radius" attribute.

    -
    +

    New in pygame 1.8.1.

    @@ -1204,9 +1260,9 @@ attribute.

    collide_mask(sprite1, sprite2) -> None

    Tests for collision between two sprites, by testing if their bitmasks -overlap (uses pygame.mask.Mask.overlap()Returns the point of intersection.). If the sprites have a +overlap (uses pygame.mask.Mask.overlap()Returns the point of intersection). If the sprites have a mask attribute, it is used as the mask, otherwise a mask is created from -the sprite's image (uses pygame.mask.from_surface()Creates a Mask from the given surface.). Sprites must +the sprite's image (uses pygame.mask.from_surface()Creates a Mask from the given surface). Sprites must have a rect attribute; the mask attribute is optional.

    The first point of collision between the masks is returned. The collision point is offset from sprite1's mask's topleft corner (which is always @@ -1239,7 +1295,7 @@ collision

    tuple(int, int) or NoneType

    -
    +

    New in pygame 1.8.0.

    @@ -1291,7 +1347,7 @@ which will be used to calculate the collision.




    -Edit on GitHub +Edit on GitHub
    @@ -1310,14 +1366,16 @@ which will be used to calculate the collision.

    next |
  • - previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surface.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surface.html index c4c6ed7..7d4703c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surface.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surface.html @@ -5,14 +5,12 @@ - pygame.Surface — pygame-ce v2.5.8 documentation - - - - - + pygame.Surface — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,311 +97,281 @@
    pygame.Surface
    -
    Pygame object for representing images.
    -
    Surface(size, flags=0, depth=0, masks=None) -> Surface
    -
    Surface(size, flags=0, surface=...) -> Surface
    +
    pygame object for representing images
    +
    Surface((width, height), flags=0, depth=0, masks=None) -> Surface
    +
    Surface((width, height), flags=0, Surface) -> Surface
    —returns an ordered list of sprites (first back, last top).returns a ordered list of sprites (first back, last top).
    - + - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - - - - - - - - - + - + - + - + - + - + - + - + - + - + - + - + - + - - + - - - - - - - - - - - - - - - - - - +
    —Draw another Surface onto this one.draw one image onto another
    —Draw many Surfaces onto this Surface at their corresponding location.draw many images onto another
    +
    —Draw many Surfaces onto this Surface at their corresponding location and with the same special_flags.change the pixel format of an image
    +
    —Change the pixel format of a Surface.change the pixel format of an image including per pixel alphas
    +
    —Change the pixel format of a Surface including per pixel alphas.create a new copy of a Surface
    +
    —Create a new copy of a Surface.fill Surface with a solid color
    +
    —Fill Surface with a solid color.Shift the surface image in place
    +
    —Shift the Surface pixels in place.Set the transparent colorkey
    +
    —Set the transparent colorkey.Get the current transparent colorkey
    +
    —Get the current transparent colorkey.set the alpha value for the full Surface image
    +
    —Set the alpha value for the full Surface.get the current Surface transparency value
    +
    —Get the current Surface transparency value.lock the Surface memory for pixel access
    +
    —Lock the Surface memory for pixel access.unlock the Surface memory from pixel access
    +
    —Unlock the Surface memory from pixel access.test if the Surface requires locking
    +
    —Test if the Surface requires locking.test if the Surface is current locked
    +
    —Test if the Surface is current locked.Gets the locks for the Surface
    +
    —Gets the locks for the Surface.get the color value at a single pixel
    +
    —Get the color value at a single pixel.set the color value for a single pixel
    +
    —Set the color value for a single pixel.get the mapped color value at a single pixel
    +
    —Get the mapped color value at a single pixel.get the color index palette for an 8-bit Surface
    +
    —Get the color index palette for an 8-bit Surface.get the color for a single entry in a palette
    +
    —Get the color for a single entry in a palette.set the color palette for an 8-bit Surface
    +
    —Set the color palette for an 8-bit Surface.set the color for a single index in an 8-bit Surface palette
    +
    —Set the color for a single index in an 8-bit Surface palette.convert a color into a mapped color value
    +
    —Convert a color into a mapped color value.convert a mapped integer color value into a Color
    +
    —Convert a mapped integer color value into a Color.set the current clipping area of the Surface
    +
    —Set the current clipping area of the Surface.get the current clipping area of the Surface
    +
    —Get the current clipping area of the Surface.create a new surface that references its parent
    +
    —Create a new Surface that references its parent.find the parent of a subsurface
    +
    —Find the parent of a subsurface.find the top level parent of a subsurface
    +
    —Find the top level parent of a subsurface.find the position of a child subsurface inside a parent
    +
    —Find the position of a child subsurface inside a parent.find the absolute position of a child subsurface inside its top level parent
    +
    —Find the absolute position of a child subsurface inside its top level parent.get the dimensions of the Surface
    +
    —Get the dimensions of the Surface.get the width of the Surface
    +
    —Get the width of the Surface.get the height of the Surface
    +
    —Get the height of the Surface.
    -—Get the rectangular area of the Surface.
    -—Get the rectangular area of the Surface.get the rectangular area of the Surface
    —Get the bit depth of the Surface pixel format.get the bit depth of the Surface pixel format
    —Get the bytes used per Surface pixel.get the bytes used per Surface pixel
    —Get the additional flags used for the Surface.get the additional flags used for the Surface
    —Get the number of bytes used per Surface row.get the number of bytes used per Surface row
    —The bitmasks needed to convert between a color and a mapped integer.the bitmasks needed to convert between a color and a mapped integer
    —Set the bitmasks needed to convert between a color and a mapped integer.set the bitmasks needed to convert between a color and a mapped integer
    —The bit shifts needed to convert between a color and a mapped integer.the bit shifts needed to convert between a color and a mapped integer
    —Sets the bit shifts needed to convert between a color and a mapped integer.sets the bit shifts needed to convert between a color and a mapped integer
    —The significant bits used to convert between a color and a mapped integer.the significant bits used to convert between a color and a mapped integer
    —Find the smallest rect containing data.find the smallest rect containing data
    —Return a buffer view of the Surface's pixels.return a buffer view of the Surface's pixels.
    —Acquires a buffer object for the pixels of the Surface.acquires a buffer object for the pixels of the Surface.
    +
    —Returns a copy of the Surface with the RGB channels pre-multiplied by the alpha channel.pixel buffer address
    +
    —Multiplies the RGB channels by the Surface alpha channel.
    -—Surface width in pixels (read-only).
    -—Surface height in pixels (read-only).
    -—Surface size in pixels (read-only).
    -—Pixel buffer address.returns a copy of the surface with the RGB channels pre-multiplied by the alpha channel.

    A pygame Surface is used to represent any image. The Surface has a fixed resolution and pixel format. Surfaces with 8-bit pixels use a color palette to map to 24-bit color.

    -

    Call pygame.Surface()Pygame object for representing images. to create a new image object. The Surface will +

    Call pygame.Surface()pygame object for representing images to create a new image object. The Surface will be cleared to all black. The only required arguments are the sizes. With no additional arguments, the Surface will be created in a format that best matches the display Surface.

    The pixel format can be controlled by passing the bit depth or an existing Surface. The flags argument is a bitmask of additional features for the -Surface. You can pass any combination of these flags:

    +surface. You can pass any combination of these flags:

    HWSURFACE    (obsolete in pygame 2) creates the image in video memory
     SRCALPHA     the pixel format will include a per-pixel alpha
     

    Both flags are only a request, and may not be possible for all displays and formats.

    -

    Advanced users can combine a set of bitmasks with a depth value. The masks +

    Advance users can combine a set of bitmasks with a depth value. The masks are a set of 4 integers representing which bits in a pixel will represent each color. Normal Surfaces should not require the masks argument.

    Surfaces can have many extra attributes like alpha planes, colorkeys, source @@ -420,31 +380,31 @@ to other Surfaces. The blit routines will attempt to use hardware acceleration when possible, otherwise they will use highly optimized software blitting methods.

    There are three types of transparency supported in pygame: colorkeys, -Surface alphas, and pixel alphas. Surface alphas can be mixed with +surface alphas, and pixel alphas. Surface alphas can be mixed with colorkeys, but an image with per pixel alphas cannot use the other modes. Colorkey transparency makes a single color value transparent. Any pixels -matching the colorkey will not be drawn. The Surface alpha value is a single -value that changes the transparency for the entire image. A Surface alpha of +matching the colorkey will not be drawn. The surface alpha value is a single +value that changes the transparency for the entire image. A surface alpha of 255 is opaque, and a value of 0 is completely transparent.

    Per pixel alphas are different because they store a transparency value for every pixel. This allows for the most precise transparency effects, but it -also the slowest. Per pixel alphas cannot be mixed with Surface alpha and +also the slowest. Per pixel alphas cannot be mixed with surface alpha and colorkeys.

    There is support for pixel access for the Surfaces. Pixel access on hardware -Surfaces is slow and not recommended. Pixels can be accessed using the +surfaces is slow and not recommended. Pixels can be accessed using the get_at() and set_at() functions. These methods are fine for simple access, but will be considerably slow when doing of pixel work with them. If you plan on doing a lot of pixel level work, it is recommended to use a pygame.PixelArraypygame object for direct pixel access of surfaces, which gives an array like view of the -Surface. For involved mathematical manipulations try the +surface. For involved mathematical manipulations try the pygame.surfarraypygame module for accessing surface pixel data using array interfaces module (It's quite quick, but requires NumPy.)

    -

    Any functions that directly access a Surface's pixel data will need that -Surface to be lock()'ed. These functions can lock() and -unlock() the Surfaces themselves without assistance. But, if a +

    Any functions that directly access a surface's pixel data will need that +surface to be lock()'ed. These functions can lock() and +unlock() the surfaces themselves without assistance. But, if a function will be called many times, there will be a lot of overhead for -multiple locking and unlocking of the Surface. It is best to lock the -Surface manually before making the function call many times, and then -unlocking when you are finished. All functions that need a locked Surface +multiple locking and unlocking of the surface. It is best to lock the +surface manually before making the function call many times, and then +unlocking when you are finished. All functions that need a locked surface will say so in their docs. Remember to leave the Surface locked only while necessary.

    Surface pixels are stored internally as a single number that has all the @@ -461,185 +421,87 @@ the smaller area.

    blit()
    -
    Draw another Surface onto this one.
    -
    blit(source, dest=(0, 0), area=None, special_flags=0) -> Rect
    +
    draw one image onto another
    +
    blit(source, dest, area=None, special_flags=0) -> Rect
    -

    Draws another Surface onto this Surface.

    -
    -
    Parameters
      -
    • -
      source

      The Surface object to draw onto this Surface. -If it has transparency, transparent pixels will be ignored when blitting to an 8-bit Surface.

      -
      -
      -
    • -
    • -
      dest (optional)

      The source draw position onto this Surface, defaults to (0, 0). -It can be a coordinate pair (x, y) or a Rect (using its top-left corner). -If a Rect is passed, its size will not affect the blit.

      -
      -
      -
    • -
    • -
      area (optional)

      The rectangular portion of the source to draw. -It can be a Rect object representing that section. If None or not provided, -the entire source Surface will be drawn. -If the Rect has negative position, the final blit position will be -dest - Rect.topleft.

      -
      -
      -
    • -
    • -
      special_flags (optional)

      Controls how the colors of the source are combined with this Surface. -If not provided it defaults to BLENDMODE_NONE (0). -See special flags for a list of possible values.

      -
      -
      -
    • -
    -
    -
    Return

    A pygame.Rectpygame object for storing rectangular coordinates object representing the affected area of this Surface that was modified -by the blit operation. This area includes only the pixels within this Surface or -its clipping area (see set_clip()). -Generally you don't need to use this return value, as it was initially designed to -pass it to pygame.display.update()Update all, or a portion, of the display. For non-OpenGL displays. to optimize the updating of the display. -Since modern computers are fast enough to update the entire display at high speeds, -this return value is rarely used nowadays.

    -
    -
    Example Use
    # create a Surface of size 50x50 and fill it with red color
    -red_surf = pygame.Surface((50, 50))
    -red_surf.fill("red")
    -
    -# draw the Surface on another Surface at position (0, 0)
    -another_surface.blit(red_surf, (0, 0))
    -
    +

    Draws a source Surface onto this Surface. The draw can be positioned with +the dest argument. The dest argument can either be a pair of coordinates representing the position of +the upper left corner of the blit or a Rect, where the upper left corner of the rectangle will be used as the +position for the blit. The size of the destination rectangle does not +effect the blit.

    +

    An optional area rectangle can be passed as well. This represents a +smaller portion of the source Surface to draw.

    +
    +

    New in pygame 1.8: Optional special_flags: BLEND_ADD, BLEND_SUB, +BLEND_MULT, BLEND_MIN, BLEND_MAX.

    -
    -
    Notes
      -
    • When self-blitting and there is a colorkey or alpha transparency set, resulting colors -may appear slightly different compared to a non-self blit.

    • -
    • The blit is ignored if the source is positioned completely outside this Surface's -clipping area. Otherwise only the overlapping area will be drawn.

    • -
    -
    -
    -
    -

    Changed in pygame-ce 2.5.1: The dest argument is optional and defaults to (0, 0)

    +
    +

    New in pygame 1.8.1: Optional special_flags: BLEND_RGBA_ADD, BLEND_RGBA_SUB, +BLEND_RGBA_MULT, BLEND_RGBA_MIN, BLEND_RGBA_MAX +BLEND_RGB_ADD, BLEND_RGB_SUB, BLEND_RGB_MULT, +BLEND_RGB_MIN, BLEND_RGB_MAX.

    +
    +

    New in pygame 1.9.2: Optional special_flags: BLEND_PREMULTIPLIED

    +
    +
    +

    New in pygame 2.0.0: Optional special_flags: BLEND_ALPHA_SDL2 - Uses the SDL2 blitter for alpha blending, +this gives different results than the default blitter, which is modelled after SDL1, due to +different approximations used for the alpha blending formula. The SDL2 blitter also supports +RLE on alpha blended surfaces which the pygame one does not.

    +
    +

    The return rectangle is the area of the affected pixels, excluding any +pixels outside the destination Surface, or outside the clipping area.

    +

    Pixel alphas will be ignored when blitting to an 8 bit Surface.

    +

    For a surface with colorkey or blanket alpha, a blit to self may give +slightly different colors than a non self-blit.

    blits()
    -
    Draw many Surfaces onto this Surface at their corresponding location.
    -
    blits(blit_sequence, doreturn=1) -> list[Rect] | None
    +
    draw many images onto another
    +
    blits(blit_sequence=((source, dest), ...), doreturn=1) -> [Rect, ...] or None
    +
    blits(((source, dest, area), ...)) -> [Rect, ...]
    +
    blits(((source, dest, area, special_flags), ...)) -> [Rect, ...]
    -

    The blits method efficiently draws a sequence of Surfaces onto this Surface.

    -

    Parameters

    -
    -
    -
    blit_sequence

    A sequence that contains each Surface to be drawn along with its associated blit -arguments. See the Sequence Item Formats section below for the possible formats.

    -
    -
    doreturn (optional)

    The doreturn parameter controls the return value. When set to True, it returns -a list of rectangles representing the changed areas. When set to False, returns -None.

    -
    -
    -
    -

    Return

    -
    -

    A list of rectangles or None.

    -
    -

    Sequence Item Formats

    -
    -
    -
    (source, dest)
      -
    • source: Surface object to be drawn.

    • -
    • dest: Position where the source Surface should be blitted.

    • -
    -
    -
    (source, dest, area)
      -
    • area: (optional) Specific area of the source Surface to be drawn.

    • -
    -
    -
    (source, dest, area, special_flags)
      -
    • special_flags: (optional) Controls the blending mode for drawing colors. -See special flags for a list of possible values.

    • -
    -
    -
    -
    -

    Notes

    -
    -
      -
    • blits is an advanced method. It is recommended to read the documentation -of blit() first.

    • -
    • To draw a Surface with a special flag, you must specify an area as well, e.g., -(source, dest, None, special_flags).

    • -
    • Prefer using blits() over blit() when drawing multiple Surfaces -for better performance. Use blit() if you need to draw a single Surface.

    • -
    • For drawing a sequence of (source, dest) pairs with whole source Surface -and a singular special_flag, use the fblits() method.

    • -
    -
    -
    -

    New in pygame 1.9.4.

    -
    -
    - -
    -
    -fblits()
    -
    -
    Draw many Surfaces onto this Surface at their corresponding location and with the same special_flags.
    -
    fblits(blit_sequence, special_flags=0, /) -> None
    -
    -

    This method takes a sequence of tuples (source, dest) as input, where source is a Surface -object and dest is its destination position on this Surface. It draws each source Surface -fully (meaning that unlike blit() you cannot pass an "area" parameter to represent -a smaller portion of the source Surface to draw) on this Surface with the same blending -mode specified by special_flags.

    +

    Draws many surfaces onto this Surface. It takes a sequence as input, +with each of the elements corresponding to the ones of blit(). +It needs at minimum a sequence of (source, dest).

    Parameters:
      -
    • blit_sequence -- a sequence of (source, dest)

    • -
    • special_flags -- the flag(s) representing the blend mode used for each Surface. -See special flags for a list of possible values.

    • +
    • blit_sequence -- a sequence of surfaces and arguments to blit them, +they correspond to the blit() arguments

    • +
    • doreturn -- if True, return a list of rects of the areas changed, +otherwise return None

    Returns:
    -

    None (unlike blit() and blits())

    +

    a list of rects of the areas changed if doreturn is +True, otherwise None

    +
    +
    Return type:
    +

    list or None

    -
    -

    Note

    -

    This method only accepts a sequence of (source, dest) pairs and a single -special_flags value that's applied to all Surfaces drawn. This allows faster -iteration over the sequence and better performance over blits(). Further -optimizations are applied if blit_sequence is a list or a tuple (using one -of them is recommended).

    -
    -
    -

    New in pygame-ce 2.1.4.

    -
    +

    New in pygame 1.9.4.

    convert()
    -
    Change the pixel format of a Surface.
    -
    convert(surface, /) -> Surface
    -
    convert(depth, flags=0, /) -> Surface
    -
    convert(masks, flags=0, /) -> Surface
    -
    convert() -> Surface
    +
    change the pixel format of an image
    +
    convert(Surface=None) -> Surface
    +
    convert(depth, flags=0) -> Surface
    +
    convert(masks, flags=0) -> Surface

    Creates a new copy of the Surface with the pixel format changed. The new pixel format can be determined from another existing Surface. Otherwise depth, flags, and masks arguments can be used, similar to the -pygame.Surface()Pygame object for representing images. call.

    +pygame.Surface()pygame object for representing images call.

    If no arguments are passed the new Surface will have the same pixel format as the display Surface. This is always the fastest format for blitting. It is a good idea to convert all Surfaces before they are @@ -647,122 +509,99 @@ blitted many times.

    The converted Surface will have no pixel alphas. They will be stripped if the original had them. See convert_alpha() for preserving or creating per-pixel alphas.

    -

    The new copy will have the same class as the copied Surface. This lets -a Surface subclass inherit this method without the need to override, +

    The new copy will have the same class as the copied surface. This lets +as Surface subclass inherit this method without the need to override, unless subclass specific instance attributes also need copying.

    -
    -

    Changed in pygame-ce 2.5.0: converting to a known format will succeed without -a window/display Surface.

    -
    convert_alpha()
    -
    Change the pixel format of a Surface including per pixel alphas.
    +
    change the pixel format of an image including per pixel alphas
    +
    convert_alpha(Surface) -> Surface
    convert_alpha() -> Surface
    -

    Creates a new copy of the Surface with the desired pixel format. The new -Surface will be in a format suited for quick blitting to the display Surface -with per pixel alpha.

    +

    Creates a new copy of the surface with the desired pixel format. The new +surface will be in a format suited for quick blitting to the given format +with per pixel alpha. If no surface is given, the new surface will be +optimized for blitting to the current display.

    Unlike the convert() method, the pixel format for the new -Surface will not be exactly the same as the display Surface, but it will -be optimized for fast alpha blitting to it.

    -

    As with convert() the returned Surface has the same class as -the converted Surface.

    -
    -

    Changed in pygame-ce 2.4.0: 'Surface' argument deprecated.

    -
    +image will not be exactly the same as the requested source, but it will +be optimized for fast alpha blitting to the destination.

    +

    As with convert() the returned surface has the same class as +the converted surface.

    copy()
    -
    Create a new copy of a Surface.
    +
    create a new copy of a Surface
    copy() -> Surface
    -

    Makes a duplicate copy of a Surface. The new Surface will have the same +

    Makes a duplicate copy of a Surface. The new surface will have the same pixel formats, color palettes, transparency settings, and class as the original. If a Surface subclass also needs to copy any instance specific -attributes then it should override copy(). Shallow copy and deepcopy -are supported, Surface implements __copy__ and __deepcopy__ respectively.

    -

    If the Surface is a subsurface, the returned Surface will not retain -the parent and will be a regular Surface with its own pixel data.

    -
    -

    New in pygame-ce 2.3.1: Added support for deepcopy by implementing __deepcopy__, calls copy() internally.

    -
    +attributes then it should override copy().

    fill()
    -
    Fill Surface with a solid color.
    +
    fill Surface with a solid color
    fill(color, rect=None, special_flags=0) -> Rect

    Fill the Surface with a solid color. If no rect argument is given the entire Surface will be filled. The rect argument will limit the fill to a specific area. The fill will also be contained by the Surface clip area.

    -

    The color argument should be compatible with pygame.typing.ColorLike. -If using RGBA, the Alpha (A part of RGBA) is ignored unless the Surface -uses per pixel alpha (Surface has the SRCALPHA flag).

    -

    The special_flags argument controls how the colors are combined. See special flags -for a list of possible values.

    -

    This will return the affected Surface area.

    -
    -

    Note

    -

    As of pygame-ce version 2.5.1, a long-standing bug has been fixed! -Now when passing in a Rect with negative x or negative y (or both), -the Rect filled will no longer be shifted to (0, 0), but instead only the -part of the Rect overlapping the window's Rect will be filled.

    +

    The color argument can be either a RGB sequence, a RGBA sequence +or a mapped color index. If using RGBA, the Alpha (A part of +RGBA) is ignored unless the surface uses per pixel alpha (Surface has +the SRCALPHA flag).

    +
    +

    New in pygame 1.8: Optional special_flags: BLEND_ADD, BLEND_SUB, +BLEND_MULT, BLEND_MIN, BLEND_MAX.

    +
    +

    New in pygame 1.8.1: Optional special_flags: BLEND_RGBA_ADD, BLEND_RGBA_SUB, +BLEND_RGBA_MULT, BLEND_RGBA_MIN, BLEND_RGBA_MAX +BLEND_RGB_ADD, BLEND_RGB_SUB, BLEND_RGB_MULT, +BLEND_RGB_MIN, BLEND_RGB_MAX.

    +
    +

    This will return the affected Surface area.

    scroll()
    -
    Shift the Surface pixels in place.
    -
    scroll(dx=0, dy=0, scroll_flag=0, /) -> None
    +
    Shift the surface image in place
    +
    scroll(dx=0, dy=0) -> None
    -

    Move the Surface by dx pixels right and dy pixels down. dx and dy may be -negative for left and up scrolls respectively.

    -

    Scrolling is contained by the Surface clip area. It is safe to have dx -and dy values that exceed the Surface size.

    -
    -
    The scroll flag can be:
      -
    • 0 (default): the pixels are shifted but previous pixels are -not modified.

    • -
    • pygame.SCROLL_ERASE: the space created by the shifting pixels -is filled with black or transparency.

    • -
    • pygame.SCROLL_REPEAT: the pixels that disappear out of the -Surface or clip bounds are brought back on the opposite side -resulting in an infinitely scrolling and repeating Surface.

    • -
    -
    -
    -
    +

    Move the image by dx pixels right and dy pixels down. dx and dy may be +negative for left and up scrolls respectively. Areas of the surface that +are not overwritten retain their original pixel values. Scrolling is +contained by the Surface clip area. It is safe to have dx and dy values +that exceed the surface size.

    +

    New in pygame 1.9.

    -
    -

    Changed in pygame-ce 2.5.3: Add repeating scroll and allow erasing pixels

    -
    set_colorkey()
    -
    Set the transparent colorkey.
    -
    set_colorkey(color, flags=0, /) -> None
    -
    set_colorkey(color, /) -> None
    +
    Set the transparent colorkey
    +
    set_colorkey(Color, flags=0) -> None
    +
    set_colorkey(None) -> None

    Set the current color key for the Surface. When blitting this Surface onto a destination, any pixels that have the same color as the colorkey -will be transparent. The color should be compatible with pygame.typing.ColorLike. -If None is passed, the colorkey will be unset.

    +will be transparent. The color can be an RGB color or a mapped color +integer. If None is passed, the colorkey will be unset.

    The colorkey will be ignored if the Surface is formatted to use per pixel alpha values. The colorkey can be mixed with the full Surface alpha value.

    @@ -775,8 +614,8 @@ will be slower to modify, but quicker to blit as a source.

    get_colorkey()
    -
    Get the current transparent colorkey.
    -
    get_colorkey() -> tuple[int, int, int, int] | None
    +
    Get the current transparent colorkey
    +
    get_colorkey() -> RGB or None

    Return the current colorkey value for the Surface. If the colorkey is not set then None is returned.

    @@ -786,42 +625,41 @@ set then None set_alpha()
    -
    Set the alpha value for the full Surface.
    -
    set_alpha(value, flags=0, /) -> None
    -
    set_alpha(value, /) -> None
    +
    set the alpha value for the full Surface image
    +
    set_alpha(value, flags=0) -> None
    +
    set_alpha(None) -> None

    Set the current alpha value for the Surface. When blitting this Surface onto a destination, the pixels will be drawn slightly transparent. The alpha value is an integer from 0 to 255, 0 is fully transparent and 255 is fully opaque. If None is passed for the alpha value, then alpha -blending will be disabled. This full alpha is compatible with other -kinds of transparency.

    +blending will be disabled, including per-pixel alpha.

    +

    This value is different than the per pixel Surface alpha. For a surface +with per pixel alpha, blanket alpha is ignored and None is returned.

    +
    +

    Changed in pygame 2.0: per-surface alpha can be combined with per-pixel +alpha.

    +

    The optional flags argument can be set to pygame.RLEACCEL to provide better performance on non accelerated displays. An RLEACCEL Surface will be slower to modify, but quicker to blit as a source.

    -
    -

    Changed in pygame 2.0: per-Surface alpha can be combined with per-pixel -alpha.

    -
    get_alpha()
    -
    Get the current Surface transparency value.
    -
    get_alpha() -> int | None
    +
    get the current Surface transparency value
    +
    get_alpha() -> int_value
    -

    Return the current alpha value for the Surface, which is an integer in the -range 0 (fully transparent) - 255 (fully opaque) set by set_alpha(). -Until an alpha is set this method will return None.

    +

    Return the current alpha value for the Surface.

    lock()
    -
    Lock the Surface memory for pixel access.
    +
    lock the Surface memory for pixel access
    lock() -> None

    Lock the pixel data of a Surface for access. On accelerated Surfaces, the @@ -838,7 +676,7 @@ locking and unlocking a Surface that does not need it.

    as needed. If a section of code is going to make calls that will repeatedly lock and unlock the Surface many times, it can be helpful to wrap the block inside a lock and unlock pair.

    -

    It is safe to nest locking and unlocking calls. The Surface will only be +

    It is safe to nest locking and unlocking calls. The surface will only be unlocked after the final lock is released.

    @@ -846,7 +684,7 @@ unlocked after the final lock is released.

    unlock()
    -
    Unlock the Surface memory from pixel access.
    +
    unlock the Surface memory from pixel access
    unlock() -> None

    Unlock the Surface pixel data after it has been locked. The unlocked @@ -856,7 +694,7 @@ Surface can once again be drawn and managed by pygame. See the as needed. If a section of code is going to make calls that will repeatedly lock and unlock the Surface many times, it can be helpful to wrap the block inside a lock and unlock pair.

    -

    It is safe to nest locking and unlocking calls. The Surface will only be +

    It is safe to nest locking and unlocking calls. The surface will only be unlocked after the final lock is released.

    @@ -864,7 +702,7 @@ unlocked after the final lock is released.

    mustlock()
    -
    Test if the Surface requires locking.
    +
    test if the Surface requires locking
    mustlock() -> bool

    Returns True if the Surface is required to be locked to access pixel @@ -881,7 +719,7 @@ wrap the block inside a lock and unlock pair.

    get_locked()
    -
    Test if the Surface is current locked.
    +
    test if the Surface is current locked
    get_locked() -> bool

    Returns True when the Surface is locked. It doesn't matter how many @@ -892,8 +730,8 @@ times the Surface is locked.

    get_locks()
    -
    Gets the locks for the Surface.
    -
    get_locks() -> tuple[Any, ...]
    +
    Gets the locks for the Surface
    +
    get_locks() -> tuple

    Returns the currently existing locks for the Surface.

    @@ -902,8 +740,8 @@ times the Surface is locked.

    get_at()
    -
    Get the color value at a single pixel.
    -
    get_at(x_y, /) -> Color
    +
    get the color value at a single pixel
    +
    get_at((x, y)) -> Color

    Return a copy of the RGBA Color value at the given pixel. If the Surface has no per pixel alpha, then the alpha value will always be 255 @@ -914,12 +752,8 @@ in a game or realtime situation. It is better to use methods which operate on many pixels at a time like with the blit, fill and draw methods - or by using pygame.surfarraypygame module for accessing surface pixel data using array interfaces/pygame.PixelArraypygame object for direct pixel access of surfaces.

    This function will temporarily lock and unlock the Surface as needed.

    -
    -

    Changed in pygame-ce 2.3.1: can now also accept both float coordinates and -Vector2s for pixels.

    -
    -
    -

    Changed in pygame 1.9: Returning a Color instead of tuple. Use tuple(surf.get_at((x,y))) +

    +

    New in pygame 1.9: Returning a Color instead of tuple. Use tuple(surf.get_at((x,y))) if you want a tuple, and not a Color. This should only matter if you want to use the color as a key in a dict.

    @@ -929,33 +763,29 @@ you want to use the color as a key in a dict.

    set_at()
    -
    Set the color value for a single pixel.
    -
    set_at(x_y, color, /) -> None
    +
    set the color value for a single pixel
    +
    set_at((x, y), Color) -> None
    -

    Set the color of a single pixel at the specified coordinates to be a -pygame.typing.ColorLike value. If the Surface does not have per pixel alphas, -the alpha value is ignored. Setting pixels outside the Surface area or outside -the Surface clipping will have no effect.

    +

    Set the RGBA or mapped integer color value for a single pixel. If the +Surface does not have per pixel alphas, the alpha value is ignored. +Setting pixels outside the Surface area or outside the Surface clipping +will have no effect.

    Getting and setting pixels one at a time is generally too slow to be used in a game or realtime situation.

    This function will temporarily lock and unlock the Surface as needed.

    Note

    -

    If the Surface is palettized, the pixel color will be set to the +

    If the surface is palettized, the pixel color will be set to the most similar color in the palette.

    -
    -

    Changed in pygame-ce 2.3.1: can now also accept both float coordinates and -Vector2s for pixels.

    -
    get_at_mapped()
    -
    Get the mapped color value at a single pixel.
    -
    get_at_mapped(x_y, /) -> int
    +
    get the mapped color value at a single pixel
    +
    get_at_mapped((x, y)) -> Color

    Return the integer value of the given pixel. If the pixel position is outside the area of the Surface an IndexError exception will be @@ -963,27 +793,23 @@ raised.

    This method is intended for pygame unit testing. It unlikely has any use in an application.

    This function will temporarily lock and unlock the Surface as needed.

    -
    +

    New in pygame 1.9.2.

    -
    -

    Changed in pygame-ce 2.3.1: can now also accept both float coordinates and -Vector2s for pixels.

    -
    get_palette()
    -
    Get the color index palette for an 8-bit Surface.
    -
    get_palette() -> list[Color]
    +
    get the color index palette for an 8-bit Surface
    +
    get_palette() -> [RGB, RGB, RGB, ...]

    Return a list of up to 256 color elements that represent the indexed colors used in an 8-bit Surface. The returned list is a copy of the palette, and changes will have no effect on the Surface.

    Returning a list of Color(with length 3) instances instead of tuples.

    -
    +

    New in pygame 1.9.

    @@ -992,12 +818,12 @@ palette, and changes will have no effect on the Surface.

    get_palette_at()
    -
    Get the color for a single entry in a palette.
    -
    get_palette_at(index, /) -> Color
    +
    get the color for a single entry in a palette
    +
    get_palette_at(index) -> RGB

    Returns the red, green, and blue color values for a single index in a Surface palette. The index should be a value from 0 to 255.

    -
    +

    New in pygame 1.9: Returning Color(with length 3) instance instead of a tuple.

    @@ -1006,8 +832,8 @@ Surface palette. The index should be a value from 0 to 255.

    set_palette()
    -
    Set the color palette for an 8-bit Surface.
    -
    set_palette(palette, /) -> None
    +
    set the color palette for an 8-bit Surface
    +
    set_palette([RGB, RGB, RGB, ...]) -> None

    Set the full palette for an 8-bit Surface. This will replace the colors in the existing palette. A partial palette can be passed and only the first @@ -1019,8 +845,8 @@ colors in the original palette will be changed.

    set_palette_at()
    -
    Set the color for a single index in an 8-bit Surface palette.
    -
    set_palette_at(index, color, /) -> None
    +
    set the color for a single index in an 8-bit Surface palette
    +
    set_palette_at(index, RGB) -> None

    Set the palette value for a single entry in a Surface palette. The index should be a value from 0 to 255.

    @@ -1031,13 +857,13 @@ should be a value from 0 to 255.

    map_rgb()
    -
    Convert a color into a mapped color value.
    -
    map_rgb(color, /) -> int
    +
    convert a color into a mapped color value
    +
    map_rgb(Color) -> mapped_int
    -

    Convert a pygame.typing.ColorLike into the mapped integer value -for this Surface. The returned integer will contain no more bits than the -bit depth of the Surface. Mapped color values are not often used inside pygame, -but can be passed to most functions that require a Surface and a color.

    +

    Convert an RGBA color into the mapped integer value for this Surface. +The returned integer will contain no more bits than the bit depth of the +Surface. Mapped color values are not often used inside pygame, but can be +passed to most functions that require a Surface and a color.

    See the Surface object documentation for more information about colors and pixel formats.

    @@ -1046,8 +872,8 @@ and pixel formats.

    unmap_rgb()
    -
    Convert a mapped integer color value into a Color.
    -
    unmap_rgb(mapped_int, /) -> Color
    +
    convert a mapped integer color value into a Color
    +
    unmap_rgb(mapped_int) -> Color

    Convert an mapped integer color into the RGB color components for this Surface. Mapped color values are not often used inside pygame, but @@ -1060,8 +886,9 @@ and pixel formats.

    set_clip()
    -
    Set the current clipping area of the Surface.
    -
    set_clip(rect, /) -> None
    +
    set the current clipping area of the Surface
    +
    set_clip(rect) -> None
    +
    set_clip(None) -> None

    Each Surface has an active clipping area. This is a rectangle that represents the only pixels on the Surface that can be modified. If @@ -1076,12 +903,12 @@ Surface.

    get_clip()
    -
    Get the current clipping area of the Surface.
    +
    get the current clipping area of the Surface
    get_clip() -> Rect

    Return a rectangle of the current clipping area. The Surface will always return a valid rectangle that will never be outside the bounds of the -Surface. If the Surface has had None set for the clipping area, the +image. If the Surface has had None set for the clipping area, the Surface will return a rectangle with the full area of the Surface.

    @@ -1089,10 +916,8 @@ Surface will return a rectangle with the full area of the Surface.

    subsurface()
    -
    Create a new Surface that references its parent.
    -
    subsurface(rect, /) -> Surface
    -
    subsurface(left_top, width_height, /) -> Surface
    -
    subsurface(left, top, width, height, /) -> Surface
    +
    create a new surface that references its parent
    +
    subsurface(Rect) -> Surface

    Returns a new Surface that shares its pixels with its new parent. The new Surface is considered a child of the original. Modifications to either @@ -1105,14 +930,14 @@ the parent. It is also possible to subsurface the display Surface if the display mode is not hardware accelerated.

    See get_offset() and get_parent() to learn more about the state of a subsurface.

    -

    A subsurface will have the same class as the parent Surface.

    +

    A subsurface will have the same class as the parent surface.

    get_parent()
    -
    Find the parent of a subsurface.
    +
    find the parent of a subsurface
    get_parent() -> Surface

    Returns the parent Surface of a subsurface. If this is not a subsurface @@ -1123,19 +948,19 @@ then None get_abs_parent()

    -
    Find the top level parent of a subsurface.
    +
    find the top level parent of a subsurface
    get_abs_parent() -> Surface
    -

    Returns the top level parent Surface of a subsurface. If this is not -a subsurface then this Surface will be returned.

    +

    Returns the parent Surface of a subsurface. If this is not a subsurface +then this surface will be returned.

    get_offset()
    -
    Find the position of a child subsurface inside a parent.
    -
    get_offset() -> tuple[int, int]
    +
    find the position of a child subsurface inside a parent
    +
    get_offset() -> (x, y)

    Get the offset position of a child subsurface inside of a parent. If the Surface is not a subsurface this will return (0, 0).

    @@ -1145,8 +970,8 @@ Surface is not a subsurface this will return (0, 0).

    get_abs_offset()
    -
    Find the absolute position of a child subsurface inside its top level parent.
    -
    get_abs_offset() -> tuple[int, int]
    +
    find the absolute position of a child subsurface inside its top level parent
    +
    get_abs_offset() -> (x, y)

    Get the offset position of a child subsurface inside of its top level parent Surface. If the Surface is not a subsurface this will return (0, @@ -1157,73 +982,52 @@ parent Surface. If the Surface is not a subsurface this will return (0,

    get_size()
    -
    Get the dimensions of the Surface.
    -
    get_size() -> tuple[int, int]
    +
    get the dimensions of the Surface
    +
    get_size() -> (width, height)
    -

    Return the width and height of the Surface in pixels. Can also be accessed -with size

    +

    Return the width and height of the Surface in pixels.

    get_width()
    -
    Get the width of the Surface.
    -
    get_width() -> int
    +
    get the width of the Surface
    +
    get_width() -> width
    -

    Return the width of the Surface in pixels. Can also be accessed with width

    +

    Return the width of the Surface in pixels.

    get_height()
    -
    Get the height of the Surface.
    -
    get_height() -> int
    +
    get the height of the Surface
    +
    get_height() -> height
    -

    Return the height of the Surface in pixels. Can also be accessed with height

    +

    Return the height of the Surface in pixels.

    get_rect()
    -
    Get the rectangular area of the Surface.
    +
    get the rectangular area of the Surface
    get_rect(**kwargs) -> Rect
    -

    Returns a new rectangle covering the entire Surface. This rectangle will -always start at (0, 0) with a width and height the same size as the Surface.

    +

    Returns a new rectangle covering the entire surface. This rectangle will +always start at (0, 0) with a width and height the same size as the image.

    You can pass keyword argument values to this function. These named values will be applied to the attributes of the Rect before it is returned. An example would be mysurf.get_rect(center=(100, 100)) to create a -rectangle for the Surface centered at a given position. Size attributes -such as size or w can also be applied to resize the Rect.

    -
    - -
    -
    -get_frect()
    -
    -
    Get the rectangular area of the Surface.
    -
    get_frect(**kwargs) -> FRect
    -
    -

    This is the same as Surface.get_rect() but returns an FRect. FRect is similar -to Rect, except it stores float values instead.

    -

    You can pass keyword argument values to this function. These named values -will be applied to the attributes of the FRect before it is returned. An -example would be mysurf.get_frect(center=(100.5, 100.5)) to create a -rectangle for the Surface centered at a given position. Size attributes -such as size or w can also be applied to resize the FRect.

    -
    -

    New in pygame-ce 2.3.0.

    -
    +rectangle for the Surface centered at a given position.

    get_bitsize()
    -
    Get the bit depth of the Surface pixel format.
    +
    get the bit depth of the Surface pixel format
    get_bitsize() -> int

    Returns the number of bits used to represent each pixel. This value may @@ -1235,7 +1039,7 @@ Surface still requires a full 2 bytes.

    get_bytesize()
    -
    Get the bytes used per Surface pixel.
    +
    get the bytes used per Surface pixel
    get_bytesize() -> int

    Return the number of bytes used per pixel.

    @@ -1245,7 +1049,7 @@ Surface still requires a full 2 bytes.

    get_flags()
    -
    Get the additional flags used for the Surface.
    +
    get the additional flags used for the Surface
    get_flags() -> int

    Returns a set of current Surface features. Each feature is a bit in the @@ -1258,8 +1062,8 @@ flags bitmask. Typical flags are ASYNCBLIT 0x00000004 # (obsolete in pygame 2) Use asynchronous blits if possible

    -

    See pygame.display.set_mode()Initialize a window or screen for display. for flags exclusive to the -display Surface.

    +

    See pygame.display.set_mode()Initialize a window or screen for display for flags exclusive to the +display surface.

    Used internally (read-only)

    HWACCEL        0x00000100    # Blit uses hardware acceleration
     SRCCOLORKEY    0x00001000    # Blit uses a source color key
    @@ -1275,7 +1079,7 @@ display Surface.

    get_pitch()
    -
    Get the number of bytes used per Surface row.
    +
    get the number of bytes used per Surface row
    get_pitch() -> int

    Return the number of bytes separating each row in the Surface. Surfaces @@ -1288,8 +1092,8 @@ have a larger pitch than their real width.

    get_masks()
    -
    The bitmasks needed to convert between a color and a mapped integer.
    -
    get_masks() -> tuple[int, int, int, int]
    +
    the bitmasks needed to convert between a color and a mapped integer
    +
    get_masks() -> (R, G, B, A)

    Returns the bitmasks used to isolate each color in a mapped integer.

    This value is not needed for normal pygame usage.

    @@ -1299,8 +1103,8 @@ have a larger pitch than their real width.

    set_masks()
    -
    Set the bitmasks needed to convert between a color and a mapped integer.
    -
    set_masks(color, /) -> None
    +
    set the bitmasks needed to convert between a color and a mapped integer
    +
    set_masks((r,g,b,a)) -> None

    This is not needed for normal pygame usage.

    @@ -1308,10 +1112,10 @@ have a larger pitch than their real width.

    Starting in pygame 2.0, the masks are read-only and accordingly this method will raise a TypeError if called.

    -
    +

    Deprecated since pygame 2.0.0.

    -
    +

    New in pygame 1.8.1.

    @@ -1320,8 +1124,8 @@ accordingly this method will raise a TypeError if called.

    get_shifts()
    -
    The bit shifts needed to convert between a color and a mapped integer.
    -
    get_shifts() -> tuple[int, int, int, int]
    +
    the bit shifts needed to convert between a color and a mapped integer
    +
    get_shifts() -> (R, G, B, A)

    Returns the pixel shifts need to convert between each color and a mapped integer.

    @@ -1332,8 +1136,8 @@ integer.

    set_shifts()
    -
    Sets the bit shifts needed to convert between a color and a mapped integer.
    -
    set_shifts(color, /) -> None
    +
    sets the bit shifts needed to convert between a color and a mapped integer
    +
    set_shifts((r,g,b,a)) -> None

    This is not needed for normal pygame usage.

    @@ -1341,10 +1145,10 @@ integer.

    Starting in pygame 2.0, the shifts are read-only and accordingly this method will raise a TypeError if called.

    -
    +

    Deprecated since pygame 2.0.0.

    -
    +

    New in pygame 1.8.1.

    @@ -1353,8 +1157,8 @@ accordingly this method will raise a TypeError if called.

    get_losses()
    -
    The significant bits used to convert between a color and a mapped integer.
    -
    get_losses() -> tuple[int, int, int, int]
    +
    the significant bits used to convert between a color and a mapped integer
    +
    get_losses() -> (R, G, B, A)

    Return the least significant number of bits stripped from each color in a mapped integer.

    @@ -1365,14 +1169,14 @@ mapped integer.

    get_bounding_rect()
    -
    Find the smallest rect containing data.
    -
    get_bounding_rect(min_alpha=1) -> Rect
    +
    find the smallest rect containing data
    +
    get_bounding_rect(min_alpha = 1) -> Rect

    Returns the smallest rectangular region that contains all the pixels in -the Surface that have an alpha value greater than or equal to the minimum +the surface that have an alpha value greater than or equal to the minimum alpha value.

    This function will temporarily lock and unlock the Surface as needed.

    -
    +

    New in pygame 1.8.

    @@ -1381,41 +1185,41 @@ alpha value.

    get_view()
    -
    Return a buffer view of the Surface's pixels.
    -
    get_view(kind='2', /) -> BufferProxy
    +
    return a buffer view of the Surface's pixels.
    +
    get_view(<kind>='2') -> BufferProxy
    -

    Return an object which exports a Surface's internal pixel buffer as +

    Return an object which exports a surface's internal pixel buffer as a C level array struct, Python level array interface or a C level buffer interface. The new buffer protocol is supported.

    The kind argument is the length 1 string '0', '1', '2', '3', 'r', 'g', 'b', or 'a'. The letters are case insensitive; 'A' will work as well. The argument can be either a Unicode or byte (char) string. The default is '2'.

    -

    '0' returns a contiguous unstructured bytes view. No Surface shape -information is given. A ValueError is raised if the Surface's pixels +

    '0' returns a contiguous unstructured bytes view. No surface shape +information is given. A ValueError is raised if the surface's pixels are discontinuous.

    -

    '1' returns a (Surface.width * Surface.height) array of continuous -pixels. A ValueError is raised if the Surface pixels are +

    '1' returns a (surface-width * surface-height) array of continuous +pixels. A ValueError is raised if the surface pixels are discontinuous.

    -

    '2' returns a (Surface.width, Surface.height) array of raw pixels. -The pixels are Surface-bytesize-d unsigned integers. The pixel format is -Surface specific. The 3 byte unsigned integers of 24 bit Surfaces are +

    '2' returns a (surface-width, surface-height) array of raw pixels. +The pixels are surface-bytesize-d unsigned integers. The pixel format is +surface specific. The 3 byte unsigned integers of 24 bit surfaces are unlikely accepted by anything other than other pygame functions.

    -

    '3' returns a (Surface.width, Surface.height, 3) array of RGB color +

    '3' returns a (surface-width, surface-height, 3) array of RGB color components. Each of the red, green, and blue components are unsigned -bytes. Only 24-bit and 32-bit Surfaces are supported. The color +bytes. Only 24-bit and 32-bit surfaces are supported. The color components must be in either RGB or BGR order within the pixel.

    'r' for red, 'g' for green, 'b' for blue, and 'a' for alpha return a -(Surface.width, Surface.height) view of a single color component within a -Surface: a color plane. Color components are unsigned bytes. Both 24-bit -and 32-bit Surfaces support 'r', 'g', and 'b'. Only 32-bit Surfaces with +(surface-width, surface-height) view of a single color component within a +surface: a color plane. Color components are unsigned bytes. Both 24-bit +and 32-bit surfaces support 'r', 'g', and 'b'. Only 32-bit surfaces with SRCALPHA support 'a'.

    -

    The Surface is locked only when an exposed interface is accessed. -For new buffer interface accesses, the Surface is unlocked once the +

    The surface is locked only when an exposed interface is accessed. +For new buffer interface accesses, the surface is unlocked once the last buffer view is released. For array interface and old buffer -interface accesses, the Surface remains locked until the BufferProxy +interface accesses, the surface remains locked until the BufferProxy object is released.

    -
    +

    New in pygame 1.9.2.

    @@ -1424,7 +1228,7 @@ object is released.

    get_buffer()
    -
    Acquires a buffer object for the pixels of the Surface.
    +
    acquires a buffer object for the pixels of the Surface.
    get_buffer() -> BufferProxy

    Return a buffer object for the pixels of the Surface. The buffer can be @@ -1434,120 +1238,56 @@ and length in bytes. The data need not be contiguous. Any gaps are included in the length, but otherwise ignored.

    This method implicitly locks the Surface. The lock will be released when the returned pygame.BufferProxypygame object to export a surface buffer through an array protocol object is garbage collected.

    -
    +

    New in pygame 1.8.

    +
    +
    +_pixels_address
    +
    +
    pixel buffer address
    +
    _pixels_address -> int
    +
    +

    The starting address of the surface's raw pixel bytes.

    +
    +

    New in pygame 1.9.2.

    +
    +
    +
    premul_alpha()
    -
    Returns a copy of the Surface with the RGB channels pre-multiplied by the alpha channel.
    +
    returns a copy of the surface with the RGB channels pre-multiplied by the alpha channel.
    premul_alpha() -> Surface
    -

    Returns a copy of the initial Surface with the red, green and blue color -channels multiplied by the alpha channel. This is intended to make it -easier to work with the BLEND_PREMULTIPLED blend mode flag of the blit() -method. Surfaces which have called this method will only look correct -after blitting if the BLEND_PREMULTIPLED special flag is used.

    -

    It is worth noting that after calling this method, methods that return the -color of a pixel such as get_at() will return the alpha multiplied color -values. It is not possible to fully reverse an alpha multiplication of -the colors in a Surface as integer color channel data is generally -reduced by the operation (e.g. 255 x 0 = 0, from there it is not -possible to reconstruct the original 255 from just the two remaining -zeros in the color and alpha channels).

    -

    If you call this method, and then call it again, it will multiply the color -channels by the alpha channel twice. There are many possible ways to obtain -a Surface with the color channels pre-multiplied by the alpha channel in -pygame, and it is not possible to tell the difference just from the -information in the pixels. It is completely possible to have two identical -Surfaces - one intended for pre-multiplied alpha blending and one intended -for normal blending. For this reason we do not store state on Surfaces -intended for pre-multiplied alpha blending.

    -

    Surfaces without an alpha channel cannot use this method and will return -an error if you use it on them. It is best used on 32 bit Surfaces (the -default on most platforms) as the blitting on these Surfaces can be -accelerated by SIMD versions of the pre-multiplied blitter.

    -

    In general pre-multiplied alpha blitting is faster then 'straight alpha' -blitting and produces superior results when blitting an alpha Surface onto -another Surface with alpha - assuming both Surfaces contain pre-multiplied -alpha colors.

    -

    There is a tutorial on premultiplied alpha blending here.

    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave premul_alpha feedback with authors

    +

    Returns a copy of the initial surface with the red, green and blue color channels multiplied +by the alpha channel. This is intended to make it easier to work with the BLEND_PREMULTIPLED +blend mode flag of the blit() method. Surfaces which have called this method will only look +correct after blitting if the BLEND_PREMULTIPLED special flag is used.

    +

    It is worth noting that after calling this method, methods that return the colour of a pixel +such as get_at() will return the alpha multiplied colour values. It is not possible to fully +reverse an alpha multiplication of the colours in a surface as integer colour channel data +is generally reduced by the operation (e.g. 255 x 0 = 0, from there it is not possible to reconstruct +the original 255 from just the two remaining zeros in the colour and alpha channels).

    +

    If you call this method, and then call it again, it will multiply the colour channels by the alpha channel +twice. There are many possible ways to obtain a surface with the colour channels pre-multiplied by the +alpha channel in pygame, and it is not possible to tell the difference just from the information in the pixels. +It is completely possible to have two identical surfaces - one intended for pre-multiplied alpha blending and +one intended for normal blending. For this reason we do not store state on surfaces intended for pre-multiplied +alpha blending.

    +

    Surfaces without an alpha channel cannot use this method and will return an error if you use +it on them. It is best used on 32 bit surfaces (the default on most platforms) as the blitting +on these surfaces can be accelerated by SIMD versions of the pre-multiplied blitter.

    +

    In general pre-multiplied alpha blitting is faster then 'straight alpha' blitting and produces +superior results when blitting an alpha surface onto another surface with alpha - assuming both +surfaces contain pre-multiplied alpha colours.

    -

    New in pygame-ce 2.1.4.

    -
    -
    - -
    -
    -premul_alpha_ip()
    -
    -
    Multiplies the RGB channels by the Surface alpha channel.
    -
    premul_alpha_ip() -> Surface
    -
    -

    Multiplies the RGB channels of the Surface by the alpha channel in place -and returns the Surface.

    -

    Surfaces without an alpha channel cannot use this method and will return -an error if you use it on them. It is best used on 32 bit Surfaces (the -default on most platforms) as the blitting on these Surfaces can be -accelerated by SIMD versions of the pre-multiplied blitter.

    -

    Refer to the premul_alpha() method for more information.

    -
    -

    New in pygame-ce 2.5.1.

    -
    -
    - -
    -
    -property width: int
    -
    -
    Surface width in pixels (read-only).
    -
    width -> int
    -
    -

    Read-only attribute. Same as get_width()

    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -property height: int
    -
    -
    Surface height in pixels (read-only).
    -
    height -> int
    -
    -

    Read-only attribute. Same as get_height()

    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -property size: tuple[int, int]
    -
    -
    Surface size in pixels (read-only).
    -
    size -> tuple[int, int]
    -
    -

    Read-only attribute. Same as get_size()

    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -property _pixels_address: int
    -
    -
    Pixel buffer address.
    -
    _pixels_address -> int
    -
    -

    The starting address of the surface's raw pixel bytes.

    -
    -

    New in pygame 1.9.2.

    +

    New in pygame 2.2.0.

    @@ -1558,7 +1298,7 @@ accelerated by SIMD versions of the pre-multiplied blitter.




    -Edit on GitHub +Edit on GitHub
    @@ -1579,12 +1319,14 @@ accelerated by SIMD versions of the pre-multiplied blitter.

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surfarray.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surfarray.html index a9c664d..cd09c1b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surfarray.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/surfarray.html @@ -5,18 +5,16 @@ - pygame.surfarray — pygame-ce v2.5.8 documentation - - - - - + pygame.surfarray — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
    @@ -221,18 +211,15 @@ This module can also separate the red, green, and blue color values into separate indices. These types of arrays are referred to as 3D arrays, and the last index is 0 for red, 1 for green, and 2 for blue.

    The pixels of a 2D array as returned by array2d() and pixels2d() -are mapped to the specific surface. Use pygame.Surface.unmap_rgb()Convert a mapped integer color value into a Color. -to convert to a color, and pygame.Surface.map_rgb()Convert a color into a mapped color value. to get the surface +are mapped to the specific surface. Use pygame.Surface.unmap_rgb()convert a mapped integer color value into a Color +to convert to a color, and pygame.Surface.map_rgb()convert a color into a mapped color value to get the surface specific pixel value of a color. Integer pixel values can only be used directly -between surfaces with matching pixel layouts (see pygame.SurfacePygame object for representing images.).

    +between surfaces with matching pixel layouts (see pygame.Surfacepygame object for representing images).

    All functions that refer to "array" will copy the surface information to a new -NumPy array. All functions that refer to "pixels" will directly reference the +numpy array. All functions that refer to "pixels" will directly reference the pixels from the surface and any changes performed to the array will make changes in the surface. As this last functions share memory with the surface, this one will be locked during the lifetime of the array.

    -
    -

    Changed in pygame-ce 2.5.6: surfarray module is lazily loaded to avoid an expensive NumPy import when unnecessary

    -
    pygame.surfarray.array2d()
    @@ -245,7 +232,7 @@ into a 2D array. The bit depth of the surface will control the size of the integer values, and will work for any type of pixel format.

    This function will temporarily lock the Surface as pixels are copied -(see the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +(see the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method).

    @@ -263,7 +250,7 @@ This is a fast operation since no data is copied.

    depths can.

    The Surface this references will remain locked for the lifetime of the array, since the array generated by this function shares memory with the surface. -See the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +See the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method.

    @@ -278,7 +265,7 @@ access method.

    will control the size of the integer values, and will work for any type of pixel format.

    This function will temporarily lock the Surface as pixels are copied (see -the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method).

    @@ -296,7 +283,7 @@ This is a fast operation since no data is copied.

    pixel formats cannot be referenced.

    The Surface this references will remain locked for the lifetime of the array, since the array generated by this function shares memory with the surface. -See the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +See the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method.

    @@ -311,7 +298,7 @@ access method.

    2D array. This will work for any type of Surface format. Surfaces without a pixel alpha will return an array with all opaque values.

    This function will temporarily lock the Surface as pixels are copied (see -the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method).

    @@ -328,7 +315,7 @@ in the Surface. This is a fast operation since no data is copied.

    This can only work on 32-bit Surfaces with a per-pixel alpha value.

    The Surface this references will remain locked for the lifetime of the array, since the array generated by this function shares memory with the surface. -See the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +See the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method.

    @@ -342,9 +329,9 @@ access method.

    Copy the pixel red values from a Surface into a 2D array. This will work for any type of Surface format.

    This function will temporarily lock the Surface as pixels are copied (see -the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method).

    -
    +

    New in pygame 2.0.2.

    @@ -362,7 +349,7 @@ fast operation since no data is copied.

    This can only work on 24-bit or 32-bit Surfaces.

    The Surface this references will remain locked for the lifetime of the array, since the array generated by this function shares memory with the surface. -See the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +See the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method.

    @@ -376,9 +363,9 @@ access method.

    Copy the pixel green values from a Surface into a 2D array. This will work for any type of Surface format.

    This function will temporarily lock the Surface as pixels are copied (see -the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method).

    -
    +

    New in pygame 2.0.2.

    @@ -396,7 +383,7 @@ This is a fast operation since no data is copied.

    This can only work on 24-bit or 32-bit Surfaces.

    The Surface this references will remain locked for the lifetime of the array, since the array generated by this function shares memory with the surface. -See the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +See the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method.

    @@ -410,9 +397,9 @@ access method.

    Copy the pixel blue values from a Surface into a 2D array. This will work for any type of Surface format.

    This function will temporarily lock the Surface as pixels are copied (see -the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method).

    -
    +

    New in pygame 2.0.2.

    @@ -430,7 +417,7 @@ fast operation since no data is copied.

    This can only work on 24-bit or 32-bit Surfaces.

    The Surface this references will remain locked for the lifetime of the array, since the array generated by this function shares memory with the surface. -See the pygame.Surface.lock()Lock the Surface memory for pixel access. - lock the Surface memory for pixel +See the pygame.Surface.lock()lock the Surface memory for pixel access - lock the Surface memory for pixel access method.

    @@ -459,10 +446,7 @@ solid opaque array will be returned.

    Create a new Surface that best resembles the data and format on the array. The array can be 2D or 3D with any sized integer values. Function make_surface uses the array struct interface to acquire array properties, -so is not limited to just NumPy arrays. See pygame.pixelcopyPygame module for general pixel array copying..

    -

    float32, float64 and (where available) float96 NumPy arrays -are also accepted, but are first rounded to the nearest integer and -copied into a new array before creating the surface.

    +so is not limited to just NumPy arrays. See pygame.pixelcopypygame module for general pixel array copying.

    New in pygame 1.9.2: array struct interface support.

    @@ -475,13 +459,8 @@ copied into a new array before creating the surface.

    Directly copy values from an array into a Surface. This is faster than converting the array into a Surface and blitting. The array must be the same -dimensions as the Surface and will completely replace all pixel values. -Accepted array types are integer, ASCII character and record arrays, as -well as float32, float64 and (where available) float96 NumPy -arrays.

    -

    Float arrays are first rounded to the nearest integer and copied into -a new array before blitting. This is significantly slower (on the order of 2x) -versus passing an integer array.

    +dimensions as the Surface and will completely replace all pixel values. Only +integer, ASCII character and record arrays are accepted.

    This function will temporarily lock the Surface as the new values are copied.

    @@ -520,7 +499,7 @@ ValueError. Using this function will raise a get_arraytypes() tuple and indicates which type of array module is used for the array creation. Using this function will raise a DeprecationWarning.

    -
    +

    New in pygame 1.8.

    @@ -537,7 +516,7 @@ strings. The values of the tuple can be used directly in the pygame.surfarray.use_arraytype()Sets the array system to be used for surface arrays () method. If no supported array system could be found, None will be returned. Using this function will raise a DeprecationWarning.

    -
    +

    New in pygame 1.8.

    @@ -549,7 +528,7 @@ system could be found, None will be returned. Using this function will raise a


    -Edit on GitHub +Edit on GitHub
    @@ -565,17 +544,19 @@ system could be found, None will be returned. Using this function will raise a modules |
  • - next |
  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/system.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/system.html deleted file mode 100644 index 525160d..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/system.html +++ /dev/null @@ -1,374 +0,0 @@ - - - - - - - - pygame.system — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -
    -pygame.system
    -
    -
    Pygame module to provide additional context about the system.
    -
    - - - - - - - - - - - - - - - - - - - - - - - -
    -—Get the information of CPU instruction sets.
    -—Get the amount of RAM configured in the system.
    -—Get a writeable folder for your app.
    -—Get preferred locales set on the system.
    -—Get the current power supply state.
    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    -
    -pygame.system.get_cpu_instruction_sets()
    -
    -
    Get the information of CPU instruction sets.
    -
    get_cpu_instruction_sets() -> _InstructionSets
    -
    -

    Returns a dict of the information of CPU instruction sets. The keys of -the dict are the names of instruction sets and the values determine -whether the instruction set is available.

    -

    Some of functions like Surface.blit can be accelerated by SIMD -instruction sets like SSE2 or AVX2. By checking the availability of -instruction sets, you can check if these accelerations are available.

    -

    Here is an example of the returned dict

    -
    {
    -    'ALTIVEC': False,
    -    'MMX': True,
    -    'SSE': True,
    -    'SSE2': True,
    -    'SSE3': True,
    -    'SSE41': True,
    -    'SSE42': True,
    -    'AVX': True,
    -    'AVX2': True,
    -    'AVX512F': False,
    -    'NEON': False,
    -    'ARMSIMD': False,
    -    'LSX': False,
    -    'LASX': False
    -}
    -
    -
    -
    -

    Note

    -

    The values of LSX and LASX will be always False if -SDL version < 2.24.0.

    -
    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    -

    Changed in pygame-ce 2.4.0: removed RDTSC key, -as it has been removed in pre-release SDL3

    -
    -
    - -
    -
    -pygame.system.get_total_ram()
    -
    -
    Get the amount of RAM configured in the system.
    -
    get_total_ram() -> int
    -
    -

    Returns the amount of RAM configured in the system in MiB.

    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    - -
    -
    -pygame.system.get_pref_path()
    -
    -
    Get a writeable folder for your app.
    -
    get_pref_path(org, app) -> str
    -
    -

    When distributing apps, it's helpful to have a way to get a writeable path, -because it's what apps are expected to do, and because sometimes the local -space around the app isn't writeable to the app.

    -

    This function returns a platform specific path for your app to store -savegames, settings, and the like. This path is unique per user and -per app name.

    -

    It takes two strings, org and app, referring to the "organization" -and "application name." For example, the organization could be "Valve," -and the application name could be "Half Life 2." It then will figure out the -preferred path, creating the folders referenced by the path if necessary, -and return a string containing the absolute path.

    -

    For example:

    -
    On Windows, it would resemble
    -C:\Users\bob\AppData\Roaming\My Company\My Program Name\
    -
    -On macOS, it would resemble
    -/Users/bob/Library/Application Support/My Company/My Program Name/
    -
    -And on Linux it would resemble
    -/home/bob/.local/share/My Company/My Program Name/
    -
    -
    -
    -

    Note

    -

    Since the organization and app names can potentially be used as -a folder name, it is highly encouraged to avoid punctuation. -Instead stick to letters, numbers, and spaces.

    -
    -
    -

    Note

    -

    The appdirs library has similar functionality for this use case, -but has more "folder types" to choose from.

    -
    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    - -
    -
    -pygame.system.get_pref_locales()
    -
    -
    Get preferred locales set on the system.
    -
    get_pref_locales() -> list[_Locale]
    -
    -

    Returns a list of "locale" dicts, sorted in descending order of preference -set on the host OS (the most preferred locale is the first element). May -also be an empty list if pygame could not find this information.

    -

    Each "locale" dict contains the language code which can be accessed by the -key "language". This language code is an ISO-639 language specifier -(such as "en" for English, "de" for German, etc). -A "locale" dict may also optionally contain a "country" field, whose -value is an ISO-3166 country code (such as "US" for the United States, -"CA" for Canada, etc). If this field is not set or undetermined, it is -None. -A "locale" dict which looks like {'language': 'en', 'country': 'US'} -indicates the user prefers American English, while -{'language': 'en', 'country': None} indicates that the user prefers -English, generically.

    -

    This might be a bit of an expensive call because it has to query the OS. So -this function must not be called in a game loop, instead it's best to ask -for this once and save the results. However, this list can change when the -user changes a system preference outside of your program. pygame will send -a LOCALECHANGED event in this case, if possible, and you can call this -function again to get an updated copy of preferred locales.

    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    - -
    -
    -pygame.system.get_power_state()
    -
    -
    Get the current power supply state.
    -
    get_power_state() -> PowerState | None
    -
    -

    Experimental: feature available for testing and feedback. -We don't anticipate it changing, but it might if something important -is brought up. Please leave get_power_state feedback with -authors

    -

    Returns a PowerState object representing the power supply state.

    -

    Returns None if the power state is unknown.

    -

    The PowerState object has several attributes:

    -
    battery_percent:
    -    An integer between 0 and 100, representing the percentage of
    -    battery life left.
    -
    -battery_seconds:
    -    An integer, representing the seconds of battery life left.
    -    Could be None if the value is unknown.
    -
    -on_battery:
    -    True if the device is running on the battery (not plugged in).
    -
    -no_battery:
    -    True if the device has no battery available (plugged in).
    -
    -charging:
    -    True if the device is charging battery (plugged in).
    -
    -charged:
    -    True if the battery of the device is fully charged (plugged in).
    -
    -plugged_in:
    -    True if the device is plugged in.
    -    Equivalent to `not on_battery`.
    -
    -has_battery:
    -    True if the device has battery.
    -    Equivalent to `on_battery or not no_battery`.
    -
    -
    -

    You should never take a battery status as absolute truth. Batteries -(especially failing batteries) are delicate hardware, and the values -reported here are best estimates based on what that hardware reports. It's -not uncommon for older batteries to lose stored power much faster than it -reports, or completely drain when reporting it has 20 percent left, etc.

    -

    Battery status can change at any time; if you are concerned with power -state, you should call this function frequently, and perhaps ignore changes -until they seem to be stable for a few seconds.

    -

    It's possible a platform can only report battery percentage or time left -but not both.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    - -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/tests.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/tests.html index 2bc4430..18701bd 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/tests.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/tests.html @@ -5,19 +5,17 @@ - pygame.tests — pygame-ce v2.5.8 documentation - - - - - + pygame.tests — pygame v2.6.1 documentation + + + + - - +
    @@ -25,30 +23,24 @@
    @@ -127,20 +117,21 @@ the go submodule with the Python -m option:

    correspond to the pygame.tests.run()Run the pygame unit test suite arguments.

    The xxxx_test submodules of the tests package are unit test suites for individual parts of pygame. Each can also be run as a main program. This is -useful if the test is interactive.

    +useful if the test, such as cdrom_test, is interactive.

    For pygame development the test suite can be run from a pygame distribution root directory. Program run_tests.py is provided for convenience, though test/go.py can be run directly.

    Module level tags control which modules are included in a unit test run. Tags are assigned to a unit test module with a corresponding <name>_tags.py module. The tags module has the global __tags__, a list of tag names. For example, -controller_test.py has a tag variable containing a tags list that -has the 'interactive' string. The 'interactive' tag indicates controller_test.py +cdrom_test.py has a tag file cdrom_tags.py containing a tags list that +has the 'interactive' string. The 'interactive' tag indicates cdrom_test.py expects user input. It is excluded from a run_tests.py or -pygame.tests.go run. Two other tags that are excluded are 'ignore' and -'subprocess_ignore'. These two tags indicate unit tests that will not run on a -particular platform, or for which no corresponding pygame module is available. -The test runner will list each excluded module along with the tag responsible.

    +pygame.tests.go run.

    +

    Two other tags that are excluded are 'ignore' and 'subprocess_ignore'. These +two tags indicate unit tests that will not run on a particular platform, or +for which no corresponding pygame module is available.

    +

    The test runner will list each excluded module along with the tag responsible.

    pygame.tests.run()
    @@ -161,7 +152,7 @@ The test runner will list each excluded module along with the tag responsible.file - if provided, the name of a file into which to dump failures/errors timings - if provided, the number of times to run each individual test to get an average run time (default is run each test once) -exclude - A list of TAG names to exclude from the run +exclude - A list of TAG names to exclude from the run show_output - show silenced stderr/stdout on errors (default False) all - dump all results, not just errors (default False) randomize - randomize order of tests (default False) @@ -185,17 +176,18 @@ The test runner will list each excluded module along with the tag responsible.By default individual test modules are run in separate subprocesses. This recreates normal pygame usage where pygame.init() and pygame.quit() are called only once per program execution, and avoids unfortunate -interactions between test modules. Also, a time limit is placed on test -execution, so frozen tests are killed when their time allotment expired. Use -the single process option if threading is not working properly or if tests -are taking too long. It is not guaranteed that all tests will pass in single -process mode.

    +interactions between test modules.

    +

    A time limit is placed on test execution ensuring that any frozen tests +processes are killed when their time allotment is expired. Use the single +process option if threading is not working properly or if tests are taking +too long. It is not guaranteed that all tests will pass in single process +mode.

    Tests are run in a randomized order if the randomize argument is True or a seed argument is provided. If no seed integer is provided then the system -time is used.

    +time is used for the randomization seed value.

    Individual test modules may have a __tags__ attribute, a list of tag strings used to selectively omit modules from a run. By default only 'interactive' -modules such as controller_test are ignored. An interactive module must be run +modules such as cdrom_test are ignored. An interactive module must be run from the console as a Python program.

    This function can only be called once per Python session. It is not reentrant.

    @@ -208,7 +200,7 @@ reentrant.




    -Edit on GitHub +Edit on GitHub
    @@ -227,14 +219,16 @@ reentrant.

    next |
  • - previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/time.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/time.html index 12e67d0..b4e364b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/time.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/time.html @@ -5,14 +5,12 @@ - pygame.time — pygame-ce v2.5.8 documentation - - - - - + pygame.time — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -107,46 +97,46 @@
    pygame.time
    -
    Pygame module for monitoring time.
    +
    pygame module for monitoring time
    - + - + - + - + - +
    —Get the time in milliseconds.get the time in milliseconds
    —Pause the program for an amount of time.pause the program for an amount of time
    —Pause the program for an amount of time.pause the program for an amount of time
    —Repeatedly create an event on the event queue.repeatedly create an event on the event queue
    —Create an object to help track time.create an object to help track time
    -

    Provides utilities for monitoring time, delaying time, and maintaining a -constant frame rate. -Times in pygame-ce are represented in milliseconds (1/1000 of a second).

    +

    Times in pygame are represented in milliseconds (1/1000 seconds). Most +platforms have a limited time resolution of around 10 milliseconds. This +resolution, in milliseconds, is given in the TIMER_RESOLUTION constant.

    pygame.time.get_ticks()
    -
    Get the time in milliseconds.
    -
    get_ticks() -> int
    +
    get the time in milliseconds
    +
    get_ticks() -> milliseconds

    Return the number of milliseconds since pygame.init() was called. Before pygame is initialized this will always be 0.

    @@ -156,8 +146,8 @@ pygame is initialized this will always be 0.

    pygame.time.wait()
    -
    Pause the program for an amount of time.
    -
    wait(milliseconds, /) -> int
    +
    pause the program for an amount of time
    +
    wait(milliseconds) -> time

    Will pause for a given number of milliseconds. This function sleeps the process to share the processor with other programs. A program that waits for @@ -170,8 +160,8 @@ slightly less accurate than the pygame.time.delay()

    -
    Pause the program for an amount of time.
    -
    delay(milliseconds, /) -> int
    +
    pause the program for an amount of time
    +
    delay(milliseconds) -> time

    Will pause for a given number of milliseconds. This function will use the processor (rather than sleeping) in order to make the delay more accurate @@ -183,12 +173,13 @@ than pygame.time.wa

    pygame.time.set_timer()
    -
    Repeatedly create an event on the event queue.
    +
    repeatedly create an event on the event queue
    +
    set_timer(event, millis) -> None
    set_timer(event, millis, loops=0) -> None

    Set an event to appear on the event queue every given number of milliseconds. The first event will not appear until the amount of time has passed.

    -

    The event parameter can be a pygame.event.Event object or an integer +

    The event attribute can be a pygame.event.Event object or an integer type that denotes an event.

    loops is an integer that denotes the number of events posted. If 0 (default) then the events will keep getting posted, unless explicitly stopped.

    @@ -198,22 +189,15 @@ event argument with -

    When this function is called with an Event object, the event(s) received -on the event queue will be a shallow copy; the dict attribute of the event -object passed as an argument and the dict attributes of the event objects -received on timer will be references to the same dict object in memory. -Modifications on one dict can affect another, use deepcopy operations on the -dict object if you don't want this behaviour. -However, calling this function with an integer event type would place event objects -on the queue that don't have a common dict reference.

    -

    This function is not supported on web (WASM/Emscripten) builds.

    -
    +

    loops replaces the once argument, and this does not break backward +compatibility

    +

    New in pygame 2.0.0.dev3: once argument added.

    -
    +

    Changed in pygame 2.0.1: event argument supports pygame.event.Event object

    -
    +

    New in pygame 2.0.1: added loops argument to replace once argument

    @@ -222,7 +206,7 @@ on the queue that don't have a common dict reference.

    pygame.time.Clock
    -
    Create an object to help track time.
    +
    create an object to help track time
    Clock() -> Clock
    @@ -230,42 +214,38 @@ on the queue that don't have a common dict reference.

    - + - + - + - + - +
    —Update the clock.update the clock
    —Update the clock.update the clock
    —Time used in the previous tick.time used in the previous tick
    —Actual time used in the previous tick.actual time used in the previous tick
    —Compute the clock framerate.compute the clock framerate

    Creates a new Clock object that can be used to track an amount of time. The clock also provides several functions to help control a game's framerate.

    -
    -

    Changed in pygame-ce 2.1.4: This class is also available through the pygame.Clock -alias.

    -
    tick()
    -
    Update the clock.
    -
    tick(framerate=0, /) -> int
    +
    update the clock
    +
    tick(framerate=0) -> milliseconds

    This method should be called once per frame. It will compute how many milliseconds have passed since the previous call.

    @@ -273,9 +253,8 @@ milliseconds have passed since the previous call.

    keep the game running slower than the given ticks per second. This can be used to help limit the runtime speed of a game. By calling Clock.tick(40) once per frame, the program will never run at more -than 40 frames per second. Passing 0 (the default) places no limit on -the framerate.

    -

    Note that this function uses SDL_Delay, which is not accurate on +than 40 frames per second.

    +

    Note that this function uses SDL_Delay function which is not accurate on every platform, but does not use much CPU. Use tick_busy_loop if you want an accurate timer, and don't mind chewing CPU.

    @@ -284,8 +263,8 @@ an accurate timer, and don't mind chewing CPU.

    tick_busy_loop()
    -
    Update the clock.
    -
    tick_busy_loop(framerate=0, /) -> int
    +
    update the clock
    +
    tick_busy_loop(framerate=0) -> milliseconds

    This method should be called once per frame. It will compute how many milliseconds have passed since the previous call.

    @@ -293,11 +272,10 @@ milliseconds have passed since the previous call.

    keep the game running slower than the given ticks per second. This can be used to help limit the runtime speed of a game. By calling Clock.tick_busy_loop(40) once per frame, the program will never run at -more than 40 frames per second. Passing 0 (the default) places no limit on -the framerate.

    -

    Note that this function uses pygame.time.delay()Pause the program for an amount of time., which uses lots +more than 40 frames per second.

    +

    Note that this function uses pygame.time.delay()pause the program for an amount of time, which uses lots of CPU in a busy loop to make sure that timing is more accurate.

    -
    +

    New in pygame 1.8.

    @@ -306,8 +284,8 @@ of CPU in a busy loop to make sure that timing is more accurate.

    get_time()
    -
    Time used in the previous tick.
    -
    get_time() -> int
    +
    time used in the previous tick
    +
    get_time() -> milliseconds

    The number of milliseconds that passed between the previous two calls to Clock.tick().

    @@ -317,8 +295,8 @@ of CPU in a busy loop to make sure that timing is more accurate.

    get_rawtime()
    -
    Actual time used in the previous tick.
    -
    get_rawtime() -> int
    +
    actual time used in the previous tick
    +
    get_rawtime() -> milliseconds

    Similar to Clock.get_time(), but does not include any time used while Clock.tick() was delaying to limit the framerate.

    @@ -328,12 +306,11 @@ while Clock.tick()<
    get_fps()
    -
    Compute the clock framerate.
    +
    compute the clock framerate
    get_fps() -> float

    Compute your game's framerate (in frames per second). It is computed by -averaging the last ten calls to Clock.tick(). Returns 0.0 if fewer -than ten ticks have been made.

    +averaging the last ten calls to Clock.tick().

    @@ -345,7 +322,7 @@ than ten ticks have been made.




    -Edit on GitHub +Edit on GitHub
    @@ -366,12 +343,14 @@ than ten ticks have been made.

  • previous |
  • - - + + + + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/touch.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/touch.html index 7cfc65e..5a813d2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/touch.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/touch.html @@ -5,14 +5,12 @@ - pygame._sdl2.touch — pygame-ce v2.5.8 documentation - - - - - + pygame._sdl2.touch — pygame v2.6.1 documentation + + + + - @@ -25,30 +23,24 @@
    @@ -133,7 +123,7 @@ -
    +

    New in pygame 2: This module requires SDL2.

    @@ -178,7 +168,7 @@ whose id is touchid.

    pygame._sdl2.touch.get_finger()
    get information about an active finger
    -
    get_finger(touchid, index) -> dict | None
    +
    get_finger(touchid, index) -> int
    Parameters:
    @@ -190,8 +180,7 @@ information about, between 0 and the
    -

    Return a dict for the finger index active on touchid, or None if the -object does not exist. +

    Return a dict for the finger index active on touchid. The dict contains these keys:

    id         the id of the finger (an integer).
     x          the normalized x position of the finger, between 0 and 1.
    @@ -208,7 +197,7 @@ The dict contains these keys:




    -Edit on GitHub +Edit on GitHub
    @@ -229,12 +218,14 @@ The dict contains these keys:

  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/transform.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/transform.html index 994e356..9afb845 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/transform.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/transform.html @@ -5,18 +5,16 @@ - pygame.transform — pygame-ce v2.5.8 documentation - - - - - + pygame.transform — pygame v2.6.1 documentation + + + + - - + @@ -25,30 +23,24 @@
    @@ -107,119 +97,89 @@
    pygame.transform
    -
    Pygame module to transform surfaces.
    +
    pygame module to transform surfaces
    - + - + - + - + - + - + - + - + - + - + - + - - - - - - - - - + - + - + - - - - - - - - - - + - - - - - - - - - +
    —Flip vertically and horizontally.flip vertically and horizontally
    —Resize to new resolution.resize to new resolution
    —Resize to new resolution, using scalar(s).resize to new resolution, using scalar(s)
    —Rotate an image.rotate an image
    —Filtered scale and rotation.filtered scale and rotation
    —Specialized image doubler.specialized image doubler
    —Scale a surface to an arbitrary size smoothly.scale a surface to an arbitrary size smoothly
    —Resize to new resolution, using scalar(s).resize to new resolution, using scalar(s)
    —Return smoothscale filter version in use: 'GENERIC', 'MMX', 'SSE', 'SSE2', or 'NEON'.return smoothscale filter version in use: 'GENERIC', 'MMX', or 'SSE'
    —Set smoothscale filter version to one of: 'GENERIC', 'MMX', 'SSE', 'SSE2', or 'NEON'.set smoothscale filter version to one of: 'GENERIC', 'MMX', or 'SSE'
    —Gets a copy of an image with an interior area removed.gets a copy of an image with an interior area removed
    —Find edges in a surface.
    -—Blur a surface using box blur.
    -—Blur a surface using gaussian blur.find edges in a surface
    —Find the average surface from many surfaces.find the average surface from many surfaces.
    —Finds the average color of a surface.finds the average color of a surface
    +
    —Inverts the RGB elements of a surface.
    -—Grayscale a surface.
    -—Replaces non transparent pixels with the provided color.grayscale a surface
    —Finds which, and how many pixels in a surface are within a threshold of a 'search_color' or a 'search_surf'.
    -—Change the hue, saturation, and lightness of a surface.
    -—Returns a pixelated version of the original surface.finds which, and how many pixels in a surface are within a threshold of a 'search_color' or a 'search_surf'.
    @@ -233,14 +193,14 @@ than to keep transforming an image multiple times. (For example, suppose you are animating a bouncing spring which expands and contracts. If you applied the size changes incrementally to the previous images, you would lose detail. Instead, always begin with the original image and scale to the desired size.)

    -
    +

    Changed in pygame 2.0.2: transform functions now support keyword arguments.

    pygame.transform.flip()
    -
    Flip vertically and horizontally.
    +
    flip vertically and horizontally
    flip(surface, flip_x, flip_y) -> Surface

    This can flip a Surface either vertically, horizontally, or both. @@ -253,39 +213,34 @@ Surface with the same dimensions.

    pygame.transform.scale()
    -
    Resize to new resolution.
    +
    resize to new resolution
    scale(surface, size, dest_surface=None) -> Surface

    Resizes the Surface to a new size, given as (width, height). This is a fast scale operation that does not sample the results.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must be the same as the size (width, height) passed -in, and the same depth and format as the source Surface.

    -
    -

    Changed in pygame-ce 2.2.1: internal scaling algorithm was replaced with a nearly -equivalent one that is 40% faster. Scale results will be very slightly -different.

    -
    +

    An optional destination surface can be used, rather than have it create a +new one. This is quicker if you want to repeatedly scale something. However +the destination must be the same size as the size (width, height) passed in. Also +the destination surface must be the same format.

    pygame.transform.scale_by()
    -
    Resize to new resolution, using scalar(s).
    +
    resize to new resolution, using scalar(s)
    scale_by(surface, factor, dest_surface=None) -> Surface
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave scale_by feedback with authors

    Same as scale(), but scales by some factor, rather than taking the new size explicitly. For example, transform.scale_by(surf, 3) will triple the size of the surface in both dimensions. Optionally, the scale factor can be a sequence of two numbers, controlling x and y scaling separately. For example, transform.scale_by(surf, (2, 1)) doubles the image width but keeps the height the same.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the scaled dimensions -(width * factor, height * factor) and same depth and format as the source Surface.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -293,7 +248,7 @@ Surface. This destination surface must have the scaled dimensions
    pygame.transform.rotate()
    -
    Rotate an image.
    +
    rotate an image
    rotate(surface, angle) -> Surface

    Unfiltered counterclockwise rotation. The angle argument represents degrees @@ -309,7 +264,7 @@ colorkey or the topleft pixel value.

    pygame.transform.rotozoom()
    -
    Filtered scale and rotation.
    +
    filtered scale and rotation
    rotozoom(surface, angle, scale) -> Surface

    This is a combined scale and rotation transform. The resulting Surface will @@ -323,7 +278,7 @@ A negative rotation angle will rotate clockwise.

    pygame.transform.scale2x()
    -
    Specialized image doubler.
    +
    specialized image doubler
    scale2x(surface, dest_surface=None) -> Surface

    This will return a new image that is double the size of the original. It @@ -332,43 +287,41 @@ bitmap graphics.

    This really only has an effect on simple images with solid colors. On photographic and antialiased images it will look like a regular unfiltered scale.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have double the dimensions -(width * 2, height * 2) and same depth and format as the source Surface.

    +

    An optional destination surface can be used, rather than have it create a +new one. This is quicker if you want to repeatedly scale something. However +the destination must be twice the size of the source surface passed in. Also +the destination surface must be the same format.

    pygame.transform.smoothscale()
    -
    Scale a surface to an arbitrary size smoothly.
    +
    scale a surface to an arbitrary size smoothly
    smoothscale(surface, size, dest_surface=None) -> Surface

    Uses one of two different algorithms for scaling each dimension of the input surface as required. For shrinkage, the output pixels are area averages of -the colors they cover. The size is a 2 number sequence for (width, height). -This function only works for 24-bit or 32-bit surfaces. A ValueError will -be thrown if the input surface bit depth is less than 24.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must be the same as the size (width, height) passed -in, and the same depth and format as the source Surface.

    -
    +the colors they cover. For expansion, a bilinear filter is used. For the +x86-64 and i686 architectures, optimized MMX routines are included and +will run much faster than other machine types. The size is a 2 number +sequence for (width, height). This function only works for 24-bit or 32-bit +surfaces. An exception will be thrown if the input surface bit depth is less +than 24.

    +

    New in pygame 1.8.

    -
    -

    Changed in pygame-ce 2.4.0: now uses SSE2/NEON SIMD for acceleration on x86 -and ARM machines, a performance improvement over previous MMX/SSE only -supported on x86.

    -
    pygame.transform.smoothscale_by()
    -
    Resize to new resolution, using scalar(s).
    +
    resize to new resolution, using scalar(s)
    smoothscale_by(surface, factor, dest_surface=None) -> Surface
    +

    Experimental: feature still in development available for testing and feedback. It may change. +Please leave smoothscale_by feedback with authors

    Same as smoothscale(), but scales by some factor, rather than taking the new size explicitly. For example, transform.smoothscale_by(surf, 3) will triple the size of the @@ -376,11 +329,8 @@ surface in both dimensions. Optionally, the scale factor can be a sequence of two numbers, controlling x and y scaling separately. For example, transform.smoothscale_by(surf, (2, 1)) doubles the image width but keeps the height the same.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the scaled dimensions -(width * factor, height * factor) and same depth and format as the source Surface.

    -

    New in pygame-ce 2.1.3.

    +

    New in pygame 2.1.3.

    @@ -388,41 +338,36 @@ Surface. This destination surface must have the scaled dimensions
    pygame.transform.get_smoothscale_backend()
    -
    Return smoothscale filter version in use: 'GENERIC', 'MMX', 'SSE', 'SSE2', or 'NEON'.
    -
    get_smoothscale_backend() -> Literal['GENERIC', 'SSE2', 'NEON']
    +
    return smoothscale filter version in use: 'GENERIC', 'MMX', or 'SSE'
    +
    get_smoothscale_backend() -> string
    -

    Shows whether or not smoothscale is using SIMD acceleration. -If no acceleration is available then "GENERIC" is returned. The level of -acceleration possible is automatically determined at runtime.

    +

    Shows whether or not smoothscale is using MMX or SSE acceleration. +If no acceleration is available then "GENERIC" is returned. For a x86 +processor the level of acceleration to use is determined at runtime.

    This function is provided for pygame testing and debugging.

    -
    -

    Changed in pygame-ce 2.4.0: Added SSE2 and NEON backends, MMX and SSE are deprecated.

    -
    pygame.transform.set_smoothscale_backend()
    -
    Set smoothscale filter version to one of: 'GENERIC', 'MMX', 'SSE', 'SSE2', or 'NEON'.
    +
    set smoothscale filter version to one of: 'GENERIC', 'MMX', or 'SSE'
    set_smoothscale_backend(backend) -> None

    Sets smoothscale acceleration. Takes a string argument. A value of 'GENERIC' -turns off acceleration. A value error is raised if type is not +turns off acceleration. 'MMX' uses MMX instructions only. 'SSE' allows +SSE extensions as well. A value error is raised if type is not recognized or not supported by the current processor.

    This function is provided for pygame testing and debugging. If smoothscale causes an invalid instruction error then it is a pygame/SDL bug that should be reported. Use this function as a temporary fix only.

    -
    -

    Changed in pygame-ce 2.4.0: Added SSE2 and NEON backends, MMX and SSE are deprecated.

    -
    pygame.transform.chop()
    -
    Gets a copy of an image with an interior area removed.
    +
    gets a copy of an image with an interior area removed
    chop(surface, rect) -> Surface

    Extracts a portion of an image. All vertical and horizontal pixels @@ -437,92 +382,33 @@ rect, you can blit with a rect to a new surface or copy a subsurface.

    pygame.transform.laplacian()
    -
    Find edges in a surface.
    +
    find edges in a surface
    laplacian(surface, dest_surface=None) -> Surface

    Finds the edges in a surface using the laplacian algorithm.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the same dimensions (width, height) and -depth as the source Surface.

    -
    +

    New in pygame 1.8.

    -
    -
    -pygame.transform.box_blur()
    -
    -
    Blur a surface using box blur.
    -
    box_blur(surface, radius, repeat_edge_pixels=True, dest_surface=None) -> Surface
    -
    -

    Returns the blurred surface using box blur algorithm.

    -

    This function does not work for indexed surfaces. -An exception will be thrown if the input is an indexed surface.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the same dimensions (width, height) and -depth and format as the source Surface.

    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    -

    Changed in pygame-ce 2.3.0: Passing the calling surface as destination surface raises a ValueError

    -
    -
    -

    Changed in pygame-ce 2.5.0: A surface with either width or height equal to 0 won't raise a ValueError

    -
    -
    - -
    -
    -pygame.transform.gaussian_blur()
    -
    -
    Blur a surface using gaussian blur.
    -
    gaussian_blur(surface, radius, repeat_edge_pixels=True, dest_surface=None) -> Surface
    -
    -

    Returns the blurred surface using gaussian blur algorithm. -Slower than box_blur().

    -

    This function does not work for indexed surfaces. -An exception will be thrown if the input is an indexed surface.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the same dimensions (width, height) and -depth and format as the source Surface.

    -
    -

    New in pygame-ce 2.2.0.

    -
    -
    -

    Changed in pygame-ce 2.3.0: Passing the calling surface as destination surface raises a ValueError

    -
    -
    -

    Changed in pygame-ce 2.3.1: Now the standard deviation of the Gaussian kernel is equal to the radius. -Blur results will be slightly different.

    -
    -
    -

    Changed in pygame-ce 2.5.0: A surface with either width or height equal to 0 won't raise a ValueError

    -
    -
    -
    pygame.transform.average_surfaces()
    -
    Find the average surface from many surfaces.
    +
    find the average surface from many surfaces.
    average_surfaces(surfaces, dest_surface=None, palette_colors=1) -> Surface

    Takes a sequence of surfaces and returns a surface with average colors from each of the surfaces.

    palette_colors - if true we average the colors in palette, otherwise we average the pixel values. This is useful if the surface is actually -grayscale colors, and not palette colors.

    +greyscale colors, and not palette colors.

    Note, this function currently does not handle palette using surfaces correctly.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the same dimensions (width, height) and -depth as the first passed source Surface.

    -
    +

    New in pygame 1.8.

    -
    +

    New in pygame 1.9: palette_colors argument

    @@ -531,31 +417,14 @@ depth as the first passed source Surface.

    pygame.transform.average_color()
    -
    Finds the average color of a surface.
    -
    average_color(surface, rect=None, consider_alpha=False) -> tuple[int, int, int, int]
    +
    finds the average color of a surface
    +
    average_color(surface, rect=None, consider_alpha=False) -> Color

    Finds the average color of a Surface or a region of a surface specified by a -Rect, and returns it as a tuple of integers red, green, blue, and alpha. -If consider_alpha is set to True, then alpha is taken into account -(removing the black artifacts).

    -
    -

    New in pygame 2.1.2: consider_alpha argument

    -
    -
    - -
    -
    -pygame.transform.invert()
    -
    -
    Inverts the RGB elements of a surface.
    -
    invert(surface, dest_surface=None) -> Surface
    -
    -

    Inverts each RGB pixel contained within the Surface, does not affect alpha channel.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the same dimensions (width, height) and -depth as the source Surface.

    +Rect, and returns it as a Color. If consider_alpha is set to True, then alpha is +taken into account (removing the black artifacts).

    -

    New in pygame-ce 2.2.0.

    +

    New in pygame 2.1.2: consider_alpha argument

    @@ -563,56 +432,20 @@ depth as the source Surface.

    pygame.transform.grayscale()
    -
    Grayscale a surface.
    +
    grayscale a surface
    grayscale(surface, dest_surface=None) -> Surface

    Returns a grayscaled version of the original surface using the luminosity formula which weights red, green and blue according to their wavelengths.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. This destination surface must have the same dimensions (width, height) and -depth as the source Surface.

    -
    -

    New in pygame-ce 2.1.4.

    -
    -
    -

    Changed in pygame-ce 2.4.0: Adjusted formula slightly to support performance -optimisation. It may return very slightly different pixels than before, -but should run seven to eleven times faster on most systems.

    -
    -
    - -
    -
    -pygame.transform.solid_overlay()
    -
    -
    Replaces non transparent pixels with the provided color.
    -
    solid_overlay(surface, color, dest_surface=None, keep_alpha=False) -> Surface
    -
    -

    Returns a new version of the original surface with all non transparent pixels set to the color provided.

    -

    An optional destination surface can be passed which is faster than creating a new -Surface. -This destination surface must have the same dimensions (width, height) and -depth as the source Surface.

    -
    -
    Parameters:
    -
    -
    -
    -
    -

    New in pygame-ce 2.5.2.

    -
    +

    An optional destination surface can be passed which is faster than creating a new Surface. +This destination surface must have the same dimensions (width, height) and depth as the source Surface.

    pygame.transform.threshold()
    -
    Finds which, and how many pixels in a surface are within a threshold of a 'search_color' or a 'search_surf'.
    -
    threshold(dest_surface, surface, search_color, threshold=(0, 0, 0, 0), set_color=(0, 0, 0, 0), set_behavior=1, search_surf=None, inverse_set=False) -> int
    +
    finds which, and how many pixels in a surface are within a threshold of a 'search_color' or a 'search_surf'.
    +
    threshold(dest_surface, surface, search_color, threshold=(0,0,0,0), set_color=(0,0,0,0), set_behavior=1, search_surf=None, inverse_set=False) -> num_threshold_pixels

    This versatile function can be used for find colors in a 'surf' close to a 'search_color' or close to colors in a separate 'search_surf'.

    @@ -627,22 +460,22 @@ of the 'search_surf'.

    Parameters:
    -
    -

    New in pygame 1.8.

    -
    -
    -

    Changed in pygame 1.9.4: Fixed a lot of bugs and added keyword arguments. Test your code.

    -
    -
    -

    Changed in pygame-ce 2.5.8: Fixed set_color writing the wrong channels on 24-bit destination -surfaces whose byte layout did not match the platform default.

    -
    -
    +

    See the threshold tests for a full of examples: https://github.com/pygame/pygame/blob/main/test/transform_test.py

    +
        def test_threshold_dest_surf_not_change(self):
    +        """the pixels within the threshold.
     
    -
    -
    -pygame.transform.hsl()
    -
    -
    Change the hue, saturation, and lightness of a surface.
    -
    hsl(surface, hue=0, saturation=0, lightness=0, dest_surface=None) -> Surface
    -
    -

    This function allows you to modify the hue, saturation, and lightness of a given surface.

    -
    -
    Parameters:
    -
      -
    • surface (pygame.SurfacePygame object for representing images.) -- The surface to transform.

    • -
    • hue (float) -- The amount to change the hue. Positive values rotate the hue clockwise, -while negative values rotate it counterclockwise. Value range: -360 to 360.

    • -
    • saturation (float) -- The amount to change the saturation. Positive values increase saturation, -while negative values decrease it. Value range: -1 to 1.

    • -
    • lightness (float) -- The amount to change the lightness. Positive values increase lightness, -while negative values decrease it. Value range: -1 to 1.

    • -
    • dest_surface (pygame.SurfacePygame object for representing images.) -- An optional destination surface to store the transformed image. -If provided, it should have the same dimensions and depth as the source surface.

    • -
    -
    -
    Returns:
    -

    A new surface with the hue, saturation, and lightness transformed.

    -
    -
    Examples:
    -

    -
    -

    Apply a hue rotation of 30 degrees, increase saturation by 20%, and decrease lightness by 10% to a surface:

    -
    new_surf = hsl(original_surf, 30, 0.2, -0.1)
    +        All pixels not within threshold are changed to set_color.
    +        So there should be none changed in this test.
    +        """
    +        (w, h) = size = (32, 32)
    +        threshold = (20, 20, 20, 20)
    +        original_color = (25, 25, 25, 25)
    +        original_dest_color = (65, 65, 65, 55)
    +        threshold_color = (10, 10, 10, 10)
    +        set_color = (255, 10, 10, 10)
    +
    +        surf = pygame.Surface(size, pygame.SRCALPHA, 32)
    +        dest_surf = pygame.Surface(size, pygame.SRCALPHA, 32)
    +        search_surf = pygame.Surface(size, pygame.SRCALPHA, 32)
    +
    +        surf.fill(original_color)
    +        search_surf.fill(threshold_color)
    +        dest_surf.fill(original_dest_color)
    +
    +        # set_behavior=1, set dest_surface from set_color.
    +        # all within threshold of third_surface, so no color is set.
    +
    +        THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR = 1
    +        pixels_within_threshold = pygame.transform.threshold(
    +            dest_surface=dest_surf,
    +            surface=surf,
    +            search_color=None,
    +            threshold=threshold,
    +            set_color=set_color,
    +            set_behavior=THRESHOLD_BEHAVIOR_FROM_SEARCH_COLOR,
    +            search_surf=search_surf,
    +        )
    +
    +        # # Return, of pixels within threshold is correct
    +        self.assertEqual(w * h, pixels_within_threshold)
    +
    +        # # Size of dest surface is correct
    +        dest_rect = dest_surf.get_rect()
    +        dest_size = dest_rect.size
    +        self.assertEqual(size, dest_size)
    +
    +        # The color is not the change_color specified for every pixel As all
    +        # pixels are within threshold
    +
    +        for pt in test_utils.rect_area_pts(dest_rect):
    +            self.assertNotEqual(dest_surf.get_at(pt), set_color)
    +            self.assertEqual(dest_surf.get_at(pt), original_dest_color)
     
    -

    New in pygame-ce 2.5.0.

    +

    New in pygame 1.8.

    -
    - -
    -
    -pygame.transform.pixelate()
    -
    -
    Returns a pixelated version of the original surface.
    -
    pixelate(surface, pixel_size, dest_surface=None) -> Surface
    -
    -

    pixel_size is an integer describing how large you want the pixels in the final pixelated image to be. -An optional destination surface can be passed which is faster than creating a new Surface. This destination -surface must have the same dimensions (width, height) and same depth and format as the source Surface.

    -
    -
    Parameters:
    -
    -
    -
    Returns:
    -

    A new surface that's been pixelated.

    -
    -
    -
    -

    New in pygame-ce 2.5.6.

    -
    -
    -

    Note

    -

    pixel_size must be >= 1. A ValueError is raised otherwise.

    +
    +

    Changed in pygame 1.9.4: Fixed a lot of bugs and added keyword arguments. Test your code.

    @@ -750,7 +564,7 @@ If provided, it should have the same dimensions and depth as the source surface.


    -Edit on GitHub +Edit on GitHub
    @@ -766,17 +580,19 @@ If provided, it should have the same dimensions and depth as the source surface. modules |
  • - next |
  • previous |
  • - - + + + +
    \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/typing.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/typing.html deleted file mode 100644 index f7476fc..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/typing.html +++ /dev/null @@ -1,278 +0,0 @@ - - - - - - - - pygame.typing — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -
    -pygame.typing
    -
    -
    pygame module providing common typehints
    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -—
    -—
    -—
    -—
    -—
    -—
    -
    -

    New in pygame-ce 2.5.2.

    -
    -

    A lot of pygame functions and methods allow the user to provide different types -for the same value like colors or points. This module exports the most common -type aliases for proper typehint annotations.

    -
    -
    -
    -pygame.typing.FileLike
    -

    An object representing a file. This includes both path-like -objects and file-like objects, i.e.:

    -
    -
      -
    • "my/string/path.txt"

    • -
    • open("my/file/path.txt")

    • -
    • pathlib.Path("my/pathlib/path.txt")

    • -
    • io.BytesIO(b"my data: \x00\x01")

    • -
    • b"my/bytes/path.txt"

    • -
    • Any object implementing the path protocol or file protocol.

    • -
    -
    -
    - -
    -
    -pygame.typing.SequenceLike
    -

    A variant of the standard Sequence ABC only requiring __getitem__ -and __len__. This includes custom sequences or builtin ones, i.e.:

    -
    -
      -
    • "abcdefg"

    • -
    • [a, b, c, d, ...]

    • -
    • (a, b, c, d, ...)

    • -
    -
    -

    Being a generic, subscribing it will signal further precision such as -SequenceLike[str] or SequenceLike[float].

    -
    - -
    -
    -pygame.typing.Point
    -

    A sequence of two numbers (floats or ints), i.e:

    -
    -
      -
    • pygame.Vector2(a, b)

    • -
    • [a, b]

    • -
    • (a, b)

    • -
    -
    -
    - -
    -
    -pygame.typing.IntPoint
    -

    A sequence of strictly two integers such as [a, b] or (a, b).

    -
    - -
    -
    -pygame.typing.ColorLike
    -

    An object representing a color such as a mapped integer, a string or -a sequence of three or four integers in range 0-255, types supported by -every function accepting a color argument. i.e.:

    -
    -
      -
    • pygame.Color(ColorLike)

    • -
    • (r, g, b)

    • -
    • (r, g, b, a)

    • -
    • [r, g, b, a]

    • -
    • "green" (Named Colors)

    • -
    • "#rrggbbaa"

    • -
    • 0 (mapped color)

    • -
    -
    -
    - -
    -
    -pygame.typing.RectLike
    -

    An object representing a rect such as a sequence of numbers or points -or an object with a rect attribute or a method returning a rect. These types -are supported by every function accepting a rect as argument. i.e.:

    -
    -
      -
    • (x, y, w, h)

    • -
    • (Point, Point)

    • -
    • pygame.Rect(RectLike)

    • -
    • Any object with a .rect attribute which is a RectLike or a function -returning a RectLike

    • -
    -
    -
    - -
    -
    - -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/window.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/window.html deleted file mode 100644 index 4efc5eb..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/ref/window.html +++ /dev/null @@ -1,975 +0,0 @@ - - - - - - - - pygame.Window — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -
    -pygame.Window
    -
    -
    Pygame object that represents a window.
    -
    Window(title='pygame window', size=(640, 480), position=WINDOWPOS_UNDEFINED, *, fullscreen=..., fullscreen_desktop=..., opengl=..., vulkan=..., hidden=..., borderless=..., resizable=..., minimized=..., maximized=..., mouse_grabbed=..., keyboard_grabbed=..., input_focus=..., mouse_focus=..., allow_high_dpi=..., mouse_capture=..., always_on_top=..., utility=...) -> Window
    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -—Get or set the window's mouse grab mode.
    -—Get or set the window's keyboard grab mode.
    -—Get if the mouse cursor is confined to the window (**read-only**).
    -—Get if the keyboard shortcuts are captured by the window (**read-only**).
    -—Get if the window is focused (**read-only**).
    -—Get or set the window title.
    -—Get or set whether the window is resizable.
    -—Gets or sets whether the window is borderless.
    -—Get or set whether the window is always on top.
    -—Get the unique window ID (**read-only**).
    -—Get or set the mouse confinement rectangle of the window.
    -—Get or set the window size in pixels.
    -—Get or set the minimum size of the window's client area.
    -—Get or set the maximum size of the window's client area.
    -—Get or set the window position in screen coordinates.
    -—Get or set the window opacity, between 0.0 (fully transparent) and 1.0 (fully opaque).
    -—Get if the window supports OpenGL.
    -—Get the window handle provided by the window manager if supported otherwise 0
    -—Get if the window is an utility window (**read-only**).
    -—Create a Window object using window data from display module.
    -—Get the window surface.
    -—Update the display surface to the window.
    -—Enable windowed mode (exit fullscreen).
    -—Enter fullscreen.
    -—Destroy the window.
    -—Hide the window.
    -—Show the window.
    -—Set the window to be focused.
    -—Restore the size and position of a minimized or maximized window.
    -—Maximize the window.
    -—Minimize the window.
    -—Set the window icon.
    -—Set the window as a modal for a parent window.
    -—Flash a window to demand attention from the user.
    -

    The Window class (formerly known as _sdl2.video.Window), is a newly -published feature of pygame-ce 2.5.2. This class allows for programs -to drive multiple windows on-screen at once, something not possible with -the pygame.display.set_mode()Initialize a window or screen for display. API. Not everything possible with -pygame.displayPygame module to control the display window and screen. is possible yet in the Window API, but the new -window class will continue to be developed, and we're excited to share -the new functionality this class offers.

    -
    -
    Parameters:
    -
      -
    • title (str) -- The title of the window.

    • -
    • size ((int, int)) -- The size of the window, in screen coordinates.

    • -
    • position ((int, int) or int) -- A tuple specifying the window position, or -WINDOWPOS_CENTERED, or WINDOWPOS_UNDEFINED.

    • -
    • fullscreen (bool) -- Create a fullscreen window using the window size as -the resolution (videomode change).

    • -
    • fullscreen_desktop (bool) -- Create a fullscreen window using the current -desktop resolution.

    • -
    • opengl (bool) -- Create a window with support for an OpenGL context.

    • -
    • vulkan (bool) -- Create a window with support for a Vulkan instance.

    • -
    • hidden (bool) -- Create a hidden window.

    • -
    • borderless (bool) -- Create a window without borders.

    • -
    • resizable (bool) -- Create a resizable window.

    • -
    • minimized (bool) -- Create a mimized window.

    • -
    • maximized (bool) -- Create a maximized window.

    • -
    • mouse_grabbed (bool) -- Create a window with grabbed mouse input.

    • -
    • keyboard_grabbed (bool) -- Create a window with grabbed keyboard input.

    • -
    • input_focus (bool) -- Create a window with input focus.

    • -
    • mouse_focus (bool) -- Create a window with mouse focus.

    • -
    • allow_high_dpi (bool) -- Create a window in high-DPI mode if supported.

    • -
    • mouse_capture (bool) -- Create a window that has the mouse captured -(unrelated to INPUT_GRABBED).

    • -
    • always_on_top (bool) -- Create a window that is always presented above -others.

    • -
    • utility (bool) -- Create a window that doesn't appear in the task bar.

    • -
    -
    -
    -

    Event behavior if one Window is created: When the close button is pressed, -the QUIT event will be sent to the event queue.

    -
    import pygame
    -
    -window = pygame.Window()
    -
    -while True:
    -for event in pygame.event.get():
    -    if event.type == pygame.QUIT:
    -        pygame.quit()
    -        raise SystemExit
    -
    -
    -

    Event behavior if multiple windows are created: When the close button is -pressed, a WINDOWCLOSE event is sent. You need to explicitly destroy -the window. Note that the event QUIT will only be sent if all -windows have been destroyed.

    -
    import pygame
    -
    -window1 = pygame.Window(position=(0,100))
    -window2 = pygame.Window(position=(700,100))
    -
    -while True:
    -for event in pygame.event.get():
    -    if event.type == pygame.WINDOWCLOSE:
    -        id = event.window.id
    -        print(f"WINDOWCLOSE event sent to Window #{id}.")
    -        event.window.destroy()
    -
    -    if event.type == pygame.QUIT:
    -        print(f"Last window is destroyed. QUIT event was sent.")
    -        pygame.quit()
    -        raise SystemExit
    -
    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    -

    Changed in pygame-ce 2.5.0: when opengl is True, the Window has an OpenGL context created by pygame

    -
    -
    -

    Changed in pygame-ce 2.5.1: Window is now a base class, allowing subclassing

    -
    -
    -
    -grab_mouse: bool
    -
    -
    Get or set the window's mouse grab mode.
    -
    grab_mouse -> bool
    -
    -

    When this attribute is set to True, the window will try to confine the mouse -cursor to itself.

    -

    Note this only set the "mode" of grab. The mouse may be confined to another window -depending on the window focus. To get if the mouse is currently restricted to this -window, please use mouse_grabbed.

    -
    -

    See also

    -

    mouse_grabbed

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -grab_keyboard: bool
    -
    -
    Get or set the window's keyboard grab mode.
    -
    grab_keyboard -> bool
    -
    -

    When this attribute is set to True, the window will try to capture system -keyboard shortcuts like Alt+Tab or the Meta/Super key.

    -

    This attribute only set the "mode" of grab. The keyboard may be captured by -another window depending on the window focus. To get if keyboard is currently -captured by this window, please use keyboard_grabbed.

    -

    Note that not all system keyboard shortcuts can be captured by applications -(one example is Ctrl+Alt+Del on Windows).

    -

    When keyboard grab is enabled, pygame will continue to handle Alt+Tab when -the window is full-screen to ensure the user is not trapped in your application. -If you have a custom keyboard shortcut to exit fullscreen mode, you may suppress -this behavior with an environment variable, e.g. -os.environ["SDL_ALLOW_ALT_TAB_WHILE_GRABBED"] = "0".

    -

    This attribute requires SDL 2.0.16+.

    -
    -

    See also

    -

    keyboard_grabbed

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -property mouse_grabbed: bool
    -
    -
    Get if the mouse cursor is confined to the window (**read-only**).
    -
    mouse_grabbed -> bool
    -
    -

    Get if the mouse cursor is currently grabbed and confined to the window.

    -

    Roughly equivalent to this expression:

    -
    win.grab_mouse and (win is get_grabbed_window())
    -
    -
    -
    -

    See also

    -

    grab_mouse

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -property keyboard_grabbed: bool
    -
    -
    Get if the keyboard shortcuts are captured by the window (**read-only**).
    -
    keyboard_grabbed -> bool
    -
    -

    Get if the keyboard shortcuts are currently grabbed and captured by the window.

    -

    Roughly equivalent to this expression:

    -
    win.grab_keyboard and (win is get_grabbed_window())
    -
    -
    -

    This attribute requires SDL 2.0.16+.

    -
    -

    See also

    -

    grab_keyboard

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -property focused: bool
    -
    -
    Get if the window is focused (**read-only**).
    -
    focused -> bool
    -
    -

    Get if the window is currently focused. The same result can be achieved using -the WINDOWFOCUSGAINED and WINDOWFOCUSLOST events.

    -

    Use focus() to focus and raise the window.

    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    -
    -title: str
    -
    -
    Get or set the window title.
    -
    title -> str
    -
    -

    An empty string means that no title is set.

    -
    - -
    -
    -resizable: bool
    -
    -
    Get or set whether the window is resizable.
    -
    resizable -> bool
    -
    -
    - -
    -
    -borderless: bool
    -
    -
    Gets or sets whether the window is borderless.
    -
    borderless -> bool
    -
    -
    -

    Note

    -

    You can't change the border state of a fullscreen window.

    -
    -
    - -
    -
    -always_on_top: bool
    -
    -
    Get or set whether the window is always on top.
    -
    always_on_top -> bool
    -
    -

    Setting the always-on-top mode requires SDL 2.0.16+.

    -
    -

    Note

    -

    Setting this property is not supported on some video drivers (like wayland) -and a pygame.errorstandard pygame exception exception may be raised in such cases.

    -
    -
    -

    New in pygame-ce 2.3.1.

    -
    -
    - -
    -
    -property id: int
    -
    -
    Get the unique window ID (**read-only**).
    -
    id -> int
    -
    -
    - -
    -
    -property mouse_rect: pygame.rect.Rect | None
    -
    -
    Get or set the mouse confinement rectangle of the window.
    -
    mouse_rect -> Rect | None
    -
    -

    Setting this attribute to a rect-like object confines the -cursor to the specified area of this window.

    -

    This attribute can be None, meaning that there is no mouse rect.

    -

    Note that this does NOT grab the cursor, it only defines the area a -cursor is restricted to when the window has mouse focus.

    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -property size: tuple[int, int]
    -
    -
    Get or set the window size in pixels.
    -
    size -> tuple[int, int]
    -
    -
    - -
    -
    -property minimum_size: tuple[int, int]
    -
    -
    Get or set the minimum size of the window's client area.
    -
    minimum_size -> tuple[int, int]
    -
    -

    Initial value in most cases is (0, 0). If from_display_module() -was used to create the window and pygame.display.set_mode()Initialize a window or screen for display. was -called with the SCALED flag, the initial value is the size used in -that call.

    -

    Raises a ValueError if negative values are provided or -if the width or height provided are greater than set -maximum width or height respectively. Unless maximum size -is (0, 0) (initial value).

    -
    -

    See also

    -

    maximum_size.

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -property maximum_size: tuple[int, int]
    -
    -
    Get or set the maximum size of the window's client area.
    -
    maximum_size -> tuple[int, int]
    -
    -

    Initial value is (0, 0).

    -

    Raises a ValueError if negative values are provided or -if the width or height provided are less than set minimum -width or height respectively.

    -
    -

    See also

    -

    minimum_size.

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -property position: tuple[int, int]
    -
    -
    Get or set the window position in screen coordinates.
    -
    position -> tuple[int, int]
    -
    -

    The position may be a tuple of (x, y) coordinates or WINDOWPOS_CENTERED or -WINDOWPOS_UNDEFINED. The origin is the topleft of the main display.

    -
    -

    Note

    -

    Setting this property is not supported on some video drivers (like wayland) -and a pygame.errorstandard pygame exception exception may be raised in such cases.

    -
    -
    - -
    -
    -opacity: float
    -
    -
    Get or set the window opacity, between 0.0 (fully transparent) and 1.0 (fully opaque).
    -
    opacity -> float
    -
    -
    -

    Note

    -

    Setting this property is not supported on some video drivers (like wayland) -and a pygame.errorstandard pygame exception exception may be raised in such cases.

    -
    -
    - -
    -
    -property opengl: bool
    -
    -
    Get if the window supports OpenGL.
    -
    opengl -> bool
    -
    -

    True if the Window has an OpenGL context associated with it, False otherwise

    -
    -

    New in pygame-ce 2.5.0.

    -
    -
    - -
    -
    -property handle: int
    -
    -
    Get the window handle provided by the window manager if supported otherwise 0
    -
    handle -> int
    -
    -

    Returns the window handle provided by the window manager as an integer. If the operating -system is not supported or the window manager hides the handle the sentinel 0 is returned.

    -

    The handle is generally available with Windows, X11 (Linux), Cocoa (MacOS), UIKit (iOS), -Android and Vivante while unavailable under Wayland and everything else.

    -
    -

    New in pygame-ce 2.5.8.

    -
    -
    - -
    -
    -property utility: bool
    -
    -
    Get if the window is an utility window (**read-only**).
    -
    utility -> bool
    -
    -

    True if the window doesn't appear in the task bar, False otherwise. -This only works for X11 and Windows, for other platforms, creating Window(utility=True) won't change anything.

    -
    -

    New in pygame-ce 2.5.3.

    -
    -
    - -
    -
    -classmethod from_display_module()
    -
    -
    Create a Window object using window data from display module.
    -
    from_display_module() -> Window
    -
    -

    DON'T USE THIS! If you want to draw to a surface and use the window -API, use Window.get_surface() and Window.flip().

    -

    Create a Window object that uses the same window data from the pygame.displayPygame module to control the display window and screen. module, created upon calling -pygame.display.set_mode()Initialize a window or screen for display..

    -
    -

    Deprecated since pygame-ce 2.4.0.

    -
    -
    - -
    -
    -get_surface()
    -
    -
    Get the window surface.
    -
    get_surface() -> Surface
    -
    -

    Returns a "display surface" for this Window. The surface returned is -analogous to the surface returned by pygame.display.set_mode()Initialize a window or screen for display..

    -

    This method allows software rendering (classic pygame rendering) on top -of the Window API. This method should not be called when using hardware -rendering (coming soon).

    -

    Similarly to the "display surface" returned by pygame.displayPygame module to control the display window and screen., -this surface will change size with the Window, and will become invalid -after the Window's destruction.

    -
    -

    See also

    -

    flip()

    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -flip()
    -
    -
    Update the display surface to the window.
    -
    flip() -> None
    -
    -

    Update pixel data from memory to be displayed in the window. This is the Window -class equivalent of pygame.display.flip()Update the full display Surface to the screen..

    -

    With get_surface() this method allows software rendering (classic pygame rendering) flipping pixel data -from an associated surface in memory to be displayed in the window. Alternatively, when this window has an -associated OpenGL context, this method will instead perform a GL buffer swap to the window.

    -

    Here is a runnable example of using get_surface and flip:

    -
    import pygame
    -
    -win = pygame.Window()
    -surf = win.get_surface()  # get the window surface
    -
    -while True:
    -   for event in pygame.event.get():
    -      if event.type == pygame.QUIT:
    -            pygame.quit()
    -            raise SystemExit
    -
    -   # draw something on the surface
    -   surf.fill("red")
    -
    -   win.flip()  # update the surface to the window
    -
    -
    -
    -

    New in pygame-ce 2.4.0.

    -
    -
    - -
    -
    -set_windowed()
    -
    -
    Enable windowed mode (exit fullscreen).
    -
    set_windowed() -> None
    -
    -
    -

    See also

    -

    set_fullscreen()

    -
    -
    - -
    -
    -set_fullscreen()
    -
    -
    Enter fullscreen.
    -
    set_fullscreen(desktop=False) -> None
    -
    -
    -
    Parameters:
    -

    desktop (bool) -- If True, use the current desktop resolution. -If False, change the fullscreen resolution to the window size.

    -
    -
    -
    -

    See also

    -

    set_windowed().

    -
    -
    - -
    -
    -destroy()
    -
    -
    Destroy the window.
    -
    destroy() -> None
    -
    -

    Destroys the internal window data of this Window object. This method is -called automatically when this Window object is garbage collected, so -there usually aren't any reasons to call it manually.

    -

    Other methods that try to manipulate that window data will raise an error.

    -
    - -
    -
    -hide()
    -
    -
    Hide the window.
    -
    hide() -> None
    -
    -
    - -
    -
    -show()
    -
    -
    Show the window.
    -
    show() -> None
    -
    -
    - -
    -
    -focus()
    -
    -
    Set the window to be focused.
    -
    focus(input_only=False) -> None
    -
    -

    Raises the window above other windows and sets the input focus.

    -
    -
    Parameters:
    -

    input_only -- if True, the window will be given input focus -but may be completely obscured by other windows. -Only supported on X11. This has been deprecated and -may be removed in a future version.

    -
    -
    -
    -

    Deprecated since pygame-ce 2.5.3: input_only argument

    -
    -
    - -
    -
    -restore()
    -
    -
    Restore the size and position of a minimized or maximized window.
    -
    restore() -> None
    -
    -
    - -
    -
    -maximize()
    -
    -
    Maximize the window.
    -
    maximize() -> None
    -
    -
    - -
    -
    -minimize()
    -
    -
    Minimize the window.
    -
    minimize() -> None
    -
    -
    - -
    -
    -set_icon()
    -
    -
    Set the window icon.
    -
    set_icon(icon, /) -> None
    -
    -
    -
    Parameters:
    -

    surface (Surface) -- A Surface to use as the icon.

    -
    -
    -
    - -
    -
    -set_modal_for()
    -
    -
    Set the window as a modal for a parent window.
    -
    set_modal_for(parent, /) -> None
    -
    -
    -
    Parameters:
    -

    parent (Window) -- The parent window.

    -
    -
    -
    -

    Note

    -

    This function is only supported on X11.

    -
    -
    - -
    -
    -flash()
    -
    -
    Flash a window to demand attention from the user.
    -
    flash(operation, /) -> None
    -
    -
    -
    Parameters:
    -

    operation (int) -- The flash operation.

    -
    -
    -
    -
    Supported flash operations are:
      -
    • pygame.FLASH_CANCEL: Cancel the current flash state if present

    • -
    • pygame.FLASH_BRIEFLY: Flash for a short amount of time to get attention

    • -
    • pygame.FLASH_UNTIL_FOCUSED: Keep flashing until the window is focused

    • -
    -
    -
    -

    Window flashing requires SDL 2.0.16+. A pygame.errorstandard pygame exception exception will be raised -otherwise.

    -
    -

    Note

    -

    This function is only supported on Windows, X11, Wayland and Cocoa (MacOS). -A pygame.errorstandard pygame exception exception will be raised if it's not supported therefore it's -advised to wrap it in a try block.

    -
    import pygame
    -window = pygame.Window()
    -
    -try:
    -    window.flash(pygame.FLASH_BRIEFLY)
    -except pygame.error:
    -    print("Window flashing not supported")
    -
    -
    -
    -
    -

    New in pygame-ce 2.5.2.

    -
    -
    - -
    - -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/search.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/search.html index 9aae0f3..e280cca 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/search.html +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/search.html @@ -4,15 +4,13 @@ - Search — pygame-ce v2.5.8 documentation - - - + Search — pygame v2.6.1 documentation + + - - + + - @@ -32,7 +30,7 @@
  • modules |
  • - +
    @@ -83,12 +81,12 @@
  • modules |
  • - + \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/searchindex.js b/.venv/lib/python3.14/site-packages/pygame/docs/generated/searchindex.js index bacc127..25a9c34 100644 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/searchindex.js +++ b/.venv/lib/python3.14/site-packages/pygame/docs/generated/searchindex.js @@ -1 +1 @@ -Search.setIndex({"alltitles": {"1. Introduction": [[69, "introduction"]], "1.1. A note on coding styles": [[69, "a-note-on-coding-styles"]], "2. Revision: Pygame fundamentals": [[73, "makegames-2"]], "2.1. The basic Pygame game": [[73, "the-basic-pygame-game"]], "2.2. Basic Pygame objects": [[73, "basic-pygame-objects"]], "2.3. Blitting": [[73, "blitting"]], "2.4. The event loop": [[73, "the-event-loop"]], "2.5. Ta-da!": [[73, "ta-da"]], "3. Kicking things off": [[74, "makegames-3"]], "3.1. The first lines, and loading modules": [[74, "the-first-lines-and-loading-modules"]], "3.2. Resource handling functions": [[74, "resource-handling-functions"]], "4. Game object classes": [[75, "makegames-4"]], "4.1. A simple ball class": [[75, "a-simple-ball-class"]], "4.1.1. Diversion 1: Sprites": [[75, "diversion-1-sprites"]], "4.1.2. Diversion 2: Vector physics": [[75, "diversion-2-vector-physics"]], "5. User-controllable objects": [[76, "makegames-5"]], "5.1. A simple bat class": [[76, "a-simple-bat-class"]], "5.1.1. Diversion 3: Pygame events": [[76, "diversion-3-pygame-events"]], "6. Putting it all together": [[77, "makegames-6"]], "6.1. Let the ball hit sides": [[77, "let-the-ball-hit-sides"]], "6.2. Let the ball hit bats": [[77, "let-the-ball-hit-bats"]], "6.3. The Finished product": [[77, "the-finished-product"]], "A Newbie Guide to pygame": [[71, "a-newbie-guide-to-pygame"]], "API exported by pygame._freetype": [[6, null]], "API exported by pygame.display": [[4, null]], "API exported by pygame.event": [[5, null]], "API exported by pygame.joystick": [[7, null]], "API exported by pygame.mixer": [[8, null]], "API exported by pygame.rwobject": [[10, null]], "API exported by pygame.surflock": [[13, null]], "API exported by pygame.version": [[14, null]], "Actualizar los Sprites": [[78, "actualizar-los-sprites"]], "Adding the User Input": [[70, "adding-the-user-input"]], "Basic Computer Vision": [[65, "basic-computer-vision"]], "Be wary of outdated, obsolete, and optional advice.": [[71, "be-wary-of-outdated-obsolete-and-optional-advice"]], "Bucle principal (Main Loop)": [[78, "bucle-principal-main-loop"]], "CLOSING": [[66, "closing"]], "Camera Module Introduction": [[65, "camera-module-introduction"]], "Capturing a Live Stream": [[65, "capturing-a-live-stream"]], "Capturing a Single Image": [[65, "capturing-a-single-image"]], "Carga de Recursos": [[78, "carga-de-recursos"]], "Centrar Texto en el Fondo": [[78, "centrar-texto-en-el-fondo"]], "Changing The Background": [[70, "changing-the-background"]], "Chimpanc\u00e9, L\u00ednea Por L\u00ednea": [[78, "chimpance-linea-por-linea"]], "Clases de Objetos para Juegos": [[78, "clases-de-objetos-para-juegos"]], "Class BufferProxy API exported by pygame.bufferproxy": [[2, null]], "Class Color API exported by pygame.color": [[3, null]], "Class Rect API exported by pygame.rect": [[9, null]], "Class Surface API exported by pygame.surface": [[12, null]], "Class Window API exported by pygame.window": [[15, null]], "Collision Detection": [[67, "collision-detection"]], "Colorkey vs. Alpha.": [[71, "colorkey-vs-alpha"]], "Colorspaces": [[65, "colorspaces"]], "Common Controller Axis Mappings": [[33, "common-controller-axis-mappings"]], "Common Problems": [[67, "common-problems"]], "Crear el Fondo": [[78, "crear-el-fondo"]], "Create The Background": [[62, "create-the-background"]], "Creating A Map": [[70, "creating-a-map"]], "Definition: \"blit\"": [[70, "definition-blit"]], "Dibujar la Escena Completa": [[78, "dibujar-la-escena-completa"]], "Display The Background While Setup Finishes": [[62, "display-the-background-while-setup-finishes"]], "Do things the pythony way.": [[71, "do-things-the-pythony-way"]], "Documents": [[17, "documents"]], "Don't bother with pixel-perfect collision detection.": [[71, "don-t-bother-with-pixel-perfect-collision-detection"]], "Don't get distracted by side issues.": [[71, "don-t-get-distracted-by-side-issues"]], "Draw The Entire Scene": [[62, "draw-the-entire-scene"]], "Examples": [[63, "examples"], [68, "examples"]], "Experimental modules": [[17, "experimental-modules"]], "Extending Your Own Classes (Advanced)": [[67, "extending-your-own-classes-advanced"]], "File Path Function Arguments": [[16, null]], "Fin del Juego": [[78, "fin-del-juego"]], "First, The Mystery Functions": [[70, "first-the-mystery-functions"]], "Functions": [[63, "functions"]], "Game Object Classes": [[62, "game-object-classes"]], "Game Over": [[62, "game-over"]], "Game object classes": [[75, null]], "Get comfortable working in Python.": [[71, "get-comfortable-working-in-python"]], "Going From The List To The Screen": [[70, "going-from-the-list-to-the-screen"]], "Graduation": [[68, "graduation"]], "HISTORY": [[66, "history"]], "Handle All Input Events": [[62, "handle-all-input-events"]], "Handling Some Input": [[70, "handling-some-input"]], "Help! How Do I Move An Image?": [[70, "help-how-do-i-move-an-image"]], "High level API exported by pygame.base": [[1, null]], "History Lesson": [[67, "history-lesson"]], "How to Decide": [[63, "how-to-decide"]], "How to use Premultiplied Alpha blending": [[72, "how-to-use-premultiplied-alpha-blending"]], "Import": [[64, "import"]], "Import Modules": [[62, "import-modules"]], "Import Surfarray": [[68, "import-surfarray"]], "Import and Init": [[65, "import-and-init"]], "Import and Initialize": [[64, "import-and-initialize"]], "Importaci\u00f3n de M\u00f3dulos": [[78, "importacion-de-modulos"]], "Inicializar Todo": [[78, "inicializar-todo"]], "Init": [[64, "init"]], "Initialize Everything": [[62, "initialize-everything"]], "Introducci\u00f3n": [[78, "introduccion"]], "Introduction": [[62, "introduction"], [63, "introduction"], [68, "introduction"]], "Introduction to Alpha Composition": [[72, "introduction-to-alpha-composition"]], "Just Pixels On The Screen": [[70, "just-pixels-on-the-screen"]], "Kicking things off": [[74, null]], "Know what a surface is.": [[71, "know-what-a-surface-is"]], "Let's Go Back A Step": [[70, "let-s-go-back-a-step"]], "Line By Line Chimp": [[62, "line-by-line-chimp"]], "Listing Connected Cameras": [[65, "listing-connected-cameras"]], "Loading Resources": [[62, "loading-resources"]], "Main Loop": [[62, "main-loop"]], "Making Games With Pygame": [[69, null], [69, "id1"]], "Making The Hero Move": [[70, "making-the-hero-move"]], "Making The Hero Move (Take 2)": [[70, "making-the-hero-move-take-2"]], "Managing the event subsystem.": [[71, "managing-the-event-subsystem"]], "Manejar los Eventos de Entrada": [[78, "manejar-los-eventos-de-entrada"]], "Mixing Them Together": [[67, "mixing-them-together"]], "More Advanced NumPy": [[68, "more-advanced-numpy"]], "Mostrar el Fondo mientras Termina el Setup": [[78, "mostrar-el-fondo-mientras-termina-el-setup"]], "Moving Multiple Images": [[70, "moving-multiple-images"]], "Named Colors": [[22, null]], "Newbie Guide to Pygame": [[71, null]], "Nintendo Switch Left Joy-Con (pygame 2.x)": [[33, "nintendo-switch-left-joy-con-pygame-2-x"]], "Nintendo Switch Left/Right Joy-Con (after SDL 2.24.0)": [[33, "nintendo-switch-left-right-joy-con-after-sdl-2-24-0"]], "Nintendo Switch Pro Controller (pygame 2.x)": [[33, "nintendo-switch-pro-controller-pygame-2-x"]], "Nintendo Switch Right Joy-Con (pygame 2.x)": [[33, "nintendo-switch-right-joy-con-pygame-2-x"]], "Numeric Python": [[68, "numeric-python"]], "Other Surfarray Functions": [[68, "other-surfarray-functions"]], "PYTHON AND GAMING": [[66, "python-and-gaming"]], "Playstation 4 Controller (pygame 1.x)": [[33, "playstation-4-controller-pygame-1-x"]], "Playstation 4 Controller (pygame 2.x)": [[33, "playstation-4-controller-pygame-2-x"]], "Preparar Objetos del Juego": [[78, "preparar-objetos-del-juego"]], "Prepare Game Object": [[62, "prepare-game-object"]], "Preparing for Improved User Input": [[70, "preparing-for-improved-user-input"]], "Put Text On The Background, Centered": [[62, "put-text-on-the-background-centered"]], "Putting It All Together": [[70, "putting-it-all-together"]], "Putting it all Together One More time": [[70, "putting-it-all-together-one-more-time"]], "Putting it all together": [[77, null]], "Pygame CE Logos": [[18, "pygame-ce-logos"]], "Pygame CE Logos Page": [[18, null]], "Pygame Intro": [[66, null]], "Pygame Modules Overview": [[66, "pygame-modules-overview"]], "Pygame Tutorials - Camera Module Introduction": [[65, null]], "Pygame Tutorials - Help! How Do I Move An Image?": [[70, null]], "Pygame Tutorials - Import and Initialize": [[64, null]], "Pygame Tutorials - Line By Line Chimp Example": [[62, null]], "Pygame Tutorials - Setting Display Modes": [[63, null]], "Pygame Tutorials - Sprite Module Introduction": [[67, null]], "Pygame Tutorials - Surfarray Introduction": [[68, null]], "Pygame Tutorials - What is Premultiplied Alpha?": [[72, null]], "Pygame-ce Front Page": [[17, null]], "Python Pygame Introduction": [[66, "python-pygame-introduction"]], "Quick start": [[17, "quick-start"]], "Quit": [[64, "quit"]], "Recognize which parts of pygame you really need.": [[71, "recognize-which-parts-of-pygame-you-really-need"]], "Rects are your friends.": [[71, "rects-are-your-friends"]], "Reference": [[17, "reference"]], "Revision: Pygame fundamentals": [[73, null]], "Screen Coordinates": [[70, "screen-coordinates"]], "Setting Basics": [[63, "setting-basics"]], "Setting Display Modes": [[63, "setting-display-modes"]], "Slots and c_api - Making functions and data available from other modules": [[11, null]], "Smooth Movement": [[70, "smooth-movement"]], "So, What Next?": [[70, "so-what-next"]], "Software architecture, design patterns, and games.": [[71, "software-architecture-design-patterns-and-games"]], "Special Flags List": [[50, "special-flags-list"]], "Sprite Module Introduction": [[67, "sprite-module-introduction"]], "Surface Locking": [[68, "surface-locking"]], "Surfarray Introduction": [[68, "surfarray-introduction"], [68, "id1"]], "TASTE": [[66, "taste"]], "Table of Contents": [[69, "table-of-contents"]], "The Classes": [[67, "the-classes"]], "The Group Class": [[67, "the-group-class"]], "The Many Group Types": [[67, "the-many-group-types"]], "The Rendering Groups": [[67, "the-rendering-groups"]], "The Sprite Class": [[67, "the-sprite-class"]], "Thresholding": [[65, "thresholding"]], "Transparency": [[68, "transparency"]], "Tutorial de Pygame - Ejemplo del Chimpanc\u00e9, L\u00ednea Por L\u00ednea": [[78, null]], "Tutorials": [[17, "tutorials"]], "Update the Sprites": [[62, "update-the-sprites"]], "Upstream & legacy logos": [[18, "upstream-legacy-logos"]], "Use Surface.convert().": [[71, "use-surface-convert"]], "User-controllable objects": [[76, null]], "Using Camera Controls": [[65, "using-camera-controls"]], "Using the Mask Module": [[65, "using-the-mask-module"]], "What Are Special Flags?": [[50, "what-are-special-flags"]], "What is Premultiplied Alpha?": [[72, "what-is-premultiplied-alpha"]], "Why would you use premultiplied alpha?": [[72, "why-would-you-use-premultiplied-alpha"]], "XBox 360 Controller (pygame 1.x)": [[33, "xbox-360-controller-pygame-1-x"]], "XBox 360 Controller (pygame 2.x)": [[33, "xbox-360-controller-pygame-2-x"]], "You Are On Your Own From Here": [[70, "you-are-on-your-own-from-here"]], "pygame C API": [[0, null]], "pygame.BufferProxypygame object to export a surface buffer through an array protocol": [[19, null]], "pygame.ColorPygame object for color representations.": [[21, null]], "pygame.PixelArraypygame object for direct pixel access of surfaces": [[42, null]], "pygame.Rectpygame object for storing rectangular coordinates": [[45, null]], "pygame.SurfacePygame object for representing images.": [[52, null]], "pygame.WindowPygame object that represents a window.": [[60, null]], "pygame._sdl2.controllerPygame module to work with controllers.": [[47, null]], "pygame._sdl2.touchpygame module to work with touch input": [[57, null]], "pygame.camerapygame module for camera use": [[20, null]], "pygame.cursorsPygame module for cursor resources.": [[23, null]], "pygame.displayPygame module to control the display window and screen.": [[24, null]], "pygame.drawPygame module for drawing shapes.": [[25, null]], "pygame.eventpygame module for interacting with events and queues": [[26, null]], "pygame.examplesmodule of example programs": [[27, null]], "pygame.fontpygame module for loading and rendering fonts": [[28, null]], "pygame.freetypepygame module for loading and rendering computer fonts": [[29, null]], "pygame.geometrypygame module for the Circle, Line, and Polygon objects": [[30, null]], "pygame.gfxdrawpygame module for drawing shapes": [[31, null]], "pygame.imagePygame module for image transfer.": [[32, null]], "pygame.joystickPygame module for interacting with joysticks, gamepads, and trackballs.": [[33, null]], "pygame.keyPygame module to work with the keyboard.": [[34, null]], "pygame.localspygame constants": [[35, null]], "pygame.maskPygame module for image masks.": [[36, null]], "pygame.mathPygame module for vector classes.": [[37, null]], "pygame.midipygame module for interacting with midi input and output.": [[38, null]], "pygame.mixer.musicpygame module for controlling streamed audio": [[41, null]], "pygame.mixerpygame module for loading and playing sounds": [[39, null]], "pygame.mousePygame module to work with the mouse.": [[40, null]], "pygame.pixelcopyPygame module for general pixel array copying.": [[43, null]], "pygame.scrappygame module for clipboard support.": [[46, null]], "pygame.sdl2_video": [[48, null]], "pygame.sndarrayPygame module for accessing sound sample data.": [[49, null]], "pygame.spritepygame module with basic game object classes": [[51, null]], "pygame.surfarraypygame module for accessing surface pixel data using array interfaces": [[53, null]], "pygame.systemPygame module to provide additional context about the system.": [[54, null]], "pygame.testsPygame unit test suite package": [[55, null]], "pygame.timePygame module for monitoring time.": [[56, null]], "pygame.transformPygame module to transform surfaces.": [[58, null]], "pygame.typingpygame module providing common typehints": [[59, null]], "pygame.versionsmall module containing version information": [[44, "module-pygame.version"]], "pygame/examples/chimp.py": [[61, null]], "pygamethe top level pygame package": [[44, null]], "special flags": [[50, null]], "src_c/_freetype.c": [[6, "src-c-freetype-c"]], "src_c/base.c": [[1, "src-c-base-c"]], "src_c/bufferproxy.c": [[2, "src-c-bufferproxy-c"]], "src_c/color.c": [[3, "src-c-color-c"]], "src_c/display.c": [[4, "src-c-display-c"]], "src_c/event.c": [[5, "src-c-event-c"]], "src_c/joystick.c": [[7, "src-c-joystick-c"]], "src_c/mixer.c": [[8, "src-c-mixer-c"]], "src_c/rect.c": [[9, "src-c-rect-c"]], "src_c/rwobject.c": [[10, "src-c-rwobject-c"]], "src_c/surface.c": [[12, "src-c-surface-c"]], "src_c/surflock.c": [[13, "src-c-surflock-c"]], "src_c/window.c": [[15, "src-c-window-c"]], "src_py/version.py": [[14, "src-py-version-py"]]}, "docnames": ["c_api", "c_api/base", "c_api/bufferproxy", "c_api/color", "c_api/display", "c_api/event", "c_api/freetype", "c_api/joystick", "c_api/mixer", "c_api/rect", "c_api/rwobject", "c_api/slots", "c_api/surface", "c_api/surflock", "c_api/version", "c_api/window", "filepaths", "index", "logos", "ref/bufferproxy", "ref/camera", "ref/color", "ref/color_list", "ref/cursors", "ref/display", "ref/draw", "ref/event", "ref/examples", "ref/font", "ref/freetype", "ref/geometry", "ref/gfxdraw", "ref/image", "ref/joystick", "ref/key", "ref/locals", "ref/mask", "ref/math", "ref/midi", "ref/mixer", "ref/mouse", "ref/music", "ref/pixelarray", "ref/pixelcopy", "ref/pygame", "ref/rect", "ref/scrap", "ref/sdl2_controller", "ref/sdl2_video", "ref/sndarray", "ref/special_flags_list", "ref/sprite", "ref/surface", "ref/surfarray", "ref/system", "ref/tests", "ref/time", "ref/touch", "ref/transform", "ref/typing", "ref/window", "tutorials/chimp.py", "tutorials/en/chimp-explanation", "tutorials/en/display-modes", "tutorials/en/import-init", "tutorials/en/intro-to-camera", "tutorials/en/intro-to-pygame", "tutorials/en/intro-to-sprites", "tutorials/en/intro-to-surfarray", "tutorials/en/make-games", "tutorials/en/move-it", "tutorials/en/newbie-guide", "tutorials/en/premultiplied-alpha", "tutorials/en/tom-games2", "tutorials/en/tom-games3", "tutorials/en/tom-games4", "tutorials/en/tom-games5", "tutorials/en/tom-games6", "tutorials/es/ChimpanceLineaporLinea"], "envversion": {"sphinx": 64, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["c_api.rst", "c_api/base.rst", "c_api/bufferproxy.rst", "c_api/color.rst", "c_api/display.rst", "c_api/event.rst", "c_api/freetype.rst", "c_api/joystick.rst", "c_api/mixer.rst", "c_api/rect.rst", "c_api/rwobject.rst", "c_api/slots.rst", "c_api/surface.rst", "c_api/surflock.rst", "c_api/version.rst", "c_api/window.rst", "filepaths.rst", "index.rst", "logos.rst", "ref/bufferproxy.rst", "ref/camera.rst", "ref/color.rst", "ref/color_list.rst", "ref/cursors.rst", "ref/display.rst", "ref/draw.rst", "ref/event.rst", "ref/examples.rst", "ref/font.rst", "ref/freetype.rst", "ref/geometry.rst", "ref/gfxdraw.rst", "ref/image.rst", "ref/joystick.rst", "ref/key.rst", "ref/locals.rst", "ref/mask.rst", "ref/math.rst", "ref/midi.rst", "ref/mixer.rst", "ref/mouse.rst", "ref/music.rst", "ref/pixelarray.rst", "ref/pixelcopy.rst", "ref/pygame.rst", "ref/rect.rst", "ref/scrap.rst", "ref/sdl2_controller.rst", "ref/sdl2_video.rst", "ref/sndarray.rst", "ref/special_flags_list.rst", "ref/sprite.rst", "ref/surface.rst", "ref/surfarray.rst", "ref/system.rst", "ref/tests.rst", "ref/time.rst", "ref/touch.rst", "ref/transform.rst", "ref/typing.rst", "ref/window.rst", "tutorials/chimp.py.rst", "tutorials/en/chimp-explanation.rst", "tutorials/en/display-modes.rst", "tutorials/en/import-init.rst", "tutorials/en/intro-to-camera.rst", "tutorials/en/intro-to-pygame.rst", "tutorials/en/intro-to-sprites.rst", "tutorials/en/intro-to-surfarray.rst", "tutorials/en/make-games.rst", "tutorials/en/move-it.rst", "tutorials/en/newbie-guide.rst", "tutorials/en/premultiplied-alpha.rst", "tutorials/en/tom-games2.rst", "tutorials/en/tom-games3.rst", "tutorials/en/tom-games4.rst", "tutorials/en/tom-games5.rst", "tutorials/en/tom-games6.rst", "tutorials/es/ChimpanceLineaporLinea.rst"], "indexentries": {"__dict__ (pygame.event.event attribute)": [[26, "pygame.event.Event.__dict__", false]], "_pixels_address (pygame.surface property)": [[52, "pygame.Surface._pixels_address", false]], "a (pygame.color attribute)": [[21, "pygame.Color.a", false]], "a (pygame.line attribute)": [[30, "pygame.Line.a", false]], "aacircle() (in module pygame.draw)": [[25, "pygame.draw.aacircle", false]], "aacircle() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.aacircle", false]], "aaellipse() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.aaellipse", false]], "aaline() (in module pygame.draw)": [[25, "pygame.draw.aaline", false]], "aalines() (in module pygame.draw)": [[25, "pygame.draw.aalines", false]], "aapolygon() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.aapolygon", false]], "aatrigon() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.aatrigon", false]], "abort() (pygame.midi.output method)": [[38, "pygame.midi.Output.abort", false]], "add() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.add", false]], "add() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.add", false]], "add() (pygame.sprite.sprite method)": [[51, "pygame.sprite.Sprite.add", false]], "aliens.main() (in module pygame.examples)": [[27, "pygame.examples.aliens.main", false]], "align (pygame.font.font attribute)": [[28, "pygame.font.Font.align", false]], "alive() (pygame.sprite.sprite method)": [[51, "pygame.sprite.Sprite.alive", false]], "alpha (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.alpha", false]], "alpha (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.alpha", false]], "always_on_top (pygame.window attribute)": [[60, "pygame.Window.always_on_top", false]], "angle (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.angle", false]], "angle (pygame.math.vector2 attribute)": [[37, "pygame.math.Vector2.angle", false]], "angle() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.angle", false]], "angle_rad (pygame.math.vector2 attribute)": [[37, "pygame.math.Vector2.angle_rad", false]], "angle_to() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.angle_to", false]], "angle_to() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.angle_to", false]], "antialiased (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.antialiased", false]], "arc() (in module pygame.draw)": [[25, "pygame.draw.arc", false]], "arc() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.arc", false]], "area (pygame.circle attribute)": [[30, "pygame.Circle.area", false]], "array() (in module pygame.sndarray)": [[49, "pygame.sndarray.array", false]], "array2d() (in module pygame.surfarray)": [[53, "pygame.surfarray.array2d", false]], "array3d() (in module pygame.surfarray)": [[53, "pygame.surfarray.array3d", false]], "array_alpha() (in module pygame.surfarray)": [[53, "pygame.surfarray.array_alpha", false]], "array_blue() (in module pygame.surfarray)": [[53, "pygame.surfarray.array_blue", false]], "array_colorkey() (in module pygame.surfarray)": [[53, "pygame.surfarray.array_colorkey", false]], "array_green() (in module pygame.surfarray)": [[53, "pygame.surfarray.array_green", false]], "array_red() (in module pygame.surfarray)": [[53, "pygame.surfarray.array_red", false]], "array_to_surface() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.array_to_surface", false]], "arraydemo.main() (in module pygame.examples)": [[27, "pygame.examples.arraydemo.main", false]], "as_frect() (pygame.circle method)": [[30, "pygame.Circle.as_frect", false]], "as_joystick() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.as_joystick", false]], "as_polar() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.as_polar", false]], "as_rect() (pygame.circle method)": [[30, "pygame.Circle.as_rect", false]], "as_spherical() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.as_spherical", false]], "ascender (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.ascender", false]], "attached() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.attached", false]], "average_color() (in module pygame.transform)": [[58, "pygame.transform.average_color", false]], "average_surfaces() (in module pygame.transform)": [[58, "pygame.transform.average_surfaces", false]], "ax (pygame.line attribute)": [[30, "pygame.Line.ax", false]], "ay (pygame.line attribute)": [[30, "pygame.Line.ay", false]], "b (pygame.color attribute)": [[21, "pygame.Color.b", false]], "b (pygame.line attribute)": [[30, "pygame.Line.b", false]], "bezier() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.bezier", false]], "bgcolor (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.bgcolor", false]], "blend_fill.main() (in module pygame.examples)": [[27, "pygame.examples.blend_fill.main", false]], "blend_mode (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.blend_mode", false]], "blend_mode (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.blend_mode", false]], "blit() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.blit", false]], "blit() (pygame.surface method)": [[52, "pygame.Surface.blit", false]], "blit_array() (in module pygame.surfarray)": [[53, "pygame.surfarray.blit_array", false]], "blit_blends.main() (in module pygame.examples)": [[27, "pygame.examples.blit_blends.main", false]], "blits() (pygame.surface method)": [[52, "pygame.Surface.blits", false]], "bold (pygame.font.font attribute)": [[28, "pygame.font.Font.bold", false]], "borderless (pygame.window attribute)": [[60, "pygame.Window.borderless", false]], "bottom (pygame.circle attribute)": [[30, "pygame.Circle.bottom", false]], "box() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.box", false]], "box_blur() (in module pygame.transform)": [[58, "pygame.transform.box_blur", false]], "bufferproxy (class in pygame)": [[19, "pygame.BufferProxy", false]], "bx (pygame.line attribute)": [[30, "pygame.Line.bx", false]], "by (pygame.line attribute)": [[30, "pygame.Line.by", false]], "camera (class in pygame.camera)": [[20, "pygame.camera.Camera", false]], "camera.main() (in module pygame.examples)": [[27, "pygame.examples.camera.main", false]], "center (pygame.circle attribute)": [[30, "pygame.Circle.center", false]], "centroid() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.centroid", false]], "change_layer() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.change_layer", false]], "change_layer() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.change_layer", false]], "channel (class in pygame.mixer)": [[39, "pygame.mixer.Channel", false]], "chimp.main() (in module pygame.examples)": [[27, "pygame.examples.chimp.main", false]], "chop() (in module pygame.transform)": [[58, "pygame.transform.chop", false]], "circle (class in pygame)": [[30, "pygame.Circle", false]], "circle() (in module pygame.draw)": [[25, "pygame.draw.circle", false]], "circle() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.circle", false]], "circumference (pygame.circle attribute)": [[30, "pygame.Circle.circumference", false]], "clamp() (in module pygame.math)": [[37, "pygame.math.clamp", false]], "clamp() (pygame.rect method)": [[45, "pygame.Rect.clamp", false]], "clamp_ip() (pygame.rect method)": [[45, "pygame.Rect.clamp_ip", false]], "clamp_magnitude() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.clamp_magnitude", false]], "clamp_magnitude() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.clamp_magnitude", false]], "clamp_magnitude_ip() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.clamp_magnitude_ip", false]], "clamp_magnitude_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.clamp_magnitude_ip", false]], "clear() (in module pygame.event)": [[26, "pygame.event.clear", false]], "clear() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.clear", false]], "clear() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.clear", false]], "clear() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.clear", false]], "clear() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.clear", false]], "clip() (pygame.rect method)": [[45, "pygame.Rect.clip", false]], "clipline() (pygame.rect method)": [[45, "pygame.Rect.clipline", false]], "clock (class in pygame.time)": [[56, "pygame.time.Clock", false]], "close() (pygame.midi.input method)": [[38, "pygame.midi.Input.close", false]], "close() (pygame.midi.output method)": [[38, "pygame.midi.Output.close", false]], "close() (pygame.pixelarray method)": [[42, "pygame.PixelArray.close", false]], "cmy (pygame.color attribute)": [[21, "pygame.Color.cmy", false]], "collide_circle() (in module pygame.sprite)": [[51, "pygame.sprite.collide_circle", false]], "collide_circle_ratio() (in module pygame.sprite)": [[51, "pygame.sprite.collide_circle_ratio", false]], "collide_mask() (in module pygame.sprite)": [[51, "pygame.sprite.collide_mask", false]], "collide_rect() (in module pygame.sprite)": [[51, "pygame.sprite.collide_rect", false]], "collide_rect_ratio() (in module pygame.sprite)": [[51, "pygame.sprite.collide_rect_ratio", false]], "collidecircle() (pygame.circle method)": [[30, "pygame.Circle.collidecircle", false]], "collidedict() (pygame.rect method)": [[45, "pygame.Rect.collidedict", false]], "collidedictall() (pygame.rect method)": [[45, "pygame.Rect.collidedictall", false]], "collidelist() (pygame.circle method)": [[30, "pygame.Circle.collidelist", false]], "collidelist() (pygame.rect method)": [[45, "pygame.Rect.collidelist", false]], "collidelistall() (pygame.circle method)": [[30, "pygame.Circle.collidelistall", false]], "collidelistall() (pygame.rect method)": [[45, "pygame.Rect.collidelistall", false]], "collideobjects() (pygame.rect method)": [[45, "pygame.Rect.collideobjects", false]], "collideobjectsall() (pygame.rect method)": [[45, "pygame.Rect.collideobjectsall", false]], "collidepoint() (pygame.circle method)": [[30, "pygame.Circle.collidepoint", false]], "collidepoint() (pygame.rect method)": [[45, "pygame.Rect.collidepoint", false]], "colliderect() (pygame.circle method)": [[30, "pygame.Circle.colliderect", false]], "colliderect() (pygame.rect method)": [[45, "pygame.Rect.colliderect", false]], "collideswith() (pygame.circle method)": [[30, "pygame.Circle.collideswith", false]], "color (class in pygame)": [[21, "pygame.Color", false]], "color (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.color", false]], "color (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.color", false]], "colorlike (in module pygame.typing)": [[59, "pygame.typing.ColorLike", false]], "colorspace() (in module pygame.camera)": [[20, "pygame.camera.colorspace", false]], "compare() (pygame.pixelarray method)": [[42, "pygame.PixelArray.compare", false]], "compile() (in module pygame.cursors)": [[23, "pygame.cursors.compile", false]], "compose_custom_blend_mode() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.compose_custom_blend_mode", false]], "connected_component() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.connected_component", false]], "connected_components() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.connected_components", false]], "contains() (in module pygame.scrap)": [[46, "pygame.scrap.contains", false]], "contains() (pygame.circle method)": [[30, "pygame.Circle.contains", false]], "contains() (pygame.rect method)": [[45, "pygame.Rect.contains", false]], "controller (class in pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.Controller", false]], "convert() (pygame.surface method)": [[52, "pygame.Surface.convert", false]], "convert_alpha() (pygame.surface method)": [[52, "pygame.Surface.convert_alpha", false]], "convolve() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.convolve", false]], "coordinates_from_window() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.coordinates_from_window", false]], "coordinates_to_window() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.coordinates_to_window", false]], "copy() (pygame.circle method)": [[30, "pygame.Circle.copy", false]], "copy() (pygame.cursors.cursor method)": [[23, "pygame.cursors.Cursor.copy", false]], "copy() (pygame.line method)": [[30, "pygame.Line.copy", false]], "copy() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.copy", false]], "copy() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.copy", false]], "copy() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.copy", false]], "copy() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.copy", false]], "copy() (pygame.rect method)": [[45, "pygame.Rect.copy", false]], "copy() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.copy", false]], "copy() (pygame.surface method)": [[52, "pygame.Surface.copy", false]], "correct_gamma() (pygame.color method)": [[21, "pygame.Color.correct_gamma", false]], "count() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.count", false]], "cross() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.cross", false]], "cross() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.cross", false]], "cursor (class in pygame.cursors)": [[23, "pygame.cursors.Cursor", false]], "cursors.main() (in module pygame.examples)": [[27, "pygame.examples.cursors.main", false]], "custom_type() (in module pygame.event)": [[26, "pygame.event.custom_type", false]], "data (pygame.cursors.cursor attribute)": [[23, "pygame.cursors.Cursor.data", false]], "delay() (in module pygame.time)": [[56, "pygame.time.delay", false]], "descender (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.descender", false]], "destroy() (pygame.window method)": [[60, "pygame.Window.destroy", false]], "diameter (pygame.circle attribute)": [[30, "pygame.Circle.diameter", false]], "dirtysprite (class in pygame.sprite)": [[51, "pygame.sprite.DirtySprite", false]], "distance_squared_to() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.distance_squared_to", false]], "distance_squared_to() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.distance_squared_to", false]], "distance_to() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.distance_to", false]], "distance_to() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.distance_to", false]], "dot() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.dot", false]], "dot() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.dot", false]], "draw() (pygame._sdl2.video.image method)": [[48, "pygame._sdl2.video.Image.draw", false]], "draw() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.draw", false]], "draw() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.draw", false]], "draw() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.draw", false]], "draw() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.draw", false]], "draw() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.draw", false]], "draw() (pygame.sprite.renderupdates method)": [[51, "pygame.sprite.RenderUpdates.draw", false]], "draw_blend_mode (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.draw_blend_mode", false]], "draw_color (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.draw_color", false]], "draw_line() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_line", false]], "draw_point() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_point", false]], "draw_quad() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_quad", false]], "draw_quad() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.draw_quad", false]], "draw_rect() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_rect", false]], "draw_triangle() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_triangle", false]], "draw_triangle() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.draw_triangle", false]], "elementwise() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.elementwise", false]], "elementwise() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.elementwise", false]], "ellipse() (in module pygame.draw)": [[25, "pygame.draw.ellipse", false]], "ellipse() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.ellipse", false]], "empty() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.empty", false]], "encode_file_path() (in module pygame)": [[44, "pygame.encode_file_path", false]], "encode_string() (in module pygame)": [[44, "pygame.encode_string", false]], "epsilon (pygame.math.vector2 attribute)": [[37, "pygame.math.Vector2.epsilon", false]], "epsilon (pygame.math.vector3 attribute)": [[37, "pygame.math.Vector3.epsilon", false]], "erase() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.erase", false]], "error": [[44, "pygame.error", false]], "event (class in pygame.event)": [[26, "pygame.event.Event", false]], "event_name() (in module pygame.event)": [[26, "pygame.event.event_name", false]], "eventlist.main() (in module pygame.examples)": [[27, "pygame.examples.eventlist.main", false]], "extract() (pygame.pixelarray method)": [[42, "pygame.PixelArray.extract", false]], "fadeout() (in module pygame.mixer)": [[39, "pygame.mixer.fadeout", false]], "fadeout() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.fadeout", false]], "fadeout() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.fadeout", false]], "fadeout() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.fadeout", false]], "fblits() (pygame.surface method)": [[52, "pygame.Surface.fblits", false]], "fgcolor (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.fgcolor", false]], "filelike (in module pygame.typing)": [[59, "pygame.typing.FileLike", false]], "fill() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.fill", false]], "fill() (pygame.surface method)": [[52, "pygame.Surface.fill", false]], "fill_quad() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.fill_quad", false]], "fill_rect() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.fill_rect", false]], "fill_triangle() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.fill_triangle", false]], "filled_circle() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.filled_circle", false]], "filled_ellipse() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.filled_ellipse", false]], "filled_polygon() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.filled_polygon", false]], "filled_trigon() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.filled_trigon", false]], "find_channel() (in module pygame.mixer)": [[39, "pygame.mixer.find_channel", false]], "fit() (pygame.rect method)": [[45, "pygame.Rect.fit", false]], "fixed_sizes (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.fixed_sizes", false]], "fixed_width (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.fixed_width", false]], "flash() (pygame.window method)": [[60, "pygame.Window.flash", false]], "flip() (in module pygame.display)": [[24, "pygame.display.flip", false]], "flip() (in module pygame.transform)": [[58, "pygame.transform.flip", false]], "flip() (pygame.window method)": [[60, "pygame.Window.flip", false]], "flip_ab() (pygame.line method)": [[30, "pygame.Line.flip_ab", false]], "flip_ab_ip() (pygame.line method)": [[30, "pygame.Line.flip_ab_ip", false]], "flip_x (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.flip_x", false]], "flip_y (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.flip_y", false]], "flood_fill() (in module pygame.draw)": [[25, "pygame.draw.flood_fill", false]], "focus() (pygame.window method)": [[60, "pygame.Window.focus", false]], "focused (pygame.window property)": [[60, "pygame.Window.focused", false]], "font (class in pygame.font)": [[28, "pygame.font.Font", false]], "font (class in pygame.freetype)": [[29, "pygame.freetype.Font", false]], "fonty.main() (in module pygame.examples)": [[27, "pygame.examples.fonty.main", false]], "freetype_misc.main() (in module pygame.examples)": [[27, "pygame.examples.freetype_misc.main", false]], "frequency_to_midi() (in module pygame.midi)": [[38, "pygame.midi.frequency_to_midi", false]], "from_cmy() (pygame.color class method)": [[21, "pygame.Color.from_cmy", false]], "from_display_module() (pygame.window class method)": [[60, "pygame.Window.from_display_module", false]], "from_hex() (pygame.color class method)": [[21, "pygame.Color.from_hex", false]], "from_hsla() (pygame.color class method)": [[21, "pygame.Color.from_hsla", false]], "from_hsva() (pygame.color class method)": [[21, "pygame.Color.from_hsva", false]], "from_i1i2i3() (pygame.color class method)": [[21, "pygame.Color.from_i1i2i3", false]], "from_joystick() (pygame._sdl2.controller.controller static method)": [[47, "pygame._sdl2.controller.Controller.from_joystick", false]], "from_normalized() (pygame.color class method)": [[21, "pygame.Color.from_normalized", false]], "from_polar() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.from_polar", false]], "from_spherical() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.from_spherical", false]], "from_surface() (in module pygame.mask)": [[36, "pygame.mask.from_surface", false]], "from_surface() (pygame._sdl2.video.texture static method)": [[48, "pygame._sdl2.video.Texture.from_surface", false]], "from_threshold() (in module pygame.mask)": [[36, "pygame.mask.from_threshold", false]], "from_window() (pygame._sdl2.video.renderer class method)": [[48, "pygame._sdl2.video.Renderer.from_window", false]], "frombuffer() (in module pygame.image)": [[32, "pygame.image.frombuffer", false]], "frombytes() (in module pygame.image)": [[32, "pygame.image.frombytes", false]], "fromstring() (in module pygame.image)": [[32, "pygame.image.fromstring", false]], "g (pygame.color attribute)": [[21, "pygame.Color.g", false]], "gaussian_blur() (in module pygame.transform)": [[58, "pygame.transform.gaussian_blur", false]], "get() (in module pygame.event)": [[26, "pygame.event.get", false]], "get() (in module pygame.scrap)": [[46, "pygame.scrap.get", false]], "get_abs_offset() (pygame.surface method)": [[52, "pygame.Surface.get_abs_offset", false]], "get_abs_parent() (pygame.surface method)": [[52, "pygame.Surface.get_abs_parent", false]], "get_active() (in module pygame.display)": [[24, "pygame.display.get_active", false]], "get_allow_screensaver() (in module pygame.display)": [[24, "pygame.display.get_allow_screensaver", false]], "get_alpha() (pygame.surface method)": [[52, "pygame.Surface.get_alpha", false]], "get_arraytype() (in module pygame.sndarray)": [[49, "pygame.sndarray.get_arraytype", false]], "get_arraytype() (in module pygame.surfarray)": [[53, "pygame.surfarray.get_arraytype", false]], "get_arraytypes() (in module pygame.sndarray)": [[49, "pygame.sndarray.get_arraytypes", false]], "get_arraytypes() (in module pygame.surfarray)": [[53, "pygame.surfarray.get_arraytypes", false]], "get_ascent() (pygame.font.font method)": [[28, "pygame.font.Font.get_ascent", false]], "get_at() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.get_at", false]], "get_at() (pygame.surface method)": [[52, "pygame.Surface.get_at", false]], "get_at_mapped() (pygame.surface method)": [[52, "pygame.Surface.get_at_mapped", false]], "get_axis() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_axis", false]], "get_axis() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_axis", false]], "get_backends() (in module pygame.camera)": [[20, "pygame.camera.get_backends", false]], "get_ball() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_ball", false]], "get_bitsize() (pygame.surface method)": [[52, "pygame.Surface.get_bitsize", false]], "get_blocked() (in module pygame.event)": [[26, "pygame.event.get_blocked", false]], "get_bold() (pygame.font.font method)": [[28, "pygame.font.Font.get_bold", false]], "get_bottom_layer() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.get_bottom_layer", false]], "get_bounding_rect() (pygame.surface method)": [[52, "pygame.Surface.get_bounding_rect", false]], "get_bounding_rects() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.get_bounding_rects", false]], "get_buffer() (pygame.surface method)": [[52, "pygame.Surface.get_buffer", false]], "get_busy() (in module pygame.mixer)": [[39, "pygame.mixer.get_busy", false]], "get_busy() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.get_busy", false]], "get_busy() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.get_busy", false]], "get_button() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_button", false]], "get_button() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_button", false]], "get_bytesize() (pygame.surface method)": [[52, "pygame.Surface.get_bytesize", false]], "get_cache_size() (in module pygame.freetype)": [[29, "pygame.freetype.get_cache_size", false]], "get_caption() (in module pygame.display)": [[24, "pygame.display.get_caption", false]], "get_clip() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.get_clip", false]], "get_clip() (pygame.surface method)": [[52, "pygame.Surface.get_clip", false]], "get_colorkey() (pygame.surface method)": [[52, "pygame.Surface.get_colorkey", false]], "get_controls() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.get_controls", false]], "get_count() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.get_count", false]], "get_count() (in module pygame.joystick)": [[33, "pygame.joystick.get_count", false]], "get_count() (in module pygame.midi)": [[38, "pygame.midi.get_count", false]], "get_cpu_instruction_sets() (in module pygame.system)": [[54, "pygame.system.get_cpu_instruction_sets", false]], "get_current_refresh_rate() (in module pygame.display)": [[24, "pygame.display.get_current_refresh_rate", false]], "get_cursor() (in module pygame.mouse)": [[40, "pygame.mouse.get_cursor", false]], "get_default_font() (in module pygame.font)": [[28, "pygame.font.get_default_font", false]], "get_default_font() (in module pygame.freetype)": [[29, "pygame.freetype.get_default_font", false]], "get_default_input_id() (in module pygame.midi)": [[38, "pygame.midi.get_default_input_id", false]], "get_default_output_id() (in module pygame.midi)": [[38, "pygame.midi.get_default_output_id", false]], "get_default_resolution() (in module pygame.freetype)": [[29, "pygame.freetype.get_default_resolution", false]], "get_descent() (pygame.font.font method)": [[28, "pygame.font.Font.get_descent", false]], "get_desktop_refresh_rates() (in module pygame.display)": [[24, "pygame.display.get_desktop_refresh_rates", false]], "get_desktop_sizes() (in module pygame.display)": [[24, "pygame.display.get_desktop_sizes", false]], "get_device() (in module pygame._sdl2.touch)": [[57, "pygame._sdl2.touch.get_device", false]], "get_device_info() (in module pygame.midi)": [[38, "pygame.midi.get_device_info", false]], "get_driver() (in module pygame.display)": [[24, "pygame.display.get_driver", false]], "get_driver() (in module pygame.mixer)": [[39, "pygame.mixer.get_driver", false]], "get_drivers() (in module pygame._sdl2.video)": [[48, "pygame._sdl2.video.get_drivers", false]], "get_endevent() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.get_endevent", false]], "get_endevent() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.get_endevent", false]], "get_error() (in module pygame)": [[44, "pygame.get_error", false]], "get_error() (in module pygame.freetype)": [[29, "pygame.freetype.get_error", false]], "get_eventstate() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.get_eventstate", false]], "get_extended() (in module pygame.image)": [[32, "pygame.image.get_extended", false]], "get_finger() (in module pygame._sdl2.touch)": [[57, "pygame._sdl2.touch.get_finger", false]], "get_flags() (pygame.surface method)": [[52, "pygame.Surface.get_flags", false]], "get_focused() (in module pygame.key)": [[34, "pygame.key.get_focused", false]], "get_focused() (in module pygame.mouse)": [[40, "pygame.mouse.get_focused", false]], "get_fonts() (in module pygame.font)": [[28, "pygame.font.get_fonts", false]], "get_fps() (pygame.time.clock method)": [[56, "pygame.time.Clock.get_fps", false]], "get_frect() (pygame.surface method)": [[52, "pygame.Surface.get_frect", false]], "get_grab() (in module pygame.event)": [[26, "pygame.event.get_grab", false]], "get_grabbed_window() (in module pygame._sdl2.video)": [[48, "pygame._sdl2.video.get_grabbed_window", false]], "get_guid() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_guid", false]], "get_hat() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_hat", false]], "get_height() (pygame.font.font method)": [[28, "pygame.font.Font.get_height", false]], "get_height() (pygame.surface method)": [[52, "pygame.Surface.get_height", false]], "get_id() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_id", false]], "get_image() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.get_image", false]], "get_init() (in module pygame)": [[44, "pygame.get_init", false]], "get_init() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.get_init", false]], "get_init() (in module pygame.display)": [[24, "pygame.display.get_init", false]], "get_init() (in module pygame.font)": [[28, "pygame.font.get_init", false]], "get_init() (in module pygame.freetype)": [[29, "pygame.freetype.get_init", false]], "get_init() (in module pygame.joystick)": [[33, "pygame.joystick.get_init", false]], "get_init() (in module pygame.midi)": [[38, "pygame.midi.get_init", false]], "get_init() (in module pygame.mixer)": [[39, "pygame.mixer.get_init", false]], "get_init() (in module pygame.scrap)": [[46, "pygame.scrap.get_init", false]], "get_init() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_init", false]], "get_init() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_init", false]], "get_instance_id() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_instance_id", false]], "get_italic() (pygame.font.font method)": [[28, "pygame.font.Font.get_italic", false]], "get_just_pressed() (in module pygame.key)": [[34, "pygame.key.get_just_pressed", false]], "get_just_pressed() (in module pygame.mouse)": [[40, "pygame.mouse.get_just_pressed", false]], "get_just_released() (in module pygame.key)": [[34, "pygame.key.get_just_released", false]], "get_just_released() (in module pygame.mouse)": [[40, "pygame.mouse.get_just_released", false]], "get_layer_of_sprite() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.get_layer_of_sprite", false]], "get_length() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.get_length", false]], "get_linesize() (pygame.font.font method)": [[28, "pygame.font.Font.get_linesize", false]], "get_locked() (pygame.surface method)": [[52, "pygame.Surface.get_locked", false]], "get_locks() (pygame.surface method)": [[52, "pygame.Surface.get_locks", false]], "get_losses() (pygame.surface method)": [[52, "pygame.Surface.get_losses", false]], "get_mapping() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_mapping", false]], "get_masks() (pygame.surface method)": [[52, "pygame.Surface.get_masks", false]], "get_metadata() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.get_metadata", false]], "get_metrics() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_metrics", false]], "get_mods() (in module pygame.key)": [[34, "pygame.key.get_mods", false]], "get_name() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_name", false]], "get_num_channels() (in module pygame.mixer)": [[39, "pygame.mixer.get_num_channels", false]], "get_num_channels() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.get_num_channels", false]], "get_num_devices() (in module pygame._sdl2.touch)": [[57, "pygame._sdl2.touch.get_num_devices", false]], "get_num_displays() (in module pygame.display)": [[24, "pygame.display.get_num_displays", false]], "get_num_fingers() (in module pygame._sdl2.touch)": [[57, "pygame._sdl2.touch.get_num_fingers", false]], "get_numaxes() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_numaxes", false]], "get_numballs() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_numballs", false]], "get_numbuttons() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_numbuttons", false]], "get_numhats() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_numhats", false]], "get_offset() (pygame.surface method)": [[52, "pygame.Surface.get_offset", false]], "get_palette() (pygame.surface method)": [[52, "pygame.Surface.get_palette", false]], "get_palette_at() (pygame.surface method)": [[52, "pygame.Surface.get_palette_at", false]], "get_parent() (pygame.surface method)": [[52, "pygame.Surface.get_parent", false]], "get_pitch() (pygame.surface method)": [[52, "pygame.Surface.get_pitch", false]], "get_point_size() (pygame.font.font method)": [[28, "pygame.font.Font.get_point_size", false]], "get_pos() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.get_pos", false]], "get_pos() (in module pygame.mouse)": [[40, "pygame.mouse.get_pos", false]], "get_power_level() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.get_power_level", false]], "get_power_state() (in module pygame.system)": [[54, "pygame.system.get_power_state", false]], "get_pref_locales() (in module pygame.system)": [[54, "pygame.system.get_pref_locales", false]], "get_pref_path() (in module pygame.system)": [[54, "pygame.system.get_pref_path", false]], "get_pressed() (in module pygame.key)": [[34, "pygame.key.get_pressed", false]], "get_pressed() (in module pygame.mouse)": [[40, "pygame.mouse.get_pressed", false]], "get_queue() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.get_queue", false]], "get_raw() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.get_raw", false]], "get_raw() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.get_raw", false]], "get_rawtime() (pygame.time.clock method)": [[56, "pygame.time.Clock.get_rawtime", false]], "get_rect() (pygame._sdl2.video.image method)": [[48, "pygame._sdl2.video.Image.get_rect", false]], "get_rect() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.get_rect", false]], "get_rect() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_rect", false]], "get_rect() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.get_rect", false]], "get_rect() (pygame.surface method)": [[52, "pygame.Surface.get_rect", false]], "get_rel() (in module pygame.mouse)": [[40, "pygame.mouse.get_rel", false]], "get_relative_mode() (in module pygame.mouse)": [[40, "pygame.mouse.get_relative_mode", false]], "get_repeat() (in module pygame.key)": [[34, "pygame.key.get_repeat", false]], "get_sdl_byteorder() (in module pygame)": [[44, "pygame.get_sdl_byteorder", false]], "get_sdl_image_version() (in module pygame.image)": [[32, "pygame.image.get_sdl_image_version", false]], "get_sdl_mixer_version() (in module pygame.mixer)": [[39, "pygame.mixer.get_sdl_mixer_version", false]], "get_sdl_ttf_version() (in module pygame.font)": [[28, "pygame.font.get_sdl_ttf_version", false]], "get_sdl_version() (in module pygame)": [[44, "pygame.get_sdl_version", false]], "get_shifts() (pygame.surface method)": [[52, "pygame.Surface.get_shifts", false]], "get_size() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.get_size", false]], "get_size() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.get_size", false]], "get_size() (pygame.surface method)": [[52, "pygame.Surface.get_size", false]], "get_sized_ascender() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_ascender", false]], "get_sized_descender() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_descender", false]], "get_sized_glyph_height() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_glyph_height", false]], "get_sized_height() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_height", false]], "get_sizes() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sizes", false]], "get_smoothscale_backend() (in module pygame.transform)": [[58, "pygame.transform.get_smoothscale_backend", false]], "get_sound() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.get_sound", false]], "get_soundfont() (in module pygame.mixer)": [[39, "pygame.mixer.get_soundfont", false]], "get_sprite() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.get_sprite", false]], "get_sprites_at() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.get_sprites_at", false]], "get_sprites_from_layer() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.get_sprites_from_layer", false]], "get_strikethrough() (pygame.font.font method)": [[28, "pygame.font.Font.get_strikethrough", false]], "get_surface() (in module pygame.display)": [[24, "pygame.display.get_surface", false]], "get_surface() (pygame.window method)": [[60, "pygame.Window.get_surface", false]], "get_text() (in module pygame.scrap)": [[46, "pygame.scrap.get_text", false]], "get_ticks() (in module pygame.time)": [[56, "pygame.time.get_ticks", false]], "get_time() (pygame.time.clock method)": [[56, "pygame.time.Clock.get_time", false]], "get_top_layer() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.get_top_layer", false]], "get_top_sprite() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.get_top_sprite", false]], "get_total_ram() (in module pygame.system)": [[54, "pygame.system.get_total_ram", false]], "get_types() (in module pygame.scrap)": [[46, "pygame.scrap.get_types", false]], "get_underline() (pygame.font.font method)": [[28, "pygame.font.Font.get_underline", false]], "get_version() (in module pygame.freetype)": [[29, "pygame.freetype.get_version", false]], "get_view() (pygame.surface method)": [[52, "pygame.Surface.get_view", false]], "get_viewport() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.get_viewport", false]], "get_visible() (in module pygame.mouse)": [[40, "pygame.mouse.get_visible", false]], "get_volume() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.get_volume", false]], "get_volume() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.get_volume", false]], "get_volume() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.get_volume", false]], "get_width() (pygame.surface method)": [[52, "pygame.Surface.get_width", false]], "get_window_position() (in module pygame.display)": [[24, "pygame.display.get_window_position", false]], "get_window_size() (in module pygame.display)": [[24, "pygame.display.get_window_size", false]], "get_wm_info() (in module pygame.display)": [[24, "pygame.display.get_wm_info", false]], "gl_get_attribute() (in module pygame.display)": [[24, "pygame.display.gl_get_attribute", false]], "gl_set_attribute() (in module pygame.display)": [[24, "pygame.display.gl_set_attribute", false]], "glcube.main() (in module pygame.examples)": [[27, "pygame.examples.glcube.main", false]], "grab_keyboard (pygame.window attribute)": [[60, "pygame.Window.grab_keyboard", false]], "grab_mouse (pygame.window attribute)": [[60, "pygame.Window.grab_mouse", false]], "grayscale() (in module pygame.transform)": [[58, "pygame.transform.grayscale", false]], "grayscale() (pygame.color method)": [[21, "pygame.Color.grayscale", false]], "group (class in pygame.sprite)": [[51, "pygame.sprite.Group", false]], "groupcollide() (in module pygame.sprite)": [[51, "pygame.sprite.groupcollide", false]], "groups() (pygame.sprite.sprite method)": [[51, "pygame.sprite.Sprite.groups", false]], "groupsingle() (in module pygame.sprite)": [[51, "pygame.sprite.GroupSingle", false]], "handle (pygame.window property)": [[60, "pygame.Window.handle", false]], "has() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.has", false]], "has_text() (in module pygame.scrap)": [[46, "pygame.scrap.has_text", false]], "headless_no_windows_needed.main() (in module pygame.examples)": [[27, "pygame.examples.headless_no_windows_needed.main", false]], "height (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.height", false]], "height (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.height", false]], "height (pygame.surface property)": [[52, "pygame.Surface.height", false]], "hex (pygame.color attribute)": [[21, "pygame.Color.hex", false]], "hide() (pygame.window method)": [[60, "pygame.Window.hide", false]], "hline() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.hline", false]], "hsl() (in module pygame.transform)": [[58, "pygame.transform.hsl", false]], "hsla (pygame.color attribute)": [[21, "pygame.Color.hsla", false]], "hsva (pygame.color attribute)": [[21, "pygame.Color.hsva", false]], "i1i2i3 (pygame.color attribute)": [[21, "pygame.Color.i1i2i3", false]], "iconify() (in module pygame.display)": [[24, "pygame.display.iconify", false]], "id (pygame.mixer.channel attribute)": [[39, "pygame.mixer.Channel.id", false]], "id (pygame.window property)": [[60, "pygame.Window.id", false]], "image (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Image", false]], "import_pygame_base (c function)": [[1, "c.import_pygame_base", false]], "inflate() (pygame.rect method)": [[45, "pygame.Rect.inflate", false]], "inflate_ip() (pygame.rect method)": [[45, "pygame.Rect.inflate_ip", false]], "info() (in module pygame.display)": [[24, "pygame.display.Info", false]], "init() (in module pygame)": [[44, "pygame.init", false]], "init() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.init", false]], "init() (in module pygame.camera)": [[20, "pygame.camera.init", false]], "init() (in module pygame.display)": [[24, "pygame.display.init", false]], "init() (in module pygame.font)": [[28, "pygame.font.init", false]], "init() (in module pygame.freetype)": [[29, "pygame.freetype.init", false]], "init() (in module pygame.joystick)": [[33, "pygame.joystick.init", false]], "init() (in module pygame.midi)": [[38, "pygame.midi.init", false]], "init() (in module pygame.mixer)": [[39, "pygame.mixer.init", false]], "init() (in module pygame.scrap)": [[46, "pygame.scrap.init", false]], "init() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.init", false]], "init() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.init", false]], "input (class in pygame.midi)": [[38, "pygame.midi.Input", false]], "intersect() (pygame.circle method)": [[30, "pygame.Circle.intersect", false]], "intpoint (in module pygame.typing)": [[59, "pygame.typing.IntPoint", false]], "invert() (in module pygame.transform)": [[58, "pygame.transform.invert", false]], "invert() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.invert", false]], "invlerp() (in module pygame.math)": [[37, "pygame.math.invlerp", false]], "is_ce (in module pygame)": [[44, "pygame.IS_CE", false]], "is_controller() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.is_controller", false]], "is_fullscreen() (in module pygame.display)": [[24, "pygame.display.is_fullscreen", false]], "is_normalized() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.is_normalized", false]], "is_normalized() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.is_normalized", false]], "is_vsync() (in module pygame.display)": [[24, "pygame.display.is_vsync", false]], "italic (pygame.font.font attribute)": [[28, "pygame.font.Font.italic", false]], "itemsize (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.itemsize", false]], "joystick (class in pygame.joystick)": [[33, "pygame.joystick.Joystick", false]], "joystick.main() (in module pygame.examples)": [[27, "pygame.examples.joystick.main", false]], "kerning (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.kerning", false]], "key_code() (in module pygame.key)": [[34, "pygame.key.key_code", false]], "keyboard_grabbed (pygame.window property)": [[60, "pygame.Window.keyboard_grabbed", false]], "kill() (pygame.sprite.sprite method)": [[51, "pygame.sprite.Sprite.kill", false]], "laplacian() (in module pygame.transform)": [[58, "pygame.transform.laplacian", false]], "layereddirty (class in pygame.sprite)": [[51, "pygame.sprite.LayeredDirty", false]], "layeredupdates (class in pygame.sprite)": [[51, "pygame.sprite.LayeredUpdates", false]], "layers() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.layers", false]], "left (pygame.circle attribute)": [[30, "pygame.Circle.left", false]], "length (pygame.bufferproxy attribute)": [[19, "pygame.BufferProxy.length", false]], "length (pygame.line attribute)": [[30, "pygame.Line.length", false]], "length() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.length", false]], "length() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.length", false]], "length_squared() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.length_squared", false]], "length_squared() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.length_squared", false]], "lerp() (in module pygame.math)": [[37, "pygame.math.lerp", false]], "lerp() (pygame.color method)": [[21, "pygame.Color.lerp", false]], "lerp() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.lerp", false]], "lerp() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.lerp", false]], "line (class in pygame)": [[30, "pygame.Line", false]], "line() (in module pygame.draw)": [[25, "pygame.draw.line", false]], "line() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.line", false]], "lines() (in module pygame.draw)": [[25, "pygame.draw.lines", false]], "liquid.main() (in module pygame.examples)": [[27, "pygame.examples.liquid.main", false]], "list_cameras() (in module pygame.camera)": [[20, "pygame.camera.list_cameras", false]], "list_modes() (in module pygame.display)": [[24, "pygame.display.list_modes", false]], "load() (in module pygame.image)": [[32, "pygame.image.load", false]], "load() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.load", false]], "load_animation() (in module pygame.image)": [[32, "pygame.image.load_animation", false]], "load_basic() (in module pygame.image)": [[32, "pygame.image.load_basic", false]], "load_extended() (in module pygame.image)": [[32, "pygame.image.load_extended", false]], "load_sized_svg() (in module pygame.image)": [[32, "pygame.image.load_sized_svg", false]], "load_xbm() (in module pygame.cursors)": [[23, "pygame.cursors.load_xbm", false]], "lock() (pygame.surface method)": [[52, "pygame.Surface.lock", false]], "logical_size (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.logical_size", false]], "lost() (in module pygame.scrap)": [[46, "pygame.scrap.lost", false]], "magnitude() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.magnitude", false]], "magnitude() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.magnitude", false]], "magnitude_squared() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.magnitude_squared", false]], "magnitude_squared() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.magnitude_squared", false]], "make_sound() (in module pygame.sndarray)": [[49, "pygame.sndarray.make_sound", false]], "make_surface() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.make_surface", false]], "make_surface() (in module pygame.surfarray)": [[53, "pygame.surfarray.make_surface", false]], "make_surface() (pygame.pixelarray method)": [[42, "pygame.PixelArray.make_surface", false]], "map_array() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.map_array", false]], "map_array() (in module pygame.surfarray)": [[53, "pygame.surfarray.map_array", false]], "map_rgb() (pygame.surface method)": [[52, "pygame.Surface.map_rgb", false]], "mask (class in pygame.mask)": [[36, "pygame.mask.Mask", false]], "mask.main() (in module pygame.examples)": [[27, "pygame.examples.mask.main", false]], "match_font() (in module pygame.font)": [[28, "pygame.font.match_font", false]], "maximize() (pygame.window method)": [[60, "pygame.Window.maximize", false]], "maximum_size (pygame.window property)": [[60, "pygame.Window.maximum_size", false]], "message_box() (in module pygame.display)": [[24, "pygame.display.message_box", false]], "metrics() (pygame.font.font method)": [[28, "pygame.font.Font.metrics", false]], "midi.main() (in module pygame.examples)": [[27, "pygame.examples.midi.main", false]], "midi_to_ansi_note() (in module pygame.midi)": [[38, "pygame.midi.midi_to_ansi_note", false]], "midi_to_frequency() (in module pygame.midi)": [[38, "pygame.midi.midi_to_frequency", false]], "midiexception": [[38, "pygame.midi.MidiException", false]], "midis2events() (in module pygame.midi)": [[38, "pygame.midi.midis2events", false]], "minimize() (pygame.window method)": [[60, "pygame.Window.minimize", false]], "minimum_size (pygame.window property)": [[60, "pygame.Window.minimum_size", false]], "mode_ok() (in module pygame.display)": [[24, "pygame.display.mode_ok", false]], "module": [[20, "module-pygame.camera", false], [23, "module-pygame.cursors", false], [24, "module-pygame.display", false], [25, "module-pygame.draw", false], [26, "module-pygame.event", false], [27, "module-pygame.examples", false], [28, "module-pygame.font", false], [29, "module-pygame.freetype", false], [30, "module-pygame.geometry", false], [31, "module-pygame.gfxdraw", false], [32, "module-pygame.image", false], [33, "module-pygame.joystick", false], [34, "module-pygame.key", false], [35, "module-pygame.locals", false], [36, "module-pygame.mask", false], [37, "module-pygame.math", false], [38, "module-pygame.midi", false], [39, "module-pygame.mixer", false], [40, "module-pygame.mouse", false], [41, "module-pygame.mixer.music", false], [43, "module-pygame.pixelcopy", false], [44, "module-pygame", false], [44, "module-pygame.version", false], [46, "module-pygame.scrap", false], [47, "module-pygame._sdl2.controller", false], [48, "module-pygame._sdl2.video", false], [49, "module-pygame.sndarray", false], [51, "module-pygame.sprite", false], [53, "module-pygame.surfarray", false], [54, "module-pygame.system", false], [55, "module-pygame.tests", false], [56, "module-pygame.time", false], [57, "module-pygame._sdl2.touch", false], [58, "module-pygame.transform", false], [59, "module-pygame.typing", false]], "mouse_grabbed (pygame.window property)": [[60, "pygame.Window.mouse_grabbed", false]], "mouse_rect (pygame.window property)": [[60, "pygame.Window.mouse_rect", false]], "move() (pygame.circle method)": [[30, "pygame.Circle.move", false]], "move() (pygame.line method)": [[30, "pygame.Line.move", false]], "move() (pygame.rect method)": [[45, "pygame.Rect.move", false]], "move_ip() (pygame.circle method)": [[30, "pygame.Circle.move_ip", false]], "move_ip() (pygame.line method)": [[30, "pygame.Line.move_ip", false]], "move_ip() (pygame.rect method)": [[45, "pygame.Rect.move_ip", false]], "move_to() (pygame.rect method)": [[45, "pygame.Rect.move_to", false]], "move_to_back() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.move_to_back", false]], "move_to_front() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.move_to_front", false]], "move_towards() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.move_towards", false]], "move_towards() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.move_towards", false]], "move_towards_ip() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.move_towards_ip", false]], "move_towards_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.move_towards_ip", false]], "moveit.main() (in module pygame.examples)": [[27, "pygame.examples.moveit.main", false]], "mustlock() (pygame.surface method)": [[52, "pygame.Surface.mustlock", false]], "name (pygame.font.font attribute)": [[28, "pygame.font.Font.name", false]], "name (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.name", false]], "name() (in module pygame.key)": [[34, "pygame.key.name", false]], "name_forindex() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.name_forindex", false]], "ndim (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.ndim", false]], "normalize() (pygame.color method)": [[21, "pygame.Color.normalize", false]], "normalize() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.normalize", false]], "normalize() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.normalize", false]], "normalize() (pygame.rect method)": [[45, "pygame.Rect.normalize", false]], "normalize_ip() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.normalize_ip", false]], "normalize_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.normalize_ip", false]], "normalized (pygame.color attribute)": [[21, "pygame.Color.normalized", false]], "note_off() (pygame.midi.output method)": [[38, "pygame.midi.Output.note_off", false]], "note_on() (pygame.midi.output method)": [[38, "pygame.midi.Output.note_on", false]], "oblique (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.oblique", false]], "opacity (pygame.window attribute)": [[60, "pygame.Window.opacity", false]], "opengl (pygame.window property)": [[60, "pygame.Window.opengl", false]], "origin (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.origin", false]], "origin (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.origin", false]], "outline (pygame.font.font attribute)": [[28, "pygame.font.Font.outline", false]], "outline() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.outline", false]], "output (class in pygame.midi)": [[38, "pygame.midi.Output", false]], "overlap() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.overlap", false]], "overlap_area() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.overlap_area", false]], "overlap_mask() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.overlap_mask", false]], "pad (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.pad", false]], "parent (pygame.bufferproxy attribute)": [[19, "pygame.BufferProxy.parent", false]], "path (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.path", false]], "pause() (in module pygame.mixer)": [[39, "pygame.mixer.pause", false]], "pause() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.pause", false]], "pause() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.pause", false]], "peek() (in module pygame.event)": [[26, "pygame.event.peek", false]], "pg_buffer (c type)": [[1, "c.pg_buffer", false]], "pg_buffer.consumer (c member)": [[1, "c.pg_buffer.consumer", false]], "pg_buffer.release_buffer (c member)": [[1, "c.pg_buffer.release_buffer", false]], "pg_buffer.view (c member)": [[1, "c.pg_buffer.view", false]], "pg_encodefilepath (c function)": [[10, "c.pg_EncodeFilePath", false]], "pg_encodestring (c function)": [[10, "c.pg_EncodeString", false]], "pg_floatfromobj (c function)": [[1, "c.pg_FloatFromObj", false]], "pg_floatfromobjindex (c function)": [[1, "c.pg_FloatFromObjIndex", false]], "pg_getdefaultwindow (c function)": [[1, "c.pg_GetDefaultWindow", false]], "pg_getdefaultwindowsurface (c function)": [[1, "c.pg_GetDefaultWindowSurface", false]], "pg_intfromobj (c function)": [[1, "c.pg_IntFromObj", false]], "pg_intfromobjindex (c function)": [[1, "c.pg_IntFromObjIndex", false]], "pg_major_version (c macro)": [[14, "c.PG_MAJOR_VERSION", false]], "pg_mappedcolorfromobj (c function)": [[3, "c.pg_MappedColorFromObj", false]], "pg_minor_version (c macro)": [[14, "c.PG_MINOR_VERSION", false]], "pg_mod_autoinit (c function)": [[1, "c.pg_mod_autoinit", false]], "pg_mod_autoquit (c function)": [[1, "c.pg_mod_autoquit", false]], "pg_patch_version (c macro)": [[14, "c.PG_PATCH_VERSION", false]], "pg_post_event (c function)": [[5, "c.pg_post_event", false]], "pg_post_event_dictproxy (c function)": [[5, "c.pg_post_event_dictproxy", false]], "pg_registerquit (c function)": [[1, "c.pg_RegisterQuit", false]], "pg_rgbafromobj (c function)": [[1, "c.pg_RGBAFromObj", false]], "pg_rgbafromobjex (c function)": [[3, "c.pg_RGBAFromObjEx", false]], "pg_setdefaultwindow (c function)": [[1, "c.pg_SetDefaultWindow", false]], "pg_setdefaultwindowsurface (c function)": [[1, "c.pg_SetDefaultWindowSurface", false]], "pg_twofloatsfromobj (c function)": [[1, "c.pg_TwoFloatsFromObj", false]], "pg_twointsfromobj (c function)": [[1, "c.pg_TwoIntsFromObj", false]], "pg_uintfromobj (c function)": [[1, "c.pg_UintFromObj", false]], "pg_uintfromobjindex (c function)": [[1, "c.pg_UintFromObjIndex", false]], "pg_version_atleast (c macro)": [[14, "c.PG_VERSION_ATLEAST", false]], "pg_versionnum (c macro)": [[14, "c.PG_VERSIONNUM", false]], "pgbuffer_asarrayinterface (c function)": [[1, "c.pgBuffer_AsArrayInterface", false]], "pgbuffer_asarraystruct (c function)": [[1, "c.pgBuffer_AsArrayStruct", false]], "pgbuffer_release (c function)": [[1, "c.pgBuffer_Release", false]], "pgbufferproxy_check (c function)": [[2, "c.pgBufferProxy_Check", false]], "pgbufferproxy_getparent (c function)": [[2, "c.pgBufferProxy_GetParent", false]], "pgbufferproxy_new (c function)": [[2, "c.pgBufferProxy_New", false]], "pgbufferproxy_trip (c function)": [[2, "c.pgBufferProxy_Trip", false]], "pgbufferproxy_type (c var)": [[2, "c.pgBufferProxy_Type", false]], "pgchannel_asint (c function)": [[8, "c.pgChannel_AsInt", false]], "pgchannel_check (c function)": [[8, "c.pgChannel_Check", false]], "pgchannel_new (c function)": [[8, "c.pgChannel_New", false]], "pgchannel_type (c var)": [[8, "c.pgChannel_Type", false]], "pgchannelobject (c type)": [[8, "c.pgChannelObject", false]], "pgcolor_checkexact (c function)": [[3, "c.pgColor_CheckExact", false]], "pgcolor_new (c function)": [[3, "c.pgColor_New", false]], "pgcolor_newlength (c function)": [[3, "c.pgColor_NewLength", false]], "pgcolor_type (c var)": [[3, "c.pgColor_Type", false]], "pgdict_asbuffer (c function)": [[1, "c.pgDict_AsBuffer", false]], "pgevent_check (c function)": [[5, "c.pgEvent_Check", false]], "pgevent_getkeydowninfo (c function)": [[5, "c.pgEvent_GetKeyDownInfo", false]], "pgevent_getkeyupinfo (c function)": [[5, "c.pgEvent_GetKeyUpInfo", false]], "pgevent_getmousebuttondowninfo (c function)": [[5, "c.pgEvent_GetMouseButtonDownInfo", false]], "pgevent_getmousebuttonupinfo (c function)": [[5, "c.pgEvent_GetMouseButtonUpInfo", false]], "pgevent_new (c function)": [[5, "c.pgEvent_New", false]], "pgevent_type (c type)": [[5, "c.pgEvent_Type", false]], "pgeventobject (c type)": [[5, "c.pgEventObject", false]], "pgeventobject.type (c member)": [[5, "c.pgEventObject.type", false]], "pgexc_buffererror (c var)": [[1, "c.pgExc_BufferError", false]], "pgexc_sdlerror (c var)": [[1, "c.pgExc_SDLError", false]], "pgfont_check (c function)": [[6, "c.pgFont_Check", false]], "pgfont_is_alive (c function)": [[6, "c.pgFont_IS_ALIVE", false]], "pgfont_new (c function)": [[6, "c.pgFont_New", false]], "pgfont_type (c type)": [[6, "c.pgFont_Type", false]], "pgfontobject (c type)": [[6, "c.pgFontObject", false]], "pgfrect_asrect (c function)": [[9, "c.pgFRect_AsRect", false]], "pgfrect_fromobject (c function)": [[9, "c.pgFRect_FromObject", false]], "pgfrect_new (c function)": [[9, "c.pgFRect_New", false]], "pgfrect_new4 (c function)": [[9, "c.pgFRect_New4", false]], "pgfrect_normalize (c function)": [[9, "c.pgFRect_Normalize", false]], "pgfrect_type (c var)": [[9, "c.pgFRect_Type", false]], "pgfrectobject (c type)": [[9, "c.pgFRectObject", false]], "pgfrectobject.r (c member)": [[9, "c.pgFRectObject.r", false]], "pgjoystick_getdeviceindexbyinstanceid (c function)": [[7, "c.pgJoystick_GetDeviceIndexByInstanceID", false]], "pgjoystick_new (c function)": [[7, "c.pgJoystick_New", false]], "pgjoystick_type (c var)": [[7, "c.pgJoystick_Type", false]], "pgobject_getbuffer (c function)": [[1, "c.pgObject_GetBuffer", false]], "pgobject_getrecthelper (c function)": [[1, "c.pgObject_getRectHelper", false]], "pgrect_asrect (c function)": [[9, "c.pgRect_AsRect", false]], "pgrect_fromobject (c function)": [[9, "c.pgRect_FromObject", false]], "pgrect_new (c function)": [[9, "c.pgRect_New", false]], "pgrect_new4 (c function)": [[9, "c.pgRect_New4", false]], "pgrect_normalize (c function)": [[9, "c.pgRect_Normalize", false]], "pgrect_type (c var)": [[9, "c.pgRect_Type", false]], "pgrectobject (c type)": [[9, "c.pgRectObject", false]], "pgrectobject.r (c member)": [[9, "c.pgRectObject.r", false]], "pgrwops_fromfileobject (c function)": [[10, "c.pgRWops_FromFileObject", false]], "pgrwops_fromobject (c function)": [[10, "c.pgRWops_FromObject", false]], "pgrwops_isfileobject (c function)": [[10, "c.pgRWops_IsFileObject", false]], "pgsound_aschunk (c function)": [[8, "c.pgSound_AsChunk", false]], "pgsound_check (c function)": [[8, "c.pgSound_Check", false]], "pgsound_new (c function)": [[8, "c.pgSound_New", false]], "pgsound_type (c var)": [[8, "c.pgSound_Type", false]], "pgsoundobject (c type)": [[8, "c.pgSoundObject", false]], "pgsurface_assurface (c function)": [[12, "c.pgSurface_AsSurface", false]], "pgsurface_blit (c function)": [[12, "c.pgSurface_Blit", false]], "pgsurface_check (c function)": [[12, "c.pgSurface_Check", false]], "pgsurface_lock (c function)": [[13, "c.pgSurface_Lock", false]], "pgsurface_lockby (c function)": [[13, "c.pgSurface_LockBy", false]], "pgsurface_new (c function)": [[12, "c.pgSurface_New", false]], "pgsurface_prep (c function)": [[13, "c.pgSurface_Prep", false]], "pgsurface_type (c var)": [[12, "c.pgSurface_Type", false]], "pgsurface_unlock (c function)": [[13, "c.pgSurface_UnLock", false]], "pgsurface_unlockby (c function)": [[13, "c.pgSurface_UnLockBy", false]], "pgsurface_unprep (c function)": [[13, "c.pgSurface_Unprep", false]], "pgsurfaceobject (c type)": [[12, "c.pgSurfaceObject", false]], "pgvidinfo_asvidinfo (c function)": [[4, "c.pgVidInfo_AsVidInfo", false]], "pgvidinfo_check (c function)": [[4, "c.pgVidInfo_Check", false]], "pgvidinfo_new (c function)": [[4, "c.pgVidInfo_New", false]], "pgvidinfo_type (c var)": [[4, "c.pgVidInfo_Type", false]], "pgvidinfoobject (c type)": [[4, "c.pgVidInfoObject", false]], "pgwindow_check (c function)": [[15, "c.pgWindow_Check", false]], "pgwindow_type (c var)": [[15, "c.pgWindow_Type", false]], "pgwindowobject (c type)": [[15, "c.pgWindowObject", false]], "pie() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.pie", false]], "pitch_bend() (pygame.midi.output method)": [[38, "pygame.midi.Output.pitch_bend", false]], "pixel() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.pixel", false]], "pixelarray (class in pygame)": [[42, "pygame.PixelArray", false]], "pixelarray.main() (in module pygame.examples)": [[27, "pygame.examples.pixelarray.main", false]], "pixelate() (in module pygame.transform)": [[58, "pygame.transform.pixelate", false]], "pixels2d() (in module pygame.surfarray)": [[53, "pygame.surfarray.pixels2d", false]], "pixels3d() (in module pygame.surfarray)": [[53, "pygame.surfarray.pixels3d", false]], "pixels_alpha() (in module pygame.surfarray)": [[53, "pygame.surfarray.pixels_alpha", false]], "pixels_blue() (in module pygame.surfarray)": [[53, "pygame.surfarray.pixels_blue", false]], "pixels_green() (in module pygame.surfarray)": [[53, "pygame.surfarray.pixels_green", false]], "pixels_red() (in module pygame.surfarray)": [[53, "pygame.surfarray.pixels_red", false]], "play() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.play", false]], "play() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.play", false]], "play() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.play", false]], "playmus.main() (in module pygame.examples)": [[27, "pygame.examples.playmus.main", false]], "point (in module pygame.typing)": [[59, "pygame.typing.Point", false]], "point_size (pygame.font.font attribute)": [[28, "pygame.font.Font.point_size", false]], "poll() (in module pygame.event)": [[26, "pygame.event.poll", false]], "poll() (pygame.midi.input method)": [[38, "pygame.midi.Input.poll", false]], "polygon() (in module pygame.draw)": [[25, "pygame.draw.polygon", false]], "polygon() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.polygon", false]], "position (pygame.window property)": [[60, "pygame.Window.position", false]], "post() (in module pygame.event)": [[26, "pygame.event.post", false]], "pre_init() (in module pygame.mixer)": [[39, "pygame.mixer.pre_init", false]], "premul_alpha() (pygame.color method)": [[21, "pygame.Color.premul_alpha", false]], "premul_alpha() (pygame.surface method)": [[52, "pygame.Surface.premul_alpha", false]], "premul_alpha_ip() (pygame.surface method)": [[52, "pygame.Surface.premul_alpha_ip", false]], "present() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.present", false]], "print_debug_info() (in module pygame)": [[44, "pygame.print_debug_info", false]], "project() (pygame.line method)": [[30, "pygame.Line.project", false]], "project() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.project", false]], "project() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.project", false]], "pump() (in module pygame.event)": [[26, "pygame.event.pump", false]], "put() (in module pygame.scrap)": [[46, "pygame.scrap.put", false]], "put_text() (in module pygame.scrap)": [[46, "pygame.scrap.put_text", false]], "pygame": [[44, "module-pygame", false]], "pygame._sdl2.controller": [[47, "module-pygame._sdl2.controller", false]], "pygame._sdl2.touch": [[57, "module-pygame._sdl2.touch", false]], "pygame._sdl2.video": [[48, "module-pygame._sdl2.video", false]], "pygame.camera": [[20, "module-pygame.camera", false]], "pygame.cursors": [[23, "module-pygame.cursors", false]], "pygame.display": [[24, "module-pygame.display", false]], "pygame.draw": [[25, "module-pygame.draw", false]], "pygame.event": [[26, "module-pygame.event", false]], "pygame.examples": [[27, "module-pygame.examples", false]], "pygame.font": [[28, "module-pygame.font", false]], "pygame.freetype": [[29, "module-pygame.freetype", false]], "pygame.geometry": [[30, "module-pygame.geometry", false]], "pygame.gfxdraw": [[31, "module-pygame.gfxdraw", false]], "pygame.image": [[32, "module-pygame.image", false]], "pygame.joystick": [[33, "module-pygame.joystick", false]], "pygame.key": [[34, "module-pygame.key", false]], "pygame.locals": [[35, "module-pygame.locals", false]], "pygame.mask": [[36, "module-pygame.mask", false]], "pygame.math": [[37, "module-pygame.math", false]], "pygame.midi": [[38, "module-pygame.midi", false]], "pygame.mixer": [[39, "module-pygame.mixer", false]], "pygame.mixer.music": [[41, "module-pygame.mixer.music", false]], "pygame.mouse": [[40, "module-pygame.mouse", false]], "pygame.pixelcopy": [[43, "module-pygame.pixelcopy", false]], "pygame.scrap": [[46, "module-pygame.scrap", false]], "pygame.sndarray": [[49, "module-pygame.sndarray", false]], "pygame.sprite": [[51, "module-pygame.sprite", false]], "pygame.surfarray": [[53, "module-pygame.surfarray", false]], "pygame.system": [[54, "module-pygame.system", false]], "pygame.tests": [[55, "module-pygame.tests", false]], "pygame.time": [[56, "module-pygame.time", false]], "pygame.transform": [[58, "module-pygame.transform", false]], "pygame.typing": [[59, "module-pygame.typing", false]], "pygame.version": [[44, "module-pygame.version", false]], "query_image() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.query_image", false]], "queue() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.queue", false]], "queue() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.queue", false]], "quit() (in module pygame)": [[44, "pygame.quit", false]], "quit() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.quit", false]], "quit() (in module pygame.display)": [[24, "pygame.display.quit", false]], "quit() (in module pygame.font)": [[28, "pygame.font.quit", false]], "quit() (in module pygame.freetype)": [[29, "pygame.freetype.quit", false]], "quit() (in module pygame.joystick)": [[33, "pygame.joystick.quit", false]], "quit() (in module pygame.midi)": [[38, "pygame.midi.quit", false]], "quit() (in module pygame.mixer)": [[39, "pygame.mixer.quit", false]], "quit() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.quit", false]], "quit() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.quit", false]], "r (pygame.circle attribute)": [[30, "pygame.Circle.r", false]], "r (pygame.color attribute)": [[21, "pygame.Color.r", false]], "r_sqr (pygame.circle attribute)": [[30, "pygame.Circle.r_sqr", false]], "raw (pygame.bufferproxy attribute)": [[19, "pygame.BufferProxy.raw", false]], "read() (pygame.midi.input method)": [[38, "pygame.midi.Input.read", false]], "rect (class in pygame)": [[45, "pygame.Rect", false]], "rect() (in module pygame.draw)": [[25, "pygame.draw.rect", false]], "rectangle() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.rectangle", false]], "rectlike (in module pygame.typing)": [[59, "pygame.typing.RectLike", false]], "reflect() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.reflect", false]], "reflect() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.reflect", false]], "reflect_ip() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.reflect_ip", false]], "reflect_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.reflect_ip", false]], "register_quit() (in module pygame)": [[44, "pygame.register_quit", false]], "remap() (in module pygame.math)": [[37, "pygame.math.remap", false]], "remove() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.remove", false]], "remove() (pygame.sprite.sprite method)": [[51, "pygame.sprite.Sprite.remove", false]], "remove_sprites_of_layer() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.remove_sprites_of_layer", false]], "render() (pygame.font.font method)": [[28, "pygame.font.Font.render", false]], "render() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render", false]], "render_raw() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render_raw", false]], "render_raw_to() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render_raw_to", false]], "render_to() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render_to", false]], "renderer (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Renderer", false]], "renderer (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.renderer", false]], "rendererdriverinfo (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.RendererDriverInfo", false]], "renderupdates (class in pygame.sprite)": [[51, "pygame.sprite.RenderUpdates", false]], "repaint_rect() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.repaint_rect", false]], "replace() (pygame.pixelarray method)": [[42, "pygame.PixelArray.replace", false]], "resizable (pygame.window attribute)": [[60, "pygame.Window.resizable", false]], "resolution (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.resolution", false]], "restore() (pygame.window method)": [[60, "pygame.Window.restore", false]], "rev (in module pygame.version)": [[44, "pygame.version.rev", false]], "rewind() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.rewind", false]], "right (pygame.circle attribute)": [[30, "pygame.Circle.right", false]], "rotate() (in module pygame.transform)": [[58, "pygame.transform.rotate", false]], "rotate() (pygame.circle method)": [[30, "pygame.Circle.rotate", false]], "rotate() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.rotate", false]], "rotate() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate", false]], "rotate_ip() (pygame.circle method)": [[30, "pygame.Circle.rotate_ip", false]], "rotate_ip() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.rotate_ip", false]], "rotate_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_ip", false]], "rotate_ip_rad() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.rotate_ip_rad", false]], "rotate_ip_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_ip_rad", false]], "rotate_rad() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.rotate_rad", false]], "rotate_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_rad", false]], "rotate_rad_ip() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.rotate_rad_ip", false]], "rotate_rad_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_rad_ip", false]], "rotate_x() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_x", false]], "rotate_x_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_x_ip", false]], "rotate_x_ip_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_x_ip_rad", false]], "rotate_x_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_x_rad", false]], "rotate_x_rad_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_x_rad_ip", false]], "rotate_y() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_y", false]], "rotate_y_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_y_ip", false]], "rotate_y_ip_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_y_ip_rad", false]], "rotate_y_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_y_rad", false]], "rotate_y_rad_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_y_rad_ip", false]], "rotate_z() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_z", false]], "rotate_z_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_z_ip", false]], "rotate_z_ip_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_z_ip_rad", false]], "rotate_z_rad() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_z_rad", false]], "rotate_z_rad_ip() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.rotate_z_rad_ip", false]], "rotation (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.rotation", false]], "rotozoom() (in module pygame.transform)": [[58, "pygame.transform.rotozoom", false]], "rumble() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.rumble", false]], "rumble() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.rumble", false]], "run() (in module pygame.tests)": [[55, "pygame.tests.run", false]], "samples() (in module pygame.sndarray)": [[49, "pygame.sndarray.samples", false]], "save() (in module pygame.image)": [[32, "pygame.image.save", false]], "save_extended() (in module pygame.image)": [[32, "pygame.image.save_extended", false]], "scalable (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.scalable", false]], "scale (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.scale", false]], "scale() (in module pygame.transform)": [[58, "pygame.transform.scale", false]], "scale() (pygame.line method)": [[30, "pygame.Line.scale", false]], "scale() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.scale", false]], "scale2x() (in module pygame.transform)": [[58, "pygame.transform.scale2x", false]], "scale_by() (in module pygame.transform)": [[58, "pygame.transform.scale_by", false]], "scale_by() (pygame.rect method)": [[45, "pygame.Rect.scale_by", false]], "scale_by_ip() (pygame.rect method)": [[45, "pygame.Rect.scale_by_ip", false]], "scale_ip() (pygame.line method)": [[30, "pygame.Line.scale_ip", false]], "scale_to_length() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.scale_to_length", false]], "scale_to_length() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.scale_to_length", false]], "scaletest.main() (in module pygame.examples)": [[27, "pygame.examples.scaletest.main", false]], "scrap_clipboard.main() (in module pygame.examples)": [[27, "pygame.examples.scrap_clipboard.main", false]], "scroll() (pygame.surface method)": [[52, "pygame.Surface.scroll", false]], "scroll.main() (in module pygame.examples)": [[27, "pygame.examples.scroll.main", false]], "sdl (in module pygame.version)": [[44, "pygame.version.SDL", false]], "sequencelike (in module pygame.typing)": [[59, "pygame.typing.SequenceLike", false]], "set_allow_screensaver() (in module pygame.display)": [[24, "pygame.display.set_allow_screensaver", false]], "set_allowed() (in module pygame.event)": [[26, "pygame.event.set_allowed", false]], "set_alpha() (pygame.surface method)": [[52, "pygame.Surface.set_alpha", false]], "set_at() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.set_at", false]], "set_at() (pygame.surface method)": [[52, "pygame.Surface.set_at", false]], "set_blocked() (in module pygame.event)": [[26, "pygame.event.set_blocked", false]], "set_bold() (pygame.font.font method)": [[28, "pygame.font.Font.set_bold", false]], "set_caption() (in module pygame.display)": [[24, "pygame.display.set_caption", false]], "set_clip() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.set_clip", false]], "set_clip() (pygame.surface method)": [[52, "pygame.Surface.set_clip", false]], "set_colorkey() (pygame.surface method)": [[52, "pygame.Surface.set_colorkey", false]], "set_controls() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.set_controls", false]], "set_cursor() (in module pygame.mouse)": [[40, "pygame.mouse.set_cursor", false]], "set_default_resolution() (in module pygame.freetype)": [[29, "pygame.freetype.set_default_resolution", false]], "set_direction() (pygame.font.font method)": [[28, "pygame.font.Font.set_direction", false]], "set_endevent() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.set_endevent", false]], "set_endevent() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.set_endevent", false]], "set_error() (in module pygame)": [[44, "pygame.set_error", false]], "set_eventstate() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.set_eventstate", false]], "set_fullscreen() (pygame.window method)": [[60, "pygame.Window.set_fullscreen", false]], "set_gamma() (in module pygame.display)": [[24, "pygame.display.set_gamma", false]], "set_gamma_ramp() (in module pygame.display)": [[24, "pygame.display.set_gamma_ramp", false]], "set_grab() (in module pygame.event)": [[26, "pygame.event.set_grab", false]], "set_icon() (in module pygame.display)": [[24, "pygame.display.set_icon", false]], "set_icon() (pygame.window method)": [[60, "pygame.Window.set_icon", false]], "set_instrument() (pygame.midi.output method)": [[38, "pygame.midi.Output.set_instrument", false]], "set_italic() (pygame.font.font method)": [[28, "pygame.font.Font.set_italic", false]], "set_led() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.set_led", false]], "set_led() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.set_led", false]], "set_length() (pygame.color method)": [[21, "pygame.Color.set_length", false]], "set_linesize() (pygame.font.font method)": [[28, "pygame.font.Font.set_linesize", false]], "set_mapping() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.set_mapping", false]], "set_masks() (pygame.surface method)": [[52, "pygame.Surface.set_masks", false]], "set_modal_for() (pygame.window method)": [[60, "pygame.Window.set_modal_for", false]], "set_mode() (in module pygame.display)": [[24, "pygame.display.set_mode", false]], "set_mode() (in module pygame.scrap)": [[46, "pygame.scrap.set_mode", false]], "set_mods() (in module pygame.key)": [[34, "pygame.key.set_mods", false]], "set_num_channels() (in module pygame.mixer)": [[39, "pygame.mixer.set_num_channels", false]], "set_palette() (in module pygame.display)": [[24, "pygame.display.set_palette", false]], "set_palette() (pygame.surface method)": [[52, "pygame.Surface.set_palette", false]], "set_palette_at() (pygame.surface method)": [[52, "pygame.Surface.set_palette_at", false]], "set_point_size() (pygame.font.font method)": [[28, "pygame.font.Font.set_point_size", false]], "set_pos() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.set_pos", false]], "set_pos() (in module pygame.mouse)": [[40, "pygame.mouse.set_pos", false]], "set_relative_mode() (in module pygame.mouse)": [[40, "pygame.mouse.set_relative_mode", false]], "set_repeat() (in module pygame.key)": [[34, "pygame.key.set_repeat", false]], "set_reserved() (in module pygame.mixer)": [[39, "pygame.mixer.set_reserved", false]], "set_script() (pygame.font.font method)": [[28, "pygame.font.Font.set_script", false]], "set_shifts() (pygame.surface method)": [[52, "pygame.Surface.set_shifts", false]], "set_smoothscale_backend() (in module pygame.transform)": [[58, "pygame.transform.set_smoothscale_backend", false]], "set_soundfont() (in module pygame.mixer)": [[39, "pygame.mixer.set_soundfont", false]], "set_source_location() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.set_source_location", false]], "set_strikethrough() (pygame.font.font method)": [[28, "pygame.font.Font.set_strikethrough", false]], "set_text_input_rect() (in module pygame.key)": [[34, "pygame.key.set_text_input_rect", false]], "set_timer() (in module pygame.time)": [[56, "pygame.time.set_timer", false]], "set_timing_threshold() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.set_timing_threshold", false]], "set_timing_treshold() (pygame.sprite.layereddirty method)": [[51, "pygame.sprite.LayeredDirty.set_timing_treshold", false]], "set_underline() (pygame.font.font method)": [[28, "pygame.font.Font.set_underline", false]], "set_viewport() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.set_viewport", false]], "set_visible() (in module pygame.mouse)": [[40, "pygame.mouse.set_visible", false]], "set_volume() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.set_volume", false]], "set_volume() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.set_volume", false]], "set_volume() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.set_volume", false]], "set_window_position() (in module pygame.display)": [[24, "pygame.display.set_window_position", false]], "set_windowed() (pygame.window method)": [[60, "pygame.Window.set_windowed", false]], "shape (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.shape", false]], "show() (pygame.window method)": [[60, "pygame.Window.show", false]], "size (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.size", false]], "size (pygame.surface property)": [[52, "pygame.Surface.size", false]], "size (pygame.window property)": [[60, "pygame.Window.size", false]], "size() (pygame.font.font method)": [[28, "pygame.font.Font.size", false]], "slerp() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.slerp", false]], "slerp() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.slerp", false]], "smoothscale() (in module pygame.transform)": [[58, "pygame.transform.smoothscale", false]], "smoothscale_by() (in module pygame.transform)": [[58, "pygame.transform.smoothscale_by", false]], "smoothstep() (in module pygame.math)": [[37, "pygame.math.smoothstep", false]], "smoothstep() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.smoothstep", false]], "smoothstep() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.smoothstep", false]], "solid_overlay() (in module pygame.transform)": [[58, "pygame.transform.solid_overlay", false]], "sound (class in pygame.mixer)": [[39, "pygame.mixer.Sound", false]], "sound.main() (in module pygame.examples)": [[27, "pygame.examples.sound.main", false]], "sound_array_demos.main() (in module pygame.examples)": [[27, "pygame.examples.sound_array_demos.main", false]], "sprite (class in pygame.sprite)": [[51, "pygame.sprite.Sprite", false]], "spritecollide() (in module pygame.sprite)": [[51, "pygame.sprite.spritecollide", false]], "spritecollideany() (in module pygame.sprite)": [[51, "pygame.sprite.spritecollideany", false]], "sprites() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.sprites", false]], "sprites() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.sprites", false]], "srcrect (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.srcrect", false]], "stars.main() (in module pygame.examples)": [[27, "pygame.examples.stars.main", false]], "start() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.start", false]], "start_text_input() (in module pygame.key)": [[34, "pygame.key.start_text_input", false]], "stop() (in module pygame.mixer)": [[39, "pygame.mixer.stop", false]], "stop() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.stop", false]], "stop() (pygame.camera.camera method)": [[20, "pygame.camera.Camera.stop", false]], "stop() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.stop", false]], "stop() (pygame.mixer.sound method)": [[39, "pygame.mixer.Sound.stop", false]], "stop_rumble() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.stop_rumble", false]], "stop_rumble() (pygame.joystick.joystick method)": [[33, "pygame.joystick.Joystick.stop_rumble", false]], "stop_text_input() (in module pygame.key)": [[34, "pygame.key.stop_text_input", false]], "strength (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.strength", false]], "strides (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.strides", false]], "strikethrough (pygame.font.font attribute)": [[28, "pygame.font.Font.strikethrough", false]], "strong (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.strong", false]], "style (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.style", false]], "style_name (pygame.font.font attribute)": [[28, "pygame.font.Font.style_name", false]], "style_name (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.style_name", false]], "subsurface() (pygame.surface method)": [[52, "pygame.Surface.subsurface", false]], "surface (class in pygame)": [[52, "pygame.Surface", false]], "surface (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.surface", false]], "surface_to_array() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.surface_to_array", false]], "switch_layer() (pygame.sprite.layeredupdates method)": [[51, "pygame.sprite.LayeredUpdates.switch_layer", false]], "sysfont() (in module pygame.font)": [[28, "pygame.font.SysFont", false]], "sysfont() (in module pygame.freetype)": [[29, "pygame.freetype.SysFont", false]], "target (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.target", false]], "testsprite.main() (in module pygame.examples)": [[27, "pygame.examples.testsprite.main", false]], "texture (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Texture", false]], "texture (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.texture", false]], "textured_polygon() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.textured_polygon", false]], "threshold() (in module pygame.transform)": [[58, "pygame.transform.threshold", false]], "tick() (pygame.time.clock method)": [[56, "pygame.time.Clock.tick", false]], "tick_busy_loop() (pygame.time.clock method)": [[56, "pygame.time.Clock.tick_busy_loop", false]], "time() (in module pygame.midi)": [[38, "pygame.midi.time", false]], "title (pygame.window attribute)": [[60, "pygame.Window.title", false]], "to_surface() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.to_surface", false]], "to_surface() (pygame.mask.mask method)": [[36, "pygame.mask.Mask.to_surface", false]], "tobytes() (in module pygame.image)": [[32, "pygame.image.tobytes", false]], "toggle_fullscreen() (in module pygame.display)": [[24, "pygame.display.toggle_fullscreen", false]], "top (pygame.circle attribute)": [[30, "pygame.Circle.top", false]], "tostring() (in module pygame.image)": [[32, "pygame.image.tostring", false]], "transpose() (pygame.pixelarray method)": [[42, "pygame.PixelArray.transpose", false]], "trigon() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.trigon", false]], "type (pygame.cursors.cursor attribute)": [[23, "pygame.cursors.Cursor.type", false]], "type (pygame.event.event attribute)": [[26, "pygame.event.Event.type", false]], "ucs4 (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.ucs4", false]], "underline (pygame.font.font attribute)": [[28, "pygame.font.Font.underline", false]], "underline (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.underline", false]], "underline_adjustment (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.underline_adjustment", false]], "union() (pygame.rect method)": [[45, "pygame.Rect.union", false]], "union_ip() (pygame.rect method)": [[45, "pygame.Rect.union_ip", false]], "unionall() (pygame.rect method)": [[45, "pygame.Rect.unionall", false]], "unionall_ip() (pygame.rect method)": [[45, "pygame.Rect.unionall_ip", false]], "unload() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.unload", false]], "unlock() (pygame.surface method)": [[52, "pygame.Surface.unlock", false]], "unmap_rgb() (pygame.surface method)": [[52, "pygame.Surface.unmap_rgb", false]], "unpause() (in module pygame.mixer)": [[39, "pygame.mixer.unpause", false]], "unpause() (in module pygame.mixer.music)": [[41, "pygame.mixer.music.unpause", false]], "unpause() (pygame.mixer.channel method)": [[39, "pygame.mixer.Channel.unpause", false]], "update() (in module pygame.display)": [[24, "pygame.display.update", false]], "update() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.update", false]], "update() (pygame.circle method)": [[30, "pygame.Circle.update", false]], "update() (pygame.color method)": [[21, "pygame.Color.update", false]], "update() (pygame.line method)": [[30, "pygame.Line.update", false]], "update() (pygame.math.vector2 method)": [[37, "pygame.math.Vector2.update", false]], "update() (pygame.math.vector3 method)": [[37, "pygame.math.Vector3.update", false]], "update() (pygame.rect method)": [[45, "pygame.Rect.update", false]], "update() (pygame.sprite.group method)": [[51, "pygame.sprite.Group.update", false]], "update() (pygame.sprite.sprite method)": [[51, "pygame.sprite.Sprite.update", false]], "use_arraytype() (in module pygame.sndarray)": [[49, "pygame.sndarray.use_arraytype", false]], "use_arraytype() (in module pygame.surfarray)": [[53, "pygame.surfarray.use_arraytype", false]], "use_bitmap_strikes (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.use_bitmap_strikes", false]], "utility (pygame.window property)": [[60, "pygame.Window.utility", false]], "vector2 (class in pygame.math)": [[37, "pygame.math.Vector2", false]], "vector3 (class in pygame.math)": [[37, "pygame.math.Vector3", false]], "ver (in module pygame.version)": [[44, "pygame.version.ver", false]], "vernum (in module pygame.version)": [[44, "pygame.version.vernum", false]], "vertical (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.vertical", false]], "vgrade.main() (in module pygame.examples)": [[27, "pygame.examples.vgrade.main", false]], "vline() (in module pygame.gfxdraw)": [[31, "pygame.gfxdraw.vline", false]], "wait() (in module pygame.event)": [[26, "pygame.event.wait", false]], "wait() (in module pygame.time)": [[56, "pygame.time.wait", false]], "was_init() (in module pygame.freetype)": [[29, "pygame.freetype.was_init", false]], "wide (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.wide", false]], "width (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.width", false]], "width (pygame.surface property)": [[52, "pygame.Surface.width", false]], "window (class in pygame)": [[60, "pygame.Window", false]], "window (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Window", false]], "write() (pygame.bufferproxy method)": [[19, "pygame.BufferProxy.write", false]], "write() (pygame.midi.output method)": [[38, "pygame.midi.Output.write", false]], "write_short() (pygame.midi.output method)": [[38, "pygame.midi.Output.write_short", false]], "write_sys_ex() (pygame.midi.output method)": [[38, "pygame.midi.Output.write_sys_ex", false]], "x (pygame.circle attribute)": [[30, "pygame.Circle.x", false]], "y (pygame.circle attribute)": [[30, "pygame.Circle.y", false]]}, "objects": {"": [[14, 0, 1, "c.PG_MAJOR_VERSION", "PG_MAJOR_VERSION"], [14, 0, 1, "c.PG_MINOR_VERSION", "PG_MINOR_VERSION"], [14, 0, 1, "c.PG_PATCH_VERSION", "PG_PATCH_VERSION"], [14, 0, 1, "c.PG_VERSIONNUM", "PG_VERSIONNUM"], [14, 0, 1, "c.PG_VERSION_ATLEAST", "PG_VERSION_ATLEAST"], [1, 1, 1, "c.import_pygame_base", "import_pygame_base"], [2, 1, 1, "c.pgBufferProxy_Check", "pgBufferProxy_Check"], [2, 1, 1, "c.pgBufferProxy_GetParent", "pgBufferProxy_GetParent"], [2, 1, 1, "c.pgBufferProxy_New", "pgBufferProxy_New"], [2, 1, 1, "c.pgBufferProxy_Trip", "pgBufferProxy_Trip"], [2, 3, 1, "c.pgBufferProxy_Type", "pgBufferProxy_Type"], [1, 1, 1, "c.pgBuffer_AsArrayInterface", "pgBuffer_AsArrayInterface"], [1, 1, 1, "c.pgBuffer_AsArrayStruct", "pgBuffer_AsArrayStruct"], [1, 1, 1, "c.pgBuffer_Release", "pgBuffer_Release"], [8, 4, 1, "c.pgChannelObject", "pgChannelObject"], [8, 1, 1, "c.pgChannel_AsInt", "pgChannel_AsInt"], [8, 1, 1, "c.pgChannel_Check", "pgChannel_Check"], [8, 1, 1, "c.pgChannel_New", "pgChannel_New"], [8, 3, 1, "c.pgChannel_Type", "pgChannel_Type"], [3, 1, 1, "c.pgColor_CheckExact", "pgColor_CheckExact"], [3, 1, 1, "c.pgColor_New", "pgColor_New"], [3, 1, 1, "c.pgColor_NewLength", "pgColor_NewLength"], [3, 3, 1, "c.pgColor_Type", "pgColor_Type"], [1, 1, 1, "c.pgDict_AsBuffer", "pgDict_AsBuffer"], [5, 4, 1, "c.pgEventObject", "pgEventObject"], [5, 1, 1, "c.pgEvent_Check", "pgEvent_Check"], [5, 1, 1, "c.pgEvent_GetKeyDownInfo", "pgEvent_GetKeyDownInfo"], [5, 1, 1, "c.pgEvent_GetKeyUpInfo", "pgEvent_GetKeyUpInfo"], [5, 1, 1, "c.pgEvent_GetMouseButtonDownInfo", "pgEvent_GetMouseButtonDownInfo"], [5, 1, 1, "c.pgEvent_GetMouseButtonUpInfo", "pgEvent_GetMouseButtonUpInfo"], [5, 1, 1, "c.pgEvent_New", "pgEvent_New"], [5, 4, 1, "c.pgEvent_Type", "pgEvent_Type"], [1, 3, 1, "c.pgExc_BufferError", "pgExc_BufferError"], [1, 3, 1, "c.pgExc_SDLError", "pgExc_SDLError"], [9, 4, 1, "c.pgFRectObject", "pgFRectObject"], [9, 1, 1, "c.pgFRect_AsRect", "pgFRect_AsRect"], [9, 1, 1, "c.pgFRect_FromObject", "pgFRect_FromObject"], [9, 1, 1, "c.pgFRect_New", "pgFRect_New"], [9, 1, 1, "c.pgFRect_New4", "pgFRect_New4"], [9, 1, 1, "c.pgFRect_Normalize", "pgFRect_Normalize"], [9, 3, 1, "c.pgFRect_Type", "pgFRect_Type"], [6, 4, 1, "c.pgFontObject", "pgFontObject"], [6, 1, 1, "c.pgFont_Check", "pgFont_Check"], [6, 1, 1, "c.pgFont_IS_ALIVE", "pgFont_IS_ALIVE"], [6, 1, 1, "c.pgFont_New", "pgFont_New"], [6, 4, 1, "c.pgFont_Type", "pgFont_Type"], [7, 1, 1, "c.pgJoystick_GetDeviceIndexByInstanceID", "pgJoystick_GetDeviceIndexByInstanceID"], [7, 1, 1, "c.pgJoystick_New", "pgJoystick_New"], [7, 3, 1, "c.pgJoystick_Type", "pgJoystick_Type"], [1, 1, 1, "c.pgObject_GetBuffer", "pgObject_GetBuffer"], [1, 1, 1, "c.pgObject_getRectHelper", "pgObject_getRectHelper"], [10, 1, 1, "c.pgRWops_FromFileObject", "pgRWops_FromFileObject"], [10, 1, 1, "c.pgRWops_FromObject", "pgRWops_FromObject"], [10, 1, 1, "c.pgRWops_IsFileObject", "pgRWops_IsFileObject"], [9, 4, 1, "c.pgRectObject", "pgRectObject"], [9, 1, 1, "c.pgRect_AsRect", "pgRect_AsRect"], [9, 1, 1, "c.pgRect_FromObject", "pgRect_FromObject"], [9, 1, 1, "c.pgRect_New", "pgRect_New"], [9, 1, 1, "c.pgRect_New4", "pgRect_New4"], [9, 1, 1, "c.pgRect_Normalize", "pgRect_Normalize"], [9, 3, 1, "c.pgRect_Type", "pgRect_Type"], [8, 4, 1, "c.pgSoundObject", "pgSoundObject"], [8, 1, 1, "c.pgSound_AsChunk", "pgSound_AsChunk"], [8, 1, 1, "c.pgSound_Check", "pgSound_Check"], [8, 1, 1, "c.pgSound_New", "pgSound_New"], [8, 3, 1, "c.pgSound_Type", "pgSound_Type"], [12, 4, 1, "c.pgSurfaceObject", "pgSurfaceObject"], [12, 1, 1, "c.pgSurface_AsSurface", "pgSurface_AsSurface"], [12, 1, 1, "c.pgSurface_Blit", "pgSurface_Blit"], [12, 1, 1, "c.pgSurface_Check", "pgSurface_Check"], [13, 1, 1, "c.pgSurface_Lock", "pgSurface_Lock"], [13, 1, 1, "c.pgSurface_LockBy", "pgSurface_LockBy"], [12, 1, 1, "c.pgSurface_New", "pgSurface_New"], [13, 1, 1, "c.pgSurface_Prep", "pgSurface_Prep"], [12, 3, 1, "c.pgSurface_Type", "pgSurface_Type"], [13, 1, 1, "c.pgSurface_UnLock", "pgSurface_UnLock"], [13, 1, 1, "c.pgSurface_UnLockBy", "pgSurface_UnLockBy"], [13, 1, 1, "c.pgSurface_Unprep", "pgSurface_Unprep"], [4, 4, 1, "c.pgVidInfoObject", "pgVidInfoObject"], [4, 1, 1, "c.pgVidInfo_AsVidInfo", "pgVidInfo_AsVidInfo"], [4, 1, 1, "c.pgVidInfo_Check", "pgVidInfo_Check"], [4, 1, 1, "c.pgVidInfo_New", "pgVidInfo_New"], [4, 3, 1, "c.pgVidInfo_Type", "pgVidInfo_Type"], [15, 4, 1, "c.pgWindowObject", "pgWindowObject"], [15, 1, 1, "c.pgWindow_Check", "pgWindow_Check"], [15, 3, 1, "c.pgWindow_Type", "pgWindow_Type"], [10, 1, 1, "c.pg_EncodeFilePath", "pg_EncodeFilePath"], [10, 1, 1, "c.pg_EncodeString", "pg_EncodeString"], [1, 1, 1, "c.pg_FloatFromObj", "pg_FloatFromObj"], [1, 1, 1, "c.pg_FloatFromObjIndex", "pg_FloatFromObjIndex"], [1, 1, 1, "c.pg_GetDefaultWindow", "pg_GetDefaultWindow"], [1, 1, 1, "c.pg_GetDefaultWindowSurface", "pg_GetDefaultWindowSurface"], [1, 1, 1, "c.pg_IntFromObj", "pg_IntFromObj"], [1, 1, 1, "c.pg_IntFromObjIndex", "pg_IntFromObjIndex"], [3, 1, 1, "c.pg_MappedColorFromObj", "pg_MappedColorFromObj"], [1, 1, 1, "c.pg_RGBAFromObj", "pg_RGBAFromObj"], [3, 1, 1, "c.pg_RGBAFromObjEx", "pg_RGBAFromObjEx"], [1, 1, 1, "c.pg_RegisterQuit", "pg_RegisterQuit"], [1, 1, 1, "c.pg_SetDefaultWindow", "pg_SetDefaultWindow"], [1, 1, 1, "c.pg_SetDefaultWindowSurface", "pg_SetDefaultWindowSurface"], [1, 1, 1, "c.pg_TwoFloatsFromObj", "pg_TwoFloatsFromObj"], [1, 1, 1, "c.pg_TwoIntsFromObj", "pg_TwoIntsFromObj"], [1, 1, 1, "c.pg_UintFromObj", "pg_UintFromObj"], [1, 1, 1, "c.pg_UintFromObjIndex", "pg_UintFromObjIndex"], [1, 4, 1, "c.pg_buffer", "pg_buffer"], [1, 1, 1, "c.pg_mod_autoinit", "pg_mod_autoinit"], [1, 1, 1, "c.pg_mod_autoquit", "pg_mod_autoquit"], [5, 1, 1, "c.pg_post_event", "pg_post_event"], [5, 1, 1, "c.pg_post_event_dictproxy", "pg_post_event_dictproxy"], [44, 5, 0, "-", "pygame"]], "pgBufferProxy_Check": [[2, 2, 1, "c.pgBufferProxy_Check", "x"]], "pgBufferProxy_GetParent": [[2, 2, 1, "c.pgBufferProxy_GetParent", "obj"]], "pgBufferProxy_New": [[2, 2, 1, "c.pgBufferProxy_New", "get_buffer"], [2, 2, 1, "c.pgBufferProxy_New", "obj"]], "pgBufferProxy_Trip": [[2, 2, 1, "c.pgBufferProxy_Trip", "obj"]], "pgBuffer_AsArrayInterface": [[1, 2, 1, "c.pgBuffer_AsArrayInterface", "view_p"]], "pgBuffer_AsArrayStruct": [[1, 2, 1, "c.pgBuffer_AsArrayStruct", "view_p"]], "pgBuffer_Release": [[1, 2, 1, "c.pgBuffer_Release", "pg_view_p"]], "pgChannel_AsInt": [[8, 2, 1, "c.pgChannel_AsInt", "x"]], "pgChannel_Check": [[8, 2, 1, "c.pgChannel_Check", "obj"]], "pgChannel_New": [[8, 2, 1, "c.pgChannel_New", "channelnum"]], "pgColor_CheckExact": [[3, 2, 1, "c.pgColor_CheckExact", "obj"]], "pgColor_New": [[3, 2, 1, "c.pgColor_New", "rgba"]], "pgColor_NewLength": [[3, 2, 1, "c.pgColor_NewLength", "length"], [3, 2, 1, "c.pgColor_NewLength", "rgba"]], "pgDict_AsBuffer": [[1, 2, 1, "c.pgDict_AsBuffer", "dict"], [1, 2, 1, "c.pgDict_AsBuffer", "flags"], [1, 2, 1, "c.pgDict_AsBuffer", "pg_view_p"]], "pgEventObject": [[5, 3, 1, "c.pgEventObject.type", "type"]], "pgEvent_Check": [[5, 2, 1, "c.pgEvent_Check", "x"]], "pgEvent_New": [[5, 2, 1, "c.pgEvent_New", "event"]], "pgFRectObject": [[9, 3, 1, "c.pgFRectObject.r", "r"]], "pgFRect_AsRect": [[9, 2, 1, "c.pgFRect_AsRect", "obj"]], "pgFRect_FromObject": [[9, 2, 1, "c.pgFRect_FromObject", "obj"], [9, 2, 1, "c.pgFRect_FromObject", "temp"]], "pgFRect_New": [[9, 2, 1, "c.pgFRect_New", "r"]], "pgFRect_New4": [[9, 2, 1, "c.pgFRect_New4", "h"], [9, 2, 1, "c.pgFRect_New4", "w"], [9, 2, 1, "c.pgFRect_New4", "x"], [9, 2, 1, "c.pgFRect_New4", "y"]], "pgFRect_Normalize": [[9, 2, 1, "c.pgFRect_Normalize", "rect"]], "pgFont_Check": [[6, 2, 1, "c.pgFont_Check", "x"]], "pgFont_IS_ALIVE": [[6, 2, 1, "c.pgFont_IS_ALIVE", "o"]], "pgFont_New": [[6, 2, 1, "c.pgFont_New", "filename"], [6, 2, 1, "c.pgFont_New", "font_index"]], "pgJoystick_GetDeviceIndexByInstanceID": [[7, 2, 1, "c.pgJoystick_GetDeviceIndexByInstanceID", "instance_id"]], "pgJoystick_New": [[7, 2, 1, "c.pgJoystick_New", "id"]], "pgObject_GetBuffer": [[1, 2, 1, "c.pgObject_GetBuffer", "flags"], [1, 2, 1, "c.pgObject_GetBuffer", "obj"], [1, 2, 1, "c.pgObject_GetBuffer", "pg_view_p"]], "pgObject_getRectHelper": [[1, 2, 1, "c.pgObject_getRectHelper", "args"], [1, 2, 1, "c.pgObject_getRectHelper", "kwnames"], [1, 2, 1, "c.pgObject_getRectHelper", "nargs"], [1, 2, 1, "c.pgObject_getRectHelper", "rect"], [1, 2, 1, "c.pgObject_getRectHelper", "type"]], "pgRWops_FromFileObject": [[10, 2, 1, "c.pgRWops_FromFileObject", "obj"]], "pgRWops_FromObject": [[10, 2, 1, "c.pgRWops_FromObject", "extptr"], [10, 2, 1, "c.pgRWops_FromObject", "obj"]], "pgRWops_IsFileObject": [[10, 2, 1, "c.pgRWops_IsFileObject", "rw"]], "pgRectObject": [[9, 3, 1, "c.pgRectObject.r", "r"]], "pgRect_AsRect": [[9, 2, 1, "c.pgRect_AsRect", "obj"]], "pgRect_FromObject": [[9, 2, 1, "c.pgRect_FromObject", "obj"], [9, 2, 1, "c.pgRect_FromObject", "temp"]], "pgRect_New": [[9, 2, 1, "c.pgRect_New", "r"]], "pgRect_New4": [[9, 2, 1, "c.pgRect_New4", "h"], [9, 2, 1, "c.pgRect_New4", "w"], [9, 2, 1, "c.pgRect_New4", "x"], [9, 2, 1, "c.pgRect_New4", "y"]], "pgRect_Normalize": [[9, 2, 1, "c.pgRect_Normalize", "rect"]], "pgSound_AsChunk": [[8, 2, 1, "c.pgSound_AsChunk", "x"]], "pgSound_Check": [[8, 2, 1, "c.pgSound_Check", "obj"]], "pgSound_New": [[8, 2, 1, "c.pgSound_New", "chunk"]], "pgSurface_AsSurface": [[12, 2, 1, "c.pgSurface_AsSurface", "x"]], "pgSurface_Blit": [[12, 2, 1, "c.pgSurface_Blit", "blend_flags"], [12, 2, 1, "c.pgSurface_Blit", "dstobj"], [12, 2, 1, "c.pgSurface_Blit", "dstrect"], [12, 2, 1, "c.pgSurface_Blit", "srcobj"], [12, 2, 1, "c.pgSurface_Blit", "srcrect"]], "pgSurface_Check": [[12, 2, 1, "c.pgSurface_Check", "x"]], "pgSurface_Lock": [[13, 2, 1, "c.pgSurface_Lock", "surfobj"]], "pgSurface_LockBy": [[13, 2, 1, "c.pgSurface_LockBy", "lockobj"], [13, 2, 1, "c.pgSurface_LockBy", "surfobj"]], "pgSurface_New": [[12, 2, 1, "c.pgSurface_New", "s"]], "pgSurface_Prep": [[13, 2, 1, "c.pgSurface_Prep", "surfobj"]], "pgSurface_UnLock": [[13, 2, 1, "c.pgSurface_UnLock", "surfobj"]], "pgSurface_UnLockBy": [[13, 2, 1, "c.pgSurface_UnLockBy", "lockobj"], [13, 2, 1, "c.pgSurface_UnLockBy", "surfobj"]], "pgSurface_Unprep": [[13, 2, 1, "c.pgSurface_Unprep", "surfobj"]], "pgVidInfo_AsVidInfo": [[4, 2, 1, "c.pgVidInfo_AsVidInfo", "obj"]], "pgVidInfo_Check": [[4, 2, 1, "c.pgVidInfo_Check", "x"]], "pgVidInfo_New": [[4, 2, 1, "c.pgVidInfo_New", "i"]], "pgWindow_Check": [[15, 2, 1, "c.pgWindow_Check", "x"]], "pg_EncodeFilePath": [[10, 2, 1, "c.pg_EncodeFilePath", "eclass"], [10, 2, 1, "c.pg_EncodeFilePath", "obj"]], "pg_EncodeString": [[10, 2, 1, "c.pg_EncodeString", "eclass"], [10, 2, 1, "c.pg_EncodeString", "encoding"], [10, 2, 1, "c.pg_EncodeString", "errors"], [10, 2, 1, "c.pg_EncodeString", "obj"]], "pg_FloatFromObj": [[1, 2, 1, "c.pg_FloatFromObj", "obj"], [1, 2, 1, "c.pg_FloatFromObj", "val"]], "pg_FloatFromObjIndex": [[1, 2, 1, "c.pg_FloatFromObjIndex", "index"], [1, 2, 1, "c.pg_FloatFromObjIndex", "obj"], [1, 2, 1, "c.pg_FloatFromObjIndex", "val"]], "pg_IntFromObj": [[1, 2, 1, "c.pg_IntFromObj", "obj"], [1, 2, 1, "c.pg_IntFromObj", "val"]], "pg_IntFromObjIndex": [[1, 2, 1, "c.pg_IntFromObjIndex", "index"], [1, 2, 1, "c.pg_IntFromObjIndex", "obj"], [1, 2, 1, "c.pg_IntFromObjIndex", "val"]], "pg_MappedColorFromObj": [[3, 2, 1, "c.pg_MappedColorFromObj", "color"], [3, 2, 1, "c.pg_MappedColorFromObj", "handle_flags"], [3, 2, 1, "c.pg_MappedColorFromObj", "surf"], [3, 2, 1, "c.pg_MappedColorFromObj", "val"]], "pg_RGBAFromObj": [[1, 2, 1, "c.pg_RGBAFromObj", "RGBA"], [1, 2, 1, "c.pg_RGBAFromObj", "obj"]], "pg_RGBAFromObjEx": [[3, 2, 1, "c.pg_RGBAFromObjEx", "color"], [3, 2, 1, "c.pg_RGBAFromObjEx", "handle_flags"], [3, 2, 1, "c.pg_RGBAFromObjEx", "rgba"]], "pg_RegisterQuit": [[1, 2, 1, "c.pg_RegisterQuit", "f"]], "pg_SetDefaultWindow": [[1, 2, 1, "c.pg_SetDefaultWindow", "win"]], "pg_SetDefaultWindowSurface": [[1, 2, 1, "c.pg_SetDefaultWindowSurface", "screen"]], "pg_TwoFloatsFromObj": [[1, 2, 1, "c.pg_TwoFloatsFromObj", "obj"], [1, 2, 1, "c.pg_TwoFloatsFromObj", "val1"], [1, 2, 1, "c.pg_TwoFloatsFromObj", "val2"]], "pg_TwoIntsFromObj": [[1, 2, 1, "c.pg_TwoIntsFromObj", "obj"], [1, 2, 1, "c.pg_TwoIntsFromObj", "v2"], [1, 2, 1, "c.pg_TwoIntsFromObj", "val1"]], "pg_UintFromObj": [[1, 2, 1, "c.pg_UintFromObj", "obj"], [1, 2, 1, "c.pg_UintFromObj", "val"]], "pg_UintFromObjIndex": [[1, 2, 1, "c.pg_UintFromObjIndex", "_index"], [1, 2, 1, "c.pg_UintFromObjIndex", "obj"], [1, 2, 1, "c.pg_UintFromObjIndex", "val"]], "pg_buffer": [[1, 3, 1, "c.pg_buffer.consumer", "consumer"], [1, 3, 1, "c.pg_buffer.release_buffer", "release_buffer"], [1, 3, 1, "c.pg_buffer.view", "view"]], "pg_mod_autoinit": [[1, 2, 1, "c.pg_mod_autoinit", "modname"]], "pg_mod_autoquit": [[1, 2, 1, "c.pg_mod_autoquit", "modname"]], "pg_post_event": [[5, 2, 1, "c.pg_post_event", "dict"], [5, 2, 1, "c.pg_post_event", "type"]], "pg_post_event_dictproxy": [[5, 2, 1, "c.pg_post_event_dictproxy", "dict_proxy"], [5, 2, 1, "c.pg_post_event_dictproxy", "type"]], "pygame": [[19, 6, 1, "", "BufferProxy"], [30, 6, 1, "", "Circle"], [21, 6, 1, "", "Color"], [44, 9, 1, "", "IS_CE"], [30, 6, 1, "", "Line"], [42, 6, 1, "", "PixelArray"], [45, 6, 1, "", "Rect"], [52, 6, 1, "", "Surface"], [60, 6, 1, "", "Window"], [20, 5, 0, "-", "camera"], [23, 5, 0, "-", "cursors"], [24, 5, 0, "-", "display"], [25, 5, 0, "-", "draw"], [44, 11, 1, "", "encode_file_path"], [44, 11, 1, "", "encode_string"], [44, 12, 1, "", "error"], [26, 5, 0, "-", "event"], [27, 5, 0, "-", "examples"], [28, 5, 0, "-", "font"], [29, 5, 0, "-", "freetype"], [30, 5, 0, "-", "geometry"], [44, 11, 1, "", "get_error"], [44, 11, 1, "", "get_init"], [44, 11, 1, "", "get_sdl_byteorder"], [44, 11, 1, "", "get_sdl_version"], [31, 5, 0, "-", "gfxdraw"], [32, 5, 0, "-", "image"], [44, 11, 1, "", "init"], [33, 5, 0, "-", "joystick"], [34, 5, 0, "-", "key"], [35, 5, 0, "-", "locals"], [36, 5, 0, "-", "mask"], [37, 5, 0, "-", "math"], [38, 5, 0, "-", "midi"], [39, 5, 0, "-", "mixer"], [40, 5, 0, "-", "mouse"], [43, 5, 0, "-", "pixelcopy"], [44, 11, 1, "", "print_debug_info"], [44, 11, 1, "", "quit"], [44, 11, 1, "", "register_quit"], [46, 5, 0, "-", "scrap"], [44, 11, 1, "", "set_error"], [49, 5, 0, "-", "sndarray"], [51, 5, 0, "-", "sprite"], [53, 5, 0, "-", "surfarray"], [54, 5, 0, "-", "system"], [55, 5, 0, "-", "tests"], [56, 5, 0, "-", "time"], [58, 5, 0, "-", "transform"], [59, 5, 0, "-", "typing"], [44, 5, 0, "-", "version"]], "pygame.BufferProxy": [[19, 7, 1, "", "length"], [19, 7, 1, "", "parent"], [19, 7, 1, "", "raw"], [19, 8, 1, "", "write"]], "pygame.Circle": [[30, 7, 1, "", "area"], [30, 8, 1, "", "as_frect"], [30, 8, 1, "", "as_rect"], [30, 7, 1, "", "bottom"], [30, 7, 1, "", "center"], [30, 7, 1, "", "circumference"], [30, 8, 1, "", "collidecircle"], [30, 8, 1, "", "collidelist"], [30, 8, 1, "", "collidelistall"], [30, 8, 1, "", "collidepoint"], [30, 8, 1, "", "colliderect"], [30, 8, 1, "", "collideswith"], [30, 8, 1, "", "contains"], [30, 8, 1, "", "copy"], [30, 7, 1, "", "diameter"], [30, 8, 1, "", "intersect"], [30, 7, 1, "", "left"], [30, 8, 1, "", "move"], [30, 8, 1, "", "move_ip"], [30, 7, 1, "", "r"], [30, 7, 1, "", "r_sqr"], [30, 7, 1, "", "right"], [30, 8, 1, "", "rotate"], [30, 8, 1, "", "rotate_ip"], [30, 7, 1, "", "top"], [30, 8, 1, "", "update"], [30, 7, 1, "", "x"], [30, 7, 1, "", "y"]], "pygame.Color": [[21, 7, 1, "", "a"], [21, 7, 1, "", "b"], [21, 7, 1, "", "cmy"], [21, 8, 1, "", "correct_gamma"], [21, 8, 1, "", "from_cmy"], [21, 8, 1, "", "from_hex"], [21, 8, 1, "", "from_hsla"], [21, 8, 1, "", "from_hsva"], [21, 8, 1, "", "from_i1i2i3"], [21, 8, 1, "", "from_normalized"], [21, 7, 1, "", "g"], [21, 8, 1, "", "grayscale"], [21, 7, 1, "", "hex"], [21, 7, 1, "", "hsla"], [21, 7, 1, "", "hsva"], [21, 7, 1, "", "i1i2i3"], [21, 8, 1, "", "lerp"], [21, 8, 1, "", "normalize"], [21, 7, 1, "", "normalized"], [21, 8, 1, "", "premul_alpha"], [21, 7, 1, "", "r"], [21, 8, 1, "", "set_length"], [21, 8, 1, "", "update"]], "pygame.Line": [[30, 7, 1, "", "a"], [30, 7, 1, "", "ax"], [30, 7, 1, "", "ay"], [30, 7, 1, "", "b"], [30, 7, 1, "", "bx"], [30, 7, 1, "", "by"], [30, 8, 1, "", "copy"], [30, 8, 1, "", "flip_ab"], [30, 8, 1, "", "flip_ab_ip"], [30, 7, 1, "", "length"], [30, 8, 1, "", "move"], [30, 8, 1, "", "move_ip"], [30, 8, 1, "", "project"], [30, 8, 1, "", "scale"], [30, 8, 1, "", "scale_ip"], [30, 8, 1, "", "update"]], "pygame.PixelArray": [[42, 8, 1, "", "close"], [42, 8, 1, "", "compare"], [42, 8, 1, "", "extract"], [42, 7, 1, "", "itemsize"], [42, 8, 1, "", "make_surface"], [42, 7, 1, "", "ndim"], [42, 8, 1, "", "replace"], [42, 7, 1, "", "shape"], [42, 7, 1, "", "strides"], [42, 7, 1, "", "surface"], [42, 8, 1, "", "transpose"]], "pygame.Rect": [[45, 8, 1, "", "clamp"], [45, 8, 1, "", "clamp_ip"], [45, 8, 1, "", "clip"], [45, 8, 1, "", "clipline"], [45, 8, 1, "", "collidedict"], [45, 8, 1, "", "collidedictall"], [45, 8, 1, "", "collidelist"], [45, 8, 1, "", "collidelistall"], [45, 8, 1, "", "collideobjects"], [45, 8, 1, "", "collideobjectsall"], [45, 8, 1, "", "collidepoint"], [45, 8, 1, "", "colliderect"], [45, 8, 1, "", "contains"], [45, 8, 1, "", "copy"], [45, 8, 1, "", "fit"], [45, 8, 1, "", "inflate"], [45, 8, 1, "", "inflate_ip"], [45, 8, 1, "", "move"], [45, 8, 1, "", "move_ip"], [45, 8, 1, "", "move_to"], [45, 8, 1, "", "normalize"], [45, 8, 1, "", "scale_by"], [45, 8, 1, "", "scale_by_ip"], [45, 8, 1, "", "union"], [45, 8, 1, "", "union_ip"], [45, 8, 1, "", "unionall"], [45, 8, 1, "", "unionall_ip"], [45, 8, 1, "", "update"]], "pygame.Surface": [[52, 10, 1, "", "_pixels_address"], [52, 8, 1, "", "blit"], [52, 8, 1, "", "blits"], [52, 8, 1, "", "convert"], [52, 8, 1, "", "convert_alpha"], [52, 8, 1, "", "copy"], [52, 8, 1, "", "fblits"], [52, 8, 1, "", "fill"], [52, 8, 1, "", "get_abs_offset"], [52, 8, 1, "", "get_abs_parent"], [52, 8, 1, "", "get_alpha"], [52, 8, 1, "", "get_at"], [52, 8, 1, "", "get_at_mapped"], [52, 8, 1, "", "get_bitsize"], [52, 8, 1, "", "get_bounding_rect"], [52, 8, 1, "", "get_buffer"], [52, 8, 1, "", "get_bytesize"], [52, 8, 1, "", "get_clip"], [52, 8, 1, "", "get_colorkey"], [52, 8, 1, "", "get_flags"], [52, 8, 1, "", "get_frect"], [52, 8, 1, "", "get_height"], [52, 8, 1, "", "get_locked"], [52, 8, 1, "", "get_locks"], [52, 8, 1, "", "get_losses"], [52, 8, 1, "", "get_masks"], [52, 8, 1, "", "get_offset"], [52, 8, 1, "", "get_palette"], [52, 8, 1, "", "get_palette_at"], [52, 8, 1, "", "get_parent"], [52, 8, 1, "", "get_pitch"], [52, 8, 1, "", "get_rect"], [52, 8, 1, "", "get_shifts"], [52, 8, 1, "", "get_size"], [52, 8, 1, "", "get_view"], [52, 8, 1, "", "get_width"], [52, 10, 1, "", "height"], [52, 8, 1, "", "lock"], [52, 8, 1, "", "map_rgb"], [52, 8, 1, "", "mustlock"], [52, 8, 1, "", "premul_alpha"], [52, 8, 1, "", "premul_alpha_ip"], [52, 8, 1, "", "scroll"], [52, 8, 1, "", "set_alpha"], [52, 8, 1, "", "set_at"], [52, 8, 1, "", "set_clip"], [52, 8, 1, "", "set_colorkey"], [52, 8, 1, "", "set_masks"], [52, 8, 1, "", "set_palette"], [52, 8, 1, "", "set_palette_at"], [52, 8, 1, "", "set_shifts"], [52, 10, 1, "", "size"], [52, 8, 1, "", "subsurface"], [52, 8, 1, "", "unlock"], [52, 8, 1, "", "unmap_rgb"], [52, 10, 1, "", "width"]], "pygame.Window": [[60, 7, 1, "", "always_on_top"], [60, 7, 1, "", "borderless"], [60, 8, 1, "", "destroy"], [60, 8, 1, "", "flash"], [60, 8, 1, "", "flip"], [60, 8, 1, "", "focus"], [60, 10, 1, "", "focused"], [60, 8, 1, "", "from_display_module"], [60, 8, 1, "", "get_surface"], [60, 7, 1, "", "grab_keyboard"], [60, 7, 1, "", "grab_mouse"], [60, 10, 1, "", "handle"], [60, 8, 1, "", "hide"], [60, 10, 1, "", "id"], [60, 10, 1, "", "keyboard_grabbed"], [60, 8, 1, "", "maximize"], [60, 10, 1, "", "maximum_size"], [60, 8, 1, "", "minimize"], [60, 10, 1, "", "minimum_size"], [60, 10, 1, "", "mouse_grabbed"], [60, 10, 1, "", "mouse_rect"], [60, 7, 1, "", "opacity"], [60, 10, 1, "", "opengl"], [60, 10, 1, "", "position"], [60, 7, 1, "", "resizable"], [60, 8, 1, "", "restore"], [60, 8, 1, "", "set_fullscreen"], [60, 8, 1, "", "set_icon"], [60, 8, 1, "", "set_modal_for"], [60, 8, 1, "", "set_windowed"], [60, 8, 1, "", "show"], [60, 10, 1, "", "size"], [60, 7, 1, "", "title"], [60, 10, 1, "", "utility"]], "pygame._sdl2": [[47, 5, 0, "-", "controller"], [57, 5, 0, "-", "touch"], [48, 5, 0, "-", "video"]], "pygame._sdl2.controller": [[47, 6, 1, "", "Controller"], [47, 11, 1, "", "get_count"], [47, 11, 1, "", "get_eventstate"], [47, 11, 1, "", "get_init"], [47, 11, 1, "", "init"], [47, 11, 1, "", "is_controller"], [47, 11, 1, "", "name_forindex"], [47, 11, 1, "", "quit"], [47, 11, 1, "", "set_eventstate"]], "pygame._sdl2.controller.Controller": [[47, 8, 1, "", "as_joystick"], [47, 8, 1, "", "attached"], [47, 8, 1, "", "from_joystick"], [47, 8, 1, "", "get_axis"], [47, 8, 1, "", "get_button"], [47, 8, 1, "", "get_init"], [47, 8, 1, "", "get_mapping"], [47, 8, 1, "", "init"], [47, 8, 1, "", "quit"], [47, 8, 1, "", "rumble"], [47, 8, 1, "", "set_led"], [47, 8, 1, "", "set_mapping"], [47, 8, 1, "", "stop_rumble"]], "pygame._sdl2.touch": [[57, 11, 1, "", "get_device"], [57, 11, 1, "", "get_finger"], [57, 11, 1, "", "get_num_devices"], [57, 11, 1, "", "get_num_fingers"]], "pygame._sdl2.video": [[48, 6, 1, "", "Image"], [48, 6, 1, "", "Renderer"], [48, 6, 1, "", "RendererDriverInfo"], [48, 6, 1, "", "Texture"], [48, 6, 1, "", "Window"], [48, 11, 1, "", "get_drivers"], [48, 11, 1, "", "get_grabbed_window"]], "pygame._sdl2.video.Image": [[48, 7, 1, "", "alpha"], [48, 7, 1, "", "angle"], [48, 7, 1, "", "blend_mode"], [48, 7, 1, "", "color"], [48, 8, 1, "", "draw"], [48, 7, 1, "", "flip_x"], [48, 7, 1, "", "flip_y"], [48, 8, 1, "", "get_rect"], [48, 7, 1, "", "origin"], [48, 7, 1, "", "srcrect"], [48, 7, 1, "", "texture"]], "pygame._sdl2.video.Renderer": [[48, 8, 1, "", "blit"], [48, 8, 1, "", "clear"], [48, 8, 1, "", "compose_custom_blend_mode"], [48, 8, 1, "", "coordinates_from_window"], [48, 8, 1, "", "coordinates_to_window"], [48, 7, 1, "", "draw_blend_mode"], [48, 7, 1, "", "draw_color"], [48, 8, 1, "", "draw_line"], [48, 8, 1, "", "draw_point"], [48, 8, 1, "", "draw_quad"], [48, 8, 1, "", "draw_rect"], [48, 8, 1, "", "draw_triangle"], [48, 8, 1, "", "fill_quad"], [48, 8, 1, "", "fill_rect"], [48, 8, 1, "", "fill_triangle"], [48, 8, 1, "", "from_window"], [48, 8, 1, "", "get_viewport"], [48, 7, 1, "", "logical_size"], [48, 8, 1, "", "present"], [48, 7, 1, "", "scale"], [48, 8, 1, "", "set_viewport"], [48, 7, 1, "", "target"], [48, 8, 1, "", "to_surface"]], "pygame._sdl2.video.Texture": [[48, 7, 1, "", "alpha"], [48, 7, 1, "", "blend_mode"], [48, 7, 1, "", "color"], [48, 8, 1, "", "draw"], [48, 8, 1, "", "draw_quad"], [48, 8, 1, "", "draw_triangle"], [48, 8, 1, "", "from_surface"], [48, 8, 1, "", "get_rect"], [48, 7, 1, "", "height"], [48, 7, 1, "", "renderer"], [48, 8, 1, "", "update"], [48, 7, 1, "", "width"]], "pygame.camera": [[20, 6, 1, "", "Camera"], [20, 11, 1, "", "colorspace"], [20, 11, 1, "", "get_backends"], [20, 11, 1, "", "init"], [20, 11, 1, "", "list_cameras"]], "pygame.camera.Camera": [[20, 8, 1, "", "get_controls"], [20, 8, 1, "", "get_image"], [20, 8, 1, "", "get_raw"], [20, 8, 1, "", "get_size"], [20, 8, 1, "", "query_image"], [20, 8, 1, "", "set_controls"], [20, 8, 1, "", "start"], [20, 8, 1, "", "stop"]], "pygame.cursors": [[23, 6, 1, "", "Cursor"], [23, 11, 1, "", "compile"], [23, 11, 1, "", "load_xbm"]], "pygame.cursors.Cursor": [[23, 8, 1, "", "copy"], [23, 7, 1, "", "data"], [23, 7, 1, "", "type"]], "pygame.display": [[24, 11, 1, "", "Info"], [24, 11, 1, "", "flip"], [24, 11, 1, "", "get_active"], [24, 11, 1, "", "get_allow_screensaver"], [24, 11, 1, "", "get_caption"], [24, 11, 1, "", "get_current_refresh_rate"], [24, 11, 1, "", "get_desktop_refresh_rates"], [24, 11, 1, "", "get_desktop_sizes"], [24, 11, 1, "", "get_driver"], [24, 11, 1, "", "get_init"], [24, 11, 1, "", "get_num_displays"], [24, 11, 1, "", "get_surface"], [24, 11, 1, "", "get_window_position"], [24, 11, 1, "", "get_window_size"], [24, 11, 1, "", "get_wm_info"], [24, 11, 1, "", "gl_get_attribute"], [24, 11, 1, "", "gl_set_attribute"], [24, 11, 1, "", "iconify"], [24, 11, 1, "", "init"], [24, 11, 1, "", "is_fullscreen"], [24, 11, 1, "", "is_vsync"], [24, 11, 1, "", "list_modes"], [24, 11, 1, "", "message_box"], [24, 11, 1, "", "mode_ok"], [24, 11, 1, "", "quit"], [24, 11, 1, "", "set_allow_screensaver"], [24, 11, 1, "", "set_caption"], [24, 11, 1, "", "set_gamma"], [24, 11, 1, "", "set_gamma_ramp"], [24, 11, 1, "", "set_icon"], [24, 11, 1, "", "set_mode"], [24, 11, 1, "", "set_palette"], [24, 11, 1, "", "set_window_position"], [24, 11, 1, "", "toggle_fullscreen"], [24, 11, 1, "", "update"]], "pygame.draw": [[25, 11, 1, "", "aacircle"], [25, 11, 1, "", "aaline"], [25, 11, 1, "", "aalines"], [25, 11, 1, "", "arc"], [25, 11, 1, "", "circle"], [25, 11, 1, "", "ellipse"], [25, 11, 1, "", "flood_fill"], [25, 11, 1, "", "line"], [25, 11, 1, "", "lines"], [25, 11, 1, "", "polygon"], [25, 11, 1, "", "rect"]], "pygame.event": [[26, 6, 1, "", "Event"], [26, 11, 1, "", "clear"], [26, 11, 1, "", "custom_type"], [26, 11, 1, "", "event_name"], [26, 11, 1, "", "get"], [26, 11, 1, "", "get_blocked"], [26, 11, 1, "", "get_grab"], [26, 11, 1, "", "peek"], [26, 11, 1, "", "poll"], [26, 11, 1, "", "post"], [26, 11, 1, "", "pump"], [26, 11, 1, "", "set_allowed"], [26, 11, 1, "", "set_blocked"], [26, 11, 1, "", "set_grab"], [26, 11, 1, "", "wait"]], "pygame.event.Event": [[26, 7, 1, "", "__dict__"], [26, 7, 1, "", "type"]], "pygame.examples.aliens": [[27, 11, 1, "", "main"]], "pygame.examples.arraydemo": [[27, 11, 1, "", "main"]], "pygame.examples.blend_fill": [[27, 11, 1, "", "main"]], "pygame.examples.blit_blends": [[27, 11, 1, "", "main"]], "pygame.examples.camera": [[27, 11, 1, "", "main"]], "pygame.examples.chimp": [[27, 11, 1, "", "main"]], "pygame.examples.cursors": [[27, 11, 1, "", "main"]], "pygame.examples.eventlist": [[27, 11, 1, "", "main"]], "pygame.examples.fonty": [[27, 11, 1, "", "main"]], "pygame.examples.freetype_misc": [[27, 11, 1, "", "main"]], "pygame.examples.glcube": [[27, 11, 1, "", "main"]], "pygame.examples.headless_no_windows_needed": [[27, 11, 1, "", "main"]], "pygame.examples.joystick": [[27, 11, 1, "", "main"]], "pygame.examples.liquid": [[27, 11, 1, "", "main"]], "pygame.examples.mask": [[27, 11, 1, "", "main"]], "pygame.examples.midi": [[27, 11, 1, "", "main"]], "pygame.examples.moveit": [[27, 11, 1, "", "main"]], "pygame.examples.pixelarray": [[27, 11, 1, "", "main"]], "pygame.examples.playmus": [[27, 11, 1, "", "main"]], "pygame.examples.scaletest": [[27, 11, 1, "", "main"]], "pygame.examples.scrap_clipboard": [[27, 11, 1, "", "main"]], "pygame.examples.scroll": [[27, 11, 1, "", "main"]], "pygame.examples.sound": [[27, 11, 1, "", "main"]], "pygame.examples.sound_array_demos": [[27, 11, 1, "", "main"]], "pygame.examples.stars": [[27, 11, 1, "", "main"]], "pygame.examples.testsprite": [[27, 11, 1, "", "main"]], "pygame.examples.vgrade": [[27, 11, 1, "", "main"]], "pygame.font": [[28, 6, 1, "", "Font"], [28, 11, 1, "", "SysFont"], [28, 11, 1, "", "get_default_font"], [28, 11, 1, "", "get_fonts"], [28, 11, 1, "", "get_init"], [28, 11, 1, "", "get_sdl_ttf_version"], [28, 11, 1, "", "init"], [28, 11, 1, "", "match_font"], [28, 11, 1, "", "quit"]], "pygame.font.Font": [[28, 7, 1, "", "align"], [28, 7, 1, "", "bold"], [28, 8, 1, "", "get_ascent"], [28, 8, 1, "", "get_bold"], [28, 8, 1, "", "get_descent"], [28, 8, 1, "", "get_height"], [28, 8, 1, "", "get_italic"], [28, 8, 1, "", "get_linesize"], [28, 8, 1, "", "get_point_size"], [28, 8, 1, "", "get_strikethrough"], [28, 8, 1, "", "get_underline"], [28, 7, 1, "", "italic"], [28, 8, 1, "", "metrics"], [28, 7, 1, "", "name"], [28, 7, 1, "", "outline"], [28, 7, 1, "", "point_size"], [28, 8, 1, "", "render"], [28, 8, 1, "", "set_bold"], [28, 8, 1, "", "set_direction"], [28, 8, 1, "", "set_italic"], [28, 8, 1, "", "set_linesize"], [28, 8, 1, "", "set_point_size"], [28, 8, 1, "", "set_script"], [28, 8, 1, "", "set_strikethrough"], [28, 8, 1, "", "set_underline"], [28, 8, 1, "", "size"], [28, 7, 1, "", "strikethrough"], [28, 7, 1, "", "style_name"], [28, 7, 1, "", "underline"]], "pygame.freetype": [[29, 6, 1, "", "Font"], [29, 11, 1, "", "SysFont"], [29, 11, 1, "", "get_cache_size"], [29, 11, 1, "", "get_default_font"], [29, 11, 1, "", "get_default_resolution"], [29, 11, 1, "", "get_error"], [29, 11, 1, "", "get_init"], [29, 11, 1, "", "get_version"], [29, 11, 1, "", "init"], [29, 11, 1, "", "quit"], [29, 11, 1, "", "set_default_resolution"], [29, 11, 1, "", "was_init"]], "pygame.freetype.Font": [[29, 7, 1, "", "antialiased"], [29, 7, 1, "", "ascender"], [29, 7, 1, "", "bgcolor"], [29, 7, 1, "", "descender"], [29, 7, 1, "", "fgcolor"], [29, 7, 1, "", "fixed_sizes"], [29, 7, 1, "", "fixed_width"], [29, 8, 1, "", "get_metrics"], [29, 8, 1, "", "get_rect"], [29, 8, 1, "", "get_sized_ascender"], [29, 8, 1, "", "get_sized_descender"], [29, 8, 1, "", "get_sized_glyph_height"], [29, 8, 1, "", "get_sized_height"], [29, 8, 1, "", "get_sizes"], [29, 7, 1, "", "height"], [29, 7, 1, "", "kerning"], [29, 7, 1, "", "name"], [29, 7, 1, "", "oblique"], [29, 7, 1, "", "origin"], [29, 7, 1, "", "pad"], [29, 7, 1, "", "path"], [29, 8, 1, "", "render"], [29, 8, 1, "", "render_raw"], [29, 8, 1, "", "render_raw_to"], [29, 8, 1, "", "render_to"], [29, 7, 1, "", "resolution"], [29, 7, 1, "", "rotation"], [29, 7, 1, "", "scalable"], [29, 7, 1, "", "size"], [29, 7, 1, "", "strength"], [29, 7, 1, "", "strong"], [29, 7, 1, "", "style"], [29, 7, 1, "", "style_name"], [29, 7, 1, "", "ucs4"], [29, 7, 1, "", "underline"], [29, 7, 1, "", "underline_adjustment"], [29, 7, 1, "", "use_bitmap_strikes"], [29, 7, 1, "", "vertical"], [29, 7, 1, "", "wide"]], "pygame.gfxdraw": [[31, 11, 1, "", "aacircle"], [31, 11, 1, "", "aaellipse"], [31, 11, 1, "", "aapolygon"], [31, 11, 1, "", "aatrigon"], [31, 11, 1, "", "arc"], [31, 11, 1, "", "bezier"], [31, 11, 1, "", "box"], [31, 11, 1, "", "circle"], [31, 11, 1, "", "ellipse"], [31, 11, 1, "", "filled_circle"], [31, 11, 1, "", "filled_ellipse"], [31, 11, 1, "", "filled_polygon"], [31, 11, 1, "", "filled_trigon"], [31, 11, 1, "", "hline"], [31, 11, 1, "", "line"], [31, 11, 1, "", "pie"], [31, 11, 1, "", "pixel"], [31, 11, 1, "", "polygon"], [31, 11, 1, "", "rectangle"], [31, 11, 1, "", "textured_polygon"], [31, 11, 1, "", "trigon"], [31, 11, 1, "", "vline"]], "pygame.image": [[32, 11, 1, "", "frombuffer"], [32, 11, 1, "", "frombytes"], [32, 11, 1, "", "fromstring"], [32, 11, 1, "", "get_extended"], [32, 11, 1, "", "get_sdl_image_version"], [32, 11, 1, "", "load"], [32, 11, 1, "", "load_animation"], [32, 11, 1, "", "load_basic"], [32, 11, 1, "", "load_extended"], [32, 11, 1, "", "load_sized_svg"], [32, 11, 1, "", "save"], [32, 11, 1, "", "save_extended"], [32, 11, 1, "", "tobytes"], [32, 11, 1, "", "tostring"]], "pygame.joystick": [[33, 6, 1, "", "Joystick"], [33, 11, 1, "", "get_count"], [33, 11, 1, "", "get_init"], [33, 11, 1, "", "init"], [33, 11, 1, "", "quit"]], "pygame.joystick.Joystick": [[33, 8, 1, "", "get_axis"], [33, 8, 1, "", "get_ball"], [33, 8, 1, "", "get_button"], [33, 8, 1, "", "get_guid"], [33, 8, 1, "", "get_hat"], [33, 8, 1, "", "get_id"], [33, 8, 1, "", "get_init"], [33, 8, 1, "", "get_instance_id"], [33, 8, 1, "", "get_name"], [33, 8, 1, "", "get_numaxes"], [33, 8, 1, "", "get_numballs"], [33, 8, 1, "", "get_numbuttons"], [33, 8, 1, "", "get_numhats"], [33, 8, 1, "", "get_power_level"], [33, 8, 1, "", "init"], [33, 8, 1, "", "quit"], [33, 8, 1, "", "rumble"], [33, 8, 1, "", "set_led"], [33, 8, 1, "", "stop_rumble"]], "pygame.key": [[34, 11, 1, "", "get_focused"], [34, 11, 1, "", "get_just_pressed"], [34, 11, 1, "", "get_just_released"], [34, 11, 1, "", "get_mods"], [34, 11, 1, "", "get_pressed"], [34, 11, 1, "", "get_repeat"], [34, 11, 1, "", "key_code"], [34, 11, 1, "", "name"], [34, 11, 1, "", "set_mods"], [34, 11, 1, "", "set_repeat"], [34, 11, 1, "", "set_text_input_rect"], [34, 11, 1, "", "start_text_input"], [34, 11, 1, "", "stop_text_input"]], "pygame.mask": [[36, 6, 1, "", "Mask"], [36, 11, 1, "", "from_surface"], [36, 11, 1, "", "from_threshold"]], "pygame.mask.Mask": [[36, 8, 1, "", "angle"], [36, 8, 1, "", "centroid"], [36, 8, 1, "", "clear"], [36, 8, 1, "", "connected_component"], [36, 8, 1, "", "connected_components"], [36, 8, 1, "", "convolve"], [36, 8, 1, "", "copy"], [36, 8, 1, "", "count"], [36, 8, 1, "", "draw"], [36, 8, 1, "", "erase"], [36, 8, 1, "", "fill"], [36, 8, 1, "", "get_at"], [36, 8, 1, "", "get_bounding_rects"], [36, 8, 1, "", "get_rect"], [36, 8, 1, "", "get_size"], [36, 8, 1, "", "invert"], [36, 8, 1, "", "outline"], [36, 8, 1, "", "overlap"], [36, 8, 1, "", "overlap_area"], [36, 8, 1, "", "overlap_mask"], [36, 8, 1, "", "scale"], [36, 8, 1, "", "set_at"], [36, 8, 1, "", "to_surface"]], "pygame.math": [[37, 6, 1, "", "Vector2"], [37, 6, 1, "", "Vector3"], [37, 11, 1, "", "clamp"], [37, 11, 1, "", "invlerp"], [37, 11, 1, "", "lerp"], [37, 11, 1, "", "remap"], [37, 11, 1, "", "smoothstep"]], "pygame.math.Vector2": [[37, 7, 1, "", "angle"], [37, 7, 1, "", "angle_rad"], [37, 8, 1, "", "angle_to"], [37, 8, 1, "", "as_polar"], [37, 8, 1, "", "clamp_magnitude"], [37, 8, 1, "", "clamp_magnitude_ip"], [37, 8, 1, "", "copy"], [37, 8, 1, "", "cross"], [37, 8, 1, "", "distance_squared_to"], [37, 8, 1, "", "distance_to"], [37, 8, 1, "", "dot"], [37, 8, 1, "", "elementwise"], [37, 7, 1, "", "epsilon"], [37, 8, 1, "", "from_polar"], [37, 8, 1, "", "is_normalized"], [37, 8, 1, "", "length"], [37, 8, 1, "", "length_squared"], [37, 8, 1, "", "lerp"], [37, 8, 1, "", "magnitude"], [37, 8, 1, "", "magnitude_squared"], [37, 8, 1, "", "move_towards"], [37, 8, 1, "", "move_towards_ip"], [37, 8, 1, "", "normalize"], [37, 8, 1, "", "normalize_ip"], [37, 8, 1, "", "project"], [37, 8, 1, "", "reflect"], [37, 8, 1, "", "reflect_ip"], [37, 8, 1, "", "rotate"], [37, 8, 1, "", "rotate_ip"], [37, 8, 1, "", "rotate_ip_rad"], [37, 8, 1, "", "rotate_rad"], [37, 8, 1, "", "rotate_rad_ip"], [37, 8, 1, "", "scale_to_length"], [37, 8, 1, "", "slerp"], [37, 8, 1, "", "smoothstep"], [37, 8, 1, "", "update"]], "pygame.math.Vector3": [[37, 8, 1, "", "angle_to"], [37, 8, 1, "", "as_spherical"], [37, 8, 1, "", "clamp_magnitude"], [37, 8, 1, "", "clamp_magnitude_ip"], [37, 8, 1, "", "copy"], [37, 8, 1, "", "cross"], [37, 8, 1, "", "distance_squared_to"], [37, 8, 1, "", "distance_to"], [37, 8, 1, "", "dot"], [37, 8, 1, "", "elementwise"], [37, 7, 1, "", "epsilon"], [37, 8, 1, "", "from_spherical"], [37, 8, 1, "", "is_normalized"], [37, 8, 1, "", "length"], [37, 8, 1, "", "length_squared"], [37, 8, 1, "", "lerp"], [37, 8, 1, "", "magnitude"], [37, 8, 1, "", "magnitude_squared"], [37, 8, 1, "", "move_towards"], [37, 8, 1, "", "move_towards_ip"], [37, 8, 1, "", "normalize"], [37, 8, 1, "", "normalize_ip"], [37, 8, 1, "", "project"], [37, 8, 1, "", "reflect"], [37, 8, 1, "", "reflect_ip"], [37, 8, 1, "", "rotate"], [37, 8, 1, "", "rotate_ip"], [37, 8, 1, "", "rotate_ip_rad"], [37, 8, 1, "", "rotate_rad"], [37, 8, 1, "", "rotate_rad_ip"], [37, 8, 1, "", "rotate_x"], [37, 8, 1, "", "rotate_x_ip"], [37, 8, 1, "", "rotate_x_ip_rad"], [37, 8, 1, "", "rotate_x_rad"], [37, 8, 1, "", "rotate_x_rad_ip"], [37, 8, 1, "", "rotate_y"], [37, 8, 1, "", "rotate_y_ip"], [37, 8, 1, "", "rotate_y_ip_rad"], [37, 8, 1, "", "rotate_y_rad"], [37, 8, 1, "", "rotate_y_rad_ip"], [37, 8, 1, "", "rotate_z"], [37, 8, 1, "", "rotate_z_ip"], [37, 8, 1, "", "rotate_z_ip_rad"], [37, 8, 1, "", "rotate_z_rad"], [37, 8, 1, "", "rotate_z_rad_ip"], [37, 8, 1, "", "scale_to_length"], [37, 8, 1, "", "slerp"], [37, 8, 1, "", "smoothstep"], [37, 8, 1, "", "update"]], "pygame.midi": [[38, 6, 1, "", "Input"], [38, 12, 1, "", "MidiException"], [38, 6, 1, "", "Output"], [38, 11, 1, "", "frequency_to_midi"], [38, 11, 1, "", "get_count"], [38, 11, 1, "", "get_default_input_id"], [38, 11, 1, "", "get_default_output_id"], [38, 11, 1, "", "get_device_info"], [38, 11, 1, "", "get_init"], [38, 11, 1, "", "init"], [38, 11, 1, "", "midi_to_ansi_note"], [38, 11, 1, "", "midi_to_frequency"], [38, 11, 1, "", "midis2events"], [38, 11, 1, "", "quit"], [38, 11, 1, "", "time"]], "pygame.midi.Input": [[38, 8, 1, "", "close"], [38, 8, 1, "", "poll"], [38, 8, 1, "", "read"]], "pygame.midi.Output": [[38, 8, 1, "", "abort"], [38, 8, 1, "", "close"], [38, 8, 1, "", "note_off"], [38, 8, 1, "", "note_on"], [38, 8, 1, "", "pitch_bend"], [38, 8, 1, "", "set_instrument"], [38, 8, 1, "", "write"], [38, 8, 1, "", "write_short"], [38, 8, 1, "", "write_sys_ex"]], "pygame.mixer": [[39, 6, 1, "", "Channel"], [39, 6, 1, "", "Sound"], [39, 11, 1, "", "fadeout"], [39, 11, 1, "", "find_channel"], [39, 11, 1, "", "get_busy"], [39, 11, 1, "", "get_driver"], [39, 11, 1, "", "get_init"], [39, 11, 1, "", "get_num_channels"], [39, 11, 1, "", "get_sdl_mixer_version"], [39, 11, 1, "", "get_soundfont"], [39, 11, 1, "", "init"], [41, 5, 0, "-", "music"], [39, 11, 1, "", "pause"], [39, 11, 1, "", "pre_init"], [39, 11, 1, "", "quit"], [39, 11, 1, "", "set_num_channels"], [39, 11, 1, "", "set_reserved"], [39, 11, 1, "", "set_soundfont"], [39, 11, 1, "", "stop"], [39, 11, 1, "", "unpause"]], "pygame.mixer.Channel": [[39, 8, 1, "", "fadeout"], [39, 8, 1, "", "get_busy"], [39, 8, 1, "", "get_endevent"], [39, 8, 1, "", "get_queue"], [39, 8, 1, "", "get_sound"], [39, 8, 1, "", "get_volume"], [39, 7, 1, "", "id"], [39, 8, 1, "", "pause"], [39, 8, 1, "", "play"], [39, 8, 1, "", "queue"], [39, 8, 1, "", "set_endevent"], [39, 8, 1, "", "set_source_location"], [39, 8, 1, "", "set_volume"], [39, 8, 1, "", "stop"], [39, 8, 1, "", "unpause"]], "pygame.mixer.Sound": [[39, 8, 1, "", "copy"], [39, 8, 1, "", "fadeout"], [39, 8, 1, "", "get_length"], [39, 8, 1, "", "get_num_channels"], [39, 8, 1, "", "get_raw"], [39, 8, 1, "", "get_volume"], [39, 8, 1, "", "play"], [39, 8, 1, "", "set_volume"], [39, 8, 1, "", "stop"]], "pygame.mixer.music": [[41, 11, 1, "", "fadeout"], [41, 11, 1, "", "get_busy"], [41, 11, 1, "", "get_endevent"], [41, 11, 1, "", "get_metadata"], [41, 11, 1, "", "get_pos"], [41, 11, 1, "", "get_volume"], [41, 11, 1, "", "load"], [41, 11, 1, "", "pause"], [41, 11, 1, "", "play"], [41, 11, 1, "", "queue"], [41, 11, 1, "", "rewind"], [41, 11, 1, "", "set_endevent"], [41, 11, 1, "", "set_pos"], [41, 11, 1, "", "set_volume"], [41, 11, 1, "", "stop"], [41, 11, 1, "", "unload"], [41, 11, 1, "", "unpause"]], "pygame.mouse": [[40, 11, 1, "", "get_cursor"], [40, 11, 1, "", "get_focused"], [40, 11, 1, "", "get_just_pressed"], [40, 11, 1, "", "get_just_released"], [40, 11, 1, "", "get_pos"], [40, 11, 1, "", "get_pressed"], [40, 11, 1, "", "get_rel"], [40, 11, 1, "", "get_relative_mode"], [40, 11, 1, "", "get_visible"], [40, 11, 1, "", "set_cursor"], [40, 11, 1, "", "set_pos"], [40, 11, 1, "", "set_relative_mode"], [40, 11, 1, "", "set_visible"]], "pygame.pixelcopy": [[43, 11, 1, "", "array_to_surface"], [43, 11, 1, "", "make_surface"], [43, 11, 1, "", "map_array"], [43, 11, 1, "", "surface_to_array"]], "pygame.scrap": [[46, 11, 1, "", "contains"], [46, 11, 1, "", "get"], [46, 11, 1, "", "get_init"], [46, 11, 1, "", "get_text"], [46, 11, 1, "", "get_types"], [46, 11, 1, "", "has_text"], [46, 11, 1, "", "init"], [46, 11, 1, "", "lost"], [46, 11, 1, "", "put"], [46, 11, 1, "", "put_text"], [46, 11, 1, "", "set_mode"]], "pygame.sndarray": [[49, 11, 1, "", "array"], [49, 11, 1, "", "get_arraytype"], [49, 11, 1, "", "get_arraytypes"], [49, 11, 1, "", "make_sound"], [49, 11, 1, "", "samples"], [49, 11, 1, "", "use_arraytype"]], "pygame.sprite": [[51, 6, 1, "", "DirtySprite"], [51, 6, 1, "", "Group"], [51, 11, 1, "", "GroupSingle"], [51, 6, 1, "", "LayeredDirty"], [51, 6, 1, "", "LayeredUpdates"], [51, 6, 1, "", "RenderUpdates"], [51, 6, 1, "", "Sprite"], [51, 11, 1, "", "collide_circle"], [51, 11, 1, "", "collide_circle_ratio"], [51, 11, 1, "", "collide_mask"], [51, 11, 1, "", "collide_rect"], [51, 11, 1, "", "collide_rect_ratio"], [51, 11, 1, "", "groupcollide"], [51, 11, 1, "", "spritecollide"], [51, 11, 1, "", "spritecollideany"]], "pygame.sprite.Group": [[51, 8, 1, "", "add"], [51, 8, 1, "", "clear"], [51, 8, 1, "", "copy"], [51, 8, 1, "", "draw"], [51, 8, 1, "", "empty"], [51, 8, 1, "", "has"], [51, 8, 1, "", "remove"], [51, 8, 1, "", "sprites"], [51, 8, 1, "", "update"]], "pygame.sprite.LayeredDirty": [[51, 8, 1, "", "change_layer"], [51, 8, 1, "", "clear"], [51, 8, 1, "", "draw"], [51, 8, 1, "", "get_clip"], [51, 8, 1, "", "repaint_rect"], [51, 8, 1, "", "set_clip"], [51, 8, 1, "", "set_timing_threshold"], [51, 8, 1, "", "set_timing_treshold"]], "pygame.sprite.LayeredUpdates": [[51, 8, 1, "", "add"], [51, 8, 1, "", "change_layer"], [51, 8, 1, "", "draw"], [51, 8, 1, "", "get_bottom_layer"], [51, 8, 1, "", "get_layer_of_sprite"], [51, 8, 1, "", "get_sprite"], [51, 8, 1, "", "get_sprites_at"], [51, 8, 1, "", "get_sprites_from_layer"], [51, 8, 1, "", "get_top_layer"], [51, 8, 1, "", "get_top_sprite"], [51, 8, 1, "", "layers"], [51, 8, 1, "", "move_to_back"], [51, 8, 1, "", "move_to_front"], [51, 8, 1, "", "remove_sprites_of_layer"], [51, 8, 1, "", "sprites"], [51, 8, 1, "", "switch_layer"]], "pygame.sprite.RenderUpdates": [[51, 8, 1, "", "draw"]], "pygame.sprite.Sprite": [[51, 8, 1, "", "add"], [51, 8, 1, "", "alive"], [51, 8, 1, "", "groups"], [51, 8, 1, "", "kill"], [51, 8, 1, "", "remove"], [51, 8, 1, "", "update"]], "pygame.surfarray": [[53, 11, 1, "", "array2d"], [53, 11, 1, "", "array3d"], [53, 11, 1, "", "array_alpha"], [53, 11, 1, "", "array_blue"], [53, 11, 1, "", "array_colorkey"], [53, 11, 1, "", "array_green"], [53, 11, 1, "", "array_red"], [53, 11, 1, "", "blit_array"], [53, 11, 1, "", "get_arraytype"], [53, 11, 1, "", "get_arraytypes"], [53, 11, 1, "", "make_surface"], [53, 11, 1, "", "map_array"], [53, 11, 1, "", "pixels2d"], [53, 11, 1, "", "pixels3d"], [53, 11, 1, "", "pixels_alpha"], [53, 11, 1, "", "pixels_blue"], [53, 11, 1, "", "pixels_green"], [53, 11, 1, "", "pixels_red"], [53, 11, 1, "", "use_arraytype"]], "pygame.system": [[54, 11, 1, "", "get_cpu_instruction_sets"], [54, 11, 1, "", "get_power_state"], [54, 11, 1, "", "get_pref_locales"], [54, 11, 1, "", "get_pref_path"], [54, 11, 1, "", "get_total_ram"]], "pygame.tests": [[55, 11, 1, "", "run"]], "pygame.time": [[56, 6, 1, "", "Clock"], [56, 11, 1, "", "delay"], [56, 11, 1, "", "get_ticks"], [56, 11, 1, "", "set_timer"], [56, 11, 1, "", "wait"]], "pygame.time.Clock": [[56, 8, 1, "", "get_fps"], [56, 8, 1, "", "get_rawtime"], [56, 8, 1, "", "get_time"], [56, 8, 1, "", "tick"], [56, 8, 1, "", "tick_busy_loop"]], "pygame.transform": [[58, 11, 1, "", "average_color"], [58, 11, 1, "", "average_surfaces"], [58, 11, 1, "", "box_blur"], [58, 11, 1, "", "chop"], [58, 11, 1, "", "flip"], [58, 11, 1, "", "gaussian_blur"], [58, 11, 1, "", "get_smoothscale_backend"], [58, 11, 1, "", "grayscale"], [58, 11, 1, "", "hsl"], [58, 11, 1, "", "invert"], [58, 11, 1, "", "laplacian"], [58, 11, 1, "", "pixelate"], [58, 11, 1, "", "rotate"], [58, 11, 1, "", "rotozoom"], [58, 11, 1, "", "scale"], [58, 11, 1, "", "scale2x"], [58, 11, 1, "", "scale_by"], [58, 11, 1, "", "set_smoothscale_backend"], [58, 11, 1, "", "smoothscale"], [58, 11, 1, "", "smoothscale_by"], [58, 11, 1, "", "solid_overlay"], [58, 11, 1, "", "threshold"]], "pygame.typing": [[59, 9, 1, "", "ColorLike"], [59, 9, 1, "", "FileLike"], [59, 9, 1, "", "IntPoint"], [59, 9, 1, "", "Point"], [59, 9, 1, "", "RectLike"], [59, 9, 1, "", "SequenceLike"]], "pygame.version": [[44, 9, 1, "", "SDL"], [44, 9, 1, "", "rev"], [44, 9, 1, "", "ver"], [44, 9, 1, "", "vernum"]]}, "objnames": {"0": ["c", "macro", "C macro"], "1": ["c", "function", "C function"], "2": ["c", "functionParam", "C function parameter"], "3": ["c", "member", "C member"], "4": ["c", "type", "C type"], "5": ["py", "module", "Python module"], "6": ["py", "class", "Python class"], "7": ["py", "attribute", "Python attribute"], "8": ["py", "method", "Python method"], "9": ["py", "data", "Python data"], "10": ["py", "property", "Python property"], "11": ["py", "function", "Python function"], "12": ["py", "exception", "Python exception"]}, "objtypes": {"0": "c:macro", "1": "c:function", "2": "c:functionParam", "3": "c:member", "4": "c:type", "5": "py:module", "6": "py:class", "7": "py:attribute", "8": "py:method", "9": "py:data", "10": "py:property", "11": "py:function", "12": "py:exception"}, "terms": {"": [9, 12, 13, 16, 19, 21, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 50, 51, 52, 54, 56, 58, 60, 62, 63, 66, 67, 68, 69, 71, 72, 73, 74, 75, 76, 77], "0": [1, 2, 3, 5, 6, 12, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 62, 63, 65, 66, 67, 68, 70, 71, 72, 73, 74, 76, 77, 78], "02778": 29, "08333": 29, "09375": 39, "0dev11": 33, "0x": 21, "0x00": 21, "0x00000000": 52, "0x00000001": 52, "0x00000004": 52, "0x00000100": 52, "0x00001000": 52, "0x00002000": 52, "0x00004000": 52, "0x00010000": 52, "0x01000000": 52, "0x10": 38, "0x10000": 29, "0x10ffff": 29, "0x11": 38, "0x12": 38, "0x13": 38, "0x7d": 38, "0x90": 38, "0xaacce": 42, "0xc0": 38, "0xd800": 29, "0xdfff": 29, "0xf0": 38, "0xf7": 38, "0xff": 21, "0xff00ff": 42, "0xffff": 24, "0xrrggbb": 21, "0xrrggbbaa": 21, "1": [1, 2, 3, 5, 7, 9, 12, 14, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 57, 58, 60, 61, 62, 63, 64, 65, 66, 67, 68, 70, 71, 72, 78], "10": [25, 27, 33, 36, 37, 44, 45, 58, 61, 62, 66, 68, 70, 71, 72, 73, 76, 77, 78], "100": [21, 25, 37, 38, 52, 54, 60, 65, 68, 70, 71, 72], "1000": [17, 51, 56], "101": 18, "1024": [38, 39], "105": 65, "1080": [24, 63], "1080p": 24, "10th": 36, "11": [33, 37], "110": 18, "113": 25, "114": 42, "115": 25, "117": 27, "12": [11, 29, 33, 39, 61, 62, 72, 78], "120": [23, 72], "1221": 24, "1234": 44, "125": 25, "127": [36, 38], "128": [39, 45, 68], "1280": [17, 61, 62, 71, 78], "1280x480": 78, "13": [33, 66, 68, 77], "135": 25, "14": 33, "140": 72, "145": 65, "15": [25, 28, 33, 37, 45, 52, 61, 62, 78], "150": [25, 31, 45, 73], "1560": 18, "15924": 28, "16": [16, 23, 24, 28, 29, 33, 39, 49, 60, 63, 68], "16711680": 63, "16bit": 39, "17": [33, 66], "170": [42, 61, 62, 65, 72, 78], "179": 25, "18": [17, 26, 33, 61, 62, 66, 78], "180": [37, 72], "187": [61, 62, 78], "19": 33, "192": 71, "1920": [24, 63], "1d": 42, "1e": 37, "1x1": 38, "2": [1, 9, 16, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 62, 65, 66, 68, 69, 71, 78], "20": [23, 25, 28, 33, 37, 45, 54, 58, 68, 71], "200": [25, 31, 37, 45, 66, 72], "2000": [17, 66, 71], "20000": 38, "2001": [18, 66], "2004": 20, "2021": 18, "2022": 71, "2023": 71, "2024": 18, "204": 42, "20500": 38, "21": [38, 66], "210": 25, "214": 18, "22": 49, "220": 25, "22000": 49, "22050": 39, "225": 25, "23": 66, "235": [61, 62, 78], "238": [42, 61, 62, 78], "24": [19, 20, 23, 28, 32, 42, 52, 53, 54, 58, 66, 68], "240": 66, "24x24": 23, "25": [25, 33, 61, 62, 66, 72, 78], "250": [25, 72, 73], "255": [1, 21, 28, 29, 31, 33, 36, 39, 42, 43, 48, 50, 51, 52, 59, 62, 63, 65, 68, 71, 72, 73, 78], "256": [24, 38, 45, 50, 52], "26": [26, 44], "260": 25, "27": 38, "29": 18, "299": 42, "2d": [17, 36, 42, 43, 48, 53, 66, 67, 68, 71], "2pre": 37, "2x": 53, "2x2": 68, "3": [1, 18, 19, 20, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 37, 38, 39, 40, 42, 43, 44, 45, 47, 52, 54, 58, 60, 66, 67, 68, 69, 70, 71], "30": [18, 23, 25, 29, 31, 33, 39, 45, 55, 58, 65, 66, 71], "300": [17, 25, 45, 72], "3072": 39, "314": 18, "315": 29, "3166": 54, "32": [1, 16, 19, 20, 28, 29, 32, 36, 39, 52, 53, 58, 63, 68], "320": 66, "32767": 47, "32768": 47, "32x32": 24, "33": 68, "340": 25, "359": 29, "36": [29, 73], "360": [21, 29, 47, 58, 61, 62, 78], "390": 29, "3d": [24, 27, 43, 53, 66, 68], "3f": 33, "3rd": 66, "3x3": 68, "4": [1, 3, 9, 19, 21, 24, 25, 26, 28, 29, 30, 32, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 47, 51, 52, 54, 56, 58, 60, 61, 62, 63, 64, 65, 68, 69, 70, 71, 74, 77, 78], "40": [17, 23, 25, 56, 58, 66, 70, 71], "400": [23, 24, 25, 65], "4096": [38, 39], "4321": 44, "44100": 39, "45": 29, "47": 77, "480": [20, 27, 40, 60, 61, 62, 63, 65, 70, 77, 78], "4k": 24, "4th": 68, "5": [5, 14, 17, 21, 24, 25, 26, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 51, 52, 53, 58, 59, 60, 61, 62, 65, 66, 68, 69, 70, 77, 78], "50": [18, 23, 25, 27, 37, 45, 52, 65, 66, 68, 71, 72, 73], "500": [33, 45], "500m": 38, "50x50": 52, "512": 39, "53": 18, "55": 25, "587": 42, "6": [21, 25, 27, 30, 32, 33, 34, 36, 37, 39, 40, 41, 44, 45, 47, 48, 49, 53, 58, 68, 69, 70], "60": [17, 23, 25, 38, 39, 40, 61, 62, 70, 71, 77, 78], "600": [23, 63, 70], "63": 21, "639": 54, "64": [21, 29, 61, 62, 78], "640": [20, 27, 40, 60, 63, 65, 70, 77], "640x480": [24, 68, 70], "65": 38, "65280": 63, "6x": 71, "7": [24, 26, 28, 33, 34, 39, 43, 44, 66, 68], "70": 25, "700": [24, 33, 60], "72": 29, "720": [17, 29, 71], "75": [23, 25], "8": [16, 19, 20, 21, 23, 24, 26, 27, 28, 29, 31, 32, 33, 34, 36, 37, 39, 42, 43, 44, 46, 49, 50, 51, 52, 53, 56, 58, 60, 63, 66, 68, 70, 77], "80": [25, 51, 61, 62, 78], "800": [18, 63], "8191": 38, "8192": 38, "824": 18, "8bit": 39, "9": [14, 17, 19, 20, 21, 24, 26, 27, 29, 31, 33, 34, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 50, 52, 53, 58, 65, 68], "90": [25, 36, 37, 39, 58, 61, 62, 65, 77, 78], "97": 34, "A": [1, 4, 8, 9, 12, 15, 16, 17, 19, 20, 21, 23, 24, 25, 26, 27, 29, 30, 31, 33, 34, 36, 37, 39, 40, 41, 42, 43, 45, 46, 48, 49, 51, 52, 54, 55, 56, 58, 59, 60, 62, 66, 67, 72, 73, 74, 77, 78], "AND": [20, 34, 46], "ANDing": 71, "AS": 20, "And": [23, 33, 54, 61, 62, 70, 71, 72, 73, 77, 78], "As": [25, 29, 30, 36, 39, 40, 44, 52, 53, 62, 65, 67, 68, 71, 72, 73, 74, 76, 77], "At": [27, 32, 66, 67, 68], "BE": [20, 46], "BUT": 20, "BY": 20, "Be": [23, 24, 25, 28, 44, 68], "Being": [59, 66, 71], "But": [27, 37, 40, 43, 52, 67, 68, 70, 73, 75, 76], "By": [24, 26, 29, 32, 36, 39, 40, 43, 44, 48, 50, 52, 54, 55, 56, 58, 65, 67, 69, 70, 73, 74], "FOR": 20, "For": [1, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 34, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 47, 48, 49, 51, 52, 54, 55, 58, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 76], "IF": 20, "IN": [20, 46], "If": [5, 10, 13, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 58, 60, 62, 63, 64, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77], "In": [19, 20, 23, 24, 29, 31, 32, 33, 34, 37, 38, 40, 41, 43, 44, 52, 56, 62, 63, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77], "It": [2, 3, 10, 17, 18, 19, 20, 21, 24, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 41, 42, 43, 44, 45, 47, 48, 50, 51, 52, 54, 55, 56, 58, 61, 62, 63, 64, 65, 66, 67, 68, 69, 71, 74, 75, 76, 77], "Its": 35, "NO": 20, "NOT": [20, 38, 41, 58, 60], "No": [1, 5, 6, 9, 12, 15, 24, 34, 44, 45, 51, 52, 78], "Nos": 78, "Not": [24, 26, 45, 52, 60, 64, 66, 67, 68], "OF": 20, "ON": 20, "OR": [20, 29, 36], "ORed": 39, "ORing": 34, "Of": 65, "On": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 20, 24, 26, 27, 38, 40, 41, 44, 46, 51, 52, 54, 58, 61, 66, 71], "One": [3, 11, 33, 39, 48, 66, 68, 71], "Or": [17, 21, 27, 44, 67], "SUCH": 20, "THE": [20, 46], "TO": 20, "That": [17, 29, 58, 62, 66, 67, 70, 71], "The": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 60, 61, 63, 64, 65, 66, 68, 69, 71, 72, 75, 76, 78], "Then": [11, 23, 62, 67, 68, 70, 73, 74, 76, 77], "There": [18, 20, 21, 23, 24, 25, 26, 27, 28, 31, 33, 34, 38, 40, 45, 46, 51, 52, 62, 63, 64, 65, 67, 68, 70, 71, 72, 73], "These": [18, 21, 23, 24, 25, 26, 27, 29, 33, 38, 40, 44, 45, 47, 48, 51, 52, 53, 55, 58, 59, 62, 63, 67, 68, 70, 71, 73, 75], "To": [23, 24, 26, 30, 31, 33, 34, 36, 38, 39, 40, 41, 42, 43, 47, 48, 51, 52, 56, 60, 65, 68, 75, 76], "WILL": 46, "Will": [4, 5, 6, 12, 15, 28, 39, 56], "With": [27, 32, 37, 38, 52, 60, 66, 68, 70, 73, 75, 76], "_": [21, 34], "__bytes__": 39, "__class__": 45, "__copy__": [36, 39, 52], "__deepcopy__": 52, "__dict__": 26, "__file__": [27, 61, 62, 78], "__getitem__": 59, "__init__": [45, 51, 61, 62, 65, 67, 70, 74, 75, 76, 77, 78], "__len__": 59, "__main__": [33, 61, 73, 77], "__name__": [33, 45, 61, 73, 77], "__new__": [29, 45], "__repr__": 45, "__tags__": 55, "_camera": 20, "_default_lay": 51, "_freetyp": [0, 11], "_index": 1, "_instructionset": 54, "_layer": 51, "_local": 54, "_pixels_address": 52, "_pygam": 11, "_rect": 45, "_sdl2": [17, 48, 60], "_spin": [61, 62, 78], "_sprite__g": 67, "_spritegroup": 67, "_tag": 55, "_test": 55, "_time_threshold": 51, "_use_upd": 51, "_vidinfo": 24, "_walk": [61, 62, 78], "a0": 38, "a6f89747b551": 44, "a_mask": 36, "aa": [21, 31, 68], "aaa": 68, "aacircl": [25, 31], "aaellips": 31, "aalib": 24, "aalin": 25, "aapolygon": [25, 31], "aatrigon": 31, "abc": 59, "abcdefg": 59, "abgr": 32, "abil": [44, 62, 66], "abl": [24, 32, 33, 42, 66, 71, 77], "abnorm": 77, "abort": 38, "about": [10, 17, 20, 24, 27, 28, 33, 38, 40, 42, 44, 48, 50, 51, 52, 57, 62, 63, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76], "abov": [3, 16, 20, 23, 24, 25, 28, 29, 32, 33, 37, 41, 42, 43, 45, 60, 62, 65, 67, 68, 70, 71, 72, 75], "abrir": 78, "absent": 24, "absolut": [21, 33, 38, 41, 52, 54, 71], "abspath": [61, 62, 78], "abstractgroup": 51, "acarrea": 78, "acceler": [24, 25, 27, 31, 48, 52, 54, 58, 66], "accept": [16, 25, 27, 28, 29, 30, 31, 32, 39, 40, 45, 51, 52, 53, 59, 70], "access": [9, 10, 17, 19, 25, 26, 27, 28, 29, 33, 36, 37, 38, 39, 40, 43, 44, 46, 51, 52, 54, 63, 67, 68, 71], "accident": 71, "acci\u00f3n": 78, "accommod": 70, "accord": [21, 34, 43, 58], "accordingli": 52, "account": [24, 33, 34, 37, 39, 41, 42, 58], "accumul": 33, "accur": [28, 40, 41, 50, 56], "achiev": [48, 60, 70, 74], "acolor": 21, "acquir": [10, 52, 53], "across": [23, 24, 34, 61, 62, 68, 70, 71, 75, 76, 77, 78], "act": [37, 62, 66], "action": [26, 66, 68, 76], "activ": [24, 39, 40, 41, 49, 52, 53, 57], "activeev": [24, 26], "actual": [4, 12, 20, 23, 24, 28, 30, 31, 33, 38, 39, 41, 43, 45, 51, 52, 56, 58, 62, 63, 66, 67, 68, 70, 71, 73, 76, 78], "actualic": 78, "actualizacada": 78, "actualizaci\u00f3n": 78, "actualment": 78, "ac\u00e1": 78, "ad": [11, 24, 25, 26, 29, 32, 33, 34, 36, 39, 40, 41, 42, 43, 44, 45, 47, 51, 52, 56, 58, 62, 67, 68, 71, 75, 77], "adam": 17, "adapt": [24, 25], "adaptive_vsync": 24, "add": [24, 29, 50, 51, 52, 62, 65, 66, 67, 68, 69, 70, 72, 77], "add_intern": 67, "add_map": 47, "addit": [23, 24, 25, 26, 27, 33, 34, 37, 38, 40, 44, 46, 48, 51, 52, 71], "addition": [24, 25, 70], "address": [19, 33, 47, 52, 71, 74], "adecuar": 78, "adelant": 78, "adem\u00e1": 78, "adjac": [25, 31], "adjust": [9, 21, 24, 28, 29, 38, 58, 72, 77], "admit": 71, "adopt": [48, 69], "advanc": [17, 28, 29, 47, 51, 52, 66, 70], "advancemam": 58, "advantag": [17, 50, 63, 66, 67, 71, 72, 75], "advertencia": 78, "advic": 66, "advis": [20, 23, 24, 60], "ae": 28, "affect": [12, 24, 25, 26, 29, 30, 39, 42, 44, 45, 51, 52, 53, 56, 58, 68], "afraid": 68, "after": [19, 24, 25, 28, 29, 32, 34, 38, 39, 41, 47, 49, 51, 52, 60, 62, 63, 65, 66, 68, 70, 71, 77], "afterward": 48, "afuera": 78, "again": [20, 34, 39, 41, 44, 51, 52, 54, 56, 63, 67, 68, 69, 70, 71, 73, 76, 77], "against": [29, 32, 44, 45, 58, 65, 67], "agnost": 48, "ago": 66, "agp": 68, "agrad": 78, "agregar": 78, "ahead": [25, 33], "ahora": 78, "ai": [30, 74, 77], "aid": 29, "aim": 69, "al": 78, "album": 41, "algo": 78, "algorithm": [25, 31, 36, 44, 50, 58, 71, 72], "alguno": 78, "alia": [26, 28, 33, 39, 56], "alias": [17, 24, 28, 29, 59, 73], "aliceblu": 22, "alien": [27, 67], "alien1": 70, "align": [28, 29, 36, 37, 45], "aliv": [19, 51, 67], "all": [17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 51, 52, 53, 55, 58, 60, 63, 64, 65, 66, 67, 68, 69, 71, 72, 73, 74, 75, 76], "all_my_sprites_list": 71, "all_sprit": [61, 62], "allblack": 68, "alloc": [10, 32, 39], "allot": 55, "allow": [17, 20, 21, 23, 24, 26, 28, 29, 30, 32, 33, 37, 39, 42, 44, 45, 46, 48, 50, 51, 52, 58, 59, 60, 62, 63, 65, 67, 68, 70, 72, 75, 77], "allow_high_dpi": [44, 60], "allowedchang": 39, "allsprit": 78, "almost": [17, 62, 66, 67, 68, 69, 72, 74], "alon": [27, 30, 71], "along": [27, 29, 32, 38, 45, 52, 55, 61, 66, 67, 68, 70, 75], "alongsid": 18, "alpha": [1, 17, 21, 24, 25, 27, 28, 29, 31, 32, 33, 36, 43, 44, 47, 48, 50, 52, 53, 58, 66, 68, 74], "alpha_mod": 48, "alphaoper": 48, "alreadi": [10, 24, 26, 29, 30, 33, 38, 39, 41, 45, 47, 50, 51, 65, 66, 67, 68, 70, 71, 72, 76], "alrededor": 78, "alsa": 38, "also": [3, 5, 11, 13, 16, 17, 19, 21, 23, 24, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 50, 51, 52, 53, 54, 55, 56, 58, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 73, 74, 75, 76, 77], "alt": [34, 60], "alter": [36, 40, 58], "altern": [24, 25, 27, 28, 29, 31, 45, 60, 72], "altgr": 34, "although": 74, "altivec": 54, "alwai": [20, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 39, 40, 44, 45, 47, 48, 49, 50, 51, 52, 54, 56, 58, 60, 62, 63, 64, 66, 67, 68, 70, 71, 74, 75, 77], "always_on_top": 60, "ambigu": 39, "american": 54, "among": 20, "amongst": 17, "amount": [21, 24, 28, 29, 30, 33, 40, 54, 56, 57, 58, 60, 62, 66, 72], "ampersand": 34, "amplitud": 49, "an": [1, 2, 3, 4, 5, 6, 8, 10, 11, 12, 14, 16, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 62, 63, 64, 65, 66, 67, 68, 71, 72, 73, 74, 75, 76, 77, 78], "an_id": 38, "analog": [33, 42, 47, 60], "andal": 29, "andmask": [23, 40], "android": [26, 34, 60], "angl": [25, 29, 30, 31, 36, 37, 39, 48, 58, 65, 75, 77], "angle_rad": 37, "angle_to": 37, "angular": 75, "ani": [1, 10, 17, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 36, 38, 39, 40, 41, 42, 43, 44, 45, 47, 48, 50, 51, 52, 53, 54, 56, 58, 59, 60, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76], "anim": [17, 27, 32, 51, 58, 66, 67, 70], "anisotrop": [44, 48], "annoi": [17, 69], "annot": 59, "anoth": [11, 21, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 36, 37, 40, 41, 42, 43, 45, 46, 47, 48, 50, 51, 52, 56, 60, 66, 67, 68, 70, 71, 72, 74, 77], "another_surfac": 52, "ansi": 38, "ansi_not": 38, "answer": [66, 71], "ant": 78, "anterior": 78, "anti": [17, 24, 29, 73], "antialia": 28, "antialias": [25, 28, 29, 31, 58, 62], "anticip": [44, 54], "antiquewhit": 22, "antiquewhite1": 22, "antiquewhite2": 22, "antiquewhite3": 22, "antiquewhite4": 22, "anuncio": 78, "anymor": 71, "anyon": 67, "anyth": [17, 24, 44, 51, 52, 60, 62, 66, 67, 68, 70, 71], "anywai": [68, 73], "anywher": [70, 72], "apagamo": 78, "apariencia": 78, "apart": 39, "api": [17, 20, 24, 26, 29, 31, 34, 38, 46, 47, 48, 60, 65, 71], "app": [24, 27, 44, 54, 65], "app_didenterbackground": 26, "app_didenterforeground": 26, "app_lowmemori": 26, "app_termin": 26, "app_willenterbackground": 26, "app_willenterforeground": 26, "appdata": 54, "appdir": 54, "appear": [17, 24, 26, 52, 56, 60, 66, 67, 70, 71, 72], "append": [33, 65, 67, 70, 71], "appli": [1, 21, 25, 27, 29, 36, 37, 38, 52, 57, 58, 68, 71], "applic": [0, 19, 24, 26, 27, 34, 35, 38, 39, 46, 52, 54, 60, 71, 72, 76], "approach": 69, "appropri": [24, 26, 40, 62, 63, 67, 76], "approxim": [33, 36, 50, 65, 72], "apropiado": 78, "aproximaci\u00f3n": 78, "aqua": 22, "aquamarin": 22, "aquamarine1": 22, "aquamarine2": 22, "aquamarine3": 22, "aquamarine4": 22, "aquella": 78, "aqu\u00ed": 78, "ar": [1, 3, 5, 9, 10, 11, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 55, 56, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 72, 73, 74, 75, 76, 77], "arang": 68, "arbitrari": [28, 29, 58, 70], "arbitrarili": 24, "arc": [25, 31], "arcad": [66, 71], "archiv": [28, 29, 71], "archivo": 78, "area": [12, 24, 25, 27, 28, 29, 30, 33, 36, 44, 45, 48, 51, 52, 58, 60, 61, 62, 65, 66, 67, 70, 71, 73, 75, 76, 77, 78], "aren": [48, 60, 70, 71], "arg": [1, 27, 51, 55], "argb": 32, "argb_premult": 32, "argument": [1, 2, 3, 10, 12, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 39, 40, 41, 43, 44, 45, 47, 48, 50, 51, 52, 55, 56, 58, 59, 60, 62, 63, 67, 70, 71, 73], "argumento": 78, "arial": 28, "aris": 20, "arithmet": [21, 37, 42, 68], "arm": [58, 71], "armsimd": 54, "around": [17, 24, 25, 27, 30, 31, 33, 37, 40, 42, 45, 48, 54, 62, 63, 65, 66, 68, 70, 71, 73, 74, 77], "arrai": [1, 2, 3, 5, 17, 21, 23, 27, 29, 32, 34, 39, 42, 49, 52, 66, 68, 70], "arrang": 68, "array1": 43, "array2": 43, "array2d": [53, 68], "array3d": [53, 68], "array_alpha": [53, 68], "array_blu": 53, "array_colorkei": [43, 53, 68], "array_green": 53, "array_r": 53, "array_to_surfac": 43, "arraydemo": [17, 27, 68], "arraytyp": [27, 49, 53], "arrayxd": 68, "arriba": 78, "arriv": 71, "arrow": [23, 27, 34, 70], "articl": [66, 70, 72], "artifact": 58, "artist": 41, "as_frect": 30, "as_joystick": 47, "as_polar": 37, "as_rect": 30, "as_spher": 37, "ascend": 29, "ascent": [28, 29], "ascii": [16, 23, 34, 53], "aseguramo": 78, "asegurarno": 78, "asegurar\u00e1": 78, "asi": 78, "asignada": 78, "asignarlo": 78, "ask": [24, 28, 29, 54, 62, 63, 65, 66, 70, 71], "aspect": [32, 44, 45], "assembl": 34, "assembli": 66, "assert": 70, "asset": 71, "assign": [21, 26, 29, 33, 42, 45, 47, 51, 55, 62, 68, 70, 76], "assist": [52, 71], "associ": [8, 29, 48, 52, 57, 60], "assum": [1, 10, 12, 21, 28, 29, 38, 40, 45, 52, 65, 67, 69, 72, 74, 76], "asterisk": 34, "astyp": 68, "asymmetr": 37, "asyncblit": 52, "asynchron": 52, "as\u00ed": 78, "as\u00edmismo": 78, "atravesar\u00e1": 78, "atributo": 78, "atr\u00e1": 78, "attach": [24, 27, 47, 65], "attack": 66, "attempt": [20, 28, 29, 37, 38, 52, 62, 64, 68], "attent": [60, 66], "attribut": [1, 5, 21, 24, 26, 28, 29, 30, 31, 33, 34, 35, 36, 37, 39, 40, 44, 45, 48, 51, 52, 54, 55, 56, 59, 60, 62, 67, 73, 75, 76, 77], "attributeerror": [29, 67], "audac": 41, "audio": [27, 38, 39, 44, 46, 49, 66], "audio_allow_any_chang": 39, "audio_allow_channels_chang": 39, "audio_allow_format_chang": 39, "audio_allow_frequency_chang": 39, "audiodevicead": 26, "audiodeviceremov": 26, "august": 18, "aumenta": 78, "aunqu": 78, "author": [20, 54, 62, 63, 64, 65, 66, 67, 68, 70, 71, 72], "automat": [24, 28, 29, 31, 32, 33, 34, 35, 38, 39, 44, 46, 51, 52, 58, 60, 62, 64, 68], "autom\u00e1ticament": 78, "autor": 78, "avail": [0, 10, 18, 20, 21, 23, 24, 26, 27, 28, 29, 31, 32, 33, 38, 39, 41, 44, 46, 48, 49, 52, 53, 54, 55, 56, 57, 58, 60, 62, 63, 64, 66, 67, 68, 70, 71], "averag": [28, 29, 55, 56, 58, 65, 68, 71, 72], "average_color": [58, 65], "average_surfac": [58, 65], "avid": 71, "avoid": [24, 28, 34, 37, 39, 42, 45, 49, 53, 54, 55, 68, 71, 77], "avx": 54, "avx2": 54, "avx512f": 54, "awai": [17, 24, 30, 37, 67, 77], "awar": [24, 26, 28, 44, 68, 71], "awkward": [70, 71], "ax": [24, 29, 30, 33, 47, 75], "axi": [26, 29, 37, 40, 42, 47, 48, 49, 53, 58, 73, 75], "axis_numb": 33, "ayuda": 78, "ayudar": 78, "azimuth": 37, "azul": 78, "azur": 22, "azure1": 22, "azure2": 22, "azure3": 22, "azure4": 22, "b": [21, 25, 27, 30, 33, 34, 37, 42, 43, 45, 46, 47, 52, 58, 59, 68], "b0": 47, "b3": 47, "bach": 41, "back": [28, 29, 33, 34, 38, 39, 48, 51, 52, 61, 62, 63, 65, 72, 76, 77, 78], "backbuff": 48, "backcompat": 25, "backend": [20, 24, 26, 39, 43, 44, 58, 63], "background": [25, 26, 27, 28, 29, 39, 44, 51, 61, 65, 67, 69, 71, 72, 73, 75, 77, 78], "backslash": 34, "backslashreplac": 44, "backspac": 34, "backward": [24, 26, 29, 39], "backyard": 66, "bad": 71, "bajo": 78, "baker": 66, "ball": [23, 26, 33, 66, 69, 73, 74, 76], "ball_numb": 33, "ballrect": 66, "ballsprit": 77, "banner": [17, 27, 61, 62], "bar": 60, "base": [0, 3, 11, 19, 20, 25, 26, 27, 28, 29, 30, 36, 39, 48, 50, 51, 54, 60, 61, 62, 65, 67, 68, 70, 71, 75, 77, 78], "base_text_surf": 28, "baselin": [28, 29], "basic": [17, 20, 21, 24, 27, 32, 46, 62, 66, 67, 68, 69, 70, 71, 72, 74, 75, 76, 77, 78], "basic_surf": 72, "bat": 69, "batch": 48, "batteri": 54, "battery_perc": 54, "battery_second": 54, "bayer": 20, "bb": 21, "bdf": 29, "beam": 23, "bear": [28, 29, 40], "beauti": 70, "becam": 26, "becaus": [25, 29, 30, 34, 37, 38, 39, 45, 52, 54, 62, 67, 68, 69, 71, 72, 73, 74, 75, 76, 77], "becom": [24, 26, 29, 39, 41, 49, 52, 53, 60, 66, 67, 68, 70, 71], "been": [21, 23, 24, 26, 29, 33, 37, 39, 40, 41, 44, 46, 47, 48, 51, 52, 54, 56, 58, 60, 63, 64, 66, 67, 70, 71, 72, 76, 77], "befor": [1, 10, 19, 20, 23, 24, 28, 29, 31, 33, 34, 36, 37, 38, 39, 40, 41, 44, 46, 48, 51, 52, 53, 55, 56, 58, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 75, 76], "beforehand": 26, "begin": [17, 19, 20, 25, 27, 39, 41, 45, 58, 66, 68, 70, 75], "beginn": 68, "behalf": 19, "behavior": [24, 28, 29, 32, 37, 40, 48, 51, 60], "behaviour": [24, 26, 40, 44, 56, 77], "behind": [17, 24, 32, 51, 75, 76, 77], "beig": 22, "being": [5, 9, 20, 21, 24, 25, 26, 30, 32, 33, 34, 36, 38, 39, 40, 41, 42, 45, 46, 47, 66, 67, 70, 71, 76], "believ": 71, "belong": [51, 62, 67, 73], "below": [17, 20, 21, 24, 25, 27, 33, 38, 39, 44, 45, 46, 50, 51, 52, 65, 70], "bend": 38, "benefit": [67, 70], "besid": [27, 68], "best": [13, 20, 24, 26, 27, 36, 39, 42, 43, 52, 53, 54, 63, 66, 67, 68, 70, 71, 74], "bet": 63, "better": [24, 28, 29, 31, 38, 40, 41, 52, 58, 66, 67, 68, 70, 71, 73], "between": [1, 3, 21, 24, 25, 26, 28, 29, 30, 33, 34, 36, 37, 38, 39, 41, 42, 43, 44, 45, 46, 47, 49, 50, 51, 52, 53, 54, 55, 56, 57, 60, 65, 67, 68, 71, 72], "bewar": [30, 45], "beyond": 71, "bezier": 31, "bg": 65, "bgcolor": [28, 29], "bgd": 51, "bgr": [32, 52, 68], "bgra": [21, 32], "bid": [62, 78], "bien": 78, "big": [19, 20, 44, 51, 65, 67, 68, 70], "bigger": [17, 24, 62], "biggest": [24, 63], "bin": [61, 73, 74, 75], "binari": [20, 21, 23], "bind": [38, 63], "bisqu": 22, "bisque1": 22, "bisque2": 22, "bisque3": 22, "bisque4": 22, "bit": [1, 16, 17, 19, 20, 23, 24, 27, 28, 29, 31, 32, 33, 36, 39, 41, 42, 43, 49, 50, 51, 52, 53, 54, 58, 62, 63, 65, 67, 68, 69, 70, 71, 72, 75, 77], "bitblt": 70, "bitmap": [23, 29, 32, 58, 70], "bitmap_1": 23, "bitmap_2": 23, "bitmask": [23, 34, 36, 51, 52], "bitsiz": [24, 36, 63], "bitstream": 29, "bitwis": [24, 34, 36], "bl": 77, "bla": 32, "black": [22, 23, 24, 25, 27, 28, 29, 33, 36, 42, 52, 58, 62, 65, 66, 68, 71, 72], "blade": 66, "blanchedalmond": 22, "blanco": 78, "blank": [28, 65, 70, 71, 73], "blanket": 43, "blend": [21, 25, 27, 29, 44, 48, 50, 52, 71], "blend_": 50, "blend_add": 50, "blend_alpha_sdl2": 50, "blend_fil": 27, "blend_flag": 12, "blend_max": 50, "blend_min": 50, "blend_mod": 48, "blend_mult": 50, "blend_premultipl": 52, "blend_premultipli": [21, 50, 72], "blend_rgb_add": 50, "blend_rgb_max": 50, "blend_rgb_min": 50, "blend_rgb_mult": 50, "blend_rgb_sub": 50, "blend_rgba_add": 50, "blend_rgba_max": 50, "blend_rgba_min": 50, "blend_rgba_mult": 50, "blend_rgba_sub": 50, "blend_sub": 50, "blend_xxx": 27, "blendmod": 51, "blendmode_": 48, "blendmode_non": [50, 52], "blit": [12, 21, 24, 27, 28, 29, 31, 33, 43, 48, 50, 51, 52, 53, 54, 58, 61, 62, 65, 66, 67, 68, 69, 71, 72, 75, 76, 77, 78], "blit_arrai": [43, 53, 68], "blit_blend": 27, "blit_hw": [24, 63], "blit_hw_a": [24, 63], "blit_hw_cc": [24, 63], "blit_sequ": 52, "blit_sw": [24, 63], "blit_sw_a": [24, 63], "blit_sw_cc": [24, 63], "blitteamo": 78, "blittear": 78, "blitter": [44, 50, 52, 70], "blitzbas": 27, "blob": 65, "block": [5, 19, 20, 24, 26, 36, 41, 51, 52, 60, 62, 65, 71], "block_list": 51, "blocks_hit_list": 51, "bloodi": 66, "bloqu": 78, "blt": 70, "blue": [1, 20, 21, 22, 24, 25, 28, 30, 32, 42, 52, 53, 58, 65, 68, 72, 73, 75, 78], "blue1": 22, "blue2": 22, "blue3": 22, "blue4": 22, "blueviolet": 22, "bluish": 68, "blur": 58, "bmp": [32, 46, 66, 70], "bob": 54, "bold": [28, 29], "boldobliqu": [28, 29], "bomb": 67, "bondad": 78, "bonu": 70, "book": [17, 28, 29, 71], "bookobliqu": [28, 29], "bool": [5, 19, 20, 24, 25, 26, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 44, 45, 46, 47, 48, 51, 52, 58, 60], "boolean": [26, 28, 30, 33, 34, 40, 45, 58, 67, 70], "boom": 67, "boom_sound": 67, "boost": 71, "border": [24, 25, 31, 40, 45, 60], "border_bottom_left_radiu": 25, "border_bottom_right_radiu": 25, "border_radiu": 25, "border_top_left_radiu": 25, "border_top_right_radiu": 25, "borderless": [24, 60], "bore": 74, "borra": 78, "borrow": [1, 66, 74], "both": [21, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 42, 48, 52, 54, 58, 59, 65, 66, 67, 68, 70, 71, 72, 75, 77], "bother": [62, 69, 74], "bottleneck": 71, "bottom": [24, 25, 27, 28, 29, 30, 31, 32, 36, 45, 51, 66, 77], "bottomleft": [45, 77], "bottomright": [45, 77], "bot\u00f3n": 78, "bounc": [27, 37, 58, 66, 77], "bound": [23, 24, 25, 29, 30, 36, 40, 48, 51, 52], "boundari": [25, 29, 36], "box": [24, 25, 29, 31, 34, 58, 65, 67, 72, 76], "box_blur": 58, "br": 77, "bracket": [34, 75], "break": [20, 25, 28, 31, 34, 46, 70, 76], "breakag": 42, "breakdown": 66, "brief": [27, 44, 69, 70], "briefli": 73, "bright": [20, 21, 65], "brighten": 24, "brightmap": 68, "brindar": 78, "bring": [51, 66, 71], "broadcast": [42, 68], "broader": 71, "broken": [40, 44], "broken_x": 23, "brought": [52, 54, 58], "brown": [22, 72], "brown1": 22, "brown2": 22, "brown3": 22, "brown4": 22, "bu": 68, "bueno": 78, "buffer": [1, 2, 20, 21, 24, 32, 38, 39, 43, 46, 52, 60, 62, 66, 67], "buffer_s": 38, "bufferproxi": [0, 17, 19, 32, 52], "buffers": [38, 39], "bug": [21, 44, 52, 58, 66, 71, 77], "build": [44, 56, 67, 68, 73, 77], "built": [16, 20, 21, 26, 28, 29, 32, 37, 39, 44, 71, 73], "builtin": [20, 28, 59, 67], "bullet": [67, 71], "bump": 71, "bumper": 33, "bunch": [65, 67, 71], "bundl": [28, 29], "burlywood": 22, "burlywood1": 22, "burlywood2": 22, "burlywood3": 22, "burlywood4": 22, "buscamo": 78, "buscando": 78, "buscar": 78, "buscar\u00e1": 78, "busi": [20, 39, 56, 70], "button": [5, 24, 25, 26, 27, 33, 34, 40, 47, 60, 62, 69, 70, 71, 73, 76], "button4": 40, "button5": 40, "bx": [30, 47], "bypass": 44, "byte": [10, 16, 19, 20, 21, 23, 24, 28, 29, 32, 38, 39, 42, 43, 44, 46, 52, 58, 59], "byte_data": 46, "bytearrai": [32, 39], "bytecod": 66, "byteord": 19, "bytes": [19, 24, 36, 52, 63], "bytesio": 59, "bytestr": 39, "b\u00e1sica": 78, "b\u00e1sico": 78, "b\u00e9zier": 31, "c": [11, 17, 19, 20, 21, 27, 28, 31, 34, 43, 44, 45, 52, 54, 59, 64, 66, 68], "c_api": 0, "ca": 54, "cach": 29, "cache_s": 29, "cada": [17, 78], "cadetblu": 22, "cadetblue1": 22, "cadetblue2": 22, "cadetblue3": 22, "cadetblue4": 22, "calcnewpo": [75, 77], "calcul": [29, 30, 36, 37, 39, 41, 42, 51, 75, 76], "calibr": 65, "calidad": 78, "call": [1, 10, 13, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 44, 45, 46, 47, 48, 51, 52, 54, 55, 56, 58, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78], "callabl": [19, 44, 51], "callback": [1, 2, 19, 51], "caller": [5, 10, 38], "calling_mask": 36, "cam": 65, "cambian": 78, "cambiando": 78, "cambiar": 78, "cambio": 78, "came": [27, 32], "camera": [17, 27, 44, 71], "camlist": 65, "can": [1, 3, 5, 9, 10, 14, 16, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 58, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78], "canada": 54, "cancel": 60, "candid": 34, "cannot": [16, 20, 24, 26, 28, 30, 31, 39, 41, 45, 48, 51, 52, 53, 56, 66, 67, 70, 71, 74, 77], "cap": 34, "capabl": [24, 63, 66, 74, 75], "capslock": 34, "caption": 24, "captur": [17, 20, 27, 32, 33, 60], "captura": 78, "capword": 26, "card": [24, 39, 68], "care": [10, 24, 39, 62, 68, 73], "caret": 34, "cargado": 78, "cargamo": 78, "cargar": 78, "cargu": 78, "carguen": 78, "carpeta": 78, "carri": 77, "case": [5, 17, 20, 21, 24, 25, 28, 29, 30, 32, 34, 36, 37, 38, 39, 41, 43, 44, 52, 54, 60, 62, 65, 67, 70, 71, 73, 75, 76], "casi": 78, "caso": 78, "castl": 66, "catch": [44, 67, 77], "categor": 67, "categori": 71, "caught": 66, "caus": [2, 20, 21, 24, 26, 28, 36, 41, 42, 44, 58, 61, 62, 68, 71, 76, 78], "causa": 78, "causando": 78, "causar\u00e1": 78, "caveat": 24, "cc": 65, "ccolor": 65, "cdot": 30, "ce": [20, 21, 24, 25, 26, 28, 29, 30, 32, 33, 34, 35, 36, 37, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 56, 58, 59, 60, 72], "ceil": 66, "center": [25, 27, 30, 31, 33, 36, 44, 45, 48, 51, 52, 61, 65, 73, 78], "centeri": 45, "centerx": [45, 61, 62, 73, 78], "centr": 44, "central": 78, "centro": 78, "centroid": [36, 65], "certain": [21, 34, 37, 62, 65, 69, 71], "certainli": [68, 70], "cff": 29, "cgg": 25, "challeng": [66, 71], "chanc": [39, 68, 71], "chang": [17, 20, 21, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 56, 58, 60, 62, 63, 65, 66, 67, 68, 69, 71, 72, 75, 76, 77], "change_lay": 51, "channel": [8, 21, 32, 38, 39, 41, 50, 52, 58, 68, 71, 72], "channelnum": 8, "char": [1, 5, 6, 10, 28, 29, 52], "char_bit": 36, "charact": [16, 19, 24, 26, 28, 29, 34, 43, 44, 53, 70, 71, 76], "character": 37, "characterist": 21, "charg": 54, "charset": 46, "chart": 68, "chartreus": 22, "chartreuse1": 22, "chartreuse2": 22, "chartreuse3": 22, "chartreuse4": 22, "chase": 67, "chaser": 67, "chatroom": 70, "cheap": [51, 67], "cheaper": 71, "check": [3, 4, 5, 6, 8, 12, 15, 17, 20, 24, 26, 27, 28, 33, 36, 39, 40, 41, 42, 44, 46, 47, 49, 51, 53, 54, 62, 64, 65, 66, 67, 70, 71, 73, 74, 75, 76, 77], "checkout": 44, "chew": 56, "chief": 74, "child": 52, "chimp": [17, 27, 67, 69, 74, 78], "chimpanc\u00e9": 17, "chimpanze": 17, "chocando": 78, "chocol": 22, "chocolate1": 22, "chocolate2": 22, "chocolate3": 22, "chocolate4": 22, "choc\u00f3": 78, "choic": [20, 24, 39, 65], "choos": [20, 23, 24, 27, 39, 50, 54, 63, 68, 69, 71], "chop": 58, "choppi": 70, "chord": 71, "chore": 71, "chosen": [20, 24, 29, 39], "chromin": 20, "chunk": [8, 19, 77], "circl": [17, 23, 25, 27, 31, 33, 51, 65], "circular": 67, "circumfer": 30, "circumst": 77, "claim": 20, "clamp": [27, 30, 37, 45, 50], "clamp_ip": 45, "clamp_magnitud": 37, "clamp_magnitude_ip": 37, "clariti": 36, "clark": 71, "class": [0, 17, 19, 21, 26, 27, 28, 29, 30, 32, 33, 36, 38, 39, 45, 52, 56, 60, 61, 65, 69, 70, 71, 74, 77, 78], "classic": 60, "classless": [74, 75], "classmethod": [21, 48, 60], "claus": 77, "clave": 78, "clean": [40, 42, 62, 64, 66, 67, 70, 71, 78], "cleaner": [66, 70], "cleanli": [64, 66, 67, 70, 77], "cleanup": [42, 78], "clear": [17, 24, 25, 26, 33, 34, 36, 39, 43, 48, 51, 52, 66, 67, 70, 71], "clear_callback": 51, "clearer": 64, "clench": [61, 62, 78], "click": [17, 23, 24, 25, 26, 27, 33, 34, 40, 71, 73], "client": 60, "clip": [25, 27, 36, 45, 48, 51, 52, 70], "clipboard": [17, 27], "clipboardupd": 26, "cliplin": 45, "clipped_lin": 45, "clist": 65, "clock": [17, 23, 24, 25, 33, 40, 56, 61, 62, 70, 71, 77, 78], "clockwis": [29, 30, 31, 37, 48, 58, 75], "clone": 21, "close": [10, 17, 20, 23, 24, 25, 26, 27, 29, 33, 38, 41, 42, 47, 58, 60, 65, 68, 70, 73, 74], "close_to_play": 67, "close_to_player2": 67, "close_to_player3": 67, "closest": [24, 30, 38, 39, 63], "cluster": 25, "cmy": 21, "co": [75, 77], "cocoa": [24, 60], "code": [5, 16, 17, 19, 20, 23, 24, 25, 27, 28, 29, 30, 31, 33, 34, 36, 40, 42, 43, 44, 45, 46, 51, 52, 54, 58, 62, 65, 66, 67, 68, 70, 71, 72, 73, 74, 75, 76, 77], "codec": 44, "codepoint": 28, "coder": 71, "coeffici": 37, "coercion": 68, "coincida": 78, "col": 31, "cola": 78, "collect": [13, 24, 34, 52, 60, 64, 71], "collid": [30, 36, 45, 51, 61, 62, 67, 75, 77, 78], "collide_circl": 51, "collide_circle_ratio": 51, "collide_mask": [36, 51], "collide_rect": 51, "collide_rect_ratio": 51, "collidecircl": 30, "collided_cal": 51, "collidedict": 45, "collidedictal": 45, "collidelist": [30, 45], "collidelistal": [30, 45], "collideobject": 45, "collideobjectsal": 45, "collidepoint": [30, 45, 71, 77], "colliderect": [30, 45, 51, 61, 62, 77, 78], "collideswith": 30, "colliding_sprit": 51, "collis": [27, 30, 36, 37, 45, 51, 65, 77], "collision_box": 45, "colocar": 78, "colon": [34, 39], "color": [0, 1, 11, 17, 23, 24, 25, 28, 29, 31, 32, 33, 36, 42, 43, 44, 47, 48, 50, 51, 52, 53, 58, 59, 62, 63, 65, 66, 68, 70, 71, 72, 73, 78], "color_arg": [33, 47], "color_mod": 48, "color_valu": 21, "colordict": 22, "colorkei": [24, 27, 28, 29, 32, 43, 50, 52, 53, 58, 61, 62, 66, 68, 78], "colorlik": [25, 28, 36, 52, 58, 59], "colormap": [27, 43, 53], "coloroper": 48, "colorspac": 20, "column": [36, 42, 68], "com": 72, "combin": [24, 29, 30, 34, 37, 45, 50, 52, 58, 66, 71, 72, 77], "come": [26, 27, 28, 29, 38, 44, 60, 61, 65, 66, 67, 68, 70, 71, 75, 76, 77], "comfort": [17, 75], "comma": [28, 29, 34, 38, 68], "command": [25, 26, 27, 33, 55, 68], "comment": [27, 61, 67, 69, 75, 77], "commerci": [17, 66], "commit": [34, 66], "common": [17, 24, 28, 29, 47, 51, 56, 58, 64, 66, 69, 70, 71], "commun": [48, 71], "como": 78, "compani": [54, 66], "compar": [34, 36, 37, 42, 44, 50, 51, 52, 58, 66, 71], "comparison": [21, 26, 27, 42, 68], "compat": [24, 25, 26, 29, 32, 33, 39, 46, 47, 48, 51, 52, 74], "compens": 66, "compensa": 78, "compil": [14, 17, 23, 28, 29, 32, 39, 44], "compilador": 78, "complejo": 78, "complement": 37, "complet": [25, 30, 34, 39, 41, 45, 51, 52, 53, 54, 60, 66, 67, 71, 77], "completament": 78, "completo": 78, "complex": [39, 62, 66, 67, 71, 74, 75, 76], "complic": [71, 72], "compon": [21, 36, 37, 43, 52, 68], "compos": [48, 72], "compose_custom_blend_mod": 48, "composit": [17, 26, 34], "compositor": 44, "compress": [41, 52], "comprobaci\u00f3n": 78, "comprueba": 78, "comput": [17, 20, 27, 28, 32, 33, 39, 52, 56, 62, 66, 67, 70, 71], "computadora": 78, "comun": 78, "con": [17, 78], "concept": [17, 66, 68, 69, 70, 71], "concern": [54, 67], "conclud": 66, "concret": 71, "concurr": 71, "condens": [28, 29], "condici\u00f3n": 78, "condit": [20, 23, 39, 77], "confid": 71, "configur": [17, 24, 29, 40, 48, 54, 68], "configura": 78, "configuracion": 78, "configuramo": 78, "confin": [60, 70], "confirm": 26, "confus": [25, 70, 71], "conjunct": 24, "connect": [25, 27, 31, 33, 36, 47, 69, 70, 74], "connected_compon": [36, 65], "consequ": 74, "consequenti": 20, "consid": [24, 25, 29, 36, 37, 39, 41, 44, 45, 48, 51, 52, 58, 71, 77], "consider": 52, "consider_alpha": 58, "consist": [21, 25, 26, 39, 68, 69, 73, 74], "consol": [27, 44, 55], "const": [1, 6, 10], "constant": [17, 23, 24, 26, 28, 29, 34, 39, 40, 44, 46, 47, 48, 50, 56, 64, 65, 70], "constrain": [25, 40], "constraint": 40, "construct": [30, 37, 44, 45, 70], "constructor": [29, 33, 37, 51, 62, 67, 78], "consum": [1, 56, 68, 71], "contact": [62, 63, 64, 65, 66, 67, 68, 70, 72], "contacto": 78, "contain": [0, 6, 9, 17, 23, 24, 25, 26, 28, 29, 30, 32, 33, 34, 35, 36, 38, 39, 40, 41, 43, 45, 46, 47, 48, 51, 52, 54, 55, 57, 58, 61, 62, 63, 66, 67, 70, 71, 72, 74, 76, 77, 78], "conten": 78, "contenedor": 78, "contenido": 78, "content": [24, 35, 42, 46, 48, 63], "contentsof": 62, "context": [24, 42, 48, 60, 71], "contien": 78, "contigu": [19, 25, 52], "continu": [36, 39, 40, 44, 51, 52, 60, 66, 73], "continuaci\u00f3n": 78, "contract": [20, 58], "contrast": [40, 75], "contribut": [21, 67], "contributor": 20, "control": [4, 17, 20, 23, 26, 27, 28, 29, 34, 35, 39, 44, 50, 51, 52, 53, 55, 56, 58, 60, 62, 63, 64, 66, 69, 70, 71, 74, 78], "controlar": 78, "controller_axis_lefti": 47, "controller_axis_leftx": 47, "controller_axis_righti": 47, "controller_axis_rightx": 47, "controller_axis_triggerleft": 47, "controller_axis_triggerright": 47, "controller_button_a": 47, "controller_button_b": 47, "controller_button_back": 47, "controller_button_dpad_down": 47, "controller_button_dpad_left": 47, "controller_button_dpad_right": 47, "controller_button_dpad_up": 47, "controller_button_guid": 47, "controller_button_i": 47, "controller_button_leftshould": 47, "controller_button_leftstick": 47, "controller_button_rightshould": 47, "controller_button_rightstick": 47, "controller_button_start": 47, "controller_button_x": 47, "controller_test": 55, "controlleraxismot": 47, "controllerbuttondown": 47, "controllerbuttonup": 47, "controllerdevicead": [26, 47], "controllerdeviceremap": [26, 47], "controllerdeviceremov": [26, 47], "controllertouchpaddown": 47, "controllertouchpadmot": 47, "controllertouchpadup": 47, "convei": 23, "conveni": [28, 34, 37, 40, 44, 51, 55, 66, 70, 71], "convent": 47, "convers": [1, 20, 21, 36, 37, 42, 53, 71], "convert": [1, 20, 21, 23, 29, 32, 37, 38, 39, 41, 43, 45, 49, 52, 53, 61, 62, 63, 68, 70, 72, 73, 74, 77, 78], "convert_alpha": [27, 32, 52, 72, 74, 77], "conviert": 78, "convolut": [36, 68], "convolv": 36, "cool": 71, "coord": 65, "coordin": [9, 23, 24, 25, 29, 30, 31, 33, 36, 37, 40, 48, 51, 52, 58, 60, 73, 77], "coordinates_from_window": 48, "coordinates_to_window": 48, "copi": [19, 23, 26, 27, 30, 32, 36, 37, 39, 42, 45, 46, 48, 49, 50, 51, 52, 53, 54, 56, 58, 62, 66, 67, 68, 70, 71, 72, 73], "copia": 78, "copiamo": 78, "copiar": 78, "copyright": [20, 41], "coral": 22, "coral1": 22, "coral2": 22, "coral3": 22, "coral4": 22, "cord": 27, "core": 71, "coremidi": 38, "corner": [25, 29, 31, 36, 40, 42, 44, 51, 52, 58, 62, 65, 70, 71, 77], "cornflowerblu": 22, "cornsilk": 22, "cornsilk1": 22, "cornsilk2": 22, "cornsilk3": 22, "cornsilk4": 22, "correct": [20, 23, 28, 40, 45, 52, 68, 70], "correct_gamma": 21, "correctament": 78, "correctli": [25, 37, 38, 39, 48, 58, 65, 68, 70], "correr": 78, "correspond": [21, 26, 29, 32, 34, 36, 38, 41, 42, 45, 50, 52, 55, 71, 77], "corta": 78, "cosa": 78, "cost": [24, 48], "could": [23, 24, 26, 32, 34, 37, 45, 51, 53, 54, 58, 62, 65, 67, 68, 69, 70, 72, 73, 74, 75], "couldn": [33, 74, 77], "count": [19, 33, 36, 39, 42, 58, 65], "counter": 30, "counterclockwis": [25, 29, 37, 58], "countri": 54, "coupl": [33, 62, 67, 68, 70], "courier": 29, "cours": [65, 73, 74, 75, 76, 77], "cover": [1, 17, 25, 34, 44, 45, 48, 52, 58, 63, 65, 70, 71, 73], "cprofil": 71, "cpu": [25, 54, 56, 71], "crash": 67, "crea": 78, "creada": 78, "creamo": 78, "crean": 78, "crearemo": 78, "crearl": 78, "crear\u00e1": 78, "creat": [1, 2, 5, 6, 17, 18, 19, 21, 22, 23, 24, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 39, 40, 42, 43, 45, 47, 48, 49, 50, 51, 52, 53, 54, 56, 58, 60, 61, 63, 65, 66, 67, 68, 71, 72, 73, 74, 75, 76, 77], "create_graphics_screen": 70, "create_screen": 70, "creation": [5, 21, 28, 29, 33, 44, 47, 48, 49, 51, 53, 70], "crect": 65, "cree": 78, "crimson": 22, "critic": 71, "critter": [61, 62, 78], "crop": [45, 58], "cross": [33, 37, 48, 62, 66, 68, 74], "crossbar": 27, "crossbon": 23, "crossfad": 68, "crosshair": 23, "crt": 24, "crucial": 71, "crude": [27, 62, 70], "crudo": 78, "cruza": 78, "cryptic": 67, "ctrl": 60, "cuadro": 78, "cual": 78, "cualquier": 78, "cuando": 78, "cube": 27, "cuni": 25, "cur": 23, "current": [14, 17, 20, 23, 24, 27, 28, 29, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 55, 58, 60, 62, 63, 66, 67, 70, 71, 75, 76, 77], "current_h": [24, 63], "current_w": [24, 63], "cursor": [17, 26, 27, 40, 60, 62, 66, 71, 78], "cursor_arg": 23, "cursor_index": 23, "curv": [31, 37], "custom": [17, 24, 26, 27, 39, 48, 51, 59, 60, 66], "custom_typ": 26, "customis": 74, "cut": [39, 46, 71], "cutout": 70, "cu\u00e1l": 78, "cx1": 45, "cx2": 45, "cy1": 45, "cy2": 45, "cyan": 22, "cyan1": 22, "cyan2": 22, "cyan3": 22, "cyan4": 22, "cz": 25, "c\u00f3digo": [17, 78], "c\u00f3mo": 78, "d": [30, 33, 34, 52, 59, 70, 71, 73, 75], "da": [69, 78], "dafluffypotato": 17, "dai": [66, 67, 71], "damag": 20, "dan": 72, "daninthesh": 72, "dark": [62, 66], "darkblu": 22, "darkcyan": 22, "darken": 24, "darker": 50, "darkgoldenrod": 22, "darkgoldenrod1": 22, "darkgoldenrod2": 22, "darkgoldenrod3": 22, "darkgoldenrod4": 22, "darkgrai": 22, "darkgreen": 22, "darkgrei": 22, "darkkhaki": 22, "darkmagenta": 22, "darkolivegreen": 22, "darkolivegreen1": 22, "darkolivegreen2": 22, "darkolivegreen3": 22, "darkolivegreen4": 22, "darkorang": 22, "darkorange1": 22, "darkorange2": 22, "darkorange3": 22, "darkorange4": 22, "darkorchid": 22, "darkorchid1": 22, "darkorchid2": 22, "darkorchid3": 22, "darkorchid4": 22, "darkr": 22, "darksalmon": 22, "darkseagreen": 22, "darkseagreen1": 22, "darkseagreen2": 22, "darkseagreen3": 22, "darkseagreen4": 22, "darkslateblu": 22, "darkslategrai": 22, "darkslategray1": 22, "darkslategray2": 22, "darkslategray3": 22, "darkslategray4": 22, "darkslategrei": 22, "darkturquois": 22, "darkviolet": 22, "darl": 78, "data": [0, 2, 17, 19, 20, 23, 27, 32, 36, 37, 38, 39, 40, 41, 43, 46, 48, 52, 58, 59, 60, 61, 62, 66, 68, 70, 71, 72, 74, 77, 78], "data1": 38, "data2": 38, "data3": 38, "data_dir": [61, 62, 78], "datatyp": 68, "date": 71, "david": 71, "de": [17, 54], "deal": [34, 44, 68, 71, 76], "dealloc": 33, "dealt": [26, 76], "death": 66, "debat": 71, "debe": 78, "debemo": 78, "deber\u00eda": 78, "deber\u00edan": 78, "debug": [26, 39, 44, 58, 71, 76], "decapit": 66, "decid": [26, 36, 67, 69, 71], "decidimo": 78, "decim": 25, "decimo": 78, "decis": 71, "declar": [9, 44, 68, 70], "decod": [23, 29, 34, 46, 66], "decor": 73, "decreas": [39, 45, 58], "decref": 5, "dedic": 67, "deep": 39, "deepcopi": [26, 52, 56], "deeper": 71, "deeppink": 22, "deeppink1": 22, "deeppink2": 22, "deeppink3": 22, "deeppink4": 22, "deepskyblu": 22, "deepskyblue1": 22, "deepskyblue2": 22, "deepskyblue3": 22, "deepskyblue4": 22, "def": [28, 29, 33, 36, 40, 45, 51, 61, 62, 65, 67, 70, 73, 74, 75, 76, 77, 78], "default": [1, 16, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 32, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 48, 50, 51, 52, 55, 56, 58, 62, 63, 66, 70, 72, 78], "default_id": 38, "default_lay": 51, "defin": [1, 2, 3, 6, 8, 9, 11, 12, 15, 26, 28, 29, 35, 44, 46, 51, 60, 62, 69, 70, 71, 73, 76], "definida": 78, "definimo": 78, "definir": 78, "definir\u00e1": 78, "definit": [46, 64, 67, 68], "deflat": 77, "degener": 30, "degre": [29, 30, 31, 36, 37, 39, 48, 53, 58, 62, 75, 77], "dej\u00f3": 78, "del": [17, 33, 60, 68], "delai": [24, 27, 32, 34, 38, 56, 71], "delet": [26, 34, 67, 70, 71], "delic": 54, "deliv": 38, "delta": [17, 37], "demand": 60, "demasiado": 78, "demo": [27, 62, 68], "demonstr": [17, 27, 37, 62, 68, 72], "demostraci\u00f3n": 78, "demuestra": 78, "denot": [41, 45, 56], "dentro": 78, "depend": [16, 24, 26, 28, 29, 32, 36, 39, 40, 41, 42, 43, 48, 49, 60, 61, 62, 66, 71, 72, 78], "dependiendo": 78, "deprec": [20, 21, 24, 25, 26, 27, 29, 32, 33, 37, 40, 46, 49, 51, 52, 53, 58, 60], "deprecationwarn": [49, 53], "depth": [17, 20, 24, 36, 42, 48, 50, 52, 53, 58, 62, 63, 65, 70], "deriv": [27, 44, 51, 62, 67, 71], "deriva": 78, "derivada": 78, "descend": [29, 54], "descent": [28, 29], "describ": [1, 19, 23, 24, 28, 38, 40, 45, 58, 63, 65, 74], "descript": [1, 20, 23, 26, 29, 34, 35, 44, 67, 70], "desd": 78, "deseado": 78, "design": [19, 40, 51, 52, 66, 67, 69, 70, 76], "desir": [20, 52, 58, 62, 63, 71], "desktop": [24, 40, 44, 60, 63, 71], "desper": 70, "dest": [29, 36, 48, 52, 68], "dest_surf": 58, "dest_surfac": [20, 58], "destin": [20, 28, 29, 31, 36, 42, 48, 50, 51, 52, 58, 66, 70, 72, 73], "destroi": [1, 60, 67], "destruct": [58, 60, 62], "destruida": 78, "detail": [17, 24, 25, 29, 33, 34, 35, 36, 37, 38, 44, 51, 52, 58, 65, 69, 71], "detect": [24, 27, 34, 36, 37, 42, 44, 45, 51, 65], "deterior": 78, "determin": [21, 23, 24, 25, 28, 29, 30, 32, 34, 37, 38, 41, 51, 52, 54, 58, 63, 67, 68, 75], "determinar": 78, "dev": [20, 65], "dev13": 26, "dev3": [26, 56], "dev7": 40, "dev8": 25, "deva": 28, "devanagari": 28, "develop": [24, 40, 44, 48, 55, 60, 66, 71, 72, 74], "deviat": 58, "devic": [7, 17, 20, 26, 27, 33, 34, 38, 39, 40, 44, 47, 48, 54, 57, 63, 65, 66, 71], "device_id": [27, 38], "device_index": [26, 33], "devicenam": 39, "devolv": 78, "devolvemo": 78, "devuelv": 78, "dga": 24, "diagnost": 39, "diagon": [36, 58], "diagram": [75, 76], "diamet": 30, "diamond": 23, "dibujamo": 78, "dibujarlo": 78, "dibujar\u00e1": 78, "dibujo": 78, "dict": [1, 5, 19, 21, 24, 26, 33, 36, 41, 45, 47, 52, 54, 55, 56, 57], "dict_proxi": 5, "dictionari": [1, 24, 26, 41, 45, 47, 51, 55, 67, 71], "dictproxi": 5, "did": [20, 25, 39, 42, 58, 66, 67, 70], "didn": [71, 73], "diferent": 78, "diff": 68, "differ": [3, 17, 20, 21, 23, 24, 25, 27, 28, 29, 31, 33, 34, 36, 39, 40, 41, 42, 44, 48, 50, 51, 52, 58, 59, 62, 63, 64, 65, 66, 67, 68, 70, 71, 72, 73, 75, 76], "difficult": [38, 66, 69, 72], "digit": [21, 33, 37], "dimens": [19, 20, 24, 25, 27, 28, 29, 31, 32, 36, 37, 42, 43, 45, 51, 52, 53, 58, 62, 68, 77], "dimension": [21, 25, 29, 31, 36, 37, 42, 68, 70, 78], "dimgrai": 22, "dimgrei": 22, "direcci\u00f3n": 78, "direct": [20, 24, 25, 27, 28, 29, 31, 33, 37, 40, 43, 47, 52, 62, 68, 70, 71, 72, 75, 77], "direct3d": 48, "directfb": 24, "direction_btt": 28, "direction_ltr": 28, "direction_rtl": 28, "direction_ttb": 28, "directli": [3, 16, 19, 23, 24, 25, 26, 28, 29, 32, 34, 39, 42, 43, 46, 49, 52, 53, 55, 67, 68, 70, 71], "directmedia": 66, "directori": [24, 28, 29, 55, 62, 70, 74], "directorio": 78, "directx": [24, 38, 66], "dirti": [51, 67, 71], "dirty_rect": 71, "dirtysprit": 51, "disabl": [24, 26, 29, 34, 44, 47, 52, 56, 61, 78], "disable_advanced_featur": 44, "disadvantag": [63, 71], "disallow": 24, "disappear": [20, 31, 46, 52], "discard": 56, "disclaim": 20, "disconnect": [33, 69], "discontinu": [19, 52], "discov": [66, 71], "discuss": [67, 71], "disk": [39, 51, 71], "displai": [0, 1, 17, 23, 25, 26, 27, 31, 33, 34, 35, 37, 39, 40, 44, 46, 51, 52, 55, 60, 61, 65, 66, 68, 70, 71, 72, 73, 75, 76, 77, 78], "display_index": 26, "display_surf": 72, "dispon": 78, "disponibilidad": 78, "distanc": [30, 37, 39, 42, 58], "distance_squared_to": 37, "distance_to": 37, "distil": 71, "distinguish": 34, "distort": 24, "distribuci\u00f3n": 78, "distribut": [17, 20, 24, 28, 54, 55, 62], "divers": 69, "divid": [34, 50, 69], "divis": [21, 23, 71], "dizzi": [61, 62, 78], "do": [9, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 33, 34, 36, 42, 44, 45, 47, 48, 51, 52, 54, 58, 62, 63, 64, 65, 66, 67, 68, 69, 72, 73, 74, 75, 76, 77, 78], "do_clamp": 37, "dobl": 78, "doc": [24, 41, 48, 51, 52, 71], "document": [20, 35, 39, 44, 52, 63, 65, 66, 67, 68, 69, 70, 71, 74, 75], "dodgerblu": 22, "dodgerblue1": 22, "dodgerblue2": 22, "dodgerblue3": 22, "dodgerblue4": 22, "doe": [3, 4, 5, 8, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 43, 44, 45, 46, 47, 51, 52, 56, 57, 58, 60, 62, 65, 67, 68, 70, 71, 72, 74, 76], "doesn": [20, 24, 25, 27, 28, 29, 44, 50, 52, 60, 62, 67, 70, 71, 72, 74, 75, 76, 77], "dog": 72, "dokil": [51, 67], "dokill1": [51, 67], "dokill2": [51, 67], "dollar": 34, "domain": 27, "don": [5, 10, 17, 20, 25, 26, 27, 29, 33, 37, 51, 52, 54, 56, 58, 60, 62, 65, 66, 67, 68, 69, 70, 72, 73, 74, 75, 77], "dond": 78, "done": [25, 28, 29, 33, 41, 62, 66, 68, 70, 71, 75], "doreturn": 52, "dot": [29, 37], "doubl": [10, 23, 24, 26, 58, 62, 66, 68], "doublebuf": [24, 71], "doubler": 58, "down": [24, 29, 31, 33, 34, 40, 44, 47, 52, 63, 65, 66, 68, 70, 71, 76], "download": [66, 77], "dpad": 47, "dpi": [29, 44, 60], "drain": 54, "drastic": 73, "draw": [17, 21, 24, 28, 29, 32, 33, 36, 48, 50, 51, 52, 60, 61, 65, 66, 67, 70, 71, 73, 77, 78], "draw_blend_mod": 48, "draw_bottom_left": 25, "draw_bottom_right": 25, "draw_color": 48, "draw_lin": 48, "draw_point": 48, "draw_quad": 48, "draw_rect": [45, 48], "draw_top_left": 25, "draw_top_right": 25, "draw_triangl": 48, "drawn": [24, 25, 28, 31, 33, 36, 48, 50, 51, 52, 62, 66, 67, 70, 71, 73], "drawplain": 78, "drew": 70, "drift": 33, "drive": 60, "driven": [24, 51], "driver": [24, 38, 39, 44, 48, 60, 63], "drivernam": 44, "drop": [26, 39], "dropbegin": 26, "dropcomplet": 26, "dropfil": 26, "dropout": 39, "droptext": 26, "dstalphafactor": 48, "dstcolorfactor": 48, "dstobj": 12, "dstrect": [12, 48], "dt": 17, "dualshock": 47, "due": [5, 21, 24, 26, 29, 37, 40, 41, 48, 71], "dull": 71, "dump": 55, "dungeon": 66, "duplic": [37, 51, 52], "durat": [33, 47], "dure": [5, 20, 24, 29, 31, 34, 41, 42, 48, 53, 68, 72], "dx": [26, 36, 52, 75, 77], "dy": [26, 36, 52, 75, 77], "dynam": [10, 71], "d\u00e9cada": 17, "d\u00f3nde": 78, "e": [21, 24, 25, 26, 28, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 44, 45, 51, 52, 59, 60, 65, 66, 69, 71, 73, 75, 76, 78], "each": [19, 20, 21, 24, 25, 26, 27, 28, 29, 31, 32, 33, 36, 37, 39, 40, 42, 46, 48, 49, 50, 51, 52, 53, 54, 55, 58, 62, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77], "earli": [17, 48, 66, 71], "earlier": [27, 41, 43, 70], "easi": [17, 27, 48, 63, 64, 66, 67, 68, 69, 70, 71, 76, 77], "easier": [45, 51, 52, 63, 64, 70, 72, 75], "easiest": [27, 47, 70, 73], "easili": [17, 23, 44, 62, 64, 65, 67, 68, 70, 71, 75], "east": 23, "eat": 67, "echo": 27, "eclass": 10, "eclecti": 65, "ed": [52, 67], "edg": [24, 25, 28, 30, 40, 45, 58, 71, 72, 77], "edit": [26, 34, 47, 72], "editbox": 71, "editor": [26, 34, 71], "efecto": 78, "effect": [17, 24, 26, 27, 28, 30, 33, 41, 44, 46, 47, 48, 50, 51, 52, 58, 62, 65, 66, 67, 68, 70, 71, 74], "effici": [17, 24, 26, 28, 51, 52, 67, 70, 71], "effort": 29, "eg": [27, 29], "eight": 27, "either": [16, 19, 21, 23, 24, 29, 30, 32, 33, 37, 39, 40, 45, 48, 51, 52, 58, 62, 63, 77], "ej": 78, "ejecuci\u00f3n": 78, "ejecut": 78, "ejecuta": 78, "ejecutan": 78, "ejecutar": 78, "ejemplo": 17, "el": 17, "element": [3, 19, 21, 29, 37, 38, 42, 43, 49, 52, 54, 58, 67, 68, 70], "elementari": 75, "elementwis": 37, "eleven": 58, "elif": [40, 61, 62, 76, 77, 78], "ella": 78, "ellips": [17, 25, 31], "ellipsi": 23, "ellipt": [25, 31], "ello": 78, "els": [1, 9, 30, 33, 34, 43, 44, 45, 46, 60, 61, 62, 63, 67, 74, 77, 78], "elsewher": [1, 71], "emb": 24, "embed": [24, 29], "emit": [24, 40], "emoci\u00f3n": 78, "emoji": [28, 29], "emphasi": 71, "empic": 78, "empiec": 78, "emploi": 71, "empti": [5, 24, 26, 28, 29, 30, 33, 34, 36, 39, 41, 44, 45, 46, 48, 51, 54, 55, 60, 63, 67], "emscripten": 56, "emul": [26, 28, 40, 63], "en": [17, 24, 54, 71], "enabl": [24, 26, 28, 29, 34, 40, 44, 45, 47, 48, 60, 66], "encapsul": [48, 76], "encarga": 78, "enclos": [25, 51], "encod": [10, 16, 23, 28, 29, 41, 44, 46, 50, 52], "encode_file_path": 44, "encode_str": 44, "encontrado": 78, "encontrar": 78, "encount": 36, "encourag": [29, 54], "encuentr": 78, "encuentra": 78, "end": [24, 25, 26, 30, 31, 32, 34, 39, 41, 44, 45, 48, 51, 61, 62, 66, 69, 70, 71, 72, 73, 76, 78], "end_index": 68, "end_po": 25, "endcap": [25, 31], "endev": [39, 41], "endian": [19, 44], "endpoint": [31, 45], "enemi": 67, "engin": [66, 71], "english": 54, "enhanc": 17, "enlarg": 29, "enough": [29, 48, 51, 52, 62, 64, 65, 66, 67, 68, 70, 71], "ensur": [24, 26, 34, 39, 60, 66, 70, 71, 73, 74], "entail": 71, "enter": [26, 28, 34, 40, 60, 62], "entir": [1, 17, 24, 25, 36, 39, 48, 51, 52, 66, 70, 71], "entiti": 70, "entonc": 78, "entr": 78, "entri": [19, 34, 52, 71], "enumer": 20, "env": [61, 74], "env_var": 44, "environ": [24, 26, 28, 33, 38, 39, 44, 46, 60, 66, 74, 75], "epsilon": 37, "equal": [14, 19, 21, 23, 24, 25, 26, 28, 29, 32, 34, 36, 37, 48, 52, 58], "equat": 36, "equip": 68, "equival": [19, 29, 30, 36, 37, 38, 42, 43, 50, 54, 58, 60, 71], "eras": [33, 36, 51, 52, 62, 66, 67, 70, 71], "err": [74, 77], "errno": 38, "error": [1, 2, 6, 10, 12, 21, 24, 26, 27, 28, 29, 30, 32, 34, 37, 38, 39, 40, 41, 43, 44, 45, 46, 52, 55, 58, 60, 62, 64, 67, 68, 71, 74, 78], "error_msg": 44, "errorstr": 44, "es": 78, "esa": 78, "esc": 27, "escala": 78, "escalar": 78, "escap": [16, 24, 29, 34, 62, 71, 77, 78], "escape_button": 24, "esconderlo": 78, "escribirla": 78, "eso": 78, "espacio": 78, "espa\u00f1ol": 78, "especi": [5, 26, 29, 44, 54, 68, 74, 78], "especifico": 78, "esperamo": 78, "esquina": 78, "essenti": [68, 72], "est": [17, 78], "esta": 78, "establec": 78, "establecemo": 78, "estado": 78, "estamo": 78, "estar": 78, "estefania": 78, "estim": 54, "esto": 78, "estuviera": 78, "est\u00e1": [17, 78], "est\u00e1n": 78, "est\u00e1ndar": 78, "est\u00e9": 78, "est\u00e9n": 78, "etc": [26, 32, 33, 36, 38, 42, 45, 54, 68, 69, 71], "etyp": 44, "euclidean": [37, 42], "euro": 34, "eval": 55, "evaluaci\u00f3n": 78, "even": [16, 20, 24, 25, 27, 28, 29, 33, 34, 40, 41, 42, 44, 56, 65, 66, 67, 68, 70, 71], "event": [0, 17, 20, 23, 24, 25, 27, 33, 34, 35, 38, 39, 40, 41, 44, 47, 54, 56, 60, 61, 65, 66, 69, 70, 72, 77, 78], "event_nam": 26, "eventlist": [26, 27], "eventtyp": [5, 26], "eventu": [13, 24, 26], "ever": [38, 41, 63], "everi": [5, 17, 20, 23, 26, 27, 32, 33, 34, 36, 37, 39, 41, 44, 51, 52, 53, 56, 58, 59, 63, 66, 67, 68, 69, 70, 71, 73, 74, 76], "everyth": [30, 43, 44, 60, 61, 66, 67, 68, 70, 71, 73, 77], "evil": 71, "evolv": 27, "ex": 40, "exact": [21, 23, 24, 25, 32, 33, 40, 63, 65, 72], "exactament": 78, "exactli": [32, 38, 42, 45, 52, 62, 66, 67, 68, 70, 71], "examin": 17, "examina": 17, "examinaremo": 78, "exampl": [11, 17, 19, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 44, 45, 46, 47, 49, 51, 52, 54, 55, 58, 60, 64, 65, 66, 67, 69, 70, 71, 72, 73, 74, 75, 76, 78], "exce": [24, 40, 52], "exceedingli": 29, "excel": [62, 66, 70], "excelent": 78, "except": [1, 3, 4, 5, 6, 7, 8, 9, 10, 12, 16, 21, 23, 24, 25, 26, 28, 29, 30, 32, 34, 38, 39, 41, 44, 45, 46, 52, 58, 60, 64, 68, 69, 74, 77], "exchang": 42, "excit": [60, 62, 66, 68, 70], "exclaim": 34, "exclud": [19, 26, 55], "exclus": [38, 52], "execut": [17, 24, 40, 55, 61, 71], "exemplari": 20, "exis": 78, "exist": [20, 23, 24, 26, 28, 29, 33, 34, 38, 44, 47, 48, 51, 52, 57, 67], "exit": [24, 25, 33, 38, 40, 44, 60, 66, 70, 73, 74, 77], "expand": [58, 69], "expect": [21, 24, 30, 32, 34, 37, 38, 39, 40, 43, 54, 55, 65, 70, 72], "expens": [48, 49, 53, 54, 68], "experi": [26, 50, 66, 67], "experiment": [20, 24, 26, 30, 31, 37, 44, 46, 48, 54, 65], "experimental_modul": 17, "expir": 55, "explain": [37, 62, 67, 70, 74, 75, 77], "explan": [17, 27, 37, 61, 64, 67, 71], "explanatori": 62, "explica": 78, "explicando": 78, "explicit": [24, 40, 43], "explicitament": 78, "explicitli": [20, 24, 29, 31, 42, 56, 58, 60, 62, 64], "explor": 66, "explos": 67, "export": [0, 11, 21, 32, 39, 42, 43, 52, 59, 71, 72], "expos": [2, 11, 29, 43, 52], "express": [20, 21, 60], "extend": [19, 30, 32, 44, 51], "extens": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 17, 32, 66], "extern": [23, 26, 49, 53], "extptr": 10, "extra": [23, 29, 32, 39, 45, 51, 52, 62, 63, 66, 67, 68, 70, 71, 72, 77, 78], "extract": [42, 58, 62], "extraer": 78, "extralight": [28, 29], "extrapol": 37, "extrem": [27, 62, 68, 70], "extremandament": 78, "ey": [66, 72], "f": [1, 19, 20, 33, 34, 45, 60, 71, 74, 77], "f1": 34, "f10": 34, "f11": 34, "f12": 34, "f13": 34, "f14": 34, "f15": 34, "f2": 34, "f3": 34, "f4": 34, "f5": 34, "f6": 34, "f7": 34, "f8": 34, "f9": 34, "face": 17, "fact": [31, 67, 71], "factor": [27, 29, 30, 58, 62, 68], "factor_and_origin": 30, "fade": [27, 39, 41, 68], "fade_m": [39, 41], "fadeout": [39, 41], "fail": [24, 26, 29, 39, 41, 44, 54, 55, 62, 64, 71], "failur": [1, 2, 3, 4, 5, 7, 8, 9, 55], "fairli": [48, 51, 64, 66, 71, 74, 75], "fake": [27, 28, 55], "fall": [28, 29, 51], "fallaron": 78, "fallback": 48, "fals": [2, 4, 5, 6, 12, 15, 17, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 44, 45, 46, 47, 48, 51, 52, 54, 55, 58, 60, 61, 62, 65, 70, 71, 72, 77, 78], "falsi": 45, "famili": [28, 39], "familiar": [66, 67, 70, 71, 73, 76], "fantast": 70, "far": [21, 37, 62, 70, 71, 72, 75, 76, 77], "farther": [62, 70], "fast": [33, 36, 42, 48, 52, 53, 58, 62, 66, 67, 68, 70, 71], "faster": [32, 37, 44, 50, 51, 52, 53, 54, 58, 62, 67, 68, 71, 72], "fastest": [24, 52, 62, 66], "fastrendergroup": 27, "favorit": 71, "favour": 24, "fbcon": 24, "fblit": [50, 52], "fear": 71, "feather": 71, "featur": [17, 24, 27, 28, 29, 30, 36, 44, 51, 52, 54, 60, 63, 67, 68, 71, 75], "fed": 20, "feed": 77, "feedback": [24, 54], "feel": [27, 67, 70, 71], "felt": 66, "fetch": 51, "fever": [61, 62, 78], "few": [23, 28, 54, 56, 66, 67, 68, 70, 71, 74], "fewer": 56, "ffff": 16, "fgcolor": 29, "field": [4, 9, 19, 33, 38, 54], "fighter": 66, "figur": [54, 70, 71], "fija": 78, "file": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 17, 23, 24, 26, 27, 28, 29, 32, 39, 41, 44, 49, 55, 59, 62, 66, 68, 69, 71, 74, 78], "file_path": 27, "filelik": 59, "filenam": [6, 23, 28, 29, 32, 39, 41, 44, 70, 74], "filenotfounderror": [41, 74, 77], "fileobj": 41, "filepath": 39, "filesystem": 16, "fill": [9, 10, 17, 21, 23, 24, 25, 26, 27, 29, 31, 33, 36, 40, 43, 48, 50, 51, 52, 60, 61, 62, 65, 66, 70, 71, 72, 73, 77, 78], "fill_quad": 48, "fill_rect": 48, "fill_triangl": 48, "filled_": 31, "filled_circl": 31, "filled_ellips": 31, "filled_polygon": 31, "filled_trigon": 31, "filter": [17, 36, 48, 58, 68], "fin": 27, "final": [23, 27, 28, 29, 36, 42, 44, 52, 58, 62, 69, 70, 71, 72, 73, 74, 77], "finalment": 78, "find": [17, 20, 24, 26, 27, 28, 30, 33, 36, 37, 39, 41, 45, 51, 52, 54, 58, 62, 63, 65, 66, 67, 68, 70, 71, 75, 77], "find_channel": 39, "fine": [39, 52, 63, 67, 71], "finer": 65, "finger": [57, 74], "finger_id": 26, "fingerdown": 26, "fingermot": 26, "fingerup": 26, "finish": [13, 34, 39, 41, 52, 64, 66, 68, 69, 70, 71], "finit": 36, "fire": [26, 68, 71], "firebrick": 22, "firebrick1": 22, "firebrick2": 22, "firebrick3": 22, "firebrick4": 22, "firmer": [66, 69], "first": [3, 19, 25, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 41, 42, 43, 45, 48, 49, 51, 52, 53, 54, 56, 58, 62, 63, 64, 65, 66, 67, 68, 69, 71, 72, 73, 75, 76, 77], "fist": [17, 61, 62, 78], "fist_offset": [61, 62, 78], "fit": [18, 20, 24, 29, 36, 39, 45, 48, 52, 73], "five": [39, 40, 41], "fix": [29, 37, 42, 52, 58, 66, 68, 71, 77], "fixed_s": 29, "fixed_width": 29, "flac": 39, "flag": [1, 19, 21, 24, 25, 27, 28, 29, 33, 35, 36, 43, 48, 51, 52, 60, 62, 63, 67, 71, 72, 78], "flame": 68, "flash": [17, 60], "flash_briefli": 60, "flash_cancel": 60, "flash_until_focus": 60, "flesh": 17, "flexibl": [17, 64, 67, 74, 75], "flip": [17, 20, 23, 24, 25, 26, 30, 32, 33, 36, 40, 42, 45, 48, 51, 58, 60, 61, 62, 65, 66, 68, 71, 72, 73, 77, 78], "flip_ab": 30, "flip_ab_ip": 30, "flip_i": [48, 58], "flip_x": [48, 58], "float": [1, 9, 19, 21, 25, 29, 30, 31, 32, 33, 36, 37, 39, 41, 45, 48, 51, 52, 53, 56, 58, 59, 60, 68], "float32": 53, "float64": 53, "float96": 53, "flood_fil": 25, "floor": 21, "floralwhit": 22, "flush": [32, 38, 40], "fly": [30, 45, 71, 73, 76], "fnt": 29, "focu": [24, 26, 33, 34, 40, 44, 60, 65], "focus": 60, "folder": [54, 62], "folk": 70, "follow": [19, 20, 23, 25, 26, 27, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 41, 45, 47, 49, 50, 51, 53, 61, 62, 66, 67, 68, 69, 71, 78], "font": [6, 17, 27, 33, 44, 61, 62, 64, 66, 71, 72, 73, 78], "font_cent": 28, "font_index": [6, 29], "font_left": 28, "font_right": 28, "fonti": 27, "foo": 71, "fool": [66, 68], "forbidden": 10, "forc": [24, 27, 39, 44, 66], "forcibli": 39, "forego": 26, "foreground": [26, 29], "foreign": 70, "forestgreen": 22, "forev": [70, 71], "forget": [17, 33, 67, 75], "form": [20, 23, 24, 31, 38, 52, 71, 73], "forma": 78, "formal": 70, "format": [20, 21, 23, 24, 25, 29, 31, 32, 36, 38, 39, 41, 42, 43, 44, 45, 48, 49, 52, 53, 58, 62, 63, 66, 68, 70, 71, 72, 73], "formato": 78, "formerli": 60, "formula": [21, 30, 37, 42, 44, 58, 72, 75], "forth": 62, "fortun": [27, 68, 70], "forward": [34, 72], "found": [17, 21, 27, 28, 29, 34, 35, 36, 38, 41, 45, 51, 52, 53, 62, 63, 68, 70, 73, 76], "four": [3, 23, 24, 25, 29, 45, 53, 59, 77], "fourth": [23, 48, 72], "fout": 27, "fox": 72, "fp": [17, 46, 51, 71], "frac": 30, "fraction": [29, 45], "frame": [17, 20, 24, 26, 32, 33, 34, 40, 44, 51, 56, 62, 65, 66, 70, 71, 73, 76, 77], "framebuff": 24, "framer": [17, 20, 56, 62, 65, 70], "framework": [27, 66, 71], "frect": [9, 30, 45, 52], "free": [10, 26, 27, 41, 67, 70, 71], "freed": 5, "freedom": [17, 66], "freesansbold": 28, "freetyp": [6, 17, 27, 28, 29, 44], "freetype2": 29, "freetype_misc": [27, 29], "frequenc": [38, 39], "frequencia": 78, "frequency_to_midi": 38, "frequent": [33, 48, 54, 67, 70, 71], "fresh": 71, "friendli": [25, 48], "friendlier": 66, "frill": 67, "from": [0, 3, 6, 9, 17, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 58, 60, 62, 64, 65, 66, 67, 68, 69, 71, 72, 73, 74, 75, 76, 77, 78], "from_cmi": 21, "from_display_modul": 60, "from_hex": 21, "from_hsla": 21, "from_hsva": 21, "from_i1i2i3": 21, "from_joystick": 47, "from_norm": 21, "from_polar": 37, "from_spher": 37, "from_surfac": [36, 48, 51], "from_threshold": [36, 65], "from_window": 48, "frombuff": 32, "frombyt": 32, "fromstr": 32, "front": 51, "frozen": [26, 55, 71], "frustrat": 71, "ftfont": [28, 29], "fuchsia": 22, "fue": 78, "fuent": 78, "fueran": 78, "full": [17, 24, 26, 27, 28, 29, 32, 33, 39, 40, 41, 42, 51, 52, 60, 61, 62, 63, 65, 66, 67, 70, 71, 73, 74, 77, 78], "fulli": [21, 24, 34, 45, 51, 52, 53, 54, 60, 62, 68, 70, 72], "fullnam": [61, 62, 74, 77, 78], "fullscreen": [24, 35, 51, 60, 63], "fullscreen_desktop": 60, "fun": [27, 65, 66, 68, 70, 71], "func": 45, "funcion": 78, "funciona": 78, "funci\u00f3n": 78, "function": [0, 1, 3, 5, 8, 9, 10, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 43, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 55, 56, 58, 59, 60, 61, 62, 64, 65, 66, 67, 69, 71, 73, 75, 76, 77], "fundament": [69, 71], "funni": 67, "further": [46, 52, 59, 72], "futur": [17, 24, 26, 28, 29, 33, 38, 39, 40, 46, 60, 67], "f\u00e1cilment": 78, "g": [21, 24, 25, 26, 27, 28, 31, 32, 34, 37, 38, 40, 42, 43, 44, 45, 51, 52, 58, 59, 60, 66, 71, 75, 76], "gain": [24, 26, 29, 65, 71], "gainsboro": 22, "game": [17, 18, 20, 23, 24, 26, 27, 33, 40, 44, 47, 52, 54, 56, 61, 63, 64, 65, 67, 70, 72, 74, 76, 77, 78], "gameobject": [70, 71], "gamepad": [7, 26, 47], "gameplai": [34, 67, 77], "gamma": [21, 24], "gap": [19, 52], "garbag": [13, 52, 60], "gather": 63, "gaussian": [58, 68], "gaussian_blur": 58, "gener": [1, 17, 24, 26, 27, 32, 33, 34, 38, 40, 41, 42, 44, 47, 48, 52, 53, 54, 58, 59, 60, 62, 65, 66, 67, 68, 71, 74, 77], "genera": 78, "generalment": 78, "geometri": [17, 30], "german": 54, "get": [2, 7, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 38, 39, 40, 41, 42, 43, 44, 46, 47, 48, 49, 51, 52, 53, 54, 55, 56, 57, 58, 60, 61, 62, 63, 64, 65, 66, 67, 68, 70, 72, 73, 74, 75, 76, 77, 78], "get_abs_offset": 52, "get_abs_par": 52, "get_act": 24, "get_allow_screensav": 24, "get_alpha": [52, 74, 77], "get_and_flip": 65, "get_arraytyp": [49, 53], "get_asc": 28, "get_at": [36, 52, 61, 62, 68, 71, 78], "get_at_map": [21, 52], "get_axi": [33, 47], "get_backend": 20, "get_bal": 33, "get_bits": 52, "get_block": 26, "get_bold": 28, "get_bottom_lay": 51, "get_bounding_rect": [36, 52], "get_buff": [2, 19, 52], "get_busi": [39, 41], "get_button": [33, 47], "get_bytes": [42, 52], "get_cache_s": 29, "get_capt": 24, "get_clip": [51, 52], "get_colorkei": 52, "get_control": [20, 65], "get_count": [33, 38, 47], "get_cpu_instruction_set": 54, "get_current_refresh_r": 24, "get_cursor": 40, "get_default_font": [28, 29], "get_default_input_id": 38, "get_default_output_id": 38, "get_default_resolut": 29, "get_desc": 28, "get_desktop_refresh_r": 24, "get_desktop_s": 24, "get_devic": 57, "get_device_info": 38, "get_driv": [24, 39, 48, 63], "get_endev": [39, 41], "get_error": [29, 44], "get_eventst": 47, "get_extend": 32, "get_fing": 57, "get_flag": 52, "get_focus": [24, 34, 40], "get_font": 28, "get_fp": 56, "get_frect": 52, "get_grab": 26, "get_grabbed_window": [48, 60], "get_guid": 33, "get_hat": 33, "get_height": [17, 28, 52], "get_id": 33, "get_imag": [20, 65], "get_init": [24, 28, 29, 33, 38, 39, 44, 46, 47, 49, 61, 62, 64, 78], "get_instance_id": 33, "get_ital": 28, "get_just_press": [34, 40], "get_just_releas": [34, 40], "get_layer_of_sprit": 51, "get_length": 39, "get_lines": 28, "get_lock": 52, "get_loss": 52, "get_map": 47, "get_mask": 52, "get_metadata": 41, "get_metr": 29, "get_mod": 34, "get_nam": 33, "get_num_channel": 39, "get_num_devic": 57, "get_num_displai": 24, "get_num_fing": 57, "get_numax": 33, "get_numbal": 33, "get_numbutton": 33, "get_numhat": 33, "get_offset": 52, "get_palett": 52, "get_palette_at": 52, "get_par": 52, "get_pitch": 52, "get_po": [40, 41, 61, 62, 71, 78], "get_point_s": 28, "get_power_level": 33, "get_power_st": 54, "get_pref_local": 54, "get_pref_path": 54, "get_press": [17, 34, 40, 70, 71], "get_queu": 39, "get_raw": [20, 39], "get_rawtim": 56, "get_rect": [29, 36, 45, 48, 51, 52, 61, 62, 66, 70, 73, 74, 75, 76, 77, 78], "get_rel": 40, "get_relative_mod": 40, "get_repeat": 34, "get_sdl_byteord": 44, "get_sdl_image_vers": 32, "get_sdl_mixer_vers": [39, 41], "get_sdl_ttf_vers": 28, "get_sdl_vers": [24, 44], "get_shift": 52, "get_siz": [20, 29, 36, 42, 52, 61, 62, 73, 77, 78], "get_sized_ascend": 29, "get_sized_descend": 29, "get_sized_glyph_height": 29, "get_sized_height": 29, "get_smoothscale_backend": 58, "get_sound": 39, "get_soundfont": 39, "get_sprit": 51, "get_sprites_at": 51, "get_sprites_from_lay": 51, "get_strikethrough": 28, "get_surfac": [24, 60, 61, 62, 75, 76, 77, 78], "get_text": 46, "get_tick": 56, "get_tim": 56, "get_top_lay": 51, "get_top_sprit": 51, "get_total_ram": 54, "get_typ": 46, "get_underlin": 28, "get_vers": 29, "get_view": [19, 52], "get_viewport": 48, "get_vis": 40, "get_volum": [39, 41], "get_width": [17, 52, 61, 62, 78], "get_window_posit": 24, "get_window_s": 24, "get_wm_info": 24, "getattr": 44, "getbufferproc": 2, "getfilesystemencod": [16, 44], "getopt": [74, 77], "gfxdraw": [11, 17, 25, 31], "gg": 21, "ggi": 24, "ghost": 67, "ghostwhit": 22, "gif": [32, 66, 71], "gil": [5, 10, 31], "girando": 78, "girar": 78, "girar\u00e1": 78, "github": [17, 44, 46], "give": [17, 19, 23, 24, 29, 33, 37, 38, 41, 42, 48, 50, 51, 52, 62, 63, 64, 68, 69, 71, 73, 74, 75], "given": [9, 14, 19, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 36, 37, 38, 39, 40, 44, 45, 46, 47, 48, 51, 52, 53, 56, 57, 58, 60, 62, 63, 67, 71], "gl": [24, 60], "gl_accelerated_visu": 24, "gl_accum_alpha_s": 24, "gl_accum_blue_s": 24, "gl_accum_green_s": 24, "gl_accum_red_s": 24, "gl_alpha_s": 24, "gl_buffer_s": 24, "gl_context_flag": 24, "gl_context_major_vers": 24, "gl_context_minor_vers": 24, "gl_context_profile_": 24, "gl_context_profile_compat": 24, "gl_context_profile_cor": 24, "gl_context_profile_mask": 24, "gl_context_release_behavior": 24, "gl_depth_siz": 24, "gl_framebuffer_srgb_cap": 24, "gl_get_attribut": 24, "gl_multisamplebuff": 24, "gl_multisamplesampl": 24, "gl_set_attribut": 24, "gl_share_with_current_context": 24, "gl_stencil_s": 24, "gl_stereo": 24, "glcube": 27, "glitch": 77, "global": [28, 29, 50, 55, 64, 74, 77], "glow": 50, "glsl": 37, "glue": 77, "glyph": [28, 29], "gmail": 72, "gnu": [74, 77], "go": [21, 23, 24, 25, 33, 37, 38, 48, 52, 55, 61, 62, 63, 64, 65, 67, 68, 69, 71, 72, 73, 74, 76, 77, 78], "goal": 66, "goe": [62, 67, 70, 71, 77], "gold": 22, "gold1": 22, "gold2": 22, "gold3": 22, "gold4": 22, "golden": 63, "goldenrod": 22, "goldenrod1": 22, "goldenrod2": 22, "goldenrod3": 22, "goldenrod4": 22, "golp": 78, "golpeabl": 78, "golpeado": 78, "golpear": 78, "gone": [70, 77], "good": [17, 20, 23, 24, 27, 28, 39, 44, 52, 62, 66, 68, 69, 70, 71, 73, 74, 75, 77], "goodluck": 27, "googl": 71, "got": [17, 26, 41, 65, 67, 70, 71], "gotten": 70, "gpu": 48, "grab": [26, 34, 40, 48, 60, 67, 70, 77], "grab_keyboard": 60, "grab_mous": 60, "grace": 77, "gradient": [27, 36, 68], "grado": 78, "gradual": 24, "grai": [22, 29, 62], "grain": 71, "grand": 78, "graphic": [24, 27, 48, 58, 62, 63, 66, 67, 68, 70, 71], "grasp": [69, 77], "grave": 34, "gray0": 22, "gray1": 22, "gray10": 22, "gray100": 22, "gray11": 22, "gray12": 22, "gray13": 22, "gray14": 22, "gray15": 22, "gray16": 22, "gray17": 22, "gray18": 22, "gray19": 22, "gray2": 22, "gray20": 22, "gray21": 22, "gray22": 22, "gray23": 22, "gray24": 22, "gray25": 22, "gray26": 22, "gray27": 22, "gray28": 22, "gray29": 22, "gray3": 22, "gray30": 22, "gray31": 22, "gray32": 22, "gray33": 22, "gray34": 22, "gray35": 22, "gray36": 22, "gray37": 22, "gray38": 22, "gray39": 22, "gray4": 22, "gray40": 22, "gray41": 22, "gray42": 22, "gray43": 22, "gray44": 22, "gray45": 22, "gray46": 22, "gray47": 22, "gray48": 22, "gray49": 22, "gray5": 22, "gray50": 22, "gray51": 22, "gray52": 22, "gray53": 22, "gray54": 22, "gray55": 22, "gray56": 22, "gray57": 22, "gray58": 22, "gray59": 22, "gray6": 22, "gray60": 22, "gray61": 22, "gray62": 22, "gray63": 22, "gray64": 22, "gray65": 22, "gray66": 22, "gray67": 22, "gray68": 22, "gray69": 22, "gray7": 22, "gray70": 22, "gray71": 22, "gray72": 22, "gray73": 22, "gray74": 22, "gray75": 22, "gray76": 22, "gray77": 22, "gray78": 22, "gray79": 22, "gray8": 22, "gray80": 22, "gray81": 22, "gray82": 22, "gray83": 22, "gray84": 22, "gray85": 22, "gray86": 22, "gray87": 22, "gray88": 22, "gray89": 22, "gray9": 22, "gray90": 22, "gray91": 22, "gray92": 22, "gray93": 22, "gray94": 22, "gray95": 22, "gray96": 22, "gray97": 22, "gray98": 22, "gray99": 22, "grayscal": [21, 58, 72], "great": [24, 65, 66, 68, 71], "greater": [19, 25, 28, 29, 32, 34, 36, 37, 38, 41, 52, 60], "green": [1, 20, 21, 22, 24, 25, 42, 52, 53, 58, 59, 62, 65, 68, 73, 78], "green1": 22, "green2": 22, "green3": 22, "green4": 22, "greenyellow": 22, "grei": 22, "grey0": 22, "grey1": 22, "grey10": 22, "grey100": 22, "grey11": 22, "grey12": 22, "grey13": 22, "grey14": 22, "grey15": 22, "grey16": 22, "grey17": 22, "grey18": 22, "grey19": 22, "grey2": 22, "grey20": 22, "grey21": 22, "grey22": 22, "grey23": 22, "grey24": 22, "grey25": 22, "grey26": 22, "grey27": 22, "grey28": 22, "grey29": 22, "grey3": 22, "grey30": 22, "grey31": 22, "grey32": 22, "grey33": 22, "grey34": 22, "grey35": 22, "grey36": 22, "grey37": 22, "grey38": 22, "grey39": 22, "grey4": 22, "grey40": 22, "grey41": 22, "grey42": 22, "grey43": 22, "grey44": 22, "grey45": 22, "grey46": 22, "grey47": 22, "grey48": 22, "grey49": 22, "grey5": 22, "grey50": 22, "grey51": 22, "grey52": 22, "grey53": 22, "grey54": 22, "grey55": 22, "grey56": 22, "grey57": 22, "grey58": 22, "grey59": 22, "grey6": 22, "grey60": 22, "grey61": 22, "grey62": 22, "grey63": 22, "grey64": 22, "grey65": 22, "grey66": 22, "grey67": 22, "grey68": 22, "grey69": 22, "grey7": 22, "grey70": 22, "grey71": 22, "grey72": 22, "grey73": 22, "grey74": 22, "grey75": 22, "grey76": 22, "grey77": 22, "grey78": 22, "grey79": 22, "grey8": 22, "grey80": 22, "grey81": 22, "grey82": 22, "grey83": 22, "grey84": 22, "grey85": 22, "grey86": 22, "grey87": 22, "grey88": 22, "grey89": 22, "grey9": 22, "grey90": 22, "grey91": 22, "grey92": 22, "grey93": 22, "grey94": 22, "grey95": 22, "grey96": 22, "grey97": 22, "grey98": 22, "grey99": 22, "gri": 78, "grid": 29, "ground": 70, "group": [27, 36, 51, 61, 62, 66, 71, 74, 77, 78], "group1": [51, 67], "group2": [51, 67], "group_list": 51, "groupcollid": [51, 67, 75], "groupmulti": 67, "groupsingl": [51, 67], "grow": [25, 28, 45, 71], "grupo": 78, "gr\u00e1fica": 78, "gr\u00e1fico": 78, "guarante": [20, 24, 26, 34, 39, 55], "guardar": 78, "guess": [39, 71], "gui": [24, 66], "guid": [17, 33, 65, 68, 73], "gui\u00f3n": 78, "h": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 21, 24, 26, 27, 31, 34, 42, 43, 45, 48, 52, 59], "ha": [1, 2, 11, 17, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 58, 60, 62, 63, 64, 65, 66, 67, 68, 70, 71, 72, 74, 75, 77, 78], "haber": 78, "habit": [71, 75], "hace": 78, "hacen": 78, "hacer": 78, "hacerla": 78, "hacia": 78, "haciendo": 78, "had": [25, 52, 66, 67, 71], "hadn": 71, "haga": 78, "hai": 78, "half": [25, 27, 45, 51, 54, 66, 71], "hand": [21, 23, 42, 43, 62, 64, 70, 71, 75], "handi": [27, 69, 71, 74, 75, 76, 77], "handili": 77, "handl": [3, 10, 16, 17, 24, 26, 29, 32, 33, 34, 39, 43, 44, 51, 58, 60, 61, 63, 66, 67, 68, 69, 71, 75, 77], "handle_flag": 3, "handler": [26, 34, 40], "hang": 33, "happen": [25, 37, 62, 64, 66, 67, 70, 71, 72, 73, 76, 77], "hard": [66, 68, 70], "hardcod": 27, "harder": [68, 69, 71], "hardest": 67, "hardwar": [23, 24, 25, 31, 33, 38, 39, 48, 52, 54, 60, 66, 67, 68, 71], "haremo": 78, "harfbuzz": 28, "harmless": 24, "har\u00e1": 78, "has_batteri": 54, "has_text": 46, "hasattr": 28, "hash": 34, "hashabl": 45, "hasn": 29, "hasta": 78, "hat": [26, 33, 47], "hat_numb": 33, "have": [1, 3, 9, 11, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 36, 37, 39, 41, 42, 43, 44, 45, 47, 48, 50, 51, 52, 53, 54, 55, 56, 58, 60, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77], "haven": 71, "haya": 78, "he": [62, 71, 73], "header": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15], "headless": 27, "headless_no_windows_need": 27, "heavili": 26, "height": [1, 9, 20, 23, 24, 25, 27, 28, 29, 30, 32, 33, 36, 42, 45, 48, 51, 52, 58, 60, 63, 66, 70, 71], "held": [5, 34, 70, 76], "hello": 73, "help": [17, 23, 26, 27, 28, 34, 37, 38, 39, 40, 48, 51, 52, 54, 55, 56, 62, 63, 67, 68, 69, 71, 74, 75, 76], "helper": 66, "henc": 29, "here": [17, 18, 20, 24, 26, 27, 28, 29, 35, 36, 40, 41, 44, 50, 51, 52, 54, 60, 61, 62, 63, 64, 67, 68, 71, 72, 73, 74, 75, 76, 77], "hex": 21, "hexadecim": 21, "hflip": [20, 65], "hi": [62, 70], "hicimo": 78, "hidden": [24, 26, 40, 60], "hide": [34, 40, 44, 60, 62], "high": [0, 24, 27, 51, 52, 60], "high_frequ": [33, 47], "higher": [17, 18, 24, 37, 38, 53, 63, 66, 67], "highest": 44, "highgui": 44, "highli": [52, 54, 71], "him": [62, 70], "hindi": 28, "hint": [24, 44, 71], "hit": [24, 26, 27, 62, 69, 71, 73, 75, 76], "hitbox": [61, 62, 78], "hkey_local_machin": 38, "hline": 31, "hmm": 70, "hold": [1, 5, 26, 28, 33, 34, 51, 58, 67, 68], "holdov": 67, "hollow": 28, "home": [33, 34, 54], "honeydew": 22, "honeydew1": 22, "honeydew2": 22, "honeydew3": 22, "honeydew4": 22, "hook": 51, "hope": 67, "hopefulli": [68, 70, 75], "hora": 78, "horizont": [20, 25, 27, 29, 30, 31, 32, 40, 48, 58, 62, 68, 70, 78], "horizontal_advance_i": 29, "horizontal_advance_x": 29, "host": [39, 54], "hotpink": 22, "hotpink1": 22, "hotpink2": 22, "hotpink3": 22, "hotpink4": 22, "hotplug": 33, "hotspot": [23, 40], "hour": 71, "how": [16, 17, 21, 24, 25, 27, 28, 29, 30, 32, 33, 34, 36, 37, 39, 41, 44, 45, 46, 50, 51, 52, 56, 58, 62, 66, 67, 68, 69, 71, 75, 76, 77], "howev": [13, 20, 26, 29, 32, 35, 37, 41, 42, 44, 45, 47, 51, 54, 56, 70, 71], "hsl": [21, 58], "hsla": 21, "hsv": [20, 21, 65], "hsva": 21, "html": 21, "http": [24, 25, 40, 48, 74, 77], "hue": [20, 58], "human": [66, 74], "humung": 66, "hundr": 66, "husano896": 40, "hw": [24, 63], "hwaccel": 52, "hwsurfac": [24, 52, 68, 71], "hx": 47, "i": [1, 2, 3, 4, 5, 6, 8, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 73, 74, 75, 76, 77, 78], "i1": 21, "i1i2i3": 21, "i2": 21, "i3": 21, "i_max": 37, "i_min": 37, "icc": 26, "iceberg": 67, "icon": [24, 60], "iconifi": 24, "icontitl": 24, "id": [7, 24, 26, 33, 34, 38, 39, 57, 60], "id3": 41, "idea": [24, 52, 63, 65, 66, 68, 69, 74, 75], "ident": [26, 42, 45, 52], "identif": 38, "identifi": [26, 28, 33, 34, 44, 46, 65, 71], "idiom": [62, 71], "idioma": 78, "idl": [25, 26, 33, 39, 41], "idx": 51, "ie": [32, 68], "ignor": [24, 26, 29, 33, 36, 38, 39, 41, 44, 47, 52, 54, 55, 71], "igual": 78, "illeg": 45, "illus": 70, "illustr": [68, 70, 75], "im": [26, 34], "imag": [12, 13, 17, 18, 20, 23, 24, 27, 28, 29, 46, 48, 51, 53, 58, 61, 62, 63, 66, 67, 68, 69, 71, 72, 73, 74, 75, 76, 77, 78], "image_fil": 27, "imagefil": 27, "imagen": 78, "imagin": [70, 73, 77], "imgsurfac": 68, "imita": 78, "immedi": [24, 26, 33, 38, 39, 48, 62], "immut": 21, "impact": [39, 72], "implement": [10, 11, 13, 19, 20, 21, 24, 26, 27, 29, 34, 38, 39, 42, 43, 44, 51, 52, 59, 66, 67, 69, 71, 77], "impli": [20, 29, 72], "implicitli": [24, 52], "import": [1, 11, 17, 20, 23, 25, 26, 27, 28, 29, 31, 33, 35, 37, 39, 40, 44, 49, 50, 53, 54, 55, 60, 61, 63, 66, 67, 69, 70, 71, 72, 73, 74, 77, 78], "import_pygame_bas": [1, 11], "importa": 78, "importado": 78, "importamo": 78, "importantli": 70, "importerror": [68, 74, 77], "import\u00f3": 78, "impos": [34, 39], "imposs": 40, "imprecis": 71, "impress": 66, "improv": [25, 28, 41, 58, 62, 71], "im\u00e1gen": 78, "inact": [29, 39], "inch": 29, "incident": 20, "inclin": 37, "includ": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 17, 20, 23, 24, 27, 28, 29, 30, 31, 32, 33, 35, 38, 39, 44, 45, 51, 52, 55, 56, 59, 62, 66, 67, 68, 69, 71, 74, 75], "incluida": 78, "inclus": [1, 3, 21, 26, 28, 29, 39], "incluso": 78, "incluyen": 17, "incom": 17, "incomplet": 55, "incorrect": [42, 43], "incorrectli": 37, "increas": [24, 26, 29, 39, 45, 51, 58, 71], "incredibli": 71, "incref": 5, "increment": [11, 58, 68], "inde": 3, "indefinit": [39, 41], "indent": [33, 69], "indentation_level": 33, "independ": [17, 32, 48, 62, 72, 74], "independient": 78, "index": [1, 6, 7, 17, 20, 24, 29, 30, 33, 34, 42, 43, 44, 45, 47, 48, 49, 51, 52, 53, 57, 58, 68, 70, 71], "indexerror": [31, 36, 38, 52], "indexexcept": 19, "indexoutofbound": 51, "indianr": 22, "indianred1": 22, "indianred2": 22, "indianred3": 22, "indianred4": 22, "indic": [12, 24, 25, 26, 30, 31, 34, 36, 38, 40, 41, 42, 45, 46, 49, 51, 53, 54, 55, 68, 72], "indica": 78, "indicado": 78, "indicarl": 78, "indicar\u00eda": 78, "indices0": 45, "indices1": 45, "indices2": 45, "indices3": 45, "indices4": 45, "indices5": 45, "indigo": 22, "indirect": 20, "individu": [17, 26, 29, 36, 44, 52, 55, 62, 71], "individualment": 78, "ineffici": 62, "ineficient": 78, "inequ": 26, "infer": 32, "infinit": [30, 52, 62, 66], "infinito": 78, "inflat": [29, 45, 61, 62, 71, 77, 78], "inflate_ip": 45, "influenc": [24, 72], "info": [4, 24, 38, 48, 63, 74], "inform": [14, 17, 19, 20, 21, 24, 26, 28, 33, 34, 37, 38, 39, 40, 41, 46, 47, 48, 52, 53, 54, 55, 57, 63, 67, 68, 70, 72], "informaci\u00f3n": 78, "inherit": [37, 51, 52, 67, 74, 75], "inicia": 78, "iniciada": 78, "inicializado": 78, "iniciar": 78, "init": [1, 17, 20, 23, 24, 25, 28, 29, 33, 38, 39, 40, 44, 46, 47, 48, 55, 56, 61, 62, 63, 66, 70, 71, 72, 73, 77, 78], "initi": [17, 20, 24, 25, 26, 28, 29, 33, 34, 35, 38, 39, 40, 44, 46, 47, 48, 49, 51, 52, 56, 60, 61, 63, 65, 66, 67, 71, 75, 78], "initialis": [24, 33, 44, 47, 69, 73, 76, 77], "inmediatament": 78, "input": [3, 17, 20, 24, 26, 27, 28, 32, 33, 34, 37, 40, 44, 45, 46, 47, 48, 52, 55, 58, 60, 61, 65, 66, 69, 71, 75], "input_focu": 60, "input_grab": 60, "input_onli": 60, "inputimag": 27, "insensit": [43, 52], "insert": [26, 34], "insid": [23, 25, 27, 30, 32, 44, 45, 48, 51, 52, 62, 65, 66, 68, 77], "insight": 71, "inspir": 17, "inspirado": 17, "instal": [17, 20, 27, 28, 32, 62, 68], "instalado": 78, "instanc": [2, 3, 4, 5, 6, 7, 8, 9, 12, 15, 19, 26, 27, 29, 30, 31, 33, 36, 37, 39, 42, 45, 51, 52, 60, 62, 67, 69, 73, 75, 76], "instance_id": [7, 26, 33], "instancia": 78, "instanti": 26, "instantli": 71, "instead": [1, 3, 9, 16, 21, 23, 24, 26, 27, 28, 29, 33, 34, 37, 39, 40, 41, 42, 44, 45, 51, 52, 54, 55, 58, 60, 67, 68, 70, 71, 72, 75], "instruccion": 78, "instruct": [54, 58], "instrument": 38, "instrument_id": 38, "int": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 19, 20, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 42, 44, 45, 47, 48, 51, 52, 54, 56, 57, 58, 59, 60], "int32": 68, "int8": 68, "integ": [1, 3, 9, 14, 19, 21, 24, 26, 27, 28, 29, 31, 32, 33, 34, 38, 39, 40, 41, 42, 43, 44, 45, 47, 49, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 68], "integr": 20, "intend": [39, 43, 48, 51, 52], "intent": 78, "intenta": 78, "interact": [5, 7, 17, 24, 27, 34, 35, 42, 47, 51, 55, 66, 68, 70, 75], "interactivo": 17, "interchang": 45, "interest": [26, 46, 66, 71], "interf": 38, "interfac": [1, 19, 21, 29, 34, 38, 39, 42, 43, 47, 52, 65, 66], "interior": 58, "intern": [0, 24, 25, 26, 34, 39, 40, 41, 44, 46, 48, 52, 58, 60, 62, 71, 77], "interna": 78, "internet": 71, "interp": 37, "interpol": [21, 31, 37], "interpret": [3, 16, 21, 27, 29, 44, 69, 71], "interrupt": 20, "intersect": [30, 36, 45, 51, 67], "interv": [34, 37], "intial": 78, "intimid": 68, "intpoint": [23, 59], "intric": 66, "intro_bal": 66, "introduc": [24, 32, 37, 41, 43, 68, 69, 70, 75, 77], "introduct": [17, 64], "introspect": 43, "intuit": 71, "invalid": [1, 24, 28, 39, 45, 47, 58, 60], "invalu": 75, "invers": 37, "inverse_set": 58, "invert": [29, 36, 37, 42, 58], "invis": 73, "invlerp": 37, "invok": [19, 29, 76], "involv": [17, 27, 29, 52, 71, 75, 77], "inward": 25, "io": [59, 60], "ip": 45, "is_c": 44, "is_control": 47, "is_fullscreen": 24, "is_norm": 37, "is_vsync": 24, "iscaptur": 26, "ish": 25, "isn": [48, 54, 65, 67, 69, 70, 71, 76], "iso": [28, 54], "isol": [52, 65], "issu": [24, 44, 66, 70, 72], "ital": [28, 29], "item": [29, 31, 42, 43, 45, 51, 52, 67, 70], "items": 42, "iter": [24, 28, 29, 34, 37, 42, 45, 48, 51, 52, 67, 71, 73, 76, 77], "its": [2, 10, 13, 18, 19, 20, 21, 24, 25, 26, 29, 30, 31, 33, 36, 37, 38, 39, 42, 44, 45, 46, 48, 50, 51, 52, 62, 63, 66, 67, 69, 70, 71, 72, 73, 74, 75, 76, 77], "itself": [13, 20, 28, 29, 37, 42, 43, 44, 48, 52, 60, 62, 66, 67, 69, 70, 71, 75, 76, 77], "ivori": 22, "ivory1": 22, "ivory2": 22, "ivory3": 22, "ivory4": 22, "izquierda": 78, "j": [34, 36], "jaggi": 58, "jc": 18, "jid": 33, "jitter": 33, "job": 66, "joi": 26, "join": [32, 33, 45, 61, 62, 74, 77, 78], "joint": 25, "journal": 71, "joyaxismot": [26, 33], "joyballmot": [26, 33], "joybuttondown": [26, 33], "joybuttonup": [26, 33], "joydevicead": [26, 33], "joydeviceremov": [26, 33], "joyhatmot": [26, 33], "joystick": [0, 17, 26, 27, 44, 47, 66, 71, 73, 76], "joystick_count": 33, "jp": 20, "jpeg": [32, 71], "jpg": [32, 66], "jugador": 78, "juli": 18, "jumbl": 71, "jump": [40, 66, 68, 70, 72], "june": 18, "just": [5, 24, 25, 27, 28, 29, 31, 34, 36, 39, 40, 41, 51, 52, 53, 55, 58, 62, 63, 64, 65, 66, 67, 68, 71, 72, 73, 75, 76, 77], "k": [34, 37], "k_": [17, 34, 35], "k_0": 34, "k_1": 34, "k_2": 34, "k_3": 34, "k_4": 34, "k_5": 34, "k_6": 34, "k_7": 34, "k_8": 34, "k_9": 34, "k_a": [17, 34, 77], "k_ac_back": 34, "k_ampersand": 34, "k_asterisk": 34, "k_at": 34, "k_b": 34, "k_backquot": 34, "k_backslash": 34, "k_backspac": 34, "k_break": 34, "k_c": 34, "k_capslock": 34, "k_caret": 34, "k_clear": 34, "k_colon": 34, "k_comma": 34, "k_d": [17, 34], "k_delet": 34, "k_dollar": 34, "k_down": [34, 70, 76, 77], "k_e": 34, "k_end": 34, "k_equal": 34, "k_escap": [23, 34, 61, 62, 65, 78], "k_euro": 34, "k_exclaim": 34, "k_f": [34, 71], "k_f1": 34, "k_f10": 34, "k_f11": 34, "k_f12": 34, "k_f13": 34, "k_f14": 34, "k_f15": 34, "k_f2": 34, "k_f3": 34, "k_f4": 34, "k_f5": 34, "k_f6": 34, "k_f7": 34, "k_f8": 34, "k_f9": 34, "k_g": 34, "k_greater": 34, "k_h": 34, "k_hash": 34, "k_help": 34, "k_home": 34, "k_i": 34, "k_insert": 34, "k_j": 34, "k_k": 34, "k_kp0": 34, "k_kp1": 34, "k_kp2": 34, "k_kp3": 34, "k_kp4": 34, "k_kp5": 34, "k_kp6": 34, "k_kp7": 34, "k_kp8": 34, "k_kp9": 34, "k_kp_divid": 34, "k_kp_enter": 34, "k_kp_equal": 34, "k_kp_minu": 34, "k_kp_multipli": 34, "k_kp_period": 34, "k_kp_plu": 34, "k_l": 34, "k_lalt": 34, "k_lctrl": 34, "k_left": [34, 70], "k_leftbracket": 34, "k_leftparen": 34, "k_less": 34, "k_lmeta": 34, "k_lshift": 34, "k_lsuper": 34, "k_m": 34, "k_menu": 34, "k_minu": 34, "k_mode": 34, "k_n": 34, "k_numlock": 34, "k_o": 34, "k_p": 34, "k_pagedown": 34, "k_pageup": 34, "k_paus": 34, "k_period": 34, "k_plu": 34, "k_power": 34, "k_print": 34, "k_q": 34, "k_question": 34, "k_quot": 34, "k_quotedbl": 34, "k_r": 34, "k_ralt": 34, "k_rctrl": 34, "k_return": 34, "k_right": [34, 70], "k_rightbracket": 34, "k_rightparen": 34, "k_rmeta": 34, "k_rshift": 34, "k_rsuper": 34, "k_scrollock": 34, "k_semicolon": 34, "k_slash": 34, "k_space": 34, "k_sysreq": 34, "k_t": [34, 71], "k_tab": 34, "k_u": 34, "k_underscor": 34, "k_up": [34, 70, 76, 77], "k_v": 34, "k_w": [17, 34], "k_x": 34, "k_y": 34, "k_z": [34, 77], "kadir014": 18, "kanji": 29, "kar": 39, "kb": 18, "kde": 44, "keep": [13, 19, 24, 33, 51, 56, 58, 60, 62, 63, 64, 65, 66, 67, 69, 70, 71, 76], "keep_alpha": 58, "kei": [5, 17, 19, 21, 23, 24, 26, 27, 34, 35, 36, 41, 45, 52, 54, 57, 60, 61, 62, 65, 66, 67, 69, 70, 71, 76, 77, 78], "kept": 39, "kern": [28, 29], "kernel": 58, "key_cod": 34, "key_rect": 45, "keyboard": [17, 26, 27, 35, 40, 60, 66, 70, 71, 73], "keyboard_grab": 60, "keycod": 34, "keydown": [23, 26, 34, 35, 61, 62, 65, 70, 76, 77, 78], "keymap": 26, "keymapchang": 26, "keypad": 34, "keypress": 71, "keyup": [26, 34, 35, 76, 77], "keyword": [1, 17, 20, 25, 26, 27, 28, 29, 30, 32, 36, 39, 44, 45, 52, 55, 58], "khaki": 22, "khaki1": 22, "khaki2": 22, "khaki3": 22, "khaki4": 22, "khrono": 24, "khz": 49, "kick": 69, "kill": [51, 55, 67], "kind": [38, 43, 52, 68, 69, 71, 72], "kmod_alt": 34, "kmod_cap": 34, "kmod_ctrl": 34, "kmod_lalt": 34, "kmod_lctrl": 34, "kmod_lmeta": 34, "kmod_lshift": 34, "kmod_meta": 34, "kmod_mod": 34, "kmod_non": 34, "kmod_num": 34, "kmod_ralt": 34, "kmod_rctrl": 34, "kmod_rmeta": 34, "kmod_rshift": 34, "kmod_shift": 34, "know": [20, 28, 32, 34, 46, 50, 62, 65, 67, 68, 70, 72, 75, 76, 77], "knowledg": 71, "known": [34, 52, 60], "kwarg": [36, 45, 48, 51, 52], "kwd": 55, "kwname": 1, "l": [20, 21, 33, 34], "la": 17, "lack": 24, "lado": 78, "laggi": 39, "laid": [29, 69], "lambda": 45, "landscap": [70, 71], "languag": [26, 27, 28, 34, 54, 66, 70, 71], "lantinga": 66, "laplacian": 58, "larg": [17, 29, 37, 43, 45, 48, 52, 58, 67, 68, 69, 71, 72, 75], "larger": [24, 39, 52, 58, 62, 68, 71], "largest": [36, 63, 65, 66, 68], "last": [17, 25, 29, 31, 33, 34, 40, 51, 52, 53, 56, 60, 62, 66, 67, 68, 70, 71], "lastli": [23, 51, 62, 63, 67, 68, 70], "lasx": 54, "late": 71, "latenc": [38, 39, 71], "later": [20, 31, 34, 38, 39, 42, 44, 46, 51, 62, 63, 64, 65, 66, 67, 68, 70, 71, 74, 77], "latest": 29, "latin1": [28, 29], "latter": 26, "lavend": 22, "lavenderblush": 22, "lavenderblush1": 22, "lavenderblush2": 22, "lavenderblush3": 22, "lavenderblush4": 22, "lawngreen": 22, "lawrenc": 72, "layer": [18, 51, 66, 67, 72], "layer1": 51, "layer1_nr": 51, "layer2": 51, "layer2_nr": 51, "layer_nr": 51, "layereddirti": 51, "layeredupd": 51, "layout": [19, 26, 28, 29, 42, 43, 53, 58, 76], "lazi": 72, "lazili": [49, 53], "lbm": 32, "le": 78, "lead": [37, 39], "leak": 70, "learn": [27, 52, 63, 66, 68, 70, 71, 72], "learnt": 77, "least": [14, 25, 31, 36, 43, 52, 57, 68, 69, 71], "leav": [25, 29, 52, 54, 68], "led": [33, 47], "left": [21, 24, 25, 26, 28, 29, 30, 34, 36, 39, 40, 44, 45, 47, 51, 52, 54, 61, 62, 65, 66, 70, 71, 73, 74, 75, 76, 77, 78], "left_top": 52, "leftclick": 27, "leftmost": 47, "legaci": [26, 34, 46], "legacy_logo": 18, "lejo": 78, "lemonchiffon": 22, "lemonchiffon1": 22, "lemonchiffon2": 22, "lemonchiffon3": 22, "lemonchiffon4": 22, "len": [19, 21, 23, 25, 31, 51, 67, 68], "lend": 48, "length": [1, 3, 5, 9, 19, 21, 24, 26, 28, 30, 31, 33, 34, 37, 39, 40, 42, 47, 50, 52, 62, 75], "length_squar": 37, "lerp": [21, 37], "less": [24, 25, 28, 34, 36, 38, 39, 56, 57, 58, 60, 72, 73], "lesson": 71, "let": [10, 21, 22, 27, 44, 52, 62, 63, 66, 68, 69, 71, 76], "letter": [21, 28, 52, 54], "level": [0, 17, 19, 21, 24, 28, 33, 38, 39, 41, 52, 55, 58, 66, 67, 68], "lgpl": 17, "li": 71, "liabil": 20, "liabl": 20, "lib": 27, "librari": [17, 20, 24, 27, 28, 29, 31, 32, 33, 38, 39, 44, 54, 63, 66, 70], "libsdl": [40, 48], "licens": [17, 74, 77], "lie": [31, 45], "life": [54, 63, 65], "lifetim": [42, 53, 68], "ligerament": 78, "light": [28, 29, 58, 72], "lightblu": 22, "lightblue1": 22, "lightblue2": 22, "lightblue3": 22, "lightblue4": 22, "lightcor": 22, "lightcyan": 22, "lightcyan1": 22, "lightcyan2": 22, "lightcyan3": 22, "lightcyan4": 22, "lighter": 50, "lightgoldenrod": 22, "lightgoldenrod1": 22, "lightgoldenrod2": 22, "lightgoldenrod3": 22, "lightgoldenrod4": 22, "lightgoldenrodyellow": 22, "lightgrai": 22, "lightgreen": 22, "lightgrei": 22, "lightobliqu": [28, 29], "lightpink": 22, "lightpink1": 22, "lightpink2": 22, "lightpink3": 22, "lightpink4": 22, "lightsalmon": 22, "lightsalmon1": 22, "lightsalmon2": 22, "lightsalmon3": 22, "lightsalmon4": 22, "lightseagreen": 22, "lightskyblu": 22, "lightskyblue1": 22, "lightskyblue2": 22, "lightskyblue3": 22, "lightskyblue4": 22, "lightslateblu": 22, "lightslategrai": 22, "lightslategrei": 22, "lightsteelblu": 22, "lightsteelblue1": 22, "lightsteelblue2": 22, "lightsteelblue3": 22, "lightsteelblue4": 22, "lightweight": [51, 71], "lightyellow": 22, "lightyellow1": 22, "lightyellow2": 22, "lightyellow3": 22, "lightyellow4": 22, "like": [1, 3, 5, 10, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 32, 33, 34, 35, 36, 37, 39, 40, 41, 42, 44, 45, 47, 48, 50, 51, 52, 54, 58, 59, 60, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78], "lime": 22, "limegreen": 22, "limit": [17, 20, 24, 25, 26, 29, 32, 33, 37, 39, 41, 52, 53, 55, 56, 64, 66, 67, 68], "limpiar": 78, "limpieza": 78, "lindo": 78, "line": [17, 25, 27, 28, 31, 32, 33, 45, 48, 55, 61, 64, 66, 67, 68, 69, 70, 71, 75, 77], "line_spac": 29, "linear": [21, 24, 37, 48, 51, 68], "linearli": [37, 52], "linen": 22, "lines": 28, "link": [24, 28, 29, 32, 39, 44], "linux": [20, 24, 38, 41, 44, 48, 54, 60, 65, 66, 71], "liquid": [27, 70], "list": [17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 41, 44, 45, 46, 51, 52, 54, 55, 62, 63, 67, 68, 71], "list_camera": [20, 65], "list_mod": [24, 63], "list_of_double_tupl": 45, "list_of_list": 45, "list_of_object_with_callable_rect": 45, "list_of_object_with_rect_attribut": 45, "list_of_rect": 45, "list_of_tupl": 45, "lista": 78, "listen": 40, "liter": [23, 58], "littl": [19, 23, 27, 44, 56, 62, 63, 67, 68, 69, 70, 71, 72, 75, 76], "live": [17, 27, 68], "ll": [23, 37, 62, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77], "llama": 78, "llamada": 78, "llamado": 78, "llamamo": 78, "llamanda": 78, "llamar": 78, "lmb": 40, "lo": 17, "load": [8, 17, 20, 23, 27, 31, 32, 41, 49, 50, 51, 53, 61, 63, 66, 68, 69, 70, 71, 75, 77, 78], "load_anim": 32, "load_background_imag": 70, "load_bas": 32, "load_extend": 32, "load_imag": [61, 62, 78], "load_player_imag": 70, "load_png": [74, 75, 76, 77], "load_sized_svg": 32, "load_sound": [61, 62, 74, 78], "load_xbm": 23, "local": [9, 17, 34, 35, 39, 40, 44, 54, 62, 64, 65, 69, 73, 74, 77, 78], "localechang": [26, 54], "localizar": 78, "locat": [27, 35, 36, 40, 50, 52, 62, 71], "lock": [13, 19, 25, 26, 34, 42, 43, 48, 51, 52, 53], "lockabl": 48, "lockobj": 13, "lofi": 18, "logger": 27, "logic": [48, 62, 66, 68, 69, 71, 74], "logica": 78, "logical_s": 48, "logo": [17, 24], "loki": 66, "long": [6, 26, 29, 36, 37, 39, 41, 44, 51, 52, 55, 66, 67, 71, 72, 76], "longer": [24, 26, 28, 33, 39, 47, 52, 71, 75, 76], "longest": [39, 71], "look": [23, 25, 28, 37, 38, 44, 46, 52, 53, 54, 58, 62, 65, 66, 67, 68, 70, 71, 72, 73, 74, 75, 76, 77], "lookout": 27, "lookup": [24, 51, 62, 68], "loop": [17, 25, 33, 39, 41, 54, 56, 61, 65, 66, 67, 69, 70, 71, 74, 75, 76, 77], "lose": [24, 34, 54, 58, 72], "loss": [20, 24, 62, 63, 71], "lost": [26, 39, 41, 46, 70], "lostsprit": 67, "lot": [27, 33, 52, 56, 58, 59, 62, 63, 66, 67, 68, 69, 70, 71, 72, 73, 75, 77], "loud": 39, "love": 71, "low": [26, 33, 66], "low_frequ": [33, 47], "lower": [24, 26, 33, 37, 38, 39, 48, 53, 71], "lowercas": [21, 28], "lowest": 38, "lowli": 71, "lsx": 54, "lt": 33, "luck": 68, "luckili": 71, "luego": 78, "lugar": 78, "luma": 20, "luminos": [21, 58], "l\u00ednea": 17, "m": [21, 27, 33, 34, 38, 40, 47, 55, 62, 68, 78], "mac": [20, 24, 27, 38, 41, 44, 66, 71], "machin": [27, 58, 67, 68], "maco": [23, 48, 54, 60], "macro": [3, 4, 5, 6, 8, 9, 12, 14, 15], "made": [5, 6, 12, 15, 17, 24, 26, 49, 56, 70, 71, 75], "magazin": 17, "magenta": 22, "magenta1": 22, "magenta2": 22, "magenta3": 22, "magenta4": 22, "magic": [70, 71, 75], "magnifi": 27, "magnitud": 37, "magnitude_squar": 37, "mai": [1, 2, 20, 21, 23, 24, 26, 28, 29, 30, 31, 32, 33, 34, 38, 39, 40, 41, 43, 44, 45, 46, 48, 50, 52, 54, 55, 58, 60, 63, 65, 66, 67, 68, 70, 71, 72], "mail": [70, 71], "main": [20, 26, 27, 33, 40, 46, 48, 51, 55, 60, 61, 65, 67, 68, 69, 70, 72, 73, 74, 75, 76, 77], "main_dir": [61, 62, 78], "mainli": [28, 52, 67, 68, 70], "maintain": [28, 44, 56, 69, 70, 71], "major": [14, 24, 28, 32, 39, 44, 66], "make": [0, 17, 21, 23, 25, 26, 27, 30, 32, 39, 42, 44, 45, 52, 53, 56, 58, 62, 63, 64, 65, 66, 67, 68, 71, 72, 73, 74, 75, 76, 77], "make_sound": [39, 49], "make_surfac": [42, 43, 53], "malform": 29, "manag": [17, 26, 33, 39, 42, 48, 51, 52, 60, 63, 66, 67], "maneja": 78, "manejo": 78, "manera": 78, "mani": [24, 25, 26, 28, 29, 30, 32, 34, 39, 40, 41, 44, 45, 50, 51, 52, 56, 58, 62, 63, 66, 70, 71], "manifest": 71, "manipul": [17, 32, 42, 45, 48, 50, 52, 60, 66, 68, 71, 75], "manner": [63, 75], "manten": 78, "mantien": 78, "manual": [24, 28, 29, 33, 44, 52, 60, 65, 72], "manylinux": 24, "map": [3, 19, 21, 34, 42, 43, 47, 52, 53, 59, 63, 68], "map_arrai": [43, 53], "map_rgb": [21, 42, 52, 53], "mapped_int": 52, "marcha": 78, "mareado": 78, "mareo": 78, "margin": [27, 37], "mario": 76, "mark": [34, 42, 48, 65, 66], "maroon": 22, "maroon1": 22, "maroon2": 22, "maroon3": 22, "maroon4": 22, "mask": [23, 24, 27, 29, 42, 50, 51, 52, 63, 71], "maskfil": 23, "mass": 36, "master": [17, 68], "match": [19, 24, 28, 29, 30, 32, 33, 34, 38, 39, 42, 43, 50, 52, 53, 58, 62, 63, 67, 68, 70], "match_font": 28, "materi": [20, 71], "math": [25, 31, 36, 37, 74, 75, 77], "mathemat": [52, 68, 69, 72], "matter": [32, 52, 67, 70, 71, 75], "max": [25, 33, 36, 37, 65], "max_i": 29, "max_length": 37, "max_texture_height": 48, "max_texture_width": 48, "max_x": 29, "maxi": 28, "maxim": [24, 26, 50, 60], "maximum": [24, 28, 29, 50, 60], "maximum_s": 60, "maxtim": 39, "maxx": 28, "mayb": [67, 70, 71, 74], "mb": 18, "me": [63, 66, 68, 71], "mean": [17, 21, 23, 24, 25, 29, 32, 33, 34, 37, 38, 39, 40, 41, 43, 47, 48, 50, 51, 52, 58, 60, 62, 63, 65, 66, 67, 70, 71, 72, 76], "meant": [44, 48, 67], "measur": [25, 38, 71, 75], "medida": 78, "mediev": 66, "medium": [25, 28, 29, 33], "mediumaquamarin": 22, "mediumblu": 22, "mediumobliqu": [28, 29], "mediumorchid": 22, "mediumorchid1": 22, "mediumorchid2": 22, "mediumorchid3": 22, "mediumorchid4": 22, "mediumpurpl": 22, "mediumpurple1": 22, "mediumpurple2": 22, "mediumpurple3": 22, "mediumpurple4": 22, "mediumseagreen": 22, "mediumslateblu": 22, "mediumspringgreen": 22, "mediumturquois": 22, "mediumvioletr": 22, "meet": [45, 71], "mega": 18, "megabyt": 24, "mejorar": 78, "member": [26, 51, 63, 67, 71], "membership": [51, 67], "memori": [10, 19, 24, 25, 26, 29, 32, 39, 48, 52, 53, 56, 60, 70], "memoryview": 32, "menci\u00f3n": 78, "meno": 78, "mensaj": 78, "mention": [56, 62, 67, 70, 71], "menu": [24, 34, 69], "merchant": 20, "mercuri": 44, "mere": [38, 71], "merrili": 77, "mess": 17, "messag": [24, 26, 38, 44, 55, 62, 71], "message_box": 24, "message_typ": 24, "messi": 72, "messier": 71, "met": [20, 23], "meta": [34, 60], "metadata": 41, "metal": 48, "method": [9, 10, 12, 16, 17, 19, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 36, 37, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 56, 59, 60, 62, 63, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 77], "metric": [28, 29], "mff": 25, "mib": 54, "mice": 40, "micro": 44, "microsoft": 24, "mid": 39, "midbottom": 45, "middl": [37, 40, 47, 65, 68, 70], "midi": [26, 27, 39], "midi_ev": 38, "midi_event_list": 38, "midi_not": 38, "midi_output": 38, "midi_to_ansi_not": 38, "midi_to_frequ": 38, "midiexcept": 38, "midiin": [26, 38], "midiout": [26, 38], "midis2ev": 38, "midisport": 38, "midleft": [45, 76, 77], "midnightblu": 22, "midright": [45, 76, 77], "midtop": 45, "might": [17, 21, 24, 26, 27, 29, 30, 37, 40, 44, 46, 48, 54, 64, 67, 68, 69, 70, 71, 72, 74, 75, 77], "mighti": 70, "migrationguid": 40, "milli": 56, "millisecond": [26, 32, 34, 38, 39, 41, 51, 56, 66], "mime": 46, "mimic": 29, "mimiz": 60, "min": [25, 37, 65], "min_alpha": 52, "min_i": 29, "min_length": 37, "min_x": 29, "mind": [40, 56, 64, 68, 71], "mini": 28, "miniatur": 33, "minim": [24, 26, 50, 60], "minimum": [24, 25, 28, 31, 32, 36, 50, 52, 60], "minimum_s": 60, "minor": [14, 28, 32, 39, 44, 66], "mintcream": 22, "minu": 34, "minut": 17, "minx": 28, "mirror": [24, 62], "misma": 78, "mismo": 78, "miss": [33, 39, 61, 62, 71, 78], "missingmodul": [49, 53], "mistakenli": 26, "mistyros": 22, "mistyrose1": 22, "mistyrose2": 22, "mistyrose3": 22, "mistyrose4": 22, "misunderstand": 71, "misunderstood": 71, "miter": 25, "mix": [28, 39, 52, 66, 68], "mix_chunk": 8, "mix_getsoundfont": 39, "mix_setmusicposit": 41, "mix_setsoundfont": 39, "mixer": [0, 17, 27, 39, 44, 49, 61, 62, 78], "mizuno": 20, "mmsystem": 38, "mmx": [54, 58], "moccasin": 22, "mod": [26, 34, 35, 39, 41], "mod_": 35, "modal": 60, "mode": [17, 21, 24, 27, 28, 29, 31, 34, 39, 40, 44, 46, 48, 50, 51, 52, 55, 60, 62, 66, 68, 71, 72], "mode_ok": [24, 63], "model": 48, "modelo": 78, "modern": [24, 52, 71], "modest": 71, "modif": [20, 26, 48, 52, 56, 74], "modifi": [29, 30, 31, 34, 35, 38, 40, 45, 48, 49, 51, 52, 58, 67, 68, 73], "modnam": 1, "modo": 78, "modul": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 19, 22, 27, 35, 42, 48, 52, 55, 60, 61, 63, 64, 68, 69, 70, 71, 75, 77, 78], "modulu": 21, "molestarno": 78, "molesto": 17, "moment": [48, 49, 71, 75], "momento": 78, "momma": 70, "monitor": [24, 35, 40, 44, 63, 66], "monkei": [61, 62, 66, 78], "mono": [29, 39, 49, 78], "monochrom": 29, "month": 66, "monto": 78, "more": [17, 20, 21, 24, 25, 26, 27, 28, 29, 31, 32, 33, 36, 37, 38, 39, 40, 41, 42, 43, 44, 47, 48, 50, 51, 52, 54, 56, 62, 63, 64, 65, 66, 67, 69, 71, 72, 73, 74, 75, 76, 77], "most": [5, 17, 24, 25, 27, 28, 29, 32, 34, 39, 40, 41, 44, 45, 48, 51, 52, 54, 58, 59, 60, 63, 64, 65, 66, 67, 68, 69, 71, 72, 73], "mostrado": 78, "mostremo": 78, "motion": [33, 40, 66, 75, 77], "mous": [17, 23, 24, 26, 27, 33, 44, 46, 60, 61, 62, 66, 69, 70, 71, 73, 76, 78], "mouse_captur": 60, "mouse_focu": 60, "mouse_grab": 60, "mouse_rect": 60, "mousebuttondown": [23, 26, 40, 61, 62, 71, 78], "mousebuttonup": [26, 40, 61, 62, 71, 78], "mousemot": [26, 40], "mousewheel": [26, 40], "movabl": [70, 76, 77], "move": [17, 24, 26, 27, 30, 37, 40, 44, 45, 51, 52, 58, 61, 62, 66, 68, 69, 71, 73, 75, 76, 77, 78], "move_and_draw_all_game_object": 70, "move_ip": [30, 45, 61, 62, 78], "move_to": 45, "move_to_back": 51, "move_to_front": 51, "move_toward": 37, "move_towards_ip": 37, "movedown": [76, 77], "moveit": [27, 70], "movement": [33, 40, 51, 62, 75, 76], "movepo": [76, 77], "mover": 78, "movers": 78, "mover\u00e1": 78, "moveup": [76, 77], "movimiento": 78, "mozart": 41, "mp3": [39, 41], "msg": 38, "msmf": 20, "much": [20, 25, 27, 28, 32, 47, 54, 56, 62, 63, 64, 66, 68, 69, 70, 71, 72, 73, 75, 77], "mucha": 78, "mucho": 78, "muev": 78, "mueva": 78, "mui": 78, "multi_thread": 55, "multicolor": 27, "multidimension": 68, "multigestur": 26, "multilin": [28, 29], "multimedia": [34, 66, 71], "multipl": [1, 5, 6, 20, 23, 24, 25, 26, 27, 28, 33, 34, 37, 39, 40, 44, 45, 51, 52, 58, 60, 65, 66, 67, 68, 69, 72], "multipli": [21, 29, 34, 37, 42, 45, 48, 50, 52, 58, 68, 72], "multisampl": 24, "music": [8, 17, 27, 38, 39, 41, 66, 74], "must": [1, 2, 3, 19, 20, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 36, 37, 38, 39, 42, 43, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 55, 58, 62, 63, 64, 66, 67, 68, 71], "mustlock": 52, "mutabl": 26, "mute": 39, "my": [27, 54, 59, 66, 68, 69, 70, 71, 72, 74, 77], "my_appl": 44, "my_data_typ": 46, "my_rect": 45, "mygroup": 67, "mysprit": 67, "mysurf": 52, "m\u00e1": 78, "m\u00e9todo": 78, "n": [33, 34, 39, 68], "nada": 78, "name": [1, 10, 20, 21, 24, 26, 27, 28, 29, 30, 33, 34, 37, 38, 39, 44, 45, 47, 48, 51, 52, 54, 55, 59, 61, 62, 63, 66, 67, 68, 69, 70, 72, 74, 76, 77, 78], "name_forindex": 47, "name_of_environment_vari": 44, "namehint": [32, 41], "namespac": [35, 64], "nano": 32, "narg": 1, "nasti": 74, "nativ": [17, 20, 23, 24, 44, 65, 71], "natur": [41, 68, 71, 74], "navajowhit": 22, "navajowhite1": 22, "navajowhite2": 22, "navajowhite3": 22, "navajowhite4": 22, "navi": 22, "navyblu": 22, "ncesidad": 78, "ndarrai": 49, "ndigit": 37, "ndim": 42, "nearest": [39, 48, 53], "nearli": [37, 58, 67], "neat": 71, "neater": 76, "nebul": 71, "necesario": 78, "necesidad": 78, "necesita": 78, "necesitamo": 78, "necesitar": 78, "necessari": [10, 24, 26, 29, 39, 52, 54, 64, 69, 71, 73, 75, 76, 77], "necessarili": 66, "need": [5, 11, 17, 20, 21, 23, 24, 26, 27, 28, 32, 33, 34, 36, 39, 42, 44, 45, 46, 51, 52, 55, 60, 61, 62, 63, 64, 65, 66, 67, 68, 70, 72, 73, 74, 75, 76, 77], "needless": 71, "needn": [27, 69, 77], "neg": [9, 19, 24, 28, 29, 30, 36, 37, 39, 40, 41, 42, 45, 52, 58, 60, 68, 77], "neglig": 20, "negra": 78, "neither": 51, "neon": [54, 58], "nest": 52, "network": [69, 74], "never": [29, 33, 37, 39, 40, 41, 52, 54, 56, 65, 66, 68, 71], "new": [2, 3, 4, 5, 6, 7, 8, 9, 12, 14, 17, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 62, 63, 66, 67, 68, 69, 70, 71, 73, 74, 75, 77, 78], "new_height": 27, "new_lay": 51, "new_mask": 36, "new_surf": 58, "new_width": 27, "newarrai": 42, "newbi": 17, "newcom": 71, "newer": [24, 41], "newli": [21, 34, 36, 60], "newlin": 28, "newpo": [61, 62, 75, 76, 77, 78], "newrect": 67, "newtonian": 66, "next": [17, 20, 29, 31, 36, 37, 39, 46, 62, 67, 71, 73, 76, 77], "nice": [28, 32, 62, 68, 69, 70, 71, 72, 75], "ning\u00fan": 78, "nirav": 65, "no_batteri": 54, "node": 44, "noevent": [26, 39, 41, 71], "nofram": 24, "nois": [33, 36, 65], "nombr": 78, "nomin": 29, "non": [19, 24, 25, 27, 28, 29, 32, 34, 42, 44, 45, 46, 51, 52, 58, 62, 67, 71, 72, 74], "none": [19, 20, 21, 24, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 56, 57, 58, 60, 61, 62, 64, 68, 73, 74, 75, 77, 78], "nonesound": [61, 62, 78], "nonetheless": 27, "nonetyp": [31, 36, 51], "nonlinear": 52, "nonzero": [36, 45], "nor": 51, "normal": [9, 12, 21, 28, 29, 36, 37, 40, 44, 45, 51, 52, 55, 57, 62, 67, 68, 75, 77, 78], "normalize_ip": 37, "normalment": 78, "north": 23, "northeast": 23, "northwest": 23, "nos": 78, "nosotro": 78, "nosubprocess": 55, "notabl": [3, 24, 41, 48, 75], "notat": 40, "notdef": 29, "note": [20, 21, 24, 25, 26, 27, 29, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 47, 48, 52, 56, 58, 60, 61, 62, 63, 64, 65, 67, 70, 71, 74, 75, 77], "note1": 36, "note2": 36, "note_off": 38, "note_on": 38, "notes": 78, "noteworthi": 66, "noth": [24, 25, 31, 33, 47, 51, 62, 63, 66, 67, 71, 73, 74], "notic": [17, 20, 30, 37, 45, 70, 71, 72, 75, 76, 77], "notifi": 67, "notimplementederror": [32, 41], "nots": 78, "now": [21, 24, 25, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 43, 44, 45, 46, 52, 58, 60, 62, 65, 66, 67, 68, 69, 70, 71, 73, 75, 77], "nowadai": [52, 66, 71], "nrp": 65, "nuanc": 71, "nuestra": 78, "nuestro": 78, "nueva": 78, "nuevo": 78, "null": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 15, 16, 28], "num": 34, "num_button": 40, "num_devic": 38, "num_ev": 38, "num_fing": 26, "num_texture_format": 48, "number": [1, 5, 8, 11, 19, 20, 21, 24, 25, 26, 27, 28, 29, 31, 32, 33, 34, 36, 37, 38, 39, 41, 42, 44, 45, 47, 49, 51, 52, 53, 54, 55, 56, 57, 58, 59, 66, 67, 68, 70, 71, 72], "numer": 37, "numev": [26, 39], "numfail": 44, "numlock": 34, "numpass": 44, "numpi": [1, 17, 27, 32, 39, 42, 43, 49, 52, 53, 66], "n\u00famero": 78, "o": [6, 10, 20, 23, 24, 26, 27, 32, 33, 34, 38, 40, 44, 45, 54, 60, 61, 62, 70, 71, 74, 77, 78], "o_max": 37, "o_min": 37, "obj": [1, 2, 3, 4, 8, 9, 10, 44, 45], "obj_list": 45, "object": [1, 2, 3, 4, 5, 6, 7, 9, 10, 12, 13, 15, 17, 20, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 36, 39, 40, 41, 43, 44, 46, 47, 48, 49, 53, 54, 56, 57, 58, 59, 61, 63, 65, 66, 67, 68, 69, 70, 71, 74, 77, 78], "objectwithcallablerectattribut": 45, "objectwithrectattribut": 45, "objectwithsomrectattribut": 45, "objetivo": 78, "obliqu": [28, 29], "obrar\u00e1": 78, "obscur": [60, 69, 71], "obsolet": [24, 44, 52], "obtain": [29, 38, 52], "obtenemo": 78, "obviou": [69, 72], "obvious": 73, "occasion": 67, "occupi": [32, 73], "occur": [26, 29, 34, 38, 39, 42, 48, 70], "octob": 66, "odd": [25, 68, 77], "ofcod": 77, "oferta": 78, "off": [20, 25, 26, 27, 29, 33, 38, 39, 41, 45, 58, 62, 67, 69, 70, 71, 77], "offcourt": 77, "offer": [23, 24, 26, 47, 60, 65], "offici": [28, 70, 71], "offset": [19, 25, 27, 28, 29, 30, 31, 36, 38, 41, 42, 45, 51, 52, 62], "often": [32, 37, 48, 52, 66, 68, 69, 71, 74], "ogg": [39, 41], "oh": 77, "ok": [24, 68, 71, 73, 75], "old": [24, 40, 44, 51, 52, 56, 62, 67, 70, 71, 76], "old_outlin": 28, "older": [24, 32, 33, 41, 44, 54, 67, 71], "oldlac": 22, "oliv": 22, "olivedrab": 22, "olivedrab1": 22, "olivedrab2": 22, "olivedrab3": 22, "olivedrab4": 22, "omit": [21, 29, 38, 42, 55], "on_batteri": 54, "onc": [17, 20, 24, 26, 28, 29, 32, 33, 34, 36, 38, 39, 41, 42, 44, 47, 52, 54, 55, 56, 60, 62, 64, 66, 67, 68, 70, 71, 73, 74, 75, 77], "one": [19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 56, 58, 60, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77], "ones": [29, 41, 59, 64, 67, 75, 76], "onli": [5, 19, 20, 21, 24, 25, 26, 28, 29, 30, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 58, 59, 60, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 73, 74, 75, 77], "onlin": 71, "ons": 66, "onscreen": 24, "onto": [12, 21, 28, 29, 30, 31, 36, 37, 48, 50, 51, 52, 62, 66, 68, 70, 71, 73, 75], "opac": 60, "opaqu": [21, 27, 29, 36, 43, 50, 52, 53, 60, 68, 71, 72], "opcional": 78, "opcionalment": 78, "open": [1, 6, 10, 17, 20, 24, 33, 34, 38, 39, 44, 46, 47, 59, 62, 65, 66, 73, 74], "opencv": [20, 44, 65], "opengl": [24, 27, 48, 52, 60, 71], "opentyp": 29, "oper": [16, 21, 23, 24, 25, 26, 34, 37, 42, 44, 45, 48, 51, 52, 53, 56, 58, 60, 67, 68, 71, 72, 73], "operand": 68, "operativo": 78, "oppos": [21, 29], "opposit": 52, "optim": [3, 24, 27, 28, 48, 52, 67, 68, 71], "optimis": [58, 71], "option": [1, 5, 19, 20, 21, 24, 25, 27, 28, 29, 30, 31, 33, 36, 38, 39, 40, 41, 43, 44, 45, 48, 51, 52, 54, 55, 56, 58, 62, 64, 65, 68, 70], "opu": 39, "orang": 22, "orange1": 22, "orange2": 22, "orange3": 22, "orange4": 22, "orangered1": 22, "orangered2": 22, "orangered3": 22, "orangered4": 22, "orchid": 22, "orchid1": 22, "orchid2": 22, "orchid3": 22, "orchid4": 22, "orden": 78, "order": [1, 20, 24, 28, 29, 32, 34, 37, 38, 39, 40, 41, 42, 44, 51, 52, 53, 54, 55, 56, 62, 68, 70, 71, 77], "ordinari": 67, "org": [24, 40, 48, 54, 62, 63, 64, 66, 67, 68, 70, 74, 77, 78], "organ": [17, 51, 54, 67, 71], "organis": 69, "organiz": 71, "organiza": 78, "orient": [29, 36, 70], "origin": [18, 21, 23, 24, 25, 27, 29, 30, 32, 33, 34, 36, 39, 42, 45, 47, 48, 51, 52, 58, 60, 61, 62, 66, 67, 68, 70, 78], "original_sound": 39, "original_surf": 58, "orthogon": [30, 36], "oscuro": 78, "oss": 38, "osx": [24, 66], "other": [0, 17, 20, 21, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 39, 41, 42, 43, 44, 45, 46, 48, 49, 50, 51, 52, 53, 55, 56, 60, 62, 65, 66, 67, 69, 70, 71, 72, 73, 74, 75, 76, 77], "otherarrai": 42, "othermask": 36, "othersurfac": 36, "otherwis": [1, 2, 3, 5, 10, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 32, 36, 37, 38, 39, 40, 43, 44, 45, 46, 48, 51, 52, 53, 58, 60, 70, 77], "otro": 78, "our": [29, 61, 62, 66, 68, 70, 72, 73], "out": [17, 20, 25, 29, 30, 33, 36, 37, 38, 39, 41, 44, 52, 54, 62, 63, 65, 67, 68, 69, 70, 71, 73, 74, 75, 76, 77], "outgo": 38, "outlin": [25, 28, 29, 36, 48, 65], "outline_color": 28, "outline_width": 28, "outlined_text_surf": 28, "outpng": 27, "output": [20, 24, 27, 30, 36, 37, 58, 71, 76], "outputimag": 27, "outsid": [24, 25, 28, 31, 34, 36, 37, 40, 45, 52, 54, 58, 62, 66, 70], "over": [23, 24, 26, 29, 32, 34, 36, 37, 39, 41, 42, 44, 47, 51, 52, 58, 61, 64, 65, 66, 67, 68, 70, 71, 72, 74], "overal": 68, "overboard": 74, "overflow": 68, "overhead": [48, 52], "overlai": 67, "overlap": [30, 36, 45, 51, 52, 67, 70, 71, 75, 77], "overlap_area": 36, "overlap_mask": 36, "overlin": 29, "overrid": [20, 29, 36, 44, 51, 52, 66], "overridden": [24, 29, 36, 39, 45], "overshoot": 37, "overwrit": [19, 27, 33, 47, 50], "overwritten": [33, 47], "own": [13, 18, 23, 26, 27, 38, 39, 46, 50, 52, 63, 66, 68, 69, 71, 74], "own_data_typ": 46, "owner": 13, "ownership": 46, "p": [27, 32, 33, 34, 43, 70], "p1": 48, "p1_mod": 48, "p1_uv": 48, "p1_xy": 48, "p2": 48, "p2_mod": 48, "p2_uv": 48, "p2_xy": 48, "p3": 48, "p3_mod": 48, "p3_uv": 48, "p3_xy": 48, "p4": 48, "p4_mod": 48, "p4_uv": 48, "p4_xy": 48, "pac": 67, "pack": [24, 52, 53, 63], "packag": [17, 27, 28, 29, 31, 32, 49, 53, 62, 64, 66, 68], "pacman": 67, "pad": [29, 32, 33, 58], "page": [34, 40, 41, 46, 68, 71], "painless": 74, "paint": [51, 73], "pair": [24, 25, 26, 28, 29, 30, 32, 33, 45, 52, 66], "palegoldenrod": 22, "palegreen": 22, "palegreen1": 22, "palegreen2": 22, "palegreen3": 22, "palegreen4": 22, "palett": [24, 28, 32, 36, 52, 53, 58], "palette_color": [36, 58], "paleturquois": 22, "paleturquoise1": 22, "paleturquoise2": 22, "paleturquoise3": 22, "paleturquoise4": 22, "palevioletr": 22, "palevioletred1": 22, "palevioletred2": 22, "palevioletred3": 22, "palevioletred4": 22, "pantalla": 78, "papayawhip": 22, "paper": 71, "paquet": 78, "par": 78, "paradigm": 71, "param": 25, "paramet": [20, 21, 24, 25, 26, 27, 28, 29, 31, 32, 34, 36, 37, 38, 39, 40, 41, 44, 45, 46, 48, 52, 56, 57, 58, 60, 65], "parametr": 37, "parametro": 78, "parent": [2, 13, 19, 24, 51, 52, 60], "parent_window": 24, "parenthesi": 34, "pars": [71, 75], "part": [24, 25, 29, 31, 36, 52, 55, 58, 66, 67, 68, 70, 74, 78], "parti": [20, 66], "partial": [25, 26, 38, 52, 71], "particl": 50, "particular": [20, 29, 41, 42, 49, 55, 56, 63, 71], "particularli": 38, "pasando": 78, "pasar": 78, "paso": 78, "pass": [1, 3, 9, 10, 16, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 48, 50, 51, 52, 53, 55, 56, 58, 61, 62, 66, 67, 70, 71, 74, 78], "past": [37, 46, 62, 66, 71], "patch": [14, 27, 28, 32, 39, 44, 66], "patel": 65, "path": [6, 10, 17, 26, 27, 28, 29, 32, 37, 39, 44, 54, 55, 59, 61, 62, 65, 71, 72, 74, 77, 78], "pathlib": [28, 29, 32, 39, 59], "pathlib_path": 39, "pathnam": [39, 62, 74], "pattern": [25, 29, 41], "paus": [24, 27, 34, 39, 41, 56, 74], "pbm": 32, "pc": [19, 38], "pcf": 29, "pci": 68, "pcx": 32, "pdf": 25, "peachpuff": 22, "peachpuff1": 22, "peachpuff2": 22, "peachpuff3": 22, "peachpuff4": 22, "peek": 26, "pegamo": 78, "pegar": 78, "pellet": 67, "penalti": [52, 63, 67], "pend": [38, 40], "peopl": [17, 32, 62, 66, 69, 70], "pepca": 25, "peque\u00f1a": 78, "per": [17, 24, 25, 29, 31, 32, 33, 36, 44, 49, 50, 51, 52, 53, 54, 55, 56, 62, 63, 66, 68, 70, 71, 72, 76, 77], "perceiv": 21, "percent": 54, "percentag": 54, "perfect": 36, "perfecta": 78, "perform": [12, 24, 27, 28, 29, 31, 36, 37, 39, 42, 48, 50, 51, 52, 53, 58, 60, 63, 65, 67, 68, 71, 72, 73, 76], "perhap": [54, 67, 70, 71, 74], "period": [26, 34, 41, 71], "permiss": 24, "permit": [16, 20, 29, 78], "permitiendono": 78, "permonitor": 44, "permonitorv2": 44, "pero": 78, "person": [66, 70, 76], "persona": 78, "perspect": [27, 66], "pertenec": 78, "peru": 22, "pete": [62, 63, 64, 66, 67, 68, 70, 71, 78], "pfr": 29, "pg": 78, "pg_buffer": [1, 2], "pg_encodefilepath": 10, "pg_encodestr": 10, "pg_floatfromobj": 1, "pg_floatfromobjindex": 1, "pg_getdefaultwindow": 1, "pg_getdefaultwindowsurfac": 1, "pg_intfromobj": 1, "pg_intfromobjindex": 1, "pg_major_vers": 14, "pg_mappedcolorfromobj": 3, "pg_minor_vers": 14, "pg_mod_autoinit": 1, "pg_mod_autoquit": 1, "pg_patch_vers": 14, "pg_post_ev": 5, "pg_post_event_dictproxi": 5, "pg_registerquit": 1, "pg_rgbafromobj": [1, 3, 11], "pg_rgbafromobjex": [1, 3], "pg_setdefaultwindow": 1, "pg_setdefaultwindowsurfac": 1, "pg_twofloatsfromobj": 1, "pg_twointsfromobj": 1, "pg_uintfromobj": 1, "pg_uintfromobjindex": 1, "pg_version_atleast": 14, "pg_versionnum": 14, "pg_view_p": 1, "pgbuffer_asarrayinterfac": 1, "pgbuffer_asarraystruct": 1, "pgbuffer_releas": 1, "pgbufferproxy_check": 2, "pgbufferproxy_getpar": 2, "pgbufferproxy_new": 2, "pgbufferproxy_trip": 2, "pgbufferproxy_typ": 2, "pgchannel_asint": 8, "pgchannel_check": 8, "pgchannel_new": 8, "pgchannel_typ": 8, "pgchannelobject": 8, "pgcolor_checkexact": 3, "pgcolor_new": 3, "pgcolor_newlength": 3, "pgcolor_typ": 3, "pgcolorhandleflag": 3, "pgdict_asbuff": 1, "pgevent_check": 5, "pgevent_getkeydowninfo": 5, "pgevent_getkeyupinfo": 5, "pgevent_getmousebuttondowninfo": 5, "pgevent_getmousebuttonupinfo": 5, "pgevent_new": 5, "pgevent_typ": 5, "pgeventdictproxi": 5, "pgeventobject": 5, "pgexc_buffererror": 1, "pgexc_sdlerror": 1, "pgfont_check": 6, "pgfont_is_al": 6, "pgfont_new": 6, "pgfont_typ": 6, "pgfontobject": 6, "pgfrect_asrect": 9, "pgfrect_fromobject": 9, "pgfrect_new": 9, "pgfrect_new4": 9, "pgfrect_norm": 9, "pgfrect_typ": 9, "pgfrectobject": 9, "pgjoystick_getdeviceindexbyinstanceid": 7, "pgjoystick_new": 7, "pgjoystick_typ": 7, "pgm": 32, "pgobject_getbuff": 1, "pgobject_getrecthelp": 1, "pgrect_asrect": 9, "pgrect_fromobject": 9, "pgrect_new": 9, "pgrect_new4": 9, "pgrect_norm": 9, "pgrect_typ": 9, "pgrectobject": 9, "pgrwops_fromfileobject": 10, "pgrwops_fromobject": 10, "pgrwops_isfileobject": 10, "pgsound_aschunk": 8, "pgsound_check": 8, "pgsound_new": 8, "pgsound_typ": 8, "pgsoundobject": 8, "pgsurface_assurfac": 12, "pgsurface_blit": 12, "pgsurface_check": 12, "pgsurface_lock": 13, "pgsurface_lockbi": 13, "pgsurface_new": 12, "pgsurface_prep": 13, "pgsurface_typ": 12, "pgsurface_unlock": 13, "pgsurface_unlockbi": 13, "pgsurface_unprep": 13, "pgsurfaceobject": [1, 12, 13], "pgvidinfo_asvidinfo": 4, "pgvidinfo_check": 4, "pgvidinfo_new": 4, "pgvidinfo_typ": 4, "pgvidinfoobject": 4, "pgwindow_check": 15, "pgwindow_typ": 15, "pgwindowobject": 15, "phi": 37, "photo": 44, "photograph": 58, "photoshop": 18, "physic": [17, 19, 24, 33, 66, 69, 74, 76, 77], "pi": [25, 30, 77], "pick": [24, 44, 58, 63, 70], "pictur": [32, 66], "pidiendo": 78, "pie": 31, "piec": [29, 71], "pil": 32, "pile": 27, "pinch": 26, "pink": 22, "pink1": 22, "pink2": 22, "pink3": 22, "pink4": 22, "pip": 17, "pip3": 17, "pipe": 24, "pitch": [32, 38, 52, 70], "pitch_bend": 38, "pivar": 78, "pixel": [17, 19, 20, 21, 23, 24, 25, 27, 28, 29, 31, 32, 36, 45, 48, 50, 52, 58, 60, 62, 63, 66, 68, 72, 73, 76, 77], "pixel2d": 68, "pixel3d": 68, "pixel_arrai": 42, "pixel_format": 24, "pixel_s": 58, "pixelarrai": [17, 27, 42, 52], "pixelcopi": [27, 42, 43, 53], "pixelformat": 20, "pixelformat_rgb888": 24, "pixels2d": [53, 68], "pixels3d": [53, 68], "pixels_alpha": [53, 68], "pixels_blu": 53, "pixels_green": 53, "pixels_r": 53, "place": [1, 21, 24, 25, 26, 29, 30, 35, 37, 38, 40, 42, 44, 45, 46, 48, 51, 52, 53, 55, 56, 62, 66, 67, 68, 70, 71, 75, 76], "placehold": [44, 62, 67], "placement": 44, "plai": [8, 17, 24, 27, 28, 33, 38, 41, 47, 61, 62, 66, 67, 70, 71, 74, 78], "plain": 46, "plan": [52, 66], "plane": 52, "plano": 78, "plant": 68, "plataforma": 78, "plateau": 71, "platform": [17, 20, 24, 25, 31, 34, 36, 38, 39, 42, 44, 46, 48, 52, 54, 55, 56, 58, 60, 62, 63, 65, 66, 71, 74, 76], "platforma": 78, "playabl": 49, "playback": [27, 39, 41], "player": [27, 51, 62, 67, 69, 70, 71, 76, 77], "player1": [69, 77], "player2": 77, "player_po": 17, "playerimag": 70, "playerpo": 70, "playersprit": 77, "playmu": 27, "pleas": [18, 24, 44, 54, 60, 71], "plenti": [69, 71], "plot": 69, "plu": [28, 34, 38, 44], "plug": [33, 54], "plugged_in": 54, "plum": 22, "plum1": 22, "plum2": 22, "plum3": 22, "plum4": 22, "pm_recommended_input_devic": 38, "pm_recommended_output_devic": 38, "pmdeviceid": 38, "png": [27, 32, 62, 66, 71, 74, 75, 76, 77], "pnm": 32, "po": [26, 36, 40, 41, 51, 61, 62, 70, 78], "poco": 78, "poder": 78, "podr\u00e1": 78, "podr\u00edamo": 78, "podr\u00edan": 78, "point": [3, 16, 19, 21, 23, 25, 27, 28, 29, 30, 31, 33, 36, 37, 38, 39, 45, 48, 51, 58, 59, 65, 66, 67, 68, 70, 71, 77], "point_siz": 28, "pointer": [9, 10, 12, 62], "polar": 37, "polish": [23, 66], "poll": [17, 26, 38, 71], "polygon": [17, 25, 31], "poner": 78, "pong": [69, 74, 77], "poor": 69, "poorli": [69, 71], "pop": [26, 44, 72], "popul": 10, "popular": [27, 33, 61], "por": 17, "porqu": 78, "port": [17, 20, 27, 38, 44, 48], "portabl": [34, 38, 66], "portion": [12, 24, 36, 45, 48, 52, 58, 66, 67, 71], "portmidi": 38, "posibilidad": 78, "posibl": 78, "posici\u00f3n": 78, "posit": [1, 9, 19, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 36, 39, 40, 41, 44, 45, 48, 51, 52, 55, 57, 58, 60, 61, 62, 65, 66, 67, 70, 71, 73, 75, 76, 77, 78], "possibl": [20, 24, 26, 28, 29, 30, 32, 33, 37, 39, 44, 51, 52, 54, 58, 60, 62, 65, 66, 68], "possibli": 69, "post": [5, 26, 39, 47, 56], "potenti": [32, 48, 54, 67, 71, 76], "powderblu": 22, "power": [18, 20, 33, 34, 39, 54, 67, 71], "power_level": 33, "powerst": 54, "ppem": 29, "ppm": 32, "pr": 40, "practic": [71, 74], "pre": [21, 29, 50, 52, 54], "pre_init": 39, "prealloc": 52, "preced": [36, 48], "precis": [24, 39, 40, 45, 52, 59, 68, 71], "precise_i": 26, "precise_x": 26, "predecessor": [68, 71], "predefin": [26, 37, 46], "predeterminada": 78, "predomin": 43, "prefer": [24, 26, 31, 32, 34, 40, 48, 52, 54], "prefijada": 78, "prefix": 62, "preguntamo": 78, "prematur": 71, "premul_alpha": [21, 50, 52, 72], "premul_alpha_ip": 52, "premultipli": [17, 50, 52, 71], "prepar": [27, 41, 61, 72], "prepara": 78, "preparan": 78, "present": [40, 44, 48, 60, 64, 66, 67, 70, 71], "presentan": 78, "preserv": [21, 32, 44, 45, 52], "preset": [23, 39], "presionado": 78, "presion\u00f3": 78, "press": [5, 27, 33, 34, 40, 47, 60, 62, 65, 70, 71], "pressur": 57, "pretend": 70, "pretti": [63, 67, 68, 70, 71, 73, 76, 77], "prettier": 34, "prevar": 71, "prevent": [24, 26, 71, 77], "prevent_display_stretch": 24, "previou": [1, 24, 29, 39, 40, 48, 51, 52, 56, 58, 62, 67, 68, 70, 71, 73, 77], "previous": [20, 21, 24, 26, 28, 29, 32, 39, 41, 44, 50, 63, 70, 73], "primari": [24, 40], "primarili": [29, 44, 48], "prime": 48, "primer": [68, 78], "primera": 78, "primero": 78, "primit": [31, 48], "principio": 17, "principl": [76, 77], "print": [26, 33, 34, 37, 40, 44, 45, 46, 60, 61, 63, 65, 70, 71, 74, 77, 78], "print_debug_info": 44, "prior": [17, 30, 37], "prioriti": 20, "privado": 78, "privat": [52, 62], "probabl": [1, 27, 37, 67, 70, 71, 72, 73], "problem": [17, 28, 43, 44, 62, 69, 71, 74], "problema": 78, "proce": 71, "process": [20, 26, 27, 33, 34, 40, 46, 48, 53, 55, 56, 64, 70, 71, 72], "processor": [56, 58], "procur": 20, "produc": [29, 30, 50, 52, 72], "product": [37, 69], "profil": [24, 26, 71], "profit": 20, "profundidad": 78, "program": [17, 24, 26, 33, 34, 38, 39, 44, 45, 54, 55, 56, 60, 61, 62, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76], "programa": [17, 78], "programm": [66, 67, 71, 74, 75], "programmat": 44, "progress": [17, 26, 30, 43], "project": [18, 27, 30, 37, 66, 69, 71, 74, 75, 77], "prolif": 71, "promesa": 78, "promis": [62, 70], "prompt": [44, 66, 68], "proper": [29, 34, 39, 40, 59, 67, 68], "properli": [10, 17, 26, 40, 48, 55, 67, 68, 70], "properti": [19, 21, 26, 29, 40, 51, 52, 53, 60], "proporcionalment": 78, "propos": 66, "protecci\u00f3n": 78, "protect": [27, 62], "protocol": [2, 17, 32, 37, 43, 52, 59], "protrud": 36, "proud": 70, "provid": [17, 20, 21, 24, 26, 27, 28, 29, 30, 32, 34, 36, 37, 39, 42, 44, 45, 48, 51, 52, 55, 56, 58, 60, 62, 65, 74, 75], "proxi": [2, 19], "prueba": 78, "ps4": 33, "pseudo": 75, "public": [27, 74, 77], "publish": 60, "pued": 78, "pueda": 78, "puedan": 78, "pueden": 78, "pull": [20, 61, 62, 78], "pummel": [61, 62, 78], "pump": [26, 33, 34, 40, 76, 77], "punch": [61, 62, 66, 78], "punch_sound": [61, 62, 78], "punchabl": 62, "punctuat": [28, 54], "puntero": 78, "pure": [32, 44, 52], "purpl": [17, 22, 71], "purple1": 22, "purple2": 22, "purple3": 22, "purple4": 22, "purpos": [1, 20, 44, 48, 65, 69], "push": [24, 34, 76], "pushabl": 33, "put": [17, 18, 33, 46, 56, 61, 64, 66, 67, 69, 73, 74, 75], "put_text": 46, "pu\u00f1o": [17, 78], "pxarrai": 42, "py": [17, 24, 27, 44, 46, 55, 68, 69, 70], "py_buff": [1, 19], "py_ssize_t": 1, "pybuf": 1, "pybuffer_releaseproc": 1, "pygam": [11, 16, 22, 50, 74, 75, 77], "pygame_blend_add": 12, "pygame_blend_alpha_sdl2": [12, 44], "pygame_blend_max": 12, "pygame_blend_min": 12, "pygame_blend_mult": 12, "pygame_blend_premultipli": 12, "pygame_blend_rgba_add": 12, "pygame_blend_rgba_max": 12, "pygame_blend_rgba_min": 12, "pygame_blend_rgba_mult": 12, "pygame_blend_rgba_sub": 12, "pygame_blend_sub": 12, "pygame_camera": 44, "pygame_ce_lofi": 18, "pygame_ce_logo": 18, "pygame_ce_pow": 18, "pygame_ce_powered_lowr": 18, "pygame_ce_tini": 18, "pygame_displai": 44, "pygame_force_scal": 44, "pygame_freetyp": [6, 28, 44], "pygame_hide_support_prompt": 44, "pygame_mix": 8, "pygameapi_base_numslot": 11, "pygamevers": 44, "pyobject": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15], "pyopengl": [27, 32, 66], "pypi": 42, "pyportmidi": 38, "pysdl": [66, 71], "pythagorean": 37, "python": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 16, 17, 19, 20, 23, 24, 27, 28, 29, 30, 32, 39, 43, 44, 45, 51, 52, 55, 61, 62, 64, 67, 69, 70, 73, 74, 75, 78], "python2": 27, "python26": 27, "python3": 20, "pytypeobject": [2, 3, 4, 7, 8, 9, 12, 15], "pyunicode_asencodedstr": [10, 44], "pyzin": 66, "p\u00e9rdida": 78, "p\u00edxel": 78, "q": 34, "qce": 20, "qoi": 32, "quad": 48, "quadrant": 25, "quadruplet": 31, "quake3": 66, "qualiti": [27, 32, 44, 48, 62, 66], "que": 78, "queri": [24, 38, 40, 46, 54, 63], "querramo": 78, "query_imag": [20, 65], "question": [17, 34, 70, 71], "queu": [26, 39, 41], "queue": [5, 20, 24, 33, 34, 35, 38, 39, 40, 41, 47, 56, 60, 62, 66, 71, 76], "quick": [26, 27, 33, 52, 55, 64, 67, 68, 72, 76], "quicker": [51, 52, 67], "quickest": 52, "quickli": [32, 62, 63, 66, 67, 68, 70], "quier": 78, "quietli": 26, "quisieramo": 78, "quit": [1, 17, 23, 24, 25, 26, 27, 28, 29, 33, 38, 39, 40, 44, 47, 52, 55, 60, 61, 62, 65, 66, 68, 70, 71, 72, 73, 76, 77, 78], "quot": 34, "quotedbl": 34, "qu\u00e9": 78, "r": [9, 21, 25, 27, 30, 31, 33, 34, 37, 42, 43, 45, 52, 58, 59, 67, 68], "r_": 30, "r_sqr": 30, "radial": [37, 68], "radian": [25, 31, 37, 75, 77], "radii": [25, 31], "radiu": [25, 30, 31, 51, 58], "rais": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 16, 19, 21, 23, 24, 25, 26, 27, 28, 29, 31, 32, 34, 36, 37, 38, 39, 41, 43, 44, 45, 46, 48, 49, 51, 52, 53, 58, 60, 64, 65, 68, 74, 77], "ralf": 17, "ram": [48, 54], "ramp": 24, "ran": 73, "rand": 77, "randint": 77, "random": [55, 69, 74, 77], "rang": [21, 24, 25, 26, 28, 29, 33, 34, 36, 37, 38, 39, 42, 44, 47, 51, 52, 58, 59, 65, 66, 68, 70], "rank": 71, "rapid": [26, 33], "rapidli": [34, 70], "rare": [37, 44, 48, 52, 71], "raster": 32, "rate": [24, 39, 41, 48, 51, 56, 71], "rather": [25, 28, 29, 31, 34, 44, 51, 56, 58, 73, 75], "ratio": [32, 45, 51], "raw": [19, 32, 42, 43, 52, 53, 68], "rb": 46, "rdtsc": 54, "re": [23, 25, 27, 29, 44, 58, 60, 63, 67, 69, 70, 71, 73, 75, 76], "reach": [66, 71], "read": [10, 19, 21, 26, 27, 28, 29, 30, 37, 38, 39, 40, 46, 48, 50, 51, 52, 60, 68, 69, 70, 71, 72], "readabl": [21, 39, 74], "readi": [20, 23, 33, 48, 55, 62, 65, 66, 70], "readlin": 23, "readm": 17, "readonli": 51, "real": [26, 28, 29, 38, 39, 52, 63, 65, 67, 70, 71, 72], "realidad": 78, "realist": [74, 77], "realiti": [63, 71], "realiz": [66, 71], "realiza": 78, "realizada": 78, "realizado": 78, "realizar": 78, "realli": [24, 58, 62, 63, 66, 67, 68, 70, 73, 75, 76], "realment": 78, "realmnet": 78, "realtim": [52, 66, 68], "reason": [24, 28, 29, 40, 48, 52, 58, 60, 65, 67, 69, 70, 71, 72, 75], "reassign": 30, "rebel": 66, "rebind": 47, "recalcul": 29, "recap": 69, "receiv": [24, 26, 33, 34, 40, 47, 56, 71], "recent": [5, 29, 34, 40, 62, 66, 67, 68], "recientement": 78, "recogn": [19, 29, 33, 43, 45, 58], "recogniz": 32, "recomepensa": 78, "recommend": [28, 32, 51, 52, 70, 71], "recommended_input_devic": 38, "recommended_output_devic": 38, "recompil": 77, "reconstruct": 52, "record": [20, 29, 53, 55, 71], "recorremo": 78, "recreat": [27, 51, 55], "rect": [0, 1, 17, 25, 29, 30, 31, 34, 36, 45, 48, 51, 52, 58, 59, 60, 61, 62, 65, 66, 67, 70, 74, 75, 76, 77, 78], "rect1": 45, "rect2": 45, "rect_dict": 45, "rect_list": [45, 51], "rect_sequ": 45, "rectangl": [1, 9, 17, 24, 25, 27, 29, 30, 31, 34, 45, 48, 51, 52, 58, 60, 71, 73, 75, 77], "rectangular": [9, 29, 31, 36, 42, 48, 51, 52, 66, 70], "rectlik": 59, "rectstyl": 71, "red": [1, 17, 20, 21, 22, 24, 25, 30, 32, 42, 51, 52, 53, 58, 60, 68, 73, 78], "red1": 22, "red2": 22, "red3": 22, "red4": 22, "red_surf": 52, "redimg": 68, "redistribut": 20, "redraw": 70, "redrawn": 24, "reduc": [5, 29, 39, 52, 72, 76], "reentrant": 55, "ref": 25, "refer": [1, 13, 19, 21, 24, 25, 26, 28, 32, 33, 34, 36, 41, 42, 46, 47, 49, 52, 53, 54, 56, 62, 63, 65, 66, 67, 68, 70, 71, 76], "referenc": [53, 54, 67, 68], "referencia": 78, "referenciada": 78, "reflect": 37, "reflect_ip": 37, "refrain": [17, 30], "refresh": [24, 48, 71], "regard": [25, 39, 41], "regardless": [28, 44], "region": [32, 52, 58, 71, 74], "regist": [1, 44, 46, 75], "register_quit": 44, "registri": 38, "regress": 37, "regular": [17, 24, 28, 29, 32, 41, 52, 58, 67], "regularli": 33, "reinit": [76, 77], "reiniti": 39, "reinitialis": 33, "rel": [21, 24, 26, 33, 37, 38, 40, 41, 45, 48, 51, 69, 74], "relat": [1, 24, 29, 35, 39, 40, 43, 47, 51, 71], "relationship": 51, "relcent": 45, "releas": [1, 5, 13, 19, 20, 24, 29, 31, 33, 34, 38, 40, 42, 44, 46, 52, 54, 62, 66, 71, 74, 76, 77], "release_buff": 1, "relev": [29, 71], "reli": [9, 17, 24, 29, 30, 32, 34, 39, 72, 76], "reliabl": [20, 24, 38], "rellenar": 78, "remain": [21, 41, 45, 52, 53, 73], "remap": [37, 42, 47], "rememb": [40, 51, 52, 63, 66, 67, 68, 69, 71, 74, 75], "remov": [13, 17, 19, 20, 25, 26, 28, 30, 33, 37, 46, 51, 54, 58, 60, 62, 67, 70, 77], "remove_intern": 67, "remove_sprites_of_lay": 51, "renam": 47, "render": [17, 24, 25, 27, 33, 48, 51, 60, 61, 62, 66, 71, 72, 73, 75, 76, 78], "render_device_reset": 26, "render_outlin": 28, "render_raw": 29, "render_raw_to": 29, "render_targets_reset": 26, "render_to": 29, "rendererdriverinfo": 48, "renderizar": 78, "renderizarlo": 78, "renderupd": [27, 51, 67, 71], "renderupdatesdraw": 67, "repaint": [26, 51], "repaint_rect": 51, "repcolor": 42, "repeat": [24, 25, 34, 36, 39, 41, 44, 52, 69, 70], "repeat_edge_pixel": 58, "repeatedli": [51, 52, 56, 62, 71], "repetida": 78, "repetidament": 78, "replac": [1, 24, 25, 26, 29, 39, 42, 43, 44, 52, 53, 56, 58, 68, 70], "report": [17, 27, 33, 40, 44, 54, 58, 71], "repositori": [44, 71], "repr": 44, "repres": [1, 3, 12, 13, 14, 15, 17, 19, 21, 23, 24, 25, 26, 29, 30, 32, 33, 34, 36, 37, 39, 40, 41, 44, 45, 47, 48, 53, 54, 56, 58, 59, 62, 66, 67, 68, 70, 71, 75], "represent": [1, 3, 9, 17, 22, 28, 31, 42, 62, 78], "representa": 78, "representan": 78, "representar": 78, "representarlo": 78, "represetar": 78, "reproduc": [20, 78], "reproducci\u00f3n": 78, "request": [1, 24, 27, 28, 29, 36, 39, 48, 49, 52, 53, 63], "requir": [19, 20, 24, 26, 27, 28, 30, 32, 34, 36, 37, 38, 39, 44, 45, 46, 47, 48, 51, 52, 57, 58, 59, 60, 63, 66, 67, 68, 69, 70, 71, 72, 73, 74, 76], "resampl": 39, "rescal": 27, "resembl": [27, 43, 53, 54], "reserv": [26, 38, 39], "reset": [29, 38, 39, 41, 51, 62, 77], "resetea": 78, "resid": 48, "resist": 71, "resiz": [17, 24, 26, 27, 36, 45, 48, 52, 58, 60, 62, 73, 78], "resolut": [17, 18, 24, 29, 48, 52, 58, 60, 62, 63, 78], "resolv": [46, 75], "resourc": [27, 41, 44, 61, 63, 69, 71, 75], "respect": [1, 21, 23, 24, 25, 34, 36, 37, 51, 52, 60], "respond": [26, 70, 71], "respons": [10, 55], "rest": [26, 46, 62, 65, 66, 68, 70, 71], "restart": [41, 74], "resto": 78, "restor": [24, 26, 60], "restrict": [28, 52, 60], "result": [21, 25, 28, 29, 30, 34, 36, 37, 38, 40, 41, 42, 45, 50, 52, 54, 55, 58, 60, 62, 66, 67, 68, 70, 71, 72, 77], "resulta": 78, "resultado": 78, "resum": [39, 41], "retail": 66, "retain": [20, 37, 52], "retriev": [14, 37, 39, 40, 41, 44, 46, 71, 76], "return": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 14, 15, 16, 19, 20, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 70, 71, 72, 73, 74, 75, 76, 77, 78], "return_button": 24, "reus": [20, 74], "reusabl": 74, "rev": 44, "revamp": 70, "revers": [1, 32, 52, 62, 66, 68, 77], "revis": [44, 66, 69], "revisaremo": 78, "reward": [62, 66], "rewind": 41, "rewound": 27, "rewrit": [71, 72], "rgb": [20, 21, 24, 25, 28, 31, 32, 43, 50, 52, 58, 62, 65, 66, 68, 71, 72, 73, 78], "rgba": [1, 3, 21, 24, 31, 32, 50, 52], "rgba_premult": 32, "rgbarrai": 68, "rgbvalu": 21, "rgbx": 32, "rich": 62, "rid": 65, "ridicul": 69, "right": [21, 24, 25, 28, 29, 30, 31, 34, 36, 39, 42, 44, 45, 46, 47, 51, 52, 61, 62, 66, 68, 70, 71, 75, 76, 77, 78], "rins": 70, "riqueza": 78, "rle": [50, 52], "rleaccel": [52, 61, 62, 78], "rleaccelok": 52, "road": 70, "roam": 54, "rojo": 78, "roll": [33, 40, 67], "root": [37, 55, 71], "rosybrown": 22, "rosybrown1": 22, "rosybrown2": 22, "rosybrown3": 22, "rosybrown4": 22, "rotaci\u00f3n": 78, "rotada": 78, "rotado": 78, "rotamo": 78, "rotando": 78, "rotar": 78, "rotat": [26, 27, 29, 30, 37, 48, 51, 58, 61, 62, 66, 78], "rotate_i": 37, "rotate_ip": [30, 37], "rotate_ip_rad": 37, "rotate_rad": 37, "rotate_rad_ip": 37, "rotate_x": 37, "rotate_x_ip": 37, "rotate_x_ip_rad": 37, "rotate_x_rad": 37, "rotate_x_rad_ip": 37, "rotate_y_ip": 37, "rotate_y_ip_rad": 37, "rotate_y_rad": 37, "rotate_y_rad_ip": 37, "rotate_z": 37, "rotate_z_ip": 37, "rotate_z_ip_rad": 37, "rotate_z_rad": 37, "rotate_z_rad_ip": 37, "rotation_point": 30, "rote": 78, "rotozoom": 58, "rough": 71, "roughli": 60, "round": [21, 25, 37, 38, 39, 53, 76], "routin": [1, 20, 28, 29, 52, 62, 63, 71], "row": [36, 42, 52, 68], "row1": 68, "row2": 68, "royalblu": 22, "royalblue1": 22, "royalblue2": 22, "royalblue3": 22, "royalblue4": 22, "rr": 21, "rrggbb": 21, "rrggbbaa": [21, 59], "rt": 33, "rudder": 33, "rudimentari": 27, "ruin": 68, "rule": [63, 77], "rumbl": [33, 47], "run": [17, 24, 26, 27, 29, 32, 33, 39, 44, 50, 54, 55, 56, 58, 61, 62, 63, 66, 67, 68, 70, 71, 72, 73, 77], "run_speed_test": 27, "run_test": 55, "run_tests__test": 55, "rundown": 27, "runnabl": 60, "runner": 55, "runtim": [24, 39, 56, 58, 66], "runtimeerror": [29, 44], "ruta": 78, "rutina": 78, "rw": 10, "rwobject": 0, "rx": 31, "ry": 31, "r\u00e1pido": 78, "sabe": 78, "sacar": 78, "saddlebrown": 22, "safe": [10, 24, 26, 28, 29, 33, 38, 39, 42, 44, 47, 51, 52, 64, 65], "sai": [52, 67, 69, 70, 71], "said": [21, 25, 69, 71, 73], "sake": [71, 73], "salido": 78, "salir": 78, "salmon": 22, "salmon1": 22, "salmon2": 22, "salmon3": 22, "salmon4": 22, "salt": 71, "saltear": 78, "sam": 66, "same": [1, 5, 10, 20, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 36, 37, 39, 40, 42, 43, 44, 45, 46, 47, 48, 50, 51, 52, 53, 56, 58, 59, 60, 62, 63, 65, 66, 67, 68, 70, 71, 72, 73, 77], "sampl": [17, 21, 39, 41, 48, 58, 65, 67, 68, 70, 76], "san": 29, "sandybrown": 22, "satisfactori": 74, "satisfi": 24, "satur": [20, 58], "sauf": 36, "save": [17, 20, 24, 32, 54, 66, 69, 71], "save_extend": 32, "savegam": 54, "saw": [62, 65, 70, 72], "scalabl": 29, "scalar": [37, 45, 58, 62], "scale": [20, 24, 25, 27, 29, 30, 32, 36, 37, 44, 45, 48, 51, 58, 60, 61, 62, 66, 68, 78], "scale2x": 58, "scale_bi": [45, 58, 61, 62], "scale_by_ip": 45, "scale_ip": 30, "scale_qu": 48, "scale_to_length": 37, "scaledown": 68, "scaler": 27, "scaletest": 27, "scaleup": 68, "scancod": [26, 34], "scancodewrapp": 34, "scanlin": 70, "scant": 27, "scene": [32, 65], "school": 40, "scipi": 68, "scope": [42, 68], "score": [27, 51, 69, 77], "scoreboard": 69, "scoreup": 69, "scrap": [17, 46], "scrap_bmp": 46, "scrap_clipboard": [27, 46], "scrap_select": 46, "scrap_text": 46, "scratch": [67, 71], "scratchi": 39, "screen": [1, 4, 17, 23, 25, 26, 27, 28, 32, 33, 34, 35, 40, 44, 45, 46, 48, 51, 52, 60, 61, 62, 63, 65, 66, 67, 68, 69, 71, 73, 75, 76, 77, 78], "screen_dim": 27, "screen_height": 24, "screen_rect": [45, 51], "screen_tear": 24, "screen_width": 24, "screensav": [24, 44], "screenshot": 62, "script": [28, 29, 61, 64, 66], "script_cod": 28, "scroll": [27, 40, 52, 66, 67, 70, 71, 72], "scroll_eras": 52, "scroll_flag": 52, "scroll_repeat": 52, "scrollabl": 27, "scrollock": 34, "sdl": [1, 5, 8, 10, 12, 13, 17, 24, 26, 27, 39, 41, 43, 44, 48, 54, 58, 60, 63, 66, 71], "sdl2": [40, 44, 47, 48, 50, 57], "sdl2_video": 17, "sdl3": [24, 54], "sdl_allow_alt_tab_while_grab": 60, "sdl_audiodriv": [39, 44], "sdl_composecustomblendmod": 48, "sdl_delai": 56, "sdl_event": 5, "sdl_frect": 9, "sdl_gfx": 31, "sdl_hint_video_allow_screensav": 24, "sdl_imag": [32, 66], "sdl_joystick_allow_background_ev": [33, 44], "sdl_mixer": [39, 41], "sdl_mouse_touch_ev": 44, "sdl_num_scancod": 5, "sdl_pushev": 5, "sdl_rect": [9, 12], "sdl_rwop": 10, "sdl_surfac": [3, 12], "sdl_ttf": [28, 29, 44], "sdl_userev": 5, "sdl_video": 52, "sdl_video_allow_screensav": 44, "sdl_video_cent": 44, "sdl_video_window_po": 44, "sdl_video_x11_net_wm_bypass_compositor": 44, "sdl_videodriv": [24, 44], "sdl_videoinfo": 4, "sdl_window": 1, "sdl_windowid": 24, "sdl_windows_dpi_awar": 44, "sdlversion": 44, "se": 78, "sea": [25, 78], "seagreen": 22, "seagreen1": 22, "seagreen2": 22, "seagreen3": 22, "seagreen4": 22, "search": [17, 28, 29, 36, 39, 45, 51, 58], "search_color": 58, "search_surf": 58, "seashel": 22, "seashell1": 22, "seashell2": 22, "seashell3": 22, "seashell4": 22, "secci\u00f3n": 78, "second": [17, 19, 21, 23, 25, 27, 30, 31, 33, 37, 39, 41, 42, 48, 49, 51, 54, 55, 56, 62, 64, 66, 68, 70, 71, 72, 76, 77], "secondari": 71, "section": [17, 52, 62, 67, 68, 69, 70, 74, 77], "secur": 74, "see": [10, 18, 20, 21, 24, 25, 27, 28, 29, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 43, 44, 45, 47, 48, 51, 52, 53, 58, 62, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77], "seed": [55, 68], "seek": 10, "seem": [32, 46, 54, 66, 67, 69, 70, 71, 72, 73, 75], "seemingli": 69, "seen": [24, 68, 69, 70, 76, 77], "segment": [25, 30, 31], "segundo": 78, "select": [20, 24, 29, 34, 36, 38, 39, 41, 44, 46, 55, 63, 70, 71], "self": [21, 36, 37, 45, 51, 52, 61, 62, 65, 67, 70, 75, 76, 77, 78], "sell": 70, "semi": [27, 39, 72], "semibold": [28, 29], "semicolon": 34, "semilight": [28, 29], "semiton": 38, "sencillo": 17, "send": [26, 38, 39, 41, 54, 77], "sens": [70, 71, 75, 76, 77], "sensibl": 39, "sent": [24, 33, 34, 39, 41, 60], "sentinel": 60, "separ": [20, 23, 27, 28, 29, 30, 38, 39, 44, 45, 51, 52, 53, 55, 58, 65, 67, 68, 69, 70, 71, 72, 74], "sequenc": [1, 9, 16, 23, 24, 25, 26, 29, 30, 31, 34, 36, 38, 40, 42, 45, 51, 52, 58, 59, 63, 66, 67, 71, 76], "sequencelik": 59, "sequenti": 25, "ser": 78, "seri": [38, 66], "serrano": 78, "serv": [66, 71], "server": [27, 40], "servic": 20, "ser\u00e1": 78, "ser\u00e1n": 78, "ser\u00eda": 78, "session": 55, "set": [1, 3, 6, 19, 20, 21, 23, 24, 25, 26, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 56, 58, 60, 62, 64, 68, 70, 71, 72, 73, 74, 75, 76, 77], "set_allow": 26, "set_allow_screensav": 24, "set_alpha": [43, 52], "set_at": [36, 52, 68, 71], "set_behavior": 58, "set_blend_mod": 48, "set_block": [26, 71], "set_bold": 28, "set_capt": [23, 24, 25, 33, 61, 62, 72, 73, 77, 78], "set_clip": [51, 52], "set_color": 58, "set_colorkei": [43, 52, 61, 62, 71, 78], "set_control": [20, 65], "set_cursor": [23, 40], "set_default_resolut": 29, "set_direct": 28, "set_draw_blend_mod": 48, "set_endev": [39, 41], "set_error": 44, "set_eventst": 47, "set_fullscreen": 60, "set_gamma": 24, "set_gamma_ramp": 24, "set_grab": [26, 34, 40], "set_icon": [24, 60], "set_instru": 38, "set_ital": 28, "set_l": [33, 47], "set_length": 21, "set_lines": 28, "set_map": 47, "set_mask": 52, "set_mod": [1, 17, 23, 24, 25, 33, 34, 35, 40, 44, 46, 52, 60, 61, 62, 63, 65, 66, 70, 71, 72, 73, 77, 78], "set_modal_for": 60, "set_num_channel": 39, "set_palett": [24, 52], "set_palette_at": 52, "set_po": [40, 41], "set_point_s": 28, "set_relative_mod": 40, "set_repeat": 34, "set_reserv": 39, "set_script": 28, "set_shift": 52, "set_smoothscale_backend": 58, "set_soundfont": 39, "set_source_loc": 39, "set_strikethrough": 28, "set_text_input_rect": 34, "set_tim": 56, "set_timing_threshold": 51, "set_timing_treshold": 51, "set_underlin": 28, "set_viewport": 48, "set_vis": [40, 61, 62, 78], "set_volum": [39, 41], "set_window": 60, "set_window_posit": 24, "setcolor": 36, "setsurfac": 36, "settabl": 44, "setup": [17, 23, 27, 71, 72], "seven": 58, "sever": [17, 23, 24, 25, 27, 29, 39, 45, 51, 54, 56, 63, 64, 66, 67, 68, 70, 71, 73, 77], "se\u00f1al": 78, "sf": 42, "sfnt": 29, "shall": 20, "shallow": [26, 36, 52, 56], "shape": [17, 19, 28, 29, 30, 37, 42, 43, 52, 66, 68], "share": [5, 17, 26, 32, 33, 34, 39, 48, 52, 53, 54, 56, 60], "sharp": 25, "she": 73, "shell": 27, "shift": [24, 27, 34, 36, 42, 44, 52, 63, 68], "shinner": [62, 63, 64, 66, 67, 68, 70, 71, 78], "shoot": 66, "short": [26, 60, 66, 68, 71], "shortcut": [21, 60, 67], "shorter": [24, 62, 68], "shortest": 37, "shot": 67, "should": [17, 20, 23, 24, 26, 27, 28, 29, 31, 32, 33, 34, 36, 37, 38, 39, 42, 44, 45, 46, 47, 48, 50, 51, 52, 54, 56, 58, 60, 62, 63, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 77], "shoulder": 47, "shouldn": 76, "show": [17, 23, 24, 27, 29, 34, 40, 55, 58, 60, 62, 63, 65, 68, 70, 71, 76, 77], "show_output": 55, "showcas": [27, 71], "shown": [24, 26, 34, 65, 70, 71, 75], "shrink": [45, 71, 77], "shrinkag": 58, "shrunk": 52, "shut": [24, 29, 33, 44], "shutdown": [8, 66], "si": 78, "side": [5, 24, 25, 42, 45, 47, 52, 62, 66, 69, 75, 76], "sido": 78, "siempr": 78, "sienna": 22, "sienna1": 22, "sienna2": 22, "sienna3": 22, "sienna4": 22, "sign": [19, 34, 38, 39, 40, 44], "signal": [26, 41, 59, 73], "signatur": 48, "signific": 52, "significa": 78, "significantli": [53, 71], "sigueint": 78, "siguient": 78, "silenc": 55, "silent": [24, 64], "silver": 22, "simd": [27, 52, 54, 58], "similar": [24, 29, 32, 33, 40, 42, 45, 48, 49, 51, 52, 54, 56, 62, 67, 68, 70, 73, 74, 76, 77, 78], "similarli": 60, "simpl": [17, 23, 24, 25, 27, 42, 48, 51, 52, 58, 61, 62, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 77, 78], "simplement": 78, "simpler": [66, 67, 70], "simplest": [65, 72], "simpli": [23, 24, 26, 38, 39, 44, 51, 62, 63, 65, 66, 68, 70, 71, 73, 75, 77], "simplic": 72, "simul": 62, "simula": 78, "simultan": 39, "sin": [75, 77, 78], "sinc": [17, 21, 24, 26, 28, 32, 33, 37, 39, 40, 41, 44, 46, 47, 48, 51, 52, 53, 54, 56, 60, 62, 63, 64, 65, 66, 67, 68, 70, 71], "singl": [19, 21, 23, 24, 25, 26, 28, 29, 30, 31, 33, 34, 39, 41, 42, 43, 45, 51, 52, 53, 55, 62, 64, 66, 67, 68, 69, 70, 73], "singular": 52, "sistema": 78, "sit": 71, "site": 27, "situacion": 78, "situat": [24, 37, 52, 67, 68, 71], "six": [39, 41, 66, 69], "sizabl": 71, "size": [1, 9, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 36, 39, 40, 42, 43, 45, 48, 51, 52, 53, 58, 60, 62, 63, 65, 66, 68, 69, 70, 71, 72, 73, 78], "sizeabl": 24, "sizeal": 23, "sizenesw": 23, "sizenws": 23, "sizeof": 36, "sizer_x_str": 23, "sizer_xy_str": 23, "sizer_y_str": 23, "skeleton": 71, "skew": 28, "skill": 71, "skip": [24, 36, 39], "skyblu": 22, "skyblue1": 22, "skyblue2": 22, "skyblue3": 22, "skyblue4": 22, "sl": 33, "slant": [28, 29], "slash": [23, 34], "slateblu": 22, "slateblue1": 22, "slateblue2": 22, "slateblue3": 22, "slateblue4": 22, "slategrai": 22, "slategray1": 22, "slategray2": 22, "slategray3": 22, "slategray4": 22, "slategrei": 22, "sleep": [26, 56], "slerp": 37, "slice": [37, 42, 43, 68, 71], "slight": [62, 67], "slightli": [17, 21, 26, 27, 37, 40, 41, 50, 52, 56, 58, 62, 67, 71, 72, 73], "slope": 25, "sloppi": 27, "slot": [0, 26], "slow": [48, 52, 63, 65, 68, 70, 71, 73], "slower": [40, 52, 53, 56, 58, 70, 71], "slowest": [44, 52, 73], "slowli": 37, "small": [20, 23, 24, 28, 29, 33, 37, 40, 41, 44, 45, 62, 66, 68, 70, 71, 73, 75], "smaller": [20, 24, 32, 36, 39, 45, 52, 71], "smallest": [24, 30, 52, 63], "smart": 70, "smooth": [28, 37, 62], "smoother": 70, "smoothli": [37, 58, 70], "smoothscal": [27, 58], "smoothscale_bi": 58, "smoothstep": 37, "sn9c101": 20, "snakeviz": 71, "snapshot": 65, "sndarrai": [17, 27, 39, 49, 66], "snow": 22, "snow1": 22, "snow2": 22, "snow3": 22, "snow4": 22, "so": [11, 17, 19, 20, 21, 23, 24, 25, 27, 29, 31, 32, 33, 34, 37, 39, 42, 43, 44, 45, 50, 51, 52, 53, 54, 55, 58, 60, 62, 63, 66, 67, 68, 69, 71, 72, 73, 74, 75, 76, 77], "sobr": 78, "socket": [74, 77], "soften": 68, "softwar": [17, 20, 24, 31, 38, 48, 51, 52, 60, 62, 66, 78], "solarwolf": 66, "solid": [25, 28, 31, 50, 51, 52, 53, 58, 68, 71], "solid_overlai": 58, "solo": 78, "solt\u00f3": 78, "solut": [71, 73], "solv": [28, 39, 69, 71], "some": [17, 20, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 35, 37, 38, 39, 40, 42, 44, 45, 46, 51, 54, 58, 60, 62, 63, 64, 65, 66, 67, 68, 69, 71, 72, 73, 74, 75, 76, 77], "someimag": 27, "someth": [17, 20, 25, 27, 40, 54, 60, 63, 65, 66, 67, 68, 70, 71, 72, 73], "sometim": [23, 24, 44, 54, 67, 71], "somewhat": [27, 67, 71], "somewher": 67, "son": 78, "sonido": 78, "sonix": 20, "soon": [41, 44, 60, 67, 76], "sophist": [74, 75], "soporta": 78, "sorri": [63, 65], "sort": [24, 26, 27, 51, 54, 62, 63, 67, 70, 71, 72, 77], "sound": [8, 17, 27, 41, 61, 62, 66, 67, 69, 71, 74, 78], "sound_array_demo": 27, "soundfont": 39, "sourc": [17, 20, 27, 32, 38, 39, 42, 43, 48, 50, 51, 52, 58, 62, 66, 67, 69, 70, 71, 72, 74, 77, 78], "source_rect": 51, "south": 23, "southeast": 23, "southwest": 23, "space": [21, 28, 29, 32, 34, 38, 42, 48, 52, 54, 70], "sparingli": 48, "speak": [73, 74], "speaker": 39, "special": [20, 23, 24, 26, 30, 34, 36, 39, 43, 51, 52, 58, 63, 67, 68, 70, 71, 73], "special_flag": [48, 50, 51, 52, 72], "specif": [17, 24, 26, 28, 29, 30, 34, 36, 37, 39, 43, 46, 48, 50, 51, 52, 53, 54, 62, 63, 65, 67, 68, 70, 71], "specifi": [14, 20, 22, 24, 25, 28, 29, 30, 32, 33, 36, 37, 38, 39, 41, 44, 45, 46, 47, 48, 51, 52, 54, 58, 60, 63, 68, 77], "sped": 25, "speed": [27, 29, 44, 52, 56, 66, 67, 70, 71, 73, 75, 76, 77], "spend": 71, "spent": [66, 71], "spheric": 37, "spill": 25, "spin": [27, 61, 62, 76, 77, 78], "split": [23, 29, 61, 62, 66, 67, 71, 78], "sport": 66, "spread": 71, "spring": 58, "springgreen": 22, "springgreen1": 22, "springgreen2": 22, "springgreen3": 22, "springgreen4": 22, "sprite": [17, 27, 36, 51, 61, 69, 71, 76, 77], "sprite1": 51, "sprite2": 51, "sprite_dict": 51, "sprite_height": 70, "sprite_list": 51, "sprite_width": 70, "spritecollid": [51, 67, 75], "spritecollideani": 51, "spritedict": 67, "sprites_click": 71, "sqr": 30, "sqrt": [30, 37], "squar": [25, 30, 33, 37], "squeez": 71, "sr": 33, "src": 68, "src_c": [0, 11, 14], "srcalpha": [36, 43, 52, 72], "srcalphafactor": 48, "srccolorfactor": 48, "srccolorkei": 52, "srcobj": 12, "srcrect": [12, 48], "sse": [54, 58], "sse2": [54, 58], "sse3": 54, "sse41": 54, "sse42": 54, "stabil": 34, "stabl": [17, 43, 54], "stage": 65, "stai": [68, 69], "stand": [27, 52], "standard": [1, 23, 24, 26, 39, 41, 43, 44, 45, 46, 51, 58, 59, 60, 62, 63, 65, 66, 67, 68, 69, 71], "star": 27, "starfield": 27, "start": [1, 19, 20, 21, 25, 26, 27, 29, 30, 31, 33, 34, 36, 39, 40, 41, 42, 44, 45, 47, 48, 51, 52, 61, 62, 63, 65, 66, 67, 68, 69, 70, 71, 73, 74, 76, 77, 78], "start_angl": [25, 31], "start_index": 68, "start_po": 25, "start_text_input": 34, "startup": [8, 39], "state": [24, 26, 27, 29, 32, 33, 34, 38, 39, 40, 46, 47, 51, 52, 54, 60, 61, 62, 67, 71, 76, 77, 78], "statement": [71, 77], "static": [47, 48, 51], "stationari": [67, 71], "statu": [27, 33, 38, 54], "stderr": 55, "stdin": 68, "stdout": 55, "steelblu": 22, "steelblue1": 22, "steelblue2": 22, "steelblue3": 22, "steelblue4": 22, "stencil": 24, "step": [17, 31, 33, 42, 62, 68, 72, 76], "stereo": [24, 39, 49], "stick": [33, 47, 54, 68, 70, 71], "still": [24, 26, 32, 39, 40, 43, 46, 47, 48, 52, 62, 65, 66, 67, 68, 69, 70, 71, 73, 76, 77], "stop": [1, 20, 25, 31, 33, 34, 39, 40, 41, 44, 47, 56, 65, 67, 70, 71, 76, 77], "stop_angl": [25, 31], "stop_rumbl": [33, 47], "stop_text_input": 34, "store": [9, 23, 24, 29, 30, 31, 36, 39, 41, 48, 51, 52, 53, 54, 58, 62, 67, 70], "str": [19, 20, 21, 24, 28, 29, 33, 34, 38, 39, 44, 46, 47, 49, 53, 54, 59, 60], "straight": [25, 31, 52, 66, 68, 70, 72, 74], "straighten": 70, "straightforward": [66, 70], "strain": 72, "strang": [24, 66], "stream": [17, 38, 39, 48, 66], "strength": [29, 33, 47], "stress": [66, 71], "stretch": [24, 27, 28, 29, 48], "strict": [20, 69, 71], "strictli": [31, 59, 73], "stride": [19, 32, 42], "strike": 29, "strikethrough": 28, "string": [3, 10, 16, 19, 20, 21, 23, 24, 26, 28, 29, 32, 33, 34, 38, 39, 41, 44, 46, 49, 52, 53, 54, 55, 58, 59, 60, 71, 74, 75], "stringifi": 21, "strip": 52, "stripe": 68, "stroke": 25, "strong": 29, "strongli": [24, 51], "struct": [1, 4, 5, 6, 8, 10, 19, 29, 42, 43, 52, 53], "structur": [8, 11, 43, 73, 75, 76], "stub": 45, "stuck": 70, "studi": [68, 75], "studio": 66, "stuff": [46, 65, 68, 69, 70], "stump": 71, "style": [26, 27, 28, 29, 33, 42, 66, 74], "style_default": 29, "style_nam": [28, 29], "style_norm": 29, "style_obliqu": 29, "style_strong": 29, "style_underlin": 29, "style_wid": 29, "su": 78, "suavidad": 78, "suavizado": 78, "sub": [48, 51, 71], "subarrai": 42, "subclass": [2, 3, 4, 5, 6, 8, 12, 15, 19, 21, 36, 37, 39, 45, 51, 52, 60], "subdirectori": [27, 62, 72], "subdirectorio": 78, "subject": [17, 24, 30, 44], "submask": 36, "submit": 71, "submodul": [44, 55], "subpackag": 55, "subprocess": 55, "subprocess_ignor": 55, "subscrib": 59, "subscript": [37, 42], "subsect": 70, "subsequ": [24, 65], "subset": [23, 24, 28, 71], "substanti": 71, "substitut": [20, 23], "substr": 38, "subsubsurfac": 52, "subsurfac": [13, 52, 58], "subtract": [50, 77], "subview": 42, "succe": [20, 24, 52], "succeed": 20, "success": [1, 2, 3, 5, 9, 12, 24, 26, 44, 71], "successfulli": [33, 47], "suceder\u00e1": 78, "sudden": 66, "suel": 78, "suffix": 45, "suficientemnt": 78, "suggest": [24, 42, 62, 71], "sugier": 78, "suit": [39, 52, 63], "suitabl": [24, 28, 29, 66, 74], "sum": 25, "suministr\u00f3": 78, "summari": 67, "summer": 66, "super": [27, 36, 48, 60, 67], "superclass": 37, "superior": 52, "suppli": [20, 36, 38, 39, 54, 62, 65, 68, 73], "support": [1, 6, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 47, 48, 49, 50, 51, 52, 53, 54, 56, 58, 59, 60, 62, 63, 65, 66, 71, 75], "suppos": [58, 71], "supposedli": 71, "suppress": 60, "sure": [11, 30, 51, 56, 62, 65, 66, 67, 68, 70, 71, 77], "surf": [3, 23, 27, 29, 31, 32, 42, 51, 52, 58, 60], "surfac": [0, 1, 2, 3, 11, 13, 17, 20, 21, 23, 24, 25, 27, 28, 29, 31, 32, 36, 37, 40, 43, 45, 48, 50, 51, 52, 54, 60, 61, 62, 63, 65, 66, 67, 70, 72, 73, 77, 78], "surface_dest": 51, "surface_to_arrai": 43, "surfarrai": [17, 19, 27, 43, 52, 53, 66, 71], "surfdemo_show": 68, "surflock": 0, "surfobj": 13, "surpris": [66, 70], "surrog": [16, 29], "surround": [39, 58, 73], "suspend": 71, "sutilment": 78, "svg": [18, 32], "svgalib": 24, "swap": [24, 32, 42, 45, 60], "swap_interv": 24, "swatch": 21, "swig": 66, "switch": [23, 24, 29, 44, 51, 63, 77], "switch_lay": 51, "swizzl": [21, 37], "swsurfac": 52, "sy": [16, 44, 55, 66, 70, 74, 77], "symbol": 34, "symmetri": 37, "sync": 24, "synchron": [38, 48], "synchronis": 24, "synonym": 26, "syntax": [68, 71], "syntaxerror": 44, "synthes": 38, "sysfont": [28, 29, 33], "sysrq": 34, "system": [16, 17, 20, 23, 24, 26, 27, 28, 29, 33, 34, 37, 38, 39, 40, 41, 44, 48, 49, 52, 53, 55, 58, 60, 63, 71, 73, 76], "system_cursor_arrow": 23, "system_cursor_crosshair": 23, "system_cursor_hand": 23, "system_cursor_ibeam": 23, "system_cursor_no": 23, "system_cursor_sizeal": 23, "system_cursor_sizen": 23, "system_cursor_sizenesw": 23, "system_cursor_sizenws": 23, "system_cursor_sizew": 23, "system_cursor_wait": 23, "system_cursor_waitarrow": 23, "systemexit": [60, 74, 77], "s\u00ed": 78, "t": [5, 10, 17, 20, 24, 25, 26, 27, 28, 29, 30, 33, 34, 37, 41, 44, 46, 48, 49, 50, 51, 52, 53, 54, 56, 58, 60, 62, 65, 66, 67, 68, 69, 70, 72, 73, 74, 75, 76, 77], "ta": 69, "tab": [34, 60], "tabl": [24, 43], "tackl": 71, "tag": [41, 55], "taka": 20, "takafumi": 20, "take": [5, 16, 23, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 41, 42, 45, 50, 51, 52, 54, 55, 58, 62, 63, 65, 66, 67, 68, 71, 73, 74, 76, 77], "taken": [3, 22, 24, 27, 37, 39, 40, 58, 75], "tal": 78, "talk": 70, "tama\u00f1o": 78, "tambi\u00e9n": 78, "tan": 22, "tan1": 22, "tan2": 22, "tan3": 22, "tan4": 22, "tango": 29, "tank": 71, "target": [29, 37, 42, 43, 45, 48, 51, 58, 61, 62, 67, 78], "target_textur": 48, "task": [60, 63, 74], "tau": 25, "teach": 70, "teal": 22, "team": 29, "tear": 24, "techniqu": [51, 71], "tecla": 78, "tell": [10, 39, 40, 44, 52, 62, 63, 67, 70, 71, 76], "temp": 9, "templat": 71, "temporari": [58, 68], "temporarili": [25, 34, 39, 41, 48, 52, 53], "tempt": 71, "temptat": 71, "ten": 56, "tenemo": 78, "tener": 78, "tenni": [76, 77], "term": [67, 70, 71, 73], "termin": [1, 26, 38, 44, 62, 70, 78], "terminologi": [40, 71, 72], "terrain1": 70, "terrain2": 70, "test": [17, 24, 26, 27, 28, 29, 30, 32, 33, 34, 37, 39, 40, 44, 45, 47, 51, 52, 54, 58, 62, 63, 64, 68, 72], "testin": 38, "testout": 38, "testsprit": 27, "text": [26, 27, 28, 29, 33, 34, 46, 61, 71, 72, 73, 75, 78], "text_color": 28, "text_font": 72, "textedit": [26, 34], "textinput": [26, 34], "textmarker_str": 23, "textpo": [61, 62, 73, 78], "textur": [31, 48], "texture_or_imag": 48, "textured_polygon": 31, "tga": [32, 66], "than": [17, 20, 21, 24, 25, 26, 27, 28, 29, 31, 32, 33, 34, 36, 37, 38, 39, 41, 44, 45, 47, 51, 52, 53, 54, 56, 57, 58, 60, 62, 63, 64, 65, 66, 67, 68, 70, 71, 72, 73, 74, 75, 76, 77], "thank": 76, "the_dirty_rectangl": 71, "thecorruptor": 18, "thei": [1, 11, 17, 20, 23, 24, 25, 26, 27, 28, 29, 30, 33, 36, 37, 39, 40, 44, 45, 46, 47, 48, 50, 51, 52, 54, 58, 62, 63, 66, 67, 68, 70, 71, 72, 74, 75, 76, 77], "them": [17, 18, 23, 26, 27, 28, 30, 32, 33, 34, 35, 36, 39, 42, 44, 45, 48, 49, 51, 52, 53, 62, 63, 65, 66, 68, 70, 71, 73, 74, 75, 76, 77], "themselv": [26, 52, 67, 69, 73], "theorem": 37, "theori": [20, 71], "therefor": [25, 31, 36, 48, 51, 60, 67, 70, 71, 75], "theta": 37, "thi": [1, 2, 3, 4, 5, 6, 9, 10, 11, 12, 13, 15, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78], "thick": [25, 28], "thickarrow_str": 23, "thin": 62, "thing": [26, 41, 44, 48, 62, 63, 64, 65, 66, 67, 68, 69, 70, 73, 75], "think": [20, 21, 24, 67, 68, 70, 71, 77], "third": [19, 20, 23, 31, 37, 48, 66, 68, 70, 73], "thirteen": 17, "thistl": 22, "thistle1": 22, "thistle2": 22, "thistle3": 22, "thistle4": 22, "thorough": 77, "those": [17, 20, 23, 26, 27, 28, 29, 36, 40, 42, 43, 48, 51, 65, 67, 68, 69, 70, 71, 74, 75, 76, 77], "though": [20, 24, 31, 38, 39, 43, 55, 68, 69, 71, 73, 74, 75, 76, 77], "thought": 71, "thousand": 49, "thread": [10, 20, 24, 26, 27, 28, 31, 39, 40, 51, 55, 65], "three": [33, 37, 39, 44, 52, 53, 59, 67, 68, 71, 73, 76], "threshold": [36, 42, 51, 58], "throttl": 33, "through": [2, 20, 26, 28, 29, 32, 33, 36, 38, 39, 44, 51, 52, 56, 62, 66, 67, 69, 70, 71, 72, 73, 76], "throughout": 35, "throw": [41, 70], "thrown": [58, 77], "thru": 66, "thu": [37, 42, 75], "thumbnail": 27, "ti": [41, 78], "tick": [17, 23, 25, 33, 40, 56, 61, 62, 70, 71, 77, 78], "tick_busy_loop": 56, "tie": 65, "tienen": 78, "tif": 32, "tiff": [32, 46], "tile": 70, "time": [14, 17, 20, 23, 24, 25, 26, 27, 28, 29, 33, 34, 35, 38, 39, 40, 41, 45, 48, 49, 51, 52, 54, 55, 58, 60, 62, 63, 65, 66, 68, 69, 71, 72, 73, 74, 75, 77, 78], "time_m": 51, "time_out": 55, "time_proc": 38, "timeout": 26, "timer": [5, 38, 56], "timer_resolut": 35, "timestamp": 38, "tini": [24, 71], "tip": [17, 67, 71, 72], "tipicament": 78, "tipo": 78, "titl": [24, 41, 60, 62, 66], "tl": 77, "to_surfac": [36, 48], "tobyt": 32, "toda": 78, "todav\u00eda": 78, "todo": 67, "togeth": [24, 34, 39, 48, 50, 58, 66, 68, 69, 72, 74], "toggl": [23, 47], "toggle_fullscreen": 24, "toler": [33, 37], "tom": [74, 77], "toma": 78, "tomar": 78, "tomato": 22, "tomato1": 22, "tomato2": 22, "tomato3": 22, "tomato4": 22, "tomchanc": [74, 77], "tompong": [69, 77], "tone": [38, 41], "too": [5, 25, 26, 29, 37, 42, 45, 51, 52, 55, 62, 68, 70, 71, 73], "took": 66, "tool": [27, 71, 72, 75], "tool_tip_surf": 72, "tool_tip_text": 72, "top": [17, 24, 25, 27, 28, 29, 30, 32, 36, 39, 40, 45, 51, 52, 60, 66, 70, 71, 73, 74, 77], "topic": [17, 71], "topleft": [24, 36, 42, 45, 48, 51, 52, 58, 60, 61, 62, 70, 77, 78], "toplevel": 39, "topmost": 51, "topright": [45, 77], "tort": 20, "tortur": 71, "tostr": 32, "total": [39, 43, 44, 55, 70, 71, 74], "touch": [26, 33, 44, 71], "touch_id": 26, "touchid": 57, "toward": [24, 33, 37, 66, 69, 71], "tr": 77, "trabajar": 78, "trabajo": 78, "traceback": [68, 74], "track": [17, 24, 51, 56, 65, 67, 70, 71], "trackbal": [7, 26, 47], "trackpad": 44, "tradition": 23, "traducci\u00f3n": 78, "trail": [55, 66], "transfer": [17, 46, 48, 58, 68, 69], "transform": [17, 20, 29, 30, 61, 62, 65, 66, 68, 70, 78], "translat": [9, 16, 27, 29, 34, 42, 48], "transmiss": 38, "transpar": [24, 25, 27, 28, 29, 32, 36, 43, 50, 52, 53, 58, 60, 62, 66, 70, 71, 72, 74], "transparent": 78, "transpos": 42, "trap": 60, "travel": 77, "trav\u00e9": 78, "tre": 78, "treat": [24, 29, 33, 53, 68], "tree": 65, "trend": 66, "tri": [33, 44, 66, 70, 71, 74], "tri_left": 23, "tri_right": 23, "trial": 71, "triangl": [25, 27, 31, 33, 48], "trick": [71, 77], "tricki": [67, 68, 71], "trickier": 68, "trigger": [33, 34, 40, 41, 47], "trigon": 31, "trigonometri": 75, "tripl": [26, 58], "triplet": [24, 31, 62], "troubl": 71, "true": [2, 3, 4, 5, 6, 8, 10, 12, 14, 15, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 44, 45, 46, 47, 48, 51, 52, 54, 55, 58, 60, 61, 62, 64, 65, 66, 67, 70, 71, 72, 73, 75, 77, 78], "truetyp": [17, 28, 62, 66, 78], "truli": 71, "truncat": [25, 31, 39, 45, 68], "truth": [54, 67], "truthi": 45, "try": [24, 26, 29, 44, 52, 60, 62, 66, 67, 68, 69, 70, 71, 73, 74, 77], "ttf": [28, 29, 72], "tune": [29, 67], "tupl": [3, 9, 19, 21, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 42, 44, 45, 48, 49, 51, 52, 53, 55, 58, 60, 68, 70, 71], "turn": [17, 29, 38, 58, 61, 62, 67, 70, 71, 78], "turquois": 22, "turquoise1": 22, "turquoise2": 22, "turquoise3": 22, "turquoise4": 22, "tutori": [27, 52, 61, 66, 69, 71, 73, 77], "tweak": 67, "twice": [51, 52, 68], "twitch": 71, "two": [1, 17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 36, 37, 38, 39, 42, 43, 45, 47, 49, 51, 52, 54, 55, 56, 58, 59, 62, 66, 67, 68, 70, 71, 72, 73, 75], "tx": 31, "txt": 59, "ty": 31, "type": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15, 16, 17, 19, 21, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 49, 51, 52, 53, 54, 56, 58, 59, 60, 61, 62, 63, 65, 66, 68, 70, 71, 72, 73, 75, 76, 77, 78], "type1": 29, "type42": 29, "typeerror": [25, 28, 39, 43, 45, 51, 52], "typehint": 17, "typelist": 26, "typestr": 19, "typic": [20, 24, 38, 52, 62], "t\u00edtulo": 78, "u": [16, 17, 19, 24, 34, 37, 54, 62, 66, 68, 70, 71, 78], "u00000001": 28, "u0001": 28, "u0010ffff": 28, "u4": 19, "uc": [16, 28, 29], "ucs4": [28, 29], "uffff": [16, 28], "ufo": 66, "ufunc": 68, "ui": 27, "uikit": 60, "uint": 68, "uint32": [1, 3, 5], "uint8": [1, 3], "uk": [74, 77], "ultim": 17, "un": [17, 78], "una": 78, "unabl": [32, 46, 67], "unalt": [44, 71], "unari": 21, "unavail": [24, 60], "unawar": 44, "unchang": [16, 21, 24, 29], "uncommit": 44, "uncommon": 54, "uncompress": [32, 39], "undefin": [29, 68], "under": [17, 38, 40, 41, 60, 66, 70, 74, 77], "underli": [28, 29, 33, 38, 39, 41, 44, 48, 71], "underlin": [28, 29], "underline_adjust": 29, "underneath": [28, 68], "underscor": [34, 62], "understand": [17, 50, 63, 66, 67, 68, 69, 70, 71, 73, 74, 76, 77], "undesir": 25, "undetermin": 54, "unencod": 44, "unfamiliar": [70, 71], "unfil": [31, 36], "unfilt": 58, "unfortun": [55, 71], "unicod": [16, 26, 28, 29, 34, 39, 44, 46, 52], "unicode_escap": 44, "unicodeencodeerror": [29, 44], "unicodeerror": 28, "uniniti": [20, 24, 28, 33, 38, 39, 44, 47], "union": [45, 67, 71], "union_ip": 45, "unional": 45, "unionall_ip": 45, "uniqu": [30, 33, 34, 51, 52, 54, 60, 70], "unit": [29, 44, 52, 54], "unix": [23, 24, 66], "unk": 44, "unknown": [24, 26, 33, 54], "unless": [6, 24, 29, 32, 46, 52, 56, 58, 60, 62, 67, 70, 75, 76], "unlik": [17, 29, 39, 43, 48, 52, 68, 76], "unload": 41, "unlock": [25, 52], "unmap": 43, "unmap_rgb": [21, 43, 52, 53], "unmodifi": 20, "unnecessari": [49, 53], "unnot": 34, "uno": 78, "unoutlin": 28, "unpack": [21, 37, 40], "unpaus": [39, 41], "unplay": [24, 66], "unpleas": 70, "unpredict": 29, "unpunch": [61, 62, 78], "unreal": 66, "unrealist": 77, "unrecogn": [28, 32], "unrel": [24, 60], "unscal": 29, "unset": [29, 36, 52, 77], "unsetcolor": 36, "unsetsurfac": 36, "unsign": [1, 19, 21, 36, 39, 52, 68], "unspecifi": [29, 37], "unstructur": 52, "unsupport": [20, 41], "until": [20, 24, 25, 26, 33, 36, 38, 41, 47, 52, 54, 56, 60, 61, 65, 67, 70, 71, 73, 76], "untransform": 29, "unus": [32, 39, 51], "unwieldi": 71, "up": [17, 18, 20, 23, 24, 25, 26, 28, 31, 33, 34, 38, 39, 40, 41, 42, 44, 47, 51, 52, 54, 62, 64, 67, 68, 70, 71, 72, 73, 74, 75, 76, 78], "updat": [12, 17, 21, 24, 25, 26, 30, 33, 34, 37, 40, 44, 45, 47, 48, 51, 52, 54, 56, 60, 61, 63, 64, 66, 67, 69, 70, 71, 73, 75, 76, 77, 78], "update_rect": 27, "upload": 48, "upon": [28, 60, 77], "upper": [26, 29, 33, 65], "uppercas": 21, "upscal": 18, "upstream_logo": 18, "us": [0, 1, 5, 9, 10, 11, 14, 16, 17, 18, 19, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 54, 55, 56, 58, 60, 61, 62, 63, 66, 67, 68, 69, 70, 73, 74, 75, 76, 77, 78], "usa": 78, "usabl": [21, 32, 65], "usada": 78, "usado": 78, "usag": [24, 32, 37, 38, 44, 48, 52, 55, 72], "usamo": 78, "usando": 78, "usar": 78, "usarlo": 78, "usar\u00e1": 78, "usb": 38, "use_alpha": 27, "use_arraytyp": [49, 53], "use_bitmap_strik": 29, "use_compat": 34, "use_fastrendergroup": 27, "use_stat": 27, "user": [17, 20, 24, 25, 26, 28, 34, 38, 44, 46, 48, 52, 54, 55, 59, 60, 62, 66, 67, 68, 69, 71, 73, 75], "userev": [26, 39], "usr": [27, 61, 73, 74, 75], "usual": [24, 26, 28, 29, 33, 39, 44, 51, 52, 60, 62, 63, 64, 66, 67, 68, 70, 74, 78], "usualment": 78, "usuario": 78, "utf": [16, 26, 28, 29, 46], "util": [56, 60, 66, 71], "utilizada": 17, "uv": 48, "uxxxxxxxx": [16, 29], "v": [19, 21, 34, 37], "v1": 44, "v2": [1, 41], "v3": 19, "v4l2": [20, 65], "va": 78, "val": [1, 3, 28, 68], "val1": 1, "val2": 1, "valid": [19, 24, 28, 39, 40, 45, 48, 52, 65, 67], "valor": 78, "valu": [1, 3, 9, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 58, 59, 60, 62, 63, 67, 68, 70, 71, 72, 73, 76, 77], "value_to_set": 44, "valueerror": [19, 23, 25, 27, 29, 31, 32, 34, 36, 37, 43, 46, 48, 49, 52, 53, 58, 60, 65, 68], "valv": 54, "vamo": 78, "van": 78, "vari": [39, 72], "variabl": [19, 23, 24, 28, 33, 38, 39, 41, 44, 55, 60, 62, 65, 66, 67, 68, 70, 77, 78], "variant": [18, 23, 59], "variat": 71, "varieti": [26, 66, 71], "variou": [1, 17, 23, 26, 27, 35, 37, 77], "vast": 32, "ve": [17, 25, 33, 62, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77], "vea": 78, "veas\u00e9": 78, "vec": 37, "vece": 78, "vector": [25, 31, 36, 69, 77], "vector2": [17, 25, 30, 31, 36, 37, 45, 52, 59], "vector3": 37, "vectorelementwiseproxi": 37, "veloc": 38, "vemo": 78, "ventana": 78, "ver": [44, 78], "vera": 29, "verd": 78, "verdadera": 78, "verdadero": 78, "verdana": 72, "verduzco": 78, "veri": [20, 24, 27, 38, 40, 48, 56, 58, 62, 64, 66, 67, 68, 70, 71, 72, 75, 76, 77], "verifi": 24, "verifica": 78, "verificamo": 78, "verificar": 78, "vernum": 44, "versatil": [47, 58], "version": [0, 12, 19, 21, 24, 26, 27, 28, 29, 31, 32, 34, 37, 39, 41, 43, 45, 51, 52, 54, 58, 60, 62, 64, 65, 66, 67, 69, 70, 71, 72, 74, 77], "versi\u00f3n": 78, "versu": 53, "vertex": 48, "vertic": [20, 24, 25, 27, 29, 30, 31, 32, 40, 42, 48, 58, 62, 68, 70, 78], "ver\u00e1": 78, "vez": 78, "vflip": [20, 65], "vgl": 24, "vgrade": [27, 68], "via": [20, 24, 29, 36, 44, 46, 48, 65, 71], "vidcaptur": 20, "video": [17, 24, 26, 27, 33, 44, 46, 48, 52, 60, 63, 65, 67], "video0": [20, 65], "video_mem": [24, 63], "videodriv": 24, "videoexpos": [24, 26], "videoinfo": 63, "videomod": 60, "videores": [24, 26], "vidinfo": [24, 63], "vieja": 78, "view": [1, 2, 17, 42, 52], "view_p": 1, "viewport": 48, "vimo": 78, "violet": 22, "violetr": 22, "violetred1": 22, "violetred2": 22, "violetred3": 22, "violetred4": 22, "virtual": [24, 27, 38, 40, 45], "visibilic": 78, "visibl": [19, 23, 24, 40, 51, 62, 63, 66, 70, 72, 78], "vision": [17, 20], "visit": 66, "vista": [24, 44], "visual": [50, 71], "visualis": 75, "visualizaci\u00f3n": 78, "vivant": 60, "vline": 31, "void": [1, 5, 9, 13], "volatil": 52, "voltear": 78, "volum": [17, 39, 41, 66], "volver": 78, "vram": 48, "vsync": [24, 48], "vsync_success": 24, "vulkan": 60, "w": [9, 24, 26, 27, 31, 34, 36, 37, 42, 43, 45, 48, 52, 59], "wa": [5, 10, 17, 18, 21, 23, 24, 25, 26, 27, 28, 32, 33, 34, 36, 38, 39, 40, 41, 42, 43, 44, 47, 48, 50, 52, 56, 58, 60, 62, 65, 66, 67, 68, 70, 71, 74, 76], "wai": [3, 5, 20, 24, 25, 26, 27, 28, 29, 32, 33, 34, 39, 40, 43, 44, 47, 48, 51, 52, 54, 55, 62, 64, 66, 67, 68, 69, 70, 72, 73, 75, 76, 77], "wait": [23, 24, 26, 33, 38, 40, 56, 62, 71], "waitarrow": 23, "walk": [61, 62, 78], "wall": [37, 65, 77], "want": [1, 10, 17, 20, 21, 24, 26, 30, 32, 33, 34, 37, 41, 44, 51, 52, 56, 58, 60, 62, 63, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77], "warn": [24, 30, 44, 61, 78], "warranti": 20, "warrior": 66, "was_init": 29, "wasm": 56, "wasn": 66, "wast": [71, 75], "watch": [17, 65, 69, 73], "wav": [39, 41, 46, 61, 62, 78], "wave": 49, "wavelength": 58, "wavpack": 39, "wayland": [23, 24, 40, 60], "we": [17, 23, 25, 27, 30, 33, 52, 54, 58, 60, 62, 64, 65, 66, 67, 68, 70, 72, 73, 74, 75, 76, 77], "weak": [13, 19, 71], "web": [27, 56, 61], "webcam": 20, "webp": [18, 32, 61, 62, 66, 68, 70, 78], "websit": 66, "week": 66, "weight": [21, 42, 58, 68], "weird": 34, "welcom": [17, 44], "well": [1, 2, 23, 25, 31, 32, 34, 40, 42, 44, 47, 48, 52, 53, 66, 67, 68, 69, 70, 71, 77], "were": [1, 11, 18, 24, 26, 28, 34, 51, 55, 66, 67, 70, 71, 74, 77], "west": 23, "wh": 24, "what": [17, 21, 23, 24, 25, 27, 28, 30, 33, 37, 39, 40, 44, 46, 48, 51, 54, 62, 63, 64, 65, 66, 67, 68, 69, 73, 74, 76, 77], "whatev": [51, 62, 65, 67, 69, 71], "wheat": 22, "wheat1": 22, "wheat2": 22, "wheat3": 22, "wheat4": 22, "wheel": [24, 40], "when": [5, 13, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 34, 37, 38, 39, 40, 41, 42, 44, 45, 46, 48, 49, 50, 51, 52, 53, 54, 55, 56, 58, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78], "whenev": [24, 39, 40, 44, 68], "where": [11, 17, 19, 21, 23, 24, 25, 26, 27, 29, 31, 32, 34, 36, 37, 39, 40, 41, 42, 44, 46, 47, 51, 52, 53, 55, 58, 62, 65, 67, 68, 70, 71, 72, 73, 76, 77], "wherea": [24, 45, 75], "wherev": [18, 26, 68], "whether": [20, 24, 26, 27, 28, 29, 30, 36, 39, 40, 45, 46, 48, 54, 58, 60, 69, 70, 71, 73], "which": [1, 3, 5, 16, 17, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 58, 59, 62, 63, 64, 66, 67, 68, 69, 70, 72, 73, 74, 75, 76, 77], "whiff": [61, 62, 78], "whiff_sound": [61, 62, 78], "while": [0, 17, 19, 23, 25, 26, 28, 31, 32, 33, 37, 39, 40, 41, 42, 43, 44, 45, 48, 49, 51, 52, 54, 56, 58, 60, 61, 65, 66, 67, 68, 70, 71, 72, 73, 75, 77, 78], "whilst": 24, "white": [22, 23, 25, 33, 36, 42, 62, 65, 73], "whitesmok": 22, "whitespac": 69, "who": [17, 48, 67, 69, 70, 74, 77], "whole": [24, 25, 38, 44, 52, 70, 71, 75], "whoop": 70, "whose": [32, 41, 42, 45, 54, 57, 58], "why": [17, 44, 66, 71, 75], "wide": [25, 28, 29, 36, 44, 50, 66, 70], "wider": [20, 34], "widget": 27, "width": [1, 9, 20, 23, 24, 25, 27, 28, 29, 30, 32, 33, 36, 42, 45, 48, 51, 52, 58, 60, 63, 66, 70, 71], "width_height": 52, "wiki": [24, 40, 48], "wikipedia": [24, 37, 72], "win": [1, 60, 61, 62, 78], "win32": 38, "windib": 24, "window": [0, 1, 4, 17, 20, 26, 27, 28, 29, 33, 34, 35, 38, 39, 40, 44, 46, 48, 52, 54, 62, 63, 66, 70, 71, 73, 76, 78], "window1": 60, "window2": 60, "window_surfac": 24, "windowclos": [26, 60], "windowdisplaychang": 26, "windowent": 26, "windowev": 24, "windowevent_minim": 24, "windowexpos": 26, "windowfocusgain": [26, 60], "windowfocuslost": [26, 60], "windowhidden": 26, "windowhittest": 26, "windowiccprofchang": 26, "windowleav": 26, "windowmaxim": 26, "windowminim": 26, "windowmov": 26, "windowpos_cent": 60, "windowpos_undefin": 60, "windowres": 26, "windowrestor": 26, "windowshown": 26, "windowsizechang": 26, "windowtakefocu": 26, "wipe": 17, "wire": 33, "wireless": 33, "wisdom": 68, "wise": [29, 68], "wish": 74, "within": [19, 23, 29, 30, 34, 36, 37, 44, 51, 52, 58, 70, 71], "without": [17, 20, 23, 24, 25, 29, 30, 32, 33, 37, 39, 42, 45, 50, 51, 52, 53, 60, 62, 63, 66, 67, 68, 70, 71, 76, 77], "wm": [24, 63], "won": [41, 51, 58, 60, 62, 67, 68, 69, 70, 71, 72, 74, 75, 76], "wonder": [65, 71], "word": [28, 29, 37, 46, 56, 67, 70, 76], "word_wrap": 29, "work": [17, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 42, 43, 45, 46, 48, 50, 51, 52, 53, 55, 58, 60, 62, 63, 65, 66, 67, 68, 69, 70, 73, 75, 77], "world": [65, 71], "worri": [27, 51, 67, 68, 71], "wors": 62, "worst": 69, "worth": [52, 56], "would": [19, 23, 25, 26, 28, 30, 32, 36, 37, 39, 44, 51, 52, 54, 56, 58, 62, 64, 65, 66, 67, 68, 69, 70, 71, 73, 75, 76, 77], "wrap": [2, 4, 10, 19, 23, 28, 31, 42, 44, 48, 52, 60, 66], "wraplength": [28, 33, 72], "wrapper": [10, 71], "wrestl": 27, "writabl": 19, "write": [1, 10, 19, 27, 29, 38, 42, 52, 58, 66, 69, 71, 74, 75], "write_short": 38, "write_sys_ex": 38, "writeabl": 54, "written": [17, 25, 28, 44, 64, 66, 67, 69, 71, 74, 75], "wrong": [39, 58, 68, 71], "wrote": 71, "wu": 25, "wv": 39, "www": 24, "x": [2, 4, 5, 6, 8, 9, 12, 15, 17, 18, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 36, 37, 38, 40, 42, 44, 45, 47, 48, 49, 51, 52, 53, 57, 58, 59, 60, 63, 70, 71, 73, 75, 77, 78], "x00": [16, 28, 59], "x01": 59, "x1": [25, 31, 45], "x10": 38, "x11": [24, 38, 40, 44, 46, 60], "x12": 38, "x13": 38, "x2": [25, 31, 45], "x3": [25, 31], "x7d": 38, "x86": 58, "x_offset": 36, "x_y": 52, "xbm": 23, "xbox": 47, "xcf": 32, "xf0": 38, "xf7": 38, "xfade": 68, "xiaolin": 25, "xor": 23, "xormask": [23, 40], "xpm": 32, "xwayland": 24, "xx": 23, "xxx": 23, "xxxx": 23, "xxxx_test": 55, "xxxxx": 23, "xy": [24, 37, 77], "xyyx": 37, "xyyzzz": 37, "xz": 37, "y": [9, 17, 21, 23, 24, 25, 26, 28, 29, 30, 31, 33, 34, 36, 37, 40, 42, 44, 45, 47, 48, 49, 51, 52, 53, 57, 58, 59, 60, 61, 62, 70, 71, 73, 75, 76, 77, 78], "y1": [25, 31, 45], "y2": [25, 31, 45], "y3": [25, 31], "y_offset": 36, "ya": 78, "ye": [68, 73], "year": [66, 71], "yellow": 22, "yellow1": 22, "yellow2": 22, "yellow3": 22, "yellow4": 22, "yellowgreen": 22, "yet": [29, 48, 60, 68, 71, 76], "yield": 48, "you": [1, 10, 11, 17, 18, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 37, 38, 39, 40, 41, 42, 44, 45, 46, 48, 50, 51, 52, 54, 56, 58, 60, 62, 63, 64, 65, 66, 67, 68, 69, 73, 74, 75, 76, 77], "your": [17, 18, 20, 23, 24, 26, 27, 31, 32, 34, 38, 41, 44, 46, 54, 56, 58, 60, 62, 63, 64, 65, 66, 68, 69, 72, 73, 74, 75, 76, 77], "yourself": [51, 62, 66, 68, 74, 75], "youtub": 17, "yup": 71, "yuv": [20, 65], "yx": 37, "yxzxzyzxyx": 37, "yyi": 37, "z": [34, 37, 75, 77], "zero": [21, 25, 28, 29, 37, 38, 39, 45, 52, 63, 67, 68, 77], "zip": [18, 71], "zl": 33, "zoom": 27, "zr": 33, "zxyxzzyx": 37, "zyx": 37, "\u00e1rea": 78, "\u00e9l": 78, "\u00e9sta": 78, "\u00e9ste": 78, "\u00faltimo": 78, "\u00fanicament": 78, "\u00fanico": 78, "\u03c0": 37}, "titles": ["pygame C API", "High level API exported by pygame.base", "Class BufferProxy API exported by pygame.bufferproxy", "Class Color API exported by pygame.color", "API exported by pygame.display", "API exported by pygame.event", "API exported by pygame._freetype", "API exported by pygame.joystick", "API exported by pygame.mixer", "Class Rect API exported by pygame.rect", "API exported by pygame.rwobject", "Slots and c_api - Making functions and data available from other modules", "Class Surface API exported by pygame.surface", "API exported by pygame.surflock", "API exported by pygame.version", "Class Window API exported by pygame.window", "File Path Function Arguments", "Pygame-ce Front Page", "Pygame CE Logos Page", "pygame.BufferProxy", "pygame.camera", "pygame.Color", "Named Colors", "pygame.cursors", "pygame.display", "pygame.draw", "pygame.event", "pygame.examples", "pygame.font", "pygame.freetype", "pygame.geometry", "pygame.gfxdraw", "pygame.image", "pygame.joystick", "pygame.key", "pygame.locals", "pygame.mask", "pygame.math", "pygame.midi", "pygame.mixer", "pygame.mouse", "pygame.mixer.music", "pygame.PixelArray", "pygame.pixelcopy", "pygame", "pygame.Rect", "pygame.scrap", "pygame._sdl2.controller", "pygame.sdl2_video", "pygame.sndarray", "special flags", "pygame.sprite", "pygame.Surface", "pygame.surfarray", "pygame.system", "pygame.tests", "pygame.time", "pygame._sdl2.touch", "pygame.transform", "pygame.typing", "pygame.Window", "pygame/examples/chimp.py", "Pygame Tutorials - Line By Line Chimp Example", "Pygame Tutorials - Setting Display Modes", "Pygame Tutorials - Import and Initialize", "Pygame Tutorials - Camera Module Introduction", "Pygame Intro", "Pygame Tutorials - Sprite Module Introduction", "Pygame Tutorials - Surfarray Introduction", "Making Games With Pygame", "Pygame Tutorials - Help! How Do I Move An Image?", "A Newbie Guide to pygame", "Pygame Tutorials - What is Premultiplied Alpha?", "Revision: Pygame fundamentals", "Kicking things off", "Game object classes", "User-controllable objects", "Putting it all together", "Tutorial de Pygame - Ejemplo del Chimpanc\u00e9, L\u00ednea Por L\u00ednea"], "titleterms": {"": 70, "0": 33, "1": [33, 69, 73, 74, 75, 76, 77], "2": [33, 70, 73, 74, 75, 77], "24": 33, "3": [73, 74, 76, 77], "360": 33, "4": [33, 73, 75], "5": [73, 76], "6": 77, "A": [69, 70, 71, 75, 76], "AND": 66, "Be": 71, "By": 62, "It": 70, "On": [62, 70], "One": 70, "The": [62, 67, 70, 73, 74, 77], "To": 70, "With": 69, "_freetyp": 6, "_sdl2": [47, 57], "about": 54, "access": [42, 49, 53], "actualizar": 78, "ad": 70, "addit": 54, "advanc": [67, 68], "advic": 71, "after": 33, "all": [62, 70, 77], "alpha": [71, 72], "an": [19, 70], "api": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15], "ar": [50, 70, 71], "architectur": 71, "argument": 16, "arrai": [19, 43, 53], "audio": 41, "avail": 11, "axi": 33, "back": 70, "background": [62, 70], "ball": [75, 77], "base": 1, "basic": [51, 63, 65, 73], "bat": [76, 77], "blend": 72, "blit": [70, 73], "bother": 71, "bucl": 78, "buffer": 19, "bufferproxi": 2, "bufferproxypygam": 19, "c": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15], "c_api": 11, "camera": [20, 65], "camerapygam": 20, "captur": 65, "carga": 78, "ce": [17, 18], "center": 62, "centrar": 78, "chang": 70, "chimp": [61, 62], "chimpanc\u00e9": 78, "circl": 30, "clase": 78, "class": [2, 3, 9, 12, 15, 37, 51, 62, 67, 75, 76], "clipboard": 46, "close": 66, "code": 69, "collis": [67, 71], "color": [3, 21, 22], "colorkei": 71, "colorpygam": 21, "colorspac": 65, "comfort": 71, "common": [33, 59, 67], "completa": 78, "composit": 72, "comput": [29, 65], "con": 33, "connect": 65, "constant": 35, "contain": 44, "content": 69, "context": 54, "control": [24, 33, 41, 47, 65, 76], "controllerpygam": 47, "convert": 71, "coordin": [45, 70], "copi": 43, "crear": 78, "creat": [62, 70], "cursor": 23, "cursorspygam": 23, "da": 73, "data": [11, 49, 53], "de": 78, "decid": 63, "definit": 70, "del": 78, "design": 71, "detect": [67, 71], "dibujar": 78, "direct": 42, "displai": [4, 24, 62, 63], "displaypygam": 24, "distract": 71, "divers": [75, 76], "do": [70, 71], "document": 17, "don": 71, "draw": [25, 31, 62], "drawpygam": 25, "ejemplo": 78, "el": 78, "en": 78, "entir": 62, "entrada": 78, "escena": 78, "event": [5, 26, 62, 71, 73, 76], "evento": 78, "eventpygam": 26, "everyth": 62, "exampl": [27, 61, 62, 63, 68], "examplesmodul": 27, "experiment": 17, "export": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15, 19], "extend": 67, "file": 16, "fin": 78, "finish": [62, 77], "first": [70, 74], "flag": 50, "fondo": 78, "font": [28, 29], "fontpygam": 28, "freetypepygam": 29, "friend": 71, "from": [11, 70], "front": 17, "function": [11, 16, 63, 68, 70, 74], "fundament": 73, "game": [51, 62, 66, 69, 71, 73, 75], "gamepad": 33, "gener": 43, "geometrypygam": 30, "get": 71, "gfxdrawpygam": 31, "go": 70, "graduat": 68, "group": 67, "guid": 71, "handl": [62, 70, 74], "help": 70, "here": 70, "hero": 70, "high": 1, "histori": [66, 67], "hit": 77, "how": [63, 70, 72], "i": [70, 71, 72], "imag": [32, 36, 52, 65, 70], "imagepygam": 32, "import": [62, 64, 65, 68], "importaci\u00f3n": 78, "improv": 70, "inform": 44, "inicializar": 78, "init": [64, 65], "initi": [62, 64], "input": [38, 57, 62, 70], "interact": [26, 33, 38], "interfac": 53, "intro": 66, "introducci\u00f3n": 78, "introduct": [62, 63, 65, 66, 67, 68, 69, 72], "issu": 71, "joi": 33, "joystick": [7, 33], "joystickpygam": 33, "juego": 78, "just": 70, "keyboard": 34, "keypygam": 34, "kick": 74, "know": 71, "la": 78, "left": 33, "legaci": 18, "lesson": 67, "let": [70, 77], "level": [1, 44], "line": [30, 62, 74], "list": [50, 65, 70], "live": 65, "lo": 78, "load": [28, 29, 39, 62, 74], "localspygam": 35, "lock": 68, "logo": 18, "loop": [62, 73, 78], "l\u00ednea": 78, "main": [62, 78], "make": [11, 69, 70], "manag": 71, "manejar": 78, "mani": 67, "map": [33, 70], "mask": [36, 65], "maskpygam": 36, "mathpygam": 37, "midi": 38, "midipygam": 38, "mientra": 78, "mix": 67, "mixer": [8, 41], "mixerpygam": 39, "mode": 63, "modul": [11, 17, 20, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 34, 36, 37, 38, 39, 40, 41, 43, 44, 46, 47, 49, 51, 53, 54, 56, 57, 58, 59, 62, 65, 66, 67, 74], "monitor": 56, "more": [68, 70], "mostrar": 78, "mous": 40, "mousepygam": 40, "move": 70, "movement": 70, "multipl": 70, "musicpygam": 41, "mysteri": 70, "m\u00f3dulo": 78, "name": 22, "need": 71, "newbi": 71, "next": 70, "nintendo": 33, "note": 69, "numer": 68, "numpi": 68, "object": [19, 21, 30, 42, 45, 51, 52, 60, 62, 73, 75, 76], "objeto": 78, "obsolet": 71, "off": 74, "option": 71, "other": [11, 68], "outdat": 71, "output": 38, "over": 62, "overview": 66, "own": [67, 70], "packag": [44, 55], "page": [17, 18], "para": 78, "part": 71, "path": 16, "pattern": 71, "perfect": 71, "physic": 75, "pixel": [42, 43, 53, 70, 71], "pixelarraypygam": 42, "pixelcopypygam": 43, "plai": 39, "playstat": 33, "polygon": 30, "por": 78, "premultipli": 72, "prepar": [62, 70], "preparar": 78, "princip": 78, "pro": 33, "problem": 67, "product": 77, "program": 27, "protocol": 19, "provid": [54, 59], "put": [62, 70, 77], "py": [14, 61], "pygam": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 76, 78], "pygameth": 44, "python": [66, 68, 71], "pythoni": 71, "queue": 26, "quick": 17, "quit": 64, "realli": 71, "recogn": 71, "rect": [9, 71], "rectangular": 45, "rectpygam": 45, "recurso": 78, "refer": 17, "render": [28, 29, 67], "repres": [52, 60], "represent": 21, "resourc": [23, 62, 74], "revis": 73, "right": 33, "rwobject": 10, "sampl": 49, "scene": 62, "scrappygam": 46, "screen": [24, 70], "sdl": 33, "sdl2_video": 48, "set": 63, "setup": [62, 78], "shape": [25, 31], "side": [71, 77], "simpl": [75, 76], "singl": 65, "slot": 11, "smooth": 70, "sndarraypygam": 49, "so": 70, "softwar": 71, "some": 70, "sound": [39, 49], "special": 50, "sprite": [62, 67, 75, 78], "spritepygam": 51, "src_c": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 15], "src_py": 14, "start": 17, "step": 70, "store": 45, "stream": [41, 65], "style": 69, "subsystem": 71, "suit": 55, "support": 46, "surfac": [12, 19, 42, 53, 58, 68, 71], "surfacepygam": 52, "surfarrai": 68, "surfarraypygam": 53, "surflock": 13, "switch": 33, "system": 54, "systempygam": 54, "t": 71, "ta": 73, "tabl": 69, "take": 70, "tast": 66, "termina": 78, "test": 55, "testspygam": 55, "text": 62, "texto": 78, "them": 67, "thing": [71, 74], "threshold": 65, "through": 19, "time": [56, 70], "timepygam": 56, "todo": 78, "togeth": [67, 70, 77], "top": 44, "touch": 57, "touchpygam": 57, "trackbal": 33, "transfer": 32, "transform": 58, "transformpygam": 58, "transpar": 68, "tutori": [17, 62, 63, 64, 65, 67, 68, 70, 72, 78], "type": 67, "typehint": 59, "typingpygam": 59, "unit": 55, "updat": 62, "upstream": 18, "us": [20, 53, 65, 71, 72], "user": [70, 76], "v": 71, "vector": [37, 75], "version": [14, 44], "versionsmal": 44, "vision": 65, "wai": 71, "wari": 71, "what": [50, 70, 71, 72], "which": 71, "while": 62, "why": 72, "window": [15, 24, 60], "windowpygam": 60, "work": [34, 40, 47, 57, 71], "would": 72, "x": 33, "xbox": 33, "you": [70, 71, 72], "your": [67, 70, 71]}}) \ No newline at end of file +Search.setIndex({"alltitles": {"-New Input is new Event": [[70, "new-input-is-new-event"]], "-Setting for Animation": [[69, "setting-for-animation"]], "-\uc0c8\ub85c\uc6b4 \uc785\ub825\uc740 \uc0c8\ub85c\uc6b4 \uc774\ubca4\ud2b8": [[78, "id2"]], "-\ud654\uba74\uc774 \uc6c0\uc9c1\uc774\uae30 \uc704\ud55c \uc870\uac74": [[77, "id2"]], "1. Introduction": [[61, "introduction"]], "1.1. A note on coding styles": [[61, "a-note-on-coding-styles"]], "2. Revision: Pygame fundamentals": [[85, "makegames-2"]], "2.1. The basic Pygame game": [[85, "the-basic-pygame-game"]], "2.2. Basic Pygame objects": [[85, "basic-pygame-objects"]], "2.3. Blitting": [[85, "blitting"]], "2.4. The event loop": [[85, "the-event-loop"]], "2.5. Ta-da!": [[85, "ta-da"]], "3. Kicking things off": [[86, "makegames-3"]], "3.1. The first lines, and loading modules": [[86, "the-first-lines-and-loading-modules"]], "3.2. Resource handling functions": [[86, "resource-handling-functions"]], "4. Game object classes": [[87, "makegames-4"]], "4.1. A simple ball class": [[87, "a-simple-ball-class"]], "4.1.1. Diversion 1: Sprites": [[87, "diversion-1-sprites"]], "4.1.2. Diversion 2: Vector physics": [[87, "diversion-2-vector-physics"]], "5. User-controllable objects": [[88, "makegames-5"]], "5.1. A simple bat class": [[88, "a-simple-bat-class"]], "5.1.1. Diversion 3: Pygame events": [[88, "diversion-3-pygame-events"]], "6. Putting it all together": [[89, "makegames-6"]], "6.1. Let the ball hit sides": [[89, "let-the-ball-hit-sides"]], "6.2. Let the ball hit bats": [[89, "let-the-ball-hit-bats"]], "6.3. The Finished product": [[89, "the-finished-product"]], "A Newbie Guide to pygame": [[84, "a-newbie-guide-to-pygame"]], "API exported by pygame._freetype": [[6, null]], "API exported by pygame.display": [[4, null]], "API exported by pygame.event": [[5, null]], "API exported by pygame.mixer": [[7, null]], "API exported by pygame.rwobject": [[9, null]], "API exported by pygame.surflock": [[12, null]], "API exported by pygame.version": [[13, null]], "Adding the User Input": [[62, "adding-the-user-input"]], "Author: Youngwook Kim (Korean)": [[67, null], [68, null], [69, null], [70, null], [71, null], [72, null], [73, null], [74, null], [75, null], [76, null], [77, null], [78, null], [79, null], [80, null], [81, null], [82, null]], "Basic Computer Vision": [[57, "basic-computer-vision"]], "Basic INPUT": [[70, "basic-input"]], "Basic PROCESS": [[69, "basic-process"]], "Basic TEMPLATE and OUTPUT": [[68, "basic-template-and-output"]], "Be wary of outdated, obsolete, and optional advice.": [[84, "be-wary-of-outdated-obsolete-and-optional-advice"]], "CLOSING": [[63, "closing"]], "Camera Module Introduction": [[57, "camera-module-introduction"]], "Capturing a Live Stream": [[57, "capturing-a-live-stream"]], "Capturing a Single Image": [[57, "capturing-a-single-image"]], "Changing The Background": [[62, "changing-the-background"]], "Class BufferProxy API exported by pygame.bufferproxy": [[2, null]], "Class Color API exported by pygame.color": [[3, null]], "Class Rect API exported by pygame.rect": [[8, null]], "Class Surface API exported by pygame.surface": [[11, null]], "Collision Detection": [[64, "collision-detection"]], "Colorkey vs. Alpha.": [[84, "colorkey-vs-alpha"]], "Colorspaces": [[57, "colorspaces"]], "Common Controller Axis Mappings": [[32, "common-controller-axis-mappings"]], "Common Problems": [[64, "common-problems"]], "Contact: rumia0601@gmail.com": [[67, "contact-rumia0601-gmail-com"], [68, "contact-rumia0601-gmail-com"], [69, "contact-rumia0601-gmail-com"], [70, "contact-rumia0601-gmail-com"], [71, "contact-rumia0601-gmail-com"], [72, "contact-rumia0601-gmail-com"], [73, "contact-rumia0601-gmail-com"], [74, "contact-rumia0601-gmail-com"], [75, "contact-rumia0601-gmail-com"], [76, "contact-rumia0601-gmail-com"], [77, "contact-rumia0601-gmail-com"], [78, "contact-rumia0601-gmail-com"], [79, "contact-rumia0601-gmail-com"], [80, "contact-rumia0601-gmail-com"], [81, "contact-rumia0601-gmail-com"], [82, "contact-rumia0601-gmail-com"]], "Create The Background": [[58, "create-the-background"]], "Creating A Map": [[62, "creating-a-map"]], "Definition: \"blit\"": [[62, "definition-blit"]], "Display The Background While Setup Finishes": [[58, "display-the-background-while-setup-finishes"]], "Do things the pythony way.": [[84, "do-things-the-pythony-way"]], "Documents": [[15, "documents"]], "Don't bother with pixel-perfect collision detection.": [[84, "don-t-bother-with-pixel-perfect-collision-detection"]], "Don't get distracted by side issues.": [[84, "don-t-get-distracted-by-side-issues"]], "Draw The Entire Scene": [[58, "draw-the-entire-scene"]], "Epilog": [[74, "epilog"]], "Examples": [[59, "examples"], [65, "examples"]], "Extending Your Own Classes (Advanced)": [[64, "extending-your-own-classes-advanced"]], "File Path Function Arguments": [[14, null]], "First, The Mystery Functions": [[62, "first-the-mystery-functions"]], "Functions": [[59, "functions"]], "Game Object Classes": [[58, "game-object-classes"]], "Game Over": [[58, "game-over"]], "Game object classes": [[87, null]], "Get comfortable working in Python.": [[84, "get-comfortable-working-in-python"]], "Going From The List To The Screen": [[62, "going-from-the-list-to-the-screen"]], "Graduation": [[65, "graduation"]], "HISTORY": [[63, "history"]], "Handle All Input Events": [[58, "handle-all-input-events"]], "Handling Some Input": [[62, "handling-some-input"]], "Help! How Do I Move An Image?": [[62, "help-how-do-i-move-an-image"]], "High level API exported by pygame.base": [[1, null]], "History Lesson": [[64, "history-lesson"]], "How to Decide": [[59, "how-to-decide"]], "Import": [[60, "import"]], "Import Modules": [[58, "import-modules"]], "Import Surfarray": [[65, "import-surfarray"]], "Import and Init": [[57, "import-and-init"]], "Import and Initialize": [[60, "import-and-initialize"]], "Init": [[60, "init"]], "Initialize Everything": [[58, "initialize-everything"]], "Introduction": [[58, "introduction"], [59, "introduction"], [65, "introduction"]], "Just Pixels On The Screen": [[62, "just-pixels-on-the-screen"]], "Kicking things off": [[86, null]], "Know what a surface is.": [[84, "know-what-a-surface-is"]], "Legacy logos": [[16, "legacy-logos"]], "Let's Go Back A Step": [[62, "let-s-go-back-a-step"]], "Line By Line Chimp": [[58, "line-by-line-chimp"]], "Listing Connected Cameras": [[57, "listing-connected-cameras"]], "Loading Resources": [[58, "loading-resources"]], "Main Loop": [[58, "main-loop"]], "Making Games With Pygame": [[61, null], [61, "id1"]], "Making The Hero Move": [[62, "making-the-hero-move"]], "Making The Hero Move (Take 2)": [[62, "making-the-hero-move-take-2"]], "Managing the event subsystem.": [[84, "managing-the-event-subsystem"]], "Mixing Them Together": [[64, "mixing-them-together"]], "More Advanced NumPy": [[65, "more-advanced-numpy"]], "Moving Multiple Images": [[62, "moving-multiple-images"]], "Named Colors": [[21, null]], "Newbie Guide to Pygame": [[84, null]], "Nintendo Switch Left Joy-Con (pygame 2.x)": [[32, "nintendo-switch-left-joy-con-pygame-2-x"]], "Nintendo Switch Pro Controller (pygame 2.x)": [[32, "nintendo-switch-pro-controller-pygame-2-x"]], "Nintendo Switch Right Joy-Con (pygame 2.x)": [[32, "nintendo-switch-right-joy-con-pygame-2-x"]], "NumPy": [[65, "numpy"]], "Other Surfarray Functions": [[65, "other-surfarray-functions"]], "PYTHON AND GAMING": [[63, "python-and-gaming"]], "Playstation 4 Controller (pygame 1.x)": [[32, "playstation-4-controller-pygame-1-x"]], "Playstation 4 Controller (pygame 2.x)": [[32, "playstation-4-controller-pygame-2-x"]], "Playstation 5 Controller (pygame 2.x)": [[32, "playstation-5-controller-pygame-2-x"]], "Prepare Game Object": [[58, "prepare-game-object"]], "Preparing for Improved User Input": [[62, "preparing-for-improved-user-input"]], "Prolog? Why Pygame?": [[67, "prolog-why-pygame"]], "Put Text On The Background, Centered": [[58, "put-text-on-the-background-centered"]], "Putting It All Together": [[62, "putting-it-all-together"]], "Putting it all Together One More time": [[62, "putting-it-all-together-one-more-time"]], "Putting it all together": [[89, null]], "Pygame Front Page": [[15, null]], "Pygame Intro": [[63, null]], "Pygame Logos": [[16, "pygame-logos"]], "Pygame Logos Page": [[16, null]], "Pygame Modules Overview": [[63, "pygame-modules-overview"]], "Pygame Tutorials - Camera Module Introduction": [[57, null]], "Pygame Tutorials - Help! How Do I Move An Image?": [[62, null]], "Pygame Tutorials - Import and Initialize": [[60, null]], "Pygame Tutorials - Line By Line Chimp Example": [[58, null]], "Pygame Tutorials - Setting Display Modes": [[59, null]], "Pygame Tutorials - Sprite Module Introduction": [[64, null]], "Pygame Tutorials - Surfarray Introduction": [[65, null]], "Python Pygame Introduction": [[63, "python-pygame-introduction"]], "Quick start": [[15, "quick-start"]], "Quit": [[60, "quit"]], "Recognize which parts of pygame you really need.": [[84, "recognize-which-parts-of-pygame-you-really-need"]], "Rects are your friends.": [[84, "rects-are-your-friends"]], "Reference": [[15, "reference"]], "Revision: Pygame fundamentals": [[85, null]], "Screen Coordinates": [[62, "screen-coordinates"]], "Setting Basics": [[59, "setting-basics"]], "Setting Display Modes": [[59, "setting-display-modes"]], "Slots and c_api - Making functions and data available from other modules": [[10, null]], "Smooth Movement": [[62, "smooth-movement"]], "So, What Next?": [[62, "so-what-next"]], "Software architecture, design patterns, and games.": [[84, "software-architecture-design-patterns-and-games"]], "Sprite Module Introduction": [[64, "sprite-module-introduction"]], "Surface Locking": [[65, "surface-locking"]], "Surfarray Introduction": [[65, "surfarray-introduction"], [65, "id1"]], "TASTE": [[63, "taste"]], "Table of Contents": [[61, "table-of-contents"]], "The Classes": [[64, "the-classes"]], "The Group Class": [[64, "the-group-class"]], "The Many Group Types": [[64, "the-many-group-types"]], "The Rendering Groups": [[64, "the-rendering-groups"]], "The Sprite Class": [[64, "the-sprite-class"]], "There is NO rule six.": [[84, "there-is-no-rule-six"]], "Thresholding": [[57, "thresholding"]], "Transparency": [[65, "transparency"]], "Tutorials": [[15, "tutorials"]], "Update the Sprites": [[58, "update-the-sprites"]], "Use Surface.convert().": [[84, "use-surface-convert"]], "User-controllable objects": [[88, null]], "Using Camera Controls": [[57, "using-camera-controls"]], "Using the Mask Module": [[57, "using-the-mask-module"]], "XBox 360 Controller (pygame 1.x)": [[32, "xbox-360-controller-pygame-1-x"]], "XBox 360 Controller (pygame 2.x)": [[32, "xbox-360-controller-pygame-2-x"]], "You Are On Your Own From Here": [[62, "you-are-on-your-own-from-here"]], "and plus alpha": [[73, "and-plus-alpha"]], "pygame C API": [[0, null]], "pygame.BufferProxypygame object to export a surface buffer through an array protocol": [[17, null]], "pygame.Colorpygame object for color representations": [[20, null]], "pygame.Overlaypygame object for video overlay graphics": [[41, null]], "pygame.PixelArraypygame object for direct pixel access of surfaces": [[42, null]], "pygame.Rectpygame object for storing rectangular coordinates": [[45, null]], "pygame.Surfacepygame object for representing images": [[51, null]], "pygame._sdl2.controllerPygame module to work with controllers.": [[47, null]], "pygame._sdl2.touchpygame module to work with touch input": [[55, null]], "pygame.camerapygame module for camera use": [[18, null]], "pygame.cdrompygame module for audio cdrom control": [[19, null]], "pygame.cursorspygame module for cursor resources": [[22, null]], "pygame.displaypygame module to control the display window and screen": [[23, null]], "pygame.drawpygame module for drawing shapes": [[24, null]], "pygame.eventpygame module for interacting with events and queues": [[25, null]], "pygame.examplesmodule of example programs": [[26, null]], "pygame.fasteventpygame module for interacting with events and queues": [[27, null]], "pygame.fontpygame module for loading and rendering fonts": [[28, null]], "pygame.freetypeEnhanced pygame module for loading and rendering computer fonts": [[29, null]], "pygame.gfxdrawpygame module for drawing shapes": [[30, null]], "pygame.imagepygame module for image transfer": [[31, null]], "pygame.joystickPygame module for interacting with joysticks, gamepads, and trackballs.": [[32, null]], "pygame.keypygame module to work with the keyboard": [[33, null]], "pygame.localspygame constants": [[34, null]], "pygame.maskpygame module for image masks.": [[35, null]], "pygame.mathpygame module for vector classes": [[36, null]], "pygame.midipygame module for interacting with midi input and output.": [[37, null]], "pygame.mixer.musicpygame module for controlling streamed audio": [[40, null]], "pygame.mixerpygame module for loading and playing sounds": [[38, null]], "pygame.mousepygame module to work with the mouse": [[39, null]], "pygame.pixelcopypygame module for general pixel array copying": [[43, null]], "pygame.scrappygame module for clipboard support.": [[46, null]], "pygame.sdl2_video": [[48, null]], "pygame.sndarraypygame module for accessing sound sample data": [[49, null]], "pygame.spritepygame module with basic game object classes": [[50, null]], "pygame.surfarraypygame module for accessing surface pixel data using array interfaces": [[52, null]], "pygame.testsPygame unit test suite package": [[53, null]], "pygame.timepygame module for monitoring time": [[54, null]], "pygame.transformpygame module to transform surfaces": [[56, null]], "pygame.versionsmall module containing version information": [[44, "module-pygame.version"]], "pygame/examples/chimp.py": [[66, null]], "pygamethe top level pygame package": [[44, null]], "src_c/_freetype.c": [[6, "src-c-freetype-c"]], "src_c/base.c": [[1, "src-c-base-c"]], "src_c/bufferproxy.c": [[2, "src-c-bufferproxy-c"]], "src_c/color.c": [[3, "src-c-color-c"]], "src_c/display.c": [[4, "src-c-display-c"]], "src_c/event.c": [[5, "src-c-event-c"]], "src_c/mixer.c": [[7, "src-c-mixer-c"]], "src_c/rect.c": [[8, "src-c-rect-c"]], "src_c/rwobject.c": [[9, "src-c-rwobject-c"]], "src_c/surface.c": [[11, "src-c-surface-c"]], "src_c/surflock.c": [[12, "src-c-surflock-c"]], "src_py/version.py": [[13, "src-py-version-py"]], "with Advanced OUTPUT \u2013 Buttons": [[72, "with-advanced-output-buttons"]], "with Advanced PROCESS - Functionalization": [[71, "with-advanced-process-functionalization"]], "\u2013 \uc65c \ud558\ud544 \ud30c\uc774\uac8c\uc784?": [[75, "id2"]], "\u2013Into Event-driven and GUI": [[68, "into-event-driven-and-gui"]], "\u2013\uc774\ubca4\ud2b8 \uae30\ubc18\uacfc GUI \uae30\ubc18\uc73c\ub85c\uc758 \uc785\ubb38": [[76, "gui"]], "\uadf8\ub9ac\uace0 \uc2ec\ud654 \ucc98\ub9ac - \ud568\uc218\ud654": [[79, "id1"]], "\uadf8\ub9ac\uace0 \uc2ec\ud654 \ucd9c\ub825 \u2013 \ubc84\ud2bc": [[80, "id1"]], "\uadf8\ub9ac\uace0 \uc870\uae08 \ub354!": [[81, "id1"]], "\uae30\ubcf8 \ud615\uc2dd\uacfc \uae30\ucd08 \ucd9c\ub825": [[76, "id1"]], "\uae30\ucd08 \uc785\ub825": [[78, "id1"]], "\uae30\ucd08 \ucc98\ub9ac": [[77, "id1"]], "\uc5d0\ud544\ub85c\uadf8": [[82, "id1"]], "\ud504\ub864\ub85c\uadf8": [[75, "id1"]], "\ud55c\uad6d\uc5b4 \ud29c\ud1a0\ub9ac\uc5bc": [[83, null], [83, "id2"]]}, "docnames": ["c_api", "c_api/base", "c_api/bufferproxy", "c_api/color", "c_api/display", "c_api/event", "c_api/freetype", "c_api/mixer", "c_api/rect", "c_api/rwobject", "c_api/slots", "c_api/surface", "c_api/surflock", "c_api/version", "filepaths", "index", "logos", "ref/bufferproxy", "ref/camera", "ref/cdrom", "ref/color", "ref/color_list", "ref/cursors", "ref/display", "ref/draw", "ref/event", "ref/examples", "ref/fastevent", "ref/font", "ref/freetype", "ref/gfxdraw", "ref/image", "ref/joystick", "ref/key", "ref/locals", "ref/mask", "ref/math", "ref/midi", "ref/mixer", "ref/mouse", "ref/music", "ref/overlay", "ref/pixelarray", "ref/pixelcopy", "ref/pygame", "ref/rect", "ref/scrap", "ref/sdl2_controller", "ref/sdl2_video", "ref/sndarray", "ref/sprite", "ref/surface", "ref/surfarray", "ref/tests", "ref/time", "ref/touch", "ref/transform", "tut/CameraIntro", "tut/ChimpLineByLine", "tut/DisplayModes", "tut/ImportInit", "tut/MakeGames", "tut/MoveIt", "tut/PygameIntro", "tut/SpriteIntro", "tut/SurfarrayIntro", "tut/chimp.py", "tut/en/Red_or_Black/1.Prolog/introduction", "tut/en/Red_or_Black/2.Print_text/Basic TEMPLATE and OUTPUT", "tut/en/Red_or_Black/3.Move_text/Basic PROCESS", "tut/en/Red_or_Black/4.Control_text/Basic INPUT", "tut/en/Red_or_Black/5.HP_bar/Advanced OUTPUT with Advanced PROCESS", "tut/en/Red_or_Black/6.Buttons/Advanced INPUT with Advanced OUTPUT", "tut/en/Red_or_Black/7.Game_board/Advanced OUTPUT and plus alpha", "tut/en/Red_or_Black/8.Epilog/Epilog", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/1.\ud504\ub864\ub85c\uadf8/\uc18c\uac1c", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/2.\ud14d\uc2a4\ud2b8 \ucd9c\ub825/\uae30\ucd08 \ud15c\ud50c\ub9bf\uacfc \ucd9c\ub825", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/3.\ud14d\uc2a4\ud2b8 \uc774\ub3d9/\uae30\ucd08 \ucc98\ub9ac", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/4.\ud14d\uc2a4\ud2b8 \uc870\uc885/\uae30\ucd08 \uc785\ub825", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/5.HP\ubc14/\uc2ec\ud654 \ucd9c\ub825 \uadf8\ub9ac\uace0 \uc2ec\ud654 \ucc98\ub9ac", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/6.\ubc84\ud2bc\ub4e4/\uc2ec\ud654 \uc785\ub825 \uadf8\ub9ac\uace0 \uc2ec\ud654 \ucd9c\ub825", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/7.\uac8c\uc784\ud310/\uc2ec\ud654 \ucd9c\ub825 \uadf8\ub9ac\uace0 \uc870\uae08 \ub354", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/8.\uc5d0\ud544\ub85c\uadf8/\uc5d0\ud544\ub85c\uadf8", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/\uac1c\uc694", "tut/newbieguide", "tut/tom_games2", "tut/tom_games3", "tut/tom_games4", "tut/tom_games5", "tut/tom_games6"], "envversion": {"sphinx": 63, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["c_api.rst", "c_api/base.rst", "c_api/bufferproxy.rst", "c_api/color.rst", "c_api/display.rst", "c_api/event.rst", "c_api/freetype.rst", "c_api/mixer.rst", "c_api/rect.rst", "c_api/rwobject.rst", "c_api/slots.rst", "c_api/surface.rst", "c_api/surflock.rst", "c_api/version.rst", "filepaths.rst", "index.rst", "logos.rst", "ref/bufferproxy.rst", "ref/camera.rst", "ref/cdrom.rst", "ref/color.rst", "ref/color_list.rst", "ref/cursors.rst", "ref/display.rst", "ref/draw.rst", "ref/event.rst", "ref/examples.rst", "ref/fastevent.rst", "ref/font.rst", "ref/freetype.rst", "ref/gfxdraw.rst", "ref/image.rst", "ref/joystick.rst", "ref/key.rst", "ref/locals.rst", "ref/mask.rst", "ref/math.rst", "ref/midi.rst", "ref/mixer.rst", "ref/mouse.rst", "ref/music.rst", "ref/overlay.rst", "ref/pixelarray.rst", "ref/pixelcopy.rst", "ref/pygame.rst", "ref/rect.rst", "ref/scrap.rst", "ref/sdl2_controller.rst", "ref/sdl2_video.rst", "ref/sndarray.rst", "ref/sprite.rst", "ref/surface.rst", "ref/surfarray.rst", "ref/tests.rst", "ref/time.rst", "ref/touch.rst", "ref/transform.rst", "tut/CameraIntro.rst", "tut/ChimpLineByLine.rst", "tut/DisplayModes.rst", "tut/ImportInit.rst", "tut/MakeGames.rst", "tut/MoveIt.rst", "tut/PygameIntro.rst", "tut/SpriteIntro.rst", "tut/SurfarrayIntro.rst", "tut/chimp.py.rst", "tut/en/Red_or_Black/1.Prolog/introduction.rst", "tut/en/Red_or_Black/2.Print_text/Basic TEMPLATE and OUTPUT.rst", "tut/en/Red_or_Black/3.Move_text/Basic PROCESS.rst", "tut/en/Red_or_Black/4.Control_text/Basic INPUT.rst", "tut/en/Red_or_Black/5.HP_bar/Advanced OUTPUT with Advanced PROCESS.rst", "tut/en/Red_or_Black/6.Buttons/Advanced INPUT with Advanced OUTPUT.rst", "tut/en/Red_or_Black/7.Game_board/Advanced OUTPUT and plus alpha.rst", "tut/en/Red_or_Black/8.Epilog/Epilog.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/1.\ud504\ub864\ub85c\uadf8/\uc18c\uac1c.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/2.\ud14d\uc2a4\ud2b8 \ucd9c\ub825/\uae30\ucd08 \ud15c\ud50c\ub9bf\uacfc \ucd9c\ub825.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/3.\ud14d\uc2a4\ud2b8 \uc774\ub3d9/\uae30\ucd08 \ucc98\ub9ac.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/4.\ud14d\uc2a4\ud2b8 \uc870\uc885/\uae30\ucd08 \uc785\ub825.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/5.HP\ubc14/\uc2ec\ud654 \ucd9c\ub825 \uadf8\ub9ac\uace0 \uc2ec\ud654 \ucc98\ub9ac.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/6.\ubc84\ud2bc\ub4e4/\uc2ec\ud654 \uc785\ub825 \uadf8\ub9ac\uace0 \uc2ec\ud654 \ucd9c\ub825.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/7.\uac8c\uc784\ud310/\uc2ec\ud654 \ucd9c\ub825 \uadf8\ub9ac\uace0 \uc870\uae08 \ub354.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/8.\uc5d0\ud544\ub85c\uadf8/\uc5d0\ud544\ub85c\uadf8.rst", "tut/ko/\ube68\uac04\ube14\ub85d \uac80\uc740\ube14\ub85d/\uac1c\uc694.rst", "tut/newbieguide.rst", "tut/tom_games2.rst", "tut/tom_games3.rst", "tut/tom_games4.rst", "tut/tom_games5.rst", "tut/tom_games6.rst"], "indexentries": {"__dict__ (pygame.event.event attribute)": [[25, "pygame.event.Event.__dict__", false]], "_pixels_address (pygame.surface attribute)": [[51, "pygame.Surface._pixels_address", false]], "a (pygame.color attribute)": [[20, "pygame.Color.a", false]], "aacircle() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.aacircle", false]], "aaellipse() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.aaellipse", false]], "aaline() (in module pygame.draw)": [[24, "pygame.draw.aaline", false]], "aalines() (in module pygame.draw)": [[24, "pygame.draw.aalines", false]], "aapolygon() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.aapolygon", false]], "aatrigon() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.aatrigon", false]], "abort() (pygame.midi.output method)": [[37, "pygame.midi.Output.abort", false]], "add() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.add", false]], "add() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.add", false]], "add() (pygame.sprite.sprite method)": [[50, "pygame.sprite.Sprite.add", false]], "aliens.main() (in module pygame.examples)": [[26, "pygame.examples.aliens.main", false]], "alive() (pygame.sprite.sprite method)": [[50, "pygame.sprite.Sprite.alive", false]], "alpha (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.alpha", false]], "alpha (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.alpha", false]], "angle (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.angle", false]], "angle() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.angle", false]], "angle_to() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.angle_to", false]], "angle_to() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.angle_to", false]], "antialiased (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.antialiased", false]], "arc() (in module pygame.draw)": [[24, "pygame.draw.arc", false]], "arc() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.arc", false]], "array() (in module pygame.sndarray)": [[49, "pygame.sndarray.array", false]], "array2d() (in module pygame.surfarray)": [[52, "pygame.surfarray.array2d", false]], "array3d() (in module pygame.surfarray)": [[52, "pygame.surfarray.array3d", false]], "array_alpha() (in module pygame.surfarray)": [[52, "pygame.surfarray.array_alpha", false]], "array_blue() (in module pygame.surfarray)": [[52, "pygame.surfarray.array_blue", false]], "array_colorkey() (in module pygame.surfarray)": [[52, "pygame.surfarray.array_colorkey", false]], "array_green() (in module pygame.surfarray)": [[52, "pygame.surfarray.array_green", false]], "array_red() (in module pygame.surfarray)": [[52, "pygame.surfarray.array_red", false]], "array_to_surface() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.array_to_surface", false]], "arraydemo.main() (in module pygame.examples)": [[26, "pygame.examples.arraydemo.main", false]], "as_joystick() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.as_joystick", false]], "as_polar() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.as_polar", false]], "as_spherical() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.as_spherical", false]], "ascender (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.ascender", false]], "attached() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.attached", false]], "average_color() (in module pygame.transform)": [[56, "pygame.transform.average_color", false]], "average_surfaces() (in module pygame.transform)": [[56, "pygame.transform.average_surfaces", false]], "b (pygame.color attribute)": [[20, "pygame.Color.b", false]], "bezier() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.bezier", false]], "bgcolor (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.bgcolor", false]], "blend_fill.main() (in module pygame.examples)": [[26, "pygame.examples.blend_fill.main", false]], "blend_mode (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.blend_mode", false]], "blend_mode (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.blend_mode", false]], "blit() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.blit", false]], "blit() (pygame.surface method)": [[51, "pygame.Surface.blit", false]], "blit_array() (in module pygame.surfarray)": [[52, "pygame.surfarray.blit_array", false]], "blit_blends.main() (in module pygame.examples)": [[26, "pygame.examples.blit_blends.main", false]], "blits() (pygame.surface method)": [[51, "pygame.Surface.blits", false]], "bold (pygame.font.font attribute)": [[28, "pygame.font.Font.bold", false]], "borderless (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.borderless", false]], "box() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.box", false]], "bufferproxy (class in pygame)": [[17, "pygame.BufferProxy", false]], "camera (class in pygame.camera)": [[18, "pygame.camera.Camera", false]], "camera.main() (in module pygame.examples)": [[26, "pygame.examples.camera.main", false]], "cd (class in pygame.cdrom)": [[19, "pygame.cdrom.CD", false]], "centroid() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.centroid", false]], "change_layer() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.change_layer", false]], "change_layer() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.change_layer", false]], "channel (class in pygame.mixer)": [[38, "pygame.mixer.Channel", false]], "chimp.main() (in module pygame.examples)": [[26, "pygame.examples.chimp.main", false]], "chop() (in module pygame.transform)": [[56, "pygame.transform.chop", false]], "circle() (in module pygame.draw)": [[24, "pygame.draw.circle", false]], "circle() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.circle", false]], "clamp() (in module pygame.math)": [[36, "pygame.math.clamp", false]], "clamp() (pygame.rect method)": [[45, "pygame.Rect.clamp", false]], "clamp_ip() (pygame.rect method)": [[45, "pygame.Rect.clamp_ip", false]], "clamp_magnitude() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.clamp_magnitude", false]], "clamp_magnitude() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.clamp_magnitude", false]], "clamp_magnitude_ip() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.clamp_magnitude_ip", false]], "clamp_magnitude_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.clamp_magnitude_ip", false]], "clear() (in module pygame.event)": [[25, "pygame.event.clear", false]], "clear() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.clear", false]], "clear() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.clear", false]], "clear() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.clear", false]], "clear() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.clear", false]], "clip() (pygame.rect method)": [[45, "pygame.Rect.clip", false]], "clipline() (pygame.rect method)": [[45, "pygame.Rect.clipline", false]], "clock (class in pygame.time)": [[54, "pygame.time.Clock", false]], "close() (pygame.midi.input method)": [[37, "pygame.midi.Input.close", false]], "close() (pygame.midi.output method)": [[37, "pygame.midi.Output.close", false]], "close() (pygame.pixelarray method)": [[42, "pygame.PixelArray.close", false]], "cmy (pygame.color attribute)": [[20, "pygame.Color.cmy", false]], "collide_circle() (in module pygame.sprite)": [[50, "pygame.sprite.collide_circle", false]], "collide_circle_ratio() (in module pygame.sprite)": [[50, "pygame.sprite.collide_circle_ratio", false]], "collide_mask() (in module pygame.sprite)": [[50, "pygame.sprite.collide_mask", false]], "collide_rect() (in module pygame.sprite)": [[50, "pygame.sprite.collide_rect", false]], "collide_rect_ratio() (in module pygame.sprite)": [[50, "pygame.sprite.collide_rect_ratio", false]], "collidedict() (pygame.rect method)": [[45, "pygame.Rect.collidedict", false]], "collidedictall() (pygame.rect method)": [[45, "pygame.Rect.collidedictall", false]], "collidelist() (pygame.rect method)": [[45, "pygame.Rect.collidelist", false]], "collidelistall() (pygame.rect method)": [[45, "pygame.Rect.collidelistall", false]], "collideobjects() (pygame.rect method)": [[45, "pygame.Rect.collideobjects", false]], "collideobjectsall() (pygame.rect method)": [[45, "pygame.Rect.collideobjectsall", false]], "collidepoint() (pygame.rect method)": [[45, "pygame.Rect.collidepoint", false]], "colliderect() (pygame.rect method)": [[45, "pygame.Rect.colliderect", false]], "color (class in pygame)": [[20, "pygame.Color", false]], "color (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.color", false]], "color (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.color", false]], "colorspace() (in module pygame.camera)": [[18, "pygame.camera.colorspace", false]], "compare() (pygame.pixelarray method)": [[42, "pygame.PixelArray.compare", false]], "compile() (in module pygame.cursors)": [[22, "pygame.cursors.compile", false]], "connected_component() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.connected_component", false]], "connected_components() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.connected_components", false]], "contains() (in module pygame.scrap)": [[46, "pygame.scrap.contains", false]], "contains() (pygame.rect method)": [[45, "pygame.Rect.contains", false]], "controller (class in pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.Controller", false]], "convert() (pygame.surface method)": [[51, "pygame.Surface.convert", false]], "convert_alpha() (pygame.surface method)": [[51, "pygame.Surface.convert_alpha", false]], "convolve() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.convolve", false]], "copy() (pygame.cursors.cursor method)": [[22, "pygame.cursors.Cursor.copy", false]], "copy() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.copy", false]], "copy() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.copy", false]], "copy() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.copy", false]], "copy() (pygame.rect method)": [[45, "pygame.Rect.copy", false]], "copy() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.copy", false]], "copy() (pygame.surface method)": [[51, "pygame.Surface.copy", false]], "correct_gamma() (pygame.color method)": [[20, "pygame.Color.correct_gamma", false]], "count() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.count", false]], "cross() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.cross", false]], "cross() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.cross", false]], "cursor (class in pygame.cursors)": [[22, "pygame.cursors.Cursor", false]], "cursors.main() (in module pygame.examples)": [[26, "pygame.examples.cursors.main", false]], "custom_type() (in module pygame.event)": [[25, "pygame.event.custom_type", false]], "data (pygame.cursors.cursor attribute)": [[22, "pygame.cursors.Cursor.data", false]], "delay() (in module pygame.time)": [[54, "pygame.time.delay", false]], "descender (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.descender", false]], "destroy() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.destroy", false]], "dirtysprite (class in pygame.sprite)": [[50, "pygame.sprite.DirtySprite", false]], "display() (pygame.overlay method)": [[41, "pygame.Overlay.display", false]], "display_index (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.display_index", false]], "distance_squared_to() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.distance_squared_to", false]], "distance_squared_to() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.distance_squared_to", false]], "distance_to() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.distance_to", false]], "distance_to() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.distance_to", false]], "dot() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.dot", false]], "dot() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.dot", false]], "draw() (pygame._sdl2.video.image method)": [[48, "pygame._sdl2.video.Image.draw", false]], "draw() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.draw", false]], "draw() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.draw", false]], "draw() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.draw", false]], "draw() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.draw", false]], "draw() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.draw", false]], "draw() (pygame.sprite.renderupdates method)": [[50, "pygame.sprite.RenderUpdates.draw", false]], "draw_blend_mode (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.draw_blend_mode", false]], "draw_color (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.draw_color", false]], "draw_line() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_line", false]], "draw_point() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_point", false]], "draw_rect() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.draw_rect", false]], "eject() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.eject", false]], "elementwise() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.elementwise", false]], "elementwise() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.elementwise", false]], "ellipse() (in module pygame.draw)": [[24, "pygame.draw.ellipse", false]], "ellipse() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.ellipse", false]], "empty() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.empty", false]], "encode_file_path() (in module pygame)": [[44, "pygame.encode_file_path", false]], "encode_string() (in module pygame)": [[44, "pygame.encode_string", false]], "epsilon (pygame.math.vector2 attribute)": [[36, "pygame.math.Vector2.epsilon", false]], "epsilon (pygame.math.vector3 attribute)": [[36, "pygame.math.Vector3.epsilon", false]], "erase() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.erase", false]], "error": [[44, "pygame.error", false]], "event (class in pygame.event)": [[25, "pygame.event.Event", false]], "event_name() (in module pygame.event)": [[25, "pygame.event.event_name", false]], "eventlist.main() (in module pygame.examples)": [[26, "pygame.examples.eventlist.main", false]], "extract() (pygame.pixelarray method)": [[42, "pygame.PixelArray.extract", false]], "fadeout() (in module pygame.mixer)": [[38, "pygame.mixer.fadeout", false]], "fadeout() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.fadeout", false]], "fadeout() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.fadeout", false]], "fadeout() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.fadeout", false]], "fgcolor (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.fgcolor", false]], "fill() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.fill", false]], "fill() (pygame.surface method)": [[51, "pygame.Surface.fill", false]], "fill_rect() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.fill_rect", false]], "filled_circle() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.filled_circle", false]], "filled_ellipse() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.filled_ellipse", false]], "filled_polygon() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.filled_polygon", false]], "filled_trigon() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.filled_trigon", false]], "find_channel() (in module pygame.mixer)": [[38, "pygame.mixer.find_channel", false]], "fit() (pygame.rect method)": [[45, "pygame.Rect.fit", false]], "fixed_sizes (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.fixed_sizes", false]], "fixed_width (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.fixed_width", false]], "flip() (in module pygame.display)": [[23, "pygame.display.flip", false]], "flip() (in module pygame.transform)": [[56, "pygame.transform.flip", false]], "flip_x (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.flip_x", false]], "flip_y (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.flip_y", false]], "focus() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.focus", false]], "font (class in pygame.font)": [[28, "pygame.font.Font", false]], "font (class in pygame.freetype)": [[29, "pygame.freetype.Font", false]], "fonty.main() (in module pygame.examples)": [[26, "pygame.examples.fonty.main", false]], "freetype_misc.main() (in module pygame.examples)": [[26, "pygame.examples.freetype_misc.main", false]], "frequency_to_midi() (in module pygame.midi)": [[37, "pygame.midi.frequency_to_midi", false]], "from_display_module() (pygame._sdl2.video.window class method)": [[48, "pygame._sdl2.video.Window.from_display_module", false]], "from_joystick() (pygame._sdl2.controller.controller static method)": [[47, "pygame._sdl2.controller.Controller.from_joystick", false]], "from_polar() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.from_polar", false]], "from_spherical() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.from_spherical", false]], "from_surface() (in module pygame.mask)": [[35, "pygame.mask.from_surface", false]], "from_surface() (pygame._sdl2.video.texture static method)": [[48, "pygame._sdl2.video.Texture.from_surface", false]], "from_threshold() (in module pygame.mask)": [[35, "pygame.mask.from_threshold", false]], "from_window() (pygame._sdl2.video.renderer class method)": [[48, "pygame._sdl2.video.Renderer.from_window", false]], "from_window() (pygame._sdl2.video.window class method)": [[48, "pygame._sdl2.video.Window.from_window", false]], "frombuffer() (in module pygame.image)": [[31, "pygame.image.frombuffer", false]], "frombytes() (in module pygame.image)": [[31, "pygame.image.frombytes", false]], "fromstring() (in module pygame.image)": [[31, "pygame.image.fromstring", false]], "g (pygame.color attribute)": [[20, "pygame.Color.g", false]], "get() (in module pygame.event)": [[25, "pygame.event.get", false]], "get() (in module pygame.fastevent)": [[27, "pygame.fastevent.get", false]], "get() (in module pygame.scrap)": [[46, "pygame.scrap.get", false]], "get_abs_offset() (pygame.surface method)": [[51, "pygame.Surface.get_abs_offset", false]], "get_abs_parent() (pygame.surface method)": [[51, "pygame.Surface.get_abs_parent", false]], "get_active() (in module pygame.display)": [[23, "pygame.display.get_active", false]], "get_all() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_all", false]], "get_allow_screensaver() (in module pygame.display)": [[23, "pygame.display.get_allow_screensaver", false]], "get_alpha() (pygame.surface method)": [[51, "pygame.Surface.get_alpha", false]], "get_arraytype() (in module pygame.sndarray)": [[49, "pygame.sndarray.get_arraytype", false]], "get_arraytype() (in module pygame.surfarray)": [[52, "pygame.surfarray.get_arraytype", false]], "get_arraytypes() (in module pygame.sndarray)": [[49, "pygame.sndarray.get_arraytypes", false]], "get_arraytypes() (in module pygame.surfarray)": [[52, "pygame.surfarray.get_arraytypes", false]], "get_ascent() (pygame.font.font method)": [[28, "pygame.font.Font.get_ascent", false]], "get_at() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.get_at", false]], "get_at() (pygame.surface method)": [[51, "pygame.Surface.get_at", false]], "get_at_mapped() (pygame.surface method)": [[51, "pygame.Surface.get_at_mapped", false]], "get_axis() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_axis", false]], "get_axis() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_axis", false]], "get_backends() (in module pygame.camera)": [[18, "pygame.camera.get_backends", false]], "get_ball() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_ball", false]], "get_bitsize() (pygame.surface method)": [[51, "pygame.Surface.get_bitsize", false]], "get_blocked() (in module pygame.event)": [[25, "pygame.event.get_blocked", false]], "get_bold() (pygame.font.font method)": [[28, "pygame.font.Font.get_bold", false]], "get_bottom_layer() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.get_bottom_layer", false]], "get_bounding_rect() (pygame.surface method)": [[51, "pygame.Surface.get_bounding_rect", false]], "get_bounding_rects() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.get_bounding_rects", false]], "get_buffer() (pygame.surface method)": [[51, "pygame.Surface.get_buffer", false]], "get_busy() (in module pygame.mixer)": [[38, "pygame.mixer.get_busy", false]], "get_busy() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.get_busy", false]], "get_busy() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_busy", false]], "get_busy() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.get_busy", false]], "get_button() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_button", false]], "get_button() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_button", false]], "get_bytesize() (pygame.surface method)": [[51, "pygame.Surface.get_bytesize", false]], "get_cache_size() (in module pygame.freetype)": [[29, "pygame.freetype.get_cache_size", false]], "get_caption() (in module pygame.display)": [[23, "pygame.display.get_caption", false]], "get_clip() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.get_clip", false]], "get_clip() (pygame.surface method)": [[51, "pygame.Surface.get_clip", false]], "get_colorkey() (pygame.surface method)": [[51, "pygame.Surface.get_colorkey", false]], "get_controls() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.get_controls", false]], "get_count() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.get_count", false]], "get_count() (in module pygame.cdrom)": [[19, "pygame.cdrom.get_count", false]], "get_count() (in module pygame.joystick)": [[32, "pygame.joystick.get_count", false]], "get_count() (in module pygame.midi)": [[37, "pygame.midi.get_count", false]], "get_current() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_current", false]], "get_cursor() (in module pygame.mouse)": [[39, "pygame.mouse.get_cursor", false]], "get_default_font() (in module pygame.font)": [[28, "pygame.font.get_default_font", false]], "get_default_font() (in module pygame.freetype)": [[29, "pygame.freetype.get_default_font", false]], "get_default_input_id() (in module pygame.midi)": [[37, "pygame.midi.get_default_input_id", false]], "get_default_output_id() (in module pygame.midi)": [[37, "pygame.midi.get_default_output_id", false]], "get_default_resolution() (in module pygame.freetype)": [[29, "pygame.freetype.get_default_resolution", false]], "get_descent() (pygame.font.font method)": [[28, "pygame.font.Font.get_descent", false]], "get_desktop_sizes() (in module pygame.display)": [[23, "pygame.display.get_desktop_sizes", false]], "get_device() (in module pygame._sdl2.touch)": [[55, "pygame._sdl2.touch.get_device", false]], "get_device_info() (in module pygame.midi)": [[37, "pygame.midi.get_device_info", false]], "get_driver() (in module pygame.display)": [[23, "pygame.display.get_driver", false]], "get_empty() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_empty", false]], "get_endevent() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.get_endevent", false]], "get_endevent() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.get_endevent", false]], "get_error() (in module pygame)": [[44, "pygame.get_error", false]], "get_error() (in module pygame.freetype)": [[29, "pygame.freetype.get_error", false]], "get_eventstate() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.get_eventstate", false]], "get_extended() (in module pygame.image)": [[31, "pygame.image.get_extended", false]], "get_finger() (in module pygame._sdl2.touch)": [[55, "pygame._sdl2.touch.get_finger", false]], "get_flags() (pygame.surface method)": [[51, "pygame.Surface.get_flags", false]], "get_focused() (in module pygame.key)": [[33, "pygame.key.get_focused", false]], "get_focused() (in module pygame.mouse)": [[39, "pygame.mouse.get_focused", false]], "get_fonts() (in module pygame.font)": [[28, "pygame.font.get_fonts", false]], "get_fps() (pygame.time.clock method)": [[54, "pygame.time.Clock.get_fps", false]], "get_grab() (in module pygame.event)": [[25, "pygame.event.get_grab", false]], "get_guid() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_guid", false]], "get_hardware() (pygame.overlay method)": [[41, "pygame.Overlay.get_hardware", false]], "get_hat() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_hat", false]], "get_height() (pygame.font.font method)": [[28, "pygame.font.Font.get_height", false]], "get_height() (pygame.surface method)": [[51, "pygame.Surface.get_height", false]], "get_id() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_id", false]], "get_id() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_id", false]], "get_image() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.get_image", false]], "get_init() (in module pygame)": [[44, "pygame.get_init", false]], "get_init() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.get_init", false]], "get_init() (in module pygame.cdrom)": [[19, "pygame.cdrom.get_init", false]], "get_init() (in module pygame.display)": [[23, "pygame.display.get_init", false]], "get_init() (in module pygame.fastevent)": [[27, "pygame.fastevent.get_init", false]], "get_init() (in module pygame.font)": [[28, "pygame.font.get_init", false]], "get_init() (in module pygame.freetype)": [[29, "pygame.freetype.get_init", false]], "get_init() (in module pygame.joystick)": [[32, "pygame.joystick.get_init", false]], "get_init() (in module pygame.midi)": [[37, "pygame.midi.get_init", false]], "get_init() (in module pygame.mixer)": [[38, "pygame.mixer.get_init", false]], "get_init() (in module pygame.scrap)": [[46, "pygame.scrap.get_init", false]], "get_init() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_init", false]], "get_init() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_init", false]], "get_init() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_init", false]], "get_instance_id() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_instance_id", false]], "get_italic() (pygame.font.font method)": [[28, "pygame.font.Font.get_italic", false]], "get_keyboard_grab() (in module pygame.event)": [[25, "pygame.event.get_keyboard_grab", false]], "get_layer_of_sprite() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.get_layer_of_sprite", false]], "get_length() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.get_length", false]], "get_linesize() (pygame.font.font method)": [[28, "pygame.font.Font.get_linesize", false]], "get_locked() (pygame.surface method)": [[51, "pygame.Surface.get_locked", false]], "get_locks() (pygame.surface method)": [[51, "pygame.Surface.get_locks", false]], "get_losses() (pygame.surface method)": [[51, "pygame.Surface.get_losses", false]], "get_mapping() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.get_mapping", false]], "get_masks() (pygame.surface method)": [[51, "pygame.Surface.get_masks", false]], "get_metrics() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_metrics", false]], "get_mods() (in module pygame.key)": [[33, "pygame.key.get_mods", false]], "get_name() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_name", false]], "get_name() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_name", false]], "get_num_channels() (in module pygame.mixer)": [[38, "pygame.mixer.get_num_channels", false]], "get_num_channels() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.get_num_channels", false]], "get_num_devices() (in module pygame._sdl2.touch)": [[55, "pygame._sdl2.touch.get_num_devices", false]], "get_num_displays() (in module pygame.display)": [[23, "pygame.display.get_num_displays", false]], "get_num_fingers() (in module pygame._sdl2.touch)": [[55, "pygame._sdl2.touch.get_num_fingers", false]], "get_numaxes() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_numaxes", false]], "get_numballs() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_numballs", false]], "get_numbuttons() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_numbuttons", false]], "get_numhats() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_numhats", false]], "get_numtracks() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_numtracks", false]], "get_offset() (pygame.surface method)": [[51, "pygame.Surface.get_offset", false]], "get_palette() (pygame.surface method)": [[51, "pygame.Surface.get_palette", false]], "get_palette_at() (pygame.surface method)": [[51, "pygame.Surface.get_palette_at", false]], "get_parent() (pygame.surface method)": [[51, "pygame.Surface.get_parent", false]], "get_paused() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_paused", false]], "get_pitch() (pygame.surface method)": [[51, "pygame.Surface.get_pitch", false]], "get_pos() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.get_pos", false]], "get_pos() (in module pygame.mouse)": [[39, "pygame.mouse.get_pos", false]], "get_power_level() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.get_power_level", false]], "get_pressed() (in module pygame.key)": [[33, "pygame.key.get_pressed", false]], "get_pressed() (in module pygame.mouse)": [[39, "pygame.mouse.get_pressed", false]], "get_queue() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.get_queue", false]], "get_raw() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.get_raw", false]], "get_raw() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.get_raw", false]], "get_rawtime() (pygame.time.clock method)": [[54, "pygame.time.Clock.get_rawtime", false]], "get_rect() (pygame._sdl2.video.image method)": [[48, "pygame._sdl2.video.Image.get_rect", false]], "get_rect() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.get_rect", false]], "get_rect() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_rect", false]], "get_rect() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.get_rect", false]], "get_rect() (pygame.surface method)": [[51, "pygame.Surface.get_rect", false]], "get_rel() (in module pygame.mouse)": [[39, "pygame.mouse.get_rel", false]], "get_repeat() (in module pygame.key)": [[33, "pygame.key.get_repeat", false]], "get_sdl_byteorder() (in module pygame)": [[44, "pygame.get_sdl_byteorder", false]], "get_sdl_image_version() (in module pygame.image)": [[31, "pygame.image.get_sdl_image_version", false]], "get_sdl_mixer_version() (in module pygame.mixer)": [[38, "pygame.mixer.get_sdl_mixer_version", false]], "get_sdl_ttf_version() (in module pygame.font)": [[28, "pygame.font.get_sdl_ttf_version", false]], "get_sdl_version() (in module pygame)": [[44, "pygame.get_sdl_version", false]], "get_shifts() (pygame.surface method)": [[51, "pygame.Surface.get_shifts", false]], "get_size() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.get_size", false]], "get_size() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.get_size", false]], "get_size() (pygame.surface method)": [[51, "pygame.Surface.get_size", false]], "get_sized_ascender() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_ascender", false]], "get_sized_descender() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_descender", false]], "get_sized_glyph_height() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_glyph_height", false]], "get_sized_height() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sized_height", false]], "get_sizes() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.get_sizes", false]], "get_smoothscale_backend() (in module pygame.transform)": [[56, "pygame.transform.get_smoothscale_backend", false]], "get_sound() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.get_sound", false]], "get_sprite() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.get_sprite", false]], "get_sprites_at() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.get_sprites_at", false]], "get_sprites_from_layer() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.get_sprites_from_layer", false]], "get_strikethrough() (pygame.font.font method)": [[28, "pygame.font.Font.get_strikethrough", false]], "get_surface() (in module pygame.display)": [[23, "pygame.display.get_surface", false]], "get_ticks() (in module pygame.time)": [[54, "pygame.time.get_ticks", false]], "get_time() (pygame.time.clock method)": [[54, "pygame.time.Clock.get_time", false]], "get_top_layer() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.get_top_layer", false]], "get_top_sprite() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.get_top_sprite", false]], "get_track_audio() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_track_audio", false]], "get_track_length() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_track_length", false]], "get_track_start() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.get_track_start", false]], "get_types() (in module pygame.scrap)": [[46, "pygame.scrap.get_types", false]], "get_underline() (pygame.font.font method)": [[28, "pygame.font.Font.get_underline", false]], "get_version() (in module pygame.freetype)": [[29, "pygame.freetype.get_version", false]], "get_view() (pygame.surface method)": [[51, "pygame.Surface.get_view", false]], "get_viewport() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.get_viewport", false]], "get_visible() (in module pygame.mouse)": [[39, "pygame.mouse.get_visible", false]], "get_volume() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.get_volume", false]], "get_volume() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.get_volume", false]], "get_volume() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.get_volume", false]], "get_width() (pygame.surface method)": [[51, "pygame.Surface.get_width", false]], "get_window_size() (in module pygame.display)": [[23, "pygame.display.get_window_size", false]], "get_wm_info() (in module pygame.display)": [[23, "pygame.display.get_wm_info", false]], "gl_get_attribute() (in module pygame.display)": [[23, "pygame.display.gl_get_attribute", false]], "gl_set_attribute() (in module pygame.display)": [[23, "pygame.display.gl_set_attribute", false]], "glcube.main() (in module pygame.examples)": [[26, "pygame.examples.glcube.main", false]], "grab (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.grab", false]], "grayscale() (in module pygame.transform)": [[56, "pygame.transform.grayscale", false]], "grayscale() (pygame.color method)": [[20, "pygame.Color.grayscale", false]], "group (class in pygame.sprite)": [[50, "pygame.sprite.Group", false]], "groupcollide() (in module pygame.sprite)": [[50, "pygame.sprite.groupcollide", false]], "groups() (pygame.sprite.sprite method)": [[50, "pygame.sprite.Sprite.groups", false]], "groupsingle() (in module pygame.sprite)": [[50, "pygame.sprite.GroupSingle", false]], "has() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.has", false]], "headless_no_windows_needed.main() (in module pygame.examples)": [[26, "pygame.examples.headless_no_windows_needed.main", false]], "height (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.height", false]], "height (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.height", false]], "hide() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.hide", false]], "hline() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.hline", false]], "hsla (pygame.color attribute)": [[20, "pygame.Color.hsla", false]], "hsva (pygame.color attribute)": [[20, "pygame.Color.hsva", false]], "i1i2i3 (pygame.color attribute)": [[20, "pygame.Color.i1i2i3", false]], "iconify() (in module pygame.display)": [[23, "pygame.display.iconify", false]], "id (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.id", false]], "image (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Image", false]], "import_pygame_base (c function)": [[1, "c.import_pygame_base", false]], "inflate() (pygame.rect method)": [[45, "pygame.Rect.inflate", false]], "inflate_ip() (pygame.rect method)": [[45, "pygame.Rect.inflate_ip", false]], "info() (in module pygame.display)": [[23, "pygame.display.Info", false]], "init() (in module pygame)": [[44, "pygame.init", false]], "init() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.init", false]], "init() (in module pygame.camera)": [[18, "pygame.camera.init", false]], "init() (in module pygame.cdrom)": [[19, "pygame.cdrom.init", false]], "init() (in module pygame.display)": [[23, "pygame.display.init", false]], "init() (in module pygame.fastevent)": [[27, "pygame.fastevent.init", false]], "init() (in module pygame.font)": [[28, "pygame.font.init", false]], "init() (in module pygame.freetype)": [[29, "pygame.freetype.init", false]], "init() (in module pygame.joystick)": [[32, "pygame.joystick.init", false]], "init() (in module pygame.midi)": [[37, "pygame.midi.init", false]], "init() (in module pygame.mixer)": [[38, "pygame.mixer.init", false]], "init() (in module pygame.scrap)": [[46, "pygame.scrap.init", false]], "init() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.init", false]], "init() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.init", false]], "input (class in pygame.midi)": [[37, "pygame.midi.Input", false]], "invert() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.invert", false]], "is_controller() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.is_controller", false]], "is_normalized() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.is_normalized", false]], "is_normalized() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.is_normalized", false]], "italic (pygame.font.font attribute)": [[28, "pygame.font.Font.italic", false]], "itemsize (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.itemsize", false]], "joystick (class in pygame.joystick)": [[32, "pygame.joystick.Joystick", false]], "joystick.main() (in module pygame.examples)": [[26, "pygame.examples.joystick.main", false]], "kerning (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.kerning", false]], "key_code() (in module pygame.key)": [[33, "pygame.key.key_code", false]], "kill() (pygame.sprite.sprite method)": [[50, "pygame.sprite.Sprite.kill", false]], "laplacian() (in module pygame.transform)": [[56, "pygame.transform.laplacian", false]], "layereddirty (class in pygame.sprite)": [[50, "pygame.sprite.LayeredDirty", false]], "layeredupdates (class in pygame.sprite)": [[50, "pygame.sprite.LayeredUpdates", false]], "layers() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.layers", false]], "length (pygame.bufferproxy attribute)": [[17, "pygame.BufferProxy.length", false]], "length() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.length", false]], "length() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.length", false]], "length_squared() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.length_squared", false]], "length_squared() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.length_squared", false]], "lerp() (in module pygame.math)": [[36, "pygame.math.lerp", false]], "lerp() (pygame.color method)": [[20, "pygame.Color.lerp", false]], "lerp() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.lerp", false]], "lerp() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.lerp", false]], "line() (in module pygame.draw)": [[24, "pygame.draw.line", false]], "line() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.line", false]], "lines() (in module pygame.draw)": [[24, "pygame.draw.lines", false]], "liquid.main() (in module pygame.examples)": [[26, "pygame.examples.liquid.main", false]], "list_cameras() (in module pygame.camera)": [[18, "pygame.camera.list_cameras", false]], "list_modes() (in module pygame.display)": [[23, "pygame.display.list_modes", false]], "load() (in module pygame.image)": [[31, "pygame.image.load", false]], "load() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.load", false]], "load_basic() (in module pygame.image)": [[31, "pygame.image.load_basic", false]], "load_extended() (in module pygame.image)": [[31, "pygame.image.load_extended", false]], "load_xbm() (in module pygame.cursors)": [[22, "pygame.cursors.load_xbm", false]], "lock() (pygame.surface method)": [[51, "pygame.Surface.lock", false]], "logical_size (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.logical_size", false]], "lost() (in module pygame.scrap)": [[46, "pygame.scrap.lost", false]], "magnitude() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.magnitude", false]], "magnitude() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.magnitude", false]], "magnitude_squared() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.magnitude_squared", false]], "magnitude_squared() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.magnitude_squared", false]], "make_sound() (in module pygame.sndarray)": [[49, "pygame.sndarray.make_sound", false]], "make_surface() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.make_surface", false]], "make_surface() (in module pygame.surfarray)": [[52, "pygame.surfarray.make_surface", false]], "make_surface() (pygame.pixelarray method)": [[42, "pygame.PixelArray.make_surface", false]], "map_array() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.map_array", false]], "map_array() (in module pygame.surfarray)": [[52, "pygame.surfarray.map_array", false]], "map_rgb() (pygame.surface method)": [[51, "pygame.Surface.map_rgb", false]], "mask (class in pygame.mask)": [[35, "pygame.mask.Mask", false]], "mask.main() (in module pygame.examples)": [[26, "pygame.examples.mask.main", false]], "match_font() (in module pygame.font)": [[28, "pygame.font.match_font", false]], "maximize() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.maximize", false]], "metrics() (pygame.font.font method)": [[28, "pygame.font.Font.metrics", false]], "midi.main() (in module pygame.examples)": [[26, "pygame.examples.midi.main", false]], "midi_to_ansi_note() (in module pygame.midi)": [[37, "pygame.midi.midi_to_ansi_note", false]], "midi_to_frequency() (in module pygame.midi)": [[37, "pygame.midi.midi_to_frequency", false]], "midiexception": [[37, "pygame.midi.MidiException", false]], "midis2events() (in module pygame.midi)": [[37, "pygame.midi.midis2events", false]], "minimize() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.minimize", false]], "mode_ok() (in module pygame.display)": [[23, "pygame.display.mode_ok", false]], "module": [[18, "module-pygame.camera", false], [19, "module-pygame.cdrom", false], [22, "module-pygame.cursors", false], [23, "module-pygame.display", false], [24, "module-pygame.draw", false], [25, "module-pygame.event", false], [26, "module-pygame.examples", false], [27, "module-pygame.fastevent", false], [28, "module-pygame.font", false], [29, "module-pygame.freetype", false], [30, "module-pygame.gfxdraw", false], [31, "module-pygame.image", false], [32, "module-pygame.joystick", false], [33, "module-pygame.key", false], [34, "module-pygame.locals", false], [35, "module-pygame.mask", false], [36, "module-pygame.math", false], [37, "module-pygame.midi", false], [38, "module-pygame.mixer", false], [39, "module-pygame.mouse", false], [40, "module-pygame.mixer.music", false], [43, "module-pygame.pixelcopy", false], [44, "module-pygame", false], [44, "module-pygame.version", false], [46, "module-pygame.scrap", false], [47, "module-pygame._sdl2.controller", false], [48, "module-pygame._sdl2.video", false], [49, "module-pygame.sndarray", false], [50, "module-pygame.sprite", false], [52, "module-pygame.surfarray", false], [53, "module-pygame.tests", false], [54, "module-pygame.time", false], [55, "module-pygame._sdl2.touch", false], [56, "module-pygame.transform", false]], "move() (pygame.rect method)": [[45, "pygame.Rect.move", false]], "move_ip() (pygame.rect method)": [[45, "pygame.Rect.move_ip", false]], "move_to_back() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.move_to_back", false]], "move_to_front() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.move_to_front", false]], "move_towards() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.move_towards", false]], "move_towards() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.move_towards", false]], "move_towards_ip() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.move_towards_ip", false]], "move_towards_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.move_towards_ip", false]], "moveit.main() (in module pygame.examples)": [[26, "pygame.examples.moveit.main", false]], "mustlock() (pygame.surface method)": [[51, "pygame.Surface.mustlock", false]], "name (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.name", false]], "name() (in module pygame.key)": [[33, "pygame.key.name", false]], "name_forindex() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.name_forindex", false]], "ndim (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.ndim", false]], "normalize() (pygame.color method)": [[20, "pygame.Color.normalize", false]], "normalize() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.normalize", false]], "normalize() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.normalize", false]], "normalize() (pygame.rect method)": [[45, "pygame.Rect.normalize", false]], "normalize_ip() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.normalize_ip", false]], "normalize_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.normalize_ip", false]], "note_off() (pygame.midi.output method)": [[37, "pygame.midi.Output.note_off", false]], "note_on() (pygame.midi.output method)": [[37, "pygame.midi.Output.note_on", false]], "oblique (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.oblique", false]], "opacity (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.opacity", false]], "orderedupdates() (in module pygame.sprite)": [[50, "pygame.sprite.OrderedUpdates", false]], "origin (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.origin", false]], "origin (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.origin", false]], "outline() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.outline", false]], "output (class in pygame.midi)": [[37, "pygame.midi.Output", false]], "overlap() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.overlap", false]], "overlap_area() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.overlap_area", false]], "overlap_mask() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.overlap_mask", false]], "overlay (class in pygame)": [[41, "pygame.Overlay", false]], "pad (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.pad", false]], "parent (pygame.bufferproxy attribute)": [[17, "pygame.BufferProxy.parent", false]], "path (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.path", false]], "pause() (in module pygame.mixer)": [[38, "pygame.mixer.pause", false]], "pause() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.pause", false]], "pause() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.pause", false]], "pause() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.pause", false]], "peek() (in module pygame.event)": [[25, "pygame.event.peek", false]], "pg_buffer (c type)": [[1, "c.pg_buffer", false]], "pg_buffer.consumer (c member)": [[1, "c.pg_buffer.consumer", false]], "pg_buffer.release_buffer (c member)": [[1, "c.pg_buffer.release_buffer", false]], "pg_buffer.view (c member)": [[1, "c.pg_buffer.view", false]], "pg_encodefilepath (c function)": [[9, "c.pg_EncodeFilePath", false]], "pg_encodestring (c function)": [[9, "c.pg_EncodeString", false]], "pg_floatfromobj (c function)": [[1, "c.pg_FloatFromObj", false]], "pg_floatfromobjindex (c function)": [[1, "c.pg_FloatFromObjIndex", false]], "pg_getdefaultwindow (c function)": [[1, "c.pg_GetDefaultWindow", false]], "pg_getdefaultwindowsurface (c function)": [[1, "c.pg_GetDefaultWindowSurface", false]], "pg_intfromobj (c function)": [[1, "c.pg_IntFromObj", false]], "pg_intfromobjindex (c function)": [[1, "c.pg_IntFromObjIndex", false]], "pg_major_version (c macro)": [[13, "c.PG_MAJOR_VERSION", false]], "pg_minor_version (c macro)": [[13, "c.PG_MINOR_VERSION", false]], "pg_mod_autoinit (c function)": [[1, "c.pg_mod_autoinit", false]], "pg_mod_autoquit (c function)": [[1, "c.pg_mod_autoquit", false]], "pg_patch_version (c macro)": [[13, "c.PG_PATCH_VERSION", false]], "pg_registerquit (c function)": [[1, "c.pg_RegisterQuit", false]], "pg_rgbafromobj (c function)": [[1, "c.pg_RGBAFromObj", false]], "pg_setdefaultwindow (c function)": [[1, "c.pg_SetDefaultWindow", false]], "pg_setdefaultwindowsurface (c function)": [[1, "c.pg_SetDefaultWindowSurface", false]], "pg_twofloatsfromobj (c function)": [[1, "c.pg_TwoFloatsFromObj", false]], "pg_twointsfromobj (c function)": [[1, "c.pg_TwoIntsFromObj", false]], "pg_uintfromobj (c function)": [[1, "c.pg_UintFromObj", false]], "pg_uintfromobjindex (c function)": [[1, "c.pg_UintFromObjIndex", false]], "pg_version_atleast (c macro)": [[13, "c.PG_VERSION_ATLEAST", false]], "pg_versionnum (c macro)": [[13, "c.PG_VERSIONNUM", false]], "pgbuffer_asarrayinterface (c function)": [[1, "c.pgBuffer_AsArrayInterface", false]], "pgbuffer_asarraystruct (c function)": [[1, "c.pgBuffer_AsArrayStruct", false]], "pgbuffer_release (c function)": [[1, "c.pgBuffer_Release", false]], "pgbufproxy_check (c function)": [[2, "c.pgBufproxy_Check", false]], "pgbufproxy_getparent (c function)": [[2, "c.pgBufproxy_GetParent", false]], "pgbufproxy_new (c function)": [[2, "c.pgBufproxy_New", false]], "pgbufproxy_trip (c function)": [[2, "c.pgBufproxy_Trip", false]], "pgbufproxy_type (c var)": [[2, "c.pgBufproxy_Type", false]], "pgchannel_asint (c function)": [[7, "c.pgChannel_AsInt", false]], "pgchannel_check (c function)": [[7, "c.pgChannel_Check", false]], "pgchannel_new (c function)": [[7, "c.pgChannel_New", false]], "pgchannel_type (c var)": [[7, "c.pgChannel_Type", false]], "pgchannelobject (c type)": [[7, "c.pgChannelObject", false]], "pgcolor_check (c function)": [[3, "c.pgColor_Check", false]], "pgcolor_new (c function)": [[3, "c.pgColor_New", false]], "pgcolor_newlength (c function)": [[3, "c.pgColor_NewLength", false]], "pgcolor_type (c var)": [[3, "c.pgColor_Type", false]], "pgdict_asbuffer (c function)": [[1, "c.pgDict_AsBuffer", false]], "pgevent_check (c function)": [[5, "c.pgEvent_Check", false]], "pgevent_filluserevent (c function)": [[5, "c.pgEvent_FillUserEvent", false]], "pgevent_new (c function)": [[5, "c.pgEvent_New", false]], "pgevent_new2 (c function)": [[5, "c.pgEvent_New2", false]], "pgevent_type (c type)": [[5, "c.pgEvent_Type", false]], "pgeventobject (c type)": [[5, "c.pgEventObject", false]], "pgeventobject.type (c member)": [[5, "c.pgEventObject.type", false]], "pgexc_buffererror (c var)": [[1, "c.pgExc_BufferError", false]], "pgexc_sdlerror (c var)": [[1, "c.pgExc_SDLError", false]], "pgfont_check (c function)": [[6, "c.pgFont_Check", false]], "pgfont_is_alive (c function)": [[6, "c.pgFont_IS_ALIVE", false]], "pgfont_new (c function)": [[6, "c.pgFont_New", false]], "pgfont_type (c type)": [[6, "c.pgFont_Type", false]], "pgfontobject (c type)": [[6, "c.pgFontObject", false]], "pglifetimelock_check (c function)": [[12, "c.pgLifetimeLock_Check", false]], "pglifetimelock_type (c var)": [[12, "c.pgLifetimeLock_Type", false]], "pglifetimelockobject (c type)": [[12, "c.pgLifetimeLockObject", false]], "pglifetimelockobject.lockobj (c member)": [[12, "c.pgLifetimeLockObject.lockobj", false]], "pglifetimelockobject.surface (c member)": [[12, "c.pgLifetimeLockObject.surface", false]], "pgobject_getbuffer (c function)": [[1, "c.pgObject_GetBuffer", false]], "pgrect_asrect (c function)": [[8, "c.pgRect_AsRect", false]], "pgrect_check (c function)": [[8, "c.pgRect_Check", false]], "pgrect_fromobject (c function)": [[8, "c.pgRect_FromObject", false]], "pgrect_new (c function)": [[8, "c.pgRect_New", false]], "pgrect_new4 (c function)": [[8, "c.pgRect_New4", false]], "pgrect_normalize (c function)": [[8, "c.pgRect_Normalize", false]], "pgrect_type (c var)": [[8, "c.pgRect_Type", false]], "pgrectobject (c type)": [[8, "c.pgRectObject", false]], "pgrectobject.r (c member)": [[8, "c.pgRectObject.r", false]], "pgrwops_fromfileobject (c function)": [[9, "c.pgRWops_FromFileObject", false]], "pgrwops_fromobject (c function)": [[9, "c.pgRWops_FromObject", false]], "pgrwops_isfileobject (c function)": [[9, "c.pgRWops_IsFileObject", false]], "pgrwops_releaseobject (c function)": [[9, "c.pgRWops_ReleaseObject", false]], "pgsound_aschunk (c function)": [[7, "c.pgSound_AsChunk", false]], "pgsound_check (c function)": [[7, "c.pgSound_Check", false]], "pgsound_new (c function)": [[7, "c.pgSound_New", false]], "pgsound_type (c var)": [[7, "c.pgSound_Type", false]], "pgsoundobject (c type)": [[7, "c.pgSoundObject", false]], "pgsurface_assurface (c function)": [[11, "c.pgSurface_AsSurface", false]], "pgsurface_blit (c function)": [[11, "c.pgSurface_Blit", false]], "pgsurface_check (c function)": [[11, "c.pgSurface_Check", false]], "pgsurface_lock (c function)": [[12, "c.pgSurface_Lock", false]], "pgsurface_lockby (c function)": [[12, "c.pgSurface_LockBy", false]], "pgsurface_locklifetime (c function)": [[12, "c.pgSurface_LockLifetime", false]], "pgsurface_new (c function)": [[11, "c.pgSurface_New", false]], "pgsurface_new2 (c function)": [[11, "c.pgSurface_New2", false]], "pgsurface_prep (c function)": [[12, "c.pgSurface_Prep", false]], "pgsurface_type (c var)": [[11, "c.pgSurface_Type", false]], "pgsurface_unlock (c function)": [[12, "c.pgSurface_UnLock", false]], "pgsurface_unlockby (c function)": [[12, "c.pgSurface_UnLockBy", false]], "pgsurface_unprep (c function)": [[12, "c.pgSurface_Unprep", false]], "pgsurfaceobject (c type)": [[11, "c.pgSurfaceObject", false]], "pgvidinfo_asvidinfo (c function)": [[4, "c.pgVidInfo_AsVidInfo", false]], "pgvidinfo_check (c function)": [[4, "c.pgVidInfo_Check", false]], "pgvidinfo_new (c function)": [[4, "c.pgVidInfo_New", false]], "pgvidinfo_type (c var)": [[4, "c.pgVidInfo_Type", false]], "pgvidinfoobject (c type)": [[4, "c.pgVidInfoObject", false]], "pie() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.pie", false]], "pitch_bend() (pygame.midi.output method)": [[37, "pygame.midi.Output.pitch_bend", false]], "pixel() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.pixel", false]], "pixelarray (class in pygame)": [[42, "pygame.PixelArray", false]], "pixelarray.main() (in module pygame.examples)": [[26, "pygame.examples.pixelarray.main", false]], "pixels2d() (in module pygame.surfarray)": [[52, "pygame.surfarray.pixels2d", false]], "pixels3d() (in module pygame.surfarray)": [[52, "pygame.surfarray.pixels3d", false]], "pixels_alpha() (in module pygame.surfarray)": [[52, "pygame.surfarray.pixels_alpha", false]], "pixels_blue() (in module pygame.surfarray)": [[52, "pygame.surfarray.pixels_blue", false]], "pixels_green() (in module pygame.surfarray)": [[52, "pygame.surfarray.pixels_green", false]], "pixels_red() (in module pygame.surfarray)": [[52, "pygame.surfarray.pixels_red", false]], "play() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.play", false]], "play() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.play", false]], "play() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.play", false]], "play() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.play", false]], "playmus.main() (in module pygame.examples)": [[26, "pygame.examples.playmus.main", false]], "poll() (in module pygame.event)": [[25, "pygame.event.poll", false]], "poll() (in module pygame.fastevent)": [[27, "pygame.fastevent.poll", false]], "poll() (pygame.midi.input method)": [[37, "pygame.midi.Input.poll", false]], "polygon() (in module pygame.draw)": [[24, "pygame.draw.polygon", false]], "polygon() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.polygon", false]], "position (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.position", false]], "post() (in module pygame.event)": [[25, "pygame.event.post", false]], "post() (in module pygame.fastevent)": [[27, "pygame.fastevent.post", false]], "pre_init() (in module pygame.mixer)": [[38, "pygame.mixer.pre_init", false]], "premul_alpha() (pygame.color method)": [[20, "pygame.Color.premul_alpha", false]], "premul_alpha() (pygame.surface method)": [[51, "pygame.Surface.premul_alpha", false]], "present() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.present", false]], "project() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.project", false]], "project() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.project", false]], "pump() (in module pygame.event)": [[25, "pygame.event.pump", false]], "pump() (in module pygame.fastevent)": [[27, "pygame.fastevent.pump", false]], "put() (in module pygame.scrap)": [[46, "pygame.scrap.put", false]], "pygame": [[44, "module-pygame", false]], "pygame._sdl2.controller": [[47, "module-pygame._sdl2.controller", false]], "pygame._sdl2.touch": [[55, "module-pygame._sdl2.touch", false]], "pygame._sdl2.video": [[48, "module-pygame._sdl2.video", false]], "pygame.camera": [[18, "module-pygame.camera", false]], "pygame.cdrom": [[19, "module-pygame.cdrom", false]], "pygame.cursors": [[22, "module-pygame.cursors", false]], "pygame.display": [[23, "module-pygame.display", false]], "pygame.draw": [[24, "module-pygame.draw", false]], "pygame.event": [[25, "module-pygame.event", false]], "pygame.examples": [[26, "module-pygame.examples", false]], "pygame.fastevent": [[27, "module-pygame.fastevent", false]], "pygame.font": [[28, "module-pygame.font", false]], "pygame.freetype": [[29, "module-pygame.freetype", false]], "pygame.gfxdraw": [[30, "module-pygame.gfxdraw", false]], "pygame.image": [[31, "module-pygame.image", false]], "pygame.joystick": [[32, "module-pygame.joystick", false]], "pygame.key": [[33, "module-pygame.key", false]], "pygame.locals": [[34, "module-pygame.locals", false]], "pygame.mask": [[35, "module-pygame.mask", false]], "pygame.math": [[36, "module-pygame.math", false]], "pygame.midi": [[37, "module-pygame.midi", false]], "pygame.mixer": [[38, "module-pygame.mixer", false]], "pygame.mixer.music": [[40, "module-pygame.mixer.music", false]], "pygame.mouse": [[39, "module-pygame.mouse", false]], "pygame.pixelcopy": [[43, "module-pygame.pixelcopy", false]], "pygame.scrap": [[46, "module-pygame.scrap", false]], "pygame.sndarray": [[49, "module-pygame.sndarray", false]], "pygame.sprite": [[50, "module-pygame.sprite", false]], "pygame.surfarray": [[52, "module-pygame.surfarray", false]], "pygame.tests": [[53, "module-pygame.tests", false]], "pygame.time": [[54, "module-pygame.time", false]], "pygame.transform": [[56, "module-pygame.transform", false]], "pygame.version": [[44, "module-pygame.version", false]], "query_image() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.query_image", false]], "queue() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.queue", false]], "queue() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.queue", false]], "quit() (in module pygame)": [[44, "pygame.quit", false]], "quit() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.quit", false]], "quit() (in module pygame.cdrom)": [[19, "pygame.cdrom.quit", false]], "quit() (in module pygame.display)": [[23, "pygame.display.quit", false]], "quit() (in module pygame.font)": [[28, "pygame.font.quit", false]], "quit() (in module pygame.freetype)": [[29, "pygame.freetype.quit", false]], "quit() (in module pygame.joystick)": [[32, "pygame.joystick.quit", false]], "quit() (in module pygame.midi)": [[37, "pygame.midi.quit", false]], "quit() (in module pygame.mixer)": [[38, "pygame.mixer.quit", false]], "quit() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.quit", false]], "quit() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.quit", false]], "quit() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.quit", false]], "r (pygame.color attribute)": [[20, "pygame.Color.r", false]], "raw (pygame.bufferproxy attribute)": [[17, "pygame.BufferProxy.raw", false]], "read() (pygame.midi.input method)": [[37, "pygame.midi.Input.read", false]], "rect (class in pygame)": [[45, "pygame.Rect", false]], "rect() (in module pygame.draw)": [[24, "pygame.draw.rect", false]], "rectangle() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.rectangle", false]], "reflect() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.reflect", false]], "reflect() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.reflect", false]], "reflect_ip() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.reflect_ip", false]], "reflect_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.reflect_ip", false]], "register_quit() (in module pygame)": [[44, "pygame.register_quit", false]], "relative_mouse (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.relative_mouse", false]], "remove() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.remove", false]], "remove() (pygame.sprite.sprite method)": [[50, "pygame.sprite.Sprite.remove", false]], "remove_sprites_of_layer() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.remove_sprites_of_layer", false]], "render() (pygame.font.font method)": [[28, "pygame.font.Font.render", false]], "render() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render", false]], "render_raw() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render_raw", false]], "render_raw_to() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render_raw_to", false]], "render_to() (pygame.freetype.font method)": [[29, "pygame.freetype.Font.render_to", false]], "renderclear (class in pygame.sprite)": [[50, "pygame.sprite.RenderClear", false]], "renderer (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Renderer", false]], "renderer (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.renderer", false]], "renderplain (class in pygame.sprite)": [[50, "pygame.sprite.RenderPlain", false]], "renderupdates (class in pygame.sprite)": [[50, "pygame.sprite.RenderUpdates", false]], "repaint_rect() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.repaint_rect", false]], "replace() (pygame.pixelarray method)": [[42, "pygame.PixelArray.replace", false]], "resizable (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.resizable", false]], "resolution (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.resolution", false]], "restore() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.restore", false]], "resume() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.resume", false]], "rev (in module pygame.version)": [[44, "pygame.version.rev", false]], "rewind() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.rewind", false]], "rotate() (in module pygame.transform)": [[56, "pygame.transform.rotate", false]], "rotate() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.rotate", false]], "rotate() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate", false]], "rotate_ip() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.rotate_ip", false]], "rotate_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_ip", false]], "rotate_ip_rad() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.rotate_ip_rad", false]], "rotate_ip_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_ip_rad", false]], "rotate_rad() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.rotate_rad", false]], "rotate_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_rad", false]], "rotate_rad_ip() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.rotate_rad_ip", false]], "rotate_rad_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_rad_ip", false]], "rotate_x() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_x", false]], "rotate_x_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_x_ip", false]], "rotate_x_ip_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_x_ip_rad", false]], "rotate_x_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_x_rad", false]], "rotate_x_rad_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_x_rad_ip", false]], "rotate_y() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_y", false]], "rotate_y_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_y_ip", false]], "rotate_y_ip_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_y_ip_rad", false]], "rotate_y_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_y_rad", false]], "rotate_y_rad_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_y_rad_ip", false]], "rotate_z() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_z", false]], "rotate_z_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_z_ip", false]], "rotate_z_ip_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_z_ip_rad", false]], "rotate_z_rad() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_z_rad", false]], "rotate_z_rad_ip() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.rotate_z_rad_ip", false]], "rotation (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.rotation", false]], "rotozoom() (in module pygame.transform)": [[56, "pygame.transform.rotozoom", false]], "rumble() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.rumble", false]], "rumble() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.rumble", false]], "run() (in module pygame.tests)": [[53, "pygame.tests.run", false]], "samples() (in module pygame.sndarray)": [[49, "pygame.sndarray.samples", false]], "save() (in module pygame.image)": [[31, "pygame.image.save", false]], "save_extended() (in module pygame.image)": [[31, "pygame.image.save_extended", false]], "scalable (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.scalable", false]], "scale (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.scale", false]], "scale() (in module pygame.transform)": [[56, "pygame.transform.scale", false]], "scale() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.scale", false]], "scale2x() (in module pygame.transform)": [[56, "pygame.transform.scale2x", false]], "scale_by() (in module pygame.transform)": [[56, "pygame.transform.scale_by", false]], "scale_by() (pygame.rect method)": [[45, "pygame.Rect.scale_by", false]], "scale_by_ip() (pygame.rect method)": [[45, "pygame.Rect.scale_by_ip", false]], "scale_to_length() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.scale_to_length", false]], "scale_to_length() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.scale_to_length", false]], "scaletest.main() (in module pygame.examples)": [[26, "pygame.examples.scaletest.main", false]], "scrap_clipboard.main() (in module pygame.examples)": [[26, "pygame.examples.scrap_clipboard.main", false]], "scroll() (pygame.surface method)": [[51, "pygame.Surface.scroll", false]], "scroll.main() (in module pygame.examples)": [[26, "pygame.examples.scroll.main", false]], "sdl (in module pygame.version)": [[44, "pygame.version.SDL", false]], "set_allow_screensaver() (in module pygame.display)": [[23, "pygame.display.set_allow_screensaver", false]], "set_allowed() (in module pygame.event)": [[25, "pygame.event.set_allowed", false]], "set_alpha() (pygame.surface method)": [[51, "pygame.Surface.set_alpha", false]], "set_at() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.set_at", false]], "set_at() (pygame.surface method)": [[51, "pygame.Surface.set_at", false]], "set_blocked() (in module pygame.event)": [[25, "pygame.event.set_blocked", false]], "set_bold() (pygame.font.font method)": [[28, "pygame.font.Font.set_bold", false]], "set_caption() (in module pygame.display)": [[23, "pygame.display.set_caption", false]], "set_clip() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.set_clip", false]], "set_clip() (pygame.surface method)": [[51, "pygame.Surface.set_clip", false]], "set_colorkey() (pygame.surface method)": [[51, "pygame.Surface.set_colorkey", false]], "set_controls() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.set_controls", false]], "set_cursor() (in module pygame.mouse)": [[39, "pygame.mouse.set_cursor", false]], "set_default_resolution() (in module pygame.freetype)": [[29, "pygame.freetype.set_default_resolution", false]], "set_endevent() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.set_endevent", false]], "set_endevent() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.set_endevent", false]], "set_error() (in module pygame)": [[44, "pygame.set_error", false]], "set_eventstate() (in module pygame._sdl2.controller)": [[47, "pygame._sdl2.controller.set_eventstate", false]], "set_fullscreen() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.set_fullscreen", false]], "set_gamma() (in module pygame.display)": [[23, "pygame.display.set_gamma", false]], "set_gamma_ramp() (in module pygame.display)": [[23, "pygame.display.set_gamma_ramp", false]], "set_grab() (in module pygame.event)": [[25, "pygame.event.set_grab", false]], "set_icon() (in module pygame.display)": [[23, "pygame.display.set_icon", false]], "set_icon() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.set_icon", false]], "set_instrument() (pygame.midi.output method)": [[37, "pygame.midi.Output.set_instrument", false]], "set_italic() (pygame.font.font method)": [[28, "pygame.font.Font.set_italic", false]], "set_keyboard_grab() (in module pygame.event)": [[25, "pygame.event.set_keyboard_grab", false]], "set_length() (pygame.color method)": [[20, "pygame.Color.set_length", false]], "set_location() (pygame.overlay method)": [[41, "pygame.Overlay.set_location", false]], "set_mapping() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.set_mapping", false]], "set_masks() (pygame.surface method)": [[51, "pygame.Surface.set_masks", false]], "set_modal_for() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.set_modal_for", false]], "set_mode() (in module pygame.display)": [[23, "pygame.display.set_mode", false]], "set_mode() (in module pygame.scrap)": [[46, "pygame.scrap.set_mode", false]], "set_mods() (in module pygame.key)": [[33, "pygame.key.set_mods", false]], "set_num_channels() (in module pygame.mixer)": [[38, "pygame.mixer.set_num_channels", false]], "set_palette() (in module pygame.display)": [[23, "pygame.display.set_palette", false]], "set_palette() (pygame.surface method)": [[51, "pygame.Surface.set_palette", false]], "set_palette_at() (pygame.surface method)": [[51, "pygame.Surface.set_palette_at", false]], "set_pos() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.set_pos", false]], "set_pos() (in module pygame.mouse)": [[39, "pygame.mouse.set_pos", false]], "set_repeat() (in module pygame.key)": [[33, "pygame.key.set_repeat", false]], "set_reserved() (in module pygame.mixer)": [[38, "pygame.mixer.set_reserved", false]], "set_script() (pygame.font.font method)": [[28, "pygame.font.Font.set_script", false]], "set_shifts() (pygame.surface method)": [[51, "pygame.Surface.set_shifts", false]], "set_smoothscale_backend() (in module pygame.transform)": [[56, "pygame.transform.set_smoothscale_backend", false]], "set_strikethrough() (pygame.font.font method)": [[28, "pygame.font.Font.set_strikethrough", false]], "set_text_input_rect() (in module pygame.key)": [[33, "pygame.key.set_text_input_rect", false]], "set_timer() (in module pygame.time)": [[54, "pygame.time.set_timer", false]], "set_timing_threshold() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.set_timing_threshold", false]], "set_timing_treshold() (pygame.sprite.layereddirty method)": [[50, "pygame.sprite.LayeredDirty.set_timing_treshold", false]], "set_underline() (pygame.font.font method)": [[28, "pygame.font.Font.set_underline", false]], "set_viewport() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.set_viewport", false]], "set_visible() (in module pygame.mouse)": [[39, "pygame.mouse.set_visible", false]], "set_volume() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.set_volume", false]], "set_volume() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.set_volume", false]], "set_volume() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.set_volume", false]], "set_windowed() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.set_windowed", false]], "shape (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.shape", false]], "show() (pygame._sdl2.video.window method)": [[48, "pygame._sdl2.video.Window.show", false]], "size (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.size", false]], "size (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.size", false]], "size() (pygame.font.font method)": [[28, "pygame.font.Font.size", false]], "slerp() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.slerp", false]], "slerp() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.slerp", false]], "smoothscale() (in module pygame.transform)": [[56, "pygame.transform.smoothscale", false]], "smoothscale_by() (in module pygame.transform)": [[56, "pygame.transform.smoothscale_by", false]], "sound (class in pygame.mixer)": [[38, "pygame.mixer.Sound", false]], "sound.main() (in module pygame.examples)": [[26, "pygame.examples.sound.main", false]], "sound_array_demos.main() (in module pygame.examples)": [[26, "pygame.examples.sound_array_demos.main", false]], "sprite (class in pygame.sprite)": [[50, "pygame.sprite.Sprite", false]], "spritecollide() (in module pygame.sprite)": [[50, "pygame.sprite.spritecollide", false]], "spritecollideany() (in module pygame.sprite)": [[50, "pygame.sprite.spritecollideany", false]], "sprites() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.sprites", false]], "sprites() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.sprites", false]], "srcrect (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.srcrect", false]], "stars.main() (in module pygame.examples)": [[26, "pygame.examples.stars.main", false]], "start() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.start", false]], "start_text_input() (in module pygame.key)": [[33, "pygame.key.start_text_input", false]], "stop() (in module pygame.mixer)": [[38, "pygame.mixer.stop", false]], "stop() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.stop", false]], "stop() (pygame.camera.camera method)": [[18, "pygame.camera.Camera.stop", false]], "stop() (pygame.cdrom.cd method)": [[19, "pygame.cdrom.CD.stop", false]], "stop() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.stop", false]], "stop() (pygame.mixer.sound method)": [[38, "pygame.mixer.Sound.stop", false]], "stop_rumble() (pygame._sdl2.controller.controller method)": [[47, "pygame._sdl2.controller.Controller.stop_rumble", false]], "stop_rumble() (pygame.joystick.joystick method)": [[32, "pygame.joystick.Joystick.stop_rumble", false]], "stop_text_input() (in module pygame.key)": [[33, "pygame.key.stop_text_input", false]], "strength (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.strength", false]], "strides (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.strides", false]], "strikethrough (pygame.font.font attribute)": [[28, "pygame.font.Font.strikethrough", false]], "strong (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.strong", false]], "style (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.style", false]], "subsurface() (pygame.surface method)": [[51, "pygame.Surface.subsurface", false]], "surface (class in pygame)": [[51, "pygame.Surface", false]], "surface (pygame.pixelarray attribute)": [[42, "pygame.PixelArray.surface", false]], "surface_to_array() (in module pygame.pixelcopy)": [[43, "pygame.pixelcopy.surface_to_array", false]], "switch_layer() (pygame.sprite.layeredupdates method)": [[50, "pygame.sprite.LayeredUpdates.switch_layer", false]], "sysfont() (in module pygame.font)": [[28, "pygame.font.SysFont", false]], "sysfont() (in module pygame.freetype)": [[29, "pygame.freetype.SysFont", false]], "target (pygame._sdl2.video.renderer attribute)": [[48, "pygame._sdl2.video.Renderer.target", false]], "testsprite.main() (in module pygame.examples)": [[26, "pygame.examples.testsprite.main", false]], "texture (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Texture", false]], "texture (pygame._sdl2.video.image attribute)": [[48, "pygame._sdl2.video.Image.texture", false]], "textured_polygon() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.textured_polygon", false]], "threshold() (in module pygame.transform)": [[56, "pygame.transform.threshold", false]], "tick() (pygame.time.clock method)": [[54, "pygame.time.Clock.tick", false]], "tick_busy_loop() (pygame.time.clock method)": [[54, "pygame.time.Clock.tick_busy_loop", false]], "time() (in module pygame.midi)": [[37, "pygame.midi.time", false]], "title (pygame._sdl2.video.window attribute)": [[48, "pygame._sdl2.video.Window.title", false]], "to_surface() (pygame._sdl2.video.renderer method)": [[48, "pygame._sdl2.video.Renderer.to_surface", false]], "to_surface() (pygame.mask.mask method)": [[35, "pygame.mask.Mask.to_surface", false]], "tobytes() (in module pygame.image)": [[31, "pygame.image.tobytes", false]], "toggle_fullscreen() (in module pygame.display)": [[23, "pygame.display.toggle_fullscreen", false]], "tostring() (in module pygame.image)": [[31, "pygame.image.tostring", false]], "transpose() (pygame.pixelarray method)": [[42, "pygame.PixelArray.transpose", false]], "trigon() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.trigon", false]], "type (pygame.cursors.cursor attribute)": [[22, "pygame.cursors.Cursor.type", false]], "type (pygame.event.event attribute)": [[25, "pygame.event.Event.type", false]], "ucs4 (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.ucs4", false]], "underline (pygame.font.font attribute)": [[28, "pygame.font.Font.underline", false]], "underline (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.underline", false]], "underline_adjustment (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.underline_adjustment", false]], "union() (pygame.rect method)": [[45, "pygame.Rect.union", false]], "union_ip() (pygame.rect method)": [[45, "pygame.Rect.union_ip", false]], "unionall() (pygame.rect method)": [[45, "pygame.Rect.unionall", false]], "unionall_ip() (pygame.rect method)": [[45, "pygame.Rect.unionall_ip", false]], "unload() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.unload", false]], "unlock() (pygame.surface method)": [[51, "pygame.Surface.unlock", false]], "unmap_rgb() (pygame.surface method)": [[51, "pygame.Surface.unmap_rgb", false]], "unpause() (in module pygame.mixer)": [[38, "pygame.mixer.unpause", false]], "unpause() (in module pygame.mixer.music)": [[40, "pygame.mixer.music.unpause", false]], "unpause() (pygame.mixer.channel method)": [[38, "pygame.mixer.Channel.unpause", false]], "update() (in module pygame.display)": [[23, "pygame.display.update", false]], "update() (pygame._sdl2.video.texture method)": [[48, "pygame._sdl2.video.Texture.update", false]], "update() (pygame.color method)": [[20, "pygame.Color.update", false]], "update() (pygame.math.vector2 method)": [[36, "pygame.math.Vector2.update", false]], "update() (pygame.math.vector3 method)": [[36, "pygame.math.Vector3.update", false]], "update() (pygame.rect method)": [[45, "pygame.Rect.update", false]], "update() (pygame.sprite.group method)": [[50, "pygame.sprite.Group.update", false]], "update() (pygame.sprite.sprite method)": [[50, "pygame.sprite.Sprite.update", false]], "use_arraytype() (in module pygame.sndarray)": [[49, "pygame.sndarray.use_arraytype", false]], "use_arraytype() (in module pygame.surfarray)": [[52, "pygame.surfarray.use_arraytype", false]], "use_bitmap_strikes (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.use_bitmap_strikes", false]], "vector2 (class in pygame.math)": [[36, "pygame.math.Vector2", false]], "vector3 (class in pygame.math)": [[36, "pygame.math.Vector3", false]], "ver (in module pygame.version)": [[44, "pygame.version.ver", false]], "vernum (in module pygame.version)": [[44, "pygame.version.vernum", false]], "vertical (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.vertical", false]], "vgrade.main() (in module pygame.examples)": [[26, "pygame.examples.vgrade.main", false]], "vline() (in module pygame.gfxdraw)": [[30, "pygame.gfxdraw.vline", false]], "wait() (in module pygame.event)": [[25, "pygame.event.wait", false]], "wait() (in module pygame.fastevent)": [[27, "pygame.fastevent.wait", false]], "wait() (in module pygame.time)": [[54, "pygame.time.wait", false]], "was_init() (in module pygame.freetype)": [[29, "pygame.freetype.was_init", false]], "weakdirtysprite (class in pygame.sprite)": [[50, "pygame.sprite.WeakDirtySprite", false]], "weaksprite (class in pygame.sprite)": [[50, "pygame.sprite.WeakSprite", false]], "wide (pygame.freetype.font attribute)": [[29, "pygame.freetype.Font.wide", false]], "width (pygame._sdl2.video.texture attribute)": [[48, "pygame._sdl2.video.Texture.width", false]], "window (class in pygame._sdl2.video)": [[48, "pygame._sdl2.video.Window", false]], "write() (pygame.bufferproxy method)": [[17, "pygame.BufferProxy.write", false]], "write() (pygame.midi.output method)": [[37, "pygame.midi.Output.write", false]], "write_short() (pygame.midi.output method)": [[37, "pygame.midi.Output.write_short", false]], "write_sys_ex() (pygame.midi.output method)": [[37, "pygame.midi.Output.write_sys_ex", false]]}, "objects": {"": [[13, 0, 1, "c.PG_MAJOR_VERSION", "PG_MAJOR_VERSION"], [13, 0, 1, "c.PG_MINOR_VERSION", "PG_MINOR_VERSION"], [13, 0, 1, "c.PG_PATCH_VERSION", "PG_PATCH_VERSION"], [13, 0, 1, "c.PG_VERSIONNUM", "PG_VERSIONNUM"], [13, 0, 1, "c.PG_VERSION_ATLEAST", "PG_VERSION_ATLEAST"], [1, 1, 1, "c.import_pygame_base", "import_pygame_base"], [1, 1, 1, "c.pgBuffer_AsArrayInterface", "pgBuffer_AsArrayInterface"], [1, 1, 1, "c.pgBuffer_AsArrayStruct", "pgBuffer_AsArrayStruct"], [1, 1, 1, "c.pgBuffer_Release", "pgBuffer_Release"], [2, 1, 1, "c.pgBufproxy_Check", "pgBufproxy_Check"], [2, 1, 1, "c.pgBufproxy_GetParent", "pgBufproxy_GetParent"], [2, 1, 1, "c.pgBufproxy_New", "pgBufproxy_New"], [2, 1, 1, "c.pgBufproxy_Trip", "pgBufproxy_Trip"], [2, 3, 1, "c.pgBufproxy_Type", "pgBufproxy_Type"], [7, 4, 1, "c.pgChannelObject", "pgChannelObject"], [7, 1, 1, "c.pgChannel_AsInt", "pgChannel_AsInt"], [7, 1, 1, "c.pgChannel_Check", "pgChannel_Check"], [7, 1, 1, "c.pgChannel_New", "pgChannel_New"], [7, 3, 1, "c.pgChannel_Type", "pgChannel_Type"], [3, 1, 1, "c.pgColor_Check", "pgColor_Check"], [3, 1, 1, "c.pgColor_New", "pgColor_New"], [3, 1, 1, "c.pgColor_NewLength", "pgColor_NewLength"], [3, 3, 1, "c.pgColor_Type", "pgColor_Type"], [1, 1, 1, "c.pgDict_AsBuffer", "pgDict_AsBuffer"], [5, 4, 1, "c.pgEventObject", "pgEventObject"], [5, 1, 1, "c.pgEvent_Check", "pgEvent_Check"], [5, 1, 1, "c.pgEvent_FillUserEvent", "pgEvent_FillUserEvent"], [5, 1, 1, "c.pgEvent_New", "pgEvent_New"], [5, 1, 1, "c.pgEvent_New2", "pgEvent_New2"], [5, 4, 1, "c.pgEvent_Type", "pgEvent_Type"], [1, 3, 1, "c.pgExc_BufferError", "pgExc_BufferError"], [1, 3, 1, "c.pgExc_SDLError", "pgExc_SDLError"], [6, 4, 1, "c.pgFontObject", "pgFontObject"], [6, 1, 1, "c.pgFont_Check", "pgFont_Check"], [6, 1, 1, "c.pgFont_IS_ALIVE", "pgFont_IS_ALIVE"], [6, 1, 1, "c.pgFont_New", "pgFont_New"], [6, 4, 1, "c.pgFont_Type", "pgFont_Type"], [12, 4, 1, "c.pgLifetimeLockObject", "pgLifetimeLockObject"], [12, 1, 1, "c.pgLifetimeLock_Check", "pgLifetimeLock_Check"], [12, 3, 1, "c.pgLifetimeLock_Type", "pgLifetimeLock_Type"], [1, 1, 1, "c.pgObject_GetBuffer", "pgObject_GetBuffer"], [9, 1, 1, "c.pgRWops_FromFileObject", "pgRWops_FromFileObject"], [9, 1, 1, "c.pgRWops_FromObject", "pgRWops_FromObject"], [9, 1, 1, "c.pgRWops_IsFileObject", "pgRWops_IsFileObject"], [9, 1, 1, "c.pgRWops_ReleaseObject", "pgRWops_ReleaseObject"], [8, 4, 1, "c.pgRectObject", "pgRectObject"], [8, 1, 1, "c.pgRect_AsRect", "pgRect_AsRect"], [8, 1, 1, "c.pgRect_Check", "pgRect_Check"], [8, 1, 1, "c.pgRect_FromObject", "pgRect_FromObject"], [8, 1, 1, "c.pgRect_New", "pgRect_New"], [8, 1, 1, "c.pgRect_New4", "pgRect_New4"], [8, 1, 1, "c.pgRect_Normalize", "pgRect_Normalize"], [8, 3, 1, "c.pgRect_Type", "pgRect_Type"], [7, 4, 1, "c.pgSoundObject", "pgSoundObject"], [7, 1, 1, "c.pgSound_AsChunk", "pgSound_AsChunk"], [7, 1, 1, "c.pgSound_Check", "pgSound_Check"], [7, 1, 1, "c.pgSound_New", "pgSound_New"], [7, 3, 1, "c.pgSound_Type", "pgSound_Type"], [11, 4, 1, "c.pgSurfaceObject", "pgSurfaceObject"], [11, 1, 1, "c.pgSurface_AsSurface", "pgSurface_AsSurface"], [11, 1, 1, "c.pgSurface_Blit", "pgSurface_Blit"], [11, 1, 1, "c.pgSurface_Check", "pgSurface_Check"], [12, 1, 1, "c.pgSurface_Lock", "pgSurface_Lock"], [12, 1, 1, "c.pgSurface_LockBy", "pgSurface_LockBy"], [12, 1, 1, "c.pgSurface_LockLifetime", "pgSurface_LockLifetime"], [11, 1, 1, "c.pgSurface_New", "pgSurface_New"], [11, 1, 1, "c.pgSurface_New2", "pgSurface_New2"], [12, 1, 1, "c.pgSurface_Prep", "pgSurface_Prep"], [11, 3, 1, "c.pgSurface_Type", "pgSurface_Type"], [12, 1, 1, "c.pgSurface_UnLock", "pgSurface_UnLock"], [12, 1, 1, "c.pgSurface_UnLockBy", "pgSurface_UnLockBy"], [12, 1, 1, "c.pgSurface_Unprep", "pgSurface_Unprep"], [4, 4, 1, "c.pgVidInfoObject", "pgVidInfoObject"], [4, 1, 1, "c.pgVidInfo_AsVidInfo", "pgVidInfo_AsVidInfo"], [4, 1, 1, "c.pgVidInfo_Check", "pgVidInfo_Check"], [4, 1, 1, "c.pgVidInfo_New", "pgVidInfo_New"], [4, 3, 1, "c.pgVidInfo_Type", "pgVidInfo_Type"], [9, 1, 1, "c.pg_EncodeFilePath", "pg_EncodeFilePath"], [9, 1, 1, "c.pg_EncodeString", "pg_EncodeString"], [1, 1, 1, "c.pg_FloatFromObj", "pg_FloatFromObj"], [1, 1, 1, "c.pg_FloatFromObjIndex", "pg_FloatFromObjIndex"], [1, 1, 1, "c.pg_GetDefaultWindow", "pg_GetDefaultWindow"], [1, 1, 1, "c.pg_GetDefaultWindowSurface", "pg_GetDefaultWindowSurface"], [1, 1, 1, "c.pg_IntFromObj", "pg_IntFromObj"], [1, 1, 1, "c.pg_IntFromObjIndex", "pg_IntFromObjIndex"], [1, 1, 1, "c.pg_RGBAFromObj", "pg_RGBAFromObj"], [1, 1, 1, "c.pg_RegisterQuit", "pg_RegisterQuit"], [1, 1, 1, "c.pg_SetDefaultWindow", "pg_SetDefaultWindow"], [1, 1, 1, "c.pg_SetDefaultWindowSurface", "pg_SetDefaultWindowSurface"], [1, 1, 1, "c.pg_TwoFloatsFromObj", "pg_TwoFloatsFromObj"], [1, 1, 1, "c.pg_TwoIntsFromObj", "pg_TwoIntsFromObj"], [1, 1, 1, "c.pg_UintFromObj", "pg_UintFromObj"], [1, 1, 1, "c.pg_UintFromObjIndex", "pg_UintFromObjIndex"], [1, 4, 1, "c.pg_buffer", "pg_buffer"], [1, 1, 1, "c.pg_mod_autoinit", "pg_mod_autoinit"], [1, 1, 1, "c.pg_mod_autoquit", "pg_mod_autoquit"], [44, 5, 0, "-", "pygame"]], "pgBuffer_AsArrayInterface": [[1, 2, 1, "c.pgBuffer_AsArrayInterface", "view_p"]], "pgBuffer_AsArrayStruct": [[1, 2, 1, "c.pgBuffer_AsArrayStruct", "view_p"]], "pgBuffer_Release": [[1, 2, 1, "c.pgBuffer_Release", "pg_view_p"]], "pgBufproxy_Check": [[2, 2, 1, "c.pgBufproxy_Check", "x"]], "pgBufproxy_GetParent": [[2, 2, 1, "c.pgBufproxy_GetParent", "obj"]], "pgBufproxy_New": [[2, 2, 1, "c.pgBufproxy_New", "get_buffer"], [2, 2, 1, "c.pgBufproxy_New", "obj"]], "pgBufproxy_Trip": [[2, 2, 1, "c.pgBufproxy_Trip", "obj"]], "pgChannel_AsInt": [[7, 2, 1, "c.pgChannel_AsInt", "x"]], "pgChannel_Check": [[7, 2, 1, "c.pgChannel_Check", "obj"]], "pgChannel_New": [[7, 2, 1, "c.pgChannel_New", "channelnum"]], "pgColor_Check": [[3, 2, 1, "c.pgColor_Check", "obj"]], "pgColor_New": [[3, 2, 1, "c.pgColor_New", "rgba"]], "pgColor_NewLength": [[3, 2, 1, "c.pgColor_NewLength", "length"], [3, 2, 1, "c.pgColor_NewLength", "rgba"]], "pgDict_AsBuffer": [[1, 2, 1, "c.pgDict_AsBuffer", "dict"], [1, 2, 1, "c.pgDict_AsBuffer", "flags"], [1, 2, 1, "c.pgDict_AsBuffer", "pg_view_p"]], "pgEventObject": [[5, 3, 1, "c.pgEventObject.type", "type"]], "pgEvent_Check": [[5, 2, 1, "c.pgEvent_Check", "x"]], "pgEvent_FillUserEvent": [[5, 2, 1, "c.pgEvent_FillUserEvent", "e"], [5, 2, 1, "c.pgEvent_FillUserEvent", "event"]], "pgEvent_New": [[5, 2, 1, "c.pgEvent_New", "event"]], "pgEvent_New2": [[5, 2, 1, "c.pgEvent_New2", "dict"], [5, 2, 1, "c.pgEvent_New2", "type"]], "pgFont_Check": [[6, 2, 1, "c.pgFont_Check", "x"]], "pgFont_IS_ALIVE": [[6, 2, 1, "c.pgFont_IS_ALIVE", "o"]], "pgFont_New": [[6, 2, 1, "c.pgFont_New", "filename"], [6, 2, 1, "c.pgFont_New", "font_index"]], "pgLifetimeLockObject": [[12, 3, 1, "c.pgLifetimeLockObject.lockobj", "lockobj"], [12, 3, 1, "c.pgLifetimeLockObject.surface", "surface"]], "pgLifetimeLock_Check": [[12, 2, 1, "c.pgLifetimeLock_Check", "x"]], "pgObject_GetBuffer": [[1, 2, 1, "c.pgObject_GetBuffer", "flags"], [1, 2, 1, "c.pgObject_GetBuffer", "obj"], [1, 2, 1, "c.pgObject_GetBuffer", "pg_view_p"]], "pgRWops_FromFileObject": [[9, 2, 1, "c.pgRWops_FromFileObject", "obj"]], "pgRWops_FromObject": [[9, 2, 1, "c.pgRWops_FromObject", "extptr"], [9, 2, 1, "c.pgRWops_FromObject", "obj"]], "pgRWops_IsFileObject": [[9, 2, 1, "c.pgRWops_IsFileObject", "rw"]], "pgRWops_ReleaseObject": [[9, 2, 1, "c.pgRWops_ReleaseObject", "context"]], "pgRectObject": [[8, 3, 1, "c.pgRectObject.r", "r"]], "pgRect_AsRect": [[8, 2, 1, "c.pgRect_AsRect", "obj"]], "pgRect_Check": [[8, 2, 1, "c.pgRect_Check", "obj"]], "pgRect_FromObject": [[8, 2, 1, "c.pgRect_FromObject", "obj"], [8, 2, 1, "c.pgRect_FromObject", "temp"]], "pgRect_New": [[8, 2, 1, "c.pgRect_New", "r"]], "pgRect_New4": [[8, 2, 1, "c.pgRect_New4", "h"], [8, 2, 1, "c.pgRect_New4", "w"], [8, 2, 1, "c.pgRect_New4", "x"], [8, 2, 1, "c.pgRect_New4", "y"]], "pgRect_Normalize": [[8, 2, 1, "c.pgRect_Normalize", "rect"]], "pgSound_AsChunk": [[7, 2, 1, "c.pgSound_AsChunk", "x"]], "pgSound_Check": [[7, 2, 1, "c.pgSound_Check", "obj"]], "pgSound_New": [[7, 2, 1, "c.pgSound_New", "chunk"]], "pgSurface_AsSurface": [[11, 2, 1, "c.pgSurface_AsSurface", "x"]], "pgSurface_Blit": [[11, 2, 1, "c.pgSurface_Blit", "dstobj"], [11, 2, 1, "c.pgSurface_Blit", "dstrect"], [11, 2, 1, "c.pgSurface_Blit", "srcobj"], [11, 2, 1, "c.pgSurface_Blit", "srcrect"], [11, 2, 1, "c.pgSurface_Blit", "the_args"]], "pgSurface_Check": [[11, 2, 1, "c.pgSurface_Check", "x"]], "pgSurface_Lock": [[12, 2, 1, "c.pgSurface_Lock", "surfobj"]], "pgSurface_LockBy": [[12, 2, 1, "c.pgSurface_LockBy", "lockobj"], [12, 2, 1, "c.pgSurface_LockBy", "surfobj"]], "pgSurface_LockLifetime": [[12, 2, 1, "c.pgSurface_LockLifetime", "lockobj"], [12, 2, 1, "c.pgSurface_LockLifetime", "surfobj"]], "pgSurface_New": [[11, 2, 1, "c.pgSurface_New", "s"]], "pgSurface_New2": [[11, 2, 1, "c.pgSurface_New2", "owner"], [11, 2, 1, "c.pgSurface_New2", "s"]], "pgSurface_Prep": [[12, 2, 1, "c.pgSurface_Prep", "surfobj"]], "pgSurface_UnLock": [[12, 2, 1, "c.pgSurface_UnLock", "surfobj"]], "pgSurface_UnLockBy": [[12, 2, 1, "c.pgSurface_UnLockBy", "lockobj"], [12, 2, 1, "c.pgSurface_UnLockBy", "surfobj"]], "pgSurface_Unprep": [[12, 2, 1, "c.pgSurface_Unprep", "surfobj"]], "pgVidInfo_AsVidInfo": [[4, 2, 1, "c.pgVidInfo_AsVidInfo", "obj"]], "pgVidInfo_Check": [[4, 2, 1, "c.pgVidInfo_Check", "x"]], "pgVidInfo_New": [[4, 2, 1, "c.pgVidInfo_New", "i"]], "pg_EncodeFilePath": [[9, 2, 1, "c.pg_EncodeFilePath", "eclass"], [9, 2, 1, "c.pg_EncodeFilePath", "obj"]], "pg_EncodeString": [[9, 2, 1, "c.pg_EncodeString", "eclass"], [9, 2, 1, "c.pg_EncodeString", "encoding"], [9, 2, 1, "c.pg_EncodeString", "errors"], [9, 2, 1, "c.pg_EncodeString", "obj"]], "pg_FloatFromObj": [[1, 2, 1, "c.pg_FloatFromObj", "obj"], [1, 2, 1, "c.pg_FloatFromObj", "val"]], "pg_FloatFromObjIndex": [[1, 2, 1, "c.pg_FloatFromObjIndex", "index"], [1, 2, 1, "c.pg_FloatFromObjIndex", "obj"], [1, 2, 1, "c.pg_FloatFromObjIndex", "val"]], "pg_IntFromObj": [[1, 2, 1, "c.pg_IntFromObj", "obj"], [1, 2, 1, "c.pg_IntFromObj", "val"]], "pg_IntFromObjIndex": [[1, 2, 1, "c.pg_IntFromObjIndex", "index"], [1, 2, 1, "c.pg_IntFromObjIndex", "obj"], [1, 2, 1, "c.pg_IntFromObjIndex", "val"]], "pg_RGBAFromObj": [[1, 2, 1, "c.pg_RGBAFromObj", "RGBA"], [1, 2, 1, "c.pg_RGBAFromObj", "obj"]], "pg_RegisterQuit": [[1, 2, 1, "c.pg_RegisterQuit", "f"]], "pg_SetDefaultWindow": [[1, 2, 1, "c.pg_SetDefaultWindow", "win"]], "pg_SetDefaultWindowSurface": [[1, 2, 1, "c.pg_SetDefaultWindowSurface", "screen"]], "pg_TwoFloatsFromObj": [[1, 2, 1, "c.pg_TwoFloatsFromObj", "obj"], [1, 2, 1, "c.pg_TwoFloatsFromObj", "val1"], [1, 2, 1, "c.pg_TwoFloatsFromObj", "val2"]], "pg_TwoIntsFromObj": [[1, 2, 1, "c.pg_TwoIntsFromObj", "obj"], [1, 2, 1, "c.pg_TwoIntsFromObj", "v2"], [1, 2, 1, "c.pg_TwoIntsFromObj", "val1"]], "pg_UintFromObj": [[1, 2, 1, "c.pg_UintFromObj", "obj"], [1, 2, 1, "c.pg_UintFromObj", "val"]], "pg_UintFromObjIndex": [[1, 2, 1, "c.pg_UintFromObjIndex", "_index"], [1, 2, 1, "c.pg_UintFromObjIndex", "obj"], [1, 2, 1, "c.pg_UintFromObjIndex", "val"]], "pg_buffer": [[1, 3, 1, "c.pg_buffer.consumer", "consumer"], [1, 3, 1, "c.pg_buffer.release_buffer", "release_buffer"], [1, 3, 1, "c.pg_buffer.view", "view"]], "pg_mod_autoinit": [[1, 2, 1, "c.pg_mod_autoinit", "modname"]], "pg_mod_autoquit": [[1, 2, 1, "c.pg_mod_autoquit", "modname"]], "pygame": [[17, 6, 1, "", "BufferProxy"], [20, 6, 1, "", "Color"], [41, 6, 1, "", "Overlay"], [42, 6, 1, "", "PixelArray"], [45, 6, 1, "", "Rect"], [51, 6, 1, "", "Surface"], [18, 5, 0, "-", "camera"], [19, 5, 0, "-", "cdrom"], [22, 5, 0, "-", "cursors"], [23, 5, 0, "-", "display"], [24, 5, 0, "-", "draw"], [44, 9, 1, "", "encode_file_path"], [44, 9, 1, "", "encode_string"], [44, 10, 1, "", "error"], [25, 5, 0, "-", "event"], [26, 5, 0, "-", "examples"], [27, 5, 0, "-", "fastevent"], [28, 5, 0, "-", "font"], [29, 5, 0, "-", "freetype"], [44, 9, 1, "", "get_error"], [44, 9, 1, "", "get_init"], [44, 9, 1, "", "get_sdl_byteorder"], [44, 9, 1, "", "get_sdl_version"], [30, 5, 0, "-", "gfxdraw"], [31, 5, 0, "-", "image"], [44, 9, 1, "", "init"], [32, 5, 0, "-", "joystick"], [33, 5, 0, "-", "key"], [34, 5, 0, "-", "locals"], [35, 5, 0, "-", "mask"], [36, 5, 0, "-", "math"], [37, 5, 0, "-", "midi"], [38, 5, 0, "-", "mixer"], [39, 5, 0, "-", "mouse"], [43, 5, 0, "-", "pixelcopy"], [44, 9, 1, "", "quit"], [44, 9, 1, "", "register_quit"], [46, 5, 0, "-", "scrap"], [44, 9, 1, "", "set_error"], [49, 5, 0, "-", "sndarray"], [50, 5, 0, "-", "sprite"], [52, 5, 0, "-", "surfarray"], [53, 5, 0, "-", "tests"], [54, 5, 0, "-", "time"], [56, 5, 0, "-", "transform"], [44, 5, 0, "-", "version"]], "pygame.BufferProxy": [[17, 7, 1, "", "length"], [17, 7, 1, "", "parent"], [17, 7, 1, "", "raw"], [17, 8, 1, "", "write"]], "pygame.Color": [[20, 7, 1, "", "a"], [20, 7, 1, "", "b"], [20, 7, 1, "", "cmy"], [20, 8, 1, "", "correct_gamma"], [20, 7, 1, "", "g"], [20, 8, 1, "", "grayscale"], [20, 7, 1, "", "hsla"], [20, 7, 1, "", "hsva"], [20, 7, 1, "", "i1i2i3"], [20, 8, 1, "", "lerp"], [20, 8, 1, "", "normalize"], [20, 8, 1, "", "premul_alpha"], [20, 7, 1, "", "r"], [20, 8, 1, "", "set_length"], [20, 8, 1, "", "update"]], "pygame.Overlay": [[41, 8, 1, "", "display"], [41, 8, 1, "", "get_hardware"], [41, 8, 1, "", "set_location"]], "pygame.PixelArray": [[42, 8, 1, "", "close"], [42, 8, 1, "", "compare"], [42, 8, 1, "", "extract"], [42, 7, 1, "", "itemsize"], [42, 8, 1, "", "make_surface"], [42, 7, 1, "", "ndim"], [42, 8, 1, "", "replace"], [42, 7, 1, "", "shape"], [42, 7, 1, "", "strides"], [42, 7, 1, "", "surface"], [42, 8, 1, "", "transpose"]], "pygame.Rect": [[45, 8, 1, "", "clamp"], [45, 8, 1, "", "clamp_ip"], [45, 8, 1, "", "clip"], [45, 8, 1, "", "clipline"], [45, 8, 1, "", "collidedict"], [45, 8, 1, "", "collidedictall"], [45, 8, 1, "", "collidelist"], [45, 8, 1, "", "collidelistall"], [45, 8, 1, "", "collideobjects"], [45, 8, 1, "", "collideobjectsall"], [45, 8, 1, "", "collidepoint"], [45, 8, 1, "", "colliderect"], [45, 8, 1, "", "contains"], [45, 8, 1, "", "copy"], [45, 8, 1, "", "fit"], [45, 8, 1, "", "inflate"], [45, 8, 1, "", "inflate_ip"], [45, 8, 1, "", "move"], [45, 8, 1, "", "move_ip"], [45, 8, 1, "", "normalize"], [45, 8, 1, "", "scale_by"], [45, 8, 1, "", "scale_by_ip"], [45, 8, 1, "", "union"], [45, 8, 1, "", "union_ip"], [45, 8, 1, "", "unionall"], [45, 8, 1, "", "unionall_ip"], [45, 8, 1, "", "update"]], "pygame.Surface": [[51, 7, 1, "", "_pixels_address"], [51, 8, 1, "", "blit"], [51, 8, 1, "", "blits"], [51, 8, 1, "", "convert"], [51, 8, 1, "", "convert_alpha"], [51, 8, 1, "", "copy"], [51, 8, 1, "", "fill"], [51, 8, 1, "", "get_abs_offset"], [51, 8, 1, "", "get_abs_parent"], [51, 8, 1, "", "get_alpha"], [51, 8, 1, "", "get_at"], [51, 8, 1, "", "get_at_mapped"], [51, 8, 1, "", "get_bitsize"], [51, 8, 1, "", "get_bounding_rect"], [51, 8, 1, "", "get_buffer"], [51, 8, 1, "", "get_bytesize"], [51, 8, 1, "", "get_clip"], [51, 8, 1, "", "get_colorkey"], [51, 8, 1, "", "get_flags"], [51, 8, 1, "", "get_height"], [51, 8, 1, "", "get_locked"], [51, 8, 1, "", "get_locks"], [51, 8, 1, "", "get_losses"], [51, 8, 1, "", "get_masks"], [51, 8, 1, "", "get_offset"], [51, 8, 1, "", "get_palette"], [51, 8, 1, "", "get_palette_at"], [51, 8, 1, "", "get_parent"], [51, 8, 1, "", "get_pitch"], [51, 8, 1, "", "get_rect"], [51, 8, 1, "", "get_shifts"], [51, 8, 1, "", "get_size"], [51, 8, 1, "", "get_view"], [51, 8, 1, "", "get_width"], [51, 8, 1, "", "lock"], [51, 8, 1, "", "map_rgb"], [51, 8, 1, "", "mustlock"], [51, 8, 1, "", "premul_alpha"], [51, 8, 1, "", "scroll"], [51, 8, 1, "", "set_alpha"], [51, 8, 1, "", "set_at"], [51, 8, 1, "", "set_clip"], [51, 8, 1, "", "set_colorkey"], [51, 8, 1, "", "set_masks"], [51, 8, 1, "", "set_palette"], [51, 8, 1, "", "set_palette_at"], [51, 8, 1, "", "set_shifts"], [51, 8, 1, "", "subsurface"], [51, 8, 1, "", "unlock"], [51, 8, 1, "", "unmap_rgb"]], "pygame._sdl2": [[47, 5, 0, "-", "controller"], [55, 5, 0, "-", "touch"], [48, 5, 0, "-", "video"]], "pygame._sdl2.controller": [[47, 6, 1, "", "Controller"], [47, 9, 1, "", "get_count"], [47, 9, 1, "", "get_eventstate"], [47, 9, 1, "", "get_init"], [47, 9, 1, "", "init"], [47, 9, 1, "", "is_controller"], [47, 9, 1, "", "name_forindex"], [47, 9, 1, "", "quit"], [47, 9, 1, "", "set_eventstate"]], "pygame._sdl2.controller.Controller": [[47, 8, 1, "", "as_joystick"], [47, 8, 1, "", "attached"], [47, 8, 1, "", "from_joystick"], [47, 8, 1, "", "get_axis"], [47, 8, 1, "", "get_button"], [47, 8, 1, "", "get_init"], [47, 8, 1, "", "get_mapping"], [47, 8, 1, "", "quit"], [47, 8, 1, "", "rumble"], [47, 8, 1, "", "set_mapping"], [47, 8, 1, "", "stop_rumble"]], "pygame._sdl2.touch": [[55, 9, 1, "", "get_device"], [55, 9, 1, "", "get_finger"], [55, 9, 1, "", "get_num_devices"], [55, 9, 1, "", "get_num_fingers"]], "pygame._sdl2.video": [[48, 6, 1, "", "Image"], [48, 6, 1, "", "Renderer"], [48, 6, 1, "", "Texture"], [48, 6, 1, "", "Window"]], "pygame._sdl2.video.Image": [[48, 7, 1, "", "alpha"], [48, 7, 1, "", "angle"], [48, 7, 1, "", "blend_mode"], [48, 7, 1, "", "color"], [48, 8, 1, "", "draw"], [48, 7, 1, "", "flip_x"], [48, 7, 1, "", "flip_y"], [48, 8, 1, "", "get_rect"], [48, 7, 1, "", "origin"], [48, 7, 1, "", "srcrect"], [48, 7, 1, "", "texture"]], "pygame._sdl2.video.Renderer": [[48, 8, 1, "", "blit"], [48, 8, 1, "", "clear"], [48, 7, 1, "", "draw_blend_mode"], [48, 7, 1, "", "draw_color"], [48, 8, 1, "", "draw_line"], [48, 8, 1, "", "draw_point"], [48, 8, 1, "", "draw_rect"], [48, 8, 1, "", "fill_rect"], [48, 8, 1, "", "from_window"], [48, 8, 1, "", "get_viewport"], [48, 7, 1, "", "logical_size"], [48, 8, 1, "", "present"], [48, 7, 1, "", "scale"], [48, 8, 1, "", "set_viewport"], [48, 7, 1, "", "target"], [48, 8, 1, "", "to_surface"]], "pygame._sdl2.video.Texture": [[48, 7, 1, "", "alpha"], [48, 7, 1, "", "blend_mode"], [48, 7, 1, "", "color"], [48, 8, 1, "", "draw"], [48, 8, 1, "", "from_surface"], [48, 8, 1, "", "get_rect"], [48, 7, 1, "", "height"], [48, 7, 1, "", "renderer"], [48, 8, 1, "", "update"], [48, 7, 1, "", "width"]], "pygame._sdl2.video.Window": [[48, 7, 1, "", "borderless"], [48, 8, 1, "", "destroy"], [48, 7, 1, "", "display_index"], [48, 8, 1, "", "focus"], [48, 8, 1, "", "from_display_module"], [48, 8, 1, "", "from_window"], [48, 7, 1, "", "grab"], [48, 8, 1, "", "hide"], [48, 7, 1, "", "id"], [48, 8, 1, "", "maximize"], [48, 8, 1, "", "minimize"], [48, 7, 1, "", "opacity"], [48, 7, 1, "", "position"], [48, 7, 1, "", "relative_mouse"], [48, 7, 1, "", "resizable"], [48, 8, 1, "", "restore"], [48, 8, 1, "", "set_fullscreen"], [48, 8, 1, "", "set_icon"], [48, 8, 1, "", "set_modal_for"], [48, 8, 1, "", "set_windowed"], [48, 8, 1, "", "show"], [48, 7, 1, "", "size"], [48, 7, 1, "", "title"]], "pygame.camera": [[18, 6, 1, "", "Camera"], [18, 9, 1, "", "colorspace"], [18, 9, 1, "", "get_backends"], [18, 9, 1, "", "init"], [18, 9, 1, "", "list_cameras"]], "pygame.camera.Camera": [[18, 8, 1, "", "get_controls"], [18, 8, 1, "", "get_image"], [18, 8, 1, "", "get_raw"], [18, 8, 1, "", "get_size"], [18, 8, 1, "", "query_image"], [18, 8, 1, "", "set_controls"], [18, 8, 1, "", "start"], [18, 8, 1, "", "stop"]], "pygame.cdrom": [[19, 6, 1, "", "CD"], [19, 9, 1, "", "get_count"], [19, 9, 1, "", "get_init"], [19, 9, 1, "", "init"], [19, 9, 1, "", "quit"]], "pygame.cdrom.CD": [[19, 8, 1, "", "eject"], [19, 8, 1, "", "get_all"], [19, 8, 1, "", "get_busy"], [19, 8, 1, "", "get_current"], [19, 8, 1, "", "get_empty"], [19, 8, 1, "", "get_id"], [19, 8, 1, "", "get_init"], [19, 8, 1, "", "get_name"], [19, 8, 1, "", "get_numtracks"], [19, 8, 1, "", "get_paused"], [19, 8, 1, "", "get_track_audio"], [19, 8, 1, "", "get_track_length"], [19, 8, 1, "", "get_track_start"], [19, 8, 1, "", "init"], [19, 8, 1, "", "pause"], [19, 8, 1, "", "play"], [19, 8, 1, "", "quit"], [19, 8, 1, "", "resume"], [19, 8, 1, "", "stop"]], "pygame.cursors": [[22, 6, 1, "", "Cursor"], [22, 9, 1, "", "compile"], [22, 9, 1, "", "load_xbm"]], "pygame.cursors.Cursor": [[22, 8, 1, "", "copy"], [22, 7, 1, "", "data"], [22, 7, 1, "", "type"]], "pygame.display": [[23, 9, 1, "", "Info"], [23, 9, 1, "", "flip"], [23, 9, 1, "", "get_active"], [23, 9, 1, "", "get_allow_screensaver"], [23, 9, 1, "", "get_caption"], [23, 9, 1, "", "get_desktop_sizes"], [23, 9, 1, "", "get_driver"], [23, 9, 1, "", "get_init"], [23, 9, 1, "", "get_num_displays"], [23, 9, 1, "", "get_surface"], [23, 9, 1, "", "get_window_size"], [23, 9, 1, "", "get_wm_info"], [23, 9, 1, "", "gl_get_attribute"], [23, 9, 1, "", "gl_set_attribute"], [23, 9, 1, "", "iconify"], [23, 9, 1, "", "init"], [23, 9, 1, "", "list_modes"], [23, 9, 1, "", "mode_ok"], [23, 9, 1, "", "quit"], [23, 9, 1, "", "set_allow_screensaver"], [23, 9, 1, "", "set_caption"], [23, 9, 1, "", "set_gamma"], [23, 9, 1, "", "set_gamma_ramp"], [23, 9, 1, "", "set_icon"], [23, 9, 1, "", "set_mode"], [23, 9, 1, "", "set_palette"], [23, 9, 1, "", "toggle_fullscreen"], [23, 9, 1, "", "update"]], "pygame.draw": [[24, 9, 1, "", "aaline"], [24, 9, 1, "", "aalines"], [24, 9, 1, "", "arc"], [24, 9, 1, "", "circle"], [24, 9, 1, "", "ellipse"], [24, 9, 1, "", "line"], [24, 9, 1, "", "lines"], [24, 9, 1, "", "polygon"], [24, 9, 1, "", "rect"]], "pygame.event": [[25, 6, 1, "", "Event"], [25, 9, 1, "", "clear"], [25, 9, 1, "", "custom_type"], [25, 9, 1, "", "event_name"], [25, 9, 1, "", "get"], [25, 9, 1, "", "get_blocked"], [25, 9, 1, "", "get_grab"], [25, 9, 1, "", "get_keyboard_grab"], [25, 9, 1, "", "peek"], [25, 9, 1, "", "poll"], [25, 9, 1, "", "post"], [25, 9, 1, "", "pump"], [25, 9, 1, "", "set_allowed"], [25, 9, 1, "", "set_blocked"], [25, 9, 1, "", "set_grab"], [25, 9, 1, "", "set_keyboard_grab"], [25, 9, 1, "", "wait"]], "pygame.event.Event": [[25, 7, 1, "", "__dict__"], [25, 7, 1, "", "type"]], "pygame.examples.aliens": [[26, 9, 1, "", "main"]], "pygame.examples.arraydemo": [[26, 9, 1, "", "main"]], "pygame.examples.blend_fill": [[26, 9, 1, "", "main"]], "pygame.examples.blit_blends": [[26, 9, 1, "", "main"]], "pygame.examples.camera": [[26, 9, 1, "", "main"]], "pygame.examples.chimp": [[26, 9, 1, "", "main"]], "pygame.examples.cursors": [[26, 9, 1, "", "main"]], "pygame.examples.eventlist": [[26, 9, 1, "", "main"]], "pygame.examples.fonty": [[26, 9, 1, "", "main"]], "pygame.examples.freetype_misc": [[26, 9, 1, "", "main"]], "pygame.examples.glcube": [[26, 9, 1, "", "main"]], "pygame.examples.headless_no_windows_needed": [[26, 9, 1, "", "main"]], "pygame.examples.joystick": [[26, 9, 1, "", "main"]], "pygame.examples.liquid": [[26, 9, 1, "", "main"]], "pygame.examples.mask": [[26, 9, 1, "", "main"]], "pygame.examples.midi": [[26, 9, 1, "", "main"]], "pygame.examples.moveit": [[26, 9, 1, "", "main"]], "pygame.examples.pixelarray": [[26, 9, 1, "", "main"]], "pygame.examples.playmus": [[26, 9, 1, "", "main"]], "pygame.examples.scaletest": [[26, 9, 1, "", "main"]], "pygame.examples.scrap_clipboard": [[26, 9, 1, "", "main"]], "pygame.examples.scroll": [[26, 9, 1, "", "main"]], "pygame.examples.sound": [[26, 9, 1, "", "main"]], "pygame.examples.sound_array_demos": [[26, 9, 1, "", "main"]], "pygame.examples.stars": [[26, 9, 1, "", "main"]], "pygame.examples.testsprite": [[26, 9, 1, "", "main"]], "pygame.examples.vgrade": [[26, 9, 1, "", "main"]], "pygame.fastevent": [[27, 9, 1, "", "get"], [27, 9, 1, "", "get_init"], [27, 9, 1, "", "init"], [27, 9, 1, "", "poll"], [27, 9, 1, "", "post"], [27, 9, 1, "", "pump"], [27, 9, 1, "", "wait"]], "pygame.font": [[28, 6, 1, "", "Font"], [28, 9, 1, "", "SysFont"], [28, 9, 1, "", "get_default_font"], [28, 9, 1, "", "get_fonts"], [28, 9, 1, "", "get_init"], [28, 9, 1, "", "get_sdl_ttf_version"], [28, 9, 1, "", "init"], [28, 9, 1, "", "match_font"], [28, 9, 1, "", "quit"]], "pygame.font.Font": [[28, 7, 1, "", "bold"], [28, 8, 1, "", "get_ascent"], [28, 8, 1, "", "get_bold"], [28, 8, 1, "", "get_descent"], [28, 8, 1, "", "get_height"], [28, 8, 1, "", "get_italic"], [28, 8, 1, "", "get_linesize"], [28, 8, 1, "", "get_strikethrough"], [28, 8, 1, "", "get_underline"], [28, 7, 1, "", "italic"], [28, 8, 1, "", "metrics"], [28, 8, 1, "", "render"], [28, 8, 1, "", "set_bold"], [28, 8, 1, "", "set_italic"], [28, 8, 1, "", "set_script"], [28, 8, 1, "", "set_strikethrough"], [28, 8, 1, "", "set_underline"], [28, 8, 1, "", "size"], [28, 7, 1, "", "strikethrough"], [28, 7, 1, "", "underline"]], "pygame.freetype": [[29, 6, 1, "", "Font"], [29, 9, 1, "", "SysFont"], [29, 9, 1, "", "get_cache_size"], [29, 9, 1, "", "get_default_font"], [29, 9, 1, "", "get_default_resolution"], [29, 9, 1, "", "get_error"], [29, 9, 1, "", "get_init"], [29, 9, 1, "", "get_version"], [29, 9, 1, "", "init"], [29, 9, 1, "", "quit"], [29, 9, 1, "", "set_default_resolution"], [29, 9, 1, "", "was_init"]], "pygame.freetype.Font": [[29, 7, 1, "", "antialiased"], [29, 7, 1, "", "ascender"], [29, 7, 1, "", "bgcolor"], [29, 7, 1, "", "descender"], [29, 7, 1, "", "fgcolor"], [29, 7, 1, "", "fixed_sizes"], [29, 7, 1, "", "fixed_width"], [29, 8, 1, "", "get_metrics"], [29, 8, 1, "", "get_rect"], [29, 8, 1, "", "get_sized_ascender"], [29, 8, 1, "", "get_sized_descender"], [29, 8, 1, "", "get_sized_glyph_height"], [29, 8, 1, "", "get_sized_height"], [29, 8, 1, "", "get_sizes"], [29, 7, 1, "", "height"], [29, 7, 1, "", "kerning"], [29, 7, 1, "", "name"], [29, 7, 1, "", "oblique"], [29, 7, 1, "", "origin"], [29, 7, 1, "", "pad"], [29, 7, 1, "", "path"], [29, 8, 1, "", "render"], [29, 8, 1, "", "render_raw"], [29, 8, 1, "", "render_raw_to"], [29, 8, 1, "", "render_to"], [29, 7, 1, "", "resolution"], [29, 7, 1, "", "rotation"], [29, 7, 1, "", "scalable"], [29, 7, 1, "", "size"], [29, 7, 1, "", "strength"], [29, 7, 1, "", "strong"], [29, 7, 1, "", "style"], [29, 7, 1, "", "ucs4"], [29, 7, 1, "", "underline"], [29, 7, 1, "", "underline_adjustment"], [29, 7, 1, "", "use_bitmap_strikes"], [29, 7, 1, "", "vertical"], [29, 7, 1, "", "wide"]], "pygame.gfxdraw": [[30, 9, 1, "", "aacircle"], [30, 9, 1, "", "aaellipse"], [30, 9, 1, "", "aapolygon"], [30, 9, 1, "", "aatrigon"], [30, 9, 1, "", "arc"], [30, 9, 1, "", "bezier"], [30, 9, 1, "", "box"], [30, 9, 1, "", "circle"], [30, 9, 1, "", "ellipse"], [30, 9, 1, "", "filled_circle"], [30, 9, 1, "", "filled_ellipse"], [30, 9, 1, "", "filled_polygon"], [30, 9, 1, "", "filled_trigon"], [30, 9, 1, "", "hline"], [30, 9, 1, "", "line"], [30, 9, 1, "", "pie"], [30, 9, 1, "", "pixel"], [30, 9, 1, "", "polygon"], [30, 9, 1, "", "rectangle"], [30, 9, 1, "", "textured_polygon"], [30, 9, 1, "", "trigon"], [30, 9, 1, "", "vline"]], "pygame.image": [[31, 9, 1, "", "frombuffer"], [31, 9, 1, "", "frombytes"], [31, 9, 1, "", "fromstring"], [31, 9, 1, "", "get_extended"], [31, 9, 1, "", "get_sdl_image_version"], [31, 9, 1, "", "load"], [31, 9, 1, "", "load_basic"], [31, 9, 1, "", "load_extended"], [31, 9, 1, "", "save"], [31, 9, 1, "", "save_extended"], [31, 9, 1, "", "tobytes"], [31, 9, 1, "", "tostring"]], "pygame.joystick": [[32, 6, 1, "", "Joystick"], [32, 9, 1, "", "get_count"], [32, 9, 1, "", "get_init"], [32, 9, 1, "", "init"], [32, 9, 1, "", "quit"]], "pygame.joystick.Joystick": [[32, 8, 1, "", "get_axis"], [32, 8, 1, "", "get_ball"], [32, 8, 1, "", "get_button"], [32, 8, 1, "", "get_guid"], [32, 8, 1, "", "get_hat"], [32, 8, 1, "", "get_id"], [32, 8, 1, "", "get_init"], [32, 8, 1, "", "get_instance_id"], [32, 8, 1, "", "get_name"], [32, 8, 1, "", "get_numaxes"], [32, 8, 1, "", "get_numballs"], [32, 8, 1, "", "get_numbuttons"], [32, 8, 1, "", "get_numhats"], [32, 8, 1, "", "get_power_level"], [32, 8, 1, "", "init"], [32, 8, 1, "", "quit"], [32, 8, 1, "", "rumble"], [32, 8, 1, "", "stop_rumble"]], "pygame.key": [[33, 9, 1, "", "get_focused"], [33, 9, 1, "", "get_mods"], [33, 9, 1, "", "get_pressed"], [33, 9, 1, "", "get_repeat"], [33, 9, 1, "", "key_code"], [33, 9, 1, "", "name"], [33, 9, 1, "", "set_mods"], [33, 9, 1, "", "set_repeat"], [33, 9, 1, "", "set_text_input_rect"], [33, 9, 1, "", "start_text_input"], [33, 9, 1, "", "stop_text_input"]], "pygame.mask": [[35, 6, 1, "", "Mask"], [35, 9, 1, "", "from_surface"], [35, 9, 1, "", "from_threshold"]], "pygame.mask.Mask": [[35, 8, 1, "", "angle"], [35, 8, 1, "", "centroid"], [35, 8, 1, "", "clear"], [35, 8, 1, "", "connected_component"], [35, 8, 1, "", "connected_components"], [35, 8, 1, "", "convolve"], [35, 8, 1, "", "copy"], [35, 8, 1, "", "count"], [35, 8, 1, "", "draw"], [35, 8, 1, "", "erase"], [35, 8, 1, "", "fill"], [35, 8, 1, "", "get_at"], [35, 8, 1, "", "get_bounding_rects"], [35, 8, 1, "", "get_rect"], [35, 8, 1, "", "get_size"], [35, 8, 1, "", "invert"], [35, 8, 1, "", "outline"], [35, 8, 1, "", "overlap"], [35, 8, 1, "", "overlap_area"], [35, 8, 1, "", "overlap_mask"], [35, 8, 1, "", "scale"], [35, 8, 1, "", "set_at"], [35, 8, 1, "", "to_surface"]], "pygame.math": [[36, 6, 1, "", "Vector2"], [36, 6, 1, "", "Vector3"], [36, 9, 1, "", "clamp"], [36, 9, 1, "", "lerp"]], "pygame.math.Vector2": [[36, 8, 1, "", "angle_to"], [36, 8, 1, "", "as_polar"], [36, 8, 1, "", "clamp_magnitude"], [36, 8, 1, "", "clamp_magnitude_ip"], [36, 8, 1, "", "copy"], [36, 8, 1, "", "cross"], [36, 8, 1, "", "distance_squared_to"], [36, 8, 1, "", "distance_to"], [36, 8, 1, "", "dot"], [36, 8, 1, "", "elementwise"], [36, 7, 1, "", "epsilon"], [36, 8, 1, "", "from_polar"], [36, 8, 1, "", "is_normalized"], [36, 8, 1, "", "length"], [36, 8, 1, "", "length_squared"], [36, 8, 1, "", "lerp"], [36, 8, 1, "", "magnitude"], [36, 8, 1, "", "magnitude_squared"], [36, 8, 1, "", "move_towards"], [36, 8, 1, "", "move_towards_ip"], [36, 8, 1, "", "normalize"], [36, 8, 1, "", "normalize_ip"], [36, 8, 1, "", "project"], [36, 8, 1, "", "reflect"], [36, 8, 1, "", "reflect_ip"], [36, 8, 1, "", "rotate"], [36, 8, 1, "", "rotate_ip"], [36, 8, 1, "", "rotate_ip_rad"], [36, 8, 1, "", "rotate_rad"], [36, 8, 1, "", "rotate_rad_ip"], [36, 8, 1, "", "scale_to_length"], [36, 8, 1, "", "slerp"], [36, 8, 1, "", "update"]], "pygame.math.Vector3": [[36, 8, 1, "", "angle_to"], [36, 8, 1, "", "as_spherical"], [36, 8, 1, "", "clamp_magnitude"], [36, 8, 1, "", "clamp_magnitude_ip"], [36, 8, 1, "", "copy"], [36, 8, 1, "", "cross"], [36, 8, 1, "", "distance_squared_to"], [36, 8, 1, "", "distance_to"], [36, 8, 1, "", "dot"], [36, 8, 1, "", "elementwise"], [36, 7, 1, "", "epsilon"], [36, 8, 1, "", "from_spherical"], [36, 8, 1, "", "is_normalized"], [36, 8, 1, "", "length"], [36, 8, 1, "", "length_squared"], [36, 8, 1, "", "lerp"], [36, 8, 1, "", "magnitude"], [36, 8, 1, "", "magnitude_squared"], [36, 8, 1, "", "move_towards"], [36, 8, 1, "", "move_towards_ip"], [36, 8, 1, "", "normalize"], [36, 8, 1, "", "normalize_ip"], [36, 8, 1, "", "project"], [36, 8, 1, "", "reflect"], [36, 8, 1, "", "reflect_ip"], [36, 8, 1, "", "rotate"], [36, 8, 1, "", "rotate_ip"], [36, 8, 1, "", "rotate_ip_rad"], [36, 8, 1, "", "rotate_rad"], [36, 8, 1, "", "rotate_rad_ip"], [36, 8, 1, "", "rotate_x"], [36, 8, 1, "", "rotate_x_ip"], [36, 8, 1, "", "rotate_x_ip_rad"], [36, 8, 1, "", "rotate_x_rad"], [36, 8, 1, "", "rotate_x_rad_ip"], [36, 8, 1, "", "rotate_y"], [36, 8, 1, "", "rotate_y_ip"], [36, 8, 1, "", "rotate_y_ip_rad"], [36, 8, 1, "", "rotate_y_rad"], [36, 8, 1, "", "rotate_y_rad_ip"], [36, 8, 1, "", "rotate_z"], [36, 8, 1, "", "rotate_z_ip"], [36, 8, 1, "", "rotate_z_ip_rad"], [36, 8, 1, "", "rotate_z_rad"], [36, 8, 1, "", "rotate_z_rad_ip"], [36, 8, 1, "", "scale_to_length"], [36, 8, 1, "", "slerp"], [36, 8, 1, "", "update"]], "pygame.midi": [[37, 6, 1, "", "Input"], [37, 10, 1, "", "MidiException"], [37, 6, 1, "", "Output"], [37, 9, 1, "", "frequency_to_midi"], [37, 9, 1, "", "get_count"], [37, 9, 1, "", "get_default_input_id"], [37, 9, 1, "", "get_default_output_id"], [37, 9, 1, "", "get_device_info"], [37, 9, 1, "", "get_init"], [37, 9, 1, "", "init"], [37, 9, 1, "", "midi_to_ansi_note"], [37, 9, 1, "", "midi_to_frequency"], [37, 9, 1, "", "midis2events"], [37, 9, 1, "", "quit"], [37, 9, 1, "", "time"]], "pygame.midi.Input": [[37, 8, 1, "", "close"], [37, 8, 1, "", "poll"], [37, 8, 1, "", "read"]], "pygame.midi.Output": [[37, 8, 1, "", "abort"], [37, 8, 1, "", "close"], [37, 8, 1, "", "note_off"], [37, 8, 1, "", "note_on"], [37, 8, 1, "", "pitch_bend"], [37, 8, 1, "", "set_instrument"], [37, 8, 1, "", "write"], [37, 8, 1, "", "write_short"], [37, 8, 1, "", "write_sys_ex"]], "pygame.mixer": [[38, 6, 1, "", "Channel"], [38, 6, 1, "", "Sound"], [38, 9, 1, "", "fadeout"], [38, 9, 1, "", "find_channel"], [38, 9, 1, "", "get_busy"], [38, 9, 1, "", "get_init"], [38, 9, 1, "", "get_num_channels"], [38, 9, 1, "", "get_sdl_mixer_version"], [38, 9, 1, "", "init"], [40, 5, 0, "-", "music"], [38, 9, 1, "", "pause"], [38, 9, 1, "", "pre_init"], [38, 9, 1, "", "quit"], [38, 9, 1, "", "set_num_channels"], [38, 9, 1, "", "set_reserved"], [38, 9, 1, "", "stop"], [38, 9, 1, "", "unpause"]], "pygame.mixer.Channel": [[38, 8, 1, "", "fadeout"], [38, 8, 1, "", "get_busy"], [38, 8, 1, "", "get_endevent"], [38, 8, 1, "", "get_queue"], [38, 8, 1, "", "get_sound"], [38, 8, 1, "", "get_volume"], [38, 8, 1, "", "pause"], [38, 8, 1, "", "play"], [38, 8, 1, "", "queue"], [38, 8, 1, "", "set_endevent"], [38, 8, 1, "", "set_volume"], [38, 8, 1, "", "stop"], [38, 8, 1, "", "unpause"]], "pygame.mixer.Sound": [[38, 8, 1, "", "fadeout"], [38, 8, 1, "", "get_length"], [38, 8, 1, "", "get_num_channels"], [38, 8, 1, "", "get_raw"], [38, 8, 1, "", "get_volume"], [38, 8, 1, "", "play"], [38, 8, 1, "", "set_volume"], [38, 8, 1, "", "stop"]], "pygame.mixer.music": [[40, 9, 1, "", "fadeout"], [40, 9, 1, "", "get_busy"], [40, 9, 1, "", "get_endevent"], [40, 9, 1, "", "get_pos"], [40, 9, 1, "", "get_volume"], [40, 9, 1, "", "load"], [40, 9, 1, "", "pause"], [40, 9, 1, "", "play"], [40, 9, 1, "", "queue"], [40, 9, 1, "", "rewind"], [40, 9, 1, "", "set_endevent"], [40, 9, 1, "", "set_pos"], [40, 9, 1, "", "set_volume"], [40, 9, 1, "", "stop"], [40, 9, 1, "", "unload"], [40, 9, 1, "", "unpause"]], "pygame.mouse": [[39, 9, 1, "", "get_cursor"], [39, 9, 1, "", "get_focused"], [39, 9, 1, "", "get_pos"], [39, 9, 1, "", "get_pressed"], [39, 9, 1, "", "get_rel"], [39, 9, 1, "", "get_visible"], [39, 9, 1, "", "set_cursor"], [39, 9, 1, "", "set_pos"], [39, 9, 1, "", "set_visible"]], "pygame.pixelcopy": [[43, 9, 1, "", "array_to_surface"], [43, 9, 1, "", "make_surface"], [43, 9, 1, "", "map_array"], [43, 9, 1, "", "surface_to_array"]], "pygame.scrap": [[46, 9, 1, "", "contains"], [46, 9, 1, "", "get"], [46, 9, 1, "", "get_init"], [46, 9, 1, "", "get_types"], [46, 9, 1, "", "init"], [46, 9, 1, "", "lost"], [46, 9, 1, "", "put"], [46, 9, 1, "", "set_mode"]], "pygame.sndarray": [[49, 9, 1, "", "array"], [49, 9, 1, "", "get_arraytype"], [49, 9, 1, "", "get_arraytypes"], [49, 9, 1, "", "make_sound"], [49, 9, 1, "", "samples"], [49, 9, 1, "", "use_arraytype"]], "pygame.sprite": [[50, 6, 1, "", "DirtySprite"], [50, 6, 1, "", "Group"], [50, 9, 1, "", "GroupSingle"], [50, 6, 1, "", "LayeredDirty"], [50, 6, 1, "", "LayeredUpdates"], [50, 9, 1, "", "OrderedUpdates"], [50, 6, 1, "", "RenderClear"], [50, 6, 1, "", "RenderPlain"], [50, 6, 1, "", "RenderUpdates"], [50, 6, 1, "", "Sprite"], [50, 6, 1, "", "WeakDirtySprite"], [50, 6, 1, "", "WeakSprite"], [50, 9, 1, "", "collide_circle"], [50, 9, 1, "", "collide_circle_ratio"], [50, 9, 1, "", "collide_mask"], [50, 9, 1, "", "collide_rect"], [50, 9, 1, "", "collide_rect_ratio"], [50, 9, 1, "", "groupcollide"], [50, 9, 1, "", "spritecollide"], [50, 9, 1, "", "spritecollideany"]], "pygame.sprite.Group": [[50, 8, 1, "", "add"], [50, 8, 1, "", "clear"], [50, 8, 1, "", "copy"], [50, 8, 1, "", "draw"], [50, 8, 1, "", "empty"], [50, 8, 1, "", "has"], [50, 8, 1, "", "remove"], [50, 8, 1, "", "sprites"], [50, 8, 1, "", "update"]], "pygame.sprite.LayeredDirty": [[50, 8, 1, "", "change_layer"], [50, 8, 1, "", "clear"], [50, 8, 1, "", "draw"], [50, 8, 1, "", "get_clip"], [50, 8, 1, "", "repaint_rect"], [50, 8, 1, "", "set_clip"], [50, 8, 1, "", "set_timing_threshold"], [50, 8, 1, "", "set_timing_treshold"]], "pygame.sprite.LayeredUpdates": [[50, 8, 1, "", "add"], [50, 8, 1, "", "change_layer"], [50, 8, 1, "", "draw"], [50, 8, 1, "", "get_bottom_layer"], [50, 8, 1, "", "get_layer_of_sprite"], [50, 8, 1, "", "get_sprite"], [50, 8, 1, "", "get_sprites_at"], [50, 8, 1, "", "get_sprites_from_layer"], [50, 8, 1, "", "get_top_layer"], [50, 8, 1, "", "get_top_sprite"], [50, 8, 1, "", "layers"], [50, 8, 1, "", "move_to_back"], [50, 8, 1, "", "move_to_front"], [50, 8, 1, "", "remove_sprites_of_layer"], [50, 8, 1, "", "sprites"], [50, 8, 1, "", "switch_layer"]], "pygame.sprite.RenderUpdates": [[50, 8, 1, "", "draw"]], "pygame.sprite.Sprite": [[50, 8, 1, "", "add"], [50, 8, 1, "", "alive"], [50, 8, 1, "", "groups"], [50, 8, 1, "", "kill"], [50, 8, 1, "", "remove"], [50, 8, 1, "", "update"]], "pygame.surfarray": [[52, 9, 1, "", "array2d"], [52, 9, 1, "", "array3d"], [52, 9, 1, "", "array_alpha"], [52, 9, 1, "", "array_blue"], [52, 9, 1, "", "array_colorkey"], [52, 9, 1, "", "array_green"], [52, 9, 1, "", "array_red"], [52, 9, 1, "", "blit_array"], [52, 9, 1, "", "get_arraytype"], [52, 9, 1, "", "get_arraytypes"], [52, 9, 1, "", "make_surface"], [52, 9, 1, "", "map_array"], [52, 9, 1, "", "pixels2d"], [52, 9, 1, "", "pixels3d"], [52, 9, 1, "", "pixels_alpha"], [52, 9, 1, "", "pixels_blue"], [52, 9, 1, "", "pixels_green"], [52, 9, 1, "", "pixels_red"], [52, 9, 1, "", "use_arraytype"]], "pygame.tests": [[53, 9, 1, "", "run"]], "pygame.time": [[54, 6, 1, "", "Clock"], [54, 9, 1, "", "delay"], [54, 9, 1, "", "get_ticks"], [54, 9, 1, "", "set_timer"], [54, 9, 1, "", "wait"]], "pygame.time.Clock": [[54, 8, 1, "", "get_fps"], [54, 8, 1, "", "get_rawtime"], [54, 8, 1, "", "get_time"], [54, 8, 1, "", "tick"], [54, 8, 1, "", "tick_busy_loop"]], "pygame.transform": [[56, 9, 1, "", "average_color"], [56, 9, 1, "", "average_surfaces"], [56, 9, 1, "", "chop"], [56, 9, 1, "", "flip"], [56, 9, 1, "", "get_smoothscale_backend"], [56, 9, 1, "", "grayscale"], [56, 9, 1, "", "laplacian"], [56, 9, 1, "", "rotate"], [56, 9, 1, "", "rotozoom"], [56, 9, 1, "", "scale"], [56, 9, 1, "", "scale2x"], [56, 9, 1, "", "scale_by"], [56, 9, 1, "", "set_smoothscale_backend"], [56, 9, 1, "", "smoothscale"], [56, 9, 1, "", "smoothscale_by"], [56, 9, 1, "", "threshold"]], "pygame.version": [[44, 11, 1, "", "SDL"], [44, 11, 1, "", "rev"], [44, 11, 1, "", "ver"], [44, 11, 1, "", "vernum"]]}, "objnames": {"0": ["c", "macro", "C macro"], "1": ["c", "function", "C function"], "2": ["c", "functionParam", "C function parameter"], "3": ["c", "member", "C member"], "4": ["c", "type", "C type"], "5": ["py", "module", "Python module"], "6": ["py", "class", "Python class"], "7": ["py", "attribute", "Python attribute"], "8": ["py", "method", "Python method"], "9": ["py", "function", "Python function"], "10": ["py", "exception", "Python exception"], "11": ["py", "data", "Python data"]}, "objtypes": {"0": "c:macro", "1": "c:function", "2": "c:functionParam", "3": "c:member", "4": "c:type", "5": "py:module", "6": "py:class", "7": "py:attribute", "8": "py:method", "9": "py:function", "10": "py:exception", "11": "py:data"}, "terms": {"": [8, 11, 12, 14, 17, 20, 22, 23, 24, 25, 26, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 50, 51, 54, 56, 58, 59, 61, 63, 64, 65, 67, 68, 69, 70, 71, 74, 84, 85, 86, 87, 88, 89], "0": [1, 2, 5, 6, 9, 11, 15, 17, 18, 19, 20, 22, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 47, 48, 50, 51, 52, 54, 55, 56, 57, 58, 59, 62, 63, 64, 65, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 86, 88, 89], "02778": 29, "08333": 29, "0d": 73, "0dev11": 32, "0x00": 20, "0x00000000": 51, "0x00000001": 51, "0x00000004": 51, "0x00000100": 51, "0x00001000": 51, "0x00002000": 51, "0x00004000": 51, "0x00010000": 51, "0x01000000": 51, "0x10": 37, "0x10000": 29, "0x10ffff": 29, "0x11": 37, "0x12": 37, "0x13": 37, "0x7d": 37, "0x90": 37, "0xaacce": 42, "0xc0": 37, "0xd800": 29, "0xdfff": 29, "0xf0": 37, "0xf7": 37, "0xff": 20, "0xff00ff": 42, "0xffff": 23, "0xrrggbb": 20, "0xrrggbbaa": 20, "0\uac1c": [78, 79], "0\ucc28\uc6d0": 81, "1": [1, 2, 3, 5, 8, 11, 13, 15, 16, 17, 18, 20, 22, 23, 24, 25, 26, 28, 29, 30, 31, 33, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 54, 55, 56, 57, 58, 59, 60, 62, 63, 64, 65, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 83, 84], "10": [23, 24, 26, 32, 35, 36, 45, 54, 56, 58, 59, 62, 63, 65, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 84, 85, 88, 89], "100": [20, 24, 36, 37, 51, 57, 62, 65, 84], "1000": [15, 50, 54], "101": 16, "1024": [37, 38], "105": 57, "1080": [23, 59], "1080p": 23, "10th": 35, "10\ub610\ub294": 79, "10\uc758": 76, "10\uc774": 77, "11": [32, 68, 69, 76, 77], "113": 24, "114": 42, "115": 24, "117": 26, "11\uc744": 77, "11\uc758": 76, "11\uc774": 77, "12": [10, 28, 29, 32, 44, 58, 66, 68, 76], "120": 22, "1234": 44, "125": 24, "127": [35, 37, 71, 72, 73, 79, 80, 81], "128": 65, "1280": [15, 58, 66, 84], "13": [32, 63, 65, 68, 76, 89], "135": 24, "14": [25, 32, 47, 68, 76], "140": [75, 76, 77, 78], "145": 57, "14\uc758": 76, "15": [24, 28, 32, 36, 45, 51, 58, 66, 68, 69, 76, 77], "150": [24, 45, 85], "1561": 16, "15924": 28, "15\uc758": 76, "16": [14, 22, 23, 25, 28, 29, 32, 38, 49, 59, 65, 68, 76], "1617": 16, "16711680": 59, "16bit": 38, "17": [63, 68, 76], "170": [42, 57, 58, 66], "179": 24, "17\uc5d0\uc11c\uc758": 76, "18": [24, 25, 36, 58, 63, 66, 68, 76], "187": [58, 66], "19": [68, 76], "192": 84, "1920": [23, 59], "19\ub294": 76, "19\uc5d0\uc11c": 76, "1d": [42, 73], "1e": 36, "1x1": 37, "1\uac1c": 78, "1\uac1c\uc758": 76, "1\uacfc": 77, "1\uc778": 75, "1\uc778\uc9c0": 81, "1\uc904\uc9dc\ub9ac": 76, "1\ucc28\uc6d0": 81, "1\ucd08\uc5d0": 77, "2": [1, 8, 11, 14, 15, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 47, 50, 51, 52, 54, 55, 56, 57, 58, 59, 61, 63, 65, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 83, 84], "20": [22, 24, 28, 36, 45, 56, 65, 68, 71, 72, 73, 76, 79, 80, 81, 84], "200": [24, 45, 63], "2000": [15, 63, 84], "20000": 37, "2001": [16, 63], "2004": 18, "2021": 16, "2022": 84, "204": 42, "20500": 37, "20\uc77c": 79, "20\uc904\uc9dc\ub9ac": 76, "21": [37, 63], "210": 24, "214": 16, "22": 49, "220": [24, 75, 76, 77, 78], "22000": 49, "22050": 38, "225": 24, "23": 63, "235": [58, 66], "238": [42, 58, 66], "2380": 23, "24": [17, 18, 22, 24, 28, 31, 42, 51, 52, 56, 63, 65], "240": [63, 68, 69, 70, 76, 77, 78, 79, 80, 81], "24x24": 22, "25": [32, 56, 58, 66], "250": [24, 85], "255": [1, 20, 28, 29, 30, 32, 35, 42, 43, 50, 51, 56, 57, 58, 59, 65, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 84, 85], "256": [23, 37, 51], "260": 24, "27": 37, "270": [72, 73, 80, 81], "29": 16, "299": 42, "2d": [15, 35, 42, 43, 48, 52, 63, 64, 65, 68, 73, 76, 84], "2d\uc6a9": 76, "2pre": 36, "2x2": 65, "2\uac1c\ub97c": 80, "2\uac1c\uc758": 78, "2\ucc28\uc6d0": 81, "3": [1, 16, 17, 18, 20, 22, 23, 24, 25, 28, 30, 31, 32, 33, 36, 37, 38, 39, 42, 43, 44, 45, 47, 50, 51, 56, 61, 62, 63, 64, 65, 67, 68, 69, 70, 71, 73, 76, 77, 78, 79, 81, 83, 84], "30": [22, 24, 29, 30, 32, 36, 38, 45, 53, 57, 63, 71, 84], "300": [15, 24, 45], "3072": 38, "30\uc73c\ub85c": 79, "315": 29, "32": [1, 14, 17, 18, 28, 29, 31, 35, 38, 51, 52, 56, 59, 65, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81], "320": [63, 68, 69, 70, 76, 77, 78, 79, 80, 81], "325": [72, 73, 80, 81], "32767": 47, "32768": 47, "32x32": 23, "33": 65, "35": 74, "359": 29, "35\ub144": 82, "36": [29, 85], "360": [20, 29, 36, 47, 58, 66], "390": 29, "3d": [23, 26, 43, 52, 63, 65, 67], "3f": 32, "3rd": 63, "3x3": 65, "3\uac1c\uc758": [76, 79], "4": [1, 3, 8, 17, 20, 24, 25, 28, 29, 33, 36, 37, 38, 39, 42, 47, 51, 56, 57, 58, 59, 60, 61, 62, 63, 65, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 83, 84, 86, 89], "40": [15, 16, 22, 24, 54, 56, 62, 63, 71, 72, 73, 79, 80, 81, 84], "400": [22, 23, 24, 57], "4096": [37, 38], "42": 24, "425": [72, 73, 80, 81], "4321": 44, "438": 16, "44100": 38, "45": [29, 72, 73, 80, 81], "47": 89, "480": [18, 26, 39, 48, 57, 58, 59, 62, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 89], "480\uc73c\ub85c": 76, "4k": 23, "4th": 65, "4\uac1c\uc758": [76, 79], "5": [13, 20, 23, 24, 25, 29, 33, 35, 36, 37, 38, 39, 40, 42, 44, 45, 46, 49, 50, 57, 58, 61, 62, 63, 65, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 83, 89], "50": [16, 22, 24, 26, 36, 45, 57, 65, 73, 81, 84, 85], "500": [32, 45], "500m": 37, "512": 38, "55": 56, "56": 24, "587": 42, "5x5": [73, 81], "5\uac00": 77, "5\uac1c\uc758": 76, "5\uc5d0": 78, "6": [24, 26, 32, 33, 36, 38, 44, 50, 61, 62, 65, 68, 69, 70, 71, 73, 76, 77, 78, 79, 81, 83], "60": [15, 16, 22, 24, 37, 38, 39, 58, 62, 66, 69, 71, 72, 73, 77, 79, 80, 81, 84, 89], "600": [22, 59, 62], "60\uc774\ub77c\ub294": 77, "63": 20, "64": [20, 29, 56, 58, 66], "640": [16, 18, 26, 39, 48, 57, 59, 62, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 89], "640x480": [23, 62, 65], "65": [37, 56], "65280": 59, "6x": 84, "6\uc744": 79, "7": [23, 32, 33, 43, 44, 63, 65, 68, 69, 70, 71, 76, 77, 78, 79, 83], "70": 24, "700": [23, 32], "72": 29, "720": [15, 29, 84], "75": [22, 24, 69, 77], "7\uc5d0\uc11c": 79, "7\uc758": 76, "8": [14, 17, 18, 20, 22, 23, 24, 26, 28, 29, 30, 31, 32, 33, 35, 38, 42, 43, 44, 46, 49, 50, 51, 52, 54, 56, 59, 62, 63, 65, 68, 69, 70, 76, 77, 78, 83, 89], "80": [24, 50, 58, 66], "800": 59, "8191": 37, "8192": 37, "8bit": 38, "8\uc758": 76, "9": [13, 15, 17, 18, 20, 23, 25, 26, 29, 30, 32, 33, 35, 36, 37, 38, 40, 42, 43, 44, 45, 46, 47, 51, 52, 56, 57, 65, 68, 69, 70, 76, 77, 78], "90": [24, 35, 36, 38, 56, 57, 58, 66, 89], "97": 33, "9\uc758": 76, "A": [1, 4, 7, 8, 11, 12, 14, 15, 17, 18, 20, 22, 23, 24, 25, 26, 29, 30, 32, 33, 35, 38, 39, 40, 42, 43, 45, 46, 49, 50, 51, 53, 54, 56, 58, 63, 64, 85, 86, 89], "AND": [18, 33], "ANDing": 84, "AS": 18, "And": [22, 32, 58, 62, 66, 68, 69, 71, 74, 84, 85, 89], "As": [24, 29, 35, 38, 39, 44, 51, 52, 56, 57, 58, 64, 65, 67, 68, 84, 85, 86, 88, 89], "At": [26, 31, 63, 64, 65], "BE": 18, "BUT": 18, "BY": 18, "Be": [22, 23, 24, 28, 44, 65], "Being": [63, 84], "But": [26, 39, 43, 51, 58, 62, 64, 65, 68, 69, 71, 72, 74, 85, 87, 88], "By": [23, 25, 29, 35, 39, 43, 44, 51, 53, 54, 56, 57, 61, 62, 64, 85, 86], "FOR": 18, "For": [1, 15, 17, 18, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 53, 56, 57, 60, 61, 62, 63, 64, 65, 67, 68, 71, 84, 85, 86, 88], "IF": 18, "IN": [18, 27], "If": [5, 9, 11, 12, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 58, 59, 60, 61, 62, 63, 64, 65, 67, 68, 69, 71, 72, 73, 74, 84, 85, 87, 88, 89], "In": [17, 18, 22, 23, 27, 29, 30, 31, 32, 33, 36, 37, 39, 40, 43, 44, 51, 54, 57, 58, 59, 61, 62, 63, 64, 65, 68, 70, 72, 84, 85, 86, 87, 88, 89], "It": [2, 9, 12, 15, 17, 18, 19, 20, 23, 25, 26, 28, 29, 31, 32, 33, 36, 37, 38, 40, 42, 43, 44, 45, 47, 50, 51, 53, 54, 56, 57, 58, 59, 60, 61, 63, 64, 65, 66, 68, 69, 72, 73, 84, 86, 87, 88, 89], "Its": 34, "NO": 18, "NOT": [18, 37, 40, 56], "No": [1, 5, 6, 8, 11, 33, 44, 45, 50, 51, 67, 70], "Not": [23, 25, 41, 45, 51, 60, 63, 64, 65, 69, 70], "OF": 18, "ON": 18, "OR": [18, 29, 35], "ORed": 38, "ORing": 33, "Of": [57, 69, 70, 71], "On": [1, 2, 3, 4, 5, 6, 7, 8, 9, 18, 23, 25, 26, 37, 40, 44, 46, 50, 51, 56, 63, 66, 84], "One": [10, 19, 32, 63, 65, 84], "Or": [20, 26, 44, 64, 74], "SUCH": 18, "THE": 18, "TO": 18, "That": [15, 29, 56, 58, 62, 63, 64, 67, 68, 69, 70, 71, 73, 74, 84], "The": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 14, 15, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 59, 60, 61, 63, 65, 66, 68, 71, 84, 87, 88], "Then": [10, 22, 24, 58, 62, 64, 65, 68, 71, 73, 85, 86, 88, 89], "There": [16, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 30, 32, 33, 37, 39, 45, 46, 50, 51, 57, 58, 59, 60, 62, 64, 65, 69, 70, 72, 73, 85], "These": [16, 20, 22, 23, 24, 26, 29, 32, 37, 39, 44, 45, 47, 48, 50, 51, 52, 53, 56, 58, 59, 62, 64, 65, 84, 85, 87], "To": [22, 23, 25, 30, 32, 33, 35, 37, 38, 39, 40, 41, 42, 43, 47, 50, 54, 57, 58, 65, 87, 88], "Will": [4, 5, 6, 11, 32, 38, 54], "With": [26, 31, 36, 37, 51, 62, 63, 65, 85, 87, 88], "_": [20, 33], "__class__": 45, "__copy__": 35, "__dict__": 25, "__file__": [26, 58, 66], "__init__": [32, 45, 50, 57, 58, 62, 64, 66, 86, 87, 88, 89], "__main__": [32, 66, 71, 72, 73, 79, 80, 81, 85, 89], "__name__": [32, 45, 66, 71, 72, 73, 79, 80, 81, 85, 89], "__new__": [29, 45], "__repr__": 45, "__tags__": 53, "_camera": 18, "_default_lay": 50, "_freetyp": [0, 10], "_index": 1, "_layer": 50, "_pixels_address": 51, "_pygam": 10, "_rect": 45, "_sdl2": 48, "_spin": [58, 66], "_sprite__g": 64, "_spritegroup": 64, "_tag": 53, "_test": 53, "_time_threshold": 50, "_use_upd": 50, "_walk": [58, 66], "a0": 37, "a6f89747b551": 44, "a_mask": 35, "aa": [20, 30, 65], "aaa": 65, "aacircl": 30, "aaellips": 30, "aalib": 23, "aalin": 24, "aapolygon": [24, 30], "aatrigon": 30, "abandon": 18, "abil": [44, 58, 63], "abl": [31, 32, 42, 58, 63, 84, 89], "abnorm": 89, "abort": 37, "about": [9, 15, 18, 19, 23, 25, 26, 28, 32, 36, 37, 39, 42, 44, 48, 50, 51, 55, 58, 59, 61, 62, 63, 64, 65, 67, 68, 70, 71, 72, 73, 74, 84, 85, 87, 88], "abov": [14, 18, 19, 22, 23, 24, 28, 29, 32, 40, 41, 42, 43, 45, 48, 57, 58, 62, 64, 65, 74, 84, 87], "absent": 23, "absolut": [19, 20, 29, 32, 37, 40, 51, 84], "abspath": [58, 66], "abstractgroup": 50, "acceler": [23, 24, 30, 41, 48, 51, 56, 63, 69], "accept": [14, 24, 26, 28, 29, 30, 31, 38, 39, 45, 50, 51, 52, 62], "access": [8, 9, 15, 17, 19, 24, 25, 26, 28, 29, 32, 35, 37, 38, 39, 41, 43, 44, 46, 50, 51, 59, 64, 65, 67, 84], "accident": 84, "accommod": 62, "accord": [20, 43, 56, 69], "accordingli": 51, "account": [32, 33, 36, 38, 40, 42, 56, 68], "accur": [39, 40, 54], "achiev": [62, 86], "acolor": 20, "acquir": [9, 51, 52], "across": [22, 23, 33, 58, 62, 65, 66, 84, 87, 88, 89], "act": [36, 58, 63, 70], "action": [25, 63, 65, 88], "activ": [23, 25, 38, 39, 40, 49, 51, 52, 55, 59, 72, 74], "activeev": [23, 25], "actual": [4, 11, 18, 19, 22, 23, 25, 28, 30, 32, 37, 38, 40, 41, 43, 45, 50, 51, 54, 56, 58, 59, 62, 63, 64, 65, 73, 84, 85, 88], "ad": [10, 23, 24, 25, 29, 31, 32, 33, 35, 38, 39, 40, 42, 43, 44, 45, 47, 50, 54, 56, 58, 64, 65, 68, 69, 70, 72, 73, 84, 87, 89], "add": [23, 29, 48, 50, 57, 58, 61, 62, 63, 64, 65, 68, 69, 70, 89], "add_intern": 64, "add_map": 47, "addit": [22, 23, 24, 25, 26, 32, 33, 36, 37, 44, 46, 48, 50, 51, 84], "addition": [23, 24, 47, 62], "address": [17, 51, 84, 86], "adequ": 72, "adjac": [24, 30], "adjust": [8, 20, 23, 28, 29, 37, 71, 89], "admit": 84, "adopt": [48, 61], "advanc": [15, 28, 29, 47, 50, 51, 58, 62, 63, 67, 70], "advancedinputoutput1": 80, "advancedinputoutput2": 80, "advancedinputoutput3": 80, "advancedinputoutput4": 80, "advancedinputoutput5": 80, "advancedoutputalpha1": 81, "advancedoutputalpha2": 81, "advancedoutputalpha3": 81, "advancedoutputprocess1": 79, "advancedoutputprocess2": 79, "advancedoutputprocess3": 79, "advancedoutputprocess4": 79, "advancedoutputprocess5": 79, "advancedoutputprocess6": 79, "advancemam": 56, "advantag": [59, 63, 64, 67, 84, 87], "advic": 63, "advis": [18, 22, 23], "ae": 28, "affect": [11, 23, 24, 29, 38, 42, 44, 45, 50, 51, 52, 65, 74], "afraid": 65, "after": [17, 19, 23, 24, 28, 29, 31, 32, 33, 37, 38, 40, 47, 49, 50, 51, 57, 58, 59, 62, 63, 65, 68, 69, 70, 84, 89], "again": [18, 33, 40, 44, 50, 51, 54, 59, 61, 62, 64, 65, 84, 85, 88, 89], "against": [29, 31, 44, 45, 56, 57, 64], "ago": 63, "agp": 65, "ahead": [24, 32], "ai": [86, 89], "aid": 29, "aim": 61, "alexei": 74, "algorithm": [24, 35, 44, 56, 67, 70, 84], "alia": [25, 31, 46, 50], "alias": [15, 23, 28, 29, 85], "aliceblu": 21, "alien": [26, 64], "alien1": 62, "align": [29, 35, 36, 45], "aliv": [17, 50, 64], "all": [15, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 44, 45, 47, 48, 50, 51, 52, 53, 56, 57, 59, 60, 61, 63, 64, 65, 67, 68, 84, 85, 86, 87, 88], "all_my_sprites_list": 84, "allblack": 65, "alloc": [9, 31, 38, 68], "allot": 53, "allow": [15, 18, 20, 22, 23, 25, 27, 28, 29, 31, 32, 36, 38, 42, 44, 45, 46, 50, 51, 56, 57, 58, 59, 62, 64, 65, 87, 89], "allowedchang": 38, "allsprit": [58, 66], "almost": [15, 58, 61, 63, 64, 65, 67, 86], "alon": [26, 84], "along": [24, 25, 26, 29, 37, 45, 53, 62, 63, 64, 65, 66, 74, 87], "alpha": [1, 20, 23, 24, 26, 28, 29, 30, 31, 35, 43, 44, 48, 51, 52, 56, 63, 65, 86], "alreadi": [9, 19, 23, 25, 29, 32, 37, 38, 40, 45, 47, 50, 57, 62, 63, 64, 65, 84, 88], "alsa": 37, "also": [10, 12, 14, 15, 17, 19, 20, 22, 23, 25, 26, 28, 29, 30, 31, 33, 35, 36, 37, 38, 39, 40, 42, 44, 45, 47, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 68, 69, 72, 73, 84, 85, 86, 87, 88, 89], "alt": [25, 33], "alter": [35, 39, 56], "altern": [19, 23, 24, 26, 28, 29, 30, 45], "altgr": 33, "although": [58, 68, 86], "alwai": [18, 23, 25, 26, 28, 29, 30, 31, 32, 33, 35, 39, 41, 44, 45, 47, 49, 50, 51, 54, 56, 58, 59, 60, 62, 63, 64, 65, 68, 69, 70, 71, 77, 84, 86, 87, 89], "always\ubb38": [76, 77], "always\ubb38\uacfc": 79, "always\ubb38\uc5d0": [76, 77], "always\ubb38\uc5d0\uc11c": 76, "always\ubb38\uc758": 77, "always\ubb38\uc774": 77, "ambigu": 38, "among": 18, "amongst": 15, "amount": [23, 25, 28, 29, 32, 39, 54, 55, 56, 58, 63], "ampersand": 33, "amplitud": 49, "an": [1, 2, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 63, 64, 65, 67, 69, 84, 85, 86, 87, 88, 89], "an_id": 37, "analog": [32, 42, 47], "andal": 29, "andmask": [22, 39], "android": [25, 33], "angl": [24, 29, 30, 35, 36, 48, 56, 57, 87, 89], "angle_to": 36, "angular": 87, "ani": [1, 9, 15, 17, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 35, 37, 38, 40, 41, 42, 43, 44, 45, 47, 48, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 67, 68, 74, 84, 85, 86, 87, 88], "anim": [15, 26, 31, 50, 56, 62, 63, 64, 67], "anisotrop": 44, "annoi": [15, 61, 73], "anoth": [10, 20, 23, 24, 26, 28, 29, 30, 32, 33, 35, 36, 39, 40, 42, 43, 45, 46, 47, 48, 50, 51, 62, 63, 64, 65, 73, 74, 84, 86, 89], "ansi": 37, "ansi_not": 37, "answer": [63, 84], "anti": [15, 23, 29, 85], "antialia": 28, "antialias": [24, 28, 29, 30, 56, 58], "anticip": [44, 69], "antiquewhit": 21, "antiquewhite1": 21, "antiquewhite2": 21, "antiquewhite3": 21, "antiquewhite4": 21, "anymor": 84, "anyon": 64, "anyth": [15, 19, 23, 27, 44, 50, 51, 58, 62, 63, 64, 65, 74, 84], "anywai": [65, 70, 85], "anywher": [12, 50, 62], "apart": 38, "api": [15, 18, 23, 25, 30, 33, 37, 46, 47, 48, 57, 84], "app": [23, 26, 44, 57], "app_didenterbackground": 25, "app_didenterforeground": 25, "app_lowmemori": 25, "app_termin": 25, "app_willenterbackground": 25, "app_willenterforeground": 25, "appear": [15, 23, 25, 54, 62, 63, 64, 70, 84], "append": [27, 57, 62, 64, 69, 73, 81, 84], "appli": [20, 24, 26, 29, 35, 36, 37, 51, 55, 56, 65, 84], "applic": [0, 17, 23, 25, 26, 27, 33, 34, 37, 38, 46, 51, 59, 84, 88], "approach": 61, "appropri": [23, 25, 39, 58, 59, 64, 69, 88], "approxim": [32, 35, 51, 57], "aptitud": 74, "aqua": 21, "aquamarin": 21, "aquamarine1": 21, "aquamarine2": 21, "aquamarine3": 21, "aquamarine4": 21, "ar": [1, 8, 9, 10, 12, 14, 15, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 63, 64, 65, 66, 67, 68, 70, 71, 72, 73, 74, 85, 86, 87, 88, 89], "arang": 65, "arbitrari": [50, 56, 62], "arbitrarili": 23, "arc": [24, 30], "arcad": [63, 84], "architectur": 56, "archiv": [28, 29, 84], "area": [11, 23, 24, 26, 28, 29, 32, 35, 44, 45, 48, 50, 51, 56, 57, 58, 62, 63, 64, 66, 68, 72, 84, 85, 87, 88, 89], "aren": [58, 62, 84], "arg": [26, 50, 53], "argb": 31, "argb_premult": 31, "argument": [1, 2, 3, 9, 11, 15, 17, 18, 19, 20, 22, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 35, 36, 38, 39, 40, 41, 43, 44, 45, 47, 48, 50, 51, 53, 54, 56, 58, 59, 62, 64, 84, 85], "aris": 18, "arithmet": [20, 36, 42, 65], "arkanoid": 69, "arm": 84, "around": [15, 23, 24, 26, 32, 36, 39, 42, 45, 48, 54, 57, 58, 59, 62, 63, 65, 84, 85, 86, 89], "arrai": [1, 2, 3, 15, 20, 22, 26, 29, 31, 33, 38, 42, 49, 51, 62, 63, 65, 72, 73, 80], "arrang": [65, 68], "array2d": [52, 65], "array3d": [52, 65], "array_alpha": [52, 65], "array_blu": 52, "array_colorkei": [43, 52, 65], "array_green": 52, "array_r": 52, "array_to_surfac": 43, "arraydemo": [15, 26, 65], "arraytyp": [26, 49, 52], "arrayxd": 65, "arriv": 84, "arrow": [22, 26, 33, 62, 70], "art": [67, 74], "articl": [62, 63], "artifact": 56, "as_joystick": 47, "as_polar": 36, "as_spher": 36, "ascend": 29, "ascent": [28, 29], "ascii": [14, 22, 33, 52, 67], "asid": 67, "ask": [23, 28, 29, 57, 58, 59, 62, 63, 84], "aspect": [44, 45], "assembl": 33, "assembli": 63, "assert": 62, "assertequ": 56, "assertnotequ": 56, "asset": 84, "assign": [20, 25, 29, 32, 42, 45, 47, 50, 53, 58, 62, 65, 88], "assist": [51, 84], "associ": [7, 29, 48, 55], "assum": [1, 9, 11, 20, 28, 29, 37, 39, 45, 51, 57, 61, 64, 86, 88], "asterisk": 33, "asteroid": 84, "astyp": 65, "asurf": 31, "asymmetr": 36, "asyncblit": 51, "asynchron": 51, "attach": [9, 23, 26, 47, 57], "attack": [36, 63], "attempt": [18, 28, 29, 37, 51, 58, 60, 65], "attent": [63, 70], "attract": 70, "attribut": [5, 23, 25, 27, 28, 29, 30, 32, 33, 34, 35, 36, 39, 44, 45, 50, 51, 53, 54, 58, 64, 85, 87, 88, 89], "attributeerror": [29, 64], "audio": [25, 26, 37, 38, 44, 46, 49, 63], "audio_allow_any_chang": 38, "audio_allow_channels_chang": 38, "audio_allow_format_chang": 38, "audio_allow_frequency_chang": 38, "audiodevic": 25, "audiodevicead": 25, "audiodeviceremov": 25, "august": 16, "author": [18, 28, 33, 36, 45, 51, 56, 57, 58, 59, 60, 62, 63, 64, 65, 84], "automat": [12, 19, 23, 28, 29, 30, 31, 32, 33, 34, 37, 38, 44, 46, 50, 51, 58, 60, 65, 68, 69], "avail": [0, 9, 16, 18, 20, 22, 23, 26, 27, 28, 29, 30, 31, 36, 37, 38, 41, 44, 45, 46, 49, 51, 52, 53, 55, 56, 58, 59, 60, 62, 63, 64, 65, 84], "avalanch": 74, "averag": [28, 29, 53, 54, 56, 57, 65, 84], "average_color": [56, 57], "average_surfac": [56, 57], "avid": 84, "avoid": [19, 23, 28, 33, 36, 38, 42, 53, 65, 84, 89], "awai": [15, 23, 25, 36, 64, 71, 89], "awar": [23, 25, 28, 44, 65, 84], "awhil": 19, "awkward": [62, 84], "ax": [23, 29, 32, 47, 87], "axi": [24, 25, 29, 36, 39, 42, 47, 48, 49, 52, 56, 85, 87], "axis_numb": 32, "azimuth": 36, "azur": 21, "azure1": 21, "azure2": 21, "azure3": 21, "azure4": 21, "b": [20, 24, 26, 32, 33, 36, 42, 43, 45, 46, 47, 51, 56, 65], "b0": 47, "b3": 47, "b_black": [73, 81], "b_height": [73, 81], "b_red": [73, 81], "b_width": [73, 81], "bach": 40, "back": [19, 28, 29, 32, 33, 37, 38, 50, 57, 58, 59, 66, 68, 88, 89], "backend": [18, 23, 25, 43, 44, 56, 59], "background": [24, 25, 26, 28, 29, 38, 44, 50, 57, 61, 64, 66, 84, 85, 87, 89], "backslash": 33, "backslashreplac": 44, "backspac": 33, "backward": [23, 25, 29, 38, 54], "backyard": 63, "bad": 84, "bagic": [76, 77, 78], "baker": 63, "ball": [25, 32, 61, 63, 69, 75, 76, 77, 78, 79, 80, 81, 85, 86, 88], "ball_numb": 32, "ballrect": [63, 75, 76, 77, 78, 79, 80, 81], "ballsprit": 89, "banner": [15, 26, 58, 66], "bar": [71, 79], "barrier": 67, "base": [0, 10, 17, 18, 24, 25, 26, 28, 29, 35, 36, 48, 50, 57, 58, 62, 64, 65, 66, 67, 68, 84, 87, 89], "baselin": [28, 29], "basic": [15, 18, 20, 23, 26, 31, 46, 58, 61, 62, 63, 64, 65, 76, 84, 86, 87, 88, 89], "bat": 61, "battleship": [67, 75], "bayer": 18, "bb": 20, "bdf": 29, "beam": 22, "bear": [28, 29, 39], "beauti": 62, "becam": 25, "becaus": [24, 27, 29, 33, 36, 37, 45, 51, 58, 61, 64, 65, 67, 68, 69, 70, 72, 73, 84, 85, 86, 87, 88, 89], "becom": [23, 25, 29, 38, 40, 49, 51, 52, 62, 63, 64, 65, 68, 73, 84], "been": [19, 20, 22, 23, 24, 25, 29, 32, 36, 38, 39, 40, 44, 46, 47, 50, 51, 59, 60, 62, 63, 64, 84, 88, 89], "befor": [9, 17, 18, 19, 22, 23, 27, 28, 29, 32, 33, 35, 37, 38, 39, 40, 44, 46, 47, 50, 51, 53, 54, 57, 58, 59, 60, 61, 62, 63, 64, 65, 68, 69, 70, 71, 84, 87, 88], "beforehand": 25, "begin": [15, 17, 18, 26, 38, 40, 45, 56, 62, 63, 65, 69, 87], "beginn": 65, "behalf": 17, "behavior": [29, 31, 36, 39, 50], "behaviour": [23, 39, 44, 46, 89], "behind": [15, 23, 31, 50, 87, 88, 89], "beig": 21, "being": [8, 18, 23, 24, 25, 31, 32, 33, 35, 36, 37, 38, 39, 40, 42, 46, 62, 63, 64, 69, 84, 88], "believ": 84, "belong": [50, 58, 64, 85], "below": [15, 18, 20, 23, 24, 26, 27, 32, 37, 44, 45, 47, 50, 57, 62, 71], "bend": 37, "benefit": [50, 62, 64], "besid": [19, 26, 65], "best": [12, 18, 23, 25, 26, 35, 38, 42, 43, 51, 52, 59, 62, 63, 64, 65, 72, 86], "bet": 59, "better": [23, 28, 30, 37, 39, 40, 51, 56, 62, 63, 64, 65, 71, 84, 85], "between": [1, 3, 20, 23, 24, 25, 28, 29, 32, 33, 35, 36, 37, 38, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 57, 64, 65, 67, 70, 84], "beyond": 84, "bezier": 30, "bg": 57, "bgcolor": 29, "bgd": 50, "bgr": [31, 51, 65], "bgra": 31, "bgsurf": 50, "bid": 58, "big": [17, 18, 44, 50, 57, 62, 64, 65, 70, 71, 72], "bigger": [15, 23, 58, 73], "biggest": [23, 59], "bilinear": 56, "bin": [66, 85, 86, 87], "binari": [15, 18, 20, 22, 41], "bind": [37, 59], "bisqu": 21, "bisque1": 21, "bisque2": 21, "bisque3": 21, "bisque4": 21, "bit": [1, 14, 15, 17, 18, 22, 23, 25, 26, 28, 29, 30, 31, 32, 35, 38, 40, 42, 43, 49, 50, 51, 52, 56, 57, 58, 59, 61, 62, 64, 65, 84, 87, 89], "bitblt": 62, "bitmap": [22, 29, 31, 56, 62], "bitmap_1": 22, "bitmap_2": 22, "bitmask": [22, 33, 35, 50, 51], "bitsiz": [23, 35, 59], "bitstream": [28, 29], "bitstreamverasan": 28, "bitwis": [23, 33, 35], "bl": 89, "bla": 31, "black": [21, 22, 23, 24, 26, 29, 35, 42, 51, 56, 57, 58, 63, 65, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84], "blade": 63, "blanchedalmond": 21, "blank": [28, 57, 62, 84, 85], "blanket": [43, 51], "blend": [20, 24, 26, 29, 44, 48, 51], "blend_add": 51, "blend_alpha_sdl2": 51, "blend_fil": 26, "blend_max": 51, "blend_min": 51, "blend_mod": 48, "blend_mult": 51, "blend_premultipl": 51, "blend_premultipli": [20, 51], "blend_rgb_add": 51, "blend_rgb_max": 51, "blend_rgb_min": 51, "blend_rgb_mult": 51, "blend_rgb_sub": 51, "blend_rgba_add": 51, "blend_rgba_max": 51, "blend_rgba_min": 51, "blend_rgba_mult": 51, "blend_rgba_sub": 51, "blend_sub": 51, "blend_xxx": 26, "blendmod": 50, "blink": 67, "blit": [11, 20, 23, 26, 28, 29, 30, 32, 43, 48, 50, 51, 52, 56, 57, 58, 61, 63, 64, 65, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 87, 88, 89], "blit_arrai": [43, 52, 65], "blit_blend": 26, "blit_hw": [23, 59], "blit_hw_a": [23, 59], "blit_hw_cc": [23, 59], "blit_sequ": 51, "blit_sw": [23, 59], "blit_sw_a": [23, 59], "blit_sw_cc": [23, 59], "blitter": [44, 51, 62], "blitzbas": 26, "blit\uc774": 76, "blit\ud568\uc218\ub294": 76, "blob": [56, 57], "block": [17, 18, 25, 35, 40, 50, 51, 57, 58, 63, 73, 84], "block_list": 50, "blocks_hit_list": 50, "bloodi": 63, "blt": 62, "blue": [1, 18, 20, 21, 23, 24, 28, 31, 42, 51, 52, 56, 57, 65, 68, 71, 72, 73, 79, 80, 81, 85, 87], "blue1": 21, "blue2": 21, "blue3": 21, "blue4": 21, "blueviolet": 21, "bluish": 65, "bmp": [31, 46, 62, 63], "board": [73, 81], "bodi": 70, "bold": [28, 29], "bomb": 64, "bonu": 62, "book": 84, "bool": [17, 18, 19, 23, 24, 25, 27, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 44, 45, 46, 47, 48, 50, 51, 56], "boolean": [25, 28, 32, 33, 39, 56, 62, 64], "boom": 64, "boom_sound": 64, "border": [23, 24, 30, 39, 45, 48], "border_bottom_left_radiu": 24, "border_bottom_right_radiu": 24, "border_radiu": 24, "border_top_left_radiu": 24, "border_top_right_radiu": 24, "borderless": 48, "bore": [67, 86], "borrow": [1, 63, 86], "both": [19, 23, 24, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 42, 50, 51, 56, 57, 62, 63, 64, 65, 67, 71, 74, 84, 87, 89], "bother": [58, 61, 86], "bottleneck": 84, "bottom": [23, 24, 26, 28, 29, 30, 31, 35, 45, 50, 63, 75, 76, 77, 78, 79, 80, 81, 89], "bottomleft": [45, 89], "bottomright": [45, 89], "bounc": [26, 36, 56, 63, 89], "bound": [22, 24, 29, 35, 50, 51], "boundari": [24, 29], "box": [24, 29, 30, 33, 57, 64, 88], "br": 89, "bracket": [33, 87], "break": [18, 30, 33, 46, 54, 62, 88], "breakag": 42, "breakdown": 63, "brief": [19, 26, 44, 61, 62], "briefli": 85, "bright": [18, 57], "brighten": 23, "brightmap": 65, "bring": [50, 63, 84], "broadcast": [42, 65], "broader": 84, "broken": [39, 44], "broken_x": 22, "brought": 56, "brown": 21, "brown1": 21, "brown2": 21, "brown3": 21, "brown4": 21, "bu": 65, "buffer": [1, 2, 18, 20, 23, 31, 37, 38, 43, 46, 51, 58, 63, 64], "buffer_s": 37, "bufferproxi": [0, 15, 17, 31, 51], "buffers": [37, 38], "bug": [20, 44, 56, 63, 84, 89], "build": [44, 64, 65, 85, 89], "built": [14, 18, 28, 29, 31, 44, 47, 84, 85], "builtin": [18, 28, 64], "bullet": [64, 84], "bump": 84, "bumper": 32, "bunch": [57, 64, 84], "bundl": [28, 29], "burlywood": 21, "burlywood1": 21, "burlywood2": 21, "burlywood3": 21, "burlywood4": 21, "busi": [18, 19, 38, 54, 62], "button": [24, 25, 26, 27, 32, 33, 39, 47, 58, 61, 62, 69, 73, 80, 84, 85, 88], "button1": 39, "button2": 39, "button3": 39, "button4": 39, "button5": 39, "bx": 47, "bye": 68, "bypass": 44, "byte": [9, 14, 17, 18, 20, 22, 23, 28, 29, 31, 37, 38, 42, 43, 44, 46, 51], "byte_data": 46, "bytearrai": 31, "bytecod": 63, "byteord": 17, "bytes": [17, 23, 35, 51, 59], "bytestr": 38, "b\u00e9zier": 30, "b\uac12": 76, "c": [10, 15, 17, 18, 20, 26, 28, 30, 33, 43, 44, 45, 51, 60, 63, 65, 67, 75], "c_api": 0, "cach": 29, "cache_s": 29, "cadetblu": 21, "cadetblue1": 21, "cadetblue2": 21, "cadetblue3": 21, "cadetblue4": 21, "cadillac": 64, "calcnewpo": [87, 89], "calcul": [24, 29, 35, 36, 40, 42, 50, 68, 69, 72, 73, 87, 88], "calibr": 57, "call": [1, 9, 12, 17, 18, 19, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 44, 45, 46, 47, 48, 50, 51, 53, 54, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 68, 69, 70, 84, 85, 86, 87, 88, 89], "callabl": [17, 44, 50], "callback": [1, 2, 17, 50], "caller": [9, 37], "calling_mask": 35, "cam": 57, "came": [26, 31], "camera": [15, 26, 44, 84], "camlist": 57, "can": [1, 8, 9, 13, 14, 15, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 49, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 84, 85, 86, 87, 88, 89], "candid": [12, 33], "cannot": [14, 18, 23, 25, 28, 30, 38, 40, 45, 48, 50, 51, 52, 54, 62, 63, 64, 69, 84, 86, 89], "canva": [68, 71], "cap": 33, "capabl": [23, 59, 63, 86, 87], "capslock": 33, "caption": [23, 68], "captur": [15, 18, 25, 26, 31, 32], "capword": 25, "card": [23, 38, 65], "care": [9, 27, 38, 58, 65, 72, 85], "caret": 33, "carri": 89, "case": [15, 18, 20, 23, 24, 28, 29, 31, 33, 36, 37, 38, 40, 43, 44, 51, 57, 58, 59, 62, 64, 68, 70, 72, 73, 74, 84, 85, 87, 88], "castl": 63, "catch": [44, 64, 89], "categor": 64, "categori": 84, "caught": 63, "caus": [2, 18, 20, 25, 28, 35, 40, 42, 44, 56, 58, 64, 65, 66, 68, 84, 88], "caveat": 23, "cc": 57, "ccolor": 57, "cd": 19, "cdrom": 63, "cdrom_tag": 53, "cdrom_test": 53, "ceil": 63, "center": [24, 26, 30, 32, 35, 44, 45, 48, 50, 51, 57, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 85], "centeri": 45, "centerx": [45, 58, 66, 85], "center\ub77c\ub294": 76, "centr": 44, "centroid": [35, 57], "certain": [20, 25, 33, 36, 57, 58, 61, 67, 68, 69, 70, 71, 72, 84], "certainli": [62, 65], "cff": 29, "challeng": [63, 84], "chanc": [38, 65, 84], "chang": [15, 18, 20, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 42, 44, 45, 46, 47, 48, 49, 50, 51, 52, 54, 56, 57, 58, 59, 61, 63, 64, 65, 68, 69, 70, 71, 73, 84, 87, 88, 89], "change_color": 56, "change_lay": 50, "channel": [7, 20, 31, 37, 38, 40, 51, 65, 84], "channelnum": 7, "char": [1, 6, 9, 28, 29, 51], "char_bit": 35, "charact": [14, 17, 23, 28, 29, 33, 43, 44, 52, 62, 84, 88], "character": 36, "characterist": [20, 74], "charset": 46, "chart": 65, "chartreus": 21, "chartreuse1": 21, "chartreuse2": 21, "chartreuse3": 21, "chartreuse4": 21, "chase": 64, "chaser": 64, "chatroom": 62, "cheap": [50, 64], "check": [3, 4, 5, 6, 7, 8, 11, 15, 18, 23, 25, 26, 28, 32, 35, 38, 39, 40, 42, 44, 46, 47, 49, 50, 52, 57, 58, 60, 62, 63, 64, 67, 68, 70, 71, 72, 84, 85, 86, 87, 88, 89], "checkout": 44, "chew": 54, "chief": 86, "child": 51, "chimp": [15, 26, 61, 64, 86], "chimpanze": 15, "chocol": 21, "chocolate1": 21, "chocolate2": 21, "chocolate3": 21, "chocolate4": 21, "choic": [18, 23, 38, 57], "choos": [18, 22, 23, 26, 59, 61, 65, 73, 84], "chop": 56, "choppi": 62, "chord": 84, "chore": 84, "chose": 73, "chosen": [18, 23, 29], "chromin": 18, "chunk": [7, 17, 89], "circl": [15, 22, 24, 26, 30, 32, 50, 57], "circular": 64, "circumst": 89, "claim": 18, "clamp": [26, 36, 45], "clamp_ip": 45, "clamp_magnitud": 36, "clamp_magnitude_ip": 36, "clariti": 35, "clark": 84, "class": [0, 15, 17, 19, 20, 26, 29, 31, 32, 35, 37, 38, 45, 51, 57, 61, 62, 66, 84, 86, 89], "classless": [86, 87], "classmethod": 48, "claus": 89, "clean": [39, 42, 58, 60, 62, 63, 64, 84], "cleaner": [62, 63], "cleanli": [60, 62, 63, 64, 89], "cleanup": 42, "clear": [15, 23, 24, 25, 32, 33, 35, 38, 43, 48, 50, 51, 62, 63, 64, 67, 75, 84], "clear_callback": 50, "clearer": 60, "clench": [58, 66], "click": [15, 22, 24, 26, 32, 33, 39, 69, 72, 84, 85], "client": 25, "clip": [24, 26, 45, 50, 51, 62], "clipboard": [15, 25, 26], "clipboardupd": 25, "cliplin": 45, "clipped_lin": 45, "clist": 57, "clock": [15, 22, 24, 32, 39, 54, 58, 62, 66, 69, 70, 71, 72, 73, 77, 78, 79, 80, 81, 84, 89], "clockwis": [29, 30, 36, 56, 87], "clone": 20, "close": [9, 15, 18, 22, 23, 24, 25, 26, 29, 32, 37, 40, 42, 47, 56, 57, 62, 65, 85, 86], "close_to_play": 64, "close_to_player2": 64, "close_to_player3": 64, "closest": [23, 37, 38, 59], "cmy": 20, "co": [87, 89], "cocoa": 23, "code": [5, 14, 15, 17, 18, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 35, 39, 42, 43, 44, 45, 46, 50, 51, 56, 57, 58, 62, 63, 64, 65, 67, 68, 69, 70, 71, 72, 73, 84, 85, 86, 87, 88, 89], "codec": 44, "codepoint": 28, "coder": 84, "coercion": 65, "col": 30, "collect": [12, 23, 33, 50, 51, 60, 84], "collid": [35, 45, 50, 58, 64, 66, 87, 89], "collide_circl": 50, "collide_circle_ratio": 50, "collide_mask": [35, 50], "collide_rect": 50, "collide_rect_ratio": 50, "collided_cal": 50, "collidedict": 45, "collidedictal": 45, "collidelist": 45, "collidelistal": 45, "collideobject": 45, "collideobjectsal": 45, "collidepoint": [45, 72, 73, 80, 81, 84, 89], "collidepoint\ub97c": 80, "colliderect": [45, 50, 58, 66, 89], "colliding_sprit": 50, "collis": [26, 35, 36, 45, 50, 57, 67, 89], "collision_box": 45, "colon": 33, "color": [0, 1, 10, 15, 22, 23, 24, 28, 29, 30, 31, 35, 42, 43, 48, 50, 51, 52, 56, 57, 58, 59, 62, 63, 65, 67, 68, 71, 72, 73, 80, 81, 84, 85], "color_valu": 20, "colordict": 21, "colorkei": [23, 26, 28, 29, 31, 43, 51, 52, 56, 58, 63, 65, 66], "colormap": [26, 43, 52], "colorspac": 18, "colour": [20, 44, 51], "column": [35, 42, 65, 73, 81], "com": 56, "combin": [23, 29, 33, 45, 50, 51, 56, 63, 64, 84, 89], "come": [25, 26, 28, 29, 37, 44, 57, 62, 63, 64, 65, 66, 84, 87, 88, 89], "comfort": [15, 87], "comma": [28, 29, 33, 37, 65], "command": [24, 25, 26, 32, 53, 65, 67, 68, 69, 70], "comment": [26, 61, 64, 66, 87, 89], "commerci": [15, 63], "commit": [33, 63], "common": [23, 28, 29, 47, 50, 56, 60, 61, 62, 63, 84], "commun": [25, 48, 84], "compani": 63, "compar": [33, 35, 36, 42, 44, 50, 56, 63, 68, 84], "comparison": [20, 25, 26, 42, 65, 70, 74], "compat": [23, 25, 29, 31, 38, 48, 50, 54, 67, 86], "compens": 63, "compil": [13, 15, 19, 22, 25, 28, 29, 31, 38, 41, 44], "complement": 36, "complet": [24, 33, 38, 40, 45, 50, 51, 52, 63, 64, 84, 89], "complex": [38, 58, 63, 64, 67, 69, 84, 86, 87, 88], "complic": [68, 84], "compon": [20, 35, 36, 43, 51, 65, 68], "composit": 33, "compositor": 44, "compound": 46, "compound_text": 46, "compress": [40, 51], "comput": [15, 18, 19, 26, 28, 31, 32, 38, 54, 58, 62, 63, 64, 69, 74, 84], "concept": [15, 61, 62, 63, 65, 69, 74, 84], "concern": [64, 74], "conclud": 63, "conclus": 74, "concret": 84, "concurr": 84, "condit": [18, 22, 38, 68, 89], "confid": 84, "configur": [15, 23, 29, 39, 59, 65], "confin": [48, 62], "confus": [24, 62, 68, 84], "connect": [24, 26, 30, 32, 35, 47, 61, 62, 74, 86], "connected_compon": [35, 57], "connenct": 32, "consequ": 86, "consequenti": 18, "consid": [23, 24, 25, 29, 35, 36, 38, 40, 44, 45, 50, 51, 56, 84, 89], "consider": 51, "consider_alpha": 56, "consist": [19, 24, 25, 27, 38, 46, 61, 65, 85, 86], "consol": [26, 44, 53, 67], "const": [1, 6, 9, 70], "constant": [15, 22, 25, 29, 33, 38, 39, 44, 46, 47, 54, 57, 60, 62, 68, 72], "constrain": [24, 39, 70], "construct": [36, 45, 62], "constructor": [29, 32, 50, 58, 64], "consum": [1, 54, 65, 84], "contact": [57, 58, 59, 60, 62, 63, 64, 65], "contain": [0, 6, 8, 15, 19, 22, 23, 24, 25, 28, 29, 31, 32, 33, 34, 35, 37, 38, 39, 43, 45, 46, 47, 50, 51, 53, 55, 58, 62, 63, 64, 66, 84, 86, 88, 89], "content": [23, 34, 41, 42, 46, 58, 59, 68, 70], "context": [9, 23, 42, 48, 84], "contigu": [17, 24, 51], "continu": [35, 38, 44, 50, 51, 63, 85], "contract": [18, 56], "contrast": [39, 70, 87], "contribut": 64, "contributor": 18, "control": [4, 15, 18, 22, 25, 26, 28, 29, 33, 34, 38, 41, 44, 50, 51, 52, 53, 54, 56, 58, 59, 60, 61, 62, 63, 69, 70, 78, 84, 86], "controller_axis_lefti": 47, "controller_axis_leftx": 47, "controller_axis_righti": 47, "controller_axis_rightx": 47, "controller_axis_triggerleft": 47, "controller_axis_triggerright": 47, "controller_button_a": 47, "controller_button_b": 47, "controller_button_back": 47, "controller_button_dpad_down": 47, "controller_button_dpad_left": 47, "controller_button_dpad_right": 47, "controller_button_dpad_up": 47, "controller_button_guid": 47, "controller_button_i": 47, "controller_button_leftshould": 47, "controller_button_leftstick": 47, "controller_button_rightshould": 47, "controller_button_rightstick": 47, "controller_button_start": 47, "controller_button_x": 47, "controlleraxismot": 47, "controllerbuttondown": 47, "controllerbuttonup": 47, "controllerdevicead": [25, 47], "controllerdeviceremap": [25, 47], "controllerdeviceremov": [25, 47], "controllertouchpaddown": 47, "controllertouchpadmot": 47, "controllertouchpadup": 47, "convei": 22, "conveni": [36, 44, 50, 53, 62, 63, 84], "convent": 47, "convers": [1, 18, 20, 35, 42, 52, 84], "convert": [1, 18, 20, 22, 24, 29, 31, 37, 38, 40, 43, 45, 49, 51, 52, 58, 59, 62, 65, 66, 85, 86, 89], "convert_alpha": [26, 31, 51, 86, 89], "convolut": [35, 65], "convolv": 35, "cool": 84, "cooper": 19, "coord": 57, "coordin": [8, 22, 24, 29, 30, 32, 35, 36, 39, 50, 51, 56, 85, 89], "copi": [17, 22, 26, 31, 35, 36, 38, 42, 45, 46, 48, 49, 50, 51, 52, 56, 58, 62, 63, 64, 65, 84, 85], "copyright": 18, "coral": 21, "coral1": 21, "coral2": 21, "coral3": 21, "coral4": 21, "cord": 26, "core": 84, "coremidi": 37, "corner": [24, 29, 30, 35, 39, 42, 44, 50, 51, 56, 57, 58, 62, 84, 89], "cornflowerblu": 21, "cornsilk": 21, "cornsilk1": 21, "cornsilk2": 21, "cornsilk3": 21, "cornsilk4": 21, "correct": [18, 22, 28, 41, 45, 51, 56, 62, 65, 68, 73], "correct_gamma": 20, "correctli": [24, 36, 37, 38, 56, 57, 58, 62, 65], "correspond": [29, 33, 35, 37, 42, 51, 53, 68, 84, 89], "could": [22, 25, 33, 36, 41, 45, 48, 49, 50, 52, 56, 57, 58, 61, 62, 64, 65, 85, 86, 87], "couldn": [86, 89], "count": [17, 19, 32, 35, 38, 42, 56, 57, 69, 73], "counterclockwis": [24, 29, 36, 56], "coupl": [32, 58, 62, 64, 65], "courier": 29, "cours": [57, 69, 70, 71, 85, 86, 87, 89], "cover": [15, 24, 33, 44, 45, 51, 56, 57, 59, 62, 74, 84, 85], "coverag": 24, "cprofil": 84, "cpu": [24, 54, 67, 75, 84], "crash": [41, 64], "creat": [1, 2, 5, 6, 15, 16, 17, 19, 20, 21, 22, 23, 25, 26, 28, 29, 31, 32, 33, 35, 36, 38, 39, 41, 42, 43, 45, 47, 48, 49, 50, 51, 52, 54, 56, 57, 59, 63, 64, 65, 66, 74, 84, 85, 86, 87, 88, 89], "create_graphics_screen": 62, "create_screen": 62, "creation": [28, 29, 32, 47, 49, 50, 52, 62], "creativ": 74, "crect": 57, "crimson": 21, "critic": 84, "critter": [58, 66], "crop": [45, 56], "cross": [32, 36, 58, 63, 65, 86], "crossbar": 26, "crossbon": 22, "crossfad": 65, "crosshair": 22, "crt": 23, "crucial": 84, "crude": [26, 58, 62], "cryptic": 64, "ctrl": 25, "cube": 26, "cui": [67, 68, 73, 81], "cui\uac00": 75, "cui\uace0": 75, "cui\ud658\uacbd\uc5d0\uc11c\ub9cc": 76, "current": [13, 18, 19, 22, 23, 25, 26, 27, 28, 29, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 56, 58, 59, 62, 63, 64, 67, 68, 69, 71, 84, 87, 88, 89], "current_h": [23, 59], "current_level": 36, "current_w": [23, 59], "cursor": [15, 26, 39, 58, 63, 84], "cursor_arg": 22, "cursor_index": 22, "cursorfil": 22, "curv": 30, "custom": [15, 23, 25, 26, 38, 50, 63], "custom_typ": 25, "customis": 86, "cut": [38, 46, 84], "cutout": 62, "cx1": 45, "cx2": 45, "cy1": 45, "cy2": 45, "cyan": 21, "cyan1": 21, "cyan2": 21, "cyan3": 21, "cyan4": 21, "c\ub85c": 75, "d": [32, 33, 51, 62, 84, 85, 87], "da": 61, "dai": [63, 64, 84], "damag": 18, "dark": [58, 63], "darkblu": 21, "darkcyan": 21, "darken": 23, "darkgoldenrod": 21, "darkgoldenrod1": 21, "darkgoldenrod2": 21, "darkgoldenrod3": 21, "darkgoldenrod4": 21, "darkgrai": 21, "darkgreen": 21, "darkgrei": 21, "darkkhaki": 21, "darkmagenta": 21, "darkolivegreen": 21, "darkolivegreen1": 21, "darkolivegreen2": 21, "darkolivegreen3": 21, "darkolivegreen4": 21, "darkorang": 21, "darkorange1": 21, "darkorange2": 21, "darkorange3": 21, "darkorange4": 21, "darkorchid": 21, "darkorchid1": 21, "darkorchid2": 21, "darkorchid3": 21, "darkorchid4": 21, "darkr": 21, "darksalmon": 21, "darkseagreen": 21, "darkseagreen1": 21, "darkseagreen2": 21, "darkseagreen3": 21, "darkseagreen4": 21, "darkslateblu": 21, "darkslategrai": 21, "darkslategray1": 21, "darkslategray2": 21, "darkslategray3": 21, "darkslategray4": 21, "darkslategrei": 21, "darkturquois": 21, "darkviolet": 21, "data": [0, 2, 15, 17, 18, 19, 22, 26, 31, 35, 37, 38, 39, 40, 41, 43, 46, 51, 56, 58, 62, 63, 65, 66, 68, 70, 71, 72, 73, 84, 86, 89], "data1": 37, "data2": 37, "data3": 37, "data_dir": [58, 66], "datatyp": 65, "date": 84, "david": 84, "dead": 27, "deal": [33, 44, 65, 68, 84, 88], "dealloc": 32, "dealt": [25, 27, 88], "death": 63, "debat": 84, "debug": [25, 56, 84, 88], "decapit": 63, "decept": 72, "decid": [25, 27, 35, 58, 61, 64, 68, 84], "decim": 24, "decis": 84, "declar": [8, 62, 65], "decod": [22, 29, 33, 46, 63], "decor": 85, "decreas": [38, 45, 72], "decrement": 9, "dedic": 64, "deeper": 84, "deeppink": 21, "deeppink1": 21, "deeppink2": 21, "deeppink3": 21, "deeppink4": 21, "deepskyblu": 21, "deepskyblue1": 21, "deepskyblue2": 21, "deepskyblue3": 21, "deepskyblue4": 21, "def": [29, 32, 35, 39, 45, 50, 56, 57, 58, 62, 64, 66, 71, 72, 73, 79, 80, 81, 85, 86, 87, 88, 89], "default": [1, 14, 18, 20, 22, 23, 24, 25, 26, 28, 29, 31, 33, 35, 36, 37, 38, 40, 43, 44, 45, 48, 50, 51, 53, 54, 56, 58, 59, 62, 63], "default_id": 37, "default_lay": 50, "defin": [1, 2, 3, 6, 7, 8, 10, 11, 25, 28, 29, 34, 36, 44, 46, 50, 58, 61, 62, 84, 85, 88], "definit": [46, 60, 64, 65, 70], "deflat": 89, "degre": [29, 30, 35, 36, 52, 56, 58, 87, 89], "del": [25, 32, 65], "delai": [26, 33, 37, 54, 69, 84], "delet": [25, 33, 62, 64, 84], "deliv": 37, "delta": [15, 36], "demo": [26, 58, 65], "demonstr": [15, 26, 36, 58, 65], "denot": [40, 45, 54], "depend": [14, 23, 25, 28, 29, 31, 35, 38, 40, 42, 43, 46, 49, 58, 63, 66, 69, 71, 84], "deprec": [20, 23, 24, 25, 26, 27, 29, 32, 36, 49, 50, 51, 52], "deprecationwarn": [49, 52], "depth": [15, 18, 23, 35, 42, 48, 51, 52, 56, 57, 58, 59, 62], "deriv": [26, 44, 50, 58, 64, 84], "descend": 29, "descent": [28, 29], "describ": [1, 17, 22, 23, 37, 39, 45, 57, 59, 86], "descript": [1, 18, 22, 25, 29, 33, 34, 44, 46, 62, 64], "design": [17, 50, 61, 62, 63, 64, 68, 71, 88], "desir": [18, 51, 56, 58, 59, 84], "desktop": [23, 48, 59, 84], "desper": 62, "dest": [29, 35, 48, 51, 56, 65], "dest_rect": 56, "dest_siz": 56, "dest_surf": 56, "dest_surfac": 56, "destin": [18, 28, 29, 30, 35, 42, 50, 51, 56, 62, 63, 85], "destroi": [1, 11, 48, 64], "destruct": [56, 58], "destsurfac": 18, "detail": [15, 23, 24, 29, 32, 33, 34, 35, 36, 37, 41, 50, 51, 56, 57, 61, 71, 84], "detect": [23, 26, 35, 36, 42, 44, 45, 50, 57], "determin": [19, 20, 22, 23, 24, 25, 28, 29, 31, 33, 36, 37, 40, 41, 50, 51, 56, 59, 64, 65, 68, 69, 72, 87], "dev": [18, 57], "dev13": 25, "dev3": [25, 54], "dev7": 39, "dev8": 24, "deva": 28, "devanagari": 28, "develop": [23, 28, 33, 36, 39, 44, 45, 48, 51, 53, 56, 63, 67, 84, 86], "devic": [15, 18, 19, 25, 26, 32, 33, 37, 39, 44, 47, 55, 57, 59, 63, 84], "device_id": [26, 37], "device_index": [25, 32], "devicenam": 38, "dga": 23, "diagon": [35, 56], "diagram": [87, 88], "diamond": 22, "dict": [1, 5, 17, 20, 23, 25, 32, 35, 45, 47, 51, 53, 55], "dictionari": [1, 5, 23, 25, 45, 47, 50, 53, 64, 84], "did": [18, 24, 62, 63, 64], "didn": [84, 85], "diff": 65, "differ": [15, 18, 19, 20, 22, 23, 25, 26, 27, 28, 29, 30, 32, 33, 35, 38, 40, 42, 44, 48, 50, 51, 56, 57, 58, 59, 60, 62, 63, 64, 65, 68, 69, 70, 84, 85, 87, 88], "difficult": [37, 61, 63], "digit": [20, 32, 36], "dilemma": 67, "dimens": [17, 18, 23, 24, 26, 28, 29, 30, 35, 36, 42, 43, 45, 50, 51, 52, 56, 58, 65, 89], "dimension": [20, 24, 29, 30, 35, 36, 42, 62, 65], "dimgrai": 21, "dimgrei": 21, "direct": [18, 23, 24, 25, 26, 29, 30, 32, 36, 39, 43, 47, 51, 58, 62, 65, 70, 84, 87, 89], "directfb": 23, "directli": [14, 17, 22, 24, 25, 28, 29, 31, 33, 42, 43, 46, 49, 51, 52, 53, 62, 64, 65, 67, 84], "directmedia": 63, "directori": [23, 28, 29, 53, 58, 62, 67, 68, 86], "directx": [23, 37, 63], "dirti": [50, 64, 84], "dirty_rect": 84, "dirtysprit": 50, "disabl": [23, 25, 29, 33, 44, 47, 51, 54, 58, 66], "disable_advanced_featur": 44, "disadvantag": [59, 84], "disallow": 23, "disappear": [18, 30, 46], "disc": 19, "discard": 54, "disclaim": 18, "disconnect": [32, 61], "discontinu": [17, 51, 67], "discourag": 27, "discov": [63, 84], "discret": 71, "discuss": [64, 84], "disk": [50, 84], "displac": 69, "displai": [0, 1, 15, 22, 24, 25, 26, 30, 32, 33, 34, 36, 38, 39, 41, 44, 46, 48, 50, 51, 53, 57, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 87, 88, 89], "display_index": [25, 48], "distanc": [36, 42, 56], "distance_squared_to": 36, "distance_to": 36, "distil": 84, "distort": 23, "distribut": [15, 18, 53, 58], "dive": 68, "divers": 61, "divid": [33, 61], "divis": [20, 22, 84], "dizzi": [58, 66], "do": [8, 15, 18, 19, 20, 22, 23, 24, 25, 26, 27, 29, 32, 33, 35, 41, 42, 44, 45, 50, 51, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 68, 69, 74, 85, 86, 87, 88, 89], "doc": [23, 27, 48, 50, 51, 70, 78, 84], "document": [18, 34, 38, 44, 51, 57, 59, 61, 62, 63, 64, 65, 84, 86, 87], "dodgerblu": 21, "dodgerblue1": 21, "dodgerblue2": 21, "dodgerblue3": 21, "dodgerblue4": 21, "doe": [3, 4, 7, 12, 19, 22, 23, 24, 25, 26, 28, 29, 30, 32, 33, 35, 36, 37, 38, 40, 41, 43, 44, 45, 46, 47, 50, 51, 54, 56, 57, 58, 62, 64, 65, 68, 84, 86, 88], "doesn": [18, 23, 26, 28, 29, 44, 51, 58, 62, 64, 72, 73, 84, 86, 87, 88, 89], "dokil": [50, 64], "dokill1": [50, 64], "dokill2": [50, 64], "dollar": 33, "domain": 26, "don": [9, 18, 24, 26, 29, 32, 36, 50, 54, 56, 57, 58, 61, 62, 63, 64, 65, 68, 70, 74, 85, 86, 87, 89], "done": [24, 28, 29, 32, 40, 58, 62, 63, 65, 68, 70, 71, 84, 87], "doreturn": 51, "dot": [29, 36], "doubl": [9, 22, 23, 56, 58, 63, 65], "doublebuf": [23, 84], "doubler": 56, "down": [23, 29, 32, 33, 39, 44, 47, 51, 57, 59, 62, 63, 65, 68, 69, 71, 72, 84, 88], "download": [63, 89], "down\ub41c": 80, "dpad": 47, "dpi": 29, "drastic": 85, "draw": [15, 20, 23, 28, 29, 31, 32, 35, 48, 50, 51, 57, 62, 63, 64, 66, 67, 68, 71, 72, 73, 79, 80, 81, 84, 85, 89], "draw_blend_mod": 48, "draw_bottom_left": 24, "draw_bottom_right": 24, "draw_circle_part": 24, "draw_color": 48, "draw_lin": 48, "draw_point": 48, "draw_rect": [45, 48], "draw_top_left": 24, "draw_top_right": 24, "drawboard": [73, 81], "drawbutton": [72, 73, 80, 81], "drawbuttons\uc5d0": 80, "drawhp": [71, 72, 73, 79, 80, 81], "drawhp\ub77c\ub294": 79, "drawn": [23, 24, 30, 32, 35, 50, 51, 58, 62, 63, 64, 68, 84, 85], "dream": 67, "drew": 62, "drift": 32, "drive": 19, "driven": [23, 50, 67], "driver": [23, 37, 44, 59], "drivernam": 44, "drop": [25, 29, 38], "dropbegin": 25, "dropcomplet": 25, "dropfil": 25, "dropout": 38, "droptext": 25, "dstobj": 11, "dstrect": [11, 48], "dt": 15, "dualshock": 47, "due": [20, 23, 25, 36, 51, 84], "dull": 84, "dummi": [58, 64, 88], "dump": 53, "dungeon": 63, "duplic": [50, 51], "durat": [32, 47], "dure": [18, 23, 29, 30, 33, 40, 42, 52, 65], "dvd": [19, 69, 77], "dx": [25, 35, 51, 87, 89], "dy": [25, 35, 51, 87, 89], "dynam": [9, 69, 84], "e": [5, 20, 23, 24, 28, 30, 31, 32, 33, 35, 36, 37, 38, 44, 45, 50, 51, 57, 61, 84, 85, 87, 88], "each": [17, 18, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 32, 35, 36, 38, 39, 42, 46, 49, 50, 51, 52, 53, 56, 57, 58, 60, 61, 62, 63, 64, 65, 71, 84, 85, 87, 88, 89], "earli": [15, 48, 63, 84], "earlier": [26, 40, 43, 62], "easi": [15, 26, 48, 59, 60, 61, 62, 63, 64, 65, 70, 84, 88, 89], "easier": [45, 50, 51, 59, 60, 62, 87], "easiest": [26, 47, 62, 71, 85], "easili": [22, 44, 57, 58, 60, 62, 64, 65, 69, 74, 84, 87], "east": 22, "eat": 64, "echo": 26, "eclass": 9, "eclecti": 57, "ed": [51, 64], "edg": [24, 28, 39, 45, 56, 89], "edit": [33, 47], "editbox": 84, "editor": [33, 84], "effect": [15, 23, 25, 26, 28, 32, 40, 44, 46, 47, 50, 51, 56, 57, 58, 62, 63, 64, 65, 73, 84, 86], "effici": [15, 23, 25, 28, 50, 62, 64, 84], "effort": 74, "eg": [26, 29, 31], "eight": 26, "either": [14, 17, 19, 22, 23, 29, 31, 32, 36, 38, 39, 45, 50, 51, 56, 58, 59, 89], "eject": 19, "element": [3, 17, 20, 29, 36, 37, 42, 43, 49, 51, 62, 64, 65], "elementari": 87, "elementwis": 36, "elif": [39, 58, 66, 69, 70, 71, 72, 73, 77, 78, 79, 80, 81, 88, 89], "ellips": [15, 24, 30], "ellipt": [24, 30], "els": [1, 8, 33, 36, 43, 44, 45, 46, 50, 58, 59, 64, 66, 69, 86, 89], "elsewher": [1, 84], "else\ubb38\uc740": 77, "emb": 23, "embed": [23, 29], "emit": 39, "emoji": 28, "emphasi": 84, "emploi": 84, "empti": [5, 19, 23, 25, 27, 28, 29, 32, 33, 35, 44, 45, 46, 50, 53, 59, 64], "emul": [23, 28, 39, 59], "enabl": [23, 25, 28, 29, 33, 44, 47, 48, 63, 67], "encapsul": 88, "enclos": [24, 50, 68], "encod": [9, 14, 22, 28, 29, 40, 44, 46, 51], "encode_file_path": 44, "encode_str": 44, "encount": 35, "end": [19, 24, 25, 30, 31, 33, 38, 40, 44, 45, 50, 58, 61, 62, 63, 66, 69, 74, 84, 85, 88], "end_index": 65, "end_po": 24, "endcap": [24, 30], "endev": [38, 40], "endian": [17, 44], "endpoint": [24, 30, 45], "enemi": [36, 64], "engin": [63, 67, 84], "enhanc": [15, 28, 29], "enjoy": 70, "enlarg": 29, "enough": [29, 50, 57, 58, 60, 62, 63, 64, 65, 67, 71, 84], "ensur": [23, 25, 27, 33, 38, 53, 62, 63, 84, 85, 86], "entail": 84, "enter": [25, 28, 33, 39, 48, 58, 67], "entertain": 32, "entir": [15, 19, 23, 24, 35, 38, 48, 50, 51, 62, 63, 64, 68, 69, 70, 72, 84], "entiti": 62, "entri": [17, 33, 51, 84], "enumer": 18, "env": [66, 86], "env_var": 44, "environ": [23, 25, 28, 32, 37, 44, 46, 63, 67, 68, 86, 87], "epsilon": 36, "equal": [13, 17, 20, 22, 24, 25, 29, 33, 35, 36, 51, 67, 73], "equat": [35, 69], "equip": 65, "equival": [17, 29, 35, 37, 42, 43, 84], "eras": [32, 35, 50, 58, 62, 63, 64, 84], "err": [86, 89], "errno": 37, "error": [1, 2, 6, 9, 11, 20, 23, 25, 26, 28, 29, 33, 36, 37, 43, 44, 46, 51, 53, 56, 58, 60, 64, 65, 74, 84, 86], "error_msg": 44, "errorstr": 44, "esc": 26, "escap": [14, 29, 33, 58, 84, 89], "especi": [25, 29, 44, 64, 65, 86], "essenti": 65, "etc": [25, 31, 32, 37, 42, 45, 61, 65, 67, 84], "etyp": 44, "euclidean": [36, 42], "euro": 33, "eval": 53, "evalu": 58, "even": [14, 18, 19, 23, 24, 26, 28, 29, 32, 36, 40, 42, 44, 54, 57, 62, 63, 64, 65, 67, 68, 72, 84], "event": [0, 15, 18, 22, 23, 24, 26, 32, 33, 34, 37, 38, 39, 40, 47, 54, 57, 61, 62, 63, 66, 67, 69, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 89], "event_nam": 25, "eventlist": [25, 26], "eventtyp": [5, 25], "eventu": [12, 23, 25], "event\ubb38": [76, 78], "event\ubb38\uc5d0": 80, "event\ubb38\uc5d0\uc11c": 79, "event\ubb38\uc744": 79, "event\ubb38\uc774": 78, "ever": [37, 40, 59], "everi": [15, 18, 19, 22, 25, 26, 32, 33, 35, 36, 38, 40, 44, 50, 51, 52, 54, 56, 59, 61, 62, 63, 64, 65, 67, 68, 69, 70, 71, 74, 84, 85, 86, 88], "everyth": [25, 43, 44, 62, 63, 64, 65, 66, 67, 68, 73, 84, 85, 89], "evil": 84, "evolv": 26, "ex": [39, 70], "exact": [20, 22, 23, 24, 31, 32, 39, 57, 72, 73], "exactli": [37, 42, 45, 51, 58, 62, 63, 64, 65, 68, 84], "examin": 15, "exampl": [10, 15, 17, 20, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 44, 45, 46, 47, 49, 50, 51, 53, 56, 57, 60, 61, 62, 63, 64, 67, 68, 70, 71, 74, 84, 85, 86, 87, 88], "exce": 51, "exceedingli": 29, "excel": [58, 62, 63], "except": [1, 3, 4, 5, 6, 7, 8, 9, 11, 14, 20, 22, 23, 24, 25, 28, 29, 31, 33, 37, 38, 44, 45, 46, 51, 56, 59, 60, 61, 65, 69, 86, 89], "exchang": 42, "excit": [58, 62, 63, 65], "exclaim": 33, "exclud": [17, 25, 51, 53], "exclus": [37, 51, 59], "execut": [15, 39, 53, 66, 67, 68, 69, 70, 71, 73, 84], "exemplari": 18, "exist": [18, 19, 22, 23, 24, 25, 28, 29, 32, 33, 37, 47, 48, 50, 51, 64], "exit": [23, 24, 32, 37, 44, 48, 62, 63, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 85, 86, 89], "expand": [56, 61], "expans": 56, "expect": [20, 27, 31, 33, 36, 37, 38, 39, 43, 53, 57, 62], "expens": 65, "experi": [25, 63, 64, 70], "experiment": [18, 23, 25, 28, 30, 33, 36, 44, 45, 46, 48, 51, 56, 57], "expir": 53, "explain": [58, 62, 64, 68, 71, 73, 86, 87, 89], "explan": [26, 36, 60, 64, 66, 68, 70, 84], "explanatori": 58, "explicit": [23, 39, 43], "explicitli": [18, 23, 29, 30, 42, 54, 56, 58, 60], "explor": 63, "explos": 64, "export": [0, 10, 20, 31, 38, 42, 43, 51], "expos": [2, 10, 29, 43, 51], "express": [18, 20], "extend": [17, 24, 31, 44, 50], "extens": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 15, 31, 56, 63], "extern": [22, 25, 49, 52, 67], "extptr": 9, "extra": [22, 29, 38, 45, 50, 51, 58, 59, 62, 63, 64, 65, 70, 84, 89], "extract": [42, 56, 58], "extrem": [26, 58, 62, 65], "ey": 63, "f": [1, 17, 18, 32, 33, 45, 84, 86, 89], "f1": 33, "f10": 33, "f11": 33, "f12": 33, "f13": 33, "f14": 33, "f15": 33, "f2": 33, "f3": 33, "f4": 33, "f5": 33, "f6": 33, "f7": 33, "f8": 33, "f9": 33, "face": 15, "fact": [30, 64, 84], "factor": [26, 29, 56, 65], "fade": [26, 38, 40, 65], "fade_m": [38, 40], "fadeout": [38, 40], "fail": [23, 25, 27, 29, 44, 53, 58, 60, 84], "failur": [1, 2, 3, 4, 5, 7, 8, 53], "fairli": [50, 60, 63, 84, 86, 87], "fake": [26, 28, 53], "fall": [28, 29, 50], "fals": [2, 4, 5, 6, 11, 12, 15, 17, 18, 19, 22, 23, 24, 25, 26, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 44, 45, 46, 47, 48, 50, 53, 56, 57, 58, 62, 66, 89], "famili": 28, "familiar": [62, 63, 64, 84, 85, 88], "fan": 15, "fantast": 62, "far": [20, 36, 58, 62, 71, 84, 87, 88, 89], "farther": [58, 62], "fast": [32, 35, 42, 51, 52, 56, 58, 62, 63, 64, 65, 69, 84], "faster": [31, 36, 44, 50, 51, 52, 56, 58, 64, 65, 67, 84], "fastest": [23, 51, 58, 63], "fastev": 27, "fastrendergroup": 26, "favorit": 84, "favour": 27, "fbcon": 23, "fear": 84, "featur": [15, 23, 25, 26, 27, 28, 29, 35, 36, 44, 45, 50, 51, 56, 59, 64, 65, 84, 87], "fed": 18, "feed": 89, "feedback": [23, 28, 33, 36, 45, 51, 56], "feel": [26, 62, 64, 84], "felt": 63, "fetch": 50, "fever": [58, 66], "few": [22, 28, 54, 62, 63, 64, 65, 74, 84, 86], "ffff": 14, "fgcolor": 29, "field": [4, 8, 12, 17, 32, 37], "fighter": 63, "figur": [62, 84], "file": [0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 22, 23, 25, 26, 28, 29, 31, 38, 40, 44, 49, 53, 58, 61, 63, 65, 67, 68, 73, 84, 86], "file_path": [26, 28], "filenam": [6, 22, 28, 29, 31, 38, 40, 62, 86], "filenotfounderror": [86, 89], "fileobj": [31, 40], "filesystem": 14, "fill": [5, 8, 9, 15, 22, 23, 24, 25, 26, 29, 30, 32, 35, 39, 43, 48, 50, 51, 56, 57, 58, 62, 63, 64, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 89], "fill_rect": 48, "filled_": 30, "filled_circl": 30, "filled_ellips": 30, "filled_polygon": 30, "filled_trigon": 30, "fill\ud568\uc218\ub098": 76, "filter": [15, 25, 35, 56, 65], "fin": 26, "final": [22, 26, 28, 29, 42, 44, 51, 58, 61, 62, 71, 84, 85, 86, 89], "final_level": 36, "find": [15, 18, 19, 23, 24, 25, 26, 28, 32, 35, 36, 38, 50, 51, 56, 57, 58, 59, 62, 63, 64, 65, 69, 71, 84, 87, 89], "find_channel": 38, "fine": [38, 51, 59, 64, 84], "finer": 57, "finger": [55, 70, 86], "finger_id": 25, "fingerdown": 25, "fingermot": 25, "fingerup": 25, "finish": [12, 33, 38, 40, 51, 60, 61, 62, 63, 65, 84], "finit": 35, "fire": [65, 84], "firebrick": 21, "firebrick1": 21, "firebrick2": 21, "firebrick3": 21, "firebrick4": 21, "firmer": [61, 63], "first": [3, 17, 19, 24, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 40, 42, 43, 45, 49, 50, 51, 52, 54, 57, 58, 59, 60, 61, 63, 64, 65, 68, 69, 70, 71, 72, 73, 84, 85, 87, 88, 89], "firstli": 70, "fist": [15, 58, 66], "fist_offset": [58, 66], "fit": [16, 18, 23, 29, 38, 45, 51, 85], "five": [38, 39, 40], "fix": [25, 29, 51, 56, 63, 65, 68, 69, 71, 84, 89], "fixed_s": 29, "fixed_width": 29, "flag": [1, 17, 20, 23, 24, 26, 28, 29, 32, 34, 35, 43, 50, 51, 58, 59, 64, 84], "flame": 65, "flash": 15, "flavor": 84, "flesh": 15, "flexibl": [15, 60, 64, 86, 87], "flip": [15, 18, 22, 23, 24, 25, 31, 32, 35, 39, 42, 45, 48, 50, 56, 57, 58, 63, 65, 66, 75, 76, 77, 78, 79, 80, 81, 84, 85, 89], "flip_i": [48, 56], "flip_x": [48, 56], "float": [1, 17, 19, 20, 24, 25, 29, 30, 32, 35, 36, 38, 40, 45, 48, 50, 54, 56, 65], "flood": [73, 81], "floor": 20, "floralwhit": 21, "flourish": 70, "flush": [31, 37], "fly": [45, 84, 85, 88], "fnt": 29, "focu": [23, 25, 32, 33, 39, 44, 48, 57, 67], "folder": [58, 63], "folk": 62, "follow": [17, 18, 22, 24, 25, 26, 29, 30, 31, 32, 33, 35, 36, 37, 38, 40, 45, 46, 47, 49, 50, 52, 58, 61, 63, 64, 65, 66, 67, 84], "font": [6, 15, 26, 32, 44, 58, 60, 63, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 84, 85], "font_index": [6, 29], "fonti": 26, "foo": 84, "fool": [63, 65], "forbidden": 9, "forc": [23, 26, 38, 44, 63], "forcibli": 38, "forego": 25, "foreground": [25, 29], "foreign": 62, "forestgreen": 21, "forev": [62, 84], "forget": [32, 64, 87], "form": [18, 22, 25, 30, 37, 51, 84, 85], "formal": 62, "format": [18, 20, 22, 23, 24, 29, 30, 31, 35, 37, 38, 40, 41, 42, 43, 44, 45, 49, 51, 52, 56, 58, 59, 62, 63, 65, 68, 84, 85], "formula": [20, 36, 42, 44, 51, 56, 87], "forth": 58, "fortun": [26, 62, 65], "forward": 33, "found": [15, 20, 26, 28, 29, 33, 34, 35, 37, 45, 49, 50, 51, 52, 58, 59, 62, 65, 70, 85, 88], "four": [3, 19, 22, 23, 24, 29, 45, 52, 70, 89], "fourth": [22, 71], "fout": 26, "fp": [15, 46, 50, 69, 77, 84], "fpsclock": [69, 70, 71, 72, 73, 77, 78, 79, 80, 81], "fps\uac00": 77, "fps\uac12\uc774": 77, "fps\ub294": 77, "fps\ub300\ub85c": 77, "fraction": 29, "frame": [15, 18, 23, 25, 27, 32, 44, 50, 54, 57, 58, 62, 63, 64, 69, 77, 84, 85, 88, 89], "framebuff": 23, "framer": [15, 18, 54, 57, 58, 62], "framework": [26, 63, 84], "free": [9, 25, 26, 40, 62, 64, 84], "freed": 11, "freedom": [15, 63], "freesansbold": 28, "freetyp": [6, 15, 26, 28, 29, 44], "freetype2": 29, "freetype_misc": [26, 29], "frequenc": [37, 38], "frequency_to_midi": 37, "frequent": [32, 62, 64, 69, 84], "fresh": 84, "friendli": [24, 68], "friendlier": 63, "frill": 64, "from": [0, 3, 5, 6, 8, 15, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 56, 57, 58, 60, 61, 63, 64, 65, 67, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 84, 85, 86, 87, 88, 89], "from_display_modul": 48, "from_joystick": 47, "from_polar": 36, "from_spher": 36, "from_surfac": [35, 48, 50], "from_threshold": [35, 57], "from_window": 48, "frombuff": 31, "frombyt": 31, "fromstr": 31, "front": 50, "frontend": 25, "frozen": [53, 84], "frustrat": 84, "ftfont": [28, 29], "fuchsia": 21, "full": [15, 23, 25, 26, 27, 28, 29, 31, 32, 38, 39, 40, 42, 50, 51, 56, 57, 58, 59, 62, 63, 64, 66, 70, 84, 85, 86, 89], "fulli": [20, 23, 33, 45, 48, 50, 51, 52, 58, 62, 65, 84], "fullnam": [58, 66, 86, 89], "fullscreen": [23, 34, 48, 50, 59], "fullscreen_desktop": 48, "fun": [26, 57, 62, 63, 65, 84], "func": 45, "function": [0, 1, 7, 8, 9, 12, 15, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 57, 58, 60, 61, 63, 64, 66, 67, 68, 69, 70, 72, 73, 84, 85, 87, 88, 89], "fundament": [61, 84], "funni": 64, "further": 46, "furthermor": [68, 70, 71], "futur": [18, 19, 23, 25, 27, 28, 29, 32, 37, 38, 41, 46, 64], "g": [20, 23, 24, 26, 28, 30, 31, 33, 36, 37, 42, 43, 44, 45, 50, 51, 56, 84, 87, 88], "gain": [23, 25, 29, 57, 84], "gainsboro": 21, "game": [15, 16, 18, 22, 23, 25, 26, 27, 32, 39, 44, 47, 51, 54, 57, 59, 60, 62, 64, 66, 67, 68, 69, 70, 71, 72, 73, 74, 86, 88, 89], "gameobject": [62, 84], "gamepad": [25, 47], "gameplai": [33, 64, 89], "gamma": [20, 23], "gap": [17, 51], "garbag": [12, 50, 51], "gather": 59, "gaussian": 65, "gener": [1, 15, 23, 25, 26, 31, 32, 33, 36, 37, 39, 40, 42, 47, 51, 52, 56, 57, 58, 63, 64, 65, 68, 73, 84, 86, 89], "generateboard": [73, 81], "geniu": 74, "geometri": [67, 71], "get": [2, 15, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 35, 37, 38, 39, 40, 42, 43, 44, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 85, 86, 87, 88, 89], "get_abs_offset": 51, "get_abs_par": 51, "get_act": 23, "get_al": 19, "get_allow_screensav": 23, "get_alpha": [51, 86, 89], "get_and_flip": 57, "get_arraytyp": [49, 52], "get_asc": 28, "get_at": [35, 51, 56, 58, 65, 66, 84], "get_at_map": [20, 51], "get_axi": [32, 47], "get_backend": 18, "get_bal": 32, "get_bits": 51, "get_block": 25, "get_bold": 28, "get_bottom_lay": 50, "get_bounding_rect": [35, 51], "get_buff": [2, 17, 51], "get_busi": [19, 38, 40], "get_button": [32, 47], "get_bytes": [42, 51], "get_cache_s": 29, "get_capt": 23, "get_clip": [50, 51], "get_colorkei": 51, "get_control": [18, 57], "get_count": [19, 32, 37, 47], "get_curr": 19, "get_cursor": 39, "get_default_font": [28, 29], "get_default_input_id": 37, "get_default_output_id": 37, "get_default_resolut": 29, "get_desc": 28, "get_desktop_s": [23, 59], "get_devic": 55, "get_device_info": 37, "get_driv": [23, 59], "get_empti": 19, "get_endev": [38, 40], "get_error": [29, 44], "get_eventst": 47, "get_extend": 31, "get_fing": 55, "get_flag": 51, "get_focus": [23, 33, 39], "get_font": 28, "get_fp": 54, "get_grab": 25, "get_guid": 32, "get_hardwar": 41, "get_hat": 32, "get_height": [15, 28, 51], "get_id": [19, 32], "get_imag": [18, 57], "get_init": [19, 23, 27, 28, 29, 32, 37, 38, 44, 46, 47, 49, 58, 60, 66], "get_instance_id": 32, "get_ital": 28, "get_keyboard_grab": 25, "get_layer_of_sprit": 50, "get_length": 38, "get_lines": 28, "get_lock": 51, "get_loss": 51, "get_map": 47, "get_mask": 51, "get_metr": 29, "get_mod": 33, "get_nam": [19, 32], "get_num_channel": 38, "get_num_devic": 55, "get_num_displai": 23, "get_num_fing": 55, "get_numax": 32, "get_numbal": 32, "get_numbutton": 32, "get_numhat": 32, "get_numtrack": 19, "get_offset": 51, "get_palett": 51, "get_palette_at": 51, "get_par": 51, "get_paus": 19, "get_pitch": 51, "get_po": [39, 40, 58, 66, 84], "get_power_level": 32, "get_press": [15, 33, 39, 62, 84], "get_queu": 38, "get_raw": [18, 38], "get_rawtim": 54, "get_rect": [29, 35, 48, 50, 51, 56, 58, 62, 63, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 85, 86, 87, 88, 89], "get_rel": 39, "get_repeat": 33, "get_sdl_byteord": 44, "get_sdl_image_vers": 31, "get_sdl_mixer_vers": 38, "get_sdl_ttf_vers": 28, "get_sdl_vers": [23, 44], "get_shift": 51, "get_siz": [18, 29, 35, 42, 51, 58, 66, 85, 89], "get_sized_ascend": 29, "get_sized_descend": 29, "get_sized_glyph_height": 29, "get_sized_height": 29, "get_smoothscale_backend": 56, "get_sound": 38, "get_sprit": 50, "get_sprites_at": 50, "get_sprites_from_lay": 50, "get_strikethrough": 28, "get_surfac": [23, 58, 66, 87, 88, 89], "get_tick": 54, "get_tim": 54, "get_top_lay": 50, "get_top_sprit": 50, "get_track_audio": 19, "get_track_length": 19, "get_track_start": 19, "get_typ": 46, "get_underlin": 28, "get_vers": 29, "get_view": [17, 51], "get_viewport": 48, "get_vis": 39, "get_volum": [38, 40], "get_width": [15, 51, 58, 66], "get_window_s": 23, "get_wm_info": 23, "getbufferproc": 2, "getch": [67, 75], "getfilesystemencod": [14, 44], "getopt": [86, 89], "gfxdraw": [10, 15, 24, 30], "gg": 20, "ggi": 23, "ghost": 64, "ghostwhit": 21, "gif": [31, 63, 79, 80, 81, 84], "gil": [9, 30], "github": [44, 46, 56], "give": [15, 17, 22, 23, 29, 32, 37, 40, 42, 50, 51, 58, 59, 60, 61, 65, 74, 84, 85, 86, 87], "given": [8, 13, 17, 20, 22, 23, 24, 25, 28, 29, 30, 32, 35, 36, 37, 38, 39, 44, 45, 46, 47, 50, 51, 52, 54, 55, 56, 58, 59, 64, 68, 70, 73, 84], "gl": 23, "gl_accelerated_visu": 23, "gl_accum_alpha_s": 23, "gl_accum_blue_s": 23, "gl_accum_green_s": 23, "gl_accum_red_s": 23, "gl_alpha_s": 23, "gl_buffer_s": 23, "gl_context_flag": 23, "gl_context_major_vers": 23, "gl_context_minor_vers": 23, "gl_context_profile_": 23, "gl_context_profile_compat": 23, "gl_context_profile_cor": 23, "gl_context_profile_mask": 23, "gl_context_release_behavior": 23, "gl_depth_siz": 23, "gl_framebuffer_srgb_cap": 23, "gl_get_attribut": 23, "gl_multisamplebuff": 23, "gl_multisamplesampl": 23, "gl_set_attribut": 23, "gl_share_with_current_context": 23, "gl_stencil_s": 23, "gl_stereo": 23, "glcube": 26, "glitch": 89, "global": [28, 53, 60, 68, 86, 89], "glsl": 36, "glue": 89, "glyph": [28, 29], "gnu": [86, 89], "go": [20, 22, 23, 24, 32, 36, 37, 51, 53, 57, 58, 59, 60, 61, 64, 65, 66, 68, 70, 74, 84, 85, 86, 88, 89], "goal": 63, "goe": [58, 62, 64, 68, 84, 89], "gold": 21, "gold1": 21, "gold2": 21, "gold3": 21, "gold4": 21, "golden": 59, "goldenrod": 21, "goldenrod1": 21, "goldenrod2": 21, "goldenrod3": 21, "goldenrod4": 21, "gone": [62, 89], "good": [15, 18, 22, 23, 26, 28, 38, 44, 51, 58, 61, 62, 63, 64, 65, 67, 68, 84, 85, 86, 87, 89], "goodluck": 26, "googl": 84, "got": [15, 25, 40, 57, 62, 64, 84], "gotten": 62, "grab": [25, 33, 39, 48, 62, 64, 89], "grace": 89, "gradient": [26, 35, 65], "grai": [21, 29, 71, 72, 73, 79, 80, 81], "grain": 84, "graphic": [23, 26, 56, 58, 59, 62, 63, 64, 65, 67, 68, 84], "grasp": [61, 89], "grave": 33, "gray0": 21, "gray1": 21, "gray10": 21, "gray100": 21, "gray11": 21, "gray12": 21, "gray13": 21, "gray14": 21, "gray15": 21, "gray16": 21, "gray17": 21, "gray18": 21, "gray19": 21, "gray2": 21, "gray20": 21, "gray21": 21, "gray22": 21, "gray23": 21, "gray24": 21, "gray25": 21, "gray26": 21, "gray27": 21, "gray28": 21, "gray29": 21, "gray3": 21, "gray30": 21, "gray31": 21, "gray32": 21, "gray33": 21, "gray34": 21, "gray35": 21, "gray36": 21, "gray37": 21, "gray38": 21, "gray39": 21, "gray4": 21, "gray40": 21, "gray41": 21, "gray42": 21, "gray43": 21, "gray44": 21, "gray45": 21, "gray46": 21, "gray47": 21, "gray48": 21, "gray49": 21, "gray5": 21, "gray50": 21, "gray51": 21, "gray52": 21, "gray53": 21, "gray54": 21, "gray55": 21, "gray56": 21, "gray57": 21, "gray58": 21, "gray59": 21, "gray6": 21, "gray60": 21, "gray61": 21, "gray62": 21, "gray63": 21, "gray64": 21, "gray65": 21, "gray66": 21, "gray67": 21, "gray68": 21, "gray69": 21, "gray7": 21, "gray70": 21, "gray71": 21, "gray72": 21, "gray73": 21, "gray74": 21, "gray75": 21, "gray76": 21, "gray77": 21, "gray78": 21, "gray79": 21, "gray8": 21, "gray80": 21, "gray81": 21, "gray82": 21, "gray83": 21, "gray84": 21, "gray85": 21, "gray86": 21, "gray87": 21, "gray88": 21, "gray89": 21, "gray9": 21, "gray90": 21, "gray91": 21, "gray92": 21, "gray93": 21, "gray94": 21, "gray95": 21, "gray96": 21, "gray97": 21, "gray98": 21, "gray99": 21, "grayscal": [20, 56], "great": [23, 57, 63, 65, 84], "greater": [17, 24, 28, 29, 33, 35, 36, 37, 40, 51, 74], "green": [1, 18, 20, 21, 23, 24, 42, 51, 52, 56, 57, 58, 65, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 85], "green1": 21, "green2": 21, "green3": 21, "green4": 21, "greenyellow": 21, "grei": [21, 58], "grey0": 21, "grey1": 21, "grey10": 21, "grey100": 21, "grey11": 21, "grey12": 21, "grey13": 21, "grey14": 21, "grey15": 21, "grey16": 21, "grey17": 21, "grey18": 21, "grey19": 21, "grey2": 21, "grey20": 21, "grey21": 21, "grey22": 21, "grey23": 21, "grey24": 21, "grey25": 21, "grey26": 21, "grey27": 21, "grey28": 21, "grey29": 21, "grey3": 21, "grey30": 21, "grey31": 21, "grey32": 21, "grey33": 21, "grey34": 21, "grey35": 21, "grey36": 21, "grey37": 21, "grey38": 21, "grey39": 21, "grey4": 21, "grey40": 21, "grey41": 21, "grey42": 21, "grey43": 21, "grey44": 21, "grey45": 21, "grey46": 21, "grey47": 21, "grey48": 21, "grey49": 21, "grey5": 21, "grey50": 21, "grey51": 21, "grey52": 21, "grey53": 21, "grey54": 21, "grey55": 21, "grey56": 21, "grey57": 21, "grey58": 21, "grey59": 21, "grey6": 21, "grey60": 21, "grey61": 21, "grey62": 21, "grey63": 21, "grey64": 21, "grey65": 21, "grey66": 21, "grey67": 21, "grey68": 21, "grey69": 21, "grey7": 21, "grey70": 21, "grey71": 21, "grey72": 21, "grey73": 21, "grey74": 21, "grey75": 21, "grey76": 21, "grey77": 21, "grey78": 21, "grey79": 21, "grey8": 21, "grey80": 21, "grey81": 21, "grey82": 21, "grey83": 21, "grey84": 21, "grey85": 21, "grey86": 21, "grey87": 21, "grey88": 21, "grey89": 21, "grey9": 21, "grey90": 21, "grey91": 21, "grey92": 21, "grey93": 21, "grey94": 21, "grey95": 21, "grey96": 21, "grey97": 21, "grey98": 21, "grey99": 21, "greyscal": 56, "grid": 29, "ground": 62, "group": [26, 35, 50, 58, 63, 84, 86], "group1": [50, 64], "group2": [50, 64], "group_list": 50, "groupcollid": [50, 64, 87], "groupmulti": 64, "groupsingl": [50, 64], "grow": [24, 45, 84], "guarante": [18, 23, 25, 33, 38, 46, 53], "guess": [38, 84], "gui": [25, 63, 67, 71, 72, 73, 75, 79], "guid": [15, 32, 57, 65, 85], "gui\uac00": 80, "gui\ub97c": 76, "gui\uc5d0\uc11c\uc758": 80, "gui\uc774\ubbc0\ub85c": 76, "gui\uc774\uc9c0\ub9cc": 81, "gui\uc784\uc744": 76, "gui\ud658\uacbd\uc5d0\uc11c": 76, "gun": 71, "g\uac12": 76, "h": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 20, 25, 26, 30, 33, 42, 43, 45, 51, 56], "ha": [1, 2, 10, 15, 17, 18, 19, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 35, 36, 38, 39, 40, 42, 43, 44, 45, 46, 47, 49, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 62, 63, 64, 65, 67, 68, 69, 70, 71, 72, 73, 84, 86, 87, 89], "habit": [84, 87], "had": [24, 51, 63, 64, 84], "hadn": 84, "half": [24, 26, 36, 50, 63], "hand": [20, 22, 42, 43, 58, 60, 62, 84, 87], "handi": [26, 61, 84, 86, 87, 88, 89], "handili": 89, "handl": [9, 14, 15, 23, 25, 28, 29, 32, 33, 38, 43, 44, 50, 56, 59, 61, 63, 64, 65, 66, 70, 84, 87, 89], "handler": [25, 27], "hang": 32, "happen": [19, 24, 58, 60, 62, 63, 64, 84, 85, 88, 89], "hard": [62, 63, 65, 68], "hardcod": 26, "harder": [61, 65, 84], "hardest": 64, "hardwar": [22, 23, 24, 30, 32, 37, 38, 41, 51, 63, 64, 65, 84], "harfbuzz": 28, "harmless": 23, "hasattr": 28, "hash": 33, "hashabl": 45, "hasn": 29, "hat": [25, 32, 47], "hat_numb": 32, "have": [1, 3, 8, 10, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 35, 36, 38, 40, 41, 42, 43, 44, 45, 47, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 67, 68, 69, 70, 72, 73, 84, 85, 86, 87, 88, 89], "haven": 84, "he": [58, 84, 85], "header": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 68, 70, 76], "header\uc5d0\uc120": 76, "header\uc758": 78, "headless": 26, "headless_no_windows_need": 26, "heavili": 25, "height": [8, 18, 22, 23, 24, 26, 28, 29, 31, 32, 35, 41, 42, 45, 48, 50, 51, 56, 59, 62, 63, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84], "held": [33, 62, 88], "hello": [68, 69, 70, 76, 77, 78, 85], "help": [15, 22, 25, 26, 28, 32, 33, 36, 37, 38, 39, 48, 50, 51, 53, 54, 58, 59, 61, 64, 65, 70, 84, 86, 87, 88], "helper": 63, "henc": 29, "here": [15, 16, 18, 23, 25, 26, 34, 35, 39, 41, 44, 50, 51, 58, 59, 60, 64, 65, 66, 68, 70, 84, 85, 86, 87, 88, 89], "hex": 20, "hflip": [18, 57], "hi": [58, 62], "hidden": [23, 25, 39], "hide": [33, 39, 44, 48, 58], "high": [0, 23, 26, 50, 67, 69], "high_frequ": [32, 47], "higher": [15, 16, 23, 36, 37, 47, 50, 52, 59, 63, 64], "highest": 44, "highgui": 44, "highli": [27, 51, 84], "him": [58, 62], "hindi": 28, "hint": [23, 84], "hit": [25, 26, 58, 61, 84, 85, 87, 88], "hitbox": [58, 66], "hkey_local_machin": 37, "hline": 30, "hmm": 62, "hold": [1, 25, 28, 32, 33, 50, 56, 64, 65, 70], "holdov": 64, "home": [32, 33], "honeydew": 21, "honeydew1": 21, "honeydew2": 21, "honeydew3": 21, "honeydew4": 21, "hook": 50, "hoonwhitecatr": [68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81], "hope": 64, "hopefulli": [62, 65, 87], "horizont": [18, 24, 25, 26, 29, 30, 39, 56, 58, 62, 65], "horizontal_advance_i": 29, "horizontal_advance_x": 29, "hot": 25, "hotkei": 25, "hotpink": 21, "hotpink1": 21, "hotpink2": 21, "hotpink3": 21, "hotpink4": 21, "hotplug": 32, "hotspot": [22, 39], "hour": 84, "how": [14, 15, 19, 20, 23, 24, 26, 29, 31, 32, 33, 35, 36, 38, 40, 44, 46, 50, 51, 54, 56, 58, 61, 63, 64, 65, 68, 69, 70, 71, 72, 73, 74, 84, 87, 88, 89], "howev": [12, 18, 29, 31, 33, 34, 36, 42, 44, 45, 47, 50, 56, 62, 67, 68, 69, 70, 74, 84], "hp": [70, 71, 72, 73, 78, 79, 80, 81], "hp\ub294": [79, 81], "hp\ub97c": [79, 80], "hp\ubc14": 83, "hp\uc744": 79, "hp\uc758": 79, "hsl": 20, "hsla": 20, "hsv": [18, 20, 57], "hsva": 20, "html": [20, 70, 78], "http": [39, 56, 70, 78, 86, 89], "hue": 18, "human": [63, 74, 86], "humung": 63, "hundr": 63, "husano896": 39, "hw": [23, 59], "hwaccel": 51, "hwsurfac": [23, 51, 65, 84], "hx": 47, "i": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 63, 64, 65, 66, 67, 68, 69, 71, 72, 73, 74, 79, 80, 81, 85, 86, 87, 88, 89], "i1": 20, "i1i2i3": 20, "i2": 20, "i3": 20, "i686": 56, "icc": 25, "iceberg": 64, "icon": [23, 48], "iconifi": 23, "icontitl": 23, "id": [19, 23, 25, 32, 33, 37, 38, 48, 55], "id3": 40, "idea": [23, 51, 57, 59, 61, 63, 65, 70, 71, 72, 73, 86, 87], "ident": [25, 42, 51, 72], "identif": 37, "identifi": [25, 28, 32, 33, 44, 46, 57, 84], "idiom": [58, 84], "idl": [24, 25, 27, 32, 38, 40], "idx": 50, "ie": [31, 65], "ignor": [25, 29, 35, 37, 38, 40, 51, 53, 84], "illeg": 45, "illus": 62, "illustr": [62, 65, 87], "im": 33, "imag": [11, 12, 15, 16, 18, 20, 22, 23, 26, 28, 29, 30, 41, 46, 48, 50, 52, 56, 58, 59, 61, 63, 64, 65, 66, 67, 69, 70, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 86, 87, 88, 89], "image_fil": 26, "imagefil": 26, "imagin": [62, 85, 89], "imgsurfac": 65, "immanuel": 74, "immedi": [23, 25, 32, 37, 38, 58], "immut": 20, "implement": [9, 10, 12, 17, 18, 20, 23, 26, 29, 33, 37, 42, 43, 44, 50, 61, 63, 64, 73, 74, 84, 89], "impli": [18, 29], "implicitli": [23, 51], "import": [1, 10, 15, 18, 22, 24, 25, 26, 27, 28, 29, 30, 32, 34, 36, 38, 39, 44, 47, 49, 52, 53, 59, 61, 62, 63, 64, 66, 67, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 86, 89], "import_pygame_bas": [1, 10], "importantli": 62, "importerror": [65, 86, 89], "import\ud558\ub294": 76, "impos": [33, 38], "imprecis": 84, "impress": 63, "improperli": 41, "improv": [24, 28, 40, 58, 73, 84], "inact": [29, 38], "inch": 29, "incident": 18, "inclin": 36, "includ": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 15, 18, 22, 23, 26, 28, 29, 30, 31, 32, 34, 37, 44, 45, 50, 51, 53, 54, 56, 58, 61, 63, 64, 65, 67, 70, 74, 84, 86, 87], "inclus": [1, 3, 20, 25, 29, 38], "incom": 15, "incomplet": 53, "incorrect": 43, "increas": [23, 29, 38, 45, 50, 68, 72, 74, 84], "incredibli": [74, 84], "increment": [10, 56, 65], "inde": 3, "indefinit": [38, 40], "indent": [32, 61], "independ": [15, 31, 58, 86], "index": [1, 6, 15, 18, 19, 23, 25, 29, 32, 33, 42, 43, 44, 45, 47, 48, 49, 50, 51, 52, 55, 59, 62, 65, 84], "indexerror": [30, 35, 37, 51], "indexexcept": 17, "indexoutofbound": 50, "indianr": 21, "indianred1": 21, "indianred2": 21, "indianred3": 21, "indianred4": 21, "indic": [11, 23, 24, 25, 30, 35, 37, 39, 40, 42, 45, 46, 49, 50, 52, 53, 65], "indices0": 45, "indices1": 45, "indices2": 45, "indices3": 45, "indices4": 45, "indices5": 45, "indigo": 21, "indirect": 18, "individu": [15, 19, 29, 35, 44, 51, 53, 58, 84], "ineffici": 58, "inequ": 25, "infinit": [58, 63, 68], "inflat": [29, 45, 58, 66, 84, 89], "inflate_ip": 45, "influenc": 23, "info": [4, 23, 37, 59, 86], "inform": [5, 13, 15, 17, 18, 19, 23, 25, 28, 32, 33, 36, 37, 39, 47, 51, 52, 53, 55, 59, 62, 64, 65, 68], "inherit": [36, 50, 51, 64, 86, 87], "init": [1, 15, 18, 19, 22, 23, 24, 27, 28, 29, 32, 37, 38, 39, 44, 46, 47, 53, 54, 58, 59, 62, 63, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 89], "initi": [15, 18, 19, 23, 24, 25, 27, 28, 29, 32, 33, 34, 37, 38, 44, 46, 47, 49, 50, 51, 54, 57, 59, 63, 64, 66, 68, 69, 77, 84, 87], "initialis": [32, 44, 47, 61, 85, 88, 89], "initial\ubb38": 76, "initial\ubb38\uc5d0": 76, "initial\ubb38\uc758": 77, "innat": 74, "inner": 72, "input": [15, 18, 23, 25, 26, 28, 32, 33, 39, 44, 45, 48, 51, 53, 56, 57, 61, 63, 66, 67, 68, 69, 72, 73, 74, 78, 84, 87], "input_onli": 48, "inputimag": 26, "input\ud568\uc218\ub97c": 76, "input\ud568\uc218\uc640\ub294": 76, "insensit": [43, 51], "insert": [33, 69, 73], "insid": [22, 24, 26, 31, 44, 45, 50, 51, 57, 58, 63, 65, 71, 72, 89], "insight": 84, "inspir": 15, "instal": [15, 18, 26, 28, 31, 58, 65], "instanc": [2, 3, 4, 5, 6, 7, 8, 11, 12, 17, 19, 25, 26, 29, 30, 32, 35, 36, 38, 42, 45, 50, 51, 58, 61, 64, 85, 87, 88], "instance_id": [25, 32], "instantli": 84, "instead": [8, 14, 20, 22, 23, 24, 25, 26, 28, 29, 32, 33, 36, 38, 42, 44, 50, 51, 53, 56, 62, 64, 65, 69, 84, 87], "instruct": 56, "instrument": 37, "instrument_id": 37, "int": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 17, 18, 20, 23, 24, 25, 28, 29, 30, 32, 33, 35, 36, 37, 41, 42, 44, 45, 47, 48, 50, 51, 55, 56, 71, 72, 73, 79, 80, 81], "int32": 65, "int8": 65, "int_valu": 51, "integ": [1, 8, 13, 17, 19, 20, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 37, 38, 39, 40, 42, 43, 44, 45, 47, 49, 50, 51, 52, 53, 54, 55, 59, 65, 71, 73], "integr": 18, "intend": [25, 43, 50, 51], "interact": [5, 15, 26, 33, 34, 42, 47, 50, 53, 62, 63, 65, 70, 87], "interest": [25, 46, 63, 67, 74, 84], "interf": 37, "interfac": [1, 17, 20, 29, 33, 37, 38, 42, 43, 47, 51, 57, 63, 70, 73], "interior": 56, "intern": [0, 12, 23, 24, 25, 27, 33, 38, 44, 46, 51, 58, 68, 70, 84, 89], "internet": 84, "interpol": [20, 30, 36], "interpret": [14, 26, 29, 44, 61, 84], "interrupt": 18, "intersect": [35, 45, 50, 64, 67], "interv": 33, "intimid": 65, "intric": 63, "intro_bal": 63, "introduc": [23, 25, 31, 43, 61, 62, 65, 87, 89], "introduct": [15, 60, 75], "introspect": 43, "intuit": [70, 84], "invad": 84, "invalid": [1, 23, 38, 45, 47, 56], "invalu": 87, "inverse_set": 56, "invert": [29, 35, 36, 42], "invis": 85, "invok": [17, 29, 88], "involv": [15, 26, 29, 51, 64, 84, 87, 89], "inward": 24, "in\ubb38\uc744": 76, "ip": 45, "is_control": 47, "is_norm": 36, "iscaptur": 25, "ish": 24, "isn": [19, 27, 48, 57, 61, 62, 64, 69, 71, 84, 88], "iso": 28, "isol": [51, 57], "issu": [23, 62, 63], "ital": [28, 29], "item": [29, 30, 42, 43, 45, 50, 62, 64], "items": 42, "iter": [28, 29, 33, 42, 45, 50, 64, 84, 85, 88, 89], "its": [2, 9, 12, 17, 18, 23, 24, 25, 29, 30, 32, 35, 36, 37, 38, 42, 44, 45, 46, 48, 50, 51, 58, 59, 61, 62, 63, 64, 68, 69, 70, 84, 85, 86, 87, 88, 89], "itself": [12, 18, 28, 29, 36, 42, 43, 44, 48, 51, 58, 61, 62, 63, 64, 84, 87, 88, 89], "it\uc744": 81, "ivori": 21, "ivory1": 21, "ivory2": 21, "ivory3": 21, "ivory4": 21, "iyuv_overlai": 41, "j": [33, 35, 73, 81], "jaggi": 56, "jid": 32, "jitter": 32, "job": [63, 64], "joi": 25, "join": [31, 45, 58, 66, 86, 89], "joint": 24, "journal": 84, "joyaxismot": [25, 32], "joyballmot": [25, 32], "joybuttondown": [25, 32], "joybuttonup": [25, 32], "joydevicead": [25, 32], "joydeviceremov": [25, 32], "joyhatmot": [25, 32], "joystick": [15, 25, 26, 44, 47, 63, 84, 85, 88], "joystick_count": 32, "jp": 18, "jpeg": [31, 84], "jpg": [31, 63], "juli": 16, "jumbl": 84, "jump": [39, 62, 63, 65], "just": [24, 26, 28, 29, 30, 32, 35, 38, 40, 41, 50, 51, 52, 53, 56, 57, 58, 59, 60, 63, 64, 65, 67, 68, 69, 70, 71, 73, 84, 85, 87, 88, 89], "k": [33, 36], "k_": [15, 33, 34, 70], "k_0": 33, "k_1": 33, "k_2": 33, "k_3": 33, "k_4": 33, "k_5": 33, "k_6": 33, "k_7": 33, "k_8": [33, 70, 78], "k_9": 33, "k_a": [15, 33, 70, 78, 89], "k_ac_back": 33, "k_ampersand": 33, "k_asterisk": 33, "k_at": 33, "k_b": 33, "k_backquot": 33, "k_backslash": 33, "k_backspac": 33, "k_break": 33, "k_c": 33, "k_capslock": 33, "k_caret": 33, "k_clear": 33, "k_colon": 33, "k_comma": 33, "k_d": [15, 33], "k_delet": [33, 70, 78], "k_dollar": 33, "k_down": [33, 62, 70, 71, 72, 73, 78, 79, 80, 81, 88, 89], "k_e": 33, "k_end": 33, "k_equal": 33, "k_escap": [22, 33, 57, 58, 66], "k_euro": 33, "k_exclaim": 33, "k_f": [33, 84], "k_f1": 33, "k_f10": 33, "k_f11": 33, "k_f12": 33, "k_f13": 33, "k_f14": 33, "k_f15": 33, "k_f2": 33, "k_f3": 33, "k_f4": [33, 70], "k_f5": 33, "k_f6": 33, "k_f7": 33, "k_f8": 33, "k_f9": 33, "k_g": 33, "k_greater": 33, "k_h": 33, "k_hash": 33, "k_help": 33, "k_home": 33, "k_i": 33, "k_insert": 33, "k_j": 33, "k_k": 33, "k_kp0": 33, "k_kp1": 33, "k_kp2": 33, "k_kp3": 33, "k_kp4": 33, "k_kp5": 33, "k_kp6": 33, "k_kp7": 33, "k_kp8": 33, "k_kp9": 33, "k_kp_divid": 33, "k_kp_enter": 33, "k_kp_equal": 33, "k_kp_minu": 33, "k_kp_multipli": 33, "k_kp_period": 33, "k_kp_plu": 33, "k_l": [33, 70, 78], "k_lalt": 33, "k_lctrl": [33, 70, 78], "k_left": [33, 62, 70, 78], "k_leftbracket": 33, "k_leftparen": 33, "k_less": 33, "k_lmeta": 33, "k_lshift": 33, "k_lsuper": 33, "k_m": 33, "k_menu": 33, "k_minu": 33, "k_mode": 33, "k_n": 33, "k_numlock": 33, "k_o": 33, "k_p": 33, "k_pagedown": 33, "k_pageup": 33, "k_paus": 33, "k_period": 33, "k_plu": 33, "k_power": 33, "k_print": 33, "k_q": 33, "k_question": 33, "k_quot": 33, "k_quotedbl": 33, "k_r": 33, "k_ralt": 33, "k_rctrl": 33, "k_return": 33, "k_right": [33, 62, 70, 78], "k_rightbracket": 33, "k_rightparen": 33, "k_rmeta": 33, "k_rshift": 33, "k_rsuper": 33, "k_scrollock": 33, "k_semicolon": 33, "k_slash": 33, "k_space": 33, "k_sysreq": 33, "k_t": [33, 84], "k_tab": 33, "k_u": 33, "k_underscor": 33, "k_up": [33, 62, 70, 71, 72, 73, 78, 79, 80, 81, 88, 89], "k_v": 33, "k_w": [15, 33], "k_x": 33, "k_y": 33, "k_z": [33, 89], "k_\uc2dc\ub9ac\uc988\uc774\ub2e4": 78, "kanji": 29, "kant": 74, "kb": 16, "kde": 44, "keep": [12, 17, 25, 32, 50, 54, 56, 57, 58, 59, 60, 61, 62, 63, 64, 84, 88], "kei": [15, 17, 20, 22, 23, 25, 26, 33, 34, 35, 45, 51, 55, 57, 58, 61, 62, 63, 64, 66, 70, 71, 72, 73, 74, 78, 79, 80, 81, 84, 88, 89], "kern": [28, 29], "key_cod": 33, "key_rect": 45, "keyboard": [15, 25, 26, 34, 39, 62, 63, 67, 70, 84, 85], "keycod": 33, "keydown": [22, 25, 33, 34, 57, 58, 62, 66, 70, 71, 72, 73, 78, 79, 80, 81, 88, 89], "keydown\uc740": 78, "keydown\uc774": 80, "keymap": 25, "keymapchang": 25, "keypad": 33, "keypress": 84, "keyup": [25, 33, 34, 70, 88, 89], "keyup\uc774\ub77c\ub294": 78, "keyword": [15, 18, 23, 24, 25, 26, 29, 31, 35, 38, 44, 45, 48, 51, 53, 56], "key\ub294": 78, "khaki": 21, "khaki1": 21, "khaki2": 21, "khaki3": 21, "khaki4": 21, "khz": 49, "kick": 61, "kill": [50, 53, 64], "kind": [25, 37, 43, 51, 61, 65, 67, 84], "kmod_alt": 33, "kmod_cap": 33, "kmod_ctrl": 33, "kmod_lalt": 33, "kmod_lctrl": 33, "kmod_lmeta": 33, "kmod_lshift": 33, "kmod_meta": 33, "kmod_mod": 33, "kmod_non": 33, "kmod_num": 33, "kmod_ralt": 33, "kmod_rctrl": 33, "kmod_rmeta": 33, "kmod_rshift": 33, "kmod_shift": 33, "know": [18, 28, 31, 33, 46, 57, 58, 62, 64, 65, 67, 68, 69, 70, 73, 87, 88, 89], "knowledg": [74, 84], "known": [33, 84], "korean": 15, "kwarg": [35, 48, 50, 51], "kwd": 53, "l": [18, 20, 32, 33], "l_f4\ub4f1\uc774": 78, "l_margin": [73, 81], "lack": 23, "laggi": 38, "laid": [29, 61], "lambda": 45, "landscap": [62, 84], "languag": [25, 26, 28, 33, 62, 63, 84], "lantinga": 63, "laplacian": 56, "larg": [15, 29, 36, 43, 45, 51, 61, 64, 65, 84, 87], "larger": [23, 38, 51, 56, 58, 65, 67, 84], "largest": [35, 57, 59, 63, 65], "last": [15, 24, 29, 30, 32, 50, 51, 52, 54, 58, 62, 63, 64, 65, 68, 84], "lastli": [22, 50, 58, 59, 62, 64, 65], "late": 84, "latenc": [37, 38, 84], "later": [18, 23, 30, 33, 37, 38, 42, 46, 50, 57, 58, 59, 60, 62, 63, 64, 65, 68, 84, 86, 89], "latest": [29, 70], "latin1": [28, 29], "latter": 25, "lavend": 21, "lavenderblush": 21, "lavenderblush1": 21, "lavenderblush2": 21, "lavenderblush3": 21, "lavenderblush4": 21, "lawngreen": 21, "layer": [16, 50, 63, 64], "layer1": 50, "layer1_nr": 50, "layer2": 50, "layer2_nr": 50, "layer_nr": 50, "layereddirti": 50, "layeredupd": 50, "layout": [17, 25, 28, 29, 43, 52, 88], "lbm": 31, "lead": 36, "leak": 62, "learn": [26, 51, 59, 62, 63, 65, 67, 68, 69, 70, 73, 74, 84], "learnt": 89, "least": [13, 24, 30, 35, 43, 51, 55, 61, 65, 67, 70, 84], "leav": [24, 28, 29, 33, 36, 45, 51, 56, 65], "left": [20, 23, 24, 25, 29, 33, 35, 38, 39, 44, 45, 47, 50, 51, 57, 58, 62, 63, 66, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 86, 87, 88, 89], "leftclick": 26, "leftmost": 47, "legaci": [25, 27, 33, 67, 75], "legacy_logo": 16, "lemonchiffon": 21, "lemonchiffon1": 21, "lemonchiffon2": 21, "lemonchiffon3": 21, "lemonchiffon4": 21, "len": [17, 20, 22, 24, 30, 50, 64, 65], "length": [1, 3, 8, 17, 19, 20, 23, 24, 25, 30, 32, 33, 36, 38, 42, 47, 51, 58, 68, 87], "length_squar": 36, "leonidovich": 74, "lerp": [20, 36], "less": [24, 27, 28, 33, 35, 37, 38, 54, 55, 56, 67, 85], "lesson": 84, "let": [9, 20, 21, 26, 44, 51, 58, 59, 61, 63, 65, 69, 70, 71, 84, 88], "letter": [19, 28, 51], "level": [0, 15, 17, 20, 23, 28, 32, 36, 37, 38, 40, 41, 51, 53, 56, 63, 64, 65, 67, 70], "lgpl": 15, "li": 84, "liabil": 18, "liabl": 18, "lib": 26, "librari": [15, 18, 26, 28, 29, 30, 31, 32, 37, 38, 44, 47, 59, 62, 63, 67], "libsdl": 39, "licens": [15, 86, 89], "lie": [30, 45], "life": [57, 59], "lifetim": [12, 42, 52, 65], "lightblu": 21, "lightblue1": 21, "lightblue2": 21, "lightblue3": 21, "lightblue4": 21, "lightcor": 21, "lightcyan": 21, "lightcyan1": 21, "lightcyan2": 21, "lightcyan3": 21, "lightcyan4": 21, "lightgoldenrod": 21, "lightgoldenrod1": 21, "lightgoldenrod2": 21, "lightgoldenrod3": 21, "lightgoldenrod4": 21, "lightgoldenrodyellow": 21, "lightgrai": 21, "lightgreen": 21, "lightgrei": 21, "lightpink": 21, "lightpink1": 21, "lightpink2": 21, "lightpink3": 21, "lightpink4": 21, "lightsalmon": 21, "lightsalmon1": 21, "lightsalmon2": 21, "lightsalmon3": 21, "lightsalmon4": 21, "lightseagreen": 21, "lightskyblu": 21, "lightskyblue1": 21, "lightskyblue2": 21, "lightskyblue3": 21, "lightskyblue4": 21, "lightslateblu": 21, "lightslategrai": 21, "lightslategrei": 21, "lightsteelblu": 21, "lightsteelblue1": 21, "lightsteelblue2": 21, "lightsteelblue3": 21, "lightsteelblue4": 21, "lightweight": [50, 84], "lightyellow": 21, "lightyellow1": 21, "lightyellow2": 21, "lightyellow3": 21, "lightyellow4": 21, "like": [1, 9, 15, 18, 20, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 34, 35, 36, 38, 39, 40, 42, 44, 45, 47, 50, 51, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 68, 69, 70, 72, 73, 74, 84, 85, 86, 87, 88, 89], "lime": 21, "limegreen": 21, "limit": [15, 18, 19, 23, 24, 25, 29, 31, 32, 38, 40, 51, 52, 53, 54, 60, 63, 64, 65, 73], "line": [15, 24, 26, 28, 30, 31, 32, 45, 48, 53, 60, 61, 62, 63, 64, 65, 66, 68, 69, 70, 84, 87, 89], "line_height": 32, "line_spac": 29, "linear": [20, 23, 36, 50, 65], "linearli": [36, 51], "linen": 21, "link": [28, 29, 31, 38, 44], "linux": [18, 23, 37, 40, 44, 57, 63, 84], "liquid": [26, 62], "list": [15, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 32, 33, 34, 35, 37, 41, 44, 45, 46, 50, 51, 53, 58, 59, 64, 65, 68, 70, 84], "list_camera": [18, 57], "list_mod": [23, 59], "list_of_double_tupl": 45, "list_of_list": 45, "list_of_object_with_callable_rect": 45, "list_of_object_with_rect_attribut": 45, "list_of_rect": 45, "list_of_tupl": 45, "listen": 39, "littl": [17, 22, 26, 44, 50, 54, 58, 59, 61, 62, 64, 65, 68, 84, 87, 88], "live": [15, 26, 65], "ll": [22, 36, 58, 61, 62, 63, 64, 65, 84, 85, 87, 88, 89], "load": [7, 15, 18, 22, 26, 30, 31, 40, 50, 59, 61, 62, 63, 65, 66, 75, 76, 77, 78, 79, 80, 81, 84, 87, 89], "load_background_imag": 62, "load_bas": 31, "load_extend": 31, "load_imag": [58, 66], "load_player_imag": 62, "load_png": [86, 87, 88, 89], "load_sound": [58, 66, 86], "load_xbm": 22, "local": [8, 15, 25, 33, 34, 38, 39, 44, 57, 58, 60, 61, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 85, 86, 89], "localechang": 25, "locals\ub85c\ubd80\ud130": 78, "locat": [25, 26, 34, 35, 39, 41, 58, 68, 69, 70, 71, 72, 73, 84], "lock": [12, 17, 24, 25, 27, 33, 42, 43, 50, 51, 52], "lockobj": 12, "logger": 26, "logic": [48, 58, 61, 63, 65, 68, 69, 70, 71, 84, 86], "logical_s": 48, "logo": [15, 23], "loki": 63, "long": [6, 25, 27, 29, 35, 38, 40, 44, 50, 53, 63, 64, 84, 88], "longer": [19, 28, 32, 38, 47, 87, 88], "longest": [38, 84], "look": [22, 24, 28, 36, 37, 44, 46, 51, 52, 56, 57, 58, 62, 63, 64, 65, 68, 69, 70, 72, 84, 85, 86, 87, 88, 89], "lookout": 26, "lookup": [23, 25, 50, 58, 65], "loop": [15, 24, 25, 32, 38, 40, 54, 57, 61, 62, 63, 64, 66, 68, 84, 86, 87, 88, 89], "lose": [19, 23, 25, 33, 56], "loss": [18, 23, 58, 59, 84], "lost": [25, 40, 46, 62], "lostsprit": 64, "lot": [26, 32, 51, 54, 56, 58, 59, 61, 62, 63, 64, 65, 67, 73, 84, 85, 87, 89], "loud": 38, "love": 84, "low": [25, 32, 63, 67], "low_frequ": [32, 47], "lower": [19, 23, 32, 36, 37, 38, 41, 52, 84], "lowercas": 28, "lowest": 37, "lowli": 84, "lt": 32, "luck": 65, "luckili": 84, "luma": 18, "luminos": [20, 56], "m": [15, 20, 26, 32, 33, 37, 39, 47, 53, 58, 65], "mac": [18, 23, 26, 37, 40, 44, 46, 63, 84], "machin": [26, 56, 64, 65], "maco": 22, "macro": [3, 4, 5, 6, 7, 8, 11, 13], "made": [5, 6, 11, 15, 23, 25, 49, 62, 71, 73, 74, 84, 87], "magazin": [15, 71], "magenta": 21, "magenta1": 21, "magenta2": 21, "magenta3": 21, "magenta4": 21, "magic": [62, 84, 87], "magnifi": 26, "magnitud": 36, "magnitude_squar": 36, "mai": [1, 2, 18, 19, 20, 22, 23, 25, 27, 28, 29, 30, 31, 32, 33, 36, 37, 38, 40, 43, 44, 45, 46, 51, 53, 56, 57, 59, 62, 63, 64, 65, 84], "mail": [62, 84], "main": [18, 25, 26, 27, 32, 39, 41, 46, 50, 53, 56, 57, 61, 62, 64, 65, 66, 71, 72, 73, 79, 80, 81, 85, 86, 87, 88, 89], "main_dir": [58, 66], "mainli": [28, 51, 62, 64, 65], "maintain": [28, 44, 50, 61, 62, 84], "main\ud568\uc218\ub97c": 79, "main\ud568\uc218\uc5d0": 79, "major": [13, 23, 28, 31, 38, 44, 63], "make": [0, 15, 20, 22, 24, 25, 26, 27, 31, 33, 38, 42, 44, 45, 50, 51, 52, 54, 56, 57, 58, 59, 60, 63, 64, 65, 67, 68, 70, 71, 72, 73, 74, 84, 85, 86, 87, 88, 89], "make_sound": [38, 49], "make_surfac": [42, 43, 52], "maker": [67, 74], "malform": 29, "man": 67, "manag": [15, 19, 25, 32, 38, 42, 50, 51, 59, 63, 64], "mani": [19, 23, 24, 25, 28, 29, 33, 36, 38, 39, 40, 44, 45, 50, 51, 54, 56, 58, 59, 62, 63, 84], "manifest": 84, "manipul": [15, 31, 42, 45, 51, 63, 65, 84, 87], "manner": [59, 87], "manual": [19, 28, 29, 32, 41, 44, 51, 57, 64], "map": [17, 20, 24, 42, 43, 47, 51, 52, 59, 65], "map_arrai": [43, 52], "map_rgb": [20, 24, 42, 51, 52], "mapped_int": 51, "margin": [26, 36, 68, 71, 72, 73, 80, 81], "mario": 88, "mark": [33, 42, 57, 63], "maroon": 21, "maroon1": 21, "maroon2": 21, "maroon3": 21, "maroon4": 21, "mask": [22, 23, 26, 29, 42, 50, 51, 59, 84], "maskfil": 22, "mass": 35, "master": [65, 67], "match": [17, 23, 28, 29, 31, 32, 33, 37, 38, 42, 43, 51, 52, 56, 58, 59, 62, 63, 64, 65, 68], "match_font": 28, "materi": [18, 84], "math": [24, 30, 35, 36, 86, 87, 89], "mathemat": [51, 61, 65], "matter": [31, 51, 62, 64, 84, 87], "max": [24, 32, 35, 36, 57, 71], "max_i": 29, "max_length": 36, "max_level": 36, "max_x": 29, "maxhp": [71, 72, 73, 79, 80, 81], "maxi": 28, "maxim": [25, 48], "maximum": [23, 28, 29], "maxtim": 38, "maxx": 28, "mayb": [62, 64, 70, 84, 86], "mb": 16, "me": [59, 63, 65, 84], "mean": [15, 20, 22, 23, 24, 29, 32, 33, 36, 37, 38, 39, 40, 43, 47, 48, 50, 56, 57, 58, 59, 62, 63, 64, 68, 69, 70, 71, 72, 84, 88], "meant": [44, 48, 64], "measur": [24, 37, 84, 87], "mechanim": 67, "mechanin": 75, "mediev": 63, "medium": [24, 32], "mediumaquamarin": 21, "mediumblu": 21, "mediumorchid": 21, "mediumorchid1": 21, "mediumorchid2": 21, "mediumorchid3": 21, "mediumorchid4": 21, "mediumpurpl": 21, "mediumpurple1": 21, "mediumpurple2": 21, "mediumpurple3": 21, "mediumpurple4": 21, "mediumseagreen": 21, "mediumslateblu": 21, "mediumspringgreen": 21, "mediumturquois": 21, "mediumvioletr": 21, "meet": [45, 84], "mega_jc": 16, "megabyt": 23, "member": [25, 50, 59, 64, 68, 84], "membership": [50, 64], "memori": [9, 17, 23, 24, 25, 29, 31, 38, 51, 52, 62, 67], "memoryview": 31, "mental": 74, "mention": [54, 58, 62, 64, 68, 70, 84], "menu": [23, 33, 61], "merchant": 18, "mercuri": 44, "mere": [37, 84], "merg": 64, "merrili": 89, "mess": 15, "messag": [25, 27, 37, 44, 53, 58, 84], "messi": 64, "messier": 84, "met": [18, 22], "meta": [25, 33], "method": [8, 9, 11, 14, 15, 17, 19, 20, 22, 23, 24, 25, 26, 28, 29, 30, 31, 32, 35, 36, 38, 39, 40, 42, 44, 45, 46, 49, 50, 51, 52, 54, 58, 59, 61, 62, 63, 64, 65, 71, 73, 84, 85, 86, 87, 89], "metric": [28, 29], "mice": 39, "micro": 44, "microsoft": 23, "midbottom": 45, "middl": [39, 47, 57, 62, 65], "midi": [25, 26], "midi_ev": 37, "midi_event_list": 37, "midi_not": 37, "midi_output": 37, "midi_to_ansi_not": 37, "midi_to_frequ": 37, "midiexcept": 37, "midiin": [25, 37], "midiout": [25, 37], "midis2ev": 37, "midisport": 37, "midleft": [45, 88, 89], "midnightblu": 21, "midpoint": 36, "midright": [45, 88, 89], "midtop": 45, "might": [20, 23, 25, 26, 29, 36, 44, 46, 60, 61, 62, 64, 65, 84, 86, 87, 89], "mighti": 62, "migrationguid": 39, "milli": 54, "millisecond": [25, 33, 37, 38, 40, 50, 54, 63], "mime": 46, "mimic": 29, "min": [24, 36, 57], "min_alpha": 51, "min_i": 29, "min_length": 36, "min_x": 29, "mind": [39, 54, 60, 65, 84], "minhp": 73, "mini": 28, "miniatur": 32, "minim": [23, 25, 48, 64], "minimum": [23, 24, 28, 30, 31, 35, 51], "minor": [13, 28, 31, 38, 44, 63], "mintcream": 21, "minu": 33, "minx": 28, "mirror": [23, 58], "miss": [58, 66, 84], "missingmodul": [49, 52], "mistyros": 21, "mistyrose1": 21, "mistyrose2": 21, "mistyrose3": 21, "mistyrose4": 21, "misunderstand": 84, "misunderstood": 84, "miter": 24, "mix": [28, 38, 51, 63, 65, 84], "mix_chunk": 7, "mix_setmusicposit": 40, "mixer": [0, 15, 26, 38, 44, 49, 58, 66], "mizuno": 18, "mmsystem": 37, "mmx": [26, 56], "moccasin": 21, "mod": [25, 33, 34, 40, 67], "mod_": 34, "modal": 48, "mode": [15, 20, 23, 25, 26, 28, 29, 30, 33, 38, 39, 44, 46, 48, 50, 51, 53, 58, 63, 65], "mode_ok": [23, 59], "model": 51, "modern": 84, "modest": 84, "modif": [12, 18, 51, 86], "modifi": [25, 29, 30, 33, 34, 37, 39, 45, 48, 49, 50, 51, 64, 65, 85], "modnam": 1, "modul": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 15, 17, 21, 26, 34, 41, 42, 48, 51, 53, 59, 60, 61, 62, 65, 66, 68, 84, 87, 89], "modulu": 20, "moment": [46, 49, 84, 87], "momma": 62, "monitor": [23, 34, 59, 63, 68], "monkei": [58, 63, 66], "mono": [29, 38, 49], "monochrom": 29, "monster": 64, "month": 63, "more": [15, 18, 19, 20, 23, 24, 25, 26, 28, 29, 30, 31, 32, 35, 36, 37, 38, 39, 42, 43, 44, 47, 50, 51, 54, 57, 58, 59, 60, 61, 63, 64, 70, 71, 73, 74, 84, 85, 86, 87, 88, 89], "most": [15, 19, 23, 24, 26, 28, 29, 31, 38, 39, 40, 44, 45, 50, 51, 54, 57, 59, 60, 61, 63, 64, 65, 74, 84, 85], "mostli": 70, "motion": [32, 39, 48, 63, 87, 89], "motiv": 70, "mous": [15, 22, 23, 25, 26, 32, 46, 48, 58, 61, 62, 63, 66, 67, 70, 72, 84, 85, 88], "mousebuttondown": [22, 25, 27, 39, 58, 66, 84], "mousebuttonup": [25, 39, 58, 66, 72, 73, 80, 81, 84], "mousebuttonup\uc774": 80, "mousemot": [25, 39], "mousewheel": [25, 39], "movabl": [62, 88, 89], "move": [15, 25, 26, 36, 39, 44, 45, 50, 51, 56, 58, 61, 63, 65, 66, 69, 70, 75, 76, 77, 78, 79, 80, 81, 84, 85, 87, 88, 89], "move_and_draw_all_game_object": 62, "move_ip": [45, 58, 66], "move_to_back": 50, "move_to_front": 50, "move_toward": 36, "move_towards_ip": 36, "movedown": [70, 78, 88, 89], "moveit": [26, 62], "movement": [32, 39, 50, 58, 87, 88], "movepo": [88, 89], "moveright": [69, 70, 77, 78], "moveup": [69, 77, 88, 89], "movi": 74, "mozart": 40, "mp3": 40, "msg": 37, "msmf": 18, "much": [18, 24, 26, 28, 31, 54, 56, 58, 59, 60, 61, 62, 63, 65, 67, 68, 71, 73, 74, 84, 85, 87, 89], "multi_thread": 53, "multicolor": 26, "multidimension": 65, "multigestur": 25, "multimedia": [33, 63, 84], "multipl": [1, 6, 18, 19, 22, 23, 24, 25, 26, 28, 32, 33, 36, 38, 41, 44, 45, 50, 51, 56, 57, 61, 63, 64, 65, 69], "multipli": [20, 24, 29, 33, 36, 42, 45, 48, 51, 56, 65], "multisampl": 23, "multithread": 27, "music": [7, 15, 26, 37, 38, 40, 63, 74, 86], "must": [1, 2, 3, 17, 18, 19, 20, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32, 35, 36, 37, 38, 41, 42, 43, 44, 45, 46, 47, 49, 50, 51, 52, 53, 56, 58, 59, 60, 63, 64, 65, 68, 72, 84], "mustlock": 51, "mutabl": 25, "mute": 38, "my": [26, 61, 62, 63, 65, 84, 86, 89], "my_appl": 44, "my_data_typ": 46, "mygroup": 64, "myscreen": [68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81], "mysprit": 64, "mysurf": 51, "mytext": [68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81], "mytextarea": [68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81], "mytextarea\ub294": 76, "mytextarea\ub77c\ub294": 76, "mytextfont": [68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81], "mytextfont\uac1d\uccb4\uc758": 76, "mytextfont\ub77c\ub294": 76, "mytext\uac1d\uccb4\uc758": 76, "mytext\ub77c\ub294": 76, "n": [28, 33, 38, 65], "name": [1, 9, 18, 19, 20, 23, 25, 26, 28, 29, 32, 33, 36, 37, 44, 45, 47, 50, 51, 53, 58, 59, 61, 62, 63, 64, 65, 66, 68, 70, 78, 86, 88, 89], "name_forindex": 47, "name_of_environment_vari": 44, "namehint": [31, 40], "namespac": [34, 58, 60], "nano": 31, "nasti": 86, "nativ": [15, 18, 22, 44, 57, 84], "natur": [40, 65, 74, 84, 86], "navajowhit": 21, "navajowhite1": 21, "navajowhite2": 21, "navajowhite3": 21, "navajowhite4": 21, "navi": 21, "navyblu": 21, "ndigit": 36, "ndim": 42, "nearest": [24, 38], "nearli": [36, 64, 67], "neat": 84, "neater": 88, "nebul": 84, "necessari": [9, 23, 25, 27, 29, 38, 50, 51, 60, 61, 64, 68, 84, 85, 87, 88, 89], "necessarili": 63, "need": [10, 15, 18, 19, 20, 22, 23, 25, 26, 27, 28, 31, 32, 33, 35, 42, 44, 45, 46, 50, 51, 53, 57, 58, 59, 60, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 85, 86, 87, 88, 89], "needless": [68, 71, 73, 84], "needn": [26, 61, 89], "neg": [8, 9, 17, 25, 29, 35, 36, 38, 39, 40, 42, 45, 51, 56, 65, 89], "neglig": 18, "neither": [50, 69, 70], "nest": 51, "network": [61, 86], "never": [29, 32, 36, 38, 39, 40, 51, 54, 57, 63, 65, 84], "new": [2, 3, 4, 5, 6, 7, 8, 11, 12, 13, 17, 18, 20, 21, 22, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 54, 55, 56, 58, 59, 61, 62, 63, 64, 65, 69, 71, 72, 73, 74, 84, 85, 86, 87, 89], "new_height": 26, "new_lay": 50, "new_mask": 35, "new_width": 26, "newarrai": 42, "newbi": 15, "newcom": 84, "newer": [23, 40], "newest": 68, "newli": [20, 35], "newlin": 28, "newpo": [58, 66, 87, 88, 89], "newrect": 64, "newtonian": 63, "next": [15, 18, 27, 29, 30, 35, 36, 38, 41, 46, 58, 64, 68, 73, 84, 85, 88, 89], "nice": [31, 58, 61, 62, 65, 84, 87], "nirav": 57, "node": 44, "noevent": [25, 27, 38, 40, 84], "nofram": 23, "nois": [32, 35, 57], "nomin": 29, "non": [17, 19, 23, 24, 26, 29, 31, 33, 41, 42, 44, 50, 51, 56, 58, 64, 84, 86], "none": [17, 18, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 54, 56, 58, 60, 64, 65, 66, 85, 86, 87, 89], "nonesound": [58, 66], "nonetheless": 26, "nonetyp": [30, 35, 50], "nonlinear": 51, "nonzero": [35, 45], "nor": [50, 70], "normal": [8, 11, 19, 20, 25, 28, 29, 35, 36, 44, 45, 50, 51, 53, 55, 58, 64, 65, 71, 87, 89], "normalize_ip": 36, "north": 22, "northeast": 22, "northwest": 22, "nosubprocess": 53, "notabl": [23, 40, 87], "notat": 39, "notdef": 29, "note": [18, 19, 20, 23, 24, 25, 26, 27, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 42, 44, 45, 47, 51, 54, 56, 57, 58, 59, 60, 62, 64, 66, 84, 86, 87, 89], "note1": 35, "note2": 35, "note_off": 37, "note_on": 37, "noteworthi": 63, "noth": [19, 23, 24, 30, 32, 50, 58, 59, 63, 64, 84, 85, 86], "notic": [18, 36, 45, 62, 68, 69, 70, 72, 84, 87, 88, 89], "notifi": 64, "notimplementederror": [31, 40], "novel": 74, "now": [23, 24, 26, 27, 28, 29, 32, 33, 35, 36, 37, 38, 43, 44, 46, 56, 57, 58, 61, 62, 63, 64, 65, 67, 68, 69, 70, 71, 72, 73, 74, 84, 85, 87, 89], "nowadai": [63, 84], "nrp": 57, "nuanc": 84, "null": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 14, 28], "num": [33, 72, 73, 80, 81], "num_button": 39, "num_devic": 37, "num_ev": 37, "num_fing": 25, "num_threshold_pixel": 56, "num_track": 19, "number": [1, 7, 10, 17, 18, 19, 20, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 40, 42, 44, 47, 49, 50, 51, 52, 53, 54, 55, 56, 62, 63, 64, 65, 69, 73, 74, 84], "numbit": 35, "numer": [36, 65], "numev": [25, 38], "numfail": 44, "numlock": 33, "numpass": 44, "numpi": [1, 15, 26, 31, 38, 42, 43, 49, 51, 52, 63], "o": [6, 9, 18, 22, 23, 25, 26, 31, 32, 33, 37, 44, 45, 46, 58, 62, 66, 84, 86, 89], "obj": [1, 2, 3, 4, 7, 8, 9, 44, 45], "obj_list": 45, "object": [1, 2, 3, 4, 5, 6, 8, 9, 11, 12, 15, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 35, 38, 39, 40, 43, 44, 46, 47, 48, 49, 52, 54, 56, 57, 59, 61, 62, 63, 64, 65, 66, 68, 69, 70, 84, 86, 89], "objectwithcallablerectattribut": 45, "objectwithrectattribut": 45, "objectwithsomrectattribut": 45, "obliqu": 29, "obscur": [61, 84], "obsolet": [23, 44, 51], "obtain": [29, 37, 51], "obviou": 61, "obvious": [64, 85], "occasion": 64, "occupi": 85, "occur": [25, 29, 33, 37, 38, 42, 62, 68], "octob": 63, "odd": [24, 65, 89], "ofcod": 89, "off": [18, 24, 25, 26, 29, 32, 37, 38, 40, 45, 56, 58, 61, 62, 64, 84, 89], "offcourt": 89, "offer": [22, 23, 25, 47, 57], "offici": [62, 84], "offset": [17, 24, 26, 28, 29, 30, 35, 37, 40, 42, 45, 50, 51, 58], "often": [19, 31, 36, 51, 61, 63, 65, 69, 84, 86], "ogg": [38, 40], "oh": 89, "ok": [65, 84, 85, 87], "okai": [69, 72], "old": [23, 39, 44, 50, 51, 54, 58, 62, 64, 74, 84, 88], "older": [23, 25, 27, 32, 40, 44, 59, 64, 84], "oldest": 68, "oldlac": 21, "oliv": 21, "olivedrab": 21, "olivedrab1": 21, "olivedrab2": 21, "olivedrab3": 21, "olivedrab4": 21, "omit": [29, 37, 42, 53], "onc": [15, 18, 19, 23, 25, 28, 29, 31, 32, 33, 35, 37, 38, 40, 42, 44, 47, 51, 53, 54, 58, 60, 62, 63, 64, 65, 84, 85, 86, 87, 89], "one": [15, 17, 18, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 38, 39, 40, 42, 43, 44, 45, 46, 47, 49, 50, 51, 52, 54, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 67, 68, 69, 70, 71, 73, 84, 85, 86, 87, 88, 89], "ones": [29, 40, 51, 60, 64, 87, 88], "onli": [17, 18, 19, 20, 23, 24, 25, 28, 29, 31, 32, 34, 35, 36, 37, 38, 39, 40, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 67, 68, 72, 73, 74, 84, 85, 86, 87, 89], "onlin": 84, "ons": 63, "onscreen": 23, "onto": [11, 20, 27, 28, 29, 30, 35, 36, 50, 51, 58, 62, 63, 65, 68, 84, 85, 87], "opac": [48, 84], "opaqu": [20, 26, 29, 35, 43, 48, 51, 52, 65, 84], "open": [1, 6, 9, 15, 18, 19, 23, 32, 33, 37, 44, 46, 47, 57, 58, 63, 85, 86], "opencv": [18, 44, 57], "opengl": [23, 26], "opentyp": 29, "oper": [14, 20, 22, 23, 24, 25, 27, 33, 36, 42, 44, 45, 48, 50, 51, 52, 56, 64, 65, 84, 85], "operand": 65, "oppos": 29, "opposit": 25, "optim": [23, 26, 28, 51, 56, 64, 65, 84], "optimis": 84, "option": [1, 17, 18, 20, 23, 24, 26, 28, 29, 30, 32, 35, 37, 38, 39, 40, 43, 44, 50, 51, 53, 54, 56, 57, 58, 60, 62, 65], "orang": 21, "orange1": 21, "orange2": 21, "orange3": 21, "orange4": 21, "orangered1": 21, "orangered2": 21, "orangered3": 21, "orangered4": 21, "orchid": 21, "orchid1": 21, "orchid2": 21, "orchid3": 21, "orchid4": 21, "order": [1, 18, 23, 28, 29, 33, 37, 38, 40, 42, 44, 50, 51, 53, 54, 58, 62, 65, 68, 84, 89], "orderedupd": 50, "ordinari": 64, "org": [39, 58, 59, 60, 62, 63, 64, 65, 70, 78, 86, 89], "organ": [15, 50, 64, 84], "organis": 61, "organiz": 84, "orient": [29, 35, 62], "origin": [20, 22, 23, 24, 26, 29, 31, 32, 33, 35, 42, 45, 47, 48, 50, 51, 56, 58, 62, 63, 64, 65, 66], "original_color": 56, "original_dest_color": 56, "orthogon": 35, "oss": 37, "osx": [23, 63], "other": [0, 15, 18, 19, 20, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 38, 40, 42, 43, 44, 45, 46, 48, 49, 50, 51, 52, 53, 54, 56, 57, 58, 61, 62, 63, 64, 68, 70, 71, 84, 85, 86, 87, 88, 89], "otherarrai": 42, "othermask": 35, "othersurfac": 35, "otherwis": [1, 2, 5, 9, 12, 17, 18, 22, 23, 24, 25, 26, 28, 29, 31, 35, 36, 37, 38, 39, 43, 45, 46, 50, 51, 52, 56, 62, 72, 73, 89], "ouput": 76, "our": [58, 62, 63, 65, 66, 74, 85], "out": [15, 18, 24, 29, 32, 35, 36, 37, 38, 40, 44, 57, 58, 59, 61, 62, 64, 65, 84, 85, 86, 87, 88, 89], "outdat": 67, "outer": 72, "outgo": 37, "outlin": [24, 29, 35, 57], "outpng": 26, "output": [18, 25, 26, 28, 32, 35, 56, 67, 69, 70, 73, 74, 84, 88], "outputimag": 26, "outsid": [24, 28, 30, 33, 35, 36, 39, 45, 51, 56, 58, 62, 63, 68], "over": [22, 23, 25, 29, 31, 33, 35, 36, 38, 40, 42, 44, 47, 50, 57, 60, 62, 63, 64, 65, 66, 84, 86], "overal": 65, "overboard": 86, "overcom": 67, "overflow": 65, "overhead": [51, 64], "overlai": 64, "overlap": [35, 45, 50, 62, 64, 84, 87, 89], "overlap_area": 35, "overlap_mask": 35, "overlin": 29, "overrid": [18, 29, 35, 44, 50, 51, 63, 84], "overridden": [23, 29, 35, 38, 45], "overshoot": 36, "overwrit": [17, 24, 26, 32, 47], "overwritten": [24, 32, 47, 51], "own": [12, 16, 22, 25, 26, 27, 37, 38, 46, 48, 59, 61, 63, 65, 84, 86], "own_data_typ": 46, "owner": [11, 12], "ownership": 46, "p": [26, 31, 32, 33, 43, 62], "p1": 48, "p2": 48, "pac": 64, "pack": [23, 51, 52, 59], "packag": [15, 26, 28, 29, 30, 31, 49, 52, 58, 60, 63, 65], "pacman": 64, "pad": [29, 32, 56], "page": [33, 39, 46, 65], "pai": 70, "painless": 86, "paint": [50, 85], "pair": [12, 23, 24, 28, 29, 31, 32, 45, 51], "pajitnov": 74, "palegoldenrod": 21, "palegreen": 21, "palegreen1": 21, "palegreen2": 21, "palegreen3": 21, "palegreen4": 21, "palett": [23, 28, 31, 35, 51, 52, 56], "palette_color": [35, 56], "paleturquois": 21, "paleturquoise1": 21, "paleturquoise2": 21, "paleturquoise3": 21, "paleturquoise4": 21, "palevioletr": 21, "palevioletred1": 21, "palevioletred2": 21, "palevioletred3": 21, "palevioletred4": 21, "papayawhip": 21, "paper": 84, "paradigm": 84, "param": 24, "paramet": [18, 20, 23, 24, 25, 26, 29, 30, 31, 33, 35, 36, 37, 38, 39, 40, 44, 45, 46, 51, 55, 56, 57, 70, 71], "parametr": 36, "parent": [2, 12, 17, 48, 50, 51], "parenthesi": 33, "pars": [84, 87], "part": [23, 24, 25, 29, 30, 35, 51, 53, 56, 62, 63, 64, 65, 68, 69, 70, 72, 86], "parti": [18, 63], "partial": [23, 24, 37, 51, 84], "particular": [18, 29, 40, 42, 49, 50, 53, 54, 59, 84], "particularli": 37, "pass": [8, 9, 14, 17, 18, 19, 20, 22, 23, 24, 25, 26, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 44, 46, 50, 51, 53, 54, 56, 58, 59, 62, 63, 64, 66, 84, 86], "past": [24, 36, 46, 58, 63, 84], "patch": [13, 26, 28, 31, 38, 44, 63], "patel": 57, "path": [6, 9, 15, 25, 26, 28, 29, 31, 36, 38, 44, 53, 57, 58, 66, 84, 86, 89], "pathlib": [28, 29, 31, 38], "pathlib_path": 38, "pathnam": [38, 58, 86], "pattern": [29, 40], "paus": [19, 26, 33, 38, 40, 54, 86], "pbm": [31, 46], "pc": [17, 37], "pcf": 29, "pci": 65, "pcx": 31, "peachpuff": 21, "peachpuff1": 21, "peachpuff2": 21, "peachpuff3": 21, "peachpuff4": 21, "peek": 25, "pellet": 64, "penalti": [51, 59, 64], "pend": 37, "peopl": [15, 31, 58, 61, 62, 63], "per": [15, 24, 25, 29, 30, 31, 32, 35, 49, 50, 51, 52, 53, 54, 58, 59, 62, 63, 65, 69, 77, 84, 88, 89], "percentag": 36, "perfect": 35, "perform": [11, 23, 25, 26, 28, 29, 30, 35, 36, 38, 42, 50, 51, 52, 56, 57, 59, 64, 65, 84, 85, 88], "perhap": [62, 64, 84, 86], "period": [33, 40, 84], "permiss": 23, "permit": [14, 18, 29], "person": [62, 63, 88], "perspect": [26, 63], "peru": 21, "pete": [58, 59, 60, 62, 63, 64, 65, 84], "pfr": 29, "pg": [22, 58, 66], "pg_buffer": [1, 2], "pg_encodefilepath": 9, "pg_encodestr": 9, "pg_floatfromobj": 1, "pg_floatfromobjindex": 1, "pg_getdefaultwindow": 1, "pg_getdefaultwindowsurfac": 1, "pg_intfromobj": 1, "pg_intfromobjindex": 1, "pg_major_vers": 13, "pg_minor_vers": 13, "pg_mod_autoinit": 1, "pg_mod_autoquit": 1, "pg_patch_vers": 13, "pg_registerquit": 1, "pg_rgbafromobj": [1, 10], "pg_setdefaultwindow": 1, "pg_setdefaultwindowsurfac": 1, "pg_twofloatsfromobj": 1, "pg_twointsfromobj": 1, "pg_uintfromobj": 1, "pg_uintfromobjindex": 1, "pg_version_atleast": 13, "pg_versionnum": 13, "pg_view_p": 1, "pgbuffer_asarrayinterfac": 1, "pgbuffer_asarraystruct": 1, "pgbuffer_releas": 1, "pgbufproxy_check": 2, "pgbufproxy_getpar": 2, "pgbufproxy_new": 2, "pgbufproxy_trip": 2, "pgbufproxy_typ": 2, "pgchannel_asint": 7, "pgchannel_check": 7, "pgchannel_new": 7, "pgchannel_typ": 7, "pgchannelobject": 7, "pgcolor_check": 3, "pgcolor_new": 3, "pgcolor_newlength": 3, "pgcolor_typ": 3, "pgdict_asbuff": 1, "pgevent_check": 5, "pgevent_filluserev": 5, "pgevent_new": 5, "pgevent_new2": 5, "pgevent_typ": 5, "pgeventobject": 5, "pgexc_buffererror": 1, "pgexc_sdlerror": 1, "pgfont_check": 6, "pgfont_is_al": 6, "pgfont_new": 6, "pgfont_typ": 6, "pgfontobject": 6, "pglifetimelock_check": 12, "pglifetimelock_typ": 12, "pglifetimelockobject": 12, "pgm": 31, "pgobject_getbuff": 1, "pgrect_asrect": 8, "pgrect_check": 8, "pgrect_fromobject": 8, "pgrect_new": 8, "pgrect_new4": 8, "pgrect_norm": 8, "pgrect_typ": 8, "pgrectobject": 8, "pgrwops_fromfileobject": 9, "pgrwops_fromobject": 9, "pgrwops_isfileobject": 9, "pgrwops_releaseobject": 9, "pgsound_aschunk": 7, "pgsound_check": 7, "pgsound_new": 7, "pgsound_typ": 7, "pgsoundobject": 7, "pgsurface_assurfac": 11, "pgsurface_blit": 11, "pgsurface_check": 11, "pgsurface_lock": 12, "pgsurface_lockbi": 12, "pgsurface_locklifetim": 12, "pgsurface_new": 11, "pgsurface_new2": 11, "pgsurface_prep": 12, "pgsurface_typ": 11, "pgsurface_unlock": 12, "pgsurface_unlockbi": 12, "pgsurface_unprep": 12, "pgsurfaceobject": [1, 11, 12], "pgvidinfo_asvidinfo": 4, "pgvidinfo_check": 4, "pgvidinfo_new": 4, "pgvidinfo_typ": 4, "pgvidinfoobject": 4, "phase": [69, 70], "phi": 36, "photo": 44, "photograph": 56, "photoshop": 16, "physic": [15, 17, 23, 25, 32, 61, 63, 86, 88, 89], "pi": [24, 89], "pick": [23, 44, 56, 59, 62, 64], "pictur": [31, 63], "pie": 30, "piec": [29, 84], "pil": 31, "pile": 26, "pinch": 25, "pink": 21, "pink1": 21, "pink2": 21, "pink3": 21, "pink4": 21, "pip": 15, "pip3": 15, "pipe": 23, "pitch": [37, 51, 62], "pitch_bend": 37, "pixel": [15, 17, 18, 20, 22, 23, 24, 26, 28, 29, 30, 31, 35, 41, 45, 48, 51, 56, 58, 59, 63, 65, 85, 88, 89], "pixel2d": 65, "pixel3d": 65, "pixel_arrai": 42, "pixelarrai": [15, 26, 42, 51], "pixelcopi": [26, 42, 43, 52], "pixelformat": 18, "pixels2d": [52, 65], "pixels3d": [52, 65], "pixels_alpha": [52, 65], "pixels_blu": 52, "pixels_green": 52, "pixels_r": 52, "pixels_within_threshold": 56, "place": [1, 23, 25, 27, 29, 34, 36, 37, 39, 42, 44, 45, 46, 50, 51, 52, 53, 58, 62, 63, 64, 65, 68, 84, 87, 88], "placehold": 44, "placement": 44, "plai": [7, 15, 19, 23, 26, 32, 36, 37, 40, 47, 58, 62, 63, 64, 66, 70, 74, 84, 86], "plain": 46, "plan": [51, 63], "plane": [41, 51], "plant": 65, "plateau": 84, "platform": [15, 18, 23, 24, 25, 30, 33, 35, 37, 38, 41, 44, 46, 51, 53, 54, 57, 58, 59, 63, 84, 86, 88], "playabl": 49, "playback": [19, 26, 38, 40, 63], "player": [26, 50, 58, 61, 62, 64, 68, 70, 73, 74, 84, 88, 89], "player1": [61, 89], "player2": 89, "player_po": 15, "playerimag": 62, "playerpo": 62, "playersprit": 89, "playmu": 26, "play\ub77c\ub294": 78, "play\ud55c\ub2e4": 78, "pleas": [16, 23, 28, 33, 36, 44, 45, 51, 56, 84], "plenti": [61, 84], "plot": 61, "plu": [28, 29, 33, 37, 44, 64], "plug": [25, 32], "plum": 21, "plum1": 21, "plum2": 21, "plum3": 21, "plum4": 21, "pm_recommended_input_devic": 37, "pm_recommended_output_devic": 37, "pmdeviceid": 37, "png": [16, 26, 31, 58, 63, 65, 66, 75, 76, 77, 78, 84, 86, 87, 88, 89], "pnm": 31, "po": [25, 27, 35, 40, 50, 58, 62, 66, 72, 73, 80, 81], "point": [14, 17, 19, 20, 22, 24, 26, 29, 30, 35, 36, 37, 45, 48, 50, 56, 57, 62, 63, 64, 65, 67, 72, 84, 89], "pointer": [8, 9, 11, 58], "polar": 36, "polish": [22, 63], "poll": [15, 25, 27, 37, 84], "polygon": [24, 30], "pong": [61, 86, 89], "poor": 61, "poorli": [61, 84], "pop": 44, "popul": 9, "popular": [26, 32, 66], "port": [18, 26, 37, 44, 48], "portabl": [33, 37, 63], "portion": [11, 23, 45, 48, 51, 56, 63, 64, 84], "portmidi": 37, "posit": [1, 8, 17, 19, 22, 23, 24, 25, 26, 28, 29, 30, 32, 33, 35, 38, 39, 40, 44, 45, 48, 50, 51, 53, 55, 57, 58, 62, 63, 64, 66, 68, 69, 84, 85, 87, 88, 89], "possibl": [18, 23, 25, 28, 29, 31, 32, 36, 44, 50, 51, 57, 58, 63, 65, 67, 68], "possibli": 61, "post": [25, 27, 38, 47, 54], "pos\ub294": 80, "potenti": [31, 64, 84, 88], "powderblu": 21, "power": [18, 32, 33, 38, 64, 74, 84], "power_level": 32, "ppem": 29, "ppm": [31, 46], "pr": 39, "practic": [84, 86], "pre": [20, 29, 51], "pre_init": 38, "prealloc": 51, "prebuilt": 15, "preced": [35, 68], "precis": [23, 38, 51, 65, 84], "precise_i": 25, "precise_x": 25, "precisei": 25, "precisex": 25, "predecessor": 84, "predefin": [25, 46], "predomin": 43, "prefer": [23, 25, 30, 31, 33], "prefix": 58, "prematur": 84, "premul_alpha": [20, 51], "prepar": [26, 40, 66], "present": [44, 48, 50, 60, 62, 63, 64, 84], "preserv": [20, 44, 45, 51], "preset": [22, 38], "press": [25, 26, 32, 33, 39, 47, 57, 58, 62, 70, 71, 84], "pressur": 55, "pretend": 62, "pretti": [59, 62, 64, 65, 84, 85, 88, 89], "prettier": 33, "prevar": 84, "prevent": [25, 84, 89], "prevent_display_stretch": 23, "previou": [1, 23, 29, 38, 39, 48, 50, 54, 56, 58, 62, 64, 65, 69, 70, 72, 73, 84, 85, 89], "previous": [18, 20, 25, 28, 29, 31, 38, 40, 44, 59, 62, 85], "primari": 39, "primarili": [25, 29, 44, 48], "prime": 48, "primer": 65, "primit": 30, "principl": [88, 89], "print": [25, 28, 32, 33, 36, 39, 44, 45, 46, 57, 58, 59, 62, 66, 68, 70, 71, 72, 73, 76, 84, 86, 89], "printboard": [73, 81], "printf": [67, 75], "print\ud568\uc218\ub098": 76, "prior": [23, 59], "prioriti": 18, "privat": [51, 58], "probabl": [26, 36, 62, 64, 68, 84, 85], "problem": [28, 43, 44, 58, 61, 69, 84, 86], "proce": 84, "procedur": [67, 68], "process": [18, 25, 26, 27, 32, 46, 52, 53, 54, 60, 62, 67, 68, 70, 72, 73, 77, 84], "processor": [54, 56], "procur": 18, "produc": [29, 51, 84], "product": [36, 61], "profil": [23, 25, 84], "profit": 18, "program": [15, 19, 23, 25, 27, 32, 33, 37, 38, 41, 44, 45, 53, 54, 58, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 73, 74, 84, 85, 86, 87, 88], "programm": [63, 64, 84, 86, 87], "programmat": 44, "progress": 43, "project": [16, 26, 36, 61, 63, 67, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 84, 86, 87, 89], "prolif": 84, "prolog": 73, "promis": [58, 62], "prompt": [44, 63, 65], "proper": [29, 33, 38, 39, 64, 65], "properli": [9, 15, 25, 39, 53, 58, 62, 64, 65, 84], "properti": [17, 25, 29, 39, 50, 52], "propos": 63, "protect": [26, 58], "protocol": [2, 15, 31, 43, 51], "proud": 62, "provid": [15, 18, 20, 23, 26, 27, 28, 29, 33, 35, 36, 38, 41, 42, 44, 45, 50, 51, 53, 54, 56, 57, 58, 67, 86, 87], "proxi": [2, 17], "ps4": 32, "pseudo": 87, "pt": 56, "public": [26, 86, 89], "pull": [18, 58, 66], "pummel": [58, 66], "pump": [25, 27, 32, 88, 89], "punch": [58, 63, 66], "punch_sound": [58, 66], "punchabl": 58, "punctuat": 28, "pure": [44, 51], "purpl": [15, 21, 84], "purple1": 21, "purple2": 21, "purple3": 21, "purple4": 21, "purpos": [1, 18, 48, 57, 61], "push": [33, 71, 88], "pushabl": 32, "put": [15, 16, 32, 46, 54, 60, 61, 63, 64, 66, 68, 85, 86, 87], "puyopuyo": [67, 75], "pxarrai": 42, "py": [15, 23, 26, 44, 46, 53, 56, 61, 62, 65], "py_buff": [1, 17], "pybuf": 1, "pybuffer_releaseproc": 1, "pycdio": 19, "pygam": [10, 14, 21, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 86, 87, 89], "pygame2": 25, "pygame_blend_add": 11, "pygame_blend_alpha_sdl2": [11, 44], "pygame_blend_max": 11, "pygame_blend_min": 11, "pygame_blend_mult": 11, "pygame_blend_premultipli": 11, "pygame_blend_rgba_add": 11, "pygame_blend_rgba_max": 11, "pygame_blend_rgba_min": 11, "pygame_blend_rgba_mult": 11, "pygame_blend_rgba_sub": 11, "pygame_blend_sub": 11, "pygame_bufferproxi": 2, "pygame_camera": 44, "pygame_displai": 44, "pygame_force_scal": 44, "pygame_freetyp": [6, 28, 44], "pygame_hide_support_prompt": 44, "pygame_lofi": 16, "pygame_logo": 16, "pygame_mix": 7, "pygame_pow": 16, "pygame_powered_lowr": 16, "pygame_tini": 16, "pygameapi_base_numslot": 10, "pygamevers": 44, "pyobject": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12], "pyopengl": [26, 31, 63], "pypi": 42, "pyportmidi": 37, "pysdl": [63, 84], "pythagorean": [36, 69], "python": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 14, 15, 17, 18, 19, 22, 26, 28, 29, 31, 38, 43, 44, 45, 50, 51, 53, 58, 60, 61, 62, 64, 65, 66, 67, 68, 85, 86, 87], "python2": 26, "python26": 26, "python3": 18, "pytypeobject": [2, 3, 4, 7, 8, 11, 12], "pyunicode_asencodedstr": [9, 44], "pyzin": 63, "q": 33, "qce": 18, "quadrant": 24, "quadruplet": [24, 30], "quake3": 63, "qualiti": [26, 44, 58, 63], "quaternion": 67, "queri": [23, 37, 46, 59], "query_imag": [18, 57], "question": [15, 33, 62, 84], "queu": [25, 38, 40], "queue": [5, 18, 23, 32, 33, 34, 37, 38, 39, 40, 47, 54, 58, 63, 84, 88], "quick": [25, 26, 32, 51, 53, 60, 64, 65, 88], "quicker": [50, 51, 56, 64], "quickest": 51, "quickli": [31, 58, 59, 62, 63, 64, 65], "quietli": 25, "quit": [1, 15, 19, 22, 23, 24, 25, 26, 28, 29, 32, 37, 38, 39, 44, 47, 51, 53, 57, 58, 62, 63, 65, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 88, 89], "quit\uac19\uc740": 76, "quit\ub77c\ub294": 76, "quiz": 73, "quot": 33, "quotedbl": 33, "r": [8, 20, 24, 26, 30, 32, 33, 36, 42, 43, 45, 51, 56, 64, 65, 71, 72, 73, 79, 80, 81], "r_margin": [72, 73, 80, 81], "radial": [36, 65], "radian": [24, 30, 36, 87, 89], "radii": [24, 30], "radiu": [24, 30, 50], "radom": 74, "rais": [1, 2, 3, 4, 5, 6, 7, 8, 9, 14, 17, 20, 22, 23, 24, 25, 26, 28, 29, 30, 31, 33, 35, 36, 37, 38, 40, 43, 44, 45, 46, 48, 49, 50, 51, 52, 56, 57, 59, 60, 65, 84, 86, 89], "ramp": 23, "ran": 85, "rand": 89, "randint": [73, 81, 89], "random": [53, 61, 73, 74, 81, 86, 89], "randomli": 73, "rang": [20, 23, 24, 25, 28, 29, 32, 33, 35, 36, 37, 38, 42, 44, 47, 50, 57, 62, 63, 65, 68, 71, 72, 73, 79, 80, 81], "rank": 84, "rapid": 32, "rapidli": [33, 62], "rare": [36, 44, 51, 84], "rate": [38, 40, 50, 69, 84], "rather": [24, 28, 29, 30, 33, 44, 50, 54, 56, 69, 85, 87], "ratio": [45, 50], "raw": [17, 31, 42, 43, 51, 52, 65], "rb": 46, "re": [22, 26, 29, 36, 44, 56, 59, 61, 62, 64, 71, 84, 85, 87, 88], "reach": [63, 84], "read": [9, 17, 20, 25, 26, 29, 37, 39, 46, 48, 50, 51, 61, 62, 65, 84], "readabl": [20, 38, 68, 86], "readi": [18, 22, 32, 48, 53, 57, 58, 62, 63], "readlin": 22, "readm": 15, "readonli": 50, "real": [25, 28, 29, 37, 38, 51, 57, 59, 62, 64, 70, 84], "realist": [86, 89], "realiti": [59, 84], "realiz": [63, 84], "realli": [23, 41, 56, 58, 59, 62, 63, 64, 65, 70, 85, 87, 88], "realtim": [51, 63, 65], "reason": [23, 27, 28, 29, 38, 39, 51, 56, 57, 61, 62, 64, 84, 87], "rebel": 63, "rebind": 47, "recalcul": 29, "recap": 61, "receiv": [23, 27, 32, 33, 39, 47, 84], "recent": [58, 63, 64, 65], "recogn": [17, 25, 29, 32, 43, 45, 56], "recogniz": 31, "recommend": [25, 27, 28, 31, 50, 51, 62, 84], "recommended_input_devic": 37, "recommended_output_devic": 37, "recompil": 89, "reconstruct": 51, "record": [18, 29, 52, 53, 72, 84], "recreat": [26, 50, 53], "rect": [0, 15, 24, 29, 30, 33, 35, 41, 45, 48, 50, 51, 56, 57, 58, 62, 63, 64, 66, 71, 72, 73, 79, 80, 81, 86, 87, 88, 89], "rect1": 45, "rect2": 45, "rect_area_pt": 56, "rect_list": [45, 50], "rect_sequ": 45, "rectangl": [8, 15, 23, 24, 26, 28, 29, 30, 33, 45, 48, 50, 51, 56, 64, 68, 84, 85, 87, 89], "rectangle_list": 23, "rectangular": [8, 29, 30, 35, 42, 48, 50, 51, 62, 63, 71, 84], "rectstyl": 84, "red": [1, 15, 18, 20, 21, 23, 24, 31, 42, 50, 51, 52, 56, 65, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 85], "red1": 21, "red2": 21, "red3": 21, "red4": 21, "redimg": 65, "redistribut": 18, "redraw": [41, 62], "redrawn": [23, 41], "reduc": [29, 38, 51, 64, 88], "reentrant": 53, "ref": [70, 78], "refcount": 9, "refer": [1, 12, 17, 23, 24, 31, 33, 35, 42, 46, 47, 49, 50, 51, 52, 57, 58, 59, 62, 63, 64, 65, 68, 69, 70, 71, 72, 73, 84, 88], "referenc": [50, 52, 58, 64, 65], "reflect": 36, "reflect_ip": 36, "refresh": 84, "regard": [24, 68], "regardless": [28, 44], "region": [31, 51, 56, 84, 86], "regist": [1, 44, 46, 87], "register_quit": 44, "registri": 37, "regular": [15, 23, 40, 41, 50, 51, 56, 64], "regularli": 32, "reinit": [88, 89], "reiniti": 38, "reinitialis": 32, "rel": [25, 32, 37, 39, 40, 41, 48, 50, 61, 86], "relat": [1, 23, 25, 29, 34, 39, 43, 47, 50, 84], "relationship": 50, "relative_mous": 48, "releas": [1, 12, 17, 18, 23, 25, 29, 30, 32, 33, 37, 39, 42, 44, 46, 51, 58, 63, 84, 86, 88, 89], "release_buff": 1, "relev": [29, 84], "reli": [8, 33, 88], "reliabl": [18, 23, 37], "remain": [20, 40, 45, 51, 52, 85], "remap": [42, 47], "rememb": [25, 39, 50, 51, 59, 61, 63, 64, 65, 68, 73, 84, 86, 87], "remind": 68, "remov": [12, 17, 18, 25, 27, 28, 32, 36, 44, 48, 50, 56, 58, 62, 64, 89], "remove_intern": 64, "remove_sprites_of_lay": 50, "renam": 47, "render": [15, 23, 24, 26, 32, 41, 48, 50, 58, 63, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 84, 85, 87, 88], "render_device_reset": 25, "render_raw": 29, "render_raw_to": 29, "render_targets_reset": 25, "render_to": 29, "renderclear": [50, 64], "renderplain": [50, 58, 64, 66, 89], "renderupd": [26, 50, 64, 84], "renderupdatesdraw": 64, "repaint": [25, 27, 50], "repaint_rect": 50, "repcolor": 42, "repeat": [23, 33, 35, 38, 40, 44, 61, 62], "repeatedli": [50, 51, 54, 56, 58, 84], "replac": [1, 23, 27, 29, 38, 42, 43, 44, 51, 52, 54, 59, 62, 65, 68], "report": [26, 32, 44, 56, 84], "repositori": [44, 84], "repr": 44, "repres": [1, 11, 12, 13, 15, 17, 19, 20, 22, 23, 24, 25, 29, 31, 32, 33, 35, 36, 38, 39, 40, 41, 44, 45, 47, 48, 52, 54, 56, 58, 62, 63, 64, 65, 84, 87], "represent": [1, 3, 8, 15, 21, 24, 30, 42, 56, 58], "reproduc": 18, "request": [1, 23, 26, 28, 29, 35, 38, 49, 51, 52, 59], "requir": [17, 18, 23, 25, 26, 28, 33, 35, 36, 37, 38, 44, 45, 46, 47, 50, 51, 55, 56, 59, 61, 62, 63, 64, 65, 68, 70, 84, 85, 86, 88], "resampl": 38, "rescal": 26, "resembl": [26, 43, 52], "reserv": [25, 37, 38], "reset": [29, 32, 37, 38, 40, 50, 58, 89], "resist": 84, "resiz": [15, 23, 25, 26, 35, 45, 48, 56, 58, 85], "resolut": [15, 16, 23, 29, 41, 51, 54, 56, 58, 59, 63], "resolv": [46, 68, 87], "resourc": [26, 38, 40, 44, 59, 61, 66, 84, 87], "respect": [1, 22, 23, 24, 33, 35, 36, 46, 50, 51, 59], "respond": [25, 27, 62, 84], "respons": [9, 53], "rest": [19, 25, 27, 57, 58, 62, 63, 65, 84], "restart": [40, 86], "restor": [23, 25, 33, 48], "restrict": [28, 51], "result": [20, 24, 28, 29, 35, 36, 37, 40, 42, 45, 51, 53, 56, 58, 62, 63, 64, 65, 68, 69, 70, 73, 76, 84, 89], "resultscreen": [77, 78], "resum": [19, 38, 40], "retail": 63, "retain": [18, 36, 51], "retrac": 23, "retriev": [13, 36, 38, 46, 84, 88], "return": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 17, 18, 19, 20, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 62, 63, 64, 65, 66, 68, 71, 72, 73, 79, 80, 81, 84, 85, 86, 87, 88, 89], "reus": [18, 86], "reusabl": 86, "rev": 44, "revamp": 62, "revers": [1, 51, 58, 63, 65, 89], "revis": [44, 61, 63], "reward": [58, 63], "rewind": 40, "rewound": 26, "rewrit": 84, "rgb": [18, 20, 23, 24, 28, 30, 31, 41, 43, 51, 57, 58, 63, 65, 84, 85], "rgba": [1, 3, 20, 23, 24, 30, 31, 51], "rgba_premult": 31, "rgbarrai": 65, "rgbx": 31, "rich": 58, "rid": 57, "ridicul": 61, "right": [20, 23, 24, 25, 29, 30, 33, 35, 38, 42, 44, 45, 47, 50, 51, 58, 62, 63, 64, 65, 66, 67, 68, 69, 75, 76, 77, 78, 79, 80, 81, 84, 87, 88, 89], "rins": 62, "rle": 51, "rleaccel": [51, 58, 66], "rleaccelok": 51, "road": 62, "roll": [32, 39, 64], "root": [36, 53, 84], "rosybrown": 21, "rosybrown1": 21, "rosybrown2": 21, "rosybrown3": 21, "rosybrown4": 21, "rotat": [25, 26, 29, 36, 48, 50, 56, 58, 63, 66], "rotate_i": 36, "rotate_ip": 36, "rotate_ip_rad": 36, "rotate_rad": 36, "rotate_rad_ip": 36, "rotate_x": 36, "rotate_x_ip": 36, "rotate_x_ip_rad": 36, "rotate_x_rad": 36, "rotate_x_rad_ip": 36, "rotate_y_ip": 36, "rotate_y_ip_rad": 36, "rotate_y_rad": 36, "rotate_y_rad_ip": 36, "rotate_z": 36, "rotate_z_ip": 36, "rotate_z_ip_rad": 36, "rotate_z_rad": 36, "rotate_z_rad_ip": 36, "rotozoom": 56, "rough": 84, "round": [20, 24, 36, 37, 38, 88], "routin": [1, 18, 25, 28, 29, 51, 56, 58, 59, 68, 84], "row": [35, 42, 51, 65], "row1": 65, "row2": 65, "royalblu": 21, "royalblue1": 21, "royalblue2": 21, "royalblue3": 21, "royalblue4": 21, "rr": 20, "rrggbb": 20, "rrggbbaa": 20, "rt": 32, "rudder": 32, "rudimentari": 26, "ruin": 65, "rule": [59, 70, 73, 74, 89], "rumbl": [32, 47], "run": [15, 23, 25, 26, 31, 32, 38, 44, 53, 54, 56, 58, 59, 62, 63, 64, 65, 66, 67, 84, 85, 89], "run_speed_test": 26, "run_test": 53, "run_tests__test": 53, "rundown": 26, "runner": 53, "runtim": [23, 38, 54, 56, 63], "runtimeerror": [29, 44], "rw": 9, "rwobject": 0, "rx": 30, "ry": 30, "r\uac12": 76, "saddlebrown": 21, "safe": [9, 19, 23, 25, 28, 29, 32, 37, 38, 42, 44, 47, 50, 51, 57, 60], "sai": [51, 61, 62, 64, 68, 84], "said": [24, 61, 68, 70, 74, 84, 85], "sake": [84, 85], "salmon": 21, "salmon1": 21, "salmon2": 21, "salmon3": 21, "salmon4": 21, "salt": 84, "sam": 63, "same": [9, 18, 19, 20, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 35, 36, 38, 39, 42, 43, 44, 45, 47, 50, 51, 52, 54, 56, 57, 58, 59, 62, 63, 64, 65, 67, 68, 70, 71, 72, 73, 84, 85, 89], "sampl": [15, 20, 38, 40, 56, 57, 62, 64, 65, 88], "san": 29, "sandybrown": 21, "satisfactori": 86, "satisfi": 23, "satur": 18, "sauf": 35, "save": [15, 18, 31, 61, 63, 84], "save_extend": 31, "saw": [57, 58, 62], "scalabl": 29, "scalar": [36, 45, 56, 58], "scale": [18, 23, 24, 26, 29, 31, 35, 36, 44, 45, 48, 50, 56, 58, 63, 65, 66], "scale2x": 56, "scale_bi": [45, 56], "scale_by_ip": 45, "scale_to_length": 36, "scaledown": 65, "scalei": 45, "scaler": 26, "scaletest": 26, "scaleup": 65, "scalex": 45, "scan": 19, "scancod": [25, 33], "scanf": [67, 75], "scanlin": 62, "scant": 26, "scene": [31, 57], "school": 39, "scope": [42, 65], "score": [26, 50, 61, 70, 89], "scoreboard": 61, "scoreup": 61, "scrap": [15, 46], "scrap_bmp": 46, "scrap_clipboard": [26, 46], "scrap_pbm": 46, "scrap_ppm": 46, "scrap_select": 46, "scrap_text": 46, "scratch": [64, 84], "scratchi": 38, "screen": [1, 4, 15, 22, 24, 25, 26, 28, 31, 32, 33, 34, 39, 44, 45, 46, 48, 50, 51, 57, 58, 59, 61, 63, 64, 65, 66, 68, 69, 70, 71, 75, 76, 77, 78, 79, 80, 81, 84, 85, 87, 88, 89], "screen_dim": 26, "screen_height": 23, "screen_rect": [45, 50], "screen_width": 23, "screensav": [23, 44, 69], "screenshot": 58, "script": [28, 29, 60, 63, 66], "scroll": [25, 26, 39, 51, 62, 63, 64, 84], "scrollabl": 26, "scrollock": 33, "sdl": [1, 5, 7, 9, 11, 12, 23, 25, 26, 27, 32, 38, 41, 43, 44, 47, 48, 56, 59, 63, 84], "sdl1": [19, 23, 41, 51], "sdl2": [25, 38, 39, 44, 47, 51, 55], "sdl3": 23, "sdl_appact": 25, "sdl_appinputfocu": 25, "sdl_appmousefocu": 25, "sdl_audiodriv": 44, "sdl_delai": 54, "sdl_event": 5, "sdl_gfx": 30, "sdl_hint_video_allow_screensav": 23, "sdl_imag": [31, 63], "sdl_joystick_allow_background_ev": [32, 44], "sdl_mixer": [38, 40], "sdl_mousewheel_flip": 25, "sdl_rect": [8, 11], "sdl_rwop": 9, "sdl_surfac": 11, "sdl_ttf": [28, 29, 44], "sdl_video": 51, "sdl_video_allow_screensav": 44, "sdl_video_cent": 44, "sdl_video_window_po": 44, "sdl_video_x11_net_wm_bypass_compositor": 44, "sdl_videodriv": [23, 44], "sdl_videoinfo": 4, "sdl_window": 1, "sdl_windowid": 23, "sdlerror": 40, "sdlversion": 44, "sea": 24, "seagreen": 21, "seagreen1": 21, "seagreen2": 21, "seagreen3": 21, "seagreen4": 21, "search": [15, 28, 29, 35, 45, 50, 56], "search_color": 56, "search_surf": 56, "seashel": 21, "seashell1": 21, "seashell2": 21, "seashell3": 21, "seashell4": 21, "second": [15, 17, 19, 20, 22, 24, 26, 30, 32, 36, 38, 40, 42, 49, 50, 53, 54, 58, 60, 62, 63, 65, 69, 70, 71, 72, 77, 84, 88, 89], "secondari": 84, "section": [15, 19, 51, 58, 61, 62, 64, 65, 67, 68, 86, 89], "secur": 86, "see": [9, 16, 18, 19, 20, 23, 24, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 43, 44, 45, 47, 50, 51, 52, 56, 57, 58, 60, 61, 62, 63, 64, 65, 84, 85, 87, 88, 89], "seed": [53, 65], "seek": 9, "seem": [31, 46, 61, 62, 63, 64, 68, 72, 73, 84, 85, 87], "seemingli": 61, "seen": [23, 61, 62, 65, 88, 89], "segment": [24, 30], "select": [18, 23, 25, 29, 33, 35, 37, 38, 40, 44, 46, 53, 59, 62, 67, 69, 73, 84], "self": [20, 32, 35, 36, 45, 50, 51, 56, 57, 58, 62, 64, 66, 87, 88, 89], "sell": 62, "semi": [26, 84], "semicolon": 33, "semiton": 37, "send": [25, 37, 38, 40, 89], "sens": [33, 62, 84, 87, 88, 89], "sent": [23, 25, 32, 33, 38, 40], "separ": [18, 22, 26, 28, 29, 37, 38, 44, 45, 50, 51, 52, 53, 56, 57, 61, 62, 64, 65, 72, 84, 86], "sequenc": [1, 8, 14, 22, 23, 24, 25, 29, 30, 33, 35, 37, 39, 42, 45, 50, 51, 56, 63, 64, 84, 88], "sequenti": 24, "seri": [37, 63, 70], "serv": [27, 63, 84], "server": [26, 39], "servic": 18, "session": 53, "set": [1, 6, 17, 18, 20, 22, 23, 24, 25, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 54, 56, 58, 60, 62, 63, 65, 67, 68, 70, 71, 72, 73, 84, 85, 86, 87, 88, 89], "set_allow": 25, "set_allow_screensav": 23, "set_alpha": [43, 51], "set_at": [35, 51, 65, 84], "set_behavior": 56, "set_block": [25, 84], "set_bold": 28, "set_capt": [22, 23, 24, 32, 58, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 85, 89], "set_clip": [50, 51], "set_color": 56, "set_colorkei": [43, 51, 58, 66, 84], "set_control": [18, 57], "set_cursor": [22, 39], "set_default_resolut": 29, "set_endev": [38, 40], "set_error": 44, "set_eventst": 47, "set_fullscreen": 48, "set_gamma": 23, "set_gamma_ramp": 23, "set_grab": [25, 33, 39], "set_icon": [23, 48], "set_instru": 37, "set_ital": 28, "set_keyboard_grab": 25, "set_length": 20, "set_loc": 41, "set_map": 47, "set_mask": 51, "set_mod": [1, 15, 22, 23, 24, 32, 33, 34, 39, 44, 46, 48, 51, 57, 58, 59, 62, 63, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 89], "set_modal_for": 48, "set_num_channel": 38, "set_palett": [23, 51], "set_palette_at": 51, "set_po": [39, 40], "set_repeat": 33, "set_reserv": 38, "set_script": 28, "set_shift": 51, "set_smoothscale_backend": 56, "set_strikethrough": 28, "set_text_input_rect": 33, "set_tim": 54, "set_timing_threshold": 50, "set_timing_treshold": 50, "set_underlin": 28, "set_viewport": 48, "set_vis": [39, 58, 66], "set_volum": [38, 40], "set_window": 48, "setcolor": 35, "setsurfac": 35, "settabl": 44, "setup": [15, 22, 26, 84], "sever": [15, 22, 23, 24, 26, 29, 38, 45, 50, 54, 59, 60, 62, 63, 64, 65, 84, 85, 89], "sf": 42, "sfnt": 29, "shade": 24, "shall": 18, "shallow": 35, "shape": [15, 17, 28, 42, 43, 51, 63, 65, 72, 84], "share": [15, 25, 28, 31, 32, 33, 38, 46, 48, 51, 52, 54], "sharp": 24, "she": 85, "shell": 26, "shift": [23, 25, 26, 33, 35, 42, 44, 51, 59, 65], "shinner": [58, 59, 60, 62, 63, 64, 65, 84], "shoot": 63, "short": [25, 63, 65, 84], "shortcut": [25, 64], "shorter": [23, 58, 65], "shortest": 36, "shot": 64, "should": [18, 19, 22, 23, 25, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 42, 44, 45, 47, 50, 51, 54, 56, 58, 59, 61, 62, 63, 64, 65, 68, 69, 84, 85, 86, 87, 89], "shoulder": 47, "shouldn": 88, "show": [15, 22, 23, 26, 29, 33, 39, 41, 48, 53, 56, 57, 58, 59, 62, 65, 84, 88, 89], "show_output": 53, "showcas": [26, 84], "shown": [23, 25, 33, 41, 57, 62, 84, 87], "shrink": [45, 84, 89], "shrinkag": 56, "shrunk": 51, "shut": [23, 29, 32, 44, 69], "shutdown": [7, 63], "side": [23, 24, 42, 45, 47, 58, 61, 63, 87, 88], "sienna": 21, "sienna1": 21, "sienna2": 21, "sienna3": 21, "sienna4": 21, "sign": [17, 33, 37, 38, 39, 44], "signal": [25, 40, 85], "signific": 51, "silenc": 53, "silent": [23, 60], "silver": 21, "simd": 51, "similar": [29, 31, 32, 42, 49, 50, 51, 54, 58, 62, 64, 65, 85, 86, 88, 89], "simpl": [15, 22, 23, 24, 25, 26, 32, 42, 50, 51, 56, 57, 58, 60, 61, 62, 63, 64, 65, 66, 67, 69, 71, 72, 73, 74, 84, 85, 86, 89], "simpler": [62, 63, 64], "simplest": [57, 71], "simpli": [22, 25, 37, 41, 44, 50, 57, 58, 59, 62, 63, 65, 67, 84, 85, 87, 89], "simul": [58, 67], "simultan": [38, 67], "sin": [87, 89], "sinc": [15, 19, 20, 23, 25, 28, 31, 32, 36, 38, 39, 44, 48, 50, 51, 52, 54, 57, 58, 59, 60, 62, 63, 64, 65, 84], "singl": [17, 20, 22, 23, 24, 25, 28, 29, 30, 32, 33, 38, 40, 41, 42, 43, 45, 50, 51, 52, 53, 58, 60, 61, 62, 63, 64, 65, 67, 68, 69, 70, 71, 73, 84, 85], "sit": 84, "site": 26, "situat": [23, 36, 51, 58, 64, 65, 84], "six": [38, 40, 61, 63], "sizabl": 84, "size": [8, 17, 18, 22, 23, 24, 25, 26, 28, 29, 31, 35, 38, 39, 41, 42, 43, 45, 48, 50, 51, 52, 56, 57, 58, 59, 61, 62, 63, 65, 66, 68, 75, 76, 77, 78, 79, 80, 81, 84, 85], "sizeal": 22, "sizenesw": 22, "sizenws": 22, "sizeof": 35, "sizer_x_str": 22, "sizer_xy_str": 22, "sizer_y_str": 22, "skeleton": 84, "skew": 28, "skill": 84, "skip": [23, 35, 38, 58], "skyblu": 21, "skyblue1": 21, "skyblue2": 21, "skyblue3": 21, "skyblue4": 21, "sl": 32, "slash": [22, 33], "slateblu": 21, "slateblue1": 21, "slateblue2": 21, "slateblue3": 21, "slateblue4": 21, "slategrai": 21, "slategray1": 21, "slategray2": 21, "slategray3": 21, "slategray4": 21, "slategrei": 21, "sleep": [25, 54], "slerp": 36, "slice": [36, 42, 43, 65, 84], "slight": [58, 64], "slightli": [15, 20, 25, 26, 36, 39, 40, 51, 54, 58, 64, 84, 85], "slope": 24, "sloppi": 26, "slot": 0, "slow": [23, 48, 51, 57, 59, 62, 65, 84, 85], "slower": [50, 51, 54, 62, 84], "slowest": [44, 51, 85], "small": [18, 22, 23, 28, 29, 32, 36, 39, 44, 45, 58, 62, 63, 65, 71, 72, 84, 85, 87], "smaller": [18, 23, 35, 38, 45, 51, 71, 72, 84], "smallest": [23, 51, 59], "smart": [62, 64], "smooth": [28, 58], "smoother": 62, "smoothli": [56, 62], "smoothscal": [26, 56], "smoothscale_bi": 56, "sn9c101": 18, "snakeviz": 84, "snapshot": 57, "sndarrai": [15, 26, 38, 49, 63], "snow": 21, "snow1": 21, "snow2": 21, "snow3": 21, "snow4": 21, "so": [10, 17, 18, 20, 22, 23, 24, 26, 29, 30, 31, 32, 33, 36, 38, 42, 43, 44, 45, 50, 51, 52, 56, 58, 59, 61, 63, 64, 65, 67, 68, 69, 70, 71, 72, 74, 84, 85, 86, 87, 88, 89], "socket": [86, 89], "soften": 65, "softwar": [15, 18, 23, 30, 37, 41, 50, 51, 58, 63], "solarwolf": 63, "solid": [24, 28, 30, 50, 51, 52, 56, 65, 84], "solut": [84, 85], "solv": [28, 38, 61, 67, 84], "some": [15, 18, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32, 34, 36, 37, 38, 39, 42, 44, 45, 46, 50, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 68, 69, 70, 72, 84, 85, 86, 87, 88, 89], "someimag": 26, "someth": [15, 18, 24, 26, 39, 56, 57, 59, 62, 63, 64, 65, 68, 69, 70, 84, 85], "sometim": [22, 23, 27, 44, 64, 84], "somewhat": [26, 64, 84], "somewher": [64, 68], "soni": 32, "sonix": 18, "soon": [40, 44, 64, 88], "sophist": [86, 87], "sorri": [57, 59], "sort": [23, 25, 26, 27, 50, 58, 59, 62, 64, 84, 89], "sound": [7, 15, 26, 40, 58, 61, 63, 64, 66, 67, 70, 73, 84, 86], "sound_array_demo": 26, "sourc": [15, 18, 26, 31, 37, 38, 42, 43, 48, 50, 51, 56, 58, 61, 62, 63, 64, 67, 68, 69, 70, 84, 86, 89], "source_rect": 50, "sourcecod": [76, 77, 78], "south": 22, "southeast": 22, "southwest": 22, "space": [20, 28, 29, 31, 33, 37, 42, 62, 84], "sparingli": 48, "speak": [85, 86], "speaker": 38, "special": [18, 22, 23, 25, 33, 35, 38, 43, 50, 51, 56, 58, 59, 62, 64, 65, 68, 84, 85], "special_flag": [48, 50, 51], "specif": [23, 25, 28, 29, 33, 35, 36, 38, 43, 46, 50, 51, 52, 57, 58, 59, 62, 64, 65, 68, 70, 71, 72, 84], "specifi": [13, 18, 21, 23, 24, 28, 29, 31, 32, 35, 36, 37, 38, 40, 46, 47, 50, 56, 59, 65, 89], "sped": 24, "speed": [25, 26, 29, 44, 54, 62, 63, 64, 69, 75, 76, 77, 78, 79, 80, 81, 84, 85, 87, 88, 89], "spend": 84, "spent": [63, 74, 84], "spheric": 36, "spill": 24, "spin": [26, 58, 66, 88, 89], "split": [22, 29, 58, 63, 64, 66, 84], "sport": 63, "spot": 84, "spread": 84, "spring": 56, "springgreen": 21, "springgreen1": 21, "springgreen2": 21, "springgreen3": 21, "springgreen4": 21, "sprite": [15, 26, 35, 36, 50, 61, 66, 84, 88, 89], "sprite1": 50, "sprite2": 50, "sprite_dict": 50, "sprite_height": 62, "sprite_list": 50, "sprite_width": 62, "spritecollid": [50, 64, 87], "spritecollideani": 50, "spritedict": 64, "sprites_click": 84, "sqrt": [36, 69], "squar": [24, 32, 36, 72], "squeez": 84, "sr": 32, "src": 65, "src_c": [0, 10, 13], "srcalpha": [35, 43, 51, 56], "srccolorkei": 51, "srcobj": 11, "srcrect": [11, 48], "sse": [26, 56], "stabil": 33, "stabl": 43, "stack": 25, "stage": 57, "stai": [61, 65, 70], "stand": 26, "standard": [1, 22, 25, 27, 41, 43, 44, 46, 50, 57, 58, 59, 61, 63, 64, 65, 68, 84], "star": 26, "starfield": 26, "start": [1, 17, 18, 19, 24, 25, 26, 29, 30, 32, 33, 35, 38, 39, 40, 42, 44, 45, 47, 50, 51, 57, 58, 59, 61, 62, 63, 64, 65, 66, 67, 69, 74, 84, 85, 86, 88, 89], "start_angl": [24, 30], "start_index": 65, "start_po": 24, "start_text_input": 33, "startup": [7, 38], "state": [23, 25, 26, 29, 31, 32, 33, 37, 38, 39, 46, 47, 48, 50, 51, 58, 64, 66, 67, 84, 88, 89], "statement": [68, 69, 70, 71, 72, 84, 89], "statement\uc5d0": 77, "statement\uc5d0\uc11c": 77, "static": [47, 48, 50, 69], "stationari": 64, "statu": [26, 32, 37, 70], "stderr": 53, "stdin": 65, "stdout": 53, "steelblu": 21, "steelblue1": 21, "steelblue2": 21, "steelblue3": 21, "steelblue4": 21, "steep": 24, "stencil": 23, "step": [15, 30, 32, 42, 58, 65, 68, 70, 73, 88], "stereo": [23, 38, 49], "stick": [32, 47, 62, 65, 84], "still": [23, 25, 28, 31, 33, 36, 38, 39, 43, 45, 46, 47, 48, 51, 56, 57, 58, 61, 62, 63, 64, 65, 71, 72, 73, 84, 85, 88, 89], "stop": [1, 18, 19, 24, 30, 32, 33, 38, 39, 40, 44, 47, 54, 57, 62, 64, 84, 88, 89], "stop_angl": [24, 30], "stop_rumbl": [32, 47], "stop_text_input": 33, "store": [8, 22, 23, 25, 29, 30, 35, 50, 51, 52, 58, 62, 64, 68], "str": [17, 18, 20, 28, 29, 32, 33, 35, 37, 44, 47, 49, 52, 71, 72, 73, 79, 80, 81], "straight": [24, 30, 51, 62, 63, 65, 86], "straighten": 62, "straightforward": [62, 63], "strang": [23, 63], "stream": [15, 37, 38, 48, 63], "strength": [29, 32, 47], "stress": [63, 84], "stretch": [23, 26, 28, 29], "strict": [18, 61, 84], "strictli": [30, 85], "stride": [17, 42], "strike": 29, "strikethrough": 28, "string": [9, 14, 17, 18, 19, 20, 22, 23, 25, 28, 29, 31, 32, 33, 37, 38, 41, 44, 46, 48, 49, 51, 52, 53, 56, 68, 84, 86, 87], "strip": 51, "stripe": 65, "stroke": 24, "strong": 29, "strongli": [23, 50], "struct": [1, 4, 5, 6, 7, 9, 17, 29, 42, 43, 51, 52], "structur": [7, 10, 43, 85, 87, 88], "stuck": 62, "studi": [65, 87], "studio": 63, "stuff": [46, 57, 61, 62, 65], "stump": 84, "style": [25, 26, 29, 32, 42, 63, 86], "style_default": 29, "style_norm": 29, "style_obliqu": 29, "style_strong": 29, "style_underlin": 29, "style_wid": 29, "sub": [50, 84], "subarrai": 42, "subclass": [2, 3, 4, 5, 6, 7, 11, 12, 17, 20, 35, 36, 45, 50, 51], "subdirectori": [26, 58], "subgroup": 67, "subject": [23, 44], "submask": 35, "submit": 84, "submodul": [44, 53], "subpackag": 53, "subprocess": 53, "subprocess_ignor": 53, "subscript": [36, 42], "subsect": 62, "subsequ": [23, 57], "subset": [22, 23, 84], "substanti": 84, "substitut": [18, 22], "substr": 37, "subsubsurfac": 51, "subsurfac": [12, 51, 56], "subtract": 89, "subview": 42, "succe": [18, 23], "succeed": 18, "success": [1, 2, 5, 8, 9, 11, 23, 44, 84], "successfulli": [32, 47], "sudden": 63, "suffix": 45, "suggest": [42, 58, 84], "suit": [27, 51, 59], "suitabl": [23, 28, 29, 46, 63, 68, 86], "sum": [24, 74], "summari": 64, "summer": 63, "super": [25, 26, 35, 48, 64], "superclass": 36, "superior": 51, "suppli": [18, 35, 37, 38, 57, 58, 65, 85], "support": [1, 6, 17, 18, 19, 20, 22, 23, 24, 25, 26, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 47, 48, 49, 50, 51, 52, 54, 56, 57, 58, 59, 63, 84, 87], "suppos": [56, 84], "supposedli": 84, "sure": [10, 50, 54, 57, 58, 62, 63, 64, 65, 69, 70, 84, 89], "surf": [22, 26, 29, 30, 42, 50, 51, 56], "surfac": [0, 1, 2, 10, 12, 15, 18, 20, 22, 23, 24, 26, 28, 29, 30, 31, 35, 36, 39, 41, 43, 46, 48, 50, 51, 57, 58, 59, 62, 63, 64, 66, 85, 89], "surface_dest": 50, "surface_to_arrai": 43, "surfarrai": [15, 17, 26, 43, 49, 51, 52, 63, 84], "surfdemo_show": 65, "surflock": 0, "surfobj": 12, "surpris": [62, 63], "surrog": [14, 29], "surround": [56, 85], "suspend": 84, "svg": [16, 31], "svgalib": 23, "swap": [23, 31, 42, 45], "swatch": 20, "swig": 63, "switch": [22, 23, 29, 44, 50, 59, 89], "switch_lay": 50, "swizzl": 36, "swsurfac": 51, "sy": [14, 44, 53, 62, 63, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 86, 89], "symbol": 33, "symmetri": 36, "sync": [23, 25], "synchron": 37, "synonym": 25, "syntax": [65, 84], "syntaxerror": 44, "synthes": 37, "sysfont": [28, 29], "sysrq": 33, "system": [14, 15, 18, 19, 22, 23, 25, 26, 27, 28, 29, 32, 33, 36, 37, 39, 40, 44, 48, 49, 51, 52, 53, 59, 68, 70, 84, 85, 88], "system_cursor_arrow": 22, "system_cursor_crosshair": 22, "system_cursor_hand": 22, "system_cursor_ibeam": 22, "system_cursor_no": 22, "system_cursor_sizeal": 22, "system_cursor_sizen": 22, "system_cursor_sizenesw": 22, "system_cursor_sizenws": 22, "system_cursor_sizew": 22, "system_cursor_wait": 22, "system_cursor_waitarrow": 22, "systemexit": [84, 86, 89], "sys\ub294": 76, "t": [9, 18, 19, 23, 24, 26, 27, 28, 29, 32, 33, 36, 40, 44, 46, 48, 49, 50, 51, 52, 54, 56, 57, 58, 61, 62, 63, 64, 65, 68, 69, 70, 71, 72, 73, 74, 85, 86, 87, 88, 89], "ta": 61, "tab": [25, 33], "tabl": [23, 43], "tackl": 84, "tag": [40, 53], "taka": 18, "takafumi": 18, "take": [14, 22, 24, 25, 26, 28, 29, 31, 32, 33, 35, 36, 37, 38, 40, 42, 45, 50, 51, 53, 56, 57, 58, 59, 63, 64, 65, 68, 84, 85, 86, 88, 89], "taken": [3, 21, 23, 26, 27, 36, 38, 39, 56, 87], "talk": 62, "tan": 21, "tan1": 21, "tan2": 21, "tan3": 21, "tan4": 21, "tango": 29, "tank": 84, "target": [29, 36, 42, 43, 45, 48, 50, 58, 64, 66], "target_textur": 48, "task": [59, 86], "tau": 24, "teach": 62, "teal": 21, "technic": 41, "techniqu": [50, 84], "tell": [9, 38, 39, 44, 51, 58, 59, 62, 64, 84, 88], "temp": 8, "templat": 84, "temporari": [56, 65], "temporarili": [19, 24, 33, 38, 40, 51, 52], "tempt": 84, "temptat": 84, "ten": 54, "tenni": [88, 89], "term": [62, 64, 85], "termin": [1, 25, 37, 44, 58, 62, 68], "terminologi": [39, 84], "terrain1": 62, "terrain2": 62, "test": [15, 19, 23, 25, 26, 28, 29, 31, 32, 33, 36, 38, 39, 41, 44, 45, 47, 50, 51, 56, 58, 59, 60, 65], "test_threshold_dest_surf_not_chang": 56, "test_util": 56, "testin": 37, "testout": 37, "testsprit": 26, "tetri": 74, "text": [25, 26, 28, 29, 32, 33, 46, 66, 68, 69, 70, 71, 84, 85, 87], "text_bitmap": 32, "text_print": 32, "textedit": [25, 33], "textinput": [25, 33], "textmarker_str": 22, "textpo": [58, 66, 85], "textprint": 32, "textur": [30, 48], "textured_polygon": 30, "textureorimag": 48, "tga": [31, 63], "than": [15, 18, 19, 23, 24, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 40, 44, 45, 47, 50, 51, 52, 54, 55, 56, 57, 58, 59, 60, 62, 63, 64, 65, 69, 70, 74, 84, 85, 86, 87, 88, 89], "thank": 88, "the_arg": 11, "the_dirty_rectangl": 84, "thecorruptor": 16, "thei": [1, 10, 18, 19, 22, 23, 24, 25, 26, 28, 29, 32, 35, 36, 38, 39, 44, 45, 46, 47, 50, 51, 56, 58, 59, 62, 63, 64, 65, 68, 69, 71, 72, 84, 86, 87, 88, 89], "them": [15, 16, 22, 24, 25, 26, 27, 28, 31, 32, 33, 34, 35, 38, 42, 44, 45, 49, 50, 51, 52, 57, 58, 59, 62, 63, 65, 71, 84, 85, 86, 87, 88, 89], "themselv": [51, 61, 64, 85], "theorem": 36, "theori": [18, 84], "therefor": [24, 30, 35, 36, 50, 62, 64, 84, 87], "theta": [35, 36], "thi": [1, 2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 15, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 72, 73, 74, 84, 85, 86, 87, 88, 89], "thick": [24, 28], "thickarrow_str": 22, "thin": 58, "thing": [19, 25, 27, 36, 40, 44, 57, 58, 59, 60, 61, 62, 63, 64, 65, 85, 87], "think": [18, 23, 36, 62, 64, 65, 70, 74, 84, 89], "third": [17, 18, 22, 30, 36, 62, 63, 65, 71, 85], "third_surfac": 56, "thirteen": 15, "thistl": 21, "thistle1": 21, "thistle2": 21, "thistle3": 21, "thistle4": 21, "thorough": 89, "those": [15, 18, 22, 23, 24, 25, 26, 28, 29, 39, 42, 43, 50, 57, 61, 62, 64, 65, 84, 86, 87, 88, 89], "though": [18, 23, 30, 37, 38, 43, 53, 61, 65, 84, 85, 86, 87, 88, 89], "thought": 84, "thousand": 49, "thread": [9, 18, 25, 26, 27, 28, 30, 38, 39, 50, 53, 57], "three": [32, 36, 38, 44, 51, 52, 64, 65, 68, 84, 85, 88], "threshold": [35, 42, 50, 56], "threshold_behavior_from_search_color": 56, "threshold_color": 56, "throttl": 32, "through": [2, 18, 25, 27, 28, 29, 31, 35, 37, 38, 44, 50, 51, 58, 61, 62, 63, 64, 74, 84, 85, 88], "throughout": 34, "throw": [40, 62, 64], "thrown": [56, 89], "thru": 63, "thu": [36, 42, 87], "thumbnail": 26, "ti": 40, "tick": [15, 22, 24, 32, 39, 54, 58, 62, 66, 69, 71, 72, 73, 77, 79, 80, 81, 84, 89], "tick_busy_loop": 54, "tick\ud568\uc218\ub294": 77, "tie": [57, 72], "tif": 31, "tiff": [31, 46], "tile": 62, "time": [13, 15, 18, 19, 22, 23, 24, 25, 26, 28, 29, 32, 34, 37, 38, 39, 40, 48, 49, 50, 51, 53, 56, 57, 58, 59, 61, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 77, 78, 79, 80, 81, 84, 85, 86, 87, 89], "time_m": 50, "time_out": 53, "time_proc": 37, "timeout": 25, "timer": [37, 54], "timer_resolut": [34, 54], "timestamp": 37, "tini": [23, 84], "tip": [15, 64, 84], "titl": [23, 48, 58, 63, 68], "tl": 89, "to_surfac": [35, 48], "tobyt": 31, "todo": 64, "togeth": [33, 38, 56, 61, 63, 65, 86], "toggl": [22, 47], "toggle_fullscreen": 23, "toler": [32, 36], "tom": [86, 89], "tomato": 21, "tomato1": 21, "tomato2": 21, "tomato3": 21, "tomato4": 21, "tomchanc": [86, 89], "tompong": [61, 89], "tone": 37, "too": [25, 27, 29, 36, 42, 45, 50, 51, 53, 58, 62, 65, 67, 68, 69, 73, 84, 85], "took": 63, "tool": [26, 64, 67, 84, 87], "toolkit": 48, "top": [15, 23, 24, 26, 28, 29, 31, 35, 38, 39, 45, 50, 51, 62, 63, 75, 76, 77, 78, 79, 80, 81, 84, 85, 86, 89], "topic": [15, 84], "topleft": [35, 42, 45, 50, 56, 58, 62, 66, 89], "toplevel": 38, "topmost": 50, "topright": [45, 89], "tort": 18, "tortur": 84, "tostr": 31, "total": [38, 43, 44, 53, 62, 68, 84, 86], "touch": [25, 32, 84], "touch_id": 25, "touchid": 55, "toward": [23, 25, 36, 61, 63, 84], "tp": [67, 75], "tprint": 32, "tr": 89, "traceback": [65, 86], "track": [15, 19, 50, 54, 57, 62, 64, 84], "trackbal": [25, 47], "tradition": 22, "trail": [53, 63], "trait": [68, 74], "transfer": [15, 46, 56, 61, 65], "transform": [15, 18, 29, 57, 58, 62, 63, 65, 66], "transform_test": 56, "translat": [8, 14, 26, 29, 33, 42], "transluc": 84, "transmiss": 37, "transpar": [23, 24, 26, 28, 29, 31, 35, 43, 48, 51, 52, 56, 58, 62, 63, 84, 86], "transpos": 42, "travel": 89, "treat": [23, 29, 32, 52, 65], "tree": 57, "trend": 63, "tri": [44, 62, 63, 84, 86], "tri_left": 22, "tri_right": 22, "trial": [74, 84], "triangl": [24, 26, 30, 32], "trick": [84, 89], "tricki": [64, 65, 84], "trickier": 65, "trigger": [25, 32, 33, 39, 40, 47, 68, 70], "trigon": 30, "trigonometri": 87, "tripl": 56, "triplet": [23, 24, 30, 58], "troubl": 84, "true": [2, 3, 4, 5, 6, 7, 9, 11, 12, 13, 15, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 44, 45, 46, 47, 50, 51, 53, 56, 57, 58, 60, 62, 63, 64, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 87, 89], "truetyp": [15, 28, 58, 63], "truli": 84, "truncat": [24, 30, 38, 45, 65], "truth": 64, "try": [25, 27, 29, 44, 51, 58, 61, 62, 63, 64, 65, 67, 84, 85, 86, 89], "ttf": [28, 29, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81], "ttf\ud30c\uc77c\ub85c": 76, "ttf\ud655\uc7a5\uc790\ub97c": 76, "tune": [29, 64], "tupl": [8, 17, 19, 20, 22, 23, 24, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 42, 44, 45, 47, 49, 50, 51, 52, 53, 59, 62, 65, 84], "turn": [29, 37, 56, 58, 62, 64, 66, 84], "turquois": 21, "turquoise1": 21, "turquoise2": 21, "turquoise3": 21, "turquoise4": 21, "turtl": 68, "tutori": [26, 61, 63, 66, 73, 74, 84, 85, 89], "tweak": 64, "twice": [50, 51, 56, 65], "twitch": 84, "two": [1, 15, 18, 19, 22, 23, 24, 25, 26, 28, 29, 30, 32, 33, 35, 36, 37, 38, 42, 43, 45, 47, 49, 50, 51, 53, 54, 56, 58, 62, 63, 64, 65, 70, 71, 72, 73, 84, 85, 87], "tx": 30, "ty": 30, "type": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 14, 15, 17, 20, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32, 33, 34, 35, 37, 38, 39, 40, 41, 42, 44, 45, 46, 47, 49, 50, 51, 52, 54, 56, 57, 58, 59, 62, 63, 65, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 87, 88, 89], "type1": 29, "type42": 29, "typeerror": [24, 28, 43, 45, 50, 51], "typelist": 25, "typestr": 17, "typic": [18, 23, 37, 51, 58], "u": [14, 17, 32, 33, 36, 41, 58, 62, 63, 65, 84], "u00000001": 28, "u0001": 28, "u0010ffff": 28, "u4": 17, "u_margin": [73, 81], "uc": [14, 28, 29], "ucs4": [28, 29], "uffff": [14, 28], "ufo": 63, "ufunc": 65, "ui": [26, 48], "uint": 65, "uint32": 1, "uint8": [1, 3], "uk": [86, 89], "ultim": 74, "unabl": [31, 46, 64], "unalt": [44, 84], "unari": 20, "unavail": [23, 58], "unchang": [14, 20, 23, 29], "uncommit": 44, "uncommon": 58, "uncompress": [31, 38], "undefin": [29, 65], "under": [15, 37, 39, 40, 62, 63, 86, 89], "underli": [28, 29, 32, 37, 44, 84], "underlin": [28, 29, 40], "underline_adjust": 29, "underneath": 65, "underscor": [33, 58], "understand": [15, 41, 59, 61, 62, 63, 64, 65, 68, 69, 70, 71, 84, 85, 86, 88, 89], "understood": 71, "undesir": 24, "unencod": 44, "unfamiliar": [62, 84], "unfil": [30, 35], "unfilt": 56, "unfortun": [53, 84], "unicod": [14, 25, 28, 29, 33, 38, 44, 46, 51], "unicode_escap": 44, "unicodeencodeerror": [29, 44], "unicodeerror": 28, "unind": 32, "uniniti": [18, 19, 23, 28, 32, 37, 38, 44, 47], "union": [45, 64, 84], "union_ip": 45, "unional": 45, "unionall_ip": 45, "uniqu": [32, 33, 48, 50, 51, 62, 67, 72, 74], "unit": [29, 44, 51], "uniti": [67, 75], "unix": [22, 23, 63], "unknown": [23, 25, 28, 32], "unless": [6, 19, 23, 29, 31, 41, 46, 51, 54, 56, 58, 62, 64, 68, 69, 87, 88], "unlik": [15, 38, 43, 51, 65, 88], "unload": 40, "unlock": [24, 51], "unmap": 43, "unmap_rgb": [20, 24, 43, 51, 52], "unmodifi": 18, "unnorm": 67, "unnot": 33, "unpack": [20, 39], "unpaus": [19, 38, 40], "unplay": [23, 63], "unpleas": 62, "unpredict": 29, "unpunch": [58, 66], "unreal": [63, 67, 75], "unrealist": 89, "unrecogn": [28, 31], "unrel": 23, "unscal": 29, "unset": [29, 35, 51, 89], "unsetcolor": 35, "unsetsurfac": 35, "unsign": [1, 17, 20, 35, 38, 51, 65], "unspecifi": 29, "unstructur": 51, "unsupport": [18, 40], "until": [18, 23, 24, 25, 27, 32, 35, 37, 40, 47, 51, 54, 57, 62, 64, 66, 84, 85, 88], "untransform": 29, "unus": [31, 38, 50], "unwieldi": 84, "up": [15, 16, 18, 22, 23, 24, 25, 27, 28, 32, 33, 37, 38, 39, 40, 42, 44, 47, 50, 51, 58, 60, 62, 64, 65, 71, 72, 73, 80, 81, 84, 85, 86, 87, 88], "updat": [11, 15, 20, 23, 24, 25, 32, 36, 41, 44, 45, 47, 48, 50, 54, 59, 60, 61, 62, 63, 64, 66, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 84, 85, 87, 88, 89], "update_rect": 26, "update\ud568\uc218\uac00": 76, "upon": 89, "upper": [25, 29, 32, 51, 57], "upscal": 16, "us": [0, 1, 8, 9, 10, 13, 14, 15, 16, 17, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 53, 54, 56, 58, 59, 61, 62, 63, 64, 65, 66, 67, 68, 71, 72, 85, 86, 87, 88, 89], "usabl": [20, 31, 57], "usag": [23, 27, 37, 51, 53], "usb": 37, "use_alpha": 26, "use_arraytyp": [49, 52], "use_bitmap_strik": 29, "use_compat": 33, "use_fastrendergroup": 26, "use_stat": 26, "use_valu": 45, "user": [5, 15, 18, 23, 24, 25, 27, 28, 33, 37, 44, 46, 51, 53, 58, 61, 63, 64, 65, 67, 72, 84, 85, 87], "userev": [25, 38], "usr": [26, 28, 66, 85, 86, 87], "usual": [23, 25, 28, 29, 32, 38, 44, 50, 51, 58, 59, 60, 62, 63, 64, 65, 70, 86], "utf": [14, 28, 29, 46], "utf8_str": 46, "util": [63, 74, 84], "uxxxxxxxx": [14, 29], "uyvy_overlai": 41, "v": [17, 20, 25, 33, 36, 41], "v1": 44, "v2": [1, 40], "v3": 17, "v4l2": [18, 57], "val": [1, 65], "val1": 1, "val2": 1, "valid": [17, 23, 28, 38, 39, 41, 45, 51, 57, 64], "valu": [1, 3, 8, 9, 17, 18, 19, 20, 22, 23, 24, 25, 26, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 56, 58, 59, 62, 64, 65, 68, 69, 71, 72, 84, 85, 88, 89], "value_to_set": 44, "valueerror": [17, 22, 24, 26, 29, 30, 31, 33, 35, 36, 43, 46, 49, 51, 52, 57, 65], "vari": 71, "variabl": [17, 22, 23, 28, 32, 37, 40, 44, 57, 58, 62, 63, 64, 65, 69, 70, 71, 74, 89], "variant": 22, "variat": 84, "varieti": [25, 63, 70, 84], "variou": [1, 15, 22, 25, 26, 34, 36, 89], "vast": 31, "ve": [15, 24, 32, 58, 61, 62, 63, 64, 65, 84, 85, 87, 88, 89], "vec": 36, "vector": [24, 30, 35, 61, 89], "vector2": [15, 24, 30, 35, 36, 45], "vector3": 36, "vectorelementwiseproxi": 36, "veloc": [37, 69], "ver": 44, "vera": [28, 29], "veri": [18, 23, 26, 37, 54, 58, 60, 62, 63, 64, 65, 70, 84, 87, 88, 89], "verifi": 23, "vernum": 44, "versatil": [47, 56], "version": [0, 11, 17, 20, 23, 25, 26, 27, 28, 29, 30, 31, 32, 33, 38, 40, 43, 45, 47, 50, 51, 56, 57, 58, 59, 60, 61, 62, 63, 64, 84, 86, 89], "vertic": [18, 23, 24, 25, 26, 29, 30, 31, 39, 42, 56, 58, 62, 65], "vflip": [18, 57], "vgl": 23, "vgrade": [26, 65], "via": [18, 23, 25, 29, 35, 57, 84], "vidcaptur": 44, "video": [15, 23, 25, 26, 32, 44, 48, 51, 57, 59, 64], "video0": [18, 57], "video_mem": [23, 59], "videocaptur": [18, 57], "videoexpos": [23, 25], "videoinfo": [23, 59], "videores": [23, 25], "vidinfo": [23, 59], "view": [1, 2, 15, 42, 51], "view_p": 1, "violet": 21, "violetr": 21, "violetred1": 21, "violetred2": 21, "violetred3": 21, "violetred4": 21, "virtual": [23, 26, 37, 39, 45, 59], "visibl": [17, 22, 23, 39, 41, 50, 58, 59, 62, 63], "vision": [15, 18], "visit": 63, "vista": 23, "visual": [70, 71, 72, 73, 84], "visualis": 87, "vline": 30, "vm": 25, "vnc": 25, "void": [1, 8, 12], "volatil": 51, "volum": [15, 38, 40, 63], "vsync": [23, 48, 59], "w": [8, 25, 26, 30, 33, 35, 36, 42, 43, 45, 56], "wa": [9, 15, 16, 19, 20, 22, 23, 24, 25, 26, 27, 28, 31, 32, 33, 35, 37, 38, 39, 40, 42, 43, 44, 47, 54, 57, 58, 62, 63, 64, 65, 68, 70, 73, 84, 86, 88], "wai": [18, 23, 24, 25, 26, 28, 29, 31, 32, 33, 36, 38, 39, 43, 44, 47, 48, 50, 51, 53, 58, 60, 61, 62, 63, 64, 65, 71, 85, 87, 88, 89], "wait": [22, 23, 25, 27, 32, 37, 39, 54, 58, 84], "waitarrow": 22, "walk": [58, 66], "wall": [36, 57, 89], "want": [9, 18, 20, 23, 25, 27, 31, 32, 33, 36, 44, 50, 51, 54, 56, 57, 58, 59, 61, 62, 63, 64, 65, 67, 68, 84, 85, 86, 87, 88, 89], "warn": [44, 48, 58, 66], "warranti": 18, "warrior": 63, "was_init": 29, "wasn": 63, "wast": [84, 87], "watch": [15, 57, 61, 85], "wav": [38, 40, 46, 58, 66], "wave": 49, "wavelength": [20, 56], "wayland": [22, 23], "we": [22, 24, 26, 32, 51, 56, 57, 58, 60, 62, 63, 64, 65, 67, 68, 69, 70, 71, 72, 73, 74, 84, 85, 86, 87, 88, 89], "weak": [12, 17, 84], "weakdirtysprit": 50, "weakli": 50, "weaksprit": 50, "web": [26, 66], "webcam": 18, "webp": 31, "websit": 63, "week": 63, "weight": [20, 36, 42, 56, 65], "weird": 33, "welcom": [15, 44], "well": [1, 2, 12, 22, 24, 27, 30, 31, 33, 39, 42, 44, 47, 51, 56, 61, 62, 63, 64, 65, 84, 89], "were": [1, 10, 23, 25, 28, 33, 50, 53, 62, 63, 64, 69, 84, 86, 89], "west": 22, "what": [15, 20, 22, 23, 24, 25, 26, 28, 32, 38, 39, 44, 46, 50, 57, 58, 59, 60, 61, 63, 64, 65, 68, 69, 71, 74, 85, 86, 88, 89], "whatev": [50, 57, 58, 61, 64, 84], "wheat": 21, "wheat1": 21, "wheat2": 21, "wheat3": 21, "wheat4": 21, "wheel": [25, 39], "when": [11, 12, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 36, 37, 38, 39, 40, 41, 42, 44, 45, 46, 49, 50, 51, 52, 53, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 73, 74, 84, 85, 87, 88, 89], "whenev": [23, 25, 38, 39, 44, 59, 65], "where": [10, 15, 17, 19, 20, 22, 23, 24, 26, 29, 30, 33, 35, 36, 38, 39, 40, 41, 42, 44, 46, 47, 50, 51, 53, 56, 57, 58, 62, 64, 65, 68, 84, 85, 88, 89], "wherea": [23, 45, 87], "wherev": [16, 25, 65], "whether": [18, 23, 25, 26, 28, 29, 35, 38, 39, 45, 46, 48, 56, 61, 62, 71, 72, 84, 85], "which": [1, 12, 14, 15, 17, 18, 20, 22, 23, 24, 25, 26, 28, 29, 31, 32, 33, 35, 36, 37, 38, 39, 40, 42, 44, 45, 46, 47, 49, 50, 51, 52, 53, 54, 56, 58, 59, 60, 61, 62, 63, 64, 65, 67, 68, 69, 70, 71, 72, 73, 74, 85, 86, 87, 88, 89], "whiff": [58, 66], "whiff_sound": [58, 66], "while": [0, 15, 17, 19, 22, 24, 25, 28, 30, 31, 32, 36, 38, 39, 40, 42, 43, 44, 49, 50, 51, 54, 57, 62, 63, 64, 65, 66, 68, 69, 70, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84, 85, 87, 89], "whilst": 23, "white": [21, 22, 24, 32, 35, 42, 57, 58, 68, 69, 70, 71, 72, 73, 76, 77, 78, 79, 80, 81, 85], "whitesmok": 21, "whitespac": 61, "who": [15, 48, 61, 62, 64, 86, 89], "whole": [23, 24, 37, 44, 62, 84, 87], "whoop": 62, "whose": [24, 55], "why": [44, 63, 70, 74, 84, 87], "wide": [24, 28, 29, 35, 44, 62, 63], "wider": [18, 33], "widget": 26, "width": [8, 18, 22, 23, 24, 26, 28, 29, 31, 32, 35, 41, 42, 45, 48, 50, 51, 56, 59, 62, 63, 71, 72, 73, 75, 76, 77, 78, 79, 80, 81, 84], "wiki": 39, "wikipedia": 36, "win": [1, 58, 66, 73], "win32": 37, "windib": 23, "window": [1, 4, 15, 18, 25, 26, 27, 28, 29, 32, 33, 34, 37, 39, 44, 46, 48, 51, 58, 59, 62, 63, 68, 69, 84, 85, 88], "window_surfac": 23, "windowclos": 25, "windowdisplaychang": 25, "windowent": 25, "windowev": [23, 25], "windowevent_minim": 23, "windowexpos": 25, "windowfocusgain": 25, "windowfocuslost": 25, "windowhidden": 25, "windowhittest": 25, "windowiccprofchang": 25, "windowleav": 25, "windowmaxim": 25, "windowminim": 25, "windowmov": 25, "windowpos_cent": 48, "windowpos_undefin": 48, "windowres": 25, "windowrestor": 25, "windowshown": 25, "windowsizechang": 25, "windowtakefocu": 25, "wipe": 15, "wire": 32, "wireless": 32, "wisdom": 65, "wise": [29, 65], "wish": 86, "within": [12, 17, 22, 29, 33, 35, 36, 44, 50, 51, 56, 62, 68, 74, 84], "without": [18, 22, 23, 24, 29, 32, 36, 38, 42, 45, 48, 50, 51, 52, 58, 59, 62, 63, 64, 65, 69, 70, 72, 84, 88, 89], "wm": [23, 59], "won": [40, 50, 58, 61, 62, 64, 65, 84, 86, 87, 88], "wonder": [57, 84], "word": [28, 29, 46, 54, 62, 64, 88], "word_wrap": 29, "work": [15, 18, 19, 20, 22, 23, 24, 25, 26, 28, 29, 30, 31, 32, 34, 35, 37, 38, 42, 43, 45, 46, 50, 51, 52, 53, 56, 57, 58, 59, 61, 62, 63, 64, 65, 68, 69, 85, 87, 89], "world": [57, 68, 69, 70, 74, 76, 77, 78, 84], "world\uac00": [77, 78], "world\ub294": 77, "world\uc758": 77, "worri": [26, 48, 50, 64, 65, 74, 84], "wors": 58, "worst": 61, "worth": [51, 54], "would": [17, 22, 24, 25, 28, 35, 36, 38, 44, 50, 51, 56, 57, 58, 60, 61, 62, 63, 64, 65, 84, 85, 87, 88, 89], "wow": 68, "wrap": [2, 4, 9, 17, 22, 28, 30, 42, 51, 63], "wrapper": [9, 84], "wrestl": 26, "writabl": 17, "write": [1, 9, 17, 26, 37, 51, 61, 63, 67, 84, 86, 87], "write_short": 37, "write_sys_ex": 37, "written": [15, 24, 28, 60, 61, 63, 64, 84, 86, 87], "wrong": [38, 65, 84], "wrote": 84, "www": [70, 78], "x": [2, 4, 5, 6, 7, 8, 11, 12, 15, 16, 22, 23, 24, 25, 26, 28, 29, 30, 33, 35, 36, 37, 39, 42, 44, 45, 46, 47, 48, 49, 50, 51, 52, 55, 56, 58, 59, 62, 68, 69, 70, 72, 73, 76, 77, 78, 80, 81, 84, 85, 87, 89], "x00": [14, 28], "x1": [24, 30, 45], "x10": 37, "x11": [23, 25, 37, 39, 44, 46, 48], "x12": 37, "x13": 37, "x2": [24, 30, 45], "x3": [24, 30], "x7d": 37, "x86": 56, "x_offset": 35, "x_scale": 48, "xbm": 22, "xbox": 47, "xf0": 37, "xf7": 37, "xfade": 65, "xor": 22, "xormask": [22, 39], "xpm": 31, "xx": 22, "xxx": 22, "xxxx": 22, "xxxx_test": 53, "xxxxx": 22, "xy": [36, 89], "x\uac12\uacfc": 80, "x\uc88c\ud45c\uac00": 76, "y": [8, 15, 20, 22, 23, 24, 25, 28, 29, 30, 32, 33, 35, 36, 39, 41, 42, 44, 45, 47, 48, 49, 50, 51, 52, 55, 56, 58, 59, 62, 66, 68, 69, 70, 72, 73, 77, 78, 80, 81, 84, 85, 87, 88, 89], "y1": [24, 30, 45], "y2": [24, 30, 45], "y3": [24, 30], "y_offset": 35, "y_scale": 48, "ye": [65, 67, 85], "yeah": 71, "year": [63, 74, 84], "yellow": 21, "yellow1": 21, "yellow2": 21, "yellow3": 21, "yellow4": 21, "yellowgreen": 21, "yet": [29, 48, 65, 84, 88], "you": [9, 10, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 36, 37, 38, 39, 40, 41, 42, 44, 46, 50, 51, 54, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 68, 71, 72, 74, 85, 86, 87, 88, 89], "your": [15, 16, 18, 19, 22, 23, 25, 26, 27, 28, 30, 31, 33, 37, 38, 44, 46, 54, 56, 57, 58, 59, 60, 61, 63, 65, 67, 70, 85, 86, 87, 88, 89], "yourself": [28, 50, 58, 63, 65, 86, 87], "yup": 84, "yuv": [18, 41, 57], "yuy2_overlai": 41, "yv12_overlai": 41, "yvyu_overlai": 41, "y\uac12\uc744": 80, "y\uc131\ubd84\uc744": 76, "y\uc88c\ud45c\uac00": 76, "z": [33, 36, 87, 89], "zero": [19, 20, 24, 28, 29, 36, 37, 38, 45, 51, 59, 64, 65, 89], "zip": [16, 84], "zl": 32, "zoom": 26, "zr": 32, "\uac00": [76, 77, 81], "\uac00\ub2a5": 80, "\uac00\ub3c5\uc131\uc744": 76, "\uac00\ubcf4\uc790": 78, "\uac00\uc18d": 77, "\uac00\uc7a5": [76, 79, 82], "\uac00\uc815\ud558\uba74": 76, "\uac00\uc815\ud574": 75, "\uac00\uc9c0\uace0": [75, 78, 81], "\uac00\uc9c0\uae30": 76, "\uac00\uc9c0\ub294": 76, "\uac00\uc9c0\ubbc0\ub85c": [76, 79], "\uac00\uc9c4\ub2e4": [76, 80], "\uac00\uc9c4\ub2e4\ub294": 75, "\uac00\uc9c8": 82, "\uac01\uac01": 79, "\uac01\uac01\uc758": 79, "\uac04\ub2e8\ud558\ub2e4": 81, "\uac10\uc18c\uc2dc\ud0a4\ub294": 80, "\uac10\uc18c\ud55c\ub2e4": 81, "\uac12": 79, "\uac12\ub9cc\uc774": 79, "\uac12\uc740": [76, 79], "\uac12\uc744": [76, 79, 80], "\uac12\uc774": 79, "\uac12\uc774\uace0": 79, "\uac16\ub294": [81, 82], "\uac19\ub2e4": [75, 76, 82], "\uac19\uc544": [77, 81], "\uac19\uc740": [76, 77, 82], "\uac19\uc74c": 81, "\uac19\uc774": [76, 79], "\uac1c\ub150\uc740": 82, "\uac1c\ub150\uc744": 77, "\uac1c\ub150\uc774\ub2e4": 82, "\uac1c\ubc1c\uc790\uac00": 75, "\uac1c\uc120\uc758": 81, "\uac1c\uc218\ub97c": 81, "\uac1c\uc218\ub9cc\ud07c": 79, "\uac1d\uccb4": [76, 78], "\uac1d\uccb4\uc5d0": 76, "\uac1d\uccb4\uc758": 76, "\uac70\uc758": [75, 76], "\uac71\uc815\ud558\uc9c0": 82, "\uac78\ub9ac\ub294": 76, "\uac80\uc740": [79, 81], "\uac80\uc740\ube14\ub85d": 15, "\uac83": [75, 76, 78], "\uac83\uacfc": [80, 82], "\uac83\ub4e4\uc774": 81, "\uac83\ub4e4\uc774\ub2e4": 76, "\uac83\ubcf4\ub2e4": 79, "\uac83\uc5d0": [75, 77, 78], "\uac83\uc5d0\ub9cc": 75, "\uac83\uc740": [76, 77, 78, 79, 80, 82], "\uac83\uc744": 79, "\uac83\uc774": [75, 76, 79, 80], "\uac83\uc774\uae30": 78, "\uac83\uc774\ub2e4": [75, 76, 77, 78, 79, 80, 81, 82], "\uac83\uc778\uac00": 80, "\uac83\ucc98\ub7fc": [77, 80], "\uac8c\uc784": [75, 76, 77, 78, 81, 82], "\uac8c\uc784\ub3c4": [75, 82], "\uac8c\uc784\ub9cc\uc758": 82, "\uac8c\uc784\uc5d0\uc11c\uc758": 79, "\uac8c\uc784\uc5d0\uc120": 77, "\uac8c\uc784\uc5d4\uc9c4": 75, "\uac8c\uc784\uc5d4\uc9c4\uc774\ub098": 75, "\uac8c\uc784\uc740": [75, 78, 81], "\uac8c\uc784\uc744": [75, 78, 82], "\uac8c\uc784\uc758": [75, 78], "\uac8c\uc784\uc774": [75, 77, 78, 80, 81, 82], "\uac8c\uc784\uc774\ub098": 82, "\uac8c\uc784\uc774\ub2e4": 81, "\uac8c\uc784\uc774\ub77c\uace0": 78, "\uac8c\uc784\uc774\ubbc0\ub85c": 76, "\uac8c\uc784\ud310": 83, "\uac8c\uc784\ud310\uc740": 81, "\uac8c\uc784\ud310\uc744": 81, "\uacaa\uc5b4": 82, "\uacb0\uacfc": [76, 77, 78], "\uacb0\uacfc\uac00": 77, "\uacb0\uacfc\ub294": [78, 81], "\uacb0\uacfc\ub97c": 77, "\uacb0\uacfc\ubb3c\ub4e4\uc744": 76, "\uacb0\uacfc\ubb3c\uc740": 76, "\uacb0\ub860\uc774": 82, "\uacb0\uc815\ud560": 76, "\uacbd\uc6b0": [76, 78, 79, 80], "\uacbd\uc6b0\ub97c": 78, "\uacbd\uc6b0\uc758": 82, "\uacbd\ud5d8\uc774": 78, "\uacc4\uc0b0\ub9cc": 76, "\uacc4\uc0b0\uc744": 80, "\uacc4\uc0b0\ud558\uae30": 77, "\uacc4\uc0b0\ud574\uc57c": 81, "\uacc4\uc18d": [75, 76, 78], "\uace0": 81, "\uace0\uae09": 75, "\uace0\ub824\ub418\uc5c8\uc744": 82, "\uace0\ub824\ub418\uc9c0": 77, "\uace0\ub824\ud558\uc5ec": 76, "\uace0\ub974\ub294": 81, "\uace0\uc815": 77, "\uace0\uc815\ub418\uc5b4": [76, 79], "\uace0\uc815\ub41c": 76, "\uace0\uc815\ub420": 77, "\uace0\uc815\uc2dc\ucf1c": 77, "\uace0\uc815\uc2dc\ud0a4\ub294": 77, "\uace0\uc815\uc2dc\ud0a8\ub2e4": 76, "\uace0\uc815\ud558\ub294": 77, "\uacf5\uac04": 76, "\uacf5\uac04\uc0c1\uc5d0\uc11c\uc758": 75, "\uacf5\uac04\uc744": [76, 80], "\uacf5\uc774\ub098": 77, "\uacfc": [76, 80], "\uad00\ub828": 75, "\uad6c\uc131": 76, "\uad6c\uc131\ub41c\ub2e4": 75, "\uad6c\uc131\ud560": 75, "\uad6c\uc2dd\uc774\uace0": 75, "\uad6c\uc5ed\uc744": 76, "\uad6c\uc5ed\uc758": 76, "\uad6c\uccb4\uc801\uc778": [78, 80], "\uad6c\ud604\ud55c": [81, 82], "\uad6c\ud604\ud55c\ub2e4\uba74": 81, "\uad6c\ud604\ud560": 82, "\uaddc\uce59": [78, 82], "\uaddc\uce59\uc740": 81, "\uaddc\uce59\uc744": [81, 82], "\uaddc\uce59\uc774": 82, "\uadf8": [75, 76, 77, 79, 80, 81], "\uadf8\uac83\uc740": 79, "\uadf8\uac83\uc774": [78, 82], "\uadf8\uac83\uc774\ub2e4": 76, "\uadf8\ub2e4\uc9c0": 76, "\uadf8\ub798\uc11c": [75, 76, 77], "\uadf8\ub798\ud53d": 75, "\uadf8\ub798\ud53d\uc744": 75, "\uadf8\ub7ec\ub098": [77, 78, 82], "\uadf8\ub7ec\uba74": [75, 77, 81], "\uadf8\ub7ec\ubbc0\ub85c": [76, 77, 80, 82], "\uadf8\ub7f0\uac00": 78, "\uadf8\ub807\ub2e4\uba74": [76, 77], "\uadf8\ub807\uc9c0": 80, "\uadf8\ub824\uc9c0\uace0": 76, "\uadf8\ub824\uc9c0\ub294": 76, "\uadf8\ub824\uc9c4\ub2e4": 81, "\uadf8\ub9ac\uace0": [75, 76, 77], "\uadf8\ub9ac\uae30": 75, "\uadf8\ub9ac\ub294": [76, 79], "\uadf8\ub9b0\ub2e4": [79, 80], "\uadf9\uc18c\uc218\ub9cc\uc744": 82, "\uae30\ub2a5": 77, "\uae30\ub2a5\uc744": [76, 77], "\uae30\ub85d\ud574\uc57c": 80, "\uae30\ubc18": 76, "\uae30\ubc18\uc73c\ub85c": 76, "\uae30\ubc18\ud558\uc600\uae30": 75, "\uae30\uc874\uc758": 82, "\uae38\uc774\ub97c": 76, "\uae4c\uba39\uc5b4\uc120": 76, "\uae5c\ube61\uac70\ub9ac\ub294": 75, "\uaf64": 76, "\ub049\uaca8": 75, "\ub05d\ub09c": 76, "\ub05d\uc774": 82, "\ub098": 81, "\ub098\uac8c": 82, "\ub098\ub220\uc9c8": 76, "\ub098\ub294": 78, "\ub098\uba74": 76, "\ub098\uc544\uc84c\ub2e4": 79, "\ub098\uc911\uc5d0": [76, 77, 78], "\ub098\ud0c0\ub0b8\ub2e4": 80, "\ub09c\ub2e4": 82, "\ub09c\uc218": 82, "\ub09c\uc218\uac00": 82, "\ub09c\uc218\uae4c\uc9c0": 82, "\ub0ab\ub2e4": 75, "\ub0b4\ubd80": [76, 78], "\ub0b4\ubd80\ub97c": 80, "\ub0b4\ubd80\uc5d0\uc11c": 80, "\ub0b4\ubd80\uc600\ub2e4\uba74": 80, "\ub0b4\uc5d0\uc11c": [77, 81, 82], "\ub0b4\uc6a9": 76, "\ub0b4\uc6a9\uacfc": 76, "\ub0b4\uc6a9\uc740": 80, "\ub108\ubb34": 77, "\ub118\uac8c": 82, "\ub123\ub294\ub2e4\uba74": 81, "\ub123\uc73c\uba74": 81, "\ub124\ubc88\uc9f8": 79, "\ub192\ub2e4\ub294": 75, "\ub192\uc774\uae30": 76, "\ub204\ub974\ub294": 77, "\ub204\ub974\uba74": 78, "\ub208\uc0ac\ud0dc": 82, "\ub208\uc0ac\ud0dc\ub97c": 82, "\ub20c\ub7ec": 79, "\ub20c\ub824\uc788\ub294": 78, "\ub20c\ub838\ub2e4": 78, "\ub20c\ub9ac\uc9c0": 78, "\ub20c\ub9b0": 78, "\ub294": 76, "\ub2a5\ub825\uc774\ub2e4": 82, "\ub2e4\ub8e8\uaca0\ub2e4": 78, "\ub2e4\ub8e8\uae30": 78, "\ub2e4\ub918\ub2e4": 82, "\ub2e4\ub974\uac8c": 78, "\ub2e4\ub974\ub2e4": 77, "\ub2e4\ub974\uc9c0": 79, "\ub2e4\ub978": [76, 78, 82], "\ub2e4\uc2dc": 79, "\ub2e4\uc591\uc131": 78, "\ub2e4\uc591\ud788": 81, "\ub2e4\uc74c": [76, 79, 80, 81], "\ub2e4\uc911": 77, "\ub2e4\ud589\ud788": 75, "\ub2e8": 77, "\ub2e8\uacc4\ub85c": 78, "\ub2e8\uacc4\ub97c": 76, "\ub2e8\uacc4\uc5d0\uc11c\uc758": 78, "\ub2e8\uc0c9": 76, "\ub2e8\uc21c\ud558\uae30": 81, "\ub2e8\uc21c\ud558\ub2e4": [79, 80], "\ub2e8\uc21c\ud558\uc9c0\ub9cc": 81, "\ub2e8\uc21c\ud788": [78, 81], "\ub2e8\uc5b4\ub294": 78, "\ub2e8\uc810\uc740": 77, "\ub2e8\uc810\uc774": 75, "\ub2ec\ub77c\uc9c0\ubbc0\ub85c": 77, "\ub2ec\ub77c\uc9c4\ub2e4": 81, "\ub2ec\ub77c\uc9c8": 78, "\ub2f4\uc558\ub294\ub370": 79, "\ub2f9\uc5f0\ud55c": 76, "\ub300\ub2e8\ud788": [81, 82], "\ub300\ub85c": 81, "\ub300\ubcf4\uac8c": 75, "\ub300\uc0c1\uc5d0": 82, "\ub300\uccb4\ud558\ub294\uac00": 76, "\ub300\ud55c": 76, "\ub354": [75, 78, 79, 82], "\ub370": 76, "\ub370\uc5d0\ub9cc": 80, "\ub370\uc774\ud130": [78, 81], "\ub370\uc774\ud130\uac00": 76, "\ub370\uc774\ud130\ub4e4\uc744": 79, "\ub370\uc774\ud130\ub97c": 79, "\ub3c4": [76, 78], "\ub3c4\uc6c0": 78, "\ub3c4\uc6c0\uc774": 78, "\ub3c4\uc911": 76, "\ub3c4\ud615": 75, "\ub3c4\ud615\uc744": 79, "\ub3d9\uae30\ubd80\uc5ec": 78, "\ub3d9\uc2dc\uc5d0": 75, "\ub3d9\uc77c\ud55c": [76, 79, 80], "\ub3d9\uc77c\ud574\uc57c": 80, "\ub3d9\uc791\ud558\ub3c4\ub85d": 78, "\ub3d9\uce58\uad00\uacc4\ub77c\ub294": 75, "\ub418\uae30": 78, "\ub418\ub3cc\uc544\uac00\uc57c": 76, "\ub418\uc5b4\uc57c\ub9cc": 77, "\ub418\uc5c8\ub294\uc9c0": 78, "\ub418\uc9c0": 79, "\ub41c": [78, 80], "\ub41c\ub2e4": [75, 76, 77, 78, 79, 80, 81, 82], "\ub41c\ub2e4\uba74": 82, "\ub420": [75, 77, 79, 80], "\ub450": [79, 80, 81, 82], "\ub450\uaed8": 79, "\ub450\uaed8\ub9cc": 80, "\ub450\ub294": [79, 80], "\ub450\ub294\ub370": 76, "\ub450\uba74": 77, "\ub450\ubc88\uc9f8": [78, 79], "\ub450\uc5c8\ub2e4": 76, "\ub458": 75, "\ub458\uc9f8": [75, 80], "\ub4a4\uc5d0": 78, "\ub4b7\ubd80\ubd84\uc5d0": 77, "\ub4e4\uba74": 79, "\ub4e4\uc5b4\uc11c": 76, "\ub4e4\uc744": 80, "\ub4f1": [75, 78], "\ub4f1\uc740": 82, "\ub4f1\uc758": 75, "\ub514\ub809\ud1a0\ub9ac\uc5d0": 76, "\ub514\uc2a4\ud50c\ub808\uc774": 75, "\ub514\uc790\uc778\ud560": 79, "\ub51c\ub808\ub9c8\uac00": 75, "\ub51c\ub808\ub9c8\ub97c": 75, "\ub51c\ub808\uc774": 77, "\ub530\ub77c": [77, 81], "\ub530\uc62c": 79, "\ub530\uc838\uc11c": 79, "\ub54c": [76, 77, 79, 81, 82], "\ub54c\ub9c8\ub2e4": 79, "\ub54c\ub9cc": 76, "\ub54c\ubb38\uc5d0": [75, 76, 77, 78, 81], "\ub54c\ubb38\uc774\ub2e4": [76, 77, 78, 80, 81], "\ub54c\uc758": 79, "\ub610\ub294": [75, 79, 82], "\ub610\ud55c": [77, 81], "\ub611\uac19\uc740": 78, "\ub73b\uc774\ub2e4": 78, "\ub77c\uace0": [78, 82], "\ub77c\ub294": [76, 82], "\ub77c\uc774\ube0c\ub7ec\ub9ac\uc774\uae30": 75, "\ub77c\uc774\ube0c\ub7ec\ub9ac\uc774\ub2e4": 75, "\ub80c\ub354\ub9c1": 79, "\ub85c\uc9c1\uc740": 79, "\ub85c\uc9c1\uc744": [76, 78], "\ub85c\uc9c1\uc774": 77, "\ub8e8\ud2b82": 77, "\ub97c": [76, 77, 78, 80], "\ub9c8\ub77c": 82, "\ub9c8\uc6b0\uc2a4": [75, 78, 80], "\ub9c8\uc6b0\uc2a4\uac00": 80, "\ub9c8\uc9c0\ub9c9\uc5d0": 76, "\ub9c8\uc9c0\ub9c9\uc73c\ub85c": [78, 79], "\ub9c8\ucc2c\uac00\uc9c0\uc774\ub2e4": 82, "\ub9cc": 75, "\ub9cc\ub4dc\ub294": [75, 80, 82], "\ub9cc\ub4e0": 75, "\ub9cc\ub4e0\ub2e4\uace0": 75, "\ub9cc\ub4e4": [75, 79, 82], "\ub9cc\ub4e4\uace0": 81, "\ub9cc\ub4e4\uc5b4": [79, 81], "\ub9cc\ub4e4\uc5b4\uc11c": 82, "\ub9cc\ub4e4\uc5b4\uc57c": 80, "\ub9cc\ub4e4\uc5b4\uc9c4": 81, "\ub9cc\ub4e4\uc5b4\uc9c4\ub2e4\uba74": 82, "\ub9cc\ub4e4\uc5c8\ub2e4": 79, "\ub9cc\uc57d": [76, 79, 80, 82], "\ub9cc\uc744": [76, 79], "\ub9ce\ub2e4": 81, "\ub9ce\uc73c\ubbc0\ub85c": 77, "\ub9ce\uc740": 81, "\ub9d0\uc774\ub2e4": 76, "\ub9d0\ud558\ub294": 78, "\ub9d0\ud55c": 76, "\ub9d0\ud588\ub2e4": 82, "\ub9d0\ud588\ub4ef": 76, "\ub9de\ub294\uac00": 78, "\ub9de\uc744": 76, "\ub9e4\uac1c": 79, "\ub9e4\uc6b0": [78, 82], "\uba39\ud788\ub294": 76, "\uba3c\uc800": [78, 79], "\uba54\ubaa8\ub9ac": 75, "\uba64\ubc84": 76, "\uba85\ub839\uc5b4\uac00": 78, "\uba87": 77, "\uba87\uba87": [76, 78], "\ubaa8\ub2c8\ud130": 76, "\ubaa8\ub450": [75, 76], "\ubaa8\ub4c8\ub4e4\uc744": 76, "\ubaa8\ub4e0": [75, 76, 78, 81, 82], "\ubaa9\ub85d\uc740": 78, "\ubaa9\ud45c\uac00": 75, "\ubab8\uc758": 78, "\ubb34\uc5b8\uac00\ub97c": [76, 78], "\ubb34\uc5c7\uc744": 77, "\ubb34\uc5c7\uc774\ub4e0\uc9c0": 82, "\ubb34\uc5c7\uc778\uac00": [77, 79, 82], "\ubb34\uc5c7\uc778\uc9c0\ub294": 79, "\ubb34\uc791\uc704\ub85c": 81, "\ubb34\ud55c": 76, "\ubb36\uc744": 80, "\ubb38\uad6c\uc774\ub2e4": 76, "\ubb38\uc790\uc5f4\uc740": 76, "\ubb38\uc790\uc5f4\uc774\ub2e4": 76, "\ubb38\uc7a5\ub4e4": 76, "\ubb38\uc81c\uac00": [76, 77], "\ubb38\uc81c\ub97c": 81, "\ubb3c\ub860": [75, 76, 77, 78, 79], "\ubb54\uac00": 80, "\ubbf8\uce58\uac8c": 82, "\ubc0f": 78, "\ubc14\uafb8\uace0": 77, "\ubc14\uafb8\ub294": 77, "\ubc14\uafb8\ub294\uac00": 79, "\ubc14\uafb8\uba74": 81, "\ubc14\uafbc": 78, "\ubc14\uafc0": 77, "\ubc14\uafd4": 79, "\ubc14\ub00c\ub294\uac00": 77, "\ubc14\ub00c\ub294\uc9c0\ub97c": 77, "\ubc14\ub294": 79, "\ubc14\ub85c": [77, 82], "\ubc18\ub4dc\uc2dc": [77, 78], "\ubc18\ubcf5\ubb38": 76, "\ubc18\uc601": 78, "\ubc18\ud544\uc218\uc801\uc73c\ub85c": 76, "\ubc18\ud658": 76, "\ubc18\ud658\ud55c\ub2e4": [76, 81], "\ubc1c\uc0dd": 76, "\ubc1c\uc0dd\ud558\uba74": 76, "\ubc1c\uc0dd\ud55c": 76, "\ubc1c\uc804\ub41c": 75, "\ubc1c\ud718\ub41c": 82, "\ubc29\ubc95": 78, "\ubc29\ubc95\uc740": [78, 79], "\ubc29\ubc95\uc744": [77, 78], "\ubc29\ubc95\uc774\ub2e4": 79, "\ubc29\uc2dd": 75, "\ubc29\ud5a5\uc73c\ub85c": 78, "\ubc29\ud5a5\ud0a4\ub97c": 78, "\ubc30\uc5f4\uacfc": 81, "\ubc30\uc5f4\uc5d0\uc11c": 81, "\ubc30\uc5f4\uc740": 81, "\ubc30\uc5f4\uc744": [76, 81], "\ubc30\uc5f4\uc774": 81, "\ubc30\uc5f4\ucc98\ub7fc": 81, "\ubc30\uc6b0\uace0": [78, 82], "\ubc30\uc6b0\ub294": [75, 76], "\ubc30\uc6b4\ub2e4": 78, "\ubc30\ud2c0\uc2ed": 75, "\ubc84\ud2bc": 81, "\ubc84\ud2bc\ub4e4": 83, "\ubc84\ud2bc\ub4e4\uc740": 80, "\ubc84\ud2bc\ub4e4\uc744": 80, "\ubc84\ud2bc\uc744": [77, 80, 81], "\ubc84\ud2bc\uc758": 80, "\ubc88": 77, "\ubc94\uc704\ub294": 80, "\ubc95\uc744": 81, "\ubcc0\uacbd\ud558\uba74\uc11c": 79, "\ubcc0\uc218": [76, 79, 80], "\ubcc0\uc218\uac00": [76, 77, 79, 80], "\ubcc0\uc218\ub294": [76, 79], "\ubcc0\uc218\ub3c4": 80, "\ubcc0\uc218\ub4e4\uc744": 80, "\ubcc0\uc218\ub4e4\uc774": 76, "\ubcc0\uc218\ub85c": [79, 80], "\ubcc0\uc218\ub97c": [76, 77, 79, 80], "\ubcc0\uc218\uc640": 78, "\ubcc0\uc218\uc758": 79, "\ubcc0\uc218\uc774\uace0": 79, "\ubcc0\uc218\uc774\ub2e4": 79, "\ubcc0\uc704\uac00": 77, "\ubcc0\uc704\ub294": 77, "\ubcc0\uc704\ub9cc": 77, "\ubcc0\ud55c\ub2e4\uba74": 79, "\ubcc0\ud560": 79, "\ubcf4\uace0": 75, "\ubcf4\ub2e4": 77, "\ubcf4\uba74": [77, 80], "\ubcf4\uc544\ub77c": [78, 79, 82], "\ubcf4\uc774\ub294": 80, "\ubcf4\uc774\uc9c4": 81, "\ubcf4\uc778\ub2e4": 77, "\ubcf4\uc778\ub2e4\ub294": [75, 77], "\ubcf4\uc77c": 77, "\ubcf4\uc790": [75, 82], "\ubcf4\ud1b5": 75, "\ubcf5\uc18c\uc218\uc88c\ud45c\ub97c": 75, "\ubcf5\uc7a1\ub3c4\ub294": 77, "\ubcf5\uc7a1\ub3c4\ub97c": 77, "\ubcf5\uc7a1\ud558\ub2e4": 76, "\ubcf5\uc7a1\ud55c": 75, "\ubcf8\uaca9\uc801\uc73c\ub85c": 79, "\ubcfc\ub9cc": 75, "\ubd80": 83, "\ubd80\ubd84\uc5d0\uc11c": 78, "\ubd80\ubd84\uc73c\ub85c": 76, "\ubd80\ubd84\uc758": 81, "\ubd80\uc5ec\ud560": 82, "\ubd84\uc11d\ud558\uc9c0": 77, "\ubd88\uacfc\ud558\ub2e4": 78, "\ubd88\uacfc\ud558\ubbc0\ub85c": 77, "\ubd88\ub9b4": 78, "\ubd88\uc5f0\uc18d\uc801": 79, "\ube14\ub85d": 81, "\ube14\ub85d\uc744": 81, "\ube14\ub85d\uc758": 81, "\ube44\uad50\ud558\uc5ec": 78, "\ube44\ud45c\uc900": 75, "\ube44\ud558\uba74": 76, "\ube48\ub3c4\uc5d0": 77, "\ube60\ub978": 75, "\ube60\ub97c\uae4c": 77, "\ube60\uc9c0\uba74": 75, "\ube68\uac04": [76, 79, 81], "\ube68\uac04\ube14\ub85d": 15, "\ube68\ub9ac": 75, "\ubfcc\uc694\ubfcc\uc694": 75, "\uc0ac\ub78c\ub4e4\uc774": 82, "\uc0ac\ub78c\uc774": 82, "\uc0ac\uc2e4": 81, "\uc0ac\uc6a9\ub418\uc5c8\uae30": 80, "\uc0ac\uc6a9\ub418\uc5c8\uc9c0\ub9cc": 80, "\uc0ac\uc6a9\ub41c": 79, "\uc0ac\uc6a9\uc790\uac00": [76, 80], "\uc0ac\uc6a9\ud558\uae30": 76, "\uc0ac\uc6a9\ud558\ub294": 76, "\uc0ac\uc6a9\ud558\uc5ec": 76, "\uc0ac\uc6a9\ud560": 76, "\uc0ac\uc774\uc5d0\ub294": 75, "\uc0ac\uc774\uc758": 75, "\uc0ac\uc9c4": 75, "\uc0b4\ud3b4\ubcf4\uc790": 76, "\uc0bd\uc785\ud558\uba74": 76, "\uc0c1\uc138\ud558\uac8c": 79, "\uc0c1\uc218": 80, "\uc0c1\uc218\ub4e4\uc744": 76, "\uc0c1\ud0dc": 78, "\uc0c1\ud0dc\ub97c": 75, "\uc0c1\ud638\uc791\uc6a9\uc774": 78, "\uc0c8\ub85c\uc6b4": [79, 81, 82], "\uc0c9": [75, 76, 79], "\uc0c9\uc0c1": [76, 79], "\uc0c9\uc0c1\uacfc": 76, "\uc0c9\uc0c1\uc740": [76, 81], "\uc0c9\uc0c1\uc744": [76, 81], "\uc0c9\uc0c1\uc758": 81, "\uc0c9\uc774": 76, "\uc0dd\uac01\uc77c": 80, "\uc0dd\uac01\ud574": 82, "\uc0dd\uac01\ud574\ubcf4\uba74": 78, "\uc0dd\uac01\ud574\ubd10\ub77c": 78, "\uc0dd\uacbc\ub2e4": 78, "\uc0dd\uae38": 76, "\uc0dd\uc131\ud558\uace0": 76, "\uc11c\ub85c": 76, "\uc120\uc5b8": 76, "\uc120\uc5b8\ub418\uc5b4\uc57c": 76, "\uc120\ud0dd\uc801\uc73c\ub85c": 75, "\uc120\ud0dd\uc801\uc778": 77, "\uc120\ud0dd\uc9c0\ub294": 81, "\uc120\ud589\ub418\uc5b4\uc57c": 79, "\uc124\uba85\uc774": 76, "\uc124\uba85\uc774\uc5c8\ub2e4": 76, "\uc124\uba85\ud558\ub294": 79, "\uc124\uba85\ud560": 81, "\uc124\uc815": 75, "\uc131\ubd84": 76, "\uc131\ubd84\uc774": 76, "\uc138\uace0": 81, "\uc138\ud305": 78, "\uc148\uc774\ub2e4": 76, "\uc18c\uac1c": 83, "\uc18c\ub9ac": [75, 78], "\uc18c\uc124": 82, "\uc18c\uc2a4": [75, 76, 77, 78], "\uc18c\uc2a4\ucf54\ub4dc": 76, "\uc18c\uc2a4\ucf54\ub4dc\uac00": 76, "\uc18c\uc2a4\ucf54\ub4dc\ub294": 76, "\uc18c\uc2a4\ucf54\ub4dc\ub97c": [75, 76], "\uc18c\uc2a4\ucf54\ub4dc\uc5d0": 76, "\uc18c\uc2a4\ucf54\ub4dc\uc640": 75, "\uc18c\uc2a4\ucf54\ub4dc\uc758": 76, "\uc18c\uc2a4\ud30c\uc77c\uc5d0": 75, "\uc18c\uc2a4\ud30c\uc77c\uc740": 75, "\uc18c\uc9c0\uac00": 80, "\uc18d": 76, "\uc18d\ub3c4\ub77c\ub294": 77, "\uc18d\ub3c4\ub97c": 77, "\uc18d\ub3c4\uc5d0": 77, "\uc18d\uc5d0\ub294": 77, "\uc190\uac00\ub77d": 78, "\uc190\uc744": 75, "\uc218": [75, 76, 77, 78, 79, 80, 81, 82], "\uc218\uac00": 82, "\uc218\ub294": [77, 82], "\uc218\ub3c4": 82, "\uc218\ub97c": 81, "\uc218\ub9ce\uc740": 75, "\uc218\uc815\ud558\ub294": 76, "\uc218\uc815\ud55c\ub2e4\uba74": 76, "\uc218\uc900": 75, "\uc218\ud589\ub418\uc5b4\uc57c": 76, "\uc218\ud589\ud55c\ub2e4": 76, "\uc21c\ucc28\uc801\uc73c\ub85c": 76, "\uc26c\uc6b4": 79, "\uc27d\uac8c": [77, 79], "\uc27d\ub2e4": [77, 78, 80], "\uc2a4\ud06c\ub9b0": 76, "\uc2b5\ub4dd\ud560": 82, "\uc2dc\uac01\uc801": 81, "\uc2dc\uac01\ud654": [78, 79], "\uc2dc\uac04": [77, 78, 81], "\uc2dc\uac04\ubcf4\ub2e4": 82, "\uc2dc\uac04\uc21c\uc73c\ub85c": 76, "\uc2dc\uac04\uc740": 77, "\uc2dc\uac04\uc744": [77, 82], "\uc2dc\uac04\uc774": [76, 82], "\uc2dc\uac04\uc774\ub2e4": 82, "\uc2dc\ub3c4\ud574": 75, "\uc2dc\uc2a4\ud15c\uc744": 78, "\uc2dc\uc2a4\ud15c\uc774": 76, "\uc2dc\uc791\ub418\uae30": 77, "\uc2dc\uc791\ub420": 77, "\uc2dc\uc791\ud558\ub294": 77, "\uc2dc\ud589": 82, "\uc2dd\uc758": 75, "\uc2e0\uacbd": 80, "\uc2e4\uc81c\ub85c": 76, "\uc2e4\ud589": [76, 77, 78, 81], "\uc2e4\ud589\ub418\uac70\ub098": 75, "\uc2e4\ud589\ub418\ub294": [75, 77], "\uc2e4\ud589\ub418\uba74": 76, "\uc2e4\ud589\ub418\uc57c": 77, "\uc2e4\ud589\ub418\uc5b4\uc57c": 76, "\uc2e4\ud589\ub418\uc9c0": 76, "\uc2e4\ud589\ub41c\ub2e4": 76, "\uc2e4\ud589\ub41c\ub2e4\ub294": 75, "\uc2e4\ud589\ub428": 75, "\uc2e4\ud589\ud558\ub294": 75, "\uc2eb\ub2e4\uba74": 80, "\uc2ec\ud654": 78, "\uc2ec\ud654\ub41c": 78, "\uc2f6\ub2e4\uba74": 75, "\uc2f6\uc744": 76, "\uc368\uc57c": 80, "\uc4f0\uba74": 76, "\uc4f8": 75, "\uc544\ub2c8\ub2e4": 78, "\uc544\ub2c8\ub77c": 77, "\uc544\ub2c8\ubbc0\ub85c": 77, "\uc544\ub2c8\uc9c0\ub9cc": 78, "\uc544\ub2cc": [75, 76, 77, 79, 80, 81], "\uc544\ub2cc\uc9c0\ub97c": 78, "\uc544\ub798\ub97c": 79, "\uc544\ub798\uc640": 79, "\uc544\ub798\ucabd\uc774": 76, "\uc544\ub9c8\ub3c4": 78, "\uc544\ubb34": 82, "\uc544\ubb34\ub798\ub3c4": 75, "\uc544\uc2a4\ud0a4\uc544\ud2b8\ub97c": 75, "\uc544\uc774\ub514\uc5b4\ub294": 79, "\uc544\uc774\ub514\uc5b4\ub97c": 79, "\uc544\uc774\ub514\uc5b4\uc640": 79, "\uc544\uc774\ub514\uc5b4\ucc98\ub7fc": 80, "\uc544\uc9c1": [79, 80], "\uc544\uc9c1\ub3c4": [77, 80], "\uc548\ub418\ub294": 77, "\uc548\ub41c\ub2e4": 76, "\uc54a\ub294": [76, 77], "\uc54a\ub294\ub2e4": [77, 78, 79, 81], "\uc54a\ub2e4": 79, "\uc54a\ub2e4\uba74": 80, "\uc54a\uc558\uc9c0\ub9cc": 78, "\uc54a\uc73c\uba74": 76, "\uc54a\uc744": [76, 77], "\uc54c": [76, 80, 81], "\uc54c\uace0": [77, 78], "\uc54c\uace0\ub9ac\uc998\uc73c\ub85c": 75, "\uc54c\uace0\ub9ac\uc998\uc758": 78, "\uc54c\uace0\ub9ac\uc998\uc774": 78, "\uc54c\ub809\uc138\uc774": 82, "\uc54c\uc544\ub0b4\uae30": 80, "\uc54c\uc544\ub0bc": [76, 77], "\uc54c\uc544\uc57c": 78, "\uc54c\uc558\ub2e4": 77, "\uc54c\uce74\ub178\uc774\ub4dc\uc758": 77, "\uc55e\ubd80\ubd84\uc5d0": 77, "\uc55e\uc11c": 76, "\uc55e\uc11c\uc11c": 76, "\uc55e\uc5d0": 78, "\uc560\ub2c8\uba54\uc774\uc158": [75, 77], "\uc57d\uac04": 78, "\uc57d\uac04\uc758": 76, "\uc5b4\ub5a4": [76, 82], "\uc5b4\ub5a4\uac00": 79, "\uc5b4\ub5a8\uae4c": [76, 80], "\uc5b4\ub5bb\uac8c": [76, 77, 79, 80, 81], "\uc5b4\ub835\uc9c0": 76, "\uc5b4\uca0c\ub4e0": 78, "\uc5b4\ucc0c\ub410\ub4e0": 76, "\uc5b8\uae09\ud558\uaca0\ub2e4": 76, "\uc5b8\uae09\ud55c": 81, "\uc5b8\uc5b4\uc758": 76, "\uc5bc\ub9c8\ub098": 77, "\uc5bc\ub9cc\ud07c\uc758": 82, "\uc5c5\ub370\uc774\ud2b8": 77, "\uc5c5\ub370\uc774\ud2b8\uac00": 76, "\uc5c5\ub370\uc774\ud2b8\ub418\uac70\ub098": 76, "\uc5c5\ub370\uc774\ud2b8\ub418\uac8c": 77, "\uc5c5\ub370\uc774\ud2b8\ub418\uc5c8\ub294\uc9c0\ub97c": 77, "\uc5c5\ub370\uc774\ud2b8\ub41c\ub2e4": 78, "\uc5c5\ub370\uc774\ud2b8\ud558\ub294": [77, 78, 80], "\uc5c6\uace0": [78, 80], "\uc5c6\uae30": [76, 77, 78], "\uc5c6\ub294": [75, 76, 82], "\uc5c6\ub2e4": [77, 78, 81], "\uc5c6\uc73c\ubbc0\ub85c": [77, 80], "\uc5c6\uc774": [76, 78], "\uc5d0": 76, "\uc5d0\uc11c": [78, 82], "\uc5d0\uc120": 76, "\uc5d0\ud544\ub85c\uadf8": 83, "\uc5d4\uc9c4": 75, "\uc5d4\uc9c4\uc5d0\ub3c4": 75, "\uc5d4\uc9c4\uc740": 75, "\uc5d4\uc9c4\uc744": 75, "\uc5d4\uc9c4\uc758": 75, "\uc5d4\ud130": 75, "\uc5ec\uae30\uc11c": 77, "\uc5ec\uae30\uc5d0": 76, "\uc5ec\uae30\uc5d0\uc11c": 82, "\uc5ec\ub7ec": 75, "\uc5ec\ub7ec\uac00\uc9c0": 76, "\uc5ec\uc804\ud788": 79, "\uc5ec\uc9c0\uac00": 81, "\uc5f0\uacb0\uc2dc\ud0a4\uba74\uc11c": 82, "\uc5f0\uacb0\uc810\uc774": 75, "\uc601\uc5ed": 80, "\uc601\uc5ed\uacfc": 80, "\uc601\uc5ed\uc744": 80, "\uc601\uc5ed\uc774": 80, "\uc601\ud5a5\uc744": 82, "\uc601\ud654": 82, "\uc608\ub97c": [76, 79], "\uc608\uc2dc": 75, "\uc608\uc2dc\uc774\ub2e4": 82, "\uc608\uc678\uc801\uc73c\ub85c": 76, "\uc608\uc81c\uc778": 76, "\uc608\uce21\ub418\uae30": 77, "\uc624\uac8c": 76, "\uc624\uac8c\ub054": 76, "\uc624\ub2f5\uc774\ub77c\uba74": 81, "\uc624\ub2f5\uc77c": 81, "\uc624\ub798": 76, "\uc624\ub978\ucabd\uc774": 76, "\uc624\ube0c\uc81d\ud2b8\uac04": 78, "\uc624\ube0c\uc81d\ud2b8\uc758": 77, "\uc624\uc9c1": [79, 80], "\uc624\ud574\uc758": 80, "\uc640": [76, 77, 78, 80, 82], "\uc640\uc57c": 77, "\uc644\ubcbd\ud788": 82, "\uc644\uc131\ub418\uc5c8\ub2e4": 78, "\uc644\uc804\ud55c": 80, "\uc644\uc804\ud788": 78, "\uc65c": 78, "\uc65c\ub098\ud558\uba74": 76, "\uc65c\ub0d0\uba74": 78, "\uc65c\ub0d0\ud558\uba74": [77, 78], "\uc678\ubd80": 75, "\uc678\uc758": 76, "\uc694\uc18c": [78, 81], "\uc694\uc18c\ub97c": 76, "\uc694\uc57d\ud558\uc790\uba74": 75, "\uc6a9": 80, "\uc6a9\ub3c4\uac00": 79, "\uc6a9\uc774\ub2e4": 81, "\uc6b0\ub9ac\uac00": 77, "\uc6b0\ub9ac\ub294": [77, 78, 81, 82], "\uc6b0\ub9ac\uc758": 82, "\uc6b0\uc120": [76, 77, 78, 79, 81], "\uc6c0\uc9c1\uc774\uac8c": 77, "\uc6c0\uc9c1\uc774\ub294": 77, "\uc6c0\uc9c1\uc778\ub2e4": [77, 78], "\uc6c0\uc9c1\uc778\ub2e4\ub294": 78, "\uc6c0\uc9c1\uc77c\uae4c": 77, "\uc6d0\ub9ac\ub97c": 76, "\uc704": 79, "\uc704\uce58": [76, 79], "\uc704\uce58\uac00": 77, "\uc704\uce58\ub97c": 76, "\uc704\uce58\uc5d0\uc11c\uc758": 80, "\uc704\ud55c": [75, 76, 80, 81], "\uc704\ud574": [76, 78, 82], "\uc704\ud574\uc11c\ub294": 78, "\uc704\ud574\uc120": 76, "\uc708\ub3c4\uc6b0": 76, "\uc708\ub3c4\uc6b0\uc758": 77, "\uc720\ub2c8\ud2f0": 75, "\uc720\uc6a9\ud55c": 76, "\uc73c\ub85c": [75, 76], "\uc740": 77, "\uc744": [77, 78, 81], "\uc74c\uc545": 82, "\uc758": 75, "\uc758\ubbf8\ub97c": 80, "\uc758\ubbf8\ud558\uac8c": [77, 80], "\uc758\ubbf8\ud558\uace0": 78, "\uc758\ubbf8\ud558\uc9c0\ub294": 78, "\uc758\ubbf8\ud55c\ub2e4": [76, 77, 78], "\uc774": [75, 76, 77, 78, 79, 80, 81, 82], "\uc774\uac83\ub4e4\uc740": 79, "\uc774\uac83\uc740": [76, 77, 81], "\uc774\uac83\uc774": [75, 76, 82], "\uc774\ub294": [77, 78], "\uc774\ub2e4": 76, "\uc774\ub3d9": 83, "\uc774\ub780": 75, "\uc774\ub7f0": [75, 78], "\uc774\ub807\uac8c": 75, "\uc774\ub8e8\uc5b4\uc9c4\ub2e4": [76, 79], "\uc774\ub8e8\uc5b4\uc9d0\uc5d0": 78, "\uc774\ub97c": 77, "\uc774\ub984": 78, "\uc774\ub984\uc73c\ub85c\ub294": 78, "\uc774\ub984\uc744": 78, "\uc774\ub984\uc758": 76, "\uc774\ubbf8": 82, "\uc774\ubbf8\uc9c0": [77, 78, 81], "\uc774\ubca4\ud2b8\uac00": [76, 78], "\uc774\ubca4\ud2b8\ub4e4\uc740": 76, "\uc774\ubca4\ud2b8\ub4e4\uc744": 76, "\uc774\ubca4\ud2b8\ub4e4\uc758": 76, "\uc774\ubca4\ud2b8\ub97c": [76, 78, 80], "\uc774\ubca4\ud2b8\uc801": 75, "\uc774\ubcc4\uc744": 76, "\uc774\uc0c1": [75, 77], "\uc774\uc0c1\uc758": 78, "\uc774\uc5d0": 76, "\uc774\uc6a9\ud558\uba74": 77, "\uc774\uc6a9\ud55c": 75, "\uc774\uc6a9\ud560": 78, "\uc774\uc720\ub294": 80, "\uc774\uc720\uc774\ub2e4": [75, 78, 82], "\uc774\uc804": [77, 78], "\uc774\uc804\uacfc": 79, "\uc774\uc804\ubd80\ud130": 78, "\uc774\uc804\uc5d0\ub294": 78, "\uc774\uc804\uc758": [76, 78, 80], "\uc774\uc81c": [77, 78, 80, 81, 82], "\uc774\uc81c\ub294": 79, "\uc774\uc820": 77, "\uc774\ud574\ud558\ub294": 76, "\uc774\ud574\ud560": [78, 79], "\uc774\ud574\ud588\ub2e4\uba74": 76, "\uc774\ud6c4": 76, "\uc774\ud6c4\uc5d0": 76, "\uc778\uc790\ub97c": 78, "\uc778\ud130\ud398\uc774\uc2a4": 78, "\uc778\ud130\ud398\uc774\uc2a4\ub97c": 81, "\uc77c\ubc18\uc801\uc73c\ub85c": 76, "\uc77c\ubd80": [76, 77, 78], "\uc77c\ubd80\ubd84": 78, "\uc77c\ubd80\uc774\uae30": 75, "\uc77c\uc5b4\ub0ac\ub294\uc9c0": 80, "\uc77c\uc73c\ud0a4\ub294": 82, "\uc77c\uc885\uc758": 77, "\uc77c\uce58\ud558\uc9c0": 76, "\uc784\ub9c8\ub204\uc5d8": 82, "\uc784\uc740": 77, "\uc785\ub825": [75, 76, 77, 80], "\uc785\ub825\ubcf4\ub2e4": 82, "\uc785\ub825\uc2dc\ud0a4\ub294": 82, "\uc785\ub825\uc740": [75, 80], "\uc785\ub825\uc744": [78, 80], "\uc785\ub825\uc774": [77, 78], "\uc785\ub825\uc774\ub098": 77, "\uc785\ub825\uc774\ub780": 80, "\uc785\ub825\ud558\ub294": 78, "\uc785\ubb38\uc7a5\ubcbd\uc774": 75, "\uc788\uac8c": [75, 76], "\uc788\uace0": 79, "\uc788\uae30": 78, "\uc788\ub290\ub0d0": 78, "\uc788\ub294": [75, 76, 80, 81, 82], "\uc788\ub294\ub370": 79, "\uc788\ub2e4": [75, 76, 77, 78, 79, 80, 81, 82], "\uc788\ub2e4\uace0": 76, "\uc788\ub3c4\ub85d": 79, "\uc788\uc5b4\uc57c": 77, "\uc788\uc73c\uba74": 75, "\uc788\uc744\uae4c": [75, 76], "\uc788\uc74c": 80, "\uc788\uc74c\uc744": [77, 78, 80], "\uc790\ub3d9\uc801\uc73c\ub85c": [76, 77], "\uc790\uc8fc": 77, "\uc791\ub3d9": 76, "\uc791\ub3d9\ud558\uc9c0": 77, "\uc791\uc131\ub418\uc5b4\uc57c": 76, "\uc791\uc131\uc740": 81, "\uc791\uc131\ud558\ub294": 75, "\uc791\uc131\ud55c": 75, "\uc791\uc5c5\uc774": 76, "\uc791\uc740": [79, 80], "\uc7a5": 77, "\uc7a5\uc774": 77, "\uc7a5\uc810\ub3c4": 75, "\uc7a5\uc810\uc740": 75, "\uc7a5\uc810\uc744": 75, "\uc800\uae09": 75, "\uc800\uc7a5\ud574": 76, "\uc801\uc6a9\ub418\uc5b4": 80, "\uc801\uc808\ud55c": [76, 77, 78, 80], "\uc801\uc808\ud788": 76, "\uc804\uc138\uacc4": 82, "\uc804\uc5ed": 76, "\uc804\uccb4": [76, 81], "\uc804\uccb4\ub97c": 79, "\uc804\ud600": 78, "\uc808\ucc28\uc801\uc73c\ub85c": 75, "\uc808\ucc28\uc801\uc774": 75, "\uc810\uc218\ub3c4": 78, "\uc810\uc740": 80, "\uc811\uadfc\uc131\uc774": 75, "\uc811\uadfc\ud560": 75, "\uc815\ub2f5\uc774\uac70\ub098": 81, "\uc815\ub2f5\uc774\ub77c\uba74": 81, "\uc815\ub82c\ub41c\ub2e4": 76, "\uc815\ub9ac\ub97c": 77, "\uc815\ubcf4\ub4e4\uc740": 76, "\uc815\ubcf4\ub97c": 76, "\uc815\uc0ac\uac01\ud615": 80, "\uc815\uc0ac\uac01\ud615\uc744": 80, "\uc815\uc218": [79, 81], "\uc815\uc2e0\uc5c6\uc774": 77, "\uc815\uc758": 78, "\uc815\uc911\uc559\uc5d0": 76, "\uc815\uc911\uc559\uc73c\ub85c": 76, "\uc815\uc911\uc559\uc740": 76, "\uc815\uc911\uc559\uc744": 76, "\uc815\uc9c0\ub41c": 77, "\uc815\ud558\uace0": 76, "\uc815\ud558\ub294": 79, "\uc815\ud55c\ub2e4": 76, "\uc815\ud560": [76, 77], "\uc815\ud574\uc57c": 76, "\uc815\ud574\uc838\uc57c": 76, "\uc815\ud655\ud788\ub294": 76, "\uc81c\uacf5\ud558\uae30": 75, "\uc81c\uc57d\uc870\uac74": 78, "\uc81c\uc678\ud654\uba74": 75, "\uc81c\uc791": 75, "\uc81c\ud55c\uc744": 81, "\uc870\uac74\ubb38\uc774": 76, "\uc870\uac74\uc774": 76, "\uc870\uc808\ud558\uac8c": 79, "\uc870\uc885": 83, "\uc874\uc7ac\ud558\uace0": 80, "\uc874\uc7ac\ud558\uae30": 77, "\uc874\uc7ac\ud568\uc744": 80, "\uc885\ub8cc": 77, "\uc885\ub8cc\ub418\uac8c": 76, "\uc885\ub8cc\ub418\uace0": 78, "\uc885\ub8cc\ub418\uc5b4\uc57c": 76, "\uc885\ub8cc\ub41c": 76, "\uc885\ub8cc\ud558\uace0": 76, "\uc885\ub8cc\ud558\ub294": 77, "\uc885\ub958\uc758": 76, "\uc88b\ub2e4\ub294": 75, "\uc88b\uc740": [75, 80], "\uc88b\uc744": 79, "\uc88c\ud45c": 76, "\uc88c\ud45c\ub97c": [78, 79], "\uc88c\ud45c\uc5d0": 77, "\uc8fc\ub294": 75, "\uc8fc\ub85c": 76, "\uc8fc\ubaa9\ud574\ub77c": 78, "\uc8fc\uc5b4\uc9c4": 76, "\uc904\ub4e4\uc740": 78, "\uc911": [75, 77], "\uc911\uc694\ud55c": 82, "\uc990\uae38": 78, "\uc99d\uac00\uc2dc\ud0a4\uac70\ub098": 80, "\uc99d\uac00\ud558\uace0": 81, "\uc9c0\uae08\uae4c\uc9c0": 78, "\uc9c0\uae08\uc740": 78, "\uc9c0\ub294": 80, "\uc9c0\uc2dd\ub9cc\uc73c\ub85c": 82, "\uc9c0\uc2dd\ubcf4\ub2e4": 82, "\uc9c0\uc2dd\uc5d0": 82, "\uc9c0\uc2dd\uc744": 82, "\uc9c0\uc5d0": 81, "\uc9c0\uc6b0\ub294": 75, "\uc9c0\uc810\uc744": 80, "\uc9c1\uad00\uc801\uc73c\ub85c": 78, "\uc9c1\uad00\uc801\uc778": 78, "\uc9c1\uc0ac\uac01\ud615": 76, "\uc9c1\uc0ac\uac01\ud615\ub4e4\uc5d0": 79, "\uc9c1\uc0ac\uac01\ud615\ub4e4\uc744": 79, "\uc9c1\uc0ac\uac01\ud615\uc744": 79, "\uc9c1\uc811": 79, "\uc9c4\uc9dc": 78, "\uc9c4\ud589\ub420": 76, "\uc9c8": 81, "\uc9c8\ub9b0\ub2e4\uba74": 75, "\uc9d1\uc911\ud558\uba74": 75, "\uc9dc\uc99d\ub0a0": 81, "\ucc28\uc774\uc810\uc774": 78, "\ucc28\uc774\uc810\uc774\ub2e4": 78, "\ucc29\uc624\ub97c": 82, "\ucc38\uace0": [76, 77, 78, 79, 80, 81], "\ucc3d\uc758\uc801\uc778": 82, "\ucc3e\uc544\ub0b4\uba74": 77, "\ucc3e\uc744": 79, "\ucc44\ub85c": 78, "\ucc44\uc6b0\ub294": 76, "\ucc98\ub9ac": [75, 76, 78], "\ucc98\ub9ac\uac00": [76, 77], "\ucc98\ub9ac\ub294": 75, "\ucc98\ub9ac\ub97c": 79, "\ucc98\ub9ac\ub9cc\uc774": 80, "\ucc98\ub9ac\uc758": 76, "\ucc98\ub9ac\ud558\uace0": 76, "\ucc98\ub9ac\ud558\ub294": 80, "\ucc98\ub9ac\ud558\ub294\uc9c0\ub294": 77, "\ucc98\ub9ac\ud558\ub824\uba74": 81, "\ucc98\ub9ac\ud560": 76, "\ucc9c\uc7ac\uc131\uc774\ub780": 82, "\uccab\ubc88\uc9f8": 79, "\uccab\uc9f8": [75, 80], "\uccab\uc9f8\ub294": 78, "\uccab\uc9f8\ub85c": 76, "\uccb4\ud06c\ud558\ub294": 76, "\ucd08\uae30\ud654\ub418\uac70\ub098": 76, "\ucd08\uae30\ud654\ub41c\ub2e4": 76, "\ucd08\uae30\ud654\ub428\uc744": 77, "\ucd08\ub85d": 76, "\ucd1d": 79, "\ucd5c\ub300": 79, "\ucd5c\ub300\uac12\uc774": 79, "\ucd5c\ub300\ud55c": 75, "\ucd5c\uc18c": 76, "\ucd94\uac00": 77, "\ucd94\uac00\ub418\uba74": 81, "\ucd94\uac00\ub418\uc5c8\uace0": 77, "\ucd94\uac00\ub418\uc5c8\ub2e4": [77, 80], "\ucd94\uac00\ub41c": 76, "\ucd94\uac00\ub41c\ub2e4": 78, "\ucd94\uac00\uc801\uc73c\ub85c": 78, "\ucd94\uac00\uc801\uc778": [76, 77, 78, 79], "\ucd94\uac00\ud558\uac70\ub098": 76, "\ucd94\uac00\ud558\ub294": [76, 78], "\ucd94\uac00\ud558\ub824": 81, "\ucd94\uac00\ud574\ubcf4\uc790": 78, "\ucd94\uac00\ud574\uc57c": 77, "\ucd9c\ub825": [75, 78, 79, 81, 83], "\ucd9c\ub825\ub418\uac8c": 76, "\ucd9c\ub825\ub418\ub294": 76, "\ucd9c\ub825\ub420": 79, "\ucd9c\ub825\uc6a9\uc774\ub2e4": 80, "\ucd9c\ub825\uc73c\ub85c": 75, "\ucd9c\ub825\uc740": [75, 78], "\ucd9c\ub825\uc744": [76, 77, 80], "\ucd9c\ub825\uc758": 78, "\ucd9c\ub825\uc774": 82, "\ucd9c\ub825\ud558\uae30": 76, "\ucd9c\ub825\ud558\ub294": [76, 78, 79, 81], "\ucd9c\ub825\ud55c\ub2e4": 81, "\ucd9c\ub825\ud574\uc57c": 81, "\ucda9\ub3cc": 75, "\ucda9\ubd84\ud788": 79, "\uce58\uace4": 76, "\uce5c\uc219\ud55c": 76, "\uce60\ud558\uae30": 75, "\uce78\ud2b8\ub294": 82, "\uce94\ubc84\uc2a4": [76, 79], "\uce94\ubc84\uc2a4\ub97c": 76, "\uce94\ubc84\uc2a4\uc5d0": 76, "\uce94\ubc84\uc2a4\uc758": 76, "\ucea1\uc158\uc5d0": 76, "\ucee4\uc9c0\uac8c": 82, "\ucee8\ud150\uce20": 78, "\ucef4\ud4e8\ud130\ub294": 82, "\ucef4\ud4e8\ud130\ub9c8\ub2e4": 77, "\ucef4\ud4e8\ud130\uc5d0\uac8c": 82, "\ucf54\ub4dc": [76, 77, 78, 79, 80, 81], "\ucf54\ub4dc\uac00": 76, "\ucf54\ub4dc\ub97c": 75, "\ucf54\ub4dc\uc640": 76, "\ucf54\ub529\ud558\uac8c": 75, "\ucf54\ub529\ud574": 75, "\ucf58\uc194": 75, "\ucf58\uc194\uc5d0\uc11c": 75, "\ud06c\uac8c": [79, 81], "\ud06c\uace0": 76, "\ud06c\uae30": 76, "\ud06c\uae30\uac00": 76, "\ud06c\uae30\ub97c": [76, 81], "\ud06c\uae30\uc640": 76, "\ud06c\ub2e4\ub294": 82, "\ud06c\uba74": 77, "\ud070": [75, 78, 79, 80], "\ud074\uae4c": 82, "\ud074\ub9ad": 80, "\ud074\ub9ad\uc774": 80, "\ud074\ub9ad\ud588\ub2e4": 80, "\ud07c\uc744": 76, "\ud0a4": 78, "\ud0a4\ub294": 78, "\ud0a4\ub4e4\ub3c4": 78, "\ud0a4\ub97c": 78, "\ud0a4\ubcf4\ub4dc": [75, 78, 79], "\ud0a4\ubcf4\ub4dc\uac00": 80, "\ud0a4\ubcf4\ub4dc\uc5d0": 78, "\ud0a4\uc758": 78, "\ud0c4\ucc3d\uc5d0\uc11c": 79, "\ud14c\ub450\ub9ac\ub97c": [79, 81], "\ud14c\ud2b8\ub9ac\uc2a4\ub97c": 82, "\ud14d\uc2a4\ud2b8": [76, 83], "\ud14d\uc2a4\ud2b8\uac00": [76, 79], "\ud14d\uc2a4\ud2b8\ub294": 76, "\ud14d\uc2a4\ud2b8\ub97c": [76, 77, 79], "\ud14d\uc2a4\ud2b8\uc758": [76, 77], "\ud14d\uc2a4\ud2b8\uc774\ub2e4": 79, "\ud1b5\ud574": 80, "\ud22c\uc790\ud588\uc744\uae4c": 82, "\ud234\uc774": 75, "\ud29c\ud1a0\ub9ac\uc5bc": [15, 81], "\ud29c\ud1a0\ub9ac\uc5bc\uc740": 82, "\ud2b8\ub9ac\uac70": 78, "\ud2b8\ub9ac\uac70\ub418\uba74": 76, "\ud2b9\uc131": [76, 81], "\ud2b9\uc131\uc774": 82, "\ud2b9\uc131\uc774\ub2e4": 82, "\ud2b9\uc774\ud55c": 80, "\ud2b9\uc815": [76, 77, 80], "\ud2b9\uc815\ud55c": 80, "\ud30c\uc774\uac8c\uc784": [76, 81], "\ud30c\uc774\uac8c\uc784\uc740": [75, 76], "\ud30c\uc774\uac8c\uc784\uc744": 75, "\ud30c\uc774\uac8c\uc784\uc758": [75, 76, 77, 82], "\ud30c\uc774\uac8c\uc784\uc774": [75, 76], "\ud30c\uc774\uc36c\uc5d0": 75, "\ud30c\uc774\uc36c\uc758": [75, 76], "\ud30c\uc77c": 75, "\ud30c\uc77c\ub85c": 81, "\ud30c\uc77c\uc744": [75, 76], "\ud30c\uc77c\uc774\ub098": 75, "\ud30c\uc9c0\ud2b8\ub178\ud504\uac00": 82, "\ud310\ub2e8\ud558\ub294": 78, "\ud310\uc815": 80, "\ud3ec\ud568": 82, "\ud3ed\ub113\uc740": 82, "\ud3f0\ud2b8": 76, "\ud3f0\ud2b8\ub97c": 76, "\ud3f0\ud2b8\uc640": 76, "\ud479": 75, "\ud48d\uc131\ud558\uac8c": 78, "\ud504\ub85c\uadf8\ub798\uba38\uac00": 75, "\ud504\ub85c\uadf8\ub798\uba38\ub294": 75, "\ud504\ub85c\uadf8\ub798\ubc0d": 76, "\ud504\ub85c\uadf8\ub798\ubc0d\uacfc": 82, "\ud504\ub85c\uadf8\ub798\ubc0d\uc740": 82, "\ud504\ub85c\uadf8\ub798\ubc0d\uc758": 82, "\ud504\ub85c\uadf8\ub7a8": [76, 77], "\ud504\ub85c\uadf8\ub7a8\uacfc": 75, "\ud504\ub85c\uadf8\ub7a8\uc5d0": 81, "\ud504\ub85c\uadf8\ub7a8\uc5d0\uc120": 78, "\ud504\ub85c\uadf8\ub7a8\uc740": [81, 82], "\ud504\ub85c\uadf8\ub7a8\uc744": [76, 77, 79, 82], "\ud504\ub85c\uadf8\ub7a8\uc758": [75, 76, 78], "\ud504\ub85c\uadf8\ub7a8\uc774": 79, "\ud504\ub85c\uc81d\ud2b8": 77, "\ud504\ub85c\uc81d\ud2b8\uac00": [76, 78], "\ud504\ub85c\uc81d\ud2b8\ub294": [76, 77, 78], "\ud504\ub85c\uc81d\ud2b8\ub85c": 76, "\ud504\ub85c\uc81d\ud2b8\uc5d0": 77, "\ud504\ub85c\uc81d\ud2b8\uc5d0\uc11c": 76, "\ud504\ub85c\uc81d\ud2b8\uc640": 78, "\ud504\ub85c\uc81d\ud2b8\uc740": 75, "\ud504\ub85c\uc81d\ud2b8\uc758": [76, 77, 78], "\ud504\ub85c\uc81d\ud2b8\uc774\uba70": 76, "\ud504\ub864\ub85c\uadf8": 83, "\ud504\ub864\ub85c\uadf8\uc5d0\uc11c": 81, "\ud504\ub9b0\ud2b8": 80, "\ud50c\ub808\uc774": [78, 82], "\ud53c\ud0c0\uace0\ub77c\uc2a4": 77, "\ud544\uc218\uc870\uac74\uc774": 78, "\ud544\uc218\uc870\uac74\uc774\uae30": 78, "\ud544\uc694": [75, 76], "\ud544\uc694\ub3c4": 81, "\ud544\uc694\ub85c": 76, "\ud544\uc694\ud558\uac8c": 80, "\ud544\uc694\ud558\ub2e4": [76, 78], "\ud544\uc694\ud560": 77, "\ud558\uaca0\ub2e4": 79, "\ud558\uace0": 81, "\ud558\uae30": [76, 78], "\ud558\uae30\ub9cc": 79, "\ud558\ub098": 75, "\ud558\ub098\ub85c": 80, "\ud558\ub098\ub9cc": 81, "\ud558\ub098\uc758": [75, 76, 77, 79, 82], "\ud558\ub098\uc774\ub2e4": 77, "\ud558\ub294": [76, 77, 80], "\ud558\ub294\ub370": 80, "\ud558\ub294\uc9c0": 76, "\ud558\ub2e4": 75, "\ud558\uba74": [76, 77, 79], "\ud558\uc580": 79, "\ud558\uc580\uc0c9": 76, "\ud558\uc600\ub2e4": 79, "\ud558\uc9c0\ub9cc": [75, 76, 77, 79, 80, 82], "\ud55c": [77, 80, 82], "\ud55c\uad6d\uc5b4": 15, "\ud55c\ub2e4": [76, 77, 78, 79, 80, 81], "\ud55c\ubc88\ub9cc": 76, "\ud55c\ubc88\ucbe4\uc740": 75, "\ud560": [76, 77, 79, 82], "\ud560\uae4c": 79, "\ud560\ub2f9\ub41c": 76, "\ud568\uc218": [76, 77], "\ud568\uc218\uac00": [76, 77], "\ud568\uc218\ub294": [76, 77, 80, 81], "\ud568\uc218\ub4e4\uacfc": 75, "\ud568\uc218\ub4e4\uc740": [75, 76], "\ud568\uc218\ub4e4\uc744": [75, 76], "\ud568\uc218\ub4e4\uc774": 75, "\ud568\uc218\ub85c": 75, "\ud568\uc218\ub97c": [76, 79], "\ud568\uc218\ubcf4\ub2e4": 77, "\ud568\uc218\uc5d0\uc120": 79, "\ud568\uc218\uc640": [76, 77], "\ud568\uc218\uc758": 76, "\ud568\uc218\uc774\uae30": 76, "\ud568\uc218\uc774\ub2e4": 77, "\ud568\uc218\ud654": 78, "\ud568\uc218\ud654\ub97c": 79, "\ud56d\uc0c1": [75, 76, 78, 80], "\ud574": 75, "\ud574\uacb0\ud560": 75, "\ud574\ub2f9": 78, "\ud574\ub2f9\ub418\ub294": 77, "\ud574\uc11c": 81, "\ud574\uc57c": [76, 79], "\ud5f7\uac08\ub9ac\uba74": 76, "\ud604\uc7ac": 79, "\ud615\uc2dd\uc5d0": 76, "\ud615\uc2dd\uc744": 76, "\ud615\uc2dd\uc774": 76, "\ud638\ucd9c\ub418\ub294\ub370": 76, "\ud638\ucd9c\ub418\uba74": 76, "\ud638\ucd9c\ub418\uc5b4\uc57c": 76, "\ud638\ucd9c\ub41c\ub2e4": 76, "\ud638\ud658\uc131": 75, "\ud654\ub824\ud55c": 76, "\ud654\uba74": [76, 79], "\ud654\uba74\uacfc": 76, "\ud654\uba74\ubcf4\ub2e4\ub294": 77, "\ud654\uba74\ubcf4\ud638\uae30\ucc98\ub7fc": 77, "\ud654\uba74\uc744": [75, 77], "\ud654\uba74\uc758": 76, "\ud655\uc2e4\ud558\ub2e4": 77, "\ud655\uc778\ud558\ub294": [75, 79], "\ud655\uc778\ud558\ub77c": 80, "\ud655\uc778\ud558\uba74": [79, 80], "\ud655\uc778\ud560": [77, 78, 79], "\ud655\uc778\ud574\uc57c": 78, "\ud655\uc815\ub41c\ub2e4\uba74": 76, "\ud658\uacbd": 75, "\ud658\uacbd\uacfc": 75, "\ud658\uacbd\uc5d0\uc11c": 75, "\ud658\uacbd\uc5d0\uc11c\uc758": 75, "\ud658\uacbd\uc6a9": 75, "\ud658\uacbd\uc740": 75, "\ud65c\ub3d9\uc774\ub2e4": 82, "\ud65c\uc131\ud654\ub418\uba74": 80, "\ud65c\uc6a9\ud558\uace0": 82, "\ud65c\uc6a9\ud55c": 75, "\ud65c\uc6a9\ud574": 75, "\ud69f\uc218\ub97c": 77, "\ud6a8\uacfc\uac00": [80, 82], "\ud6a8\uacfc\ub97c": 81, "\ud6a8\uacfc\uc74c\uc744": 81, "\ud6c4": [75, 78], "\ud6e8\uc52c": 79, "\ud765\ubbf8\ub85c\uc6b4": 82}, "titles": ["pygame C API", "High level API exported by pygame.base", "Class BufferProxy API exported by pygame.bufferproxy", "Class Color API exported by pygame.color", "API exported by pygame.display", "API exported by pygame.event", "API exported by pygame._freetype", "API exported by pygame.mixer", "Class Rect API exported by pygame.rect", "API exported by pygame.rwobject", "Slots and c_api - Making functions and data available from other modules", "Class Surface API exported by pygame.surface", "API exported by pygame.surflock", "API exported by pygame.version", "File Path Function Arguments", "Pygame Front Page", "Pygame Logos Page", "pygame.BufferProxy", "pygame.camera", "pygame.cdrom", "pygame.Color", "Named Colors", "pygame.cursors", "pygame.display", "pygame.draw", "pygame.event", "pygame.examples", "pygame.fastevent", "pygame.font", "pygame.freetype", "pygame.gfxdraw", "pygame.image", "pygame.joystick", "pygame.key", "pygame.locals", "pygame.mask", "pygame.math", "pygame.midi", "pygame.mixer", "pygame.mouse", "pygame.mixer.music", "pygame.Overlay", "pygame.PixelArray", "pygame.pixelcopy", "pygame", "pygame.Rect", "pygame.scrap", "pygame._sdl2.controller", "pygame.sdl2_video", "pygame.sndarray", "pygame.sprite", "pygame.Surface", "pygame.surfarray", "pygame.tests", "pygame.time", "pygame._sdl2.touch", "pygame.transform", "Pygame Tutorials - Camera Module Introduction", "Pygame Tutorials - Line By Line Chimp Example", "Pygame Tutorials - Setting Display Modes", "Pygame Tutorials - Import and Initialize", "Making Games With Pygame", "Pygame Tutorials - Help! How Do I Move An Image?", "Pygame Intro", "Pygame Tutorials - Sprite Module Introduction", "Pygame Tutorials - Surfarray Introduction", "pygame/examples/chimp.py", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "Author: Youngwook Kim (Korean)", "\ud55c\uad6d\uc5b4 \ud29c\ud1a0\ub9ac\uc5bc", "A Newbie Guide to pygame", "Revision: Pygame fundamentals", "Kicking things off", "Game object classes", "User-controllable objects", "Putting it all together"], "titleterms": {"": 62, "1": [32, 61, 85, 86, 87, 88, 89], "2": [32, 62, 85, 86, 87, 89], "3": [85, 86, 88, 89], "360": 32, "4": [32, 85, 87], "5": [32, 85, 88], "6": 89, "A": [61, 62, 84, 87, 88], "AND": 63, "Be": 84, "By": 58, "Into": 68, "It": 62, "NO": 84, "On": [58, 62], "One": 62, "The": [58, 62, 64, 85, 86, 89], "There": 84, "To": 62, "With": 61, "_freetyp": 6, "_sdl2": [47, 55], "access": [42, 49, 52], "ad": 62, "advanc": [64, 65, 71, 72], "advic": 84, "all": [58, 62, 89], "alpha": [73, 84], "an": [17, 62], "anim": 69, "api": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13], "ar": [62, 84], "architectur": 84, "argument": 14, "arrai": [17, 43, 52], "audio": [19, 40], "author": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "avail": 10, "axi": 32, "back": 62, "background": [58, 62], "ball": [87, 89], "base": 1, "basic": [50, 57, 59, 68, 69, 70, 85], "bat": [88, 89], "blit": [62, 85], "bother": 84, "buffer": 17, "bufferproxi": 2, "bufferproxypygam": 17, "button": 72, "c": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12], "c_api": 10, "camera": [18, 57], "camerapygam": 18, "captur": 57, "cdrom": 19, "cdrompygam": 19, "center": 58, "chang": 62, "chimp": [58, 66], "class": [2, 3, 8, 11, 36, 50, 58, 64, 87, 88], "clipboard": 46, "close": 63, "code": 61, "collis": [64, 84], "color": [3, 20, 21], "colorkei": 84, "colorpygam": 20, "colorspac": 57, "com": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "comfort": 84, "common": [32, 64], "comput": [29, 57], "con": 32, "connect": 57, "constant": 34, "contact": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "contain": 44, "content": 61, "control": [19, 23, 32, 40, 47, 57, 88], "controllerpygam": 47, "convert": 84, "coordin": [45, 62], "copi": 43, "creat": [58, 62], "cursor": 22, "cursorspygam": 22, "da": 85, "data": [10, 49, 52], "decid": 59, "definit": 62, "design": 84, "detect": [64, 84], "direct": 42, "displai": [4, 23, 58, 59], "displaypygam": 23, "distract": 84, "divers": [87, 88], "do": [62, 84], "document": 15, "don": 84, "draw": [24, 30, 58], "drawpygam": 24, "driven": 68, "entir": 58, "epilog": 74, "event": [5, 25, 27, 58, 68, 70, 84, 85, 88], "eventpygam": 25, "everyth": 58, "exampl": [26, 58, 59, 65, 66], "examplesmodul": 26, "export": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 17], "extend": 64, "fasteventpygam": 27, "file": 14, "finish": [58, 89], "first": [62, 86], "font": [28, 29], "fontpygam": 28, "freetypeenhanc": 29, "friend": 84, "from": [10, 62], "front": 15, "function": [10, 14, 59, 62, 65, 71, 86], "fundament": 85, "game": [50, 58, 61, 63, 84, 85, 87], "gamepad": 32, "gener": 43, "get": 84, "gfxdrawpygam": 30, "gmail": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "go": 62, "graduat": 65, "graphic": 41, "group": 64, "gui": [68, 76], "guid": 84, "handl": [58, 62, 86], "help": 62, "here": 62, "hero": 62, "high": 1, "histori": [63, 64], "hit": 89, "how": [59, 62], "i": [62, 70, 84], "imag": [31, 35, 51, 57, 62], "imagepygam": 31, "import": [57, 58, 60, 65], "improv": 62, "inform": 44, "init": [57, 60], "initi": [58, 60], "input": [37, 55, 58, 62, 70], "interact": [25, 27, 32, 37], "interfac": 52, "intro": 63, "introduct": [57, 58, 59, 61, 63, 64, 65], "issu": 84, "joi": 32, "joystick": 32, "joystickpygam": 32, "just": 62, "keyboard": 33, "keypygam": 33, "kick": 86, "kim": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "know": 84, "korean": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "left": 32, "legaci": 16, "lesson": 64, "let": [62, 89], "level": [1, 44], "line": [58, 86], "list": [57, 62], "live": 57, "load": [28, 29, 38, 58, 86], "localspygam": 34, "lock": 65, "logo": 16, "loop": [58, 85], "main": 58, "make": [10, 61, 62], "manag": 84, "mani": 64, "map": [32, 62], "mask": [35, 57], "maskpygam": 35, "mathpygam": 36, "midi": 37, "midipygam": 37, "mix": 64, "mixer": [7, 40], "mixerpygam": 38, "mode": 59, "modul": [10, 18, 19, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32, 33, 35, 36, 37, 38, 39, 40, 43, 44, 46, 47, 49, 50, 52, 54, 55, 56, 57, 58, 63, 64, 86], "monitor": 54, "more": [62, 65], "mous": 39, "mousepygam": 39, "move": 62, "movement": 62, "multipl": 62, "musicpygam": 40, "mysteri": 62, "name": 21, "need": 84, "new": 70, "newbi": 84, "next": 62, "nintendo": 32, "note": 61, "numpi": 65, "object": [17, 20, 41, 42, 45, 50, 51, 58, 85, 87, 88], "obsolet": 84, "off": 86, "option": 84, "other": [10, 65], "outdat": 84, "output": [37, 68, 72], "over": 58, "overlai": 41, "overlaypygam": 41, "overview": 63, "own": [62, 64], "packag": [44, 53], "page": [15, 16], "part": 84, "path": 14, "pattern": 84, "perfect": 84, "physic": 87, "pixel": [42, 43, 52, 62, 84], "pixelarraypygam": 42, "pixelcopypygam": 43, "plai": 38, "playstat": 32, "plu": 73, "prepar": [58, 62], "pro": 32, "problem": 64, "process": [69, 71], "product": 89, "program": 26, "prolog": 67, "protocol": 17, "put": [58, 62, 89], "py": [13, 66], "pygam": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 15, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 84, 85, 88], "pygameth": 44, "python": [63, 84], "pythoni": 84, "queue": [25, 27], "quick": 15, "quit": 60, "realli": 84, "recogn": 84, "rect": [8, 84], "rectangular": 45, "rectpygam": 45, "refer": 15, "render": [28, 29, 64], "repres": 51, "represent": 20, "resourc": [22, 58, 86], "revis": 85, "right": 32, "rule": 84, "rumia0601": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "rwobject": 9, "sampl": 49, "scene": 58, "scrappygam": 46, "screen": [23, 62], "sdl2_video": 48, "set": [59, 69], "setup": 58, "shape": [24, 30], "side": [84, 89], "simpl": [87, 88], "singl": 57, "six": 84, "slot": 10, "smooth": 62, "sndarraypygam": 49, "so": 62, "softwar": 84, "some": 62, "sound": [38, 49], "sprite": [58, 64, 87], "spritepygam": 50, "src_c": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12], "src_py": 13, "start": 15, "step": 62, "store": 45, "stream": [40, 57], "style": 61, "subsystem": 84, "suit": 53, "support": 46, "surfac": [11, 17, 42, 52, 56, 65, 84], "surfacepygam": 51, "surfarrai": 65, "surfarraypygam": 52, "surflock": 12, "switch": 32, "t": 84, "ta": 85, "tabl": 61, "take": 62, "tast": 63, "templat": 68, "test": 53, "testspygam": 53, "text": 58, "them": 64, "thing": [84, 86], "threshold": 57, "through": 17, "time": [54, 62], "timepygam": 54, "togeth": [62, 64, 89], "top": 44, "touch": 55, "touchpygam": 55, "trackbal": 32, "transfer": 31, "transform": 56, "transformpygam": 56, "transpar": 65, "tutori": [15, 57, 58, 59, 60, 62, 64, 65], "type": 64, "unit": 53, "updat": 58, "us": [18, 52, 57, 84], "user": [62, 88], "v": 84, "vector": [36, 87], "version": [13, 44], "versionsmal": 44, "video": 41, "vision": 57, "wai": 84, "wari": 84, "what": [62, 84], "which": 84, "while": 58, "why": 67, "window": 23, "work": [33, 39, 47, 55, 84], "x": 32, "xbox": 32, "you": [62, 84], "youngwook": [67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82], "your": [62, 64, 84], "\uadf8\ub9ac\uace0": [79, 80, 81], "\uae30\ubc18\uacfc": 76, "\uae30\ubc18\uc73c\ub85c\uc758": 76, "\uae30\ubcf8": 76, "\uae30\ucd08": [76, 77, 78], "\ub354": 81, "\ubc84\ud2bc": 80, "\uc0c8\ub85c\uc6b4": 78, "\uc2ec\ud654": [79, 80], "\uc5d0\ud544\ub85c\uadf8": 82, "\uc65c": 75, "\uc6c0\uc9c1\uc774\uae30": 77, "\uc704\ud55c": 77, "\uc774\ubca4\ud2b8": [76, 78], "\uc785\ub825": 78, "\uc785\ub825\uc740": 78, "\uc785\ubb38": 76, "\uc870\uac74": 77, "\uc870\uae08": 81, "\ucc98\ub9ac": [77, 79], "\ucd9c\ub825": [76, 80], "\ud29c\ud1a0\ub9ac\uc5bc": 83, "\ud30c\uc774\uac8c\uc784": 75, "\ud504\ub864\ub85c\uadf8": 75, "\ud558\ud544": 75, "\ud55c\uad6d\uc5b4": 83, "\ud568\uc218\ud654": 79, "\ud615\uc2dd\uacfc": 76, "\ud654\uba74\uc774": 77}}) \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/chimp.py.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/chimp.py.html deleted file mode 100644 index 69f74e4..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/chimp.py.html +++ /dev/null @@ -1,343 +0,0 @@ - - - - - - - - pygame/examples/chimp.py — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    #!/usr/bin/env python
    -"""pygame.examples.chimp
    -
    -This simple example is used for the line-by-line tutorial
    -that comes with pygame. It is based on a 'popular' web banner.
    -Note there are comments here, but for the full explanation,
    -follow along in the tutorial.
    -"""
    -
    -# Import Modules
    -import os
    -
    -import pygame
    -
    -if not pygame.font:
    -    print("Warning, fonts disabled")
    -if not pygame.mixer:
    -    print("Warning, sound disabled")
    -
    -main_dir = os.path.split(os.path.abspath(__file__))[0]
    -data_dir = os.path.join(main_dir, "data")
    -
    -
    -# functions to create our resources
    -def load_image(name, colorkey=None, scale=1):
    -    fullname = os.path.join(data_dir, name)
    -    image = pygame.image.load(fullname)
    -    image = image.convert()
    -
    -    image = pygame.transform.scale_by(image, scale)
    -
    -    if colorkey is not None:
    -        if colorkey == -1:
    -            colorkey = image.get_at((0, 0))
    -        image.set_colorkey(colorkey, pygame.RLEACCEL)
    -    return image, image.get_rect()
    -
    -
    -def load_sound(name):
    -    class NoneSound:
    -        def play(self):
    -            pass
    -
    -    if not pygame.mixer.get_init():
    -        return NoneSound()
    -
    -    fullname = os.path.join(data_dir, name)
    -    sound = pygame.mixer.Sound(fullname)
    -
    -    return sound
    -
    -
    -# classes for our game objects
    -class Fist(pygame.sprite.Sprite):
    -    """moves a clenched fist on the screen, following the mouse"""
    -
    -    def __init__(self):
    -        pygame.sprite.Sprite.__init__(self)  # call Sprite initializer
    -        self.image, self.rect = load_image("fist.webp", -1)
    -        self.fist_offset = (-235, -80)
    -        self.punching = False
    -
    -    def update(self):
    -        """move the fist based on the mouse position"""
    -        pos = pygame.mouse.get_pos()
    -        self.rect.topleft = pos
    -        self.rect.move_ip(self.fist_offset)
    -        if self.punching:
    -            self.rect.move_ip(15, 25)
    -
    -    def punch(self, target):
    -        """returns true if the fist collides with the target"""
    -        if not self.punching:
    -            self.punching = True
    -            hitbox = self.rect.inflate(-5, -5)
    -            return hitbox.colliderect(target.rect)
    -
    -    def unpunch(self):
    -        """called to pull the fist back"""
    -        self.punching = False
    -
    -
    -class Chimp(pygame.sprite.Sprite):
    -    """moves a monkey critter across the screen. it can spin the
    -    monkey when it is punched."""
    -
    -    def __init__(self):
    -        pygame.sprite.Sprite.__init__(self)  # call Sprite initializer
    -        self.image, self.rect = load_image("chimp.webp", -1, 4)
    -        screen = pygame.display.get_surface()
    -        self.area = screen.get_rect()
    -        self.rect.topleft = 10, 90
    -        self.move = 18
    -        self.dizzy = False
    -
    -    def update(self):
    -        """walk or spin, depending on the monkeys state"""
    -        if self.dizzy:
    -            self._spin()
    -        else:
    -            self._walk()
    -
    -    def _walk(self):
    -        """move the monkey across the screen, and turn at the ends"""
    -        newpos = self.rect.move((self.move, 0))
    -        if not self.area.contains(newpos):
    -            if self.rect.left < self.area.left or self.rect.right > self.area.right:
    -                self.move = -self.move
    -                newpos = self.rect.move((self.move, 0))
    -                self.image = pygame.transform.flip(self.image, True, False)
    -        self.rect = newpos
    -
    -    def _spin(self):
    -        """spin the monkey image"""
    -        center = self.rect.center
    -        self.dizzy = self.dizzy + 12
    -        if self.dizzy >= 360:
    -            self.dizzy = False
    -            self.image = self.original
    -        else:
    -            rotate = pygame.transform.rotate
    -            self.image = rotate(self.original, self.dizzy)
    -        self.rect = self.image.get_rect(center=center)
    -
    -    def punched(self):
    -        """this will cause the monkey to start spinning"""
    -        if not self.dizzy:
    -            self.dizzy = True
    -            self.original = self.image
    -
    -
    -def main():
    -    """this function is called when the program starts.
    -    it initializes everything it needs, then runs in
    -    a loop until the function returns."""
    -    # Initialize Everything
    -    pygame.init()
    -    screen = pygame.display.set_mode((1280, 480), pygame.SCALED)
    -    pygame.display.set_caption("Monkey Fever")
    -    pygame.mouse.set_visible(False)
    -
    -    # Create The Background
    -    background = pygame.Surface(screen.get_size())
    -    background = background.convert()
    -    background.fill((170, 238, 187))
    -
    -    # Put Text On The Background, Centered
    -    font = pygame.Font(None, 64)
    -    text = font.render("Pummel The Chimp, And Win $$$", True, (10, 10, 10))
    -    textpos = text.get_rect(centerx=background.get_width() / 2, y=10)
    -    background.blit(text, textpos)
    -
    -    # Display The Background
    -    screen.blit(background, (0, 0))
    -    pygame.display.flip()
    -
    -    # Prepare Game Objects
    -    whiff_sound = load_sound("whiff.wav")
    -    punch_sound = load_sound("punch.wav")
    -    chimp = Chimp()
    -    fist = Fist()
    -    all_sprites = pygame.sprite.Group(chimp, fist)
    -    clock = pygame.Clock()
    -
    -    # Main Loop
    -    going = True
    -    while going:
    -        clock.tick(60)
    -
    -        # Handle Input Events
    -        for event in pygame.event.get():
    -            if event.type == pygame.QUIT:
    -                going = False
    -            elif event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE:
    -                going = False
    -            elif event.type == pygame.MOUSEBUTTONDOWN:
    -                if fist.punch(chimp):
    -                    punch_sound.play()  # punch
    -                    chimp.punched()
    -                else:
    -                    whiff_sound.play()  # miss
    -            elif event.type == pygame.MOUSEBUTTONUP:
    -                fist.unpunch()
    -
    -        all_sprites.update()
    -
    -        # Draw Everything
    -        screen.blit(background, (0, 0))
    -        all_sprites.draw(screen)
    -        pygame.display.flip()
    -
    -    pygame.quit()
    -
    -
    -# Game Over
    -
    -
    -# this calls the 'main' function when this script is executed
    -if __name__ == "__main__":
    -    main()
    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/chimp-explanation.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/chimp-explanation.html deleted file mode 100644 index 9932f4d..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/chimp-explanation.html +++ /dev/null @@ -1,578 +0,0 @@ - - - - - - - - Pygame Tutorials - Line By Line Chimp Example — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Line By Line Chimp

    -
    -
    Author:
    -

    Pete Shinners

    -
    -
    Contact:
    -

    pete@shinners.org

    -
    -
    -
    -
    -
    -

    Introduction

    -

    In the pygame examples there is a simple example named "chimp". -This example simulates a punchable monkey moving around the screen with -promises of riches and reward. The example itself is very simple, and a -bit thin on error-checking code. This example program demonstrates many of -pygame's abilities, like creating a window, loading images and sounds, -rendering text, and basic event and mouse handling.

    -

    The program and images can be found inside the standard source distribution -of pygame. You can run it by running python -m pygame.examples.chimp in -your terminal.

    -

    This tutorial will go through the code block by block. Explaining how -the code works. There will also be mention of how the code could be improved -and what error checking could help out.

    -

    This is an excellent tutorial for people getting their first look at -the pygame code. Once pygame is fully installed, you can find -and run the chimp demo for yourself in the examples directory.

    -
    -

    (no, this is not a banner ad, it's the screenshot)

    -chimp game banner -

    Full Source

    -
    -
    -
    -

    Import Modules

    -

    This is the code that imports all the needed modules into your program. -It also checks for the availability of some of the optional pygame modules.

    -
    # Import Modules
    -import os
    -import pygame
    -
    -main_dir = os.path.split(os.path.abspath(__file__))[0]
    -data_dir = os.path.join(main_dir, "data")
    -
    -
    -

    First, we import the standard "os" python module. This allow -us to do things like create platform independent file paths.

    -

    In the next line, we import the pygame package.

    -

    Lastly, we prepare two paths for the rest of the code to use. -main_dir uses the os.path module and the __file__ variable provided -by Python to locate the game's python file, and extract the folder from -that path. It then prepares the variable data_dir to tell the -loading functions exactly where to look.

    -
    -
    -

    Loading Resources

    -

    Here we have two functions we can use to load images and sounds. We will -look at each function individually in this section.

    -
    def load_image(name, colorkey=None, scale=1):
    -    fullname = os.path.join(data_dir, name)
    -    image = pygame.image.load(fullname)
    -    image = image.convert()
    -
    -    image = pygame.transform.scale_by(image, scale)
    -
    -    if colorkey is not None:
    -        if colorkey == -1:
    -            colorkey = image.get_at((0, 0))
    -        image.set_colorkey(colorkey, pygame.RLEACCEL)
    -    return image, image.get_rect()
    -
    -
    -

    This function takes the name of an image to load. It also optionally -takes an argument it can use to set a colorkey for the image, and an argument -to scale the image. A colorkey is used in graphics to represent a color of the -image that is transparent.

    -

    The first thing this function does is create a full pathname to the file. -In this example all the resources are in a "data" subdirectory. By using -the os.path.join function, a pathname will be created that works for whatever -platform the game is running on.

    -

    Next we load the image using the pygame.image.load()Load new image from a file (or file-like object). function. -After the image is loaded, we make an important -call to the convert() function. This makes a new copy of a Surface and converts -its color format and depth to match the display. This means blitting the -image to the screen will happen as quickly as possible.

    -

    We then scale the image, using the pygame.transform.scale_by()Resize to new resolution, using scalar(s). function. -This function takes a Surface and the scale factor it should be scaled of.

    -

    Last, we set the colorkey for the image. If the user supplied an argument -for the colorkey argument we use that value as the colorkey for the image. -This would usually just be a color RGB value, like (255, 255, 255) for -white. You can also pass a value of -1 as the colorkey. In this case the -function will lookup the color at the topleft pixel of the image, and use -that color for the colorkey.

    -
    def load_sound(name):
    -    class NoneSound:
    -        def play(self):
    -            pass
    -
    -    if not pygame.mixer.get_init():
    -        return NoneSound()
    -
    -    fullname = os.path.join(data_dir, name)
    -    sound = pygame.mixer.Sound(fullname)
    -
    -    return sound
    -
    -
    -

    Next is the function to load a sound file. The first thing this function -does is check to see if the pygame.mixerpygame module for loading and playing sounds module was initialized. -If not, it returns a small class instance that has a placeholder play method. -This will act enough like a normal Sound object for this game to run without -any extra error checking.

    -

    This function is similar to the image loading function, but handles some -different problems. First we create a full path to the sound image, and -load the sound file. Then we simply return the loaded Sound object.

    -
    -
    -

    Game Object Classes

    -

    Here we create two classes to represent the objects in our game. Almost -all the logic for the game goes into these two classes. We will look over -them one at a time here.

    -
    class Fist(pygame.sprite.Sprite):
    -    """moves a clenched fist on the screen, following the mouse"""
    -
    -    def __init__(self):
    -        pygame.sprite.Sprite.__init__(self)  # call Sprite initializer
    -        self.image, self.rect = load_image("fist.png", -1)
    -        self.fist_offset = (-235, -80)
    -        self.punching = False
    -
    -    def update(self):
    -        """move the fist based on the mouse position"""
    -        pos = pygame.mouse.get_pos()
    -        self.rect.topleft = pos
    -        self.rect.move_ip(self.fist_offset)
    -        if self.punching:
    -            self.rect.move_ip(15, 25)
    -
    -    def punch(self, target):
    -        """returns true if the fist collides with the target"""
    -        if not self.punching:
    -            self.punching = True
    -            hitbox = self.rect.inflate(-5, -5)
    -            return hitbox.colliderect(target.rect)
    -
    -    def unpunch(self):
    -        """called to pull the fist back"""
    -        self.punching = False
    -
    -
    -

    Here we create a class to represent the players fist. It is derived from -the Sprite class included in the pygame.spritepygame module with basic game object classes module. The __init__ function -is called when new instances of this class are created. The first thing -we do is be sure to call the __init__ function for our base class. This -allows the Sprite's __init__ function to prepare our object for use as a -sprite. This game uses one of the sprite drawing Group classes. These classes -can draw sprites that have an "image" and "rect" attribute. By simply changing -these two attributes, the renderer will draw the current image at the current -position.

    -

    All sprites have an update() method. This function is typically called -once per frame. It is where you should put code that moves and updates -the variables for the sprite. The update() method for the fist moves the -fist to the location of the mouse pointer. It also offsets the fist position -slightly if the fist is in the "punching" state.

    -

    The following two functions punch() and unpunch() change the punching -state for the fist. The punch() method also returns a true value if the fist -is colliding with the given target sprite.

    -
    class Chimp(pygame.sprite.Sprite):
    -    """moves a monkey critter across the screen. it can spin the
    -    monkey when it is punched."""
    -
    -    def __init__(self):
    -        pygame.sprite.Sprite.__init__(self)  # call Sprite initializer
    -        self.image, self.rect = load_image("chimp.webp", -1, 4)
    -        screen = pygame.display.get_surface()
    -        self.area = screen.get_rect()
    -        self.rect.topleft = 10, 90
    -        self.move = 18
    -        self.dizzy = False
    -
    -    def update(self):
    -        """walk or spin, depending on the monkeys state"""
    -        if self.dizzy:
    -            self._spin()
    -        else:
    -            self._walk()
    -
    -    def _walk(self):
    -        """move the monkey across the screen, and turn at the ends"""
    -        newpos = self.rect.move((self.move, 0))
    -        if not self.area.contains(newpos):
    -            if self.rect.left < self.area.left or self.rect.right > self.area.right:
    -                self.move = -self.move
    -                newpos = self.rect.move((self.move, 0))
    -                self.image = pygame.transform.flip(self.image, True, False)
    -        self.rect = newpos
    -
    -    def _spin(self):
    -        """spin the monkey image"""
    -        center = self.rect.center
    -        self.dizzy = self.dizzy + 12
    -        if self.dizzy >= 360:
    -            self.dizzy = False
    -            self.image = self.original
    -        else:
    -            rotate = pygame.transform.rotate
    -            self.image = rotate(self.original, self.dizzy)
    -        self.rect = self.image.get_rect(center=center)
    -
    -    def punched(self):
    -        """this will cause the monkey to start spinning"""
    -        if not self.dizzy:
    -            self.dizzy = True
    -            self.original = self.image
    -
    -
    -

    The Chimp class is doing a little more work than the fist, but nothing -more complex. This class will move the chimp back and forth across the -screen. When the monkey is punched, he will spin around to exciting effect. -This class is also derived from the base Sprite -class, and is initialized the same as the fist. While initializing, the class -also sets the attribute "area" to be the size of the display screen.

    -

    The update function for the chimp simply looks at the current "dizzy" -state, which is true when the monkey is spinning from a punch. It calls either -the _spin or _walk method. These functions are prefixed with an underscore. -This is just a standard python idiom which suggests these methods should -only be used by the Chimp class. We could go so far as to give them a double -underscore, which would tell python to really try to make them private -methods, but we don't need such protection. :)

    -

    The _walk method creates a new position for the monkey by moving the current -rect by a given offset. If this new position crosses outside the display -area of the screen, it reverses the movement offset. It also mirrors the -image using the pygame.transform.flip()Flip vertically and horizontally. function. This is a crude effect -that makes the monkey look like he's turning the direction he is moving.

    -

    The _spin method is called when the monkey is currently "dizzy". The dizzy -attribute is used to store the current amount of rotation. When the monkey -has rotated all the way around (360 degrees) it resets the monkey image -back to the original, non-rotated version. Before calling the -pygame.transform.rotate()Rotate an image. function, you'll see the code makes a local -reference to the function simply named "rotate". There is no need to do that -for this example, it is just done here to keep the following line's length a -little shorter. Note that when calling the rotate function, we are always -rotating from the original monkey image. When rotating, there is a slight loss -of quality. Repeatedly rotating the same image and the quality would get worse -each time. Also, when rotating an image, the size of the image will actually -change. This is because the corners of the image will be rotated out, making -the image bigger. We make sure the center of the new image matches the center -of the old image, so it rotates without moving.

    -

    The last method is punched() which tells the sprite to enter its dizzy -state. This will cause the image to start spinning. It also makes a copy -of the current image named "original".

    -
    -
    -

    Initialize Everything

    -

    Before we can do much with pygame, we need to make sure its modules -are initialized. In this case we will also open a simple graphics window. -Now we are in the main() function of the program, which actually runs everything.

    -
    pygame.init()
    -screen = pygame.display.set_mode((1280, 480), pygame.SCALED)
    -pygame.display.set_caption("Monkey Fever")
    -pygame.mouse.set_visible(False)
    -
    -
    -

    The first line to initialize pygame takes care of a bit of -work for us. It checks through the imported pygame modules and attempts -to initialize each one of them. It is possible to go back and check if modules -failed to initialize, but we won't bother here. It is also possible to -take a lot more control and initialize each specific module by hand. That -type of control is generally not needed, but is available if you desire.

    -

    Next we set up the display graphics mode. Note that the pygame.displayPygame module to control the display window and screen. -module is used to control all the display settings. In this case we are -asking for a 1280 by 480 window, with the SCALED display flag. -This automatically scales up the window for displays much larger than the -window.

    -

    Last we set the window title and turn off the mouse cursor for our -window. Very basic to do, and now we have a small black window ready to -do our bidding. Usually the cursor defaults to visible, so there is no need -to really set the state unless we want to hide it.

    -
    -
    -

    Create The Background

    -

    Our program is going to have text message in the background. It would -be nice for us to create a single surface to represent the background and -repeatedly use that. The first step is to create the surface.

    -
    background = pygame.Surface(screen.get_size())
    -background = background.convert()
    -background.fill((170, 238, 187))
    -
    -
    -

    This creates a new surface for us that is the same size as the display -window. Note the extra call to convert() after creating the Surface. The -convert with no arguments will make sure our background is the same format -as the display window, which will give us the fastest results.

    -

    We also fill the entire background with a certain green color. The fill() -function usually takes an RGB triplet as arguments, but supports many -input formats. See the pygame.ColorPygame object for color representations. for all the color formats.

    -
    -
    -

    Put Text On The Background, Centered

    -

    Now that we have a background surface, lets get the text rendered to it.

    -
    font = pygame.font.Font(None, 64)
    -text = font.render("Pummel The Chimp, And Win $$$", True, (10, 10, 10))
    -textpos = text.get_rect(centerx=background.get_width() / 2, y=10)
    -background.blit(text, textpos)
    -
    -
    -

    As you see, there are a couple steps to getting this done. First we -must create the font object and render it into a new surface. We then find -the center of that new surface and blit (paste) it onto the background.

    -

    The font is created with the font module's Font() constructor. Usually -you will pass the name of a TrueType font file to this function, but we -can also pass None, which will use a default font. The Font constructor -also needs to know the size of font we want to create.

    -

    We then render that font into a new surface. The render function creates -a new surface that is the appropriate size for our text. In this case -we are also telling render to create antialiased text (for a nice smooth -look) and to use a dark gray color.

    -

    Next we need to find the centered position of the text on our display. -We create a "Rect" object from the text dimensions, which allows us to -easily assign it to the screen center.

    -

    Finally we blit (blit is like a copy or paste) the text onto the background -image.

    -
    -
    -

    Display The Background While Setup Finishes

    -

    We still have a black window on the screen. Lets show our background -while we wait for the other resources to load.

    -
    screen.blit(background, (0, 0))
    -pygame.display.flip()
    -
    -
    -

    This will blit our entire background onto the display window. The -blit is self explanatory, but what about this flip routine?

    -

    In pygame, changes to the display surface are not immediately visible. -Normally, a display must be updated in areas that have changed for them -to be visible to the user. In this case the flip() function works nicely -because it simply handles the entire window area.

    -
    -
    -

    Prepare Game Object

    -

    Here we create all the objects that the game is going to need.

    -
    whiff_sound = load_sound("whiff.wav")
    -punch_sound = load_sound("punch.wav")
    -chimp = Chimp()
    -fist = Fist()
    -all_sprites = pygame.sprite.Group((chimp, fist))
    -clock = pygame.Clock()
    -
    -
    -

    First we load two sound effects using the load_sound function we defined -above. Then we create an instance of each of our sprite classes. And lastly -we create a sprite Group which will contain all -our sprites.

    -

    We create the group named "all_sprites" by passing a list with all the sprites that -should belong in the group. We could later on add or remove sprites from this -group, but in this game we won't need to.

    -

    The clock object we create will be used to help control our game's framerate. -we will use it in the main loop of our game to make sure it doesn't run too fast.

    -
    -
    -

    Main Loop

    -

    Nothing much here, just an infinite loop.

    -
    going = True
    -while going:
    -    clock.tick(60)
    -
    -
    -

    All games run in some sort of loop. The usual order of things is to -check on the state of the computer and user input, move and update the -state of all the objects, and then draw them to the screen. You'll see -that this example is no different.

    -

    We also make a call to our clock object, which will make sure our game -doesn't run faster than 60 frames per second.

    -
    -
    -

    Handle All Input Events

    -

    This is an extremely simple case of working the event queue.

    -
    for event in pygame.event.get():
    -    if event.type == pygame.QUIT:
    -        going = False
    -    elif event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE:
    -        going = False
    -    elif event.type == pygame.MOUSEBUTTONDOWN:
    -        if fist.punch(chimp):
    -            punch_sound.play()  # punch
    -            chimp.punched()
    -        else:
    -            whiff_sound.play()  # miss
    -    elif event.type == pygame.MOUSEBUTTONUP:
    -        fist.unpunch()
    -
    -
    -

    First we get all the available Events from pygame and loop through each -of them. The first two tests see if the user has quit our game, or pressed -the escape key. In these cases we just set going to False, allowing -us out of the infinite loop.

    -

    Next we just check to see if the mouse button was pressed or released. -If the button was pressed, we ask the fist object if it has collided with -the chimp. We play the appropriate sound effect, and if the monkey was hit, -we tell him to start spinning (by calling his punched() method).

    -
    -
    -

    Update the Sprites

    -
    all_sprites.update()
    -
    -
    -

    Sprite groups have an update() method, which simply calls the update method -for all the sprites it contains. Each of the objects will move around, depending -on which state they are in. This is where the chimp will move one step side -to side, or spin a little farther if he was recently punched.

    -
    -
    -

    Draw The Entire Scene

    -

    Now that all the objects are in the right place, time to draw them.

    -
    screen.blit(background, (0, 0))
    -all_sprites.draw(screen)
    -pygame.display.flip()
    -
    -
    -

    The first blit call will draw the background onto the entire screen. This -erases everything we saw from the previous frame (slightly inefficient, but -good enough for this game). Next we call the draw() method of the sprite -container. Lastly, we flip() the contentsof pygame's software double buffer -to the screen. This makes everything we've drawn visible all at once.

    -
    -
    -

    Game Over

    -

    User has quit, time to clean up.

    -
    pygame.quit()
    -
    -
    -

    Cleaning up the running game in pygame is extremely simple. -Since all variables are automatically destructed, we don't really have to do -anything, but calling pygame.quit() explicitly cleans up pygame's internals.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/display-modes.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/display-modes.html deleted file mode 100644 index 1eed273..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/display-modes.html +++ /dev/null @@ -1,318 +0,0 @@ - - - - - - - - Pygame Tutorials - Setting Display Modes — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Setting Display Modes

    -
    -
    Author:
    -

    Pete Shinners

    -
    -
    Contact:
    -

    pete@shinners.org

    -
    -
    -
    -

    Introduction

    -

    Setting the display mode in pygame creates a visible image surface -on the monitor. -This surface can either cover the full screen, or be windowed -on platforms that support a window manager. -The display surface is nothing more than a standard pygame surface object. -There are special functions needed in the pygame.displayPygame module to control the display window and screen. -module to keep the image surface contents updated on the monitor.

    -

    Setting the display mode in pygame is an easier task than with most -graphic libraries. -The advantage is if your display mode is not available, -pygame will emulate the display mode that you asked for. -Pygame will select a display resolution and color depth that best matches -the settings you have requested, -then allow you to access the display with the format you have requested. -In reality, since the pygame.displayPygame module to control the display window and screen. module is -a binding around the SDL library, SDL is really doing all this work.

    -

    There are advantages and disadvantages to setting the display mode in this -manner. -The advantage is that if your game requires a specific display mode, -your game will run on platforms that do not support your requirements. -It also makes life easier when you're getting something started, -it is always easy to go back later and make the mode selection a little more -particular. -The disadvantage is that what you request is not always what you will get. -There is also a performance penalty when the display mode must be emulated. -This tutorial will help you understand the different methods for querying -the platforms display capabilities, and setting the display mode for your game.

    -
    -
    -

    Setting Basics

    -

    The first thing to learn about is how to actually set the current display mode. -The display mode may be set at any time after the pygame.displayPygame module to control the display window and screen. -module has been initialized. -If you have previously set the display mode, -setting it again will change the current mode. -Setting the display mode is handled with the function -pygame.display.set_mode((width, height), flags, depth)Initialize a window or screen for display.. -The only required argument in this function is a sequence containing -the width and height of the new display mode. -The depth flag is the requested bits per pixel for the surface. -If the given depth is 8, pygame will create a color-mapped surface. -When given a higher bit depth, pygame will use a packed color mode. -Much more information about depths and color modes can be found in the -documentation for the display and surface modules. -The default value for depth is 0. -When given an argument of 0, pygame will select the best bit depth to use, -usually the same as the system's current bit depth. -The flags argument lets you control extra features for the display mode. -Again, more information about this is found in the pygame reference documents.

    -
    -
    -

    How to Decide

    -

    So how do you select a display mode that is going to work best with your -graphic resources and the platform your game is running on? -There are several methods for gathering information about the display device. -All of these methods must be called after the display module has been -initialized, but you likely want to call them before setting the display mode. -First, pygame.display.Info()Create a video display information object. -will return a special object type of VidInfo, -which can tell you a lot about the graphics driver capabilities. -The function -pygame.display.list_modes(depth, flags)Get list of available fullscreen modes. -can be used to find the supported graphic modes by the system. -pygame.display.mode_ok((width, height), flags, depth)Pick the best color depth for a display mode. takes the same arguments as -set_mode(), -but returns the closest matching bit depth to the one you request. -Lastly, pygame.display.get_driver()Get the name of the pygame display backend. -will return the name of the graphics driver selected by pygame.

    -

    Just remember the golden rule. -Pygame will work with pretty much any display mode you request. -Some display modes will need to be emulated, -which will slow your game down, -since pygame will need to convert every update you make to the -"real" display mode. The best bet is to always let pygame -choose the best bit depth, -and convert all your graphic resources to that format when they are loaded. -You let pygame choose its bit depth by calling -set_mode() -with no depth argument or a depth of 0, -or you can call -mode_ok() -to find a closest matching bit depth to what you need.

    -

    When your display mode is windowed, -you usually must match the same bit depth as the desktop. -When you are fullscreen, some platforms can switch to any bit depth that -best suits your needs. -You can find the depth of the current desktop if you get a VidInfo object -before ever setting your display mode.

    -

    After setting the display mode, -you can find out information about its settings by getting a VidInfo object, -or by calling any of the Surface.get* methods on the display surface.

    -
    -
    -

    Functions

    -

    These are the routines you can use to determine the most appropriate -display mode. -You can find more information about these functions in the display module -documentation.

    -
    -

    pygame.display.mode_ok(size, flags, depth)Pick the best color depth for a display mode.

    -
    -

    This function takes the exact same arguments as pygame.display.set_mode(). -It returns the best available bit depth for the mode you have described. -If this returns zero, -then the desired display mode is not available without emulation.

    -
    -

    pygame.display.list_modes(depth, flags)Get list of available fullscreen modes.

    -
    -

    Returns a list of supported display modes with the requested -depth and flags. -An empty list is returned when there are no modes. -The flags argument defaults to FULLSCREEN. -If you specify your own flags without FULLSCREEN, -you will likely get a return value of -1. -This means that any display size is fine, since the display will be windowed. -Note that the listed modes are sorted largest to smallest.

    -
    -

    pygame.display.Info()Create a video display information object.

    -
    -

    This function returns an object with many members describing -the display device. -Printing the VidInfo object will quickly show you all the -members and values for this object.

    -
    >>> import pygame.display
    ->>> pygame.display.init()
    ->>> info = pygame.display.Info()
    ->>> print(info)
    -<VideoInfo(hw = 0, wm = 1,video_mem = 0
    -        blit_hw = 0, blit_hw_CC = 0, blit_hw_A = 0,
    -        blit_sw = 0, blit_sw_CC = 0, blit_sw_A = 0,
    -        bitsize  = 32, bytesize = 4,
    -        masks =  (16711680, 65280, 255, 0),
    -        shifts = (16, 8, 0, 0),
    -        losses =  (0, 0, 0, 8),
    -        current_w = 1920, current_h = 1080
    ->
    -
    -
    -
    -
    -

    You can test all these flags as simply members of the VidInfo object.

    -
    -
    -

    Examples

    -

    Here are some examples of different methods to init the graphics display. -They should help you get an idea of how to go about setting your display mode.

    -
    >>> # give me the best depth with a 640 x 480 windowed display
    ->>> pygame.display.set_mode((640, 480))
    -
    ->>> # give me the biggest 16-bit display available
    ->>> modes = pygame.display.list_modes(16)
    ->>> if not modes:
    -...     print('16-bit not supported')
    -... else:
    -...     print('Found Resolution:', modes[0])
    -...     pygame.display.set_mode(modes[0], FULLSCREEN, 16)
    -
    ->>> # need an 8-bit surface, nothing else will do
    ->>> if pygame.display.mode_ok((800, 600), 0, 8) != 8:
    -...     print('Can only work with an 8-bit display, sorry')
    -... else:
    -...     pygame.display.set_mode((800, 600), 0, 8)
    -
    -
    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/import-init.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/import-init.html deleted file mode 100644 index 9103c3a..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/import-init.html +++ /dev/null @@ -1,201 +0,0 @@ - - - - - - - - Pygame Tutorials - Import and Initialize — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Import and Initialize

    -
    -
    Author:
    -

    Pete Shinners

    -
    -
    Contact:
    -

    pete@shinners.org

    -
    -
    -

    Getting pygame imported and initialized is a very simple process. It is also -flexible enough to give you control over what is happening. Pygame is a -collection of different modules in a single python package. Some of the -modules are written in C, and some are written in python. Some modules -are also optional, and might not always be present.

    -

    This is just a quick introduction on what is going on when you import pygame. -For a clearer explanation definitely see the pygame examples.

    -
    -

    Import

    -

    First we must import the pygame package. Since pygame version 1.4 this -has been updated to be much easier. Most games will import all of pygame like this.

    -
    import pygame
    -from pygame.locals import *
    -
    -
    -

    The first line here is the only necessary one. It imports all the available pygame -modules into the pygame package. The second line is optional, and puts a limited -set of constants and functions into the global namespace of your script.

    -

    An important thing to keep in mind is that several pygame modules are optional. -For example, one of these is the font module. When you "import pygame", pygame -will check to see if the font module is available. If the font module is available -it will be imported as "pygame.font". If the module is not available, "pygame.font" -will be set to None. This makes it fairly easy to later on test if the font module is available.

    -
    -
    -

    Init

    -

    Before you can do much with pygame, you will need to initialize it. The most common -way to do this is just make one call.

    -
    pygame.init()
    -
    -
    -

    This will attempt to initialize all the pygame modules for you. Not all pygame modules -need to be initialized, but this will automatically initialize the ones that do. You can -also easily initialize each pygame module by hand. For example to only initialize the -font module you would just call.

    -
    pygame.font.init()
    -
    -
    -

    Note that if there is an error when you initialize with "pygame.init()", it will silently fail. -When hand initializing modules like this, any errors will raise an exception. Any -modules that must be initialized also have a "get_init()" function, which will return true -if the module has been initialized.

    -

    It is safe to call the init() function for any module more than once.

    -
    -
    -

    Quit

    -

    Modules that are initialized also usually have a quit() function that will clean up. -There is no need to explicitly call these, as pygame will cleanly quit all the -initialized modules when python finishes.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-camera.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-camera.html deleted file mode 100644 index 69e94b2..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-camera.html +++ /dev/null @@ -1,382 +0,0 @@ - - - - - - - - Pygame Tutorials - Camera Module Introduction — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Camera Module Introduction

    -
    -
    Author:
    -

    by Nirav Patel

    -
    -
    Contact:
    -

    nrp@eclecti.cc

    -
    -
    -

    Pygame 1.9 comes with support for interfacing cameras, allowing you to capture -still images, watch live streams, and do some simple computer vision. This -tutorial will cover all of those use cases, providing code samples you can base -your app or game on. You can refer to the reference documentation -for the full API.

    -
    -

    Note

    -

    As of Pygame 1.9, the camera module offers native support for cameras -that use v4l2 on Linux. There is support for other platforms via OpenCV, -but this guide will focus on the native module. Most of the code will be -valid for other platforms, but certain things like controls will not work. -The module is also marked as EXPERIMENTAL, meaning the API could -change in subsequent versions.

    -
    -
    -

    Import and Init

    -
    import pygame
    -import pygame.camera
    -from pygame.locals import *
    -
    -pygame.init()
    -pygame.camera.init()
    -
    -
    -

    As the camera module is optional, it needs to be imported and initialized -manually as shown above.

    -
    -
    -

    Capturing a Single Image

    -

    Now we will go over the simplest case of opening a camera and capturing a frame -as a surface. In the below example, we assume that there is a camera at -/dev/video0 on the computer, and initialize it with a size of 640 by 480. -The surface called image is whatever the camera was seeing when get_image() was -called.

    -
    cam = pygame.camera.Camera("/dev/video0",(640,480))
    -cam.start()
    -image = cam.get_image()
    -
    -
    -
    -

    Listing Connected Cameras

    -

    You may be wondering, what if we don't know the exact path of the camera? -We can ask the module to provide a list of cameras attached to the -computer and initialize the first camera in the list.

    -
    camlist = pygame.camera.list_cameras()
    -if camlist:
    -    cam = pygame.camera.Camera(camlist[0],(640,480))
    -
    -
    -
    -
    -

    Using Camera Controls

    -

    Most cameras support controls like flipping the image and changing brightness. -set_controls() and get_controls() can be used at any point after using start().

    -
    cam.set_controls(hflip = True, vflip = False)
    -print camera.get_controls()
    -
    -
    -
    -
    -
    -

    Capturing a Live Stream

    -

    The rest of this tutorial will be based around capturing a live stream of -images. For this, we will be using the class below. As described, it will -simply blit a constant stream of camera frames to the screen, effectively -showing live video. It is basically what you would expect, looping get_image(), -blitting to the display surface, and flipping it. For performance reasons, -we will be supplying the camera with the same surface to use each time.

    -
    class Capture:
    -    def __init__(self):
    -        self.size = (640,480)
    -        # create a display surface. standard pygame stuff
    -        self.display = pygame.display.set_mode(self.size, 0)
    -
    -        # this is the same as what we saw before
    -        self.clist = pygame.camera.list_cameras()
    -        if not self.clist:
    -            raise ValueError("Sorry, no cameras detected.")
    -        self.cam = pygame.camera.Camera(self.clist[0], self.size)
    -        self.cam.start()
    -
    -        # create a surface to capture to.  for performance purposes
    -        # bit depth is the same as that of the display surface.
    -        self.snapshot = pygame.surface.Surface(self.size, 0, self.display)
    -
    -    def get_and_flip(self):
    -        # if you don't want to tie the framerate to the camera, you can check
    -        # if the camera has an image ready.  note that while this works
    -        # on most cameras, some will never return true.
    -        if self.cam.query_image():
    -            self.snapshot = self.cam.get_image(self.snapshot)
    -
    -        # blit it to the display surface.  simple!
    -        self.display.blit(self.snapshot, (0,0))
    -        pygame.display.flip()
    -
    -    def main(self):
    -        going = True
    -        while going:
    -            events = pygame.event.get()
    -            for e in events:
    -                if e.type == QUIT or (e.type == KEYDOWN and e.key == K_ESCAPE):
    -                    # close the camera safely
    -                    self.cam.stop()
    -                    going = False
    -
    -            self.get_and_flip()
    -
    -
    -

    Since get_image() is a blocking call that could take quite a bit of time on a -slow camera, this example uses query_image() to see if the camera is ready. -This allows you to separate the framerate of your game from that of your camera. -It is also possible to have the camera capturing images in a separate thread, -for approximately the same performance gain, if you find that your camera does -not support the query_image() function correctly.

    -
    -
    -

    Basic Computer Vision

    -

    By using the camera, transform, and mask modules, pygame can do some basic -computer vision.

    -
    -

    Colorspaces

    -

    When initializing a camera, colorspace is an optional parameter, with 'RGB', -'YUV', and 'HSV' as the possible choices. YUV and HSV are both generally more -useful for computer vision than RGB, and allow you to more easily threshold by -color, something we will look at later in the tutorial.

    -
    self.cam = pygame.camera.Camera(self.clist[0], self.size, "RGB")
    -
    -
    -../../_images/camera_rgb.jpg -
    self.cam = pygame.camera.Camera(self.clist[0], self.size, "YUV")
    -
    -
    -../../_images/camera_yuv.jpg -
    self.cam = pygame.camera.Camera(self.clist[0], self.size, "HSV")
    -
    -
    -../../_images/camera_hsv.jpg -
    -
    -

    Thresholding

    -

    Using the threshold() function from the transform module, one can do simple -green screen like effects, or isolate specifically colored objects in a scene. -In the below example, we threshold out just the green tree and make the rest -of the image black. Check the reference documentation for details on the -threshold function.

    -
    self.thresholded = pygame.surface.Surface(self.size, 0, self.display)
    -self.snapshot = self.cam.get_image(self.snapshot)
    -pygame.transform.threshold(self.thresholded,self.snapshot,(0,255,0),(90,170,170),(0,0,0),2)
    -
    -
    -../../_images/camera_thresholded.jpg -

    Of course, this is only useful if you already know the exact color of the object -you are looking for. To get around this and make thresholding usable in the -real world, we need to add a calibration stage where we identify the color of an -object and use it to threshold against. We will be using the average_color() -function of the transform module to do this. Below is an example calibration -function that you could loop until an event like a key press, and an image of -what it would look like. The color inside the box will be the one that is -used for the threshold. Note that we are using the HSV colorspace in the below -images.

    -
    def calibrate(self):
    -    # capture the image
    -    self.snapshot = self.cam.get_image(self.snapshot)
    -    # blit it to the display surface
    -    self.display.blit(self.snapshot, (0,0))
    -    # make a rect in the middle of the screen
    -    crect = pygame.draw.rect(self.display, (255,0,0), (145,105,30,30), 4)
    -    # get the average color of the area inside the rect
    -    self.ccolor = pygame.transform.average_color(self.snapshot, crect)
    -    # fill the upper left corner with that color
    -    self.display.fill(self.ccolor, (0,0,50,50))
    -    pygame.display.flip()
    -
    -
    -../../_images/camera_average.jpg -
    pygame.transform.threshold(self.thresholded,self.snapshot,self.ccolor,(30,30,30),(0,0,0),2)
    -
    -
    -../../_images/camera_thresh.jpg -

    You can use the same idea to do a simple green screen/blue screen, by first -getting a background image and then thresholding against it. The below example -just has the camera pointed at a blank white wall in HSV colorspace.

    -
    def calibrate(self):
    -    # capture a bunch of background images
    -    bg = []
    -    for i in range(0,5):
    -      bg.append(self.cam.get_image(self.background))
    -    # average them down to one to get rid of some noise
    -    pygame.transform.average_surfaces(bg,self.background)
    -    # blit it to the display surface
    -    self.display.blit(self.background, (0,0))
    -    pygame.display.flip()
    -
    -
    -../../_images/camera_background.jpg -
    pygame.transform.threshold(self.thresholded,self.snapshot,(0,255,0),(30,30,30),(0,0,0),1,self.background)
    -
    -
    -../../_images/camera_green.jpg -
    -
    -

    Using the Mask Module

    -

    The stuff above is great if you just want to display images, but with the -mask module, you can also use a camera as an -input device for a game. For example, going back to the example of -thresholding out a specific object, we can find the position of that object and -use it to control an on screen object.

    -
    def get_and_flip(self):
    -    self.snapshot = self.cam.get_image(self.snapshot)
    -    # threshold against the color we got before
    -    mask = pygame.mask.from_threshold(self.snapshot, self.ccolor, (30, 30, 30))
    -    self.display.blit(self.snapshot,(0,0))
    -    # keep only the largest blob of that color
    -    connected = mask.connected_component()
    -    # make sure the blob is big enough that it isn't just noise
    -    if mask.count() > 100:
    -        # find the center of the blob
    -        coords = mask.centroid()
    -        # draw a circle with size variable on the size of the blob
    -        pygame.draw.circle(self.display, (0,255,0), coords, max(min(50,mask.count()/400),5))
    -    pygame.display.flip()
    -
    -
    -../../_images/camera_mask.jpg -

    This is just the most basic example. You can track multiple different colored -blobs, find the outlines of objects, have collision detection between real life -and in game objects, get the angle of an object to allow for even finer control, -and more. Have fun!

    -
    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-pygame.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-pygame.html deleted file mode 100644 index b7e00d5..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-pygame.html +++ /dev/null @@ -1,419 +0,0 @@ - - - - - - - - Pygame Intro — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Python Pygame Introduction

    -
    -
    Author:
    -

    Pete Shinners

    -
    -
    Contact:
    -

    pete@shinners.org

    -
    -
    -

    This article is an introduction to the pygame library -for Python programmers. -The original version appeared in the PyZine volume 1 issue 3. -This version contains minor revisions, to -create an all-around better article. Pygame is a Python extension -library that wraps the SDL library -and its helpers.

    -
    -

    HISTORY

    -

    Pygame started in the summer of 2000. Being a C programmer of many -years, I discovered both Python and SDL at about the same time. You are -already familiar with Python, which was at version 1.5.2. You may need -an introduction to SDL, which is the Simple DirectMedia Layer. -Created by Sam Lantinga, SDL is a cross-platform C library for -controlling multimedia, comparable to DirectX. It has been used for -hundreds of commercial and open source games. I was impressed at how clean -and straightforward both projects were and it wasn't long before I -realized mixing Python and SDL was an interesting proposal.

    -

    I discovered a small project already under-way with exactly the same -idea, PySDL. Created by Mark Baker, PySDL was a straightforward -implementation of SDL as a Python extension. The interface was cleaner -than a generic SWIG wrapping, but I felt it forced a "C style" of code. -The sudden death of PySDL prompted me to take on a new project of my -own.

    -

    I wanted to put together a project that really took advantage of -Python. My goal was to make it easy to do the simple things, and -straightforward to do the difficult things. Pygame was started in -October, 2000. Six months later pygame version 1.0 was released.

    -
    -
    -

    TASTE

    -

    I find the best way to understand a new library is to jump straight -into an example. In the early days of pygame, I created a bouncing ball -animation with 7 lines of code. Let's take a look at a friendlier -version of that same thing. This should be simple enough to follow -along, and a complete breakdown follows.

    -../../_images/intro_ball.webp -
     1import sys, pygame
    - 2pygame.init()
    - 3
    - 4size = width, height = 320, 240
    - 5speed = [2, 2]
    - 6black = 0, 0, 0
    - 7
    - 8screen = pygame.display.set_mode(size)
    - 9
    -10ball = pygame.image.load("intro_ball.webp")
    -11ballrect = ball.get_rect()
    -12
    -13while True:
    -14    for event in pygame.event.get():
    -15        if event.type == pygame.QUIT: sys.exit()
    -16
    -17    ballrect = ballrect.move(speed)
    -18    if ballrect.left < 0 or ballrect.right > width:
    -19        speed[0] = -speed[0]
    -20    if ballrect.top < 0 or ballrect.bottom > height:
    -21        speed[1] = -speed[1]
    -22
    -23    screen.fill(black)
    -24    screen.blit(ball, ballrect)
    -25    pygame.display.flip()
    -
    -
    -

    This is as simple as you can get for a bouncing animation. -First we see importing and initializing pygame is nothing noteworthy. -The import pygame imports the package with all the available -pygame modules. -The call to pygame.init() initializes each of these modules.

    -

    On line 8 we create a -graphical window with the call to pygame.display.set_mode(). -Pygame and SDL make this easy by defaulting to the best graphics modes -for the graphics hardware. You can override the mode and SDL will -compensate for anything the hardware cannot do. Pygame represents -images as Surface objects. -The display.set_mode() function creates a new Surface -object that represents the actual displayed graphics. Any drawing you -do to this Surface will become visible on the monitor.

    -

    At line 10 we load -our ball image. Pygame supports a variety of image formats through the -SDL_image library, including BMP, JPG, PNG, TGA, and GIF. -The pygame.image.load() function -returns us a Surface with the ball data. The Surface will keep any -colorkey or alpha transparency from the file. After loading the ball -image we create a variable named ballrect. Pygame comes with a -convenient utility object type named Rect, -which represents a rectangular area (which can be used to manage the position of an -object in the screen).

    -

    At this point, line 13, -our program is initialized and ready to run. Inside an infinite loop we -check for user input, move the ball, and then draw the ball. If you are -familiar with GUI programming, you have had experience with events and -event loops. In pygame this is no different, -we check if a QUIT event has happened. If so we -simply exit the program, pygame will ensure everything is cleanly -shutdown.

    -

    It is time to update our position for the ball. -Lines 17 moves the ballrect variable by the current speed. -Lines 18 thru 21 reverse the speed if the ball has moved outside the screen. -Not exactly Newtonian physics, but it is all we need.

    -

    On line 23 we erase -the screen by filling it with a black RGB color. If you have never -worked with animations this may seem strange. You may be asking "Why do -we need to erase anything, why don't we just move the ball on the -screen?" That is not quite the way computer animation works. Animation -is nothing more than a series of single images, which when displayed in -sequence do a very good job of fooling the human eye into seeing -motion. The screen is just a single image that the user sees. If we did -not take the time to erase the ball from the screen, we would actually -see a "trail" of the ball as we continuously draw the ball in its new -positions.

    -

    On line 24 we draw the ball image onto the screen. -Drawing of images is handled by the -Surface.blit() method. -A blit basically means copying pixel colors from one image to another. -We pass the blit method a source Surface -to copy from, and a position (which can be a Rect object or a pair of numbers e.g. (50.0, 25.0)), to place the source onto the destination.

    -

    The last thing we need to do is actually update the visible display. -Pygame manages the display with a double buffer. When we are finished -drawing we call the pygame.display.flip()Update the full display Surface to the screen. method. -This makes everything we have drawn on the screen Surface -become visible. This buffering makes sure we only see completely drawn -frames on the screen. Without it, the user would see the half completed -parts of the screen as they are being created.

    -

    That concludes this short introduction to pygame. Pygame also has -modules to do things like input handling for the keyboard, mouse, and -joystick. It can mix audio and decode streaming music. -With the Surfaces you can draw simple -shapes, rotate and scale the picture, and even manipulate the pixels of -an image in realtime as numpy arrays. -Pygame also has the ability to act as a -cross platform display layer for PyOpenGL. Most of the pygame modules -are written in C, few are actually done in Python.

    -

    The pygame website has full reference documentation for every pygame -function and tutorials for all ranges of users. The pygame source comes -with many examples of things like monkey punching and UFO shooting.

    -
    -
    -

    PYTHON AND GAMING

    -

    "Is Python suitable for gaming?" The answer is, "It depends on the -game."

    -

    Python is actually quite capable at running games. It will likely even -surprise you how much is possible in under 30 milliseconds. Still, it -is not hard to reach the ceiling once your game begins to get more -complex. Any game running in realtime will be making full use of the -computer.

    -../../_images/intro_blade.jpg -

    Over the past several years there has been an interesting trend in game development, -the move towards higher level languages. Usually a game is split into -two major parts. The game engine, which must be as fast as possible, -and the game logic, which makes the engine actually do something. It -wasn't long ago when the engine of a game was written in assembly, with -portions written in C. Nowadays, C has moved to the game engine, while -often the game itself is written in higher level scripting languages. -Games like Quake3 and Unreal run these scripts as portable bytecode.

    -

    In early 2001, developer Rebel Act Studios finished their game, -Severance: Blade of Darkness. Using their own custom 3D engine, the -rest of the game is written with Python. The game is a bloody action -3rd person perspective fighter. You control medieval warriors into -intricate decapitating combination attacks while exploring dungeons and -castles. You can download third party add-ons for this game, and find -they are nothing more than Python source files.

    -

    More recently, Python has been used in a variety of games like Freedom -Force, and Humungous' Backyard Sports Series.

    -../../_images/intro_freedom.jpg -

    Pygame and SDL serve as an excellent C engine for 2D games. -Games will still find the largest part of their runtime is spent -inside SDL handling the graphics. -SDL can take advantage of graphics hardware acceleration. -Enabling this can change a game from running around 40 frames per -second to over 200 frames per second. When you see your Python game -running at 200 frames per second, you realize that Python and games can -work together.

    -

    It is impressive how well both Python and SDL work on multiple -platforms. For example, in May of 2001 I released my own full pygame -project, SolarWolf, an arcade style action game. One thing that has -surprised me is that one year later there has been no need for any -patches, bug fixes, or updates. The game was developed entirely on -windows, but runs on Linux, Mac OSX, and many Unixes without any extra -work on my end.

    -

    Still, there are very clear limitations. The best way to manage -hardware accelerated graphics is not always the way to get fastest -results from software rendering. Hardware support is not available on -all platforms. When a game gets more complex, it often must commit to -one or the other. SDL has some other design limitations, things like -full screen scrolling graphics can quickly bring your game down to -unplayable speeds. While SDL is not suitable for all types of games, -remember companies like Loki have used SDL to run a wide variety of -retail quality titles.

    -

    Pygame is fairly low-level when it comes to writing games. You'll -quickly find yourself needing to wrap common functions into your own -game environment. The great thing about this is there is nothing inside -pygame to get in your way. Your program is in full control of -everything. The side effect of that is you will find yourself borrowing -a lot of code to get a more advanced framework put together. You'll -need a better understanding of what you are doing.

    -
    -
    -

    CLOSING

    -

    Developing games is very rewarding, there is something exciting about -being able to see and interact with the code you've written. Pygame -currently has almost 30 other projects using it. Several of them are -ready to play now. You may be surprised to visit the pygame website, -and see what other users have been able to do with Python.

    -

    One thing that has caught my attention is the amount of people coming -to Python for the first time to try game development. I can see why -games are a draw for new programmers, but it can be difficult since -creating games requires a firmer understanding of the language. I've -tried to support this group of users by writing many examples and -pygame tutorials for people new to these concepts.

    -

    In the end, my advice is to keep it simple. I cannot stress this -enough. If you are planning to create your first game, there is a -lot to learn. Even a simpler game will challenge your designs, and -complex games don't necessarily mean fun games. When you understand -Python, you can use pygame to create a simple game in only one or two -weeks. From there you'll need a surprising amount of time to add -the polish to make that into a full presentable game.

    -
    -

    Pygame Modules Overview

    - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

    cursors

    load cursor images, includes standard cursors

    display

    control the display window or screen

    draw

    draw simple shapes onto a Surface

    event

    manage events and the event queue

    font

    create and render TrueType fonts

    image

    save and load images

    joystick

    manage joystick devices

    key

    manage the keyboard

    mouse

    manage the mouse

    sndarray

    manipulate sounds with numpy

    surfarray

    manipulate images with numpy

    time

    control timing

    transform

    scale, rotate, and flip images

    -
    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-sprites.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-sprites.html deleted file mode 100644 index 4ad5939..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-sprites.html +++ /dev/null @@ -1,467 +0,0 @@ - - - - - - - - Pygame Tutorials - Sprite Module Introduction — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Sprite Module Introduction

    -
    -
    Author:
    -

    Pete Shinners

    -
    -
    Contact:
    -

    pete@shinners.org

    -
    -
    -

    Pygame version 1.3 comes with a new module, pygame.sprite. This module is -written in Python and includes some higher-level classes to manage your game -objects. By using this module to its full potential, you can easily manage and -draw your game objects. The sprite classes are very optimized, so it's likely -your game will run faster with the sprite module than without.

    -

    The sprite module is also meant to be very generic. It turns out you can use it -with nearly any type of gameplay. All this flexibility comes with a slight -penalty, it needs a little understanding to properly use it. The -reference documentation for the sprite module can keep -you running, but you'll probably need a bit more explanation of how to use -pygame.sprite in your own game.

    -

    Several of the pygame examples (like "chimp" and "aliens") have been updated to -use the sprite module. You may want to look into those first to see what this -sprite module is all about. The chimp module even has its own line-by-line -tutorial, which may help get more an understanding of programming with python -and pygame.

    -

    Note that this introduction will assume you have a bit of experience -programming with python, and are somewhat familiar with the different parts of -creating a simple game. In this tutorial the word "reference" is occasionally -used. This represents a python variable. Variables in python are references, -so you can have several variables all pointing to the same object.

    -
    -

    History Lesson

    -

    The term "sprite" is a holdover from older computer and game machines. These -older boxes were unable to draw and erase normal graphics fast enough for them -to work as games. These machines had special hardware to handle game like -objects that needed to animate very quickly. These objects were called -"sprites" and had special limitations, but could be drawn and updated very -fast. They usually existed in special overlay buffers in the video. These days -computers have become generally fast enough to handle sprite like objects -without dedicated hardware. The term sprite is still used to represent just -about anything in a 2D game that is animated.

    -
    -
    -

    The Classes

    -

    The sprite module comes with two main classes. The first is Sprite, which should be used as a base class for all your game -objects. This class doesn't really do anything on its own, it just includes -several functions to help manage the game object. The other type of class is -Group. The Group class is a container for -different Sprite objects. There are actually several different types of -group classes. Some of the Groups can draw all the elements they contain, -for example.

    -

    This is all there really is to it. We'll start with a description of what each -type of class does, and then discuss the proper ways to use these two classes.

    -
    -
    -

    The Sprite Class

    -

    As mentioned before, the Sprite class is designed to be a base class for all -your game objects. You cannot really use it on its own, as it only has several -methods to help it work with the different Group classes. The sprite keeps -track of which groups it belongs to. -The class constructor (__init__ method) takes an argument of a -Group (or list of Groups) the Sprite instance should belong to. -You can also change the Group membership for the Sprite with the -add() and -remove() methods. -There is also a groups() method, -which returns a list of the current groups containing the sprite.

    -

    When using the your Sprite classes it's best to think of them as "valid" or -"alive" when they are belonging to one or more Groups. When you remove the -instance from all groups pygame will clean up the object. (Unless you have your -own references to the instance somewhere else.) The kill() method removes the sprite from all groups it -belongs to. This will cleanly delete the sprite object. If you've put some -little games together, you'll know sometimes cleanly deleting a game object can -be tricky. The sprite also comes with an alive() method, which returns true if it is still a -member of any groups.

    -
    -
    -

    The Group Class

    -

    The Group class is just a simple container. Similar to the sprite, it has -an add() and remove() method which can change which sprites belong to -the group. You also can pass a sprite or list of sprites to the constructor -(__init__() method) to create a Group instance that contains some -initial sprites.

    -

    The Group has a few other methods like empty() to remove all sprites from the group and -copy() which will return a copy of the group -with all the same members. Also the has() -method will quickly check if the Group contains a sprite or list of -sprites.

    -

    The other function you will use frequently is the sprites() method. This returns an object that can be -looped on to access every sprite the group contains. Currently this is just a -list of the sprites, but in later version of python this will likely use -iterators for better performance.

    -

    As a shortcut, the Group also has an update() method, which will call an update() method on -every sprite in the group. Passing the same arguments to each one. Usually in a -game you need some function that updates the state of a game object. It's very -easy to call your own methods using the Group.sprites() method, but this is -a shortcut that's used enough to be included. Also note that the base -Sprite class has a placeholder update() method that takes any sort of -arguments and does nothing.

    -

    Lastly, the Group has a couple other methods that allow you to use it with -the builtin len() function, getting the number of sprites it contains, and -the "truth" operator, which allows you to do "if mygroup:" to check if the -group has any sprites.

    -
    -
    -

    Mixing Them Together

    -

    At this point the two classes seem pretty basic. Not doing a lot more than you -can do with a simple list and your own class of game objects. But there are -some big advantages to using the Sprite and Group together. A sprite -can belong to as many groups as you want. Remember as soon as it belongs to no -groups, it will usually be cleared up (unless you have other "non-group" -references to that object).

    -

    The first big thing is a fast simple way to categorize sprites. For example, -say we had a Pacman-like game. We could make separate groups for the different -types of objects in the game. Ghosts, Pac, and Pellets. When Pac eats a power -pellet, we can change the state for all ghost objects by effecting everything -in the Ghost group. This is quicker and simpler than looping through a list -of all the game objects and checking which ones are ghosts.

    -

    Adding and removing groups and sprites from each other is a very fast -operation, quicker than using lists to store everything. Therefore you can very -efficiently change group memberships. Groups can be used to work like simple -attributes for each game object. Instead of tracking some attribute like -"close_to_player" for a bunch of enemy objects, you could add them to a -separate group. Then when you need to access all the enemies that are near the -player, you already have a list of them, instead of going through a list of all -the enemies, checking for the "close_to_player" flag. Later on your game could -add multiple players, and instead of adding more "close_to_player2", -"close_to_player3" attributes, you can easily add them to different groups for -each player.

    -

    Another important benefit of using the Sprites and Groups is that the groups -cleanly handle the deleting (or killing) of game objects. In a game where many -objects are referencing other objects, sometimes deleting an object can be the -hardest part, since it can't go away until it is not referenced by anyone. Say -we have an object that is "chasing" another object. The chaser can keep a -simple Group that references the object (or objects) it is chasing. If the -object being chased happens to be destroyed, we don't need to worry about -notifying the chaser to stop chasing. The chaser can see for itself that its -group is now empty, and perhaps find a new target.

    -

    Again, the thing to remember is that adding and removing sprites from groups is -a very cheap/fast operation. You may be best off by adding many groups to -contain and organize your game objects. Some could even be empty for large -portions of the game, there isn't any penalties for managing your game like -this.

    -
    -
    -

    The Many Group Types

    -

    The above examples and reasons to use Sprites and Groups are only a tip -of the iceberg. Another advantage is that the sprite module comes with several -different types of Groups. These groups all work just like a regular old -Group, but they also have added functionality (or slightly different -functionality). Here's a list of the Group classes included with the -sprite module.

    -
    -

    Group

    -
    -

    This is the standard "no frills" group mainly explained above. Most of the -other Groups are derived from this one, but not all.

    -
    -

    GroupSingle

    -
    -

    This works exactly like the regular Group class, but it only contains -the most recently added sprite. Therefore when you add a sprite to this group, -it "forgets" about any previous sprites it had. Therefore it always contains -only one or zero sprites.

    -
    -

    RenderUpdates

    -
    -

    This group is inherited from Group, but changes the -draw() method to also return a list of pygame Rects, -which represent all the areas on screen that have been changed. -Generally you don't need to use this group, but it is included for -completeness.

    -
    -
    -

    That is the list of different groups available We'll discuss more about these -rendering groups in the next section. There's nothing stopping you from -creating your own Group classes as well. They are just python code, so you can -inherit from one of these and add/change whatever you want. In the future I -hope we can add a couple more Groups to this list. A GroupMulti which -is like the GroupSingle, but can hold up to a given number of sprites (in -some sort of circular buffer?). Also a super-render group that can clear the -position of the old sprites without needing a background image to do it (by -grabbing a copy of the screen before blitting). Who knows really, but in the -future we can add more useful classes to this list.

    -
    -
    -

    The Rendering Groups

    -

    From above we can see there are three different rendering groups. We could -probably just get away with the Group one. For a scrolling or stationary -type game, you should probably go with the Group group here to manage -your rendering.

    -

    Also note that there's nothing stopping you from mixing and matching these -render groups in your game. You should definitely use multiple rendering groups -when you want to do layering with your sprites. Also if the screen is split -into multiple sections, perhaps each section of the screen should use an -appropriate render group?

    -
    -
    -

    Collision Detection

    -

    The sprite module also comes with two very generic collision detection -functions. For more complex games, these really won't work for you, but you -can easily grab the source code for them, and modify them as needed.

    -

    Here's a summary of what they are, and what they do.

    -
    -

    spritecollide(sprite, group, dokill) -> list

    -
    -

    This checks for collisions between a single sprite and the sprites in a group. -It requires a "rect" attribute for all the sprites used. It returns a list of -all the sprites that overlap with the first sprite. The "dokill" argument is a -boolean argument. If it is true, the function will call the kill() method -on all the sprites. This means the last reference to each sprite is probably in -the returned list. Once the list goes away so do the sprites. A quick example -of using this in a loop

    -
    >>> for bomb in sprite.spritecollide(player, bombs, 1):
    -...     boom_sound.play()
    -...     Explosion(bomb, 0)
    -
    -
    -

    This finds all the sprites in the "bomb" group that collide with the player. -Because of the "dokill" argument it deletes all the crashed bombs. For each -bomb that did collide, it plays a "boom" sound effect, and creates a new -Explosion where the bomb was. (Note, the Explosion class here knows to -add each instance to the appropriate class, so we don't need to store it in a -variable, that last line might feel a little "funny" to you python programmers.)

    -
    -

    groupcollide(group1, group2, dokill1, dokill2) -> dictionary

    -
    -

    This is similar to the spritecollide function, but a little more complex. -It checks for collisions for all the sprites in one group, to the sprites in -another. There is a dokill argument for the sprites in each list. When -dokill1 is true, the colliding sprites in group1 will be kill()``ed. -When ``dokill2 is true, we get the same results for group2. The -dictionary it returns works like this; each key in the dictionary is a sprite -from group1 that had a collision. The value for that key is a list of the -sprites that it collided with. Perhaps another quick code sample explains it -best

    -
    >>> for alien in sprite.groupcollide(aliens, shots, 1, 1).keys()
    -...     boom_sound.play()
    -...     Explosion(alien, 0)
    -...     kills += 1
    -
    -
    -

    This code checks for the collisions between player bullets and all the aliens -they might intersect. In this case we only loop over the dictionary keys, but -we could loop over the values() or items() if we wanted to do something -to the specific shots that collided with aliens. If we did loop over the -values() we would be looping through lists that contain sprites. The same -sprite may even appear more than once in these different loops, since the same -"shot" could have collided against multiple "aliens".

    -
    -
    -

    Those are the basic collision functions that come with pygame. It should be -easy to roll your own that perhaps use something different than the "rect" -attribute. Or maybe try to fine-tweak your code a little more by directly -effecting the collision object, instead of building a list of the collision? -The code in the sprite collision functions is very optimized, but you could -speed it up slightly by taking out some functionality you don't need.

    -
    -
    -

    Common Problems

    -

    Currently there is one main problem that catches new users. When you derive -your new sprite class with the Sprite base, you must call the -Sprite.__init__() method from your own class __init__() method. If you -forget to call the Sprite.__init__() method, you get a cryptic error, like -this

    -
    AttributeError: 'mysprite' instance has no attribute '_Sprite__g'
    -
    -
    -
    -
    -

    Extending Your Own Classes (Advanced)

    -

    Because of speed concerns, the current Group classes try to only do exactly -what they need, and not handle a lot of general situations. If you decide you -need extra features, you may want to create your own Group class.

    -

    The Sprite and Group classes were designed to be extended, so feel free -to create your own Group classes to do specialized things. The best place -to start is probably the actual python source code for the sprite module. -Looking at the current Sprite groups should be enough example on how to -create your own.

    -

    For example, here is the source code for a rendering Group that calls a -draw() method for each sprite, instead of just blitting an "image" -variable from it. Since we want it to also handle updated areas, we will start -with a copy of the original RenderUpdates group, here is the code:

    -
    class RenderUpdatesDraw(Group):
    -    """call sprite.draw(screen) to render sprites"""
    -    def draw(self, surface):
    -        dirty = self.lostsprites
    -        self.lostsprites = []
    -        for s, r in self.spritedict.items():
    -            newrect = s.draw(screen) #Here's the big change
    -            if r is 0:
    -                dirty.append(newrect)
    -            else:
    -                dirty.append(newrect.union(r))
    -            self.spritedict[s] = newrect
    -        return dirty
    -
    -
    -

    Following is more information on how you could create your own Sprite and -Group objects from scratch.

    -

    The Sprite objects only "require" two methods. "add_internal()" and -"remove_internal()". These are called by the Group classes when they are -removing a sprite from themselves. The add_internal() and -remove_internal() have a single argument which is a group. Your Sprite -will need some way to also keep track of the Groups it belongs to. You will -likely want to try to match the other methods and arguments to the real -Sprite class, but if you're not going to use those methods, you sure don't -need them.

    -

    It is almost the same requirements for creating your own Group. In fact, if -you look at the source you'll see the GroupSingle isn't derived from the -Group class, it just implements the same methods so you can't really tell -the difference. Again you need an "add_internal()" and "remove_internal()" -method that the sprites call when they want to belong or remove themselves from -the group. The add_internal() and remove_internal() have a single -argument which is a sprite. The only other requirement for the Group -classes is they have a placeholder attribute named "_spritegroup". It doesn't matter -what the value is, as long as the attribute is present. The Sprite classes can -look for this attribute to determine the difference between a "group" and any -ordinary python container. (This is important, because several sprite methods -can take an argument of a single group, or a sequence of groups. Since they -both look similar, this is the most flexible way to "see" the difference.)

    -

    You should go through the code for the sprite module. While the code is a bit -"tuned", it's got enough comments to help you follow along. There's even a -TODO section in the source if you feel like contributing.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-surfarray.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-surfarray.html deleted file mode 100644 index 9737be5..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/intro-to-surfarray.html +++ /dev/null @@ -1,664 +0,0 @@ - - - - - - - - Pygame Tutorials - Surfarray Introduction — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Surfarray Introduction

    -
    -
    Author:
    -

    Pete Shinners

    -
    -
    Contact:
    -

    pete@shinners.org

    -
    -
    -
    -

    Introduction

    -

    This tutorial will attempt to introduce users to both NumPy and the pygame -surfarray module. To beginners, the code that uses surfarray can be quite -intimidating. But actually there are only a few concepts to understand and -you will be up and running. Using the surfarray module, it becomes possible -to perform pixel level operations from straight python code. The performance -can become quite close to the level of doing the code in C.

    -

    You may just want to jump down to the "Examples" section to get an -idea of what is possible with this module, then start at the beginning here -to work your way up.

    -

    Now I won't try to fool you into thinking everything is very easy. To get -more advanced effects by modifying pixel values is very tricky. Just mastering -Numeric Python (SciPy's original array package was Numeric, the predecessor of NumPy) -takes a lot of learning. In this tutorial I'll be sticking with -the basics and using a lot of examples in an attempt to plant seeds of wisdom. -After finishing the tutorial you should have a basic handle on how the surfarray -works.

    -
    -
    -

    Numeric Python

    -

    If you do not have the python NumPy package installed, -you will need to do that now, by following the -NumPy Installation Guide. -To make sure NumPy is working for you, -you should get something like this from the interactive python prompt.

    -
    >>> from numpy import *                    #import numeric
    ->>> a = array((1,2,3,4,5))                 #create an array
    ->>> a                                      #display the array
    -array([1, 2, 3, 4, 5])
    ->>> a[2]                                   #index into the array
    -3
    ->>> a*2                                    #new array with twiced values
    -array([ 2,  4,  6,  8, 10])
    -
    -
    -

    As you can see, the NumPy module gives us a new data type, the array. -This object holds an array of fixed size, and all values inside are of the same -type. The arrays can also be multidimensional, which is how we will use them -with images. There's a bit more to it than this, but it is enough to get us -started.

    -

    If you look at the last command above, you'll see that mathematical operations -on NumPy arrays apply to all values in the array. This is called "element-wise -operations". These arrays can also be sliced like normal lists. The slicing -syntax is the same as used on standard python objects. -(so study up if you need to :] ). -Here are some more examples of working with arrays.

    -
    >>> len(a)                                 #get array size
    -5
    ->>> a[2:]                                  #elements 2 and up
    -array([3, 4, 5])
    ->>> a[:-2]                                 #all except last 2
    -array([1, 2, 3])
    ->>> a[2:] + a[:-2]                         #add first and last
    -array([4, 6, 8])
    ->>> array((1,2,3)) + array((3,4))          #add arrays of wrong sizes
    -Traceback (most recent call last):
    -  File "<stdin>", line 1, in <module>
    -ValueError: operands could not be broadcast together with shapes (3,) (2,)
    -
    -
    -

    We get an error on the last command, because we try add together two arrays -that are different sizes. In order for two arrays two operate with each other, -including comparisons and assignment, they must have the same dimensions. It is -very important to know that the new arrays created from slicing the original all -reference the same values. So changing the values in a slice also changes the -original values. It is important how this is done.

    -
    >>> a                                      #show our starting array
    -array([1, 2, 3, 4, 5])
    ->>> aa = a[1:3]                            #slice middle 2 elements
    ->>> aa                                     #show the slice
    -array([2, 3])
    ->>> aa[1] = 13                             #chance value in slice
    ->>> a                                      #show change in original
    -array([ 1, 2, 13,  4,  5])
    ->>> aaa = array(a)                         #make copy of array
    ->>> aaa                                    #show copy
    -array([ 1, 2, 13,  4,  5])
    ->>> aaa[1:4] = 0                           #set middle values to 0
    ->>> aaa                                    #show copy
    -array([1, 0, 0, 0, 5])
    ->>> a                                      #show original again
    -array([ 1, 2, 13,  4,  5])
    -
    -
    -

    Now we will look at small arrays with two -dimensions. Don't be too worried, getting started it is the same as having a -two dimensional tuple (a tuple inside a tuple). Let's get started with -two dimensional arrays.

    -
    >>> row1 = (1,2,3)                         #create a tuple of vals
    ->>> row2 = (3,4,5)                         #another tuple
    ->>> (row1,row2)                            #show as a 2D tuple
    -((1, 2, 3), (3, 4, 5))
    ->>> b = array((row1, row2))                #create a 2D array
    ->>> b                                      #show the array
    -array([[1, 2, 3],
    -       [3, 4, 5]])
    ->>> array(((1,2),(3,4),(5,6)))             #show a new 2D array
    -array([[1, 2],
    -       [3, 4],
    -       [5, 6]])
    -
    -
    -

    Now with this two -dimensional array (from now on as "2D") we can index specific values -and do slicing on both dimensions. Simply using a comma to separate the indices -allows us to lookup/slice in multiple dimensions. Just using ":" as an -index (or not supplying enough indices) gives us all the values in -that dimension. Let's see how this works.

    -
    >>> b                                      #show our array from above
    -array([[1, 2, 3],
    -       [3, 4, 5]])
    ->>> b[0,1]                                 #index a single value
    -2
    ->>> b[1,:]                                 #slice second row
    -array([3, 4, 5])
    ->>> b[1]                                   #slice second row (same as above)
    -array([3, 4, 5])
    ->>> b[:,2]                                 #slice last column
    -array([3, 5])
    ->>> b[:,:2]                                #slice into a 2x2 array
    -array([[1, 2],
    -       [3, 4]])
    -
    -
    -

    Ok, stay with me here, this is about as hard as it gets. When using NumPy -there is one more feature to slicing. Slicing arrays also allow you to specify -a slice increment. The syntax for a slice with increment is -start_index : end_index : increment.

    -
    >>> c = arange(10)                         #like range, but makes an array
    ->>> c                                      #show the array
    -array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
    ->>> c[1:6:2]                               #slice odd values from 1 to 6
    -array([1, 3, 5])
    ->>> c[4::4]                                #slice every 4th val starting at 4
    -array([4, 8])
    ->>> c[8:1:-1]                              #slice 1 to 8, reversed
    -array([8, 7, 6, 5, 4, 3, 2])
    -
    -
    -

    Well that is it. There's enough information there to get you started using -NumPy with the surfarray module. There's certainly a lot more to NumPy, but -this is only an introduction. Besides, we want to get on to the fun stuff, -correct?

    -
    -
    -

    Import Surfarray

    -

    In order to use the surfarray module we need to import it. Since both surfarray -and NumPy are optional components for pygame, it is nice to make sure they -import correctly before using them. In these examples I'm going to import -NumPy into a variable named N. This will let you know which functions -I'm using are from the NumPy package. -(and is a lot shorter than typing NumPy before each function)

    -
    try:
    -    import numpy as N
    -    import pygame.surfarray as surfarray
    -except ImportError:
    -    raise ImportError, "NumPy and Surfarray are required."
    -
    -
    -
    -
    -

    Surfarray Introduction

    -

    There are two main types of functions in surfarray. One set of functions for -creating an array that is a copy of a surface pixel data. The other functions -create a referenced copy of the array pixel data, so that changes to the array -directly affect the original surface. There are other functions that allow you -to access any per-pixel alpha values as arrays along with a few other helpful -functions. We will look at these other functions later on.

    -

    When working with these surface arrays, there are two ways of representing the -pixel values. First, they can be represented as mapped integers. This type of -array is a simple 2D array with a single integer representing the surface's -mapped color value. This type of array is good for moving parts of an image -around. The other type of array uses three RGB values to represent each pixel -color. This type of array makes it extremely simple to do types of effects that -change the color of each pixel. This type of array is also a little trickier to -deal with, since it is essentially a 3D numeric array. Still, once you get your -mind into the right mode, it is not much harder than using the normal 2D arrays.

    -

    The NumPy module uses a machine's natural number types to represent the data -values, so a NumPy array can consist of integers that are 8-bits, 16-bits, and 32-bits. -(the arrays can also use other types like floats and doubles, but for our image -manipulation we mainly need to worry about the integer types). -Because of this limitation of integer sizes, you must take a little extra care -that the type of arrays that reference pixel data can be properly mapped to a -proper type of data. The functions create these arrays from surfaces are:

    -
    -
    -surfarray.pixels2d(surface)
    -

    Creates a 2D array (integer pixel values) that reference the original surface data. -This will work for all surface formats except 24-bit.

    -
    - -
    -
    -surfarray.array2d(surface)
    -

    Creates a 2D array (integer pixel values) that is copied from any type of surface.

    -
    - -
    -
    -surfarray.pixels3d(surface)
    -

    Creates a 3D array (RGB pixel values) that reference the original surface data. -This will only work on 24-bit and 32-bit surfaces that have RGB or BGR formatting.

    -
    - -
    -
    -surfarray.array3d(surface)
    -

    Creates a 3D array (RGB pixel values) that is copied from any type of surface.

    -
    - -

    Here is a small chart that might better illustrate what types of functions -should be used on which surfaces. As you can see, both the arrayXD functions -will work with any type of surface.

    - ------- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

    32-bit

    24-bit

    16-bit

    8-bit(c-map)

    pixel2d

    yes

    yes

    yes

    array2d

    yes

    yes

    yes

    yes

    pixel3d

    yes

    yes

    array3d

    yes

    yes

    yes

    yes

    -
    -
    -

    Examples

    -

    With this information, we are equipped to start trying things with surface -arrays. The following are short little demonstrations that create a NumPy -array and display them in pygame. These different tests are found in the -arraydemo.py example. There is a simple function named surfdemo_show -that displays an array on the screen.

    -
    -
    -allblack -
    allblack = N.zeros((128, 128))
    -surfdemo_show(allblack, 'allblack')
    -
    -
    -

    Our first example creates an all black array. Whenever you need -to create a new numeric array of a specific size, it is best to use the -zeros function. Here we create a 2D array of all zeros and display -it.

    -
    -
    -
    -
    -striped -
    striped = N.zeros((128, 128, 3))
    -striped[:] = (255, 0, 0)
    -striped[:,::3] = (0, 255, 255)
    -surfdemo_show(striped, 'striped')
    -
    -
    -

    Here we are dealing with a 3D array. We start by creating an all red image. -Then we slice out every third row and assign it to a blue/green color. As you -can see, we can treat the 3D arrays almost exactly the same as 2D arrays, just -be sure to assign them 3 values instead of a single mapped integer.

    -
    -
    -
    -
    -rgbarray -
    imgsurface = pygame.image.load('surfarray.webp')
    -rgbarray = surfarray.array3d(imgsurface)
    -surfdemo_show(rgbarray, 'rgbarray')
    -
    -
    -

    Here we load an image with the image module, then convert it to a 3D -array of integer RGB color elements. An RGB copy of a surface always -has the colors arranged as a[r,c,0] for the red component, -a[r,c,1] for the green component, and a[r,c,2] for blue. This can then -be used without caring how the pixels of the actual surface are configured, -unlike a 2D array which is a copy of the mapped -(raw) surface pixels. We will use this image in the rest of the samples.

    -
    -
    -
    -
    -flipped -
    flipped = rgbarray[:,::-1]
    -surfdemo_show(flipped, 'flipped')
    -
    -
    -

    Here we flip the image vertically. All we need to do is take the original -image array and slice it using a negative increment.

    -
    -
    -
    -
    -scaledown -
    scaledown = rgbarray[::2,::2]
    -surfdemo_show(scaledown, 'scaledown')
    -
    -
    -

    Based on the last example, scaling an image down is pretty logical. We just -slice out all the pixels using an increment of 2 vertically and horizontally.

    -
    -
    -
    -
    -scaleup -
    shape = rgbarray.shape
    -scaleup = N.zeros((shape[0]*2, shape[1]*2, shape[2]))
    -scaleup[::2,::2,:] = rgbarray
    -scaleup[1::2,::2,:] = rgbarray
    -scaleup[:,1::2] = scaleup[:,::2]
    -surfdemo_show(scaleup, 'scaleup')
    -
    -
    -

    Scaling the image up is a little more work, but is similar to the previous -scaling down, we do it all with slicing. First we create an array that is -double the size of our original. First we copy the original array into every -other pixel of the new array. Then we do it again for every other pixel doing -the odd columns. At this point we have the image scaled properly going across, -but every other row is black, so we simply need to copy each row to the one -underneath it. Then we have an image doubled in size.

    -
    -
    -
    -
    -redimg -
    redimg = N.array(rgbarray)
    -redimg[:,:,1:] = 0
    -surfdemo_show(redimg, 'redimg')
    -
    -
    -

    Now we are using 3D arrays to change the colors. Here we -set all the values in green and blue to zero. -This leaves us with just the red channel.

    -
    -
    -
    -
    -soften -
    factor = N.array((8,), N.int32)
    -soften = N.array(rgbarray, N.int32)
    -soften[1:,:]  += rgbarray[:-1,:] * factor
    -soften[:-1,:] += rgbarray[1:,:] * factor
    -soften[:,1:]  += rgbarray[:,:-1] * factor
    -soften[:,:-1] += rgbarray[:,1:] * factor
    -soften //= 33
    -surfdemo_show(soften, 'soften')
    -
    -
    -

    Here we perform a 3x3 convolution filter that will soften our image. -It looks like a lot of steps here, but what we are doing is shifting -the image 1 pixel in each direction and adding them all together (with some -multiplication for weighting). Then average all the values. It's no Gaussian, -but it's fast. One point with NumPy arrays, the precision of arithmetic -operations is determined by the array with the largest data type. -So if factor was not declared as a 1 element array of type numpy.int32, -the multiplications would be performed using numpy.int8, the 8 bit integer -type of each rgbarray element. This will cause value truncation. The soften -array must also be declared to have a larger integer size than rgbarray to -avoid truncation.

    -
    -
    -
    -
    -xfade -
    src = N.array(rgbarray)
    -dest = N.zeros(rgbarray.shape)
    -dest[:] = 20, 50, 100
    -diff = (dest - src) * 0.50
    -xfade = src + diff.astype(N.uint)
    -surfdemo_show(xfade, 'xfade')
    -
    -
    -

    Lastly, we are cross fading between the original image and a solid bluish -image. Not exciting, but the dest image could be anything, and changing the 0.50 -multiplier will let you choose any step in a linear crossfade between two images.

    -
    -
    -
    -
    -

    Hopefully by this point you are starting to see how surfarray can be used to -perform special effects and transformations that are only possible at the pixel -level. At the very least, you can use the surfarray to do a lot of Surface.set_at() -Surface.get_at() type operations very quickly. But don't think you are finished -yet, there is still much to learn.

    -
    -
    -

    Surface Locking

    -

    Like the rest of pygame, surfarray will lock any Surfaces it needs to -automatically when accessing pixel data. There is one extra thing to be aware -of though. When creating the pixel arrays, the original surface will -be locked during the lifetime of that pixel array. This is important to remember. -Be sure to "del" the pixel array or let it go out of scope -(ie, when the function returns, etc).

    -

    Also be aware that you really don't want to be doing much (if any) -direct pixel access on hardware surfaces (HWSURFACE). This is because -the actual surface data lives on the graphics card, and transferring pixel -changes over the PCI/AGP bus is not fast.

    -
    -
    -

    Transparency

    -

    The surfarray module has several methods for accessing a Surface's alpha/colorkey -values. None of the alpha functions are affected by overall transparency of a -Surface, just the pixel alpha values. Here's the list of those functions.

    -
    -
    -surfarray.pixels_alpha(surface)
    -

    Creates a 2D array (integer pixel values) that references the original -surface alpha data. -This will only work on 32-bit images with an 8-bit alpha component.

    -
    - -
    -
    -surfarray.array_alpha(surface)
    -

    Creates a 2D array (integer pixel values) that is copied from any -type of surface. -If the surface has no alpha values, -the array will be fully opaque values (255).

    -
    - -
    -
    -surfarray.array_colorkey(surface)
    -

    Creates a 2D array (integer pixel values) that is set to transparent -(0) wherever that pixel color matches the Surface colorkey.

    -
    - -
    -
    -

    Other Surfarray Functions

    -

    There are only a few other functions available in surfarray. You can get a better -list with more documentation on the -surfarray reference page. -There is one very useful function though.

    -
    -
    -surfarray.blit_array(surface, array)
    -

    This will transfer any type of 2D or 3D surface array onto a Surface -of the same dimensions. -This surfarray blit will generally be faster than assigning an array to a -referenced pixel array. -Still, it should not be as fast as normal Surface blitting, -since those are very optimized.

    -
    - -
    -
    -

    More Advanced NumPy

    -

    There's a couple last things you should know about NumPy arrays. When dealing -with very large arrays, like the kind that are 640x480 big, there are some extra -things you should be careful about. Mainly, while using the operators like + and -* on the arrays makes them easy to use, it is also very expensive on big arrays. -These operators must make new temporary copies of the array, that are then -usually copied into another array. This can get very time consuming. Fortunately, -all the NumPy operators come with special functions that can perform the -operation "in place". For example, you would want to replace -screen[:] = screen + brightmap with the much faster -add(screen, brightmap, screen). -Anyway, you'll want to read up on the NumPy UFunc -documentation for more about this. -It is important when dealing with the arrays.

    -

    Another thing to be aware of when working with NumPy arrays is the datatype -of the array. Some of the arrays (especially the mapped pixel type) often return -arrays with an unsigned 8-bit value. These arrays will easily overflow if you are -not careful. NumPy will use the same coercion that you find in C programs, so -mixing an operation with 8-bit numbers and 32-bit numbers will give a result as -32-bit numbers. You can convert the datatype of an array, but definitely be -aware of what types of arrays you have, if NumPy gets in a situation where -precision would be ruined, it will raise an exception.

    -

    Lastly, be aware that when assigning values into the 3D arrays, they must be -between 0 and 255, or you will get some undefined truncating.

    -
    -
    -

    Graduation

    -

    Well there you have it. My quick primer on Numeric Python and surfarray. -Hopefully now you see what is possible, and even if you never use them for -yourself, you do not have to be afraid when you see code that does. Look into -the vgrade example for more numeric array action. There are also some "flame" -demos floating around that use surfarray to create a realtime fire effect.

    -

    Best of all, try some things on your own. Take it slow at first and build up, -I've seen some great things with surfarray already like radial gradients and -more. Good Luck.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/make-games.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/make-games.html deleted file mode 100644 index a66d5f1..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/make-games.html +++ /dev/null @@ -1,241 +0,0 @@ - - - - - - - - Making Games With Pygame — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Making Games With Pygame

    -
    -
    -
    -

    Table of Contents

    -

    1. Introduction

    -
    -
    -

    2. Revision: Pygame fundamentals

    -
    -
    -

    3. Kicking things off

    -
    -
    -

    4. Game object classes

    -
    -
    -

    5. User-controllable objects

    -
    -
    -

    6. Putting it all together

    -
    -
    -
    -
    -

    1. Introduction

    -

    First of all, I will assume you have read the Line By Line Chimp -tutorial, which introduces the basics of Python and pygame. Give it a read before reading this -tutorial, as I won't bother repeating what that tutorial says (or at least not in as much detail). This tutorial is aimed at those -who understand how to make a ridiculously simple little "game", and who would like to make a relatively simple game like Pong. -It introduces you to some concepts of game design, some simple mathematics to work out ball physics, and some ways to keep your -game easy to maintain and expand.

    -

    All the code in this tutorial works toward implementing TomPong, -a game I've written. By the end of the tutorial, you should not only have a firmer grasp of pygame, but -you should also understand how TomPong works, and how to make your own version.

    -

    Now, for a brief recap of the basics of pygame. A common method of organising the code for a game is to divide it into the following -six sections:

    -
    -
      -
    • Load modules which are required in the game. Standard stuff, except that you should -remember to import the pygame local names as well as the pygame module itself

    • -
    • Resource handling classes; define some classes to handle your most basic resources, -which will be loading images and sounds, as well as connecting and disconnecting to and from networks, loading save game -files, and any other resources you might have.

    • -
    • Game object classes; define the classes for your game object. In the pong example, -these will be one for the player's bat (which you can initialise multiple times, one for each player in the game), and one -for the ball (which can again have multiple instances). If you're going to have a nice in-game menu, it's also a good idea to make a -menu class.

    • -
    • Any other game functions; define other necessary functions, such as scoreboards, menu -handling, etc. Any code that you could put into the main game logic, but that would make understanding said logic harder, should -be put into its own function. So as plotting a scoreboard isn't game logic, it should be moved into a function.

    • -
    • Initialise the game, including the pygame objects themselves, the background, the game -objects (initialising instances of the classes) and any other little bits of code you might want to add in.

    • -
    • The main loop, into which you put any input handling (i.e. watching for users hitting -keys/mouse buttons), the code for updating the game objects, and finally for updating the screen.

    • -
    -
    -

    Every game you make will have some or all of those sections, possibly with more of your own. For the purposes of this tutorial, I will -write about how TomPong is laid out, and the ideas I write about can be transferred to almost any kind of game you might make. I will -also assume that you want to keep all of the code in a single file, but if you're making a reasonably large game, it's often a good -idea to source certain sections into module files. Putting the game object classes into a file called objects.py, for -example, can help you keep game logic separate from game objects. If you have a lot of resource handling code, it can also be handy -to put that into resources.py. You can then from objects,resources import * to import all of the -classes and functions.

    -
    -
    -

    1.1. A note on coding styles

    -

    The first thing to remember when approaching any programming project is to decide on a coding style, and stay consistent. Python -solves a lot of the problems because of its strict interpretation of whitespace and indentation, but you can still choose the size -of your indentations, whether you put each module import on a new line, how you comment code, etc. You'll see how I do all of this -in the code examples; you needn't use my style, but whatever style you adopt, use it all the way through the program code. Also try -to document all of your classes, and comment on any bits of code that seem obscure, though don't start commenting the obvious. I've -seen plenty of people do the following:

    -
    player1.score += scoreup        # Add scoreup to player1 score
    -
    -
    -

    The worst code is poorly laid out, with seemingly random changes in style, and poor documentation. Poor code is not only annoying -for other people, but it also makes it difficult for you to maintain.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/move-it.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/move-it.html deleted file mode 100644 index b17067c..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/move-it.html +++ /dev/null @@ -1,658 +0,0 @@ - - - - - - - - Pygame Tutorials - Help! How Do I Move An Image? — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Help! How Do I Move An Image?

    -
    -
    Author:
    -

    Pete Shinners

    -
    -
    Contact:
    -

    pete@shinners.org

    -
    -
    -

    Many people new to programming and graphics have a hard time figuring -out how to make an image move around the screen. Without understanding -all the concepts, it can be very confusing. You're not the first person -to be stuck here, I'll do my best to take things step by step. We'll even -try to end with methods of keeping your animations efficient.

    -

    Note that we won't be teaching you to program with python in this article, -just introduce you to some of the basics with pygame.

    -
    -

    Just Pixels On The Screen

    -

    Pygame has a display Surface. This is basically an image that is visible -on the screen, and the image is made up of pixels. The main way you change -these pixels is by calling the blit() function. This copies the pixels -from one image onto another.

    -

    This is the first thing to understand. When you blit an image onto the -screen, you are simply changing the color of the pixels on the screen. -Pixels aren't added or moved, we just change the colors of the pixels already -on the screen. These images you blit to the screen are also Surfaces in -pygame, but they are in no way connected to the display Surface. When they -are blitted to the screen they are copied into the display, but you still -have a unique copy of the original.

    -

    With this brief description. Perhaps you can already understand what -is needed to "move" an image. We don't actually move anything at all. We -simply blit the image in a new position. But before we draw the image in -the new position, we'll need to "erase" the old one. Otherwise the image -will be visible in two places on the screen. By rapidly erasing the image -and redrawing it in a new place, we achieve the "illusion" of movement.

    -

    Through the rest of this tutorial we will break this process down into -simpler steps. Even explaining the best ways to have multiple images moving -around the screen. You probably already have questions. Like, how do we -"erase" the image before drawing it in a new position? Perhaps you're still -totally lost? Well hopefully the rest of this tutorial can straighten things -out for you.

    -
    -
    -

    Let's Go Back A Step

    -

    Perhaps the concept of pixels and images is still a little foreign to -you? Well good news, for the next few sections we are going to use code that -does everything we want, it just doesn't use pixels. We're going to create -a small python list of 6 numbers, and imagine it represents some fantastic -graphics we could see on the screen. It might actually be surprising how -closely this represents exactly what we'll later be doing with real graphics.

    -

    So let's begin by creating our screen list and fill it with a beautiful -landscape of 1s and 2s.

    -
    >>> screen = [1, 1, 2, 2, 2, 1]
    ->>> print(screen)
    -[1, 1, 2, 2, 2, 1]
    -
    -
    -

    Now we've created our background. It's not going to be very exciting -unless we also draw a player on the screen. We'll create a mighty hero -that looks like the number 8. Let's stick him near the middle of the map -and see what it looks like.

    -
    >>> screen[3] = 8
    ->>> print(screen)
    -[1, 1, 2, 8, 2, 1]
    -
    -
    -

    This might have been as far as you've gotten if you jumped right in doing -some graphics programming with pygame. You've got some nice looking stuff -on the screen, but it cannot move anywhere. Perhaps now that our screen -is just a list of numbers, it's easier to see how to move him?

    -
    -
    -

    Making The Hero Move

    -

    Before we can start moving the character. We need to keep track of some -sort of position for him. In the last section when we drew him, we just picked -an arbitrary position. Let's do it a little more officially this time.

    -
    >>> playerpos = 3
    ->>> screen[playerpos] = 8
    ->>> print(screen)
    -[1, 1, 2, 8, 2, 1]
    -
    -
    -

    Now it is pretty easy to move him to a new position. We simply change -the value of playerpos, and draw him on the screen again.

    -
    >>> playerpos = playerpos - 1
    ->>> screen[playerpos] = 8
    ->>> print(screen)
    -[1, 1, 8, 8, 2, 1]
    -
    -
    -

    Whoops. Now we can see two heroes. One in the old position, and one -in his new position. This is exactly the reason we need to "erase" the hero -in his old position before we draw him in the new position. To erase him, -we need to change that value in the list back to what it was before the hero -was there. That means we need to keep track of the values on the screen before -the hero replaced them. There's several way you could do this, but the easiest -is usually to keep a separate copy of the screen background. This means -we need to make some changes to our little game.

    -
    -
    -

    Creating A Map

    -

    What we want to do is create a separate list we will call our background. -We will create the background so it looks like our original screen did, -with 1s and 2s. Then we will copy each item from the background to the screen. -After that we can finally draw our hero back onto the screen.

    -
    >>> background = [1, 1, 2, 2, 2, 1]
    ->>> screen = [0]*6                         #a new blank screen
    ->>> for i in range(6):
    -...     screen[i] = background[i]
    ->>> print(screen)
    -[1, 1, 2, 2, 2, 1]
    ->>> playerpos = 3
    ->>> screen[playerpos] = 8
    ->>> print(screen)
    -[1, 1, 2, 8, 2, 1]
    -
    -
    -

    It may seem like a lot of extra work. We're no farther off than we were -before the last time we tried to make him move. But this time we have the -extra information we need to move him properly.

    -
    -
    -

    Making The Hero Move (Take 2)

    -

    This time it will be easy to move the hero around. First we will erase -the hero from his old position. We do this by copying the correct value -from the background onto the screen. Then we will draw the character in his -new position on the screen

    -
    >>> print(screen)
    -[1, 1, 2, 8, 2, 1]
    ->>> screen[playerpos] = background[playerpos]
    ->>> playerpos = playerpos - 1
    ->>> screen[playerpos] = 8
    ->>> print(screen)
    -[1, 1, 8, 2, 2, 1]
    -
    -
    -

    There it is. The hero has moved one space to the left. We can use this -same code to move him to the left again.

    -
    >>> screen[playerpos] = background[playerpos]
    ->>> playerpos = playerpos - 1
    ->>> screen[playerpos] = 8
    ->>> print(screen)
    -[1, 8, 2, 2, 2, 1]
    -
    -
    -

    Excellent! This isn't exactly what you'd call smooth animation. But with -a couple small changes, we'll make this work directly with graphics on -the screen.

    -
    -
    -

    Definition: "blit"

    -

    In the next sections we will transform our program from using lists to -using real graphics on the screen. When displaying the graphics we will -use the term blit frequently. If you are new to doing graphics -work, you are probably unfamiliar with this common term.

    -

    BLIT: Basically, blit means to copy graphics from one image -to another. A more formal definition is to copy an array of data -to a bitmapped array destination. You can think of blit as just -"assigning" pixels. Much like setting values in our screen-list -above, blitting assigns the color of pixels in our image.

    -

    Other graphics libraries will use the word bitblt, or just blt, -but they are talking about the same thing. It is basically copying -memory from one place to another. Actually, it is a bit more advanced than -straight copying of memory, since it needs to handle things like pixel -formats, clipping, and scanline pitches. Advanced blitters can also -handle things like transparency and other special effects.

    -
    -
    -

    Going From The List To The Screen

    -

    To take the code we see in the above to examples and make them work with -pygame is very straightforward. We'll pretend we have loaded some pretty -graphics and named them "terrain1", "terrain2", and "hero". Where before -we assigned numbers to a list, we now blit graphics to the screen. Another -big change, instead of using positions as a single index (0 through 5), we -now need a two dimensional point. We'll pretend each of the graphics -in our game is 10 pixels wide.

    -
    >>> background = [terrain1, terrain1, terrain2, terrain2, terrain2, terrain1]
    ->>> screen = create_graphics_screen()
    ->>> for i in range(6):
    -...     screen.blit(background[i], (i*10, 0))
    ->>> playerpos = 3
    ->>> screen.blit(playerimage, (playerpos*10, 0))
    -
    -
    -

    Hmm, that code should seem very familiar, and hopefully more importantly; -the code above should make a little sense. Hopefully my illustration of setting -simple values in a list shows the similarity of setting pixels on the screen -(with blit). The only part that's really extra work is converting the player position -into coordinates on the screen. For now we just use a crude (playerpos*10, 0) , -but we can certainly do better than that. Now let's move the player -image over a space. This code should have no surprises.

    -
    >>> screen.blit(background[playerpos], (playerpos*10, 0))
    ->>> playerpos = playerpos - 1
    ->>> screen.blit(playerimage, (playerpos*10, 0))
    -
    -
    -

    There you have it. With this code we've shown how to display a simple background -with a hero's image on it. Then we've properly moved that hero one space -to the left. So where do we go from here? Well for one the code is still -a little awkward. First thing we'll want to do is find a cleaner way to represent -the background and player position. Then perhaps a bit of smoother, real -animation.

    -
    -
    -

    Screen Coordinates

    -

    To position an object on the screen, we need to tell the blit() function -where to put the image. In pygame we always pass positions as (X,Y) coordinates. -This represents the number of pixels to the right, and the number of pixels -down to place the image. The top-left corner of a Surface is coordinates (0, -0). Moving to the right a little would be (10, 0), and then moving down just -as much would be (10, 10). When blitting, the position argument represents -where the topleft corner of the source should be placed on the destination.

    -

    Pygame comes with a convenient container for these coordinates, it is a -Rect. The Rect basically represents a rectangular area in these coordinates. -It has topleft corner and a size. The Rect comes with a lot of convenient -methods which help you move and position them. In our next examples we will -represent the positions of our objects with the Rects.

    -

    Also know that many functions in pygame expect Rect arguments. All of these -functions can also accept a simple tuple of 4 elements (left, top, width, -height). You aren't always required to use these Rect objects, but you will -mainly want to. Also, the blit() function can accept a Rect as its position -argument, it simply uses the topleft corner of the Rect as the real position.

    -
    -
    -

    Changing The Background

    -

    In all our previous sections, we've been storing the background as a list -of different types of ground. That is a good way to create a tile-based game, -but we want smooth scrolling. To make that a little easier, we're going to -change the background into a single image that covers the whole screen. This -way, when we want to "erase" our objects (before redrawing them) we only need -to blit the section of the erased background onto the screen.

    -

    By passing an optional third Rect argument to blit, we tell blit to only -use that subsection of the source image. You'll see that in use below as we -erase the player image.

    -

    Also note, now when we finish drawing to the screen, we call pygame.display.update() -which will show everything we've drawn onto the screen.

    -
    -
    -

    Smooth Movement

    -

    To make something appear to move smoothly, we only want to move it a couple -pixels at a time. Here is the code to make an object move smoothly across -the screen. Based on what we already now know, this should look pretty simple.

    -
    >>> screen = create_screen()
    ->>> clock = pygame.time.Clock()            #get a pygame clock object
    ->>> player = load_player_image()
    ->>> background = load_background_image()
    ->>> screen.blit(background, (0, 0))        #draw the background
    ->>> position = player.get_rect()
    ->>> screen.blit(player, position)          #draw the player
    ->>> pygame.display.update()                #and show it all
    ->>> for x in range(100):                   #animate 100 frames
    -...     screen.blit(background, position, position) #erase
    -...     position = position.move(2, 0)     #move player
    -...     screen.blit(player, position)      #draw new player
    -...     pygame.display.update()            #and show it all
    -...     clock.tick(60)                     #update 60 times per second
    -
    -
    -

    There you have it. This is all the code that is needed to smoothly animate -an object across the screen. We can even use a pretty background character. -Another benefit of doing the background this way, the image for the player -can have transparency or cutout sections and it will still draw correctly -over the background (a free bonus).

    -

    We also throw in a call to pygame.time.Clock() to grab the clock element. -With it, we can call clock.tick() to set the framerate in frames per second. -This slows down our program a little, otherwise it might run so fast you might -not see it.

    -
    -
    -

    So, What Next?

    -

    Well there we have it. Hopefully this article has done everything it promised -to do. But, at this point the code really isn't ready for the next best-selling -game. How do we easily have multiple moving objects? What exactly are those -mysterious functions like load_player_image()? We also need a way to get simple -user input, and loop for more than 100 frames. We'll take the example we -have here, and turn it into an object oriented creation that would make momma -proud.

    -
    -
    -

    First, The Mystery Functions

    -

    Full information on these types of functions can be found in other tutorials -and reference. The pygame.image module has a load() function which will do -what we want. The lines to load the images should become this.

    -
    >>> player = pygame.image.load('player.bmp').convert()
    ->>> background = pygame.image.load('liquid.webp').convert()
    -
    -
    -

    We can see that's pretty simple, the load function just takes a filename -and returns a new Surface with the loaded image. After loading we make a call -to the Surface method, convert(). Convert returns us a new Surface of the -image, but now converted to the same pixel format as our display. Since the -images will be the same format at the screen, they will blit very quickly. -If we did not convert, the blit() function is slower, since it has to convert -from one type of pixel to another as it goes.

    -

    You may also have noticed that both the load() and convert() return new -Surfaces. This means we're really creating two Surfaces on each of these -lines. In other programming languages, this results in a memory leak (not -a good thing). Fortunately Python is smart enough to handle this, and pygame -will properly clean up the Surface we end up not using.

    -

    The other mystery function we saw in the above example was create_screen(). -In pygame it is simple to create a new window for graphics. The code to create -a 640x480 surface is below. By passing no other arguments, pygame will just -pick the best color depth and pixel format for us.

    -
    >>> screen = pygame.display.set_mode((640, 480))
    -
    -
    -
    -
    -

    Handling Some Input

    -

    We desperately need to change the main loop to look for any user input, (like -when the user closes the window). We need to add "event handling" to our -program. All graphical programs use this Event Based design. The program -gets events like "keyboard pressed" or "mouse moved" from the computer. Then -the program responds to the different events. Here's what the code should -look like. Instead of looping for 100 frames, we'll keep looping until the -user asks us to stop.

    -
    >>> while True:
    -...     for event in pygame.event.get():
    -...         if event.type == pygame.QUIT:
    -...             sys.exit()
    -...     move_and_draw_all_game_objects()
    -
    -
    -

    What this code simply does is, first loop forever, then check if there are -any events from the user. We exit the program if the user presses the close -button on the window. After we've checked all the events we move and draw -our game objects. (We'll also erase them before they move, too)

    -
    -
    -

    Moving Multiple Images

    -

    Here's the part where we're really going to change things around. Let's -say we want 10 different images moving around on the screen. A good way to -handle this is to use python's classes. We'll create a class that represents -our game object. This object will have a function to move itself, and then -we can create as many as we like. The functions to draw and move the object -need to work in a way where they only move one frame (or one step) at a time. -Here's the python code to create our class.

    -
    >>> class GameObject:
    -...     def __init__(self, image, height, speed):
    -...         self.speed = speed
    -...         self.image = image
    -...         self.pos = image.get_rect().move(0, height)
    -...     def move(self):
    -...         self.pos = self.pos.move(0, self.speed)
    -...         if self.pos.right > 600:
    -...             self.pos.left = 0
    -
    -
    -

    So we have two functions in our class. The init function constructs our object. -It positions the object and sets its speed. The move method moves the object -one step. If it's gone too far, it moves the object back to the left.

    -
    -
    -

    Putting It All Together

    -

    Now with our new object class, we can put together the entire game. Here -is what the main function for our program will look like.

    -
    >>> screen = pygame.display.set_mode((640, 480))
    ->>> clock = pygame.time.Clock()            #get a pygame clock object
    ->>> player = pygame.image.load('player.bmp').convert()
    ->>> background = pygame.image.load('background.bmp').convert()
    ->>> screen.blit(background, (0, 0))
    ->>> objects = []
    ->>> for x in range(10):                    #create 10 objects</i>
    -...     o = GameObject(player, x*40, x)
    -...     objects.append(o)
    ->>> while True:
    -...     for event in pygame.event.get():
    -...         if event.type == pygame.QUIT:
    -...             sys.exit()
    -...     for o in objects:
    -...         screen.blit(background, o.pos, o.pos)
    -...     for o in objects:
    -...         o.move()
    -...         screen.blit(o.image, o.pos)
    -...     pygame.display.update()
    -...     clock.tick(60)
    -
    -
    -

    And there it is. This is the code we need to animate 10 objects on the screen. -The only point that might need explaining is the two loops we use to clear -all the objects and draw all the objects. In order to do things properly, -we need to erase all the objects before drawing any of them. In our sample -here it may not matter, but when objects are overlapping, using two loops -like this becomes important.

    -
    -
    -

    Preparing for Improved User Input

    -

    With all keyboard input terminating the program, that's not very interactive. -Let's add some extra user input!

    -

    First we should create a unique character that the player will control. We -can do that in much the same way we created the other movable entities. Let's -call the player object p. We can already move any object, but, a player should -have more input than simply moving right. To accommodate this, let's revamp -our move function under our GameObject class.

    -
    >>> def move(self, up=False, down=False, left=False, right=False):
    -...   if right:
    -...       self.pos.right += self.speed
    -...   if left:
    -...       self.pos.right -= self.speed
    -...   if down:
    -...       self.pos.top += self.speed
    -...   if up:
    -...       self.pos.top -= self.speed
    -...   if self.pos.right > WIDTH:
    -...       self.pos.left = 0
    -...   if self.pos.top > HEIGHT-SPRITE_HEIGHT:
    -...       self.pos.top = 0
    -...   if self.pos.right < SPRITE_WIDTH:
    -...       self.pos.right = WIDTH
    -...   if self.pos.top < 0:
    -...       self.pos.top = HEIGHT-SPRITE_HEIGHT
    -
    -
    -

    There's certainly a lot more going on here, so let's take it one step at a time. -First, we've added some default values into the move function, declared as up, -down, left, and right. These booleans will allow us to specifically select a -direction that the object is moving in. The first part, where we go through and -check True for each variable, is where we will add to the position of the object, -much like before. Right controls horizontal, and top controls vertical positions.

    -

    Additionally, we've removed the magic number present previously, and replaced it -with the constants WIDTH, HEIGHT, SPRITE_WIDTH, and SPRITE_HEIGHT. These values -represent the screen width and height, along with the width and height of the object -displayed on the screen.

    -

    The second part, where the position is being checked, ensures that the position -is within the confines of our screen. With this in place, we need to make sure that -when one of our other objects calls move, we set right to true.

    -
    -
    -

    Adding the User Input

    -

    We've already seen that pygame has event handling, and we know that KEYDOWN is -an event in this loop. We could, under KEYDOWN, assert the key press matches an -arrow key, where we would then call move. However, this movement will only occur -once every time a key is pressed, and it therefore will be extremely choppy and -unpleasant.

    -

    For this, we can use pygame.key.get_pressed(), which returns a list of all keys, -and whether or not they are currently pressed. Since we want these key presses -to be maintained whether an event is currently happening or not, we should put -it outside of the main event handling loop, but still within our game loop. -Our functionality will look like this.

    -
    >>> keys = pygame.key.get_pressed()
    ->>> if keys[pygame.K_UP]:
    -...     p.move(up=True)
    ->>> if keys[pygame.K_DOWN]:
    -...     p.move(down=True)
    ->>> if keys[pygame.K_LEFT]:
    -...     p.move(left=True)
    ->>> if keys[pygame.K_RIGHT]:
    -...     p.move(right=True)
    -
    -
    -

    We simply get our list of keys pressed, called keys. We can then check the index -at the key code position to see if it is held down. For more key codes, I recommend -checking out the documentation on pygame.key.

    -

    When up is held, we move our object, p, up. When down is held, we move down. Rinse and -repeat for all cases, and we're good to go!

    -
    -
    -

    Putting it all Together One More time

    -

    Now that we're finished with the player functionality, let's take one last look to make -sure we understand everything.

    -
    >>> screen = pygame.display.set_mode((640, 480))
    ->>> clock = pygame.time.Clock()            #get a pygame clock object
    ->>> player = pygame.image.load('player.bmp').convert()
    ->>> entity = pygame.image.load('alien1.bmp').convert()
    ->>> background = pygame.image.load('background.bmp').convert()
    ->>> screen.blit(background, (0, 0))
    ->>> objects = []
    ->>> p = GameObject(player, 10, 3)          #create the player object
    ->>> for x in range(10):                    #create 10 objects</i>
    -...     o = GameObject(entity, x*40, x)
    -...     objects.append(o)
    ->>> while True:
    -...     keys = pygame.key.get_pressed()
    -...     if keys[pygame.K_UP]:
    -...         p.move(up=True)
    -...     if keys[pygame.K_DOWN]:
    -...         p.move(down=True)
    -...     if keys[pygame.K_LEFT]:
    -...         p.move(left=True)
    -...     if keys[pygame.K_RIGHT]:
    -...         p.move(right=True)
    -...     for event in pygame.event.get():
    -...         if event.type == pygame.QUIT:
    -...             sys.exit()
    -...     for o in objects:
    -...         screen.blit(background, o.pos, o.pos)
    -...     for o in objects:
    -...         o.move()
    -...         screen.blit(o.image, o.pos)
    -...     pygame.display.update()
    -...     clock.tick(60)
    -
    -
    -

    A few things not mentioned earlier: we load in a second image and call it entity, -and we use that for all objects that aren't the player, which uses the player -image defined earlier.

    -

    And that's all there is to it! Now we have a fully functional player object that -is controlled using the arrow keys!

    -
    -
    -

    You Are On Your Own From Here

    -

    So what would be next on your road to learning? Well first playing around -with this example a bit. The full running version of this example is available -in the pygame examples directory. It is the example named -moveit.py . -Take a look at the code and play with it, run it, learn it.

    -

    Things you may want to work on is maybe having more than one type of object. -Finding a way to cleanly "delete" objects when you don't want to show them -any more.

    -

    There are also other tutorials and examples in pygame that cover these -issues. So when you're ready to keep learning, keep on reading. :-)

    -

    Lastly, you can feel free to come to the pygame mailing list or chatroom -with any questions on this stuff. There's always folks on hand who can help -you out with this sort of business.

    -

    Lastly, have fun, that's what games are for!

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/newbie-guide.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/newbie-guide.html deleted file mode 100644 index 40ead7a..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/newbie-guide.html +++ /dev/null @@ -1,551 +0,0 @@ - - - - - - - - A Newbie Guide to pygame — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    A Newbie Guide to pygame

    -

    or Things I learned by trial and error so you don't have to,

    -

    or How I learned to stop worrying and love the blit.

    -

    Pygame is a python wrapper for SDL, written by Pete Shinners. What this -means is that, using pygame, you can write games or other multimedia -applications in Python that will run unaltered on any of SDL's supported -platforms (Windows, Linux, Mac, and others).

    -

    Pygame may be easy to learn, but the world of graphics programming can be -pretty confusing to the newcomer. I wrote this to try to distill the practical -knowledge I've gained over the past year or so of working with pygame, and its -predecessor, PySDL. I've tried to rank these suggestions in order of -importance, but how relevant any particular hint is will depend on your own -background and the details of your project.

    -
    -

    Get comfortable working in Python.

    -

    The most important thing is to feel confident using python. Learning something -as potentially complicated as graphics programming will be a real chore if -you're also unfamiliar with the language you're using. Write a few sizable -non-graphical programs in python -- parse some text files, write a guessing -game or a journal-entry program or something. Get comfortable with string and -list manipulation -- know how to split, slice and combine strings and lists. -Know how import works -- try writing a program that is spread across -several source files. Write your own functions, and practice manipulating -numbers and characters; know how to convert between the two. Get to the point -where the syntax for using lists and dictionaries is second-nature -- you don't -want to have to run to the documentation every time you need to slice a list or -sort a set of keys. Get comfortable using file paths -- this will come in handy -later when you start loading assets and creating save files.

    -

    Resist the temptation to ask for direct help online when -you run into trouble. Instead, fire up the interpreter and play with the -problem for a few hours, or use print statements and debugging tools to find out -what's going wrong in your code. Get into the habit of looking things up in the -official Python documentation, and Googling error messages to figure out what -they mean.

    -

    This may sound incredibly dull, but the confidence you'll gain through your -familiarity with python will work wonders when it comes time to write your -game. The time you spend making python code second-nature will be nothing -compared to the time you'll save when you're writing real code.

    -
    -
    -

    Recognize which parts of pygame you really need.

    -

    Looking at the jumble of classes at the top of the pygame documentation index -may be confusing. The important thing is to realize that you can do a great -deal with only a tiny subset of functions. Many classes you'll probably never -use -- in a year, I haven't touched the Channel, Joystick, cursors, -surfarray or version functions.

    -
    -
    -

    Know what a surface is.

    -

    The most important part of pygame is the surface. Just think of a surface as a -blank piece of paper. You can do a lot of things with a surface -- you can -draw lines on it, fill parts of it with color, copy images to and from it, and -set or read individual pixel colors on it. A surface can be any size (within -reason) and you can have as many of them as you like (again, within reason). -One surface is special -- the one you create with -pygame.display.set_mode()Initialize a window or screen for display.. This 'display surface' represents the screen; -whatever you do to it will appear on the user's screen.

    -

    So how do you create surfaces? As mentioned above, you create the special -'display surface' with pygame.display.set_mode(). You can create a surface -that contains an image by using pygame.image.load()Load new image from a file (or file-like object)., or you can make a surface -that contains text with pygame.font.Font.render()Draw text on a new Surface.. You can even create a surface that -contains nothing at all with pygame.Surface()Pygame object for representing images..

    -

    Most of the surface functions are not critical. Just learn Surface.blit(), -Surface.fill(), Surface.set_at() and Surface.get_at(), and you'll be fine.

    -
    -
    -

    Use Surface.convert().

    -

    When I first read the documentation for Surface.convert(), I didn't think -it was something I had to worry about. 'I only use PNGs, therefore everything I -do will be in the same format. So I don't need convert()';. It turns out I -was very, very wrong.

    -

    The 'format' that convert() refers to isn't the file format (i.e. PNG, -JPEG, GIF), it's what's called the 'pixel format'. This refers to the -particular way that a surface records individual colors in a specific pixel. -If the surface format isn't the same as the display format, SDL will have to -convert it on-the-fly for every blit -- a fairly time-consuming process. Don't -worry too much about the explanation; just note that convert() is necessary -if you want to get any kind of speed out of your blits.

    -

    How do you use convert? Just call it after creating a surface with the -image.load() function. Instead of just doing:

    -
    surface = pygame.image.load('foo.png')
    -
    -
    -

    Do:

    -
    surface = pygame.image.load('foo.png').convert()
    -
    -
    -

    It's that easy. You just need to call it once per surface, when you load an -image off the disk. You'll be pleased with the results; I see about a 6x -increase in blitting speed by calling convert().

    -

    The only times you don't want to use convert() is when you really need to -have absolute control over an image's internal format -- say you were writing -an image conversion program or something, and you needed to ensure that the -output file had the same pixel format as the input file. If you're writing a -game, you need speed. Use convert().

    -
    -
    -

    Be wary of outdated, obsolete, and optional advice.

    -

    Pygame has been around since the early 2000s, and a lot has changed since then -- -both within the framework itself and within the broader computing landscape as a -whole. Make sure to check the dates on materials you read (including this guide!), -and take older advice with a grain of salt. Here are some common things that -stick out to me:

    -

    Dirty Rects & performance 'tricks'

    -

    When you read older bits of pygame documentation or guides online, you may see -some emphasis on only updating portions of the screen that are dirty, for the -sake of performance (in this context, "dirty" means the region has changed since -the previous frame was drawn).

    -

    Generally this entails calling pygame.display.update()Update all, or a portion, of the display. For non-OpenGL displays. (with a list of -rects) instead of pygame.display.flip()Update the full display Surface to the screen., not having scrolling backgrounds, -or even not filling the screen with a background color every frame because pygame -supposedly can't handle it. Some of pygame's API is designed to support this -paradigm as well (e.g. pygame.sprite.RenderUpdates()Group sub-class that tracks dirty updates.), which made a lot of -sense in the early years of pygame.

    -

    In the present day (2022) though, most modest desktop computers are powerful enough to -refresh the entire display once per frame at 60 FPS and beyond. You can have a moving -camera, or dynamic backgrounds and your game should run totally fine at 60 FPS. CPUs are -more powerful nowadays, and you can use display.flip() without fear.

    -

    That being said there are still a few rare times when this old technique is still useful -for squeezing out a few extra FPS. For example, if you only need to update half of the display -surface and have a stationary image in the other half. Here is the rough process for how it works:

    -

    Instead of updating the whole screen every frame, only the parts that changed since -the last frame are updated. You do this by keeping track of those rectangles in a list, -then calling update(the_dirty_rectangles) at the end of the frame. In detail -for a moving sprite:

    -
    -
      -
    • Blit a piece of the background over the sprite's current location, erasing it.

    • -
    • Append the sprite's current location rectangle to a list called dirty_rects.

    • -
    • Move the sprite.

    • -
    • Draw the sprite at its new location.

    • -
    • Append the sprite's new location to my dirty_rects list.

    • -
    • Call display.update(dirty_rects)

    • -
    -
    -

    Even though this technique is not really useful for making performant 2D games with -modern CPUs, it is still nice to be aware of. There are also still plenty of other ways -to accidentally tank your game's performance with poorly optimized rendering logic. -For example, even on modern hardware it's probably too slow to call set_at once per pixel -on the display surface. Being mindful of performance is still something you'll have to -do.

    -

    There just aren't that many 'one neat trick to fix your code performance' tips. Every game -is different and there are different problems and different algorithms to solve them -efficiently in each type of game. Pretty much every time your 2D game code is failing to hit a -reasonable frame rate the underlying cause turns out to be bad algorithm or a misunderstanding -of fundamental game design patterns.

    -

    If you are having performance problems, first make sure you aren't loading files repeatedly in your -game loop, then use one of the many options for profiling your code to find out what is taking up the -most time. Once you are armed with at least some knowledge on why your game is slow, try asking the -internet (via google), or the pygame community if they've got some better algorithms to help you out.

    -

    HWSURFACE and DOUBLEBUF

    -

    The HWSURFACE display.set_mode() flag does nothing in pygame versions 2.0.0 and -later (you can check the docs if you don't believe me)! There's no reason to -use it anymore. Even in pygame 1, its effect is pretty nuanced and -generally misunderstood by most pygame users. It was never a magic speed-up -flag, unfortunately.

    -

    DOUBLEBUF still has some use, but is also not a magic speed up flag.

    -

    The Sprite class

    -

    You don't need to use the built-in Sprite or Group classes -if you don't want to. In a lot of tutorials, it may seem like Sprite is the -fundamental "GameObject" of pygame, from which all other objects must derive, -but in reality it's pretty much just a wrapper around a Rect and a -Surface, with some additional convenience methods. You may find it -more intuitive (and fun) to write your game's core logic and classes from -scratch.

    -

    Premultiplied Alpha

    -

    Using this alpha blending mode can boost your blitting performance slightly, it even -has its own tutorial page <tutorials/en/premultiplied-alpha>.

    -
    -
    -

    Don't get distracted by side issues.

    -

    Sometimes, new game programmers spend too much time worrying about issues that -aren't really critical to their game's success. The desire to get secondary -issues 'right' is understandable, but early in the process of creating a game, -you cannot even know what the important questions are, let alone what answers -you should choose. The result can be a lot of needless prevarication.

    -

    For example, consider the question of how to organize your graphics files. -Should each frame have its own graphics file, or each sprite? Perhaps all the -graphics should be zipped up into one archive? A great deal of time has been -wasted on a lot of projects, asking these questions on mailing lists, debating -the answers, profiling, etc, etc. This is a secondary issue; any time spent -discussing it should have been spent coding the actual game.

    -

    The insight here is that it is far better to have a 'pretty good' solution that -was actually implemented, than a perfect solution that you never got around to -writing.

    -
    -
    -

    Rects are your friends.

    -

    Pete Shinners' wrapper may have cool alpha effects and fast blitting speeds, -but I have to admit my favorite part of pygame is the lowly Rect class. -A rect is simply a rectangle -- defined only by the position of its top left -corner, its width, and its height. Many pygame functions take rects as -arguments, and they also take 'rectstyles', a sequence that has the same values -as a rect. So if I need a rectangle that defines the area between 10, 20 and -40, 50, I can do any of the following:

    -
    rect = pygame.Rect(10, 20, 30, 30)
    -rect = pygame.Rect((10, 20, 30, 30))
    -rect = pygame.Rect((10, 20), (30, 30))
    -rect = (10, 20, 30, 30)
    -rect = ((10, 20, 30, 30))
    -
    -
    -

    If you use any of the first three versions, however, you get access to Rect's -utility functions. These include functions to move, shrink and inflate rects, -find the union of two rects, and a variety of collision-detection functions.

    -

    For example, suppose I'd like to get a list of all the sprites that contain a -point (x, y) -- maybe the player clicked there, or maybe that's the current -location of a bullet. It's simple if each sprite has a .rect member -- I just -do:

    -
    sprites_clicked = [sprite for sprite in all_my_sprites_list if sprite.rect.collidepoint(x, y)]
    -
    -
    -

    Rects have no other relation to surfaces or graphics functions, other than the -fact that you can use them as arguments. You can also use them in places that -have nothing to do with graphics, but still need to be defined as rectangles. -Every project I discover a few new places to use rects where I never thought -I'd need them.

    -
    -
    -

    Don't bother with pixel-perfect collision detection.

    -

    So you've got your sprites moving around, and you need to know whether or not -they're bumping into one another. It's tempting to write something like the -following:

    -
    -
      -
    • Check to see if the rects are in collision. If they aren't, ignore them.

    • -
    • For each pixel in the overlapping area, see if the corresponding pixels from both sprites are opaque. If so, there's a collision.

    • -
    -
    -

    There are other ways to do this, with ANDing sprite masks and so on, but any -way you do it in pygame, it's probably going to be too slow. For most games, -it's probably better just to do 'sub-rect collision' -- create a rect for each -sprite that's a little smaller than the actual image, and use that for -collisions instead. It will be much faster, and in most cases the player won't -notice the imprecision.

    -
    -
    -

    Managing the event subsystem.

    -

    Pygame's event system is kind of tricky. There are actually two different ways -to find out what an input device (keyboard, mouse or joystick) is doing.

    -

    The first is by directly checking the state of the device. You do this by -calling, say, pygame.mouse.get_pos()Get the mouse cursor position. or pygame.key.get_pressed()Get the state of all keyboard buttons.. -This will tell you the state of that device at the moment you call the -function.

    -

    The second method uses the SDL event queue. This queue is a list of events -- -events are added to the list as they're detected, and they're deleted from the -queue as they're read off.

    -

    There are advantages and disadvantages to each system. State-checking (system -1) gives you precision -- you know exactly when a given input was made -- if -mouse.get_pressed([0]) is 1, that means that the left mouse button is -down right at this moment. The event queue merely reports that the -mouse was down at some time in the past; if you check the queue fairly often, -that can be ok, but if you're delayed from checking it by other code, input -latency can grow. Another advantage of the state-checking system is that it -detects "chording" easily; that is, several states at the same time. If you -want to know whether the t and f keys are down at the same time, just -check:

    -
    if key.get_pressed[K_t] and key.get_pressed[K_f]:
    -    print("Yup!")
    -
    -
    -

    In the queue system, however, each keypress arrives in the queue as a -completely separate event, so you'd need to remember that the t key was -down, and hadn't come up yet, while checking for the f key. A little more -complicated.

    -

    The state system has one great weakness, however. It only reports what the -state of the device is at the moment it's called; if the user hits a mouse -button then releases it just before a call to mouse.get_pressed(), the -mouse button will return 0 -- get_pressed() missed the mouse button press -completely. The two events, MOUSEBUTTONDOWN and MOUSEBUTTONUP, will -still be sitting in the event queue, however, waiting to be retrieved and -processed.

    -

    The lesson is: choose the system that meets your requirements. If you don't -have much going on in your loop -- say you're just sitting in a while True -loop, waiting for input, use get_pressed() or another state function; the -latency will be lower. On the other hand, if every keypress is crucial, but -latency isn't as important -- say your user is typing something in an editbox, -use the event queue. Some key presses may be slightly late, but at least you'll -get them all.

    -

    A note about event.poll() vs. wait() -- poll() may seem better, -since it doesn't block your program from doing anything while it's waiting for -input -- wait() suspends the program until an event is received. -However, poll() will consume 100% of available CPU time while it runs, -and it will fill the event queue with NOEVENTS. Use set_blocked() to -select just those event types you're interested in -- your queue will be much -more manageable.

    -

    Another note about the event queue -- even if you don't want to use it, you must -still clear it periodically because it's still going to be filling up with events -in the background as the user presses keys and mouses over the window. On Windows, -if your game goes too long without clearing the queue, the operating system will -think it has frozen and show a "The application is not responding" message. -Iterating over event.get() or simply calling event.clear() once per frame -will avoid this.

    -
    -
    -

    Colorkey vs. Alpha.

    -

    There's a lot of confusion around these two terms, and much of it comes -from the terminology used.

    -

    Per pixel alpha is the best type of alpha to use, it will give you nice -transparent and 'feathered' edges. Basically, each pixel in the source image -has its own alpha value, from 0 to 255. Most image editors will let you export -images with an alpha channel and pygame can load them.

    -

    'Colorkey blitting' involves telling pygame that all pixels of a certain color -in a certain image are transparent instead of whatever color they happen to be. -These transparent pixels are not blitted when the rest of the image is blitted, -and so don't obscure the background. Simply call Surface.set_colorkey(), -and pass in an RGB tuple -- say (0,0,0). This would make every pixel in the source -image transparent instead of black. It used to be significantly cheaper to blit -than per pixel alpha, but this is no longer the case and in many cases it is -actually slower.

    -

    Surface 'Alpha' is also available it applies to the whole surface. Surface alpha -causes each pixel in the source image to be only partially opaque. -For example, if you set a Surface's alpha to 192 and then blitted it onto a -background, 3/4 of each pixel's color would come from the source image, and 1/4 -from the background. Alpha is measured from 255 to 0, where 0 is completely -transparent, and 255 is completely opaque. Note that surface alpha and alpha -blitting can be combined.

    -
    -
    -

    Software architecture, design patterns, and games.

    -

    You may reach a point where you're comfortable writing code, you're able to solve -complex problems without assistance, you understand how to use most of pygame's -modules, and yet, as you work on larger projects they always seem to get messier -and harder to maintain as time goes on. This can manifest in many ways -- for -example, fixing bugs in one place might always seem to create new bugs elsewhere, -figuring out where code should go might become a challenge, adding new -things might frequently require you to rewrite many other things, and so on. -Finally, you decide to cut your losses and start fresh on something new.

    -

    This is a common issue and it can be frustrating -- on the one hand, your -programming skills are improving, and yet you aren't able to finish the games -you start due to somewhat nebulous organizational problems.

    -

    This brings us to the concept of software architecture and design patterns. You -may be familiar with pygame's "standard" base template (there are many equivalent -variations of this, so don't stress about the small details too much):

    -
    -
    Standard Pygame game loop
    -
     1 import pygame
    - 2
    - 3 pygame.init()
    - 4
    - 5 screen = pygame.display.set_mode((1280,720))
    - 6
    - 7 clock = pygame.time.Clock()
    - 8
    - 9 running = True
    -10
    -11 while running:
    -12     # Process player inputs.
    -13     for event in pygame.event.get():
    -14         if event.type == pygame.QUIT:
    -15             running = False
    -16
    -17     # Do logical updates here.
    -18     # ...
    -19
    -20     screen.fill("purple")  # Fill the display with a solid color
    -21
    -22     # Render the graphics here.
    -23     # ...
    -24
    -25     pygame.display.flip()  # Refresh on-screen display
    -26     clock.tick(60)         # wait until next frame (at 60 FPS)
    -27
    -28 pygame.quit()
    -
    -
    -
    -

    It does some initial setup, starts a loop, and then proceeds to repeatedly -collect input, handle the game's logic, and draw the current frame forever until -the program ends. The update, render, wait loop shown here is actually a design -pattern that serves as the skeleton of most games -- it's prolific because it's -clean, it's organized, and it works. (There's also an important but easy-to-miss -design feature here in the form of a strict division between the game's logic -and rendering routines. This decision alone prevents a whole category of potential -bugs related to objects updating and rendering concurrently, which is nice).

    -

    It turns out that there are many design patterns like this that are used frequently -in games and in software development at large. For a great resource on this -specifically for games, I highly recommend Game Programming Patterns, a short -free, e-book on the topic. It covers a bunch of useful patterns and concrete situations -where you might want to employ them. It won't instantly make you a better coder, -but learning some theory about software architecture can go a long way towards -helping you escape plateaus and tackle larger projects more confidently.

    -
    -
    -

    Do things the pythony way.

    -

    A final note (this isn't the least important one; it just comes at the end). -Pygame is a pretty lightweight wrapper around SDL, which is in turn a pretty -lightweight wrapper around your native OS graphics calls. Chances are pretty -good that if your code is still slow, and you've done the things I've mentioned -above, then the problem lies in the way you're addressing your data in python. -Certain idioms are just going to be slow in python no matter what you do. -Luckily, python is a very clear language -- if a piece of code looks awkward or -unwieldy, chances are its speed can be improved, too. Read over Why Pygame is -Slow for some deeper insight into why pygame might be considered slower than -other frameworks/engines, and what that actually means in practice. -And if you're truly stumped by performance problems, profilers like cProfile -(or SnakeViz, a visualizer for cProfile) can help identify bottlenecks (they'll -tell you which parts of the code are taking the longest to execute). That said, -premature optimisation is the root of all evil; if it's already fast enough, -don't torture the code trying to make it faster. If it's fast enough, let it -be :)

    -

    There you go. Now you know practically everything I know about using pygame. -Now, go write that game!

    -
    -

    David Clark is an avid pygame user and the editor of the Pygame Code -Repository, a showcase for community-submitted python game code. He is also -the author of Twitch, an entirely average pygame arcade game.

    -

    This guide was substantially updated in 2022 and updated again in 2023.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/premultiplied-alpha.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/premultiplied-alpha.html deleted file mode 100644 index 7cf69ff..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/premultiplied-alpha.html +++ /dev/null @@ -1,371 +0,0 @@ - - - - - - - - Pygame Tutorials - What is Premultiplied Alpha? — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    What is Premultiplied Alpha?

    -
    -
    Author:
    -

    Dan Lawrence

    -
    -
    Contact:
    -

    danintheshed@gmail.com

    -
    -
    -
    -

    Introduction to Alpha Composition

    -

    Alpha composition is the process by which we combine one or more semi-transparent images -into a final non-transparent image for display. In pygame-ce these images are called Surfaces -so I'll use that terminology going forwards.

    -

    The simplest example of an alpha composition is when we create a Surface, fill it with a color -that has an alpha channel, and then blit that surface direct to our display surface. For example:

    -
    -
    Simple example of Straight Alpha composition
    -
     1 import pygame
    - 2 from pygame import SRCALPHA, QUIT
    - 3
    - 4 pygame.init()
    - 5
    - 6 pygame.display.set_caption("Basic Composition")
    - 7 display_surf = pygame.display.set_mode((300, 170))
    - 8
    - 9 # create a Surface with the SRCALPHA flag to add an extra channel of data
    -10 # to each pixel that indicates how transparent it should be (from 0 - fully
    -11 # transparent, to 255 - fully opaque.
    -12 basic_surf = pygame.Surface((120, 120), flags=SRCALPHA)
    -13 # the fourth number here sets the alpha to 25 (almost fully see through)
    -14 basic_surf.fill((50, 50, 50, 25))
    -15
    -16 running = True
    -17
    -18 while running:
    -19     for event in pygame.event.get():
    -20         if event.type == QUIT:
    -21             running = False
    -22
    -23     display_surf.fill((180, 140, 50))
    -24
    -25     display_surf.blit(basic_surf, (25, 25))
    -26
    -27     pygame.display.flip()
    -
    -
    -
    -

    This kind of alpha composition uses the 'Straight Alpha' formula:

    -
    result = (source.RGB * source.A) + (destination.RGB * (1 - source.A))
    -
    -
    -

    In this formula our 'basic_surf' from the example code above would be the source, and our 'display_surf' -would be the destination.

    -

    The main advantage of this kind of alpha compositing is the independence of all the channels from one -another and the simplicity of its use. There is no setup required and most image editing programs will -export alpha in this way as a separate channel. This is why it is the default composition method in -pygame-ce.

    -
    -
    -

    How to use Premultiplied Alpha blending

    -

    Premultiplied alpha blending uses a slightly different formula to compose two surfaces

    -
    result = source.RGB + (destination.RGB * (1 - source.A))
    -
    -
    -

    As you can see there is one less multiplication in there - this is because, as is implied by the name, -in a premultiplied alpha composition all the pixels colors have already been multiplied by their alpha -channel value.

    -

    We can rewrite the example above to use premultiplied alpha:

    -
    -
    Simple example of Premultiplied Alpha composition
    -
     1 import pygame
    - 2 from pygame import SRCALPHA, BLEND_PREMULTIPLIED, QUIT
    - 3
    - 4 pygame.init()
    - 5
    - 6 pygame.display.set_caption("Basic Composition")
    - 7 display_surf = pygame.display.set_mode((300, 170))
    - 8
    - 9 basic_surf = pygame.Surface((120, 120), flags=SRCALPHA)
    -10 basic_surf.fill((50, 50, 50, 25))
    -11 basic_surf = basic_surf.premul_alpha()
    -12
    -13 running = True
    -14
    -15 while running:
    -16     for event in pygame.event.get():
    -17         if event.type == QUIT:
    -18             running = False
    -19
    -20     display_surf.fill((180, 140, 50))
    -21
    -22     display_surf.blit(basic_surf, (25, 25),
    -23                       special_flags=BLEND_PREMULTIPLIED)
    -24
    -25     pygame.display.flip()
    -
    -
    -
    -

    There are two main changes here. First setting the blend mode in the blit from the default blending -algorithm, which uses the straight alpha formula, to BLEND_PREMULTIPLIED. Second, we use the -premul_alpha() method on our alpha surface to return a Surface where the color channels have been -multiplied by the alpha.

    -

    Using premul_alpha() is just one way to get a premultiplied Surface, some image editing programs -will allow you to export images in a premultiplied alpha format, or you could manually convert an -image's alpha channel to a grayscale layer and multiply that with your image before your final export.

    -

    If you run the two programs above they should produce the exact same result.

    -
    -
    -

    Why would you use premultiplied alpha?

    -

    So far premultiplied alpha probably just seems like extra steps to get the same result. Why would you -want to use it over straight alpha?

    -

    There are two main reasons - and the first is performance. As you saw in the two formulas above, there -is one less mathematical operation to do at composition time with premultiplied alpha. Assuming you are -not adjusting your alpha in real-time - and in most game development usages you won't be, that is one -less operation to do per pixel which means, that on average your premultiplied alpha blits will be a -little bit faster than your straight alpha blits.

    -

    The second reason is a little more complicated to demonstrate so I've prepared a program to demonstrate -the issue. Essentially the straight alpha formula has issues when blending together two surfaces that -both contain alpha pixels, and the impact of this can vary from not noticeable at all to looking very -messy. Here is the example program for straight alpha:

    -
    -
    Example of Straight Alpha composition between two surfaces with per-pixel alpha
    -
     1 import pygame
    - 2
    - 3 pygame.init()
    - 4
    - 5 pygame.display.set_caption("Straight Alpha")
    - 6 display_surf = pygame.display.set_mode((300, 170))
    - 7
    - 8 text_font = pygame.font.Font("fonts/verdana.ttf", size=12)
    - 9
    -10 tool_tip_text = text_font.render(
    -11     "Some text in a box, to test alpha blending. "
    -12     "A quick brown fox jumps over the lazy dog.",
    -13     True,
    -14     (200, 200, 250),
    -15     wraplength=100,
    -16 ).convert_alpha()
    -17
    -18 tool_tip_surf = pygame.Surface((120, 120), flags=pygame.SRCALPHA)
    -19 tool_tip_surf.fill((50, 50, 50, 25))
    -20
    -21 tool_tip_surf.blit(tool_tip_text, (10, 10))
    -22
    -23 running = True
    -24
    -25 while running:
    -26     for event in pygame.event.get():
    -27         if event.type == pygame.QUIT:
    -28             running = False
    -29
    -30     display_surf.fill((180, 140, 50))
    -31
    -32     display_surf.blit(tool_tip_surf, (25, 25))
    -33
    -34     pygame.display.flip()
    -
    -
    -
    -

    This example approximates the sort of code you might use to add a semi-transparent 'tool-tip' -pop up box in a pygame-ce application. You may need to change the path to the verdana font, -copy it into a 'fonts/' subdirectory or use an alternative font. The issue is visible on all -fonts but more obvious on some fonts than others depending on how much they rely on alpha pixels -for visibility. If you run this program you will get a result that looks like this:

    -Example of Straight Alpha Composition -

    Which, to my eyes, makes the text difficult to read and something of a strain on the eyes.

    -

    If we rewrite the example to use premultiplied alpha composition instead:

    -
    -
    Example of Premultiplied Alpha composition between two surfaces with per-pixel alpha
    -
     1 import pygame
    - 2
    - 3 pygame.init()
    - 4
    - 5 pygame.display.set_caption("Premultiplied Alpha")
    - 6 display_surf = pygame.display.set_mode((300, 170))
    - 7
    - 8 text_font = pygame.font.Font("fonts/verdana.ttf", size=12)
    - 9
    -10 tool_tip_text = text_font.render(
    -11     "Some text in a box, to test alpha blending. "
    -12     "A quick brown fox jumps over the lazy dog.",
    -13     True,
    -14     (200, 200, 250),
    -15     wraplength=100,
    -16 ).convert_alpha()
    -17 tool_tip_text = tool_tip_text.premul_alpha()
    -18
    -19 tool_tip_surf = pygame.Surface((120, 120), flags=pygame.SRCALPHA)
    -20 tool_tip_surf.fill((50, 50, 50, 25))
    -21 tool_tip_surf = tool_tip_surf.premul_alpha()
    -22
    -23 tool_tip_surf.blit(tool_tip_text, (10, 10),
    -24                    special_flags=pygame.BLEND_PREMULTIPLIED)
    -25
    -26 running = True
    -27
    -28 while running:
    -29     for event in pygame.event.get():
    -30         if event.type == pygame.QUIT:
    -31             running = False
    -32
    -33     display_surf.fill((180, 140, 50))
    -34
    -35     display_surf.blit(tool_tip_surf, (25, 25),
    -36                       special_flags=pygame.BLEND_PREMULTIPLIED)
    -37
    -38     pygame.display.flip()
    -
    -
    -
    -

    You then get a result that looks like this:

    -Example of Premultiplied Alpha Composition -

    Which is a lot easier to read.

    -

    Why does this happen? Essentially it is because in the Straight Alpha formula the combined pixels -colors are losing the influence of the alpha information for the destination surface's pixels. -If you scroll back up to the formula for Straight Alpha you will notice that destination alpha -doesn't appear anywhere in it. In the example, the destination alpha should reduce the influence -of the black tool tip box background color on the final pixels by a large amount, but in the straight -alpha version it doesn't so we get a lot of extra black blended into the alpha edges of our light -blue text.

    -

    In the premultiplied alpha formula all the color channels of both surfaces are already multiplied by -their alpha channel - so we don't lose any information during the composition formula and the end -result looks more like what we would expect.

    -

    ---

    -

    And that is about all you need to know about alpha compositing and the differences between straight -alpha and premultiplied alpha. If you do want to learn more, then wikipedia has a nice long article -for further reading.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games2.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games2.html deleted file mode 100644 index 970cac6..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games2.html +++ /dev/null @@ -1,244 +0,0 @@ - - - - - - - - Revision: Pygame fundamentals — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    2. Revision: Pygame fundamentals

    -
    -

    2.1. The basic Pygame game

    -

    For the sake of revision, and to ensure that you are familiar with the basic structure of a Pygame program, I'll briefly run through -a basic Pygame program, which will display no more than a window with some text in it, that should, by the end, look something like -this (though of course the window decoration will probably be different on your system):

    -../../_images/tom_basic.webp -

    The full code for this example looks like this:

    -
    #!/usr/bin/python
    -
    -import pygame
    -from pygame.locals import *
    -
    -def main():
    -    # Initialise screen
    -    pygame.init()
    -    screen = pygame.display.set_mode((150, 50))
    -    pygame.display.set_caption('Basic Pygame program')
    -
    -    # Fill background
    -    background = pygame.Surface(screen.get_size())
    -    background = background.convert()
    -    background.fill((250, 250, 250))
    -
    -    # Display some text
    -    font = pygame.font.Font(None, 36)
    -    text = font.render("Hello There", 1, (10, 10, 10))
    -    textpos = text.get_rect()
    -    textpos.centerx = background.get_rect().centerx
    -    background.blit(text, textpos)
    -
    -    # Blit everything to the screen
    -    screen.blit(background, (0, 0))
    -    pygame.display.flip()
    -
    -    # Event loop
    -    while True:
    -        for event in pygame.event.get():
    -            if event.type == QUIT:
    -                return
    -
    -        screen.blit(background, (0, 0))
    -        pygame.display.flip()
    -
    -
    -if __name__ == '__main__': main()
    -
    -
    -
    -
    -

    2.2. Basic Pygame objects

    -

    As you can see, the code consists of three main objects: the screen, the background, and the text. Each of these objects is created -by first calling an instance of an in-built Pygame object, and then modifying it to fit our needs. The screen is a slightly special -case, because we still modify the display through Pygame calls, rather than calling methods belonging to the screen object. But for -all other Pygame objects, we first create the object as a copy of a Pygame object, giving it some attributes, and build our game -objects from them.

    -

    With the background, we first create a Pygame Surface object, and make it the size of the screen. We then perform the convert() -operation to convert the Surface to a single pixel format. This is more obviously necessary when we have several images and surfaces, -all of different pixel formats, which makes rendering them quite slow. By converting all the surfaces, we can drastically speed up -rendering times. Finally, we fill the background surface with white (255, 255, 255). These values are RGB (Red Green -Blue), and can be worked out from any good paint program.

    -

    With the text, we require more than one object. First, we create a font object, which defines which font to use, and the size of the -font. Then we create a text object, by using the render method that belongs to our font object, supplying three arguments: -the text to be rendered, whether or not it should be anti-aliased (1=yes, 0=no), and the color of the text (again in RGB format). Next -we create a third text object, which gets the rectangle for the text. The easiest way to understand this is to imagine drawing a -rectangle that will surround all of the text; you can then use this rectangle to get/set the position of the text on the screen. So -in this example we get the rectangle, set its centerx attribute to be the centerx attribute of the -background (so the text's center will be the same as the background's center, i.e. the text will be centered on the screen on the x -axis). We could also set the y coordinate, but it's not any different so I left the text at the top of the screen. As the screen is -small anyway, it didn't seem necessary.

    -
    -
    -

    2.3. Blitting

    -

    Now we have created our game objects, we need to actually render them. If we didn't and we ran the program, we'd just see a -blank window, and the objects would remain invisible. The term used for rendering objects is blitting, which is where -you copy the pixels belonging to said object onto the destination object. So to render the background object, you blit it onto the -screen. In this example, to make things simple, we blit the text onto the background (so the background will now have a copy of the -text on it), and then blit the background onto the screen.

    -

    Blitting is one of the slowest operations in any game, so you need to be careful not to blit too much onto the screen in every frame. -If you have a background image, and a ball flying around the screen, then you could blit the background and then the ball in every -frame, which would cover up the ball's previous position and render the new ball, but this would be pretty slow. A better solution is -to blit the background onto the area that the ball previously occupied, which can be found by the ball's previous rectangle, and then -blitting the ball, so that you are only blitting two small areas.

    -
    -
    -

    2.4. The event loop

    -

    Once you've set the game up, you need to put it into a loop so that it will continuously run until the user signals that he/she wants -to exit. So you start an open while loop, and then for each iteration of the loop, which will be each frame of the game, -update the game. The first thing is to check for any Pygame events, which will be the user hitting the keyboard, clicking a mouse -button, moving a joystick, resizing the window, or trying to close it. In this case, we simply want to watch out for for user trying -to quit the game by closing the window, in which case the game should return, which will end the while loop. -Then we simply need to re-blit the background, and flip (update) the display to have everything drawn. OK, as nothing moves or happens -in this example, we don't strictly speaking need to re-blit the background in every iteration, but I put it in because when things are -moving around on the screen, you will need to do all your blitting here.

    -
    -
    -

    2.5. Ta-da!

    -

    And that's it - your most basic Pygame game! All games will take a form similar to this, but with lots more code for the actual game -functions themselves, which are more to do your with programming, and less guided in structure by the workings of Pygame. This is what -this tutorial is really about, and will now go onto.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games3.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games3.html deleted file mode 100644 index 46b3d6d..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games3.html +++ /dev/null @@ -1,224 +0,0 @@ - - - - - - - - Kicking things off — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    3. Kicking things off

    -

    The first sections of code are relatively simple, and, once written, can usually be reused in every game you consequently make. They -will do all of the boring, generic tasks like loading modules, loading images, opening networking connections, playing music, and so -on. They will also include some simple but effective error handling, and any customisation you wish to provide on top of functions -provided by modules like sys and pygame.

    -
    -

    3.1. The first lines, and loading modules

    -

    First off, you need to start off your game and load up your modules. It's always a good idea to set a few things straight at the top of -the main source file, such as the name of the file, what it contains, the license it is under, and any other helpful info you might -want to give those who will be looking at it. Then you can load modules, with some error checking so that Python doesn't print out -a nasty traceback, which non-programmers won't understand. The code is fairly simple, so I won't bother explaining any of it:

    -
    #!/usr/bin/env python
    -#
    -# Tom's Pong
    -# A simple pong game with realistic physics and AI
    -# http://tomchance.org.uk/projects/pong
    -#
    -# Released under the GNU General Public License
    -
    -VERSION = "0.4"
    -
    -try:
    -    import sys
    -    import random
    -    import math
    -    import os
    -    import getopt
    -    import pygame
    -    from socket import *
    -    from pygame.locals import *
    -except ImportError, err:
    -    print(f"couldn't load module. {err}")
    -    sys.exit(2)
    -
    -
    -
    -
    -

    3.2. Resource handling functions

    -

    In the Line By Line Chimp example, the first code to be written was for loading images and sounds. As these -were totally independent of any game logic or game objects, they were written as separate functions, and were written first so -that later code could make use of them. I generally put all my code of this nature first, in their own, classless functions; these -will, generally speaking, be resource handling functions. You can of course create classes for these, so that you can group them -together, and maybe have an object with which you can control all of your resources. As with any good programming environment, it's up -to you to develop your own best practice and style.

    -

    It's always a good idea to write your own resource handling functions, -because although Pygame has methods for opening images and sounds, and other modules will have their methods of opening other -resources, those methods can take up more than one line, they can require consistent modification by yourself, and they often don't -provide satisfactory error handling. Writing resource handling functions gives you sophisticated, reusable code, and gives you more -control over your resources. Take this example of an image loading function:

    -
    def load_png(name):
    -    """ Load image and return image object"""
    -    fullname = os.path.join("data", name)
    -    try:
    -        image = pygame.image.load(fullname)
    -        if image.get_alpha() is None:
    -            image = image.convert()
    -        else:
    -            image = image.convert_alpha()
    -    except FileNotFoundError:
    -        print(f"Cannot load image: {fullname}")
    -        raise SystemExit
    -    return image, image.get_rect()
    -
    -
    -

    Here we make a more sophisticated image loading function than the one provided by pygame.image.load()Load new image from a file (or file-like object).. Note that -the first line of the function is a documentation string describing what the function does, and what object(s) it returns. The -function assumes that all of your images are in a directory called data, and so it takes the filename and creates the full pathname, -for example data/ball.png, using the os module to ensure cross-platform compatibility. Then it -tries to load the image, and convert any alpha regions so you can achieve transparency, and it returns a more human-readable error -if there's a problem. Finally it returns the image object, and its rect.

    -

    You can make similar functions for loading any other resources, such as loading sounds. You can also make resource handling classes, -to give you more flexibility with more complex resources. For example, you could make a music class, with an __init__ -function that loads the sound (perhaps borrowing from a load_sound() function), a function to pause the music, and a -function to restart. Another handy resource handling class is for network connections. Functions to open sockets, pass data with -suitable security and error checking, close sockets, finger addresses, and other network tasks, can make writing a game with network -capabilities relatively painless.

    -

    Remember the chief task of these functions/classes is to ensure that by the time you get around to writing game object classes, -and the main loop, there's almost nothing left to do. Class inheritance can make these basic classes especially handy. Don't go -overboard though; functions which will only be used by one class should be written as part of that class, not as a global -function.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games4.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games4.html deleted file mode 100644 index 5bda444..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games4.html +++ /dev/null @@ -1,253 +0,0 @@ - - - - - - - - Game object classes — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    4. Game object classes

    -

    Once you've loaded your modules, and written your resource handling functions, you'll want to get on to writing some game objects. -The way this is done is fairly simple, though it can seem complex at first. You write a class for each type of object in the game, -and then create an instance of those classes for the objects. You can then use those classes' methods to manipulate the objects, -giving objects some motion and interactive capabilities. So your game, in pseudo-code, will look like this:

    -
    #!/usr/bin/python
    -
    -# [load modules here]
    -
    -# [resource handling functions here]
    -
    -class Ball:
    -    # [ball functions (methods) here]
    -    # [e.g. a function to calculate new position]
    -    # [and a function to check if it hits the side]
    -
    -def main:
    -    # [initiate game environment here]
    -
    -    # [create new object as instance of ball class]
    -    ball = Ball()
    -
    -    while True:
    -        # [check for user input]
    -
    -        # [call ball's update function]
    -        ball.update()
    -
    -
    -

    This is, of course, a very simple example, and you'd need to put in all the code, instead of those little bracketed comments. But -you should get the basic idea. You create a class, into which you put all the functions for a ball, including __init__, -which would create all the ball's attributes, and update, which would move the ball to its new position, before blitting -it onto the screen in this position.

    -

    You can then create more classes for all of your other game objects, and then create instances of them so that you can handle them -easily in the main function and the main program loop. Contrast this with initiating the ball in the main -function, and then having lots of classless functions to manipulate a set ball object, and you'll hopefully see why using classes is -an advantage: It allows you to put all of the code for each object in one place; it makes using objects easier; it makes adding new -objects, and manipulating them, more flexible. Rather than adding more code for each new ball object, you could simply create new -instances of the Ball class for each new ball object. Magic!

    -
    -

    4.1. A simple ball class

    -

    Here is a simple class with the functions necessary for creating a ball object that will, if the update function is called -in the main loop, move across the screen:

    -
    class Ball(pygame.sprite.Sprite):
    -    """A ball that will move across the screen
    -    Returns: ball object
    -    Functions: update, calcnewpos
    -    Attributes: area, vector"""
    -
    -    def __init__(self, vector):
    -        pygame.sprite.Sprite.__init__(self)
    -        self.image, self.rect = load_png('ball.png')
    -        screen = pygame.display.get_surface()
    -        self.area = screen.get_rect()
    -        self.vector = vector
    -
    -    def update(self):
    -        newpos = self.calcnewpos(self.rect,self.vector)
    -        self.rect = newpos
    -
    -    def calcnewpos(self,rect,vector):
    -        (angle,z) = vector
    -        (dx,dy) = (z*math.cos(angle),z*math.sin(angle))
    -        return rect.move(dx,dy)
    -
    -
    -

    Here we have the Ball class, with an __init__ function that sets the ball up, an update -function that changes the ball's rectangle to be in the new position, and a calcnewpos function to calculate the ball's -new position based on its current position, and the vector by which it is moving. I'll explain the physics in a moment. The one other -thing to note is the documentation string, which is a little bit longer this time, and explains the basics of the class. These strings -are handy not only to yourself and other programmers looking at the code, but also for tools to parse your code and document it. They -won't make much of a difference in small programs, but with large ones they're invaluable, so it's a good habit to get into.

    -
    -

    4.1.1. Diversion 1: Sprites

    -

    The other reason for creating a class for each object is sprites. Each image you render in your game will be a sprite object, and so -to begin with, the class for each object should inherit the Sprite class. -This is a really nice feature of Python - class -inheritance. Now the Ball class has all of the functions that come with the Sprite class, and any object -instances of the Ball class will be registered by Pygame as sprites. Whereas with text and the background, which don't -move, it's OK to blit the object onto the background, Pygame handles sprite objects in a different manner, which you'll see when we -look at the whole program's code.

    -

    Basically, you create both a ball object, and a sprite object for that ball, and you then call the ball's update function on the -sprite object, thus updating the sprite. Sprites also give you sophisticated ways of determining if two objects have collided. -Normally you might just check in the main loop to see if their rectangles overlap, but that would involve a lot of code, which would -be a waste because the Sprite class provides two functions (spritecollide and groupcollide) -to do this for you.

    -
    -
    -

    4.1.2. Diversion 2: Vector physics

    -

    Other than the structure of the Ball class, the notable thing about this code is the vector physics, used to calculate -the ball's movement. With any game involving angular movement, you won't get very far unless you're comfortable with trigonometry, so -I'll just introduce the basics you need to know to make sense of the calcnewpos function.

    -

    To begin with, you'll notice that the ball has an attribute vector, which is made up of angle and z. -The angle is measured in radians, and will give you the direction in which the ball is moving. Z is the speed at which the ball -moves. So by using this vector, we can determine the direction and speed of the ball, and therefore how much it will move on the x and -y axes:

    -../../_images/tom_radians.webp -

    The diagram above illustrates the basic maths behind vectors. In the left hand diagram, you can see the ball's projected movement -represented by the blue line. The length of that line (z) represents its speed, and the angle is the direction in which -it will move. The angle for the ball's movement will always be taken from the x axis on the right, and it is measured clockwise from -that line, as shown in the diagram.

    -

    From the angle and speed of the ball, we can then work out how much it has moved along the x and y axes. We need to do this because -Pygame doesn't support vectors itself, and we can only move the ball by moving its rectangle along the two axes. So we need to -resolve the angle and speed into its movement on the x axis (dx) and on the y axis (dy). This is a simple matter of -trigonometry, and can be done with the formulae shown in the diagram.

    -

    If you've studied elementary trigonometry before, none of this should be news to you. But just in case you're forgetful, here are some -useful formulae to remember, that will help you visualise the angles (I find it easier to visualise angles in degrees than in radians!)

    -../../_images/tom_formulae.webp -
    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games5.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games5.html deleted file mode 100644 index b3de42a..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games5.html +++ /dev/null @@ -1,242 +0,0 @@ - - - - - - - - User-controllable objects — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    5. User-controllable objects

    -

    So far you can create a Pygame window, and render a ball that will fly across the screen. The next step is to make some bats which -the user can control. This is potentially far more simple than the ball, because it requires no physics (unless your user-controlled -object will move in ways more complex than up and down, e.g. a platform character like Mario, in which case you'll need more physics). -User-controllable objects are pretty easy to create, thanks to Pygame's event queue system, as you'll see.

    -
    -

    5.1. A simple bat class

    -

    The principle behind the bat class is similar to that of the ball class. You need an __init__ function to initialise the -ball (so you can create object instances for each bat), an update function to perform per-frame changes on the bat before -it is blitted the bat to the screen, and the functions that will define what this class will actually do. Here's some sample code:

    -
    class Bat(pygame.sprite.Sprite):
    -    """Movable tennis 'bat' with which one hits the ball
    -    Returns: bat object
    -    Functions: reinit, update, moveup, movedown
    -    Attributes: which, speed"""
    -
    -    def __init__(self, side):
    -        pygame.sprite.Sprite.__init__(self)
    -        self.image, self.rect = load_png("bat.png")
    -        screen = pygame.display.get_surface()
    -        self.area = screen.get_rect()
    -        self.side = side
    -        self.speed = 10
    -        self.state = "still"
    -        self.reinit()
    -
    -    def reinit(self):
    -        self.state = "still"
    -        self.movepos = [0,0]
    -        if self.side == "left":
    -            self.rect.midleft = self.area.midleft
    -        elif self.side == "right":
    -            self.rect.midright = self.area.midright
    -
    -    def update(self):
    -        newpos = self.rect.move(self.movepos)
    -        if self.area.contains(newpos):
    -            self.rect = newpos
    -        pygame.event.pump()
    -
    -    def moveup(self):
    -        self.movepos[1] = self.movepos[1] - (self.speed)
    -        self.state = "moveup"
    -
    -    def movedown(self):
    -        self.movepos[1] = self.movepos[1] + (self.speed)
    -        self.state = "movedown"
    -
    -
    -

    As you can see, this class is very similar to the ball class in its structure. But there are differences in what each function does. -First of all, there is a reinit function, which is used when a round ends, and the bat needs to be set back in its starting place, -with any attributes set back to their necessary values. Next, the way in which the bat is moved is a little more complex than with the -ball, because here its movement is simple (up/down), but it relies on the user telling it to move, unlike the ball which just keeps -moving in every frame. To make sense of how the bat moves, it is helpful to look at a quick diagram to show the sequence of events:

    -../../_images/tom_event-flowchart.webp -

    What happens here is that the person controlling the bat pushes down on the key that moves the bat up. For each iteration of the main -game loop (for every frame), if the key is still held down, then the state attribute of that bat object will be set to -"moving", and the moveup function will be called, causing the ball's y position to be reduced by the value of the -speed attribute (in this example, 10). In other words, so long as the key is held down, the bat will move up the screen -by 10 pixels per frame. The state attribute isn't used here yet, but it's useful to know if you're dealing with spin, or -would like some useful debugging output.

    -

    As soon as the player lets go of that key, the second set of boxes is invoked, and the state attribute of the bat object -will be set back to "still", and the movepos attribute will be set back to [0,0], meaning that when the update function is called, it won't move the bat any more. So when the player lets go of the key, the bat stops moving. Simple!

    -
    -

    5.1.1. Diversion 3: Pygame events

    -

    So how do we know when the player is pushing keys down, and then releasing them? With the Pygame event queue system of course! It's a -really easy system to use and understand, so this shouldn't take long :) You've already seen the event queue in action in the basic -Pygame program, where it was used to check if the user was quitting the application. The code for moving the bat is about as simple -as that:

    -
    for event in pygame.event.get():
    -    if event.type == QUIT:
    -        return
    -    elif event.type == KEYDOWN:
    -        if event.key == K_UP:
    -            player.moveup()
    -        if event.key == K_DOWN:
    -            player.movedown()
    -    elif event.type == KEYUP:
    -        if event.key == K_UP or event.key == K_DOWN:
    -            player.movepos = [0,0]
    -            player.state = "still"
    -
    -
    -

    Here assume that you've already created an instance of a bat, and called the object player. You can see the familiar -layout of the for structure, which iterates through each event found in the Pygame event queue, which is retrieved with -the event.get() function. As the user hits keys, pushes mouse buttons and moves the joystick about, those actions are -pumped into the Pygame event queue, and left there until dealt with. So in each iteration of the main game loop, you go through -these events, checking if they're ones you want to deal with, and then dealing with them appropriately. The event.pump() -function that was in the Bat.update function is then called in every iteration to pump out old events, and keep the queue -current.

    -

    First we check if the user is quitting the program, and quit it if they are. Then we check if any keys are being pushed down, and if -they are, we check if they're the designated keys for moving the bat up and down. If they are, then we call the appropriate moving -function, and set the player state appropriately (though the states moveup and movedown and changed in the moveup() and -movedown() functions, which makes for neater code, and doesn't break encapsulation, which means that you -assign attributes to the object itself, without referring to the name of the instance of that object). Notice here we have three -states: still, moveup, and movedown. Again, these come in handy if you want to debug or calculate spin. We also check if any keys have -been "let go" (i.e. are no longer being held down), and again if they're the right keys, we stop the bat from moving.

    -
    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games6.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games6.html deleted file mode 100644 index 8eb110b..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/en/tom-games6.html +++ /dev/null @@ -1,441 +0,0 @@ - - - - - - - - Putting it all together — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    6. Putting it all together

    -

    So far you've learnt all the basics necessary to build a simple game. You should understand how to create Pygame objects, how Pygame -displays objects, how it handles events, and how you can use physics to introduce some motion into your game. Now I'll just show how -you can take all those chunks of code and put them together into a working game. What we need first is to let the ball hit the sides -of the screen, and for the bat to be able to hit the ball, otherwise there's not going to be much gameplay involved. We do this -using Pygame's collision methods.

    -
    -

    6.1. Let the ball hit sides

    -

    The basic principle behind making it bounce of the sides is easy to grasp. You grab the coordinates of the four corners of the ball, -and check to see if they correspond with the x or y coordinate of the edge of the screen. So if the top right and top left corners both -have a y coordinate of zero, you know that the ball is currently on the top edge of the screen. We do all this in the update function, -after we've worked out the new position of the ball.

    -
    if not self.area.contains(newpos):
    -    tl = not self.area.collidepoint(newpos.topleft)
    -    tr = not self.area.collidepoint(newpos.topright)
    -    bl = not self.area.collidepoint(newpos.bottomleft)
    -    br = not self.area.collidepoint(newpos.bottomright)
    -    if tr and tl or (br and bl):
    -        angle = -angle
    -    if tl and bl:
    -        self.offcourt(player=2)
    -    if tr and br:
    -        self.offcourt(player=1)
    -
    -self.vector = (angle,z)
    -
    -
    -

    Here we check to see if the area -contains the new position of the ball (it always should, so we needn't have an else clause, -though in other circumstances you might want to consider it). We then check if the coordinates for the four corners -are colliding with the area's edges, and create objects for each result. If they are, the objects will have a value of 1, -or True. If they don't, then the value will be None, or False. We then see if it has hit the top or bottom, and if it -has we change the ball's direction. Handily, using radians we can do this by simply reversing its positive/negative value. -We also check to see if the ball has gone off the sides, and if it has we call the offcourt function. -This, in my game, resets the ball, adds 1 point to the score of the player specified when calling the function, and displays the new score.

    -

    Finally, we recompile the vector based on the new angle. And that is it. The ball will now merrily bounce off the walls and go -offcourt with good grace.

    -
    -
    -

    6.2. Let the ball hit bats

    -

    Making the ball hit the bats is very similar to making it hit the sides of the screen. We still use the collide method, but this time -we check to see if the rectangles for the ball and either bat collide. In this code I've also put in some extra code to avoid various -glitches. You'll find that you'll have to put all sorts of extra code in to avoid glitches and bugs, so it's good to get used to seeing -it.

    -
    else:
    -    # Deflate the rectangles so you can't catch a ball behind the bat
    -    player1.rect.inflate(-3, -3)
    -    player2.rect.inflate(-3, -3)
    -
    -    # Do ball and bat collide?
    -    # Note I put in an odd rule that sets self.hit to 1 when they collide, and unsets it in the next
    -    # iteration. this is to stop odd ball behaviour where it finds a collision *inside* the
    -    # bat, the ball reverses, and is still inside the bat, so bounces around inside.
    -    # This way, the ball can always escape and bounce away cleanly
    -    if self.rect.colliderect(player1.rect) == 1 and not self.hit:
    -        angle = math.pi - angle
    -        self.hit = not self.hit
    -    elif self.rect.colliderect(player2.rect) == 1 and not self.hit:
    -        angle = math.pi - angle
    -        self.hit = not self.hit
    -    elif self.hit:
    -        self.hit = not self.hit
    -self.vector = (angle,z)
    -
    -
    -

    We start this section with an else statement, because this carries on from the previous chunk of code to check if the ball -hits the sides. It makes sense that if it doesn't hit the sides, it might hit a bat, so we carry on the conditional statement. The -first glitch to fix is to shrink the players' rectangles by 3 pixels in both dimensions, to stop the bat catching a ball that goes -behind them (if you imagine you just move the bat so that as the ball travels behind it, the rectangles overlap, and so normally the -ball would then have been "hit" - this prevents that).

    -

    Next we check if the rectangles collide, with one more glitch fix. Notice that I've commented on these odd bits of code - it's always -good to explain bits of code that are abnormal, both for others who look at your code, and so you understand it when you come back to -it. The without the fix, the ball might hit a corner of the bat, change direction, and one frame later still find itself inside the -bat. Then it would again think it has been hit, and change its direction. This can happen several times, making the ball's motion -completely unrealistic. So we have a variable, self.hit, which we set to True when it has been hit, and False one frame -later. When we check if the rectangles have collided, we also check if self.hit is True/False, to stop internal bouncing.

    -

    The important code here is pretty easy to understand. All rectangles have a colliderect -function, into which you feed the rectangle of another object, which returns True if the rectangles do overlap, and False if not. -If they do, we can change the direction by subtracting the current angle from pi (again, a handy trick you can do with radians, -which will adjust the angle by 90 degrees and send it off in the right direction; you might find at this point that a thorough -understanding of radians is in order!). Just to finish the glitch checking, we switch self.hit back to False if it's the frame -after they were hit.

    -

    We also then recompile the vector. You would of course want to remove the same line in the previous chunk of code, so that you only do -this once after the if-else conditional statement. And that's it! The combined code will now allow the ball to hit sides and bats.

    -
    -
    -

    6.3. The Finished product

    -

    The final product, with all the bits of code thrown together, as well as some other bits ofcode to glue it all together, will look -like this:

    -
    #
    -# Tom's Pong
    -# A simple pong game with realistic physics and AI
    -# http://tomchance.org.uk/projects/pong
    -#
    -# Released under the GNU General Public License
    -
    -VERSION = "0.4"
    -
    -try:
    -    import sys
    -    import random
    -    import math
    -    import os
    -    import getopt
    -    import pygame
    -    from socket import *
    -    from pygame.locals import *
    -except ImportError, err:
    -    print(f"couldn't load module. {err}")
    -    sys.exit(2)
    -
    -def load_png(name):
    -    """ Load image and return image object"""
    -    fullname = os.path.join("data", name)
    -    try:
    -        image = pygame.image.load(fullname)
    -        if image.get_alpha is None:
    -            image = image.convert()
    -        else:
    -            image = image.convert_alpha()
    -    except FileNotFoundError:
    -        print(f"Cannot load image: {fullname}")
    -        raise SystemExit
    -    return image, image.get_rect()
    -
    -class Ball(pygame.sprite.Sprite):
    -    """A ball that will move across the screen
    -    Returns: ball object
    -    Functions: update, calcnewpos
    -    Attributes: area, vector"""
    -
    -    def __init__(self, (xy), vector):
    -        pygame.sprite.Sprite.__init__(self)
    -        self.image, self.rect = load_png("ball.png")
    -        screen = pygame.display.get_surface()
    -        self.area = screen.get_rect()
    -        self.vector = vector
    -        self.hit = 0
    -
    -    def update(self):
    -        newpos = self.calcnewpos(self.rect,self.vector)
    -        self.rect = newpos
    -        (angle,z) = self.vector
    -
    -        if not self.area.contains(newpos):
    -            tl = not self.area.collidepoint(newpos.topleft)
    -            tr = not self.area.collidepoint(newpos.topright)
    -            bl = not self.area.collidepoint(newpos.bottomleft)
    -            br = not self.area.collidepoint(newpos.bottomright)
    -            if tr and tl or (br and bl):
    -                angle = -angle
    -            if tl and bl:
    -                #self.offcourt()
    -                angle = math.pi - angle
    -            if tr and br:
    -                angle = math.pi - angle
    -                #self.offcourt()
    -        else:
    -            # Deflate the rectangles so you can't catch a ball behind the bat
    -            player1.rect.inflate(-3, -3)
    -            player2.rect.inflate(-3, -3)
    -
    -            # Do ball and bat collide?
    -            # Note I put in an odd rule that sets self.hit to 1 when they collide, and unsets it in the next
    -            # iteration. this is to stop odd ball behaviour where it finds a collision *inside* the
    -            # bat, the ball reverses, and is still inside the bat, so bounces around inside.
    -            # This way, the ball can always escape and bounce away cleanly
    -            if self.rect.colliderect(player1.rect) == 1 and not self.hit:
    -                angle = math.pi - angle
    -                self.hit = not self.hit
    -            elif self.rect.colliderect(player2.rect) == 1 and not self.hit:
    -                angle = math.pi - angle
    -                self.hit = not self.hit
    -            elif self.hit:
    -                self.hit = not self.hit
    -        self.vector = (angle,z)
    -
    -    def calcnewpos(self,rect,vector):
    -        (angle,z) = vector
    -        (dx,dy) = (z*math.cos(angle),z*math.sin(angle))
    -        return rect.move(dx,dy)
    -
    -class Bat(pygame.sprite.Sprite):
    -    """Movable tennis 'bat' with which one hits the ball
    -    Returns: bat object
    -    Functions: reinit, update, moveup, movedown
    -    Attributes: which, speed"""
    -
    -    def __init__(self, side):
    -        pygame.sprite.Sprite.__init__(self)
    -        self.image, self.rect = load_png("bat.png")
    -        screen = pygame.display.get_surface()
    -        self.area = screen.get_rect()
    -        self.side = side
    -        self.speed = 10
    -        self.state = "still"
    -        self.reinit()
    -
    -    def reinit(self):
    -        self.state = "still"
    -        self.movepos = [0,0]
    -        if self.side == "left":
    -            self.rect.midleft = self.area.midleft
    -        elif self.side == "right":
    -            self.rect.midright = self.area.midright
    -
    -    def update(self):
    -        newpos = self.rect.move(self.movepos)
    -        if self.area.contains(newpos):
    -            self.rect = newpos
    -        pygame.event.pump()
    -
    -    def moveup(self):
    -        self.movepos[1] = self.movepos[1] - (self.speed)
    -        self.state = "moveup"
    -
    -    def movedown(self):
    -        self.movepos[1] = self.movepos[1] + (self.speed)
    -        self.state = "movedown"
    -
    -
    -def main():
    -    # Initialise screen
    -    pygame.init()
    -    screen = pygame.display.set_mode((640, 480))
    -    pygame.display.set_caption("Basic Pong")
    -
    -    # Fill background
    -    background = pygame.Surface(screen.get_size())
    -    background = background.convert()
    -    background.fill((0, 0, 0))
    -
    -    # Initialise players
    -    global player1
    -    global player2
    -    player1 = Bat("left")
    -    player2 = Bat("right")
    -
    -    # Initialise ball
    -    speed = 13
    -    rand = ((0.1 * (random.randint(5,8))))
    -    ball = Ball((0,0),(0.47,speed))
    -
    -    # Initialise sprites
    -    playersprites = pygame.sprite.Group((player1, player2))
    -    ballsprite = pygame.sprite.Group(ball)
    -
    -    # Blit everything to the screen
    -    screen.blit(background, (0, 0))
    -    pygame.display.flip()
    -
    -    # Initialise clock
    -    clock = pygame.time.Clock()
    -
    -    # Event loop
    -    while True:
    -        # Make sure game doesn't run at more than 60 frames per second
    -        clock.tick(60)
    -
    -        for event in pygame.event.get():
    -            if event.type == QUIT:
    -                return
    -            elif event.type == KEYDOWN:
    -                if event.key == K_a:
    -                    player1.moveup()
    -                if event.key == K_z:
    -                    player1.movedown()
    -                if event.key == K_UP:
    -                    player2.moveup()
    -                if event.key == K_DOWN:
    -                    player2.movedown()
    -            elif event.type == KEYUP:
    -                if event.key == K_a or event.key == K_z:
    -                    player1.movepos = [0,0]
    -                    player1.state = "still"
    -                if event.key == K_UP or event.key == K_DOWN:
    -                    player2.movepos = [0,0]
    -                    player2.state = "still"
    -
    -        screen.blit(background, ball.rect, ball.rect)
    -        screen.blit(background, player1.rect, player1.rect)
    -        screen.blit(background, player2.rect, player2.rect)
    -        ballsprite.update()
    -        playersprites.update()
    -        ballsprite.draw(screen)
    -        playersprites.draw(screen)
    -        pygame.display.flip()
    -
    -
    -if __name__ == "__main__":
    -    main()
    -
    -
    -

    As well as showing you the final product, I'll point you back to TomPong, upon which all of this is based. Download it, have a look -at the source code, and you'll see a full implementation of pong using all of the code you've seen in this tutorial, as well as lots of -other code I've added in various versions, such as some extra physics for spinning, and various other bug and glitch fixes.

    -

    Oh, find TomPong at http://tomchance.org.uk/projects/pong.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/es/ChimpanceLineaporLinea.html b/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/es/ChimpanceLineaporLinea.html deleted file mode 100644 index 359abf3..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/generated/tutorials/es/ChimpanceLineaporLinea.html +++ /dev/null @@ -1,621 +0,0 @@ - - - - - - - - Tutorial de Pygame - Ejemplo del Chimpancé, Línea Por Línea — pygame-ce v2.5.8 documentation - - - - - - - - - - - - - - -
    - -
    -
    - - -
    -
    - -
    -
    - -
    -
    -

    Chimpancé, Línea Por Línea

    -
    -
    Autor:
    -

    Pete Shinners. Traducción al español: Estefania Pivaral Serrano

    -
    -
    Contacto:
    -

    pete@shinners.org

    -
    -
    -
    -
    -
    -

    Introducción

    -

    Entre los ejemplos de pygame hay un ejemplo simple llamado "chimp" (chimpancé). -Este ejemplo simula un mono golpeable que se mueve alrededor de la pantalla -con promesas de riquezas y recomepensas. El ejemplo en sí es muy simple y acarrea -poco código de comprobación de error. Como modelo de programa, Chimp demuestra muchas -de las bondades de pygame, como por ejemplo crear una ventana, cargar imágenes -y sonidos, representar texto, y manejo de eventos básicos y del mouse.

    -

    El programa y las imagenes se pueden encontrar dentro de la fuente estándar -de distribución de pygame. Se puede ejecutar al correr python -m pygame.examples.chimp -en la terminal.

    -

    Este tutorial atravesará el código bloque a bloque, explicando cómo -funciona el mismo. Además, se hará mención de cómo se puede -mejorar el código y qué errores de comprobación podrían ser de ayuda.

    -

    Este tutorial es excelente para aquellas personas que están buscando -una primera aproximación a códigos de pygame. Una vez que pygame -esté completamente instalado, podrás encontrar y ejecutar la demostración -del chimpancé para ti mismo en el directorio de ejemplos.

    -
    -

    (no, este no es un anuncio, es una captura de pantalla)

    -chimp game banner -

    Full Source

    -
    -
    -
    -

    Importación de Módulos

    -

    Este es el código que importa todos los módulos necesarios del programa. -Este código también comprueba la disponibilidad de algunos de los módulos opcionales -de pygame.

    -
    # Import Modules
    -import os
    -import pygame as pg
    -
    -if not pg.font:
    -    print("Warning, fonts disabled")
    -if not pg.mixer:
    -    print("Warning, sound disabled")
    -
    -main_dir = os.path.split(os.path.abspath(__file__))[0]
    -data_dir = os.path.join(main_dir, "data")
    -
    -
    -

    Primero, se importa el módulo estándar de python "os" (sistema operativo). -Esto permite hacer cosas como crear rutas de archivos independientes de la -platforma.

    -

    En la sigueinte línea, se importa el paquete de pygame. En nuestro caso, -importamos pygame como pg, para que todas las funciones de pygame puedan -ser referenciadas desde el espacio de nombres pg.

    -

    Algunos de los módulos de pygame son opcionales, y si no fueran encontrados, -la evaluación será False. Es por eso que decidimos mostrar (print) un agradable -mensaje de advertencia si los módulos font o -mixer no están disponibles. -(Aunque estos solo podrían no estar disponibles en situaciones poco comunes).

    -

    Finalmente, se preparan dos rutas que serán usadas para el resto del código. -Una de ellas es main_dir, que usa el módulo os.path y la variable __file__ -asignada por Python para localizar el archivo de juegos de python, y extraer la carpeta -desde esa ruta. Luego, ésta prepara la ruta data_dir para indicarle a las -funciones de carga exactamente dónde buscar.

    -
    -
    -

    Carga de Recursos

    -

    A continuación, se presentan dos funciones que se pueden usar para cargar imágenes y sonidos. -En esta sección examinaremos cada función individualmente.

    -
    def load_image(name, colorkey=None, scale=1):
    -    fullname = os.path.join(data_dir, name)
    -    image = pg.image.load(fullname)
    -
    -    size = image.get_size()
    -    size = (size[0] * scale, size[1] * scale)
    -    image = pg.transform.scale(image, size)
    -
    -    image = image.convert()
    -    if colorkey is not None:
    -        if colorkey == -1:
    -            colorkey = image.get_at((0, 0))
    -        image.set_colorkey(colorkey, pg.RLEACCEL)
    -    return image, image.get_rect()
    -
    -
    -

    Esta función toma el nombre de la imagen a cargar. Opcionalmente, también -toma un argumento que puede usar para definir la clave de color (colorkey) de -la imagen, y un argumento para determinar la escala de la imagen. -La clave de color se usa en la gráfica para representar un color en la imagen -que es transparente.

    -

    Lo que esta función hace en primera instancia es crearle al archivo un nombre -de ruta completo. -En este ejemplo, todos los recursos están en el subdirectorio "data". Al usar -la función os.path.join, se creará el nombre de ruta para cualquier plataforma -en que se ejecute el juego.

    -

    El paso siguiente es cargar la imagen usando la función pygame.image.load()Load new image from a file (or file-like object).. -Luego de que la imagen se cargue, llamamos a la función -convert(). Al hacer esto se crea una nueva copia del Surface y convierte -su formato de color y la profundidad, de tal forma que coincida con el mostrado. -Esto significa que el dibujo (blitting) de la imagen a la pantalla sucederá -lo más rápido posible.

    -

    Luego, usando la función pygame.transform.scale()Resize to new resolution. se definirá el tamaño de -la imagen. Esta función toma una Surface y el tamaño al cual se debería adecuar. -Para darle tamaño con números escalares, se puede tomar la medida y determinar las -dimensiones x e y con número escalar.

    -

    Finalmente, definimos la clave de color para la imagen. Si el usuario suministró -un valor para el parametro de la clave de color, usamos ese valor como la clave -de color de la imagen. Usualmente, éste sería un valor de color RGB -(red-green-blue = rojo-verde-azul), como (255, 255, 255) para el color blanco. -También es posible pasar el valor -1 como la clave de color. En este caso, la -función buscará el color en el píxel de arriba a la izquierda de la imagen, -y lo usará para la clave de color.

    -
    def load_sound(name):
    -    class NoneSound:
    -        def play(self):
    -            pass
    -
    -    if not pg.mixer or not pg.mixer.get_init():
    -        return NoneSound()
    -
    -    fullname = os.path.join(data_dir, name)
    -    sound = pg.mixer.Sound(fullname)
    -
    -    return sound
    -
    -
    -

    La anterior, es la función para cargar un archivo de sonido. Lo primero que hace -esta función es verificar si el módulo pygame.mixerpygame module for loading and playing sounds se importó correctamente. -En caso de no ser así, la función va a devolver una instancia de reproducción de un -sonido de error. Esto obrará como un objeto de Sonido normal para que el juego se -ejecute sin ningún error de comprobación extra.

    -

    Esta funcion es similar a la función de carga de imagen, pero maneja diferentes problemas. -Primero, creamos una ruta completa al sonido de la imagen y cargamos el archivo -de sonido. Luego, simplemente devolvemos el objeto de Sonido cargado.

    -
    -
    -

    Clases de Objetos para Juegos

    -

    En este caso creamos dos clases (classes) que representan los objetos en nuestro juego. -Casi toda la logica del juego se organiza en estas dos clases. A continuación -las revisaremos de a una.

    -
    class Fist(pg.sprite.Sprite):
    -    """moves a clenched fist on the screen, following the mouse"""
    -
    -    def __init__(self):
    -        pg.sprite.Sprite.__init__(self)  # call Sprite initializer
    -        self.image, self.rect = load_image("fist.webp", -1)
    -        self.fist_offset = (-235, -80)
    -        self.punching = False
    -
    -    def update(self):
    -        """move the fist based on the mouse position"""
    -        pos = pg.mouse.get_pos()
    -        self.rect.topleft = pos
    -        self.rect.move_ip(self.fist_offset)
    -        if self.punching:
    -            self.rect.move_ip(15, 25)
    -
    -    def punch(self, target):
    -        """returns true if the fist collides with the target"""
    -        if not self.punching:
    -            self.punching = True
    -            hitbox = self.rect.inflate(-5, -5)
    -            return hitbox.colliderect(target.rect)
    -
    -    def unpunch(self):
    -        """called to pull the fist back"""
    -        self.punching = False
    -
    -
    -

    En este caso, creamos una clase (class) que representa el puño del jugador. Esta se -deriva de la clase Sprite incluida en el módulo pygame.spritepygame module with basic game object classes. La -función __init__ es llamada cuando se crean nuevas instancias de este clase. -Esto le permite a la función __init__ del Sprite preparar nuestro objeto para -ser usado como una imagen (sprite). -Este juego usa uno de los dibujos de sprite de la clase de Grupo. Estas clases -pueden dibujar sprites que tienen un atributo "imagen" y uno "rect". Al cambiar -simplemente estos dos atributos, el compilador (renderer) dibujará la imagen actual -en la posición actual.

    -

    Todos los sprites tienen un método update(). Esta función es tipicamente -llamada una vez por cuadro. Es en esta función donde se debería colocar el código -que mueva y actualice las variables para el sprite. El método de update() para el -movimiento del puño, mueve el puño al lugar donde se encuentre el puntero del mouse. -Asímismo, compensa sutilmente la posición del puño sobre el objeto, si el puño está -en condición de golpear.

    -

    Las siguientes dos funciones punch() y unpunch() cambian la condición de -golpeado del puño. El método punch() también devuelve un valor verdadero si -el puño está chocando con el sprite objetivo.

    -
    class Chimp(pg.sprite.Sprite):
    -    """moves a monkey critter across the screen. it can spin the
    -    monkey when it is punched."""
    -
    -    def __init__(self):
    -        pg.sprite.Sprite.__init__(self)  # call Sprite intializer
    -        self.image, self.rect = load_image("chimp.webp", -1, 4)
    -        screen = pg.display.get_surface()
    -        self.area = screen.get_rect()
    -        self.rect.topleft = 10, 90
    -        self.move = 18
    -        self.dizzy = False
    -
    -    def update(self):
    -        """walk or spin, depending on the monkeys state"""
    -        if self.dizzy:
    -            self._spin()
    -        else:
    -            self._walk()
    -
    -    def _walk(self):
    -        """move the monkey across the screen, and turn at the ends"""
    -        newpos = self.rect.move((self.move, 0))
    -        if not self.area.contains(newpos):
    -            if self.rect.left < self.area.left or self.rect.right > self.area.right:
    -                self.move = -self.move
    -                newpos = self.rect.move((self.move, 0))
    -                self.image = pg.transform.flip(self.image, True, False)
    -        self.rect = newpos
    -
    -    def _spin(self):
    -        """spin the monkey image"""
    -        center = self.rect.center
    -        self.dizzy = self.dizzy + 12
    -        if self.dizzy >= 360:
    -            self.dizzy = False
    -            self.image = self.original
    -        else:
    -            rotate = pg.transform.rotate
    -            self.image = rotate(self.original, self.dizzy)
    -        self.rect = self.image.get_rect(center=center)
    -
    -    def punched(self):
    -        """this will cause the monkey to start spinning"""
    -        if not self.dizzy:
    -            self.dizzy = True
    -            self.original = self.image
    -
    -
    -

    Si bien la clase (class) Chimp está haciendo un poco más de trabajo que el -puño, no resulta mucho más complejo. Esta clase moverá al chimpancé hacia adelante -y hacia atrás, por la pantalla. Cuando el mono es golpeado, él girará -con un efecto de emoción. Esta clase también es derivada de la base de clases -Sprite y es iniciada de igual manera que el puño. -Mientras se inicia, la clase también establece el atributo "area" para que sea -del tamaño de la pantalla de visualización.

    -

    La función update para el chimpancé simplemente se fija en el estado actual -del mono. Esta puede ser "dizzy" (mareado), la cual sería verdadera si el mono -está girando a causa del golpe. La función llama al método _spin o _walk. -Estas funciones son prefijadas con un guión bajo, lo cual en el idioma estándar -de python sugiere que estos métodos deberían ser solo usados por la clase Chimp. -Podríamos incluso hasta escribirlas con un doble guión bajo, lo cual indicaría a -python que realmente intente hacerlas un método privado, pero no necesitamos tal -protección. :)

    -

    El método _walk crea una nueva posición para el mono al mover el 'rect' actual -al centro del puño. Si la nueva posición se cruza hacia afuera del área -de visualización de la pantalla, el movimiento del puño da marcha atrás. -También imita la imagen usando la función pygame.transform.flip()Flip vertically and horizontally.. Este es -un efecto crudo que hace que el mono se vea como si estuviera cambiando de -dirección.

    -

    El método _spin es llamado cuando el mono está actualmente en estado "dizzy" -(mareado). El atributo 'dizzy' es usado para guardar el monto de rotación. -Cuando el mono ha rotado por completo en su eje (360 grados) se resetea la -imagen a la versión original no rotada. Antes de llamar a la función -pygame.transform.rotate()Rotate an image., verás que el código hace una referencia local -a la función simplemente llamanda "rotate". No hay ncesidad de hacer eso en -este ejemplo, aquí fue realizada para mantener la siguiente línea un poco -más corta. Notese que al llamar a la función rotate, se está siempre rotando -la imagen original del mono. Cuando rotamos, hay un pequeña pérdida de calidad. -Rotar repetidamente la misma imagen genera que la calidad se deteriore cada vez -más. Esto se debe a que las esquinas de la imagen van a haber sido rotadas de más, -causando que la imagen se haga más grande. Nos aseguramos que la nueva imagen -coincida con el centro de la vieja imagen, para que de esta forma se rote sin -moverse.

    -

    El último método es punched() el cual indica al sprite que entre en un estado de -mareo. Esto causará que la imagen empice a girar. Además, también crea una copia de -la actual imagen llamada "original".

    -
    -
    -

    Inicializar Todo

    -

    Antes de poder hacer algo con pygame, necesitamos asegurarnos que los módulos -estén inicializados. En este caso, vamos a abrir también una simple ventana de -gráficos. -Ahora estamos en la función main() del programa, la cual ejecuta todo.

    -
    pg.init()
    -screen = pg.display.set_mode((1280, 480), pg.SCALED)
    -pg.display.set_caption("Monkey Fever")
    -pg.mouse.set_visible(False)
    -
    -
    -

    La primera línea para inicializar pygame realiza algo de trabajo por nosotros. -Verifica a través del módulo importado pygame e intenta inicializar cada uno de -ellos. Es posible volver y verificar que los módulos que fallaron al iniciar, pero -no vamos a molestarnos acá con eso. También es posible tomar mucho más control -e inicializar cada módulo en especifico, uno a uno. Ese tipo de control no es -necesario generalmente, pero está disponible en caso de ser deseado.

    -

    Luego, se configura el modo de visualización de gráficos. Notse que el módulo -pygame.displayPygame module to control the display window and screen. es usado para controlar todas las configuraciones de -visualización. En este caso nosotros estamos buscando una ventana 1280x480, -con SCALED, que es la señal de visualización (display flag) -Esto aumenta proporcionalmente la ventana de visualización (display) más grande que la -ventana. (window)

    -

    Por último, establecemos el título de la ventana y apagamos el cursor del mouse -para nuestra ventana. Es una acción básica y ahora tenemos una pequeña ventana negra -que está lista para nuestras instrucciones (bidding) u ofertas. Generalmente, el cursor -se mantiene visible por default, asi que no hay mucha necesidad de realmente -establecer este estado a menos que querramos esconderlo.

    -
    -
    -

    Crear el Fondo

    -

    Nuestro programa va a tener un mensaje de texto en el fondo. Sería bueno -crear un único surface que represente el fondo y lo use repetidas veces. -El primer paso es crear el Surface.

    -
    background = pg.Surface(screen.get_size())
    -background = background.convert()
    -background.fill((170, 238, 187))
    -
    -
    -

    Esto crea el nuevo surface, que en nuestro caso, es del mismo tamaño que -la ventana de visualización. Notese el llamado extra a convert() luego -de crear la Surface. La función convert() sin argumentos es para asegurarnos -que nuestro fondo sea del mismo formato que la ventana de visualización, -lo cual nos va a brindar resultados más rápidos.

    -

    Lo que nosotros hicimos también, fue rellenar el fondo con un color verduzco. -La función fill() suele tomar como argumento tres instancias de colores RGB, -pero soporta muchos formatos de entrada. Para ver todos los formatos de color -veasé pygame.ColorPygame object for color representations..

    -
    -
    -

    Centrar Texto en el Fondo

    -

    Ahora que tenemos el surface del fondo, vamos a representar el texto en él. -Nosotros solo haremos esto si vemos que el módulo pygame.fontpygame module for loading and rendering fonts se importó -correctamente. De no ser así, hay que saltear esta sección.

    -
    if pg.font:
    -    font = pg.font.Font(None, 64)
    -    text = font.render("Pummel The Chimp, And Win $$$", True, (10, 10, 10))
    -    textpos = text.get_rect(centerx=background.get_width() / 2, y=10)
    -    background.blit(text, textpos)
    -
    -
    -

    Tal como pueden ver, hay un par de pasos para realizar esto. Primero, debemos -crear la fuente del objeto y renderizarlo (representarlo) en una nueva Surface. -Luego, buscamos el centro de esa nueva surface y lo pegamos (blit) al fondo.

    -

    La fuente es creada con el constructor Font() del módulo font. Generalmente, -uno va a poner el nombre de la fuente TrueType en esta función, pero también se -puede poner None, como hicimos en este caso, y entonces se usará la fuente -por predeterminada. El constructor Font también necesita la información -del tamaño de la fuente que se quiere crear.

    -

    Luego vamos a represetar (renderizar) la fuente en la nueva surface. La función -render crea una nueva surface que es del tamaño apropiado para nuestro texto. -En este caso, también le estamos pidiendo al render que cree un texto suavizado -(para un lindo efecto de suavidad en la apariencia) y que use un color gris oscuro.

    -

    Lo siguiente que necesitamos es encontrar la posición la posición central, para -colocar el texto en el centro de la pantalla. Creamos un objeto "Rect" de las -dimensiones del texto, lo cual nos permite asignarlo fácilmente al centro de la -pantalla.

    -

    Finalmente, blitteamos (pegamos o copiamos) el texto en la imagen de fondo.

    -
    -
    -

    Mostrar el Fondo mientras Termina el Setup

    -

    Todavía tenemos una ventana negra en la pantalla. Mostremos el fondo -mientras esperamos que se carguen los otros recursos.

    -
    screen.blit(background, (0, 0))
    -pygame.display.flip()
    -
    -
    -

    Esto va a blittear (pegar o copiar) nuestro fondo en la ventana de visualización. -El blit se explica por sí mismo, pero ¿qué está haciendo esa rutina flip?

    -

    En pygame, los cambios en la surface de visualización (display) no se hacen visibles -inmediatamente. Normalmente, la pantalla debe ser actualizacada para que el usuario -pueda ver los cambios realizados. En este caso la función flip() es perfecta para eso -porque se encarga de toda el área de la pantalla.

    -
    -
    -

    Preparar Objetos del Juego

    -

    En este caso crearemos todos los objetos que el juego va a necesitar.

    -
    whiff_sound = load_sound("whiff.wav")
    -punch_sound = load_sound("punch.wav")
    -chimp = Chimp()
    -fist = Fist()
    -allsprites = pg.sprite.Group((chimp, fist))
    -clock = pg.time.Clock()
    -
    -
    -

    Primero cargamos dos efectos de sonido usando la función load_sound, que se -encuentra definida en código arriba. Luego, creamos una instancia para cada -uno de los sprites de la clase. Por último, creamos el sprite -Group que va a contener todos nuestros sprites.

    -

    Nosotros creamos el grupo llamado "allsprites" al pasar una lista con todos los sprites que deberían -pertenecer al grupo. Exise la posibilidad, si más adelante quisieramos, de agregar -o sacar sprites de este grupo, pero para este juego no sería necesario.

    -

    El objeto clock que creamos será usado para ayudar a controlar la frequencia de -cuadros de nuestro juego. Vamos a usarlo en el bucle (loop) principal de nuestro -juego para asegurarnos que no se ejecute demasiado rápido.

    -
    -
    -

    Bucle principal (Main Loop)

    -

    No hay mucho por acá, solo un loop infinito.

    -
    going = True
    -while going:
    -    clock.tick(60)
    -
    -
    -

    Todos los juegos se ejecutan sobre una especie de loop. El orden usual de las cosas -es verificar el estado de la computadora y la entrada de usuario, mover y actualizar -el estado de todos los objetos, y luego dibujarlos en la pantalla. Verás que este -ejemplo no es diferente.

    -

    También haremos un llamado a nuestro objeto clock, que asegurará que nuestro juego -no se ejecute pasando los 60 cuadros por segundo.

    -
    -
    -

    Manejar los Eventos de Entrada

    -

    Este es un caso extremandamente simple para trabajar la cola de eventos.

    -
    for event in pg.event.get():
    -    if event.type == pg.QUIT:
    -        going = False
    -    elif event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE:
    -        going = False
    -    elif event.type == pg.MOUSEBUTTONDOWN:
    -        if fist.punch(chimp):
    -            punch_sound.play()  # punch
    -            chimp.punched()
    -        else:
    -            whiff_sound.play()  # miss
    -    elif event.type == pg.MOUSEBUTTONUP:
    -        fist.unpunch()
    -
    -
    -

    Primero obtenemos todos los Eventos (events) disponibles en pygame y los recorremos en loop. -Las primeras dos pruebas es para ver si el usuario dejó nuestro juego, o si -presionó la tecla de escape. En estos casos, configuramos going en False, -permitiendonos salir del loop infinito.

    -

    A continuación, verificamos si se presionó o si se soltó el botón del mouse. En el -caso de que el botón se haya presionado, preguntamos al primer objeto si chocó con -el mono. Se reproduce el sonido apropiado, y si el mono fue golpeado, le decimos -que empiece a girar (al hacer un llamado a su método punched() )

    -
    -
    -

    Actualizar los Sprites

    -
    allsprites.update()
    -
    -
    -

    Los grupos de Sprite tienen un método update(), que simplemente llama al -método de actualización para todos los sprites que contiene. Cada uno de los -objetos se va a mover, dependiendo de cuál sea el estado en el que estén. Acá -es donde el mono se va a mover de un lado a otro, o va a girar un poco más -lejos si fue recientemente golpeado.

    -
    -
    -

    Dibujar la Escena Completa

    -

    Ahora que todos los objetos están en el lugar indicado, es el momento para -dibujarlos.

    -
    screen.blit(background, (0, 0))
    -allsprites.draw(screen)
    -pygame.display.flip()
    -
    -
    -

    La primera llamada de blit dibujará el fondo en toda la pantalla. Esto borra -todo lo que vimos en el cuadro anterior (ligeramente ineficiente, pero -suficientemnte bueno para este juego). A continuación, llamamos al método -draw() del contenedor de sprites. Ya que este contenedor de sprites es -en realidad una instancia del grupo de sprites "DrawPlain", sabe como dibujar -nuestros sprites. Por último, usamos el método flip() para voltear los contenidos -del software de pygame. Se realiza el flip a través del cargado de la imagen en segundo -plano. Esto hace que todo lo que dibujamos luego se visibilice de una vez.

    -
    -
    -

    Fin del Juego

    -

    El usuario ha salido del juego, hora de limpiar (clean up)

    -
    pg.quit()
    -
    -
    -

    Hacer la limpieza, el cleanup, de la ejecución del juego en pygame es extremandamente -simple. Ya que todas las variables son automáticamente destruidas, nosotros no -tenemos que hacer realmnete nada, únicamente llamar a pg.quit() que explicitamente -hace la limpieza de las partes internas del pygame.

    -
    -
    -
    - - -

    -
    -Edit on GitHub -
    -
    -
    -
    -
    - - - - \ No newline at end of file diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/serve.py b/.venv/lib/python3.14/site-packages/pygame/docs/serve.py deleted file mode 100644 index e5afa91..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/serve.py +++ /dev/null @@ -1,70 +0,0 @@ -# python -m pygame.docs.serve - -import sys -import webbrowser -from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer - -# use relative import here and not absolute, so that `python -m docs` works at -# development time -from . import PKG_DIR, has_local_docs - - -class DocsHandler(SimpleHTTPRequestHandler): - def __init__(self, *args, **kwargs): - super().__init__(*args, **kwargs, directory=str(PKG_DIR)) - - -def serve(address: str, port: int): - with ThreadingHTTPServer((address, port), DocsHandler) as httpd: - try: - httpd.serve_forever() - except KeyboardInterrupt: - print("\nKeyboard interrupt received, exiting.") - sys.exit(0) - - -TARGET = "localhost" - - -def main(): - print("Running a simple server to serve documentation.") - print( - "If you want to just open documentation files in the browser, " - "run 'python -m pygame.docs.static'." - ) - if not has_local_docs(): - print("ERROR: no local documentation found, cannot serve anything, exiting...") - sys.exit(1) - print("WARNING: this is not for production use!") - import argparse - - parser = argparse.ArgumentParser() - parser.add_argument( - "port", - action="store", - default=8000, - type=int, - nargs="?", - help="specify alternate port (default: 8000)", - ) - parser.add_argument( - "--no-browser", - "-n", - action="store_false", - default=True, - dest="open_browser", - help="whether to open a browser tab", - ) - - parsed_args = parser.parse_args() - - print(f"Serving on: http://{TARGET}:{parsed_args.port}") - - if parsed_args.open_browser: - webbrowser.open(f"http://{TARGET}:{parsed_args.port}") - - serve(TARGET, parsed_args.port) - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pygame/docs/static.py b/.venv/lib/python3.14/site-packages/pygame/docs/static.py deleted file mode 100644 index 25aeb7b..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/docs/static.py +++ /dev/null @@ -1,26 +0,0 @@ -import webbrowser - -# use relative import here and not absolute, so that `python -m docs` works at -# development time -from . import PKG_DIR - - -def open_docs(): - main_page = PKG_DIR / "index.html" - if main_page.exists(): - url = main_page.as_uri() - else: - url = "https://pyga.me/docs/" - webbrowser.open(url) - - -def main(): - print("Opening local documentation files in the browser.") - print( - "If you want to run a simple server instead, run 'python -m pygame.docs.serve'." - ) - open_docs() - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pygame/draw.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/draw.cpython-314-x86_64-linux-gnu.so index 7b6ee81..e766e4d 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/draw.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/draw.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/draw.pyi b/.venv/lib/python3.14/site-packages/pygame/draw.pyi index 6bc884c..d574ea3 100644 --- a/.venv/lib/python3.14/site-packages/pygame/draw.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/draw.pyi @@ -1,581 +1,74 @@ -"""Pygame module for drawing shapes. - -Draw several simple shapes to a surface. These functions will work for -rendering to any format of surface. - -Most of the functions take a width argument to represent the size of stroke -(thickness) around the edge of the shape. If a width of 0 is passed the shape -will be filled (solid). - -All the drawing functions respect the clip area for the surface and will be -constrained to that area. The functions return a rectangle representing the -bounding area of changed pixels. This bounding rectangle is the 'minimum' -bounding box that encloses the affected area. - -All the drawing functions accept a color argument that is compatible with -:data:`pygame.typing.ColorLike`. - -A color's alpha value will be written directly into the surface (if the -surface contains pixel alphas), but the draw function will not draw -transparently. - -These functions temporarily lock the surface they are operating on. Many -sequential drawing calls can be sped up by locking and unlocking the surface -object around the draw calls (see :func:`pygame.Surface.lock` and -:func:`pygame.Surface.unlock`). - -.. note :: - See the :mod:`pygame.gfxdraw` module for alternative draw methods. -""" - -from typing import overload +from typing import Optional, Sequence from pygame.rect import Rect from pygame.surface import Surface -from pygame.typing import ColorLike, Point, RectLike, SequenceLike + +from ._common import ColorValue, Coordinate, RectValue def rect( surface: Surface, - color: ColorLike, - rect: RectLike, + color: ColorValue, + rect: RectValue, width: int = 0, border_radius: int = -1, border_top_left_radius: int = -1, border_top_right_radius: int = -1, border_bottom_left_radius: int = -1, border_bottom_right_radius: int = -1, -) -> Rect: - """Draw a rectangle. - - Draws a rectangle on the given surface. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param Rect rect: rectangle to draw, position and dimensions - :param int width: (optional) used for line thickness or to indicate that - the rectangle is to be filled (not to be confused with the width value - of the ``rect`` parameter) - - | if ``width == 0``, (default) fill the rectangle - | if ``width > 0``, used for line thickness - | if ``width < 0``, nothing will be drawn - | - - :param int border_radius: (optional) used for drawing rectangle with rounded corners. - The supported range is [0, min(height, width) / 2], with 0 representing a rectangle - without rounded corners. - :param int border_top_left_radius: (optional) used for setting the value of top left - border. If you don't set this value, it will use the border_radius value. - :param int border_top_right_radius: (optional) used for setting the value of top right - border. If you don't set this value, it will use the border_radius value. - :param int border_bottom_left_radius: (optional) used for setting the value of bottom left - border. If you don't set this value, it will use the border_radius value. - :param int border_bottom_right_radius: (optional) used for setting the value of bottom right - border. If you don't set this value, it will use the border_radius value. - - | if ``border_radius < 1`` it will draw rectangle without rounded corners - | if any of border radii has the value ``< 0`` it will use value of the border_radius - | If sum of radii on the same side of the rectangle is greater than the rect size the radii - | will get scaled - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the position of the given ``rect`` - parameter and its width and height will be 0 - :rtype: Rect - - .. note:: - The :func:`pygame.Surface.fill()` method works just as well for drawing - filled rectangles and can be hardware accelerated on some platforms. - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - .. versionchangedold:: 2.0.0.dev8 Added support for border radius. - .. versionchangedold:: 2.1.1 - Drawing rects with width now draws the width correctly inside the - rect's area, rather than using an internal call to draw.lines(), - which had half the width spill outside the rect area. - """ - +) -> Rect: ... def polygon( surface: Surface, - color: ColorLike, - points: SequenceLike[Point], + color: ColorValue, + points: Sequence[Coordinate], width: int = 0, -) -> Rect: - """Draw a polygon. - - Draws a polygon on the given surface. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param points: a sequence of 3 or more (x, y) coordinates that make up the - vertices of the polygon, each point in the sequence must be a - tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats, - e.g. ``[(x1, y1), (x2, y2), (x3, y3)]`` - :type points: tuple(point) or list(point) - :param int width: (optional) used for line thickness or to indicate that - the polygon is to be filled - - | if width == 0, (default) fill the polygon - | if width > 0, used for line thickness - | if width < 0, nothing will be drawn - | - - .. note:: - When using ``width`` values ``> 1``, the edge lines will grow - outside the original boundary of the polygon. For more details on - how the thickness for edge lines grow, refer to the ``width`` notes - of the :func:`pygame.draw.line` function. - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the position of the first point in the - ``points`` parameter (float values will be truncated) and its width and - height will be 0 - :rtype: Rect - - :raises ValueError: if ``len(points) < 3`` (must have at least 3 points) - :raises TypeError: if ``points`` is not a sequence or ``points`` does not - contain number pairs - - .. note:: - For an aapolygon, use :func:`aalines()` with ``closed=True``. - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - """ - +) -> Rect: ... def circle( surface: Surface, - color: ColorLike, - center: Point, + color: ColorValue, + center: Coordinate, radius: float, width: int = 0, draw_top_right: bool = False, draw_top_left: bool = False, draw_bottom_left: bool = False, draw_bottom_right: bool = False, -) -> Rect: - """Draw a circle. - - Draws a circle on the given surface. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param center: center point of the circle as a sequence of 2 ints/floats, - e.g. ``(x, y)`` - :type center: tuple(int or float, int or float) or - list(int or float, int or float) or Vector2(int or float, int or float) - :param radius: radius of the circle, measured from the ``center`` parameter, - nothing will be drawn if the ``radius`` is less than 1 - :type radius: int or float - :param int width: (optional) used for line thickness or to indicate that - the circle is to be filled - - | if ``width == 0``, (default) fill the circle - | if ``width > 0``, used for line thickness - | if ``width < 0``, nothing will be drawn - | - - .. note:: - When using ``width`` values ``> 1``, the edge lines will only grow - inward. - :param bool draw_top_right: (optional) if this is set to True then the top right corner - of the circle will be drawn - :param bool draw_top_left: (optional) if this is set to True then the top left corner - of the circle will be drawn - :param bool draw_bottom_left: (optional) if this is set to True then the bottom left corner - of the circle will be drawn - :param bool draw_bottom_right: (optional) if this is set to True then the bottom right corner - of the circle will be drawn - - | If any quadrants are set to True, only they will be drawn, otherwise the entire circle will be drawn. - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the ``center`` parameter value (float - values will be truncated) and its width and height will be 0 - :rtype: Rect - - :raises TypeError: if ``center`` is not a sequence of two numbers - :raises TypeError: if ``radius`` is not a number - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - Nothing is drawn when the radius is 0 (a pixel at the ``center`` coordinates - used to be drawn when the radius equaled 0). - Floats, and Vector2 are accepted for the ``center`` param. - The drawing algorithm was improved to look more like a circle. - .. versionchangedold:: 2.0.0.dev8 Added support for drawing circle quadrants. - """ - -def aacircle( - surface: Surface, - color: ColorLike, - center: Point, - radius: float, - width: int = 0, - draw_top_right: bool = False, - draw_top_left: bool = False, - draw_bottom_left: bool = False, - draw_bottom_right: bool = False, -) -> Rect: - """Draw an antialiased circle. - - Draws an antialiased circle on the given surface. - Uses Xiaolin Wu Circle Algorithm. - Adapted from: https://cgg.mff.cuni.cz/~pepca/ref/WU.pdf - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param center: center point of the circle as a sequence of 2 ints/floats, - e.g. ``(x, y)`` - :type center: tuple(int or float, int or float) or - list(int or float, int or float) or Vector2(int or float, int or float) - :param radius: radius of the circle, measured from the ``center`` parameter, - nothing will be drawn if the ``radius`` is less than 1 - :type radius: int or float - :param int width: (optional) used for line thickness or to indicate that - the circle is to be filled - - | if ``width == 0``, (default) fill the circle - | if ``width > 0``, used for line thickness - | if ``width < 0``, nothing will be drawn - | - - .. note:: - When using ``width`` values ``> 1``, the edge lines will only grow - inward. - :param bool draw_top_right: (optional) if this is set to True then the top right corner - of the circle will be drawn - :param bool draw_top_left: (optional) if this is set to True then the top left corner - of the circle will be drawn - :param bool draw_bottom_left: (optional) if this is set to True then the bottom left corner - of the circle will be drawn - :param bool draw_bottom_right: (optional) if this is set to True then the bottom right corner - of the circle will be drawn - - | If any quadrants are set to True, only they will be drawn, otherwise the entire circle will be drawn. - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the ``center`` parameter value (float - values will be truncated) and its width and height will be 0 - :rtype: Rect - - :raises TypeError: if ``center`` is not a sequence of two numbers - :raises TypeError: if ``radius`` is not a number - - .. versionadded:: 2.5.0 - """ - -def ellipse(surface: Surface, color: ColorLike, rect: RectLike, width: int = 0) -> Rect: - """Draw an ellipse. - - Draws an ellipse on the given surface. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param Rect rect: rectangle to indicate the position and dimensions of the - ellipse, the ellipse will be centered inside the rectangle and bounded - by it - :param int width: (optional) used for line thickness or to indicate that - the ellipse is to be filled (not to be confused with the width value - of the ``rect`` parameter) - - | if ``width == 0``, (default) fill the ellipse - | if ``width > 0``, used for line thickness - | if ``width < 0``, nothing will be drawn - | - - .. note:: - When using ``width`` values ``> 1``, the edge lines will only grow - inward from the original boundary of the ``rect`` parameter. - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the position of the given ``rect`` - parameter and its width and height will be 0 - :rtype: Rect - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - """ - +) -> Rect: ... +def ellipse( + surface: Surface, color: ColorValue, rect: RectValue, width: int = 0 +) -> Rect: ... def arc( surface: Surface, - color: ColorLike, - rect: RectLike, + color: ColorValue, + rect: RectValue, start_angle: float, stop_angle: float, width: int = 1, -) -> Rect: - """Draw an elliptical arc. - - Draws an elliptical arc on the given surface. - - The two angle arguments are given in radians and indicate the start and stop - positions of the arc. The arc is drawn in a counterclockwise direction from - the ``start_angle`` to the ``stop_angle``. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param Rect rect: rectangle to indicate the position and dimensions of the - ellipse which the arc will be based on, the ellipse will be centered - inside the rectangle - :param float start_angle: start angle of the arc in radians - :param float stop_angle: stop angle of the arc in - radians - - | if ``start_angle < stop_angle``, the arc is drawn in a - counterclockwise direction from the ``start_angle`` to the - ``stop_angle`` - | if ``start_angle > stop_angle``, tau (tau == 2 * pi) will be added - to the ``stop_angle``, if the resulting stop angle value is greater - than the ``start_angle`` the above ``start_angle < stop_angle`` case - applies, otherwise nothing will be drawn - | if ``start_angle == stop_angle``, nothing will be drawn - - :param int width: (optional) used for line thickness (not to be confused - with the width value of the ``rect`` parameter) - - | if ``width == 0``, nothing will be drawn - | if ``width > 0``, (default is 1) used for line thickness - | if ``width < 0``, same as ``width == 0`` - - .. note:: - When using ``width`` values ``> 1``, the edge lines will only grow - inward from the original boundary of the ``rect`` parameter. - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the position of the given ``rect`` - parameter and its width and height will be 0 - :rtype: Rect - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - """ - +) -> Rect: ... def line( surface: Surface, - color: ColorLike, - start_pos: Point, - end_pos: Point, + color: ColorValue, + start_pos: Coordinate, + end_pos: Coordinate, width: int = 1, -) -> Rect: - """Draw a straight line. - - Draws a straight line on the given surface. There are no endcaps. For thick - lines the ends are squared off. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param start_pos: start position of the line, (x, y) - :type start_pos: tuple(int or float, int or float) or - list(int or float, int or float) or Vector2(int or float, int or float) - :param end_pos: end position of the line, (x, y) - :type end_pos: tuple(int or float, int or float) or - list(int or float, int or float) or Vector2(int or float, int or float) - :param int width: (optional) used for line thickness - - | if width >= 1, used for line thickness (default is 1) - | if width < 1, nothing will be drawn - - .. note:: - When using ``width`` values ``> 1``, lines will grow as follows. - - For odd ``width`` values, the thickness of each line grows with the - original line being in the center. - - For even ``width`` values, the thickness of each line grows with the - original line being offset from the center (as there is no exact - center line drawn). As a result, lines with a slope < 1 - (horizontal-ish) will have 1 more pixel of thickness below the - original line (in the y direction). Lines with a slope >= 1 - (vertical-ish) will have 1 more pixel of thickness to the right of - the original line (in the x direction). - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the ``start_pos`` parameter value (float - values will be truncated) and its width and height will be 0 - :rtype: Rect - - :raises TypeError: if ``start_pos`` or ``end_pos`` is not a sequence of - two numbers - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - """ - +) -> Rect: ... def lines( surface: Surface, - color: ColorLike, + color: ColorValue, closed: bool, - points: SequenceLike[Point], + points: Sequence[Coordinate], width: int = 1, -) -> Rect: - """Draw multiple contiguous straight line segments. - - Draws a sequence of contiguous straight lines on the given surface. There are - no endcaps or miter joints. For thick lines the ends are squared off. - Drawing thick lines with sharp corners can have undesired looking results. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param bool closed: if ``True`` an additional line segment is drawn between - the first and last points in the ``points`` sequence - :param points: a sequence of 2 or more (x, y) coordinates, where each - point in the sequence must be a - tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats and adjacent - points will be connected by a line segment, e.g. for the - points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will be drawn - from ``(x1, y1)`` to ``(x2, y2)`` and from ``(x2, y2)`` to ``(x3, y3)``, - additionally if the ``closed`` parameter is ``True`` another line segment - will be drawn from ``(x3, y3)`` to ``(x1, y1)`` - :type points: tuple(point) or list(point) - :param int width: (optional) used for line thickness - - | if width >= 1, used for line thickness (default is 1) - | if width < 1, nothing will be drawn - - .. note:: - When using ``width`` values ``> 1`` refer to the ``width`` notes - of :func:`line` for details on how thick lines grow. - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the position of the first point in the - ``points`` parameter (float values will be truncated) and its width and - height will be 0 - :rtype: Rect - - :raises ValueError: if ``len(points) < 2`` (must have at least 2 points) - :raises TypeError: if ``points`` is not a sequence or ``points`` does not - contain number pairs - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - """ - +) -> Rect: ... def aaline( surface: Surface, - color: ColorLike, - start_pos: Point, - end_pos: Point, - width: int = 1, -) -> Rect: - """Draw a straight antialiased line. - - Draws a straight antialiased line on the given surface. There are no endcaps. - For thick lines the ends are squared off. - - .. note:: - Regarding float values for coordinates, a point with coordinate - consisting of two whole numbers is considered being right in the center - of said pixel (and having a height and width of 1 pixel would therefore - completely cover it), while a point with coordinate where one (or both) - of the numbers have non-zero decimal parts would be partially covering - two (or four if both numbers have decimal parts) adjacent pixels, *e.g.* - the point ``(1.4, 2)`` covers 60% of the pixel ``(1, 2)`` and 40% of the - pixel ``(2,2)``. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param start_pos: start position of the line, (x, y) - :type start_pos: tuple(int or float, int or float) or - list(int or float, int or float) or Vector2(int or float, int or float) - :param end_pos: end position of the line, (x, y) - :type end_pos: tuple(int or float, int or float) or - list(int or float, int or float) or Vector2(int or float, int or float) - :param int width: (optional) used for line thickness - - | if width >= 1, used for line thickness (default is 1) - | if width < 1, a line of width == 1 will be drawn - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the ``start_pos`` parameter value (float - values will be truncated) and its width and height will be 0 - :rtype: Rect - - :raises TypeError: if ``start_pos`` or ``end_pos`` is not a sequence of - two numbers - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - .. versionchanged:: 2.4.0 Removed deprecated 'blend' argument - .. versionchanged:: 2.5.0 ``blend`` argument re-added for backcompat, but will - do nothing different and always raise a deprecation exception when used. - .. versionchanged:: 2.5.6 Added ``width`` in place of the deprecated - ``blend`` argument in a way that doesn't break backcompat too much. - """ - + color: ColorValue, + start_pos: Coordinate, + end_pos: Coordinate, + blend: int = 1, +) -> Rect: ... def aalines( surface: Surface, - color: ColorLike, + color: ColorValue, closed: bool, - points: SequenceLike[Point], -) -> Rect: - """Draw multiple contiguous straight antialiased line segments. - - Draws a sequence of contiguous straight antialiased lines on the given - surface. - - :param Surface surface: surface to draw on - :param color: color to draw with, the alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` - :param bool closed: if ``True`` an additional line segment is drawn between - the first and last points in the ``points`` sequence - :param points: a sequence of 2 or more (x, y) coordinates, where each - point in the sequence must be a - tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats and adjacent - points will be connected by a line segment, e.g. for the - points ``[(x1, y1), (x2, y2), (x3, y3)]`` a line segment will be drawn - from ``(x1, y1)`` to ``(x2, y2)`` and from ``(x2, y2)`` to ``(x3, y3)``, - additionally if the ``closed`` parameter is ``True`` another line segment - will be drawn from ``(x3, y3)`` to ``(x1, y1)`` - :type points: tuple(point) or list(point) - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the position of the first point in the - ``points`` parameter (float values will be truncated) and its width and - height will be 0 - :rtype: Rect - - :raises ValueError: if ``len(points) < 2`` (must have at least 2 points) - :raises TypeError: if ``points`` is not a sequence or ``points`` does not - contain number pairs - - .. versionchangedold:: 2.0.0 Added support for keyword arguments. - .. versionchanged:: 2.4.0 Removed deprecated ``blend`` argument - .. versionchanged:: 2.5.0 ``blend`` argument re-added for backcompat, but will - always raise a deprecation exception when used - """ - -def flood_fill(surface: Surface, color: ColorLike | Surface, start_pos: Point) -> Rect: - """Fill an enclosed, same color area, on a surface. - - Replace the color of a cluster of connected same-color pixels, beginning - from the starting position, with a repeating pattern or solid single color. - - :param Surface surface: surface to draw on - :param color: color, or surface pattern, to draw with. The alpha value is optional if using a - tuple ``(RGB[A])`` - :type color: :data:`pygame.typing.ColorLike` or a pattern to fill with, as a Surface - :param start_pos: starting position as a sequence of 2 ints/floats, - e.g. ``(x, y)`` - :type start_pos: tuple(int or float, int or float) or - list(int or float, int or float) or Vector2(int or float, int or float) - - :returns: a rect bounding the changed pixels, if nothing is drawn the - bounding rect's position will be the position of the starting point - and its width and height will be 0 - :rtype: Rect - - .. versionadded:: 2.5.6 - """ + points: Sequence[Coordinate], + blend: int = 1, +) -> Rect: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/event.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/event.cpython-314-x86_64-linux-gnu.so index 9fffc99..a5e630b 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/event.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/event.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/event.pyi b/.venv/lib/python3.14/site-packages/pygame/event.pyi index e72942c..9175960 100644 --- a/.venv/lib/python3.14/site-packages/pygame/event.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/event.pyi @@ -1,55 +1,51 @@ -from typing import Any, ClassVar, TypeAlias, final +from typing import ( + Any, + Dict, + List, + Optional, + Sequence, + SupportsInt, + Tuple, + Union, + final, + overload, +) -from pygame.typing import SequenceLike -from typing_extensions import deprecated # added in 3.13 - -class _GenericEvent: - # Just exists to avoid duplication of data for Event - # and (deprecated) EventType - - @property - def type(self) -> int: ... - __dict__: dict[str, Any] - __hash__: ClassVar[None] # type: ignore[assignment] +@final +class Event: + type: int + dict: Dict[str, Any] + __dict__: Dict[str, Any] + __hash__: None # type: ignore def __init__( - self, type: int, dict: dict[str, Any] = ..., **kwargs: Any + self, type: int, dict: Dict[str, Any] = ..., **kwargs: Any ) -> None: ... - def __getattr__(self, name: str) -> Any: ... + def __getattribute__(self, name: str) -> Any: ... def __setattr__(self, name: str, value: Any) -> None: ... def __delattr__(self, name: str) -> None: ... def __bool__(self) -> bool: ... - # this is at the bottom because mypy complains if this declaration comes - # before any uses of the dict[] typehinting because of the same naming - @property - def dict(self) -> dict[str, Any]: ... - -@final -class Event(_GenericEvent): - pass - -@final -@deprecated("Use `Event` instead (EventType is an old alias)") -class EventType(_GenericEvent): - pass - -_EventTypes: TypeAlias = int | SequenceLike[int] +_EventTypes = Union[SupportsInt, Tuple[SupportsInt, ...], Sequence[SupportsInt]] def pump() -> None: ... def get( - eventtype: _EventTypes | None = None, - pump: bool = True, - exclude: _EventTypes | None = None, -) -> list[Event]: ... + eventtype: Optional[_EventTypes] = None, + pump: Any = True, + exclude: Optional[_EventTypes] = None, +) -> List[Event]: ... def poll() -> Event: ... def wait(timeout: int = 0) -> Event: ... -def peek(eventtype: _EventTypes | None = None, pump: bool = True) -> bool: ... -def clear(eventtype: _EventTypes | None = None, pump: bool = True) -> None: ... -def event_name(type: int, /) -> str: ... -def set_blocked(type: _EventTypes | None, /) -> None: ... -def set_allowed(type: _EventTypes | None, /) -> None: ... -def get_blocked(type: _EventTypes, /) -> bool: ... -def set_grab(grab: bool, /) -> None: ... +def peek(eventtype: Optional[_EventTypes] = None, pump: Any = True) -> bool: ... +def clear(eventtype: Optional[_EventTypes] = None, pump: Any = True) -> None: ... +def event_name(type: int) -> str: ... +def set_blocked(type: Optional[_EventTypes]) -> None: ... +def set_allowed(type: Optional[_EventTypes]) -> None: ... +def get_blocked(type: _EventTypes) -> bool: ... +def set_grab(grab: bool) -> None: ... def get_grab() -> bool: ... -def post(event: Event, /) -> bool: ... +def set_keyboard_grab(grab: bool) -> None: ... +def get_keyboard_grab() -> bool: ... +def post(event: Event) -> bool: ... def custom_type() -> int: ... + +EventType = Event diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/README.rst b/.venv/lib/python3.14/site-packages/pygame/examples/README.rst index 1e38461..68b75bb 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/README.rst +++ b/.venv/lib/python3.14/site-packages/pygame/examples/README.rst @@ -1,145 +1,154 @@ -These examples should help get you started with pygame. Here is a -brief rundown of what you get. The source code for all examples -is in the public domain. Feel free to use for your own projects. +These examples are a good introduction to various Pygame modules and +techniques. They are beginner-friendly with source code in the public +domain that can be adapted for your projects. + + +aacircles.py + An example of using the gfxdraw module to drawing anti-aliased circles. aliens.py - This started off as a port of the SDL demonstration, Aliens. - Now it has evolved into something sort of resembling fun. - This demonstrates a lot of different uses of sprites and - optimized blitting. Also transparency, colorkeys, fonts, sound, - music, joystick, and more. (PS, my high score is 117! goodluck) + An arcade-style space shooter game that showcases various common and + important Pygame modules and techniques. arraydemo.py - Another example filled with various surfarray effects. - It requires the surfarray and image modules to be installed. - This little demo can also make a good starting point for any of - your own tests with surfarray + Showcases the use of Numpy with Pygame to perform efficient + pixel manipulation. audiocapture.py - Record sound from a microphone, and play back the recorded sound. + Use the mixer module to record sound from a microphone, and + play back the recorded sound. blend_fill.py - BLEND_ing colors in different ways with Surface.fill(). + Demonstrates how to perform surface blending and filling + with Pygame. blit_blends.py - BLEND_ing colors Surface.blit(). + Uses blit functions to showcase some of Pygame's different + blending modes. camera.py Basic image capturing and display using pygame.camera +chimp.py + A simple game featuring a chimp that showcases the use of + common and important Pygame modules and techniques. + cursors.py - Make custom cursors :) + Demonstrates the creation of custom cursors with Pygame. dropevent.py - Drag and drop files. Using the following events. + Drag and drop files using the following events: DROPBEGIN, DROPCOMPLETE, DROPTEXT, DROPFILE eventlist.py - Learn about pygame events and input. - Watch the events fly by. Click the mouse, and see the mouse - event come up. Press a keyboard key, and see the key up event. + A utility for displaying and logging real-time Pygame events, + useful for debugging. font_viewer.py - Display all available fonts in a scrolling window. + Demonstrates how to display all available fonts in a + scrolling window. fonty.py - Super quick, super simple application demonstrating - the different ways to render fonts with the font module + A simple application demonstrating the different ways + to render fonts with the font module freetype_misc.py - FreeType is a world famous font project. + Shows how to use the freetype module to perform font + rendering and manipulation. glcube.py Using PyOpenGL and Pygame, this creates a spinning 3D multicolored cube. go_over_there.py - Demonstrates Vector.move_towards. + Demonstrates the important Vector.move_towards() function. + +grid.py + A simple example of grid-based movement. headless_no_windows_needed.py - For using pygame in scripts. + Shows how to run Pygame in scripts. + +joystick.py + Shows how to integrate joysticks or game controllers into Pygame. liquid.py - This example was created in a quick comparison with the - BlitzBasic gaming language. Nonetheless, it demonstrates a quick - 8-bit setup (with colormap). + Demonstrates how to create a simple liquid effect in an image. mask.py - Single bit pixel manipulation. Fast for collision detection, - and also good for computer vision. + Showcases how to use masks for collision detection and sprite + interaction. midi.py - For connecting pygame to musical equipment. + Demonstrates how to use MIDI I/O using the midi module. moveit.py - A very simple example of moving stuff. + Illustrates how to accomplish sprite movement and animation. music_drop_fade.py - Fade in and play music from a list while observing - several events. Uses fade_ms added in pygame2, as well as set_endevent, - set_volume, drag and drop events, and the scrap module. - -ninepatch.py - Demonstrate the purpose of the 9-patch scale method and a way to implement it. + Showcases dropping music files into Pygame, and how to + apply a fade effect to music playback. pixelarray.py - Process whole arrays of pixels at a time. - Like numpy, but for pixels, and also built into pygame. + Manipulation of individual pixels using the PixelArray module. playmus.py - Simple music playing example. + Uses the mixer module to play music files with CLI. prevent_display_stretching.py - A windows specific example. + Illustrates how to maintain aspect ratio when resizing a window + in Pygame. + +resizing_new.py + Showcases various window resizing events and how to fit graphics + to new dimensions. scaletest.py - Showing how to scale Surfaces. + Showcases the scaling of Surfaces. scrap_clipboard.py - A simple demonstration example for the clipboard support. + Shows how to implement clipboard interaction with Pygame's scrap module. + +scroll.py + An example that implements smooth scrolling backgrounds for side-scrolling + games or parallax effects. setmodescale.py - SCALED allows you to work in 320x200 and have it show up big. - It handles mouse scaling and selection of a good sized window depending + Handles mouse scaling and selection of a good sized window depending on the display. sound.py - Extremely basic testing of the mixer module. Load a - sound and play it. All from the command shell, no graphics. + Illustrates how to implement sound effects and music using Pygame. sound_array_demos.py - Echo, delay and other array based processing of sounds. + Showcases echo, delay and other array based processing of sounds. sprite_texture.py - Shows how to use hardware Image Textures with pygame.sprite. + Demonstrates how to use textured sprites in Pygame. stars.py - A simple starfield example. You can change the center of - perspective by leftclicking the mouse on the screen. + A simple starfield implementation in which the perspective can be + changed by a mouse click. testsprite.py - More of a test example. If you're interested in how to use sprites, - then check out the aliens.py example instead. + Showcases the basics of sprite handling, namely collision + detection and animation. textinput.py A little "console" where you can write in text. Shows how to use the TEXTEDITING and TEXTINPUT events. vgrade.py - Demonstrates creating a vertical gradient with - Numpy. The app will create a new gradient every half - second and report the time needed to create and display the - image. If you're not prepared to start working with the - Numpy arrays, don't worry about the source for this one :] + Shows how to apply vertical gradients to surfaces using Pygame. video.py - It explores some new video APIs in pygame 2. - Including multiple windows, Textures, and such. + Showcases the movie module, including the display of playback + controls. data/ Directory with the resources for the examples. -There's LOTS of examples on the pygame website, and on places like github. -We're always on the lookout for more examples and/or example -requests. Code like this is probably the best way to start -getting involved with Python gaming. +More examples can be found on the Pygame website and GitHub. +We're always looking for new examples and/or example requests. Examining +code such as this is a great way to get started with Python-based +game development. diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/aacircle.py b/.venv/lib/python3.14/site-packages/pygame/examples/aacircle.py index 24fc2aa..651df18 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/aacircle.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/aacircle.py @@ -10,7 +10,7 @@ def main(): pygame.init() screen = pygame.display.set_mode((500, 500)) screen.fill((255, 0, 0)) - s = pygame.Surface(screen.get_size(), pygame.SRCALPHA) + s = pygame.Surface(screen.get_size(), pygame.SRCALPHA, 32) pygame.draw.line(s, (0, 0, 0), (250, 250), (250 + 200, 250)) width = 1 @@ -23,23 +23,18 @@ def main(): pygame.draw.circle(screen, "green", (50, 100), 10) pygame.draw.circle(screen, "black", (50, 100), 10, 1) - running = True - - clock = pygame.Clock() - - while running: - clock.tick(10) - - for event in pygame.event.get(): + pygame.display.flip() + try: + while True: + event = pygame.event.wait() if event.type == pygame.QUIT: - running = False - elif event.type == pygame.KEYDOWN: - if event.key == pygame.K_q: - running = False - - pygame.display.flip() - - pygame.quit() + break + if event.type == pygame.KEYDOWN: + if event.key == pygame.K_ESCAPE or event.unicode == "q": + break + pygame.display.flip() + finally: + pygame.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/aliens.py b/.venv/lib/python3.14/site-packages/pygame/examples/aliens.py index 3bc80f1..224c749 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/aliens.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/aliens.py @@ -1,16 +1,16 @@ #!/usr/bin/env python -"""pygame.examples.aliens +""" pygame.examples.aliens Shows a mini game where you have to defend against aliens. What does it show you about pygame? -* pygame.sprite, the difference between Sprite and Group. +* pg.sprite, the difference between Sprite and Group. * dirty rectangle optimization for processing for speed. -* music with pygame.mixer.music, including fadeout -* sound effects with pygame.Sound +* music with pg.mixer.music, including fadeout +* sound effects with pg.Sound * event processing, keyboard handling, QUIT handling. -* a main loop frame limited with a game clock from the pygame.time module +* a main loop frame limited with a game clock from pg.time.Clock * fullscreen switching. @@ -18,19 +18,20 @@ Controls -------- * Left and right arrows to move. -* Space bar to shoot. +* Space bar to shoot * f key to toggle between fullscreen. """ import os import random +from typing import List # import basic pygame modules -import pygame +import pygame as pg # see if we can load more than standard BMP -if not pygame.image.get_extended(): +if not pg.image.get_extended(): raise SystemExit("Sorry, extended image module required") @@ -39,7 +40,7 @@ MAX_SHOTS = 2 # most player bullets onscreen ALIEN_ODDS = 22 # chances a new alien appears BOMB_ODDS = 60 # chances a new bomb will drop ALIEN_RELOAD = 12 # frames between new aliens -SCREENRECT = pygame.Rect(0, 0, 640, 480) +SCREENRECT = pg.Rect(0, 0, 640, 480) SCORE = 0 main_dir = os.path.split(os.path.abspath(__file__))[0] @@ -49,21 +50,21 @@ def load_image(file): """loads an image, prepares it for play""" file = os.path.join(main_dir, "data", file) try: - surface = pygame.image.load(file) - except pygame.error: - raise SystemExit(f'Could not load image "{file}" {pygame.get_error()}') + surface = pg.image.load(file) + except pg.error: + raise SystemExit(f'Could not load image "{file}" {pg.get_error()}') return surface.convert() def load_sound(file): """because pygame can be compiled without mixer.""" - if not pygame.mixer: + if not pg.mixer: return None file = os.path.join(main_dir, "data", file) try: - sound = pygame.mixer.Sound(file) + sound = pg.mixer.Sound(file) return sound - except pygame.error: + except pg.error: print(f"Warning, unable to load, {file}") return None @@ -76,20 +77,19 @@ def load_sound(file): # since it is passed extra information about the keyboard. -class Player(pygame.sprite.Sprite): +class Player(pg.sprite.Sprite): """Representing the player as a moon buggy type car.""" speed = 10 bounce = 24 gun_offset = -11 - images = [] - containers = None + images: List[pg.Surface] = [] - def __init__(self): - super().__init__(self.containers) + def __init__(self, *groups): + pg.sprite.Sprite.__init__(self, *groups) self.image = self.images[0] self.rect = self.image.get_rect(midbottom=SCREENRECT.midbottom) - self.reloading = False + self.reloading = 0 self.origtop = self.rect.top self.facing = -1 @@ -109,16 +109,15 @@ class Player(pygame.sprite.Sprite): return pos, self.rect.top -class Alien(pygame.sprite.Sprite): +class Alien(pg.sprite.Sprite): """An alien space ship. That slowly moves down the screen.""" speed = 13 animcycle = 12 - images = [] - containers = None + images: List[pg.Surface] = [] - def __init__(self): - pygame.sprite.Sprite.__init__(self, self.containers) + def __init__(self, *groups): + pg.sprite.Sprite.__init__(self, *groups) self.image = self.images[0] self.rect = self.image.get_rect() self.facing = random.choice((-1, 1)) * Alien.speed @@ -126,7 +125,7 @@ class Alien(pygame.sprite.Sprite): if self.facing < 0: self.rect.right = SCREENRECT.right - def update(self): + def update(self, *args, **kwargs): self.rect.move_ip(self.facing, 0) if not SCREENRECT.contains(self.rect): self.facing = -self.facing @@ -136,21 +135,20 @@ class Alien(pygame.sprite.Sprite): self.image = self.images[self.frame // self.animcycle % 3] -class Explosion(pygame.sprite.Sprite): +class Explosion(pg.sprite.Sprite): """An explosion. Hopefully the Alien and not the player!""" defaultlife = 12 animcycle = 3 - images = [] - containers = None + images: List[pg.Surface] = [] - def __init__(self, actor): - pygame.sprite.Sprite.__init__(self, self.containers) + def __init__(self, actor, *groups): + pg.sprite.Sprite.__init__(self, *groups) self.image = self.images[0] self.rect = self.image.get_rect(center=actor.rect.center) self.life = self.defaultlife - def update(self): + def update(self, *args, **kwargs): """called every time around the game loop. Show the explosion surface for 'defaultlife'. @@ -164,19 +162,18 @@ class Explosion(pygame.sprite.Sprite): self.kill() -class Shot(pygame.sprite.Sprite): +class Shot(pg.sprite.Sprite): """a bullet the Player sprite fires.""" speed = -11 - images = [] - containers = None + images: List[pg.Surface] = [] - def __init__(self, pos): - pygame.sprite.Sprite.__init__(self, self.containers) + def __init__(self, pos, *groups): + pg.sprite.Sprite.__init__(self, *groups) self.image = self.images[0] self.rect = self.image.get_rect(midbottom=pos) - def update(self): + def update(self, *args, **kwargs): """called every time around the game loop. Every tick we move the shot upwards. @@ -186,19 +183,19 @@ class Shot(pygame.sprite.Sprite): self.kill() -class Bomb(pygame.sprite.Sprite): +class Bomb(pg.sprite.Sprite): """A bomb the aliens drop.""" speed = 9 - images = [] - containers = None + images: List[pg.Surface] = [] - def __init__(self, alien): - pygame.sprite.Sprite.__init__(self, self.containers) + def __init__(self, alien, explosion_group, *groups): + pg.sprite.Sprite.__init__(self, *groups) self.image = self.images[0] self.rect = self.image.get_rect(midbottom=alien.rect.move(0, 5).midbottom) + self.explosion_group = explosion_group - def update(self): + def update(self, *args, **kwargs): """called every time around the game loop. Every frame we move the sprite 'rect' down. @@ -209,141 +206,139 @@ class Bomb(pygame.sprite.Sprite): """ self.rect.move_ip(0, self.speed) if self.rect.bottom >= 470: - Explosion(self) + Explosion(self, self.explosion_group) self.kill() -class Score(pygame.sprite.Sprite): +class Score(pg.sprite.Sprite): """to keep track of the score.""" - def __init__(self): - pygame.sprite.Sprite.__init__(self) - self.font = pygame.Font(None, 20) - self.font.set_italic(True) + def __init__(self, *groups): + pg.sprite.Sprite.__init__(self, *groups) + self.font = pg.font.Font(None, 20) + self.font.set_italic(1) self.color = "white" self.lastscore = -1 self.update() self.rect = self.image.get_rect().move(10, 450) - def update(self): + def update(self, *args, **kwargs): """We only update the score in update() when it has changed.""" if SCORE != self.lastscore: self.lastscore = SCORE - msg = "Score: %d" % SCORE - self.image = self.font.render(msg, False, self.color) + msg = f"Score: {SCORE}" + self.image = self.font.render(msg, 0, self.color) -def main(): +def main(winstyle=0): # Initialize pygame - pygame.mixer.pre_init(44100, 32, 2, 1024) - pygame.init() - if pygame.mixer and not pygame.mixer.get_init(): + if pg.get_sdl_version()[0] == 2: + pg.mixer.pre_init(44100, 32, 2, 1024) + pg.init() + if pg.mixer and not pg.mixer.get_init(): print("Warning, no sound") - pygame.mixer = None + pg.mixer = None fullscreen = False # Set the display mode winstyle = 0 # |FULLSCREEN - screen = pygame.display.set_mode(SCREENRECT.size, winstyle) + bestdepth = pg.display.mode_ok(SCREENRECT.size, winstyle, 32) + screen = pg.display.set_mode(SCREENRECT.size, winstyle, bestdepth) # Load images, assign to sprite classes # (do this before the classes are used, after screen setup) img = load_image("player1.gif") - Player.images = [img, pygame.transform.flip(img, True, False)] + Player.images = [img, pg.transform.flip(img, 1, 0)] img = load_image("explosion1.gif") - Explosion.images = [img, pygame.transform.flip(img, True, True)] + Explosion.images = [img, pg.transform.flip(img, 1, 1)] Alien.images = [load_image(im) for im in ("alien1.gif", "alien2.gif", "alien3.gif")] Bomb.images = [load_image("bomb.gif")] Shot.images = [load_image("shot.gif")] # decorate the game window - icon = pygame.transform.scale(Alien.images[0], (32, 32)) - pygame.display.set_icon(icon) - pygame.display.set_caption("Pygame Aliens") - pygame.mouse.set_visible(False) + icon = pg.transform.scale(Alien.images[0], (32, 32)) + pg.display.set_icon(icon) + pg.display.set_caption("Pygame Aliens") + pg.mouse.set_visible(0) # create the background, tile the bgd image bgdtile = load_image("background.gif") - background = pygame.Surface(SCREENRECT.size) + background = pg.Surface(SCREENRECT.size) for x in range(0, SCREENRECT.width, bgdtile.get_width()): background.blit(bgdtile, (x, 0)) - pygame.display.flip() + screen.blit(background, (0, 0)) + pg.display.flip() # load the sound effects boom_sound = load_sound("boom.wav") shoot_sound = load_sound("car_door.wav") - if pygame.mixer: + if pg.mixer: music = os.path.join(main_dir, "data", "house_lo.wav") - pygame.mixer.music.load(music) - pygame.mixer.music.play(-1) + pg.mixer.music.load(music) + pg.mixer.music.play(-1) # Initialize Game Groups - aliens = pygame.sprite.Group() - shots = pygame.sprite.Group() - bombs = pygame.sprite.Group() - all_sprites = pygame.sprite.Group() - lastalien = pygame.sprite.GroupSingle() - - # assign default groups to each sprite class - Player.containers = all_sprites - Alien.containers = aliens, all_sprites, lastalien - Shot.containers = shots, all_sprites - Bomb.containers = bombs, all_sprites - Explosion.containers = all_sprites - Score.containers = all_sprites + aliens = pg.sprite.Group() + shots = pg.sprite.Group() + bombs = pg.sprite.Group() + all = pg.sprite.RenderUpdates() + lastalien = pg.sprite.GroupSingle() # Create Some Starting Values alienreload = ALIEN_RELOAD - clock = pygame.Clock() + clock = pg.time.Clock() # initialize our starting sprites global SCORE - player = Player() - Alien() # note, this 'lives' because it goes into a sprite group - if pygame.font: - all_sprites.add(Score()) + player = Player(all) + Alien( + aliens, all, lastalien + ) # note, this 'lives' because it goes into a sprite group + if pg.font: + all.add(Score(all)) # Run our main loop whilst the player is alive. while player.alive(): - # Erase last frame by blitting the background to the screen - screen.blit(background, (0, 0)) - # get input - for event in pygame.event.get(): - if event.type == pygame.QUIT: + for event in pg.event.get(): + if event.type == pg.QUIT: return - if event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE: + if event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE: return - elif event.type == pygame.KEYDOWN: - if event.key == pygame.K_f: + if event.type == pg.KEYDOWN: + if event.key == pg.K_f: if not fullscreen: print("Changing to FULLSCREEN") screen_backup = screen.copy() - screen = pygame.display.set_mode( - SCREENRECT.size, - winstyle | pygame.FULLSCREEN | pygame.SCALED, + screen = pg.display.set_mode( + SCREENRECT.size, winstyle | pg.FULLSCREEN, bestdepth ) screen.blit(screen_backup, (0, 0)) else: print("Changing to windowed mode") screen_backup = screen.copy() - screen = pygame.display.set_mode(SCREENRECT.size, winstyle) + screen = pg.display.set_mode( + SCREENRECT.size, winstyle, bestdepth + ) screen.blit(screen_backup, (0, 0)) - pygame.display.flip() + pg.display.flip() fullscreen = not fullscreen - keystate = pygame.key.get_pressed() + keystate = pg.key.get_pressed() + + # clear/erase the last drawn sprites + all.clear(screen, background) # update all the sprites - all_sprites.update() + all.update() # handle player input - direction = keystate[pygame.K_RIGHT] - keystate[pygame.K_LEFT] + direction = keystate[pg.K_RIGHT] - keystate[pg.K_LEFT] player.move(direction) - firing = keystate[pygame.K_SPACE] + firing = keystate[pg.K_SPACE] if not player.reloading and firing and len(shots) < MAX_SHOTS: - Shot(player.gunpos()) - if pygame.mixer: + Shot(player.gunpos(), shots, all) + if pg.mixer and shoot_sound is not None: shoot_sound.play() player.reloading = firing @@ -351,50 +346,50 @@ def main(): if alienreload: alienreload = alienreload - 1 elif not int(random.random() * ALIEN_ODDS): - Alien() + Alien(aliens, all, lastalien) alienreload = ALIEN_RELOAD # Drop bombs if lastalien and not int(random.random() * BOMB_ODDS): - Bomb(lastalien.sprite) + Bomb(lastalien.sprite, all, bombs, all) # Detect collisions between aliens and players. - for alien in pygame.sprite.spritecollide(player, aliens, True): - if pygame.mixer: + for alien in pg.sprite.spritecollide(player, aliens, 1): + if pg.mixer and boom_sound is not None: boom_sound.play() - Explosion(alien) - Explosion(player) + Explosion(alien, all) + Explosion(player, all) SCORE = SCORE + 1 player.kill() # See if shots hit the aliens. - for alien in pygame.sprite.groupcollide(aliens, shots, True, True).keys(): - if pygame.mixer: + for alien in pg.sprite.groupcollide(aliens, shots, 1, 1).keys(): + if pg.mixer and boom_sound is not None: boom_sound.play() - Explosion(alien) + Explosion(alien, all) SCORE = SCORE + 1 # See if alien bombs hit the player. - for bomb in pygame.sprite.spritecollide(player, bombs, True): - if pygame.mixer: + for bomb in pg.sprite.spritecollide(player, bombs, 1): + if pg.mixer and boom_sound is not None: boom_sound.play() - Explosion(player) - Explosion(bomb) + Explosion(player, all) + Explosion(bomb, all) player.kill() # draw the scene - all_sprites.draw(screen) - pygame.display.flip() + dirty = all.draw(screen) + pg.display.update(dirty) # cap the framerate at 40fps. Also called 40HZ or 40 times per second. clock.tick(40) - if pygame.mixer: - pygame.mixer.music.fadeout(1000) - pygame.time.wait(1000) + if pg.mixer: + pg.mixer.music.fadeout(1000) + pg.time.wait(1000) # call the "main" function if running this script if __name__ == "__main__": main() - pygame.quit() + pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/arraydemo.py b/.venv/lib/python3.14/site-packages/pygame/examples/arraydemo.py index 132c828..514722b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/arraydemo.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/arraydemo.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.arraydemo +""" pygame.examples.arraydemo Welcome to the arraydemo! @@ -16,7 +16,7 @@ This demo will show you a few things: import os -import pygame +import pygame as pg from pygame import surfarray main_dir = os.path.split(os.path.abspath(__file__))[0] @@ -24,19 +24,19 @@ main_dir = os.path.split(os.path.abspath(__file__))[0] def surfdemo_show(array_img, name): "displays a surface, waits for user to continue" - screen = pygame.display.set_mode(array_img.shape[:2]) + screen = pg.display.set_mode(array_img.shape[:2], 0, 32) surfarray.blit_array(screen, array_img) - pygame.display.flip() - pygame.display.set_caption(name) + pg.display.flip() + pg.display.set_caption(name) while True: - e = pygame.event.wait() + e = pg.event.wait() # Force application to only advance when main button is released - if e.type == pygame.MOUSEBUTTONUP and e.button == pygame.BUTTON_LEFT: + if e.type == pg.MOUSEBUTTONUP and e.button == pg.BUTTON_LEFT: break - elif e.type == pygame.KEYDOWN and e.key == pygame.K_s: - pygame.image.save(screen, name + ".png") - elif e.type == pygame.QUIT: - pygame.quit() + elif e.type == pg.KEYDOWN and e.key == pg.K_s: + pg.image.save(screen, name + ".png") + elif e.type == pg.QUIT: + pg.quit() raise SystemExit() @@ -45,7 +45,7 @@ def main(): import numpy as np from numpy import int32, uint - pygame.init() + pg.init() print("Using Numpy") print("Press the left mouse button to advance image.") @@ -64,8 +64,8 @@ def main(): surfdemo_show(striped, "striped") # rgbarray - imagename = os.path.join(main_dir, "data", "arraydemo.webp") - imgsurface = pygame.image.load(imagename) + imagename = os.path.join(main_dir, "data", "arraydemo.bmp") + imgsurface = pg.image.load(imagename) rgbarray = surfarray.array3d(imgsurface) surfdemo_show(rgbarray, "rgbarray") @@ -113,7 +113,7 @@ def main(): surfdemo_show(xfade, "xfade") # all done - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/audiocapture.py b/.venv/lib/python3.14/site-packages/pygame/examples/audiocapture.py index f345376..714a8aa 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/audiocapture.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/audiocapture.py @@ -1,23 +1,30 @@ #!/usr/bin/env python -"""pygame.examples.audiocapture +""" pygame.examples.audiocapture A pygame 2 experiment. * record sound from a microphone * play back the recorded sound """ - +import pygame as pg import time -import pygame from pygame._sdl2 import ( - AUDIO_ALLOW_FORMAT_CHANGE, - AUDIO_F32, - AudioDevice, get_audio_device_names, + AudioDevice, + AUDIO_F32, + AUDIO_ALLOW_FORMAT_CHANGE, ) from pygame._sdl2.mixer import set_post_mix + +pg.mixer.pre_init(44100, 32, 2, 512) +pg.init() + +# init_subsystem(INIT_AUDIO) +names = get_audio_device_names(True) +print(names) + sounds = [] sound_chunks = [] @@ -41,42 +48,31 @@ def postmix_callback(postmix, audiomemoryview): print(postmix) -def main(): - pygame.mixer.pre_init(44100, 32, 2, 512) - pygame.init() +set_post_mix(postmix_callback) - # init_subsystem(INIT_AUDIO) - names = get_audio_device_names(True) - print(names) +audio = AudioDevice( + devicename=names[0], + iscapture=True, + frequency=44100, + audioformat=AUDIO_F32, + numchannels=2, + chunksize=512, + allowed_changes=AUDIO_ALLOW_FORMAT_CHANGE, + callback=callback, +) +# start recording. +audio.pause(0) - set_post_mix(postmix_callback) +print(audio) - audio = AudioDevice( - devicename=names[0], - iscapture=True, - frequency=44100, - audioformat=AUDIO_F32, - numchannels=2, - chunksize=512, - allowed_changes=AUDIO_ALLOW_FORMAT_CHANGE, - callback=callback, - ) - # start recording. - audio.pause(0) - - print(audio) - - print(f"recording with '{names[0]}'") - time.sleep(5) - - print("Turning data into a pygame.mixer.Sound") - sound = pygame.mixer.Sound(buffer=b"".join(sound_chunks)) - - print("playing back recorded sound") - sound.play() - time.sleep(5) - pygame.quit() +print(f"recording with '{names[0]}'") +time.sleep(5) -if __name__ == "__main__": - main() +print("Turning data into a pg.mixer.Sound") +sound = pg.mixer.Sound(buffer=b"".join(sound_chunks)) + +print("playing back recorded sound") +sound.play() +time.sleep(5) +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/blend_fill.py b/.venv/lib/python3.14/site-packages/pygame/examples/blend_fill.py index a2c9d31..473da04 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/blend_fill.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/blend_fill.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.blend_fill +""" pygame.examples.blend_fill BLEND_ing colors in different ways with Surface.fill(). @@ -10,10 +10,8 @@ Keyboard Controls: * A - ADD, S- SUB, M- MULT, - MIN, + MAX to change the blend modes """ - import os - -import pygame +import pygame as pg from pygame import K_1, K_2, K_3, K_4, K_5, K_6, K_7, K_8, K_9 @@ -34,63 +32,63 @@ def main(): blendtype = 0 step = 5 - pygame.init() - screen = pygame.display.set_mode((640, 480)) + pg.init() + screen = pg.display.set_mode((640, 480), 0, 32) screen.fill((100, 100, 100)) - image = pygame.image.load(os.path.join(data_dir, "liquid.webp")).convert() - blendimage = pygame.image.load(os.path.join(data_dir, "liquid.webp")).convert() + image = pg.image.load(os.path.join(data_dir, "liquid.bmp")).convert() + blendimage = pg.image.load(os.path.join(data_dir, "liquid.bmp")).convert() screen.blit(image, (10, 10)) screen.blit(blendimage, (200, 10)) - pygame.display.flip() - pygame.key.set_repeat(500, 30) + pg.display.flip() + pg.key.set_repeat(500, 30) usage() going = True while going: - for event in pygame.event.get(): - if event.type == pygame.QUIT: + for event in pg.event.get(): + if event.type == pg.QUIT: going = False - if event.type == pygame.KEYDOWN: + if event.type == pg.KEYDOWN: usage() - if event.key == pygame.K_ESCAPE: + if event.key == pg.K_ESCAPE: going = False - if event.key == pygame.K_r: + if event.key == pg.K_r: color[0] += step if color[0] > 255: color[0] = 0 changed = True - elif event.key == pygame.K_g: + elif event.key == pg.K_g: color[1] += step if color[1] > 255: color[1] = 0 changed = True - elif event.key == pygame.K_b: + elif event.key == pg.K_b: color[2] += step if color[2] > 255: color[2] = 0 changed = True - elif event.key == pygame.K_a: - blendtype = pygame.BLEND_ADD + elif event.key == pg.K_a: + blendtype = pg.BLEND_ADD changed = True - elif event.key == pygame.K_s: - blendtype = pygame.BLEND_SUB + elif event.key == pg.K_s: + blendtype = pg.BLEND_SUB changed = True - elif event.key == pygame.K_m: - blendtype = pygame.BLEND_MULT + elif event.key == pg.K_m: + blendtype = pg.BLEND_MULT changed = True - elif event.key == pygame.K_PLUS: - blendtype = pygame.BLEND_MAX + elif event.key == pg.K_PLUS: + blendtype = pg.BLEND_MAX changed = True - elif event.key == pygame.K_MINUS: - blendtype = pygame.BLEND_MIN + elif event.key == pg.K_MINUS: + blendtype = pg.BLEND_MIN changed = True elif event.key in (K_1, K_2, K_3, K_4, K_5, K_6, K_7, K_8, K_9): @@ -100,15 +98,16 @@ def main(): screen.fill((100, 100, 100)) screen.blit(image, (10, 10)) blendimage.blit(image, (0, 0)) + # blendimage.fill (color, (0, 0, 20, 20), blendtype) blendimage.fill(color, None, blendtype) screen.blit(blendimage, (200, 10)) print( f"Color: {tuple(color)}, Pixel (0,0): {[blendimage.get_at((0, 0))]}" ) changed = False - pygame.display.flip() + pg.display.flip() - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/blit_blends.py b/.venv/lib/python3.14/site-packages/pygame/examples/blit_blends.py index 12da36b..e5f64a2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/blit_blends.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/blit_blends.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.blit_blends +""" pygame.examples.blit_blends Blending colors in different ways with different blend modes. @@ -19,32 +19,30 @@ Keyboard Controls * 1, 2, 3, 4 - use different images. """ - import os +import pygame as pg import time -import pygame - main_dir = os.path.split(os.path.abspath(__file__))[0] data_dir = os.path.join(main_dir, "data") try: - import numpy import pygame.surfarray + import numpy except ImportError: print("no surfarray for you! install numpy") def main(): - pygame.init() - pygame.mixer.quit() # remove ALSA underflow messages for Debian squeeze - screen = pygame.display.set_mode((640, 480)) + pg.init() + pg.mixer.quit() # remove ALSA underflow messages for Debian squeeze + screen = pg.display.set_mode((640, 480)) - im1 = pygame.Surface(screen.get_size()) + im1 = pg.Surface(screen.get_size()) # im1= im1.convert() im1.fill((100, 0, 0)) - im2 = pygame.Surface(screen.get_size()) + im2 = pg.Surface(screen.get_size()) im2.fill((0, 50, 0)) # we make a srcalpha copy of it. # im3= im2.convert(SRCALPHA) @@ -52,50 +50,50 @@ def main(): im3.set_alpha(127) images = {} - images[pygame.K_1] = im2 - images[pygame.K_2] = pygame.image.load(os.path.join(data_dir, "chimp.webp")) - images[pygame.K_3] = pygame.image.load(os.path.join(data_dir, "alien3.gif")) - images[pygame.K_4] = pygame.image.load(os.path.join(data_dir, "liquid.webp")) + images[pg.K_1] = im2 + images[pg.K_2] = pg.image.load(os.path.join(data_dir, "chimp.png")) + images[pg.K_3] = pg.image.load(os.path.join(data_dir, "alien3.gif")) + images[pg.K_4] = pg.image.load(os.path.join(data_dir, "liquid.bmp")) img_to_blit = im2.convert() iaa = img_to_blit.convert_alpha() blits = {} - blits[pygame.K_a] = pygame.BLEND_ADD - blits[pygame.K_s] = pygame.BLEND_SUB - blits[pygame.K_m] = pygame.BLEND_MULT - blits[pygame.K_EQUALS] = pygame.BLEND_MAX - blits[pygame.K_MINUS] = pygame.BLEND_MIN + blits[pg.K_a] = pg.BLEND_ADD + blits[pg.K_s] = pg.BLEND_SUB + blits[pg.K_m] = pg.BLEND_MULT + blits[pg.K_EQUALS] = pg.BLEND_MAX + blits[pg.K_MINUS] = pg.BLEND_MIN blitsn = {} - blitsn[pygame.K_a] = "BLEND_ADD" - blitsn[pygame.K_s] = "BLEND_SUB" - blitsn[pygame.K_m] = "BLEND_MULT" - blitsn[pygame.K_EQUALS] = "BLEND_MAX" - blitsn[pygame.K_MINUS] = "BLEND_MIN" + blitsn[pg.K_a] = "BLEND_ADD" + blitsn[pg.K_s] = "BLEND_SUB" + blitsn[pg.K_m] = "BLEND_MULT" + blitsn[pg.K_EQUALS] = "BLEND_MAX" + blitsn[pg.K_MINUS] = "BLEND_MIN" screen.blit(im1, (0, 0)) - pygame.display.flip() - clock = pygame.Clock() + pg.display.flip() + clock = pg.time.Clock() print("one pixel is:%s:" % [im1.get_at((0, 0))]) going = True while going: clock.tick(60) - for event in pygame.event.get(): - if event.type == pygame.QUIT: + for event in pg.event.get(): + if event.type == pg.QUIT: going = False - if event.type == pygame.KEYDOWN: + if event.type == pg.KEYDOWN: usage() - if event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE: + if event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE: going = False - elif event.type == pygame.KEYDOWN and event.key in images.keys(): + elif event.type == pg.KEYDOWN and event.key in images.keys(): img_to_blit = images[event.key] iaa = img_to_blit.convert_alpha() - elif event.type == pygame.KEYDOWN and event.key in blits.keys(): + elif event.type == pg.KEYDOWN and event.key in blits.keys(): t1 = time.time() # blits is a dict keyed with key -> blit flag. eg BLEND_ADD. im1.blit(img_to_blit, (0, 0), None, blits[event.key]) @@ -103,7 +101,7 @@ def main(): print("one pixel is:%s:" % [im1.get_at((0, 0))]) print(f"time to do:{t2 - t1}:") - elif event.type == pygame.KEYDOWN and event.key in [pygame.K_t]: + elif event.type == pg.KEYDOWN and event.key in [pg.K_t]: for bkey in blits.keys(): t1 = time.time() @@ -116,7 +114,7 @@ def main(): onedoing = blitsn[bkey] print(f"time to do :{onedoing}: is :{t2 - t1}:") - elif event.type == pygame.KEYDOWN and event.key in [pygame.K_o]: + elif event.type == pg.KEYDOWN and event.key in [pg.K_o]: t1 = time.time() # blits is a dict keyed with key -> blit flag. eg BLEND_ADD. im1.blit(iaa, (0, 0)) @@ -124,7 +122,7 @@ def main(): print("one pixel is:%s:" % [im1.get_at((0, 0))]) print(f"time to do:{t2 - t1}:") - elif event.type == pygame.KEYDOWN and event.key == pygame.K_SPACE: + elif event.type == pg.KEYDOWN and event.key == pg.K_SPACE: # this additive blend without clamp two surfaces. # im1.set_alpha(127) # im1.blit(im1, (0,0)) @@ -140,7 +138,7 @@ def main(): print("one pixel is:%s:" % [im1.get_at((0, 0))]) print(f"time to do:{t2 - t1}:") - elif event.type == pygame.KEYDOWN and event.key in [pygame.K_z]: + elif event.type == pg.KEYDOWN and event.key in [pg.K_z]: t1 = time.time() im1p = pygame.surfarray.pixels3d(im1) im2p = pygame.surfarray.pixels3d(im2) @@ -156,25 +154,21 @@ def main(): print("one pixel is:%s:" % [im1.get_at((0, 0))]) print(f"time to do:{t2 - t1}:") - elif event.type == pygame.KEYDOWN and event.key in [ - pygame.K_r, - pygame.K_g, - pygame.K_b, - ]: + elif event.type == pg.KEYDOWN and event.key in [pg.K_r, pg.K_g, pg.K_b]: # this adds one to each pixel. colmap = {} - colmap[pygame.K_r] = 0x10000 - colmap[pygame.K_g] = 0x00100 - colmap[pygame.K_b] = 0x00001 + colmap[pg.K_r] = 0x10000 + colmap[pg.K_g] = 0x00100 + colmap[pg.K_b] = 0x00001 im1p = pygame.surfarray.pixels2d(im1) im1p += colmap[event.key] del im1p print("one pixel is:%s:" % [im1.get_at((0, 0))]) - elif event.type == pygame.KEYDOWN and event.key == pygame.K_p: + elif event.type == pg.KEYDOWN and event.key == pg.K_p: print("one pixel is:%s:" % [im1.get_at((0, 0))]) - elif event.type == pygame.KEYDOWN and event.key == pygame.K_f: + elif event.type == pg.KEYDOWN and event.key == pg.K_f: # this additive blend without clamp two surfaces. t1 = time.time() @@ -187,9 +181,9 @@ def main(): print(f"time to do:{t2 - t1}:") screen.blit(im1, (0, 0)) - pygame.display.flip() + pg.display.flip() - pygame.quit() + pg.quit() def usage(): diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/camera.py b/.venv/lib/python3.14/site-packages/pygame/examples/camera.py index 986fc09..cfb91d2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/camera.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/camera.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.camera +""" pygame.examples.camera Basic image capturing and display using pygame.camera @@ -11,8 +11,7 @@ Keyboard controls - 9, start camera 9. - 10, start camera... wait a minute! There's not 10 key! """ - -import pygame +import pygame as pg import pygame.camera @@ -24,7 +23,7 @@ class VideoCapturePlayer: super().__init__(**argd) # create a display surface. standard pygame stuff - self.display = pygame.display.set_mode(self.size) + self.display = pg.display.set_mode(self.size) self.init_cams(0) def init_cams(self, which_cam_idx): @@ -47,11 +46,11 @@ class VideoCapturePlayer: # starts the camera self.camera.start() - self.clock = pygame.Clock() + self.clock = pg.time.Clock() # create a surface to capture to. for performance purposes, you want the # bit depth to be the same as that of the display surface. - self.snapshot = pygame.surface.Surface(self.size, 0, self.display) + self.snapshot = pg.surface.Surface(self.size, 0, self.display) # return the name of the camera being used, to be included in the window name return cam_id @@ -78,7 +77,7 @@ class VideoCapturePlayer: # self.snapshot = self.camera.get_image(self.display) # # self.display.blit(self.snapshot, (0,0)) - pygame.display.flip() + pg.display.flip() def main(self): # get the camera list. If there are no cameras, raise a value error. @@ -98,15 +97,13 @@ class VideoCapturePlayer: going = True while going: - events = pygame.event.get() + events = pg.event.get() for e in events: - if e.type == pygame.QUIT or ( - e.type == pygame.KEYDOWN and e.key == pygame.K_ESCAPE - ): + if e.type == pg.QUIT or (e.type == pg.KEYDOWN and e.key == pg.K_ESCAPE): going = False - if e.type == pygame.KEYDOWN: - if e.key in range(pygame.K_0, pygame.K_0 + 10): - camera = self.init_cams(e.key - pygame.K_0) + if e.type == pg.KEYDOWN: + if e.key in range(pg.K_0, pg.K_0 + 10): + camera = self.init_cams(e.key - pg.K_0) self.get_and_flip() self.clock.tick() @@ -114,10 +111,10 @@ class VideoCapturePlayer: def main(): - pygame.init() + pg.init() pygame.camera.init() VideoCapturePlayer().main() - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/chimp.py b/.venv/lib/python3.14/site-packages/pygame/examples/chimp.py index b85d28e..b3373ec 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/chimp.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/chimp.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.chimp +""" pygame.examples.chimp This simple example is used for the line-by-line tutorial that comes with pygame. It is based on a 'popular' web banner. @@ -7,14 +7,14 @@ Note there are comments here, but for the full explanation, follow along in the tutorial. """ + # Import Modules import os +import pygame as pg -import pygame - -if not pygame.font: +if not pg.font: print("Warning, fonts disabled") -if not pygame.mixer: +if not pg.mixer: print("Warning, sound disabled") main_dir = os.path.split(os.path.abspath(__file__))[0] @@ -24,15 +24,17 @@ data_dir = os.path.join(main_dir, "data") # functions to create our resources def load_image(name, colorkey=None, scale=1): fullname = os.path.join(data_dir, name) - image = pygame.image.load(fullname) + image = pg.image.load(fullname) image = image.convert() - image = pygame.transform.scale_by(image, scale) + size = image.get_size() + size = (size[0] * scale, size[1] * scale) + image = pg.transform.scale(image, size) if colorkey is not None: if colorkey == -1: colorkey = image.get_at((0, 0)) - image.set_colorkey(colorkey, pygame.RLEACCEL) + image.set_colorkey(colorkey, pg.RLEACCEL) return image, image.get_rect() @@ -41,28 +43,28 @@ def load_sound(name): def play(self): pass - if not pygame.mixer.get_init(): + if not pg.mixer or not pg.mixer.get_init(): return NoneSound() fullname = os.path.join(data_dir, name) - sound = pygame.mixer.Sound(fullname) + sound = pg.mixer.Sound(fullname) return sound # classes for our game objects -class Fist(pygame.sprite.Sprite): +class Fist(pg.sprite.Sprite): """moves a clenched fist on the screen, following the mouse""" def __init__(self): - pygame.sprite.Sprite.__init__(self) # call Sprite initializer - self.image, self.rect = load_image("fist.webp", -1) + pg.sprite.Sprite.__init__(self) # call Sprite initializer + self.image, self.rect = load_image("fist.png", -1) self.fist_offset = (-235, -80) self.punching = False def update(self): """move the fist based on the mouse position""" - pos = pygame.mouse.get_pos() + pos = pg.mouse.get_pos() self.rect.topleft = pos self.rect.move_ip(self.fist_offset) if self.punching: @@ -80,14 +82,14 @@ class Fist(pygame.sprite.Sprite): self.punching = False -class Chimp(pygame.sprite.Sprite): +class Chimp(pg.sprite.Sprite): """moves a monkey critter across the screen. it can spin the monkey when it is punched.""" def __init__(self): - pygame.sprite.Sprite.__init__(self) # call Sprite initializer - self.image, self.rect = load_image("chimp.webp", -1, 4) - screen = pygame.display.get_surface() + pg.sprite.Sprite.__init__(self) # call Sprite initializer + self.image, self.rect = load_image("chimp.png", -1, 4) + screen = pg.display.get_surface() self.area = screen.get_rect() self.rect.topleft = 10, 90 self.move = 18 @@ -107,7 +109,7 @@ class Chimp(pygame.sprite.Sprite): if self.rect.left < self.area.left or self.rect.right > self.area.right: self.move = -self.move newpos = self.rect.move((self.move, 0)) - self.image = pygame.transform.flip(self.image, True, False) + self.image = pg.transform.flip(self.image, True, False) self.rect = newpos def _spin(self): @@ -118,7 +120,7 @@ class Chimp(pygame.sprite.Sprite): self.dizzy = False self.image = self.original else: - rotate = pygame.transform.rotate + rotate = pg.transform.rotate self.image = rotate(self.original, self.dizzy) self.rect = self.image.get_rect(center=center) @@ -134,33 +136,34 @@ def main(): it initializes everything it needs, then runs in a loop until the function returns.""" # Initialize Everything - pygame.init() - screen = pygame.display.set_mode((1280, 480), pygame.SCALED) - pygame.display.set_caption("Monkey Fever") - pygame.mouse.set_visible(False) + pg.init() + screen = pg.display.set_mode((1280, 480), pg.SCALED) + pg.display.set_caption("Monkey Fever") + pg.mouse.set_visible(False) # Create The Background - background = pygame.Surface(screen.get_size()) + background = pg.Surface(screen.get_size()) background = background.convert() background.fill((170, 238, 187)) # Put Text On The Background, Centered - font = pygame.Font(None, 64) - text = font.render("Pummel The Chimp, And Win $$$", True, (10, 10, 10)) - textpos = text.get_rect(centerx=background.get_width() / 2, y=10) - background.blit(text, textpos) + if pg.font: + font = pg.font.Font(None, 64) + text = font.render("Pummel The Chimp, And Win $$$", True, (10, 10, 10)) + textpos = text.get_rect(centerx=background.get_width() / 2, y=10) + background.blit(text, textpos) # Display The Background screen.blit(background, (0, 0)) - pygame.display.flip() + pg.display.flip() # Prepare Game Objects whiff_sound = load_sound("whiff.wav") punch_sound = load_sound("punch.wav") chimp = Chimp() fist = Fist() - all_sprites = pygame.sprite.Group(chimp, fist) - clock = pygame.Clock() + allsprites = pg.sprite.RenderPlain((chimp, fist)) + clock = pg.time.Clock() # Main Loop going = True @@ -168,28 +171,28 @@ def main(): clock.tick(60) # Handle Input Events - for event in pygame.event.get(): - if event.type == pygame.QUIT: + for event in pg.event.get(): + if event.type == pg.QUIT: going = False - elif event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE: + elif event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE: going = False - elif event.type == pygame.MOUSEBUTTONDOWN: + elif event.type == pg.MOUSEBUTTONDOWN: if fist.punch(chimp): punch_sound.play() # punch chimp.punched() else: whiff_sound.play() # miss - elif event.type == pygame.MOUSEBUTTONUP: + elif event.type == pg.MOUSEBUTTONUP: fist.unpunch() - all_sprites.update() + allsprites.update() # Draw Everything screen.blit(background, (0, 0)) - all_sprites.draw(screen) - pygame.display.flip() + allsprites.draw(screen) + pg.display.flip() - pygame.quit() + pg.quit() # Game Over diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/cursors.py b/.venv/lib/python3.14/site-packages/pygame/examples/cursors.py index fe6bdbf..f9448bd 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/cursors.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/cursors.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.cursors +""" pygame.examples.cursors Click a button and the cursor will change. This example will show you: *The different types of cursors that exist @@ -8,30 +8,30 @@ This example will show you: *How to make a simple button """ +import pygame as pg import os -import pygame # Create a system cursor -system_cursor1 = pygame.SYSTEM_CURSOR_CROSSHAIR -system_cursor2 = pygame.SYSTEM_CURSOR_HAND -system_cursor3 = pygame.SYSTEM_CURSOR_IBEAM +system_cursor1 = pg.SYSTEM_CURSOR_CROSSHAIR +system_cursor2 = pg.SYSTEM_CURSOR_HAND +system_cursor3 = pg.SYSTEM_CURSOR_IBEAM # Create a color cursor -surf = pygame.Surface((40, 40)) +surf = pg.Surface((40, 40)) surf.fill((120, 50, 50)) -color_cursor = pygame.cursors.Cursor((20, 20), surf) +color_cursor = pg.cursors.Cursor((20, 20), surf) # Create a color cursor with an image surface main_dir = os.path.split(os.path.abspath(__file__))[0] -image_name = os.path.join(main_dir, "data", "cursor.webp") -image = pygame.image.load(image_name) -image_cursor = pygame.cursors.Cursor( +image_name = os.path.join(main_dir, "data", "cursor.png") +image = pg.image.load(image_name) +image_cursor = pg.cursors.Cursor( (image.get_width() // 2, image.get_height() // 2), image ) @@ -66,16 +66,16 @@ thickarrow_strings = ( " ", ) -bitmap_cursor1 = pygame.cursors.Cursor( +bitmap_cursor1 = pg.cursors.Cursor( (24, 24), (0, 0), - *pygame.cursors.compile(thickarrow_strings, black="X", white=".", xor="o"), + *pg.cursors.compile(thickarrow_strings, black="X", white=".", xor="o"), ) # Create a bitmap cursor from premade simple strings -bitmap_cursor2 = pygame.cursors.diamond +bitmap_cursor2 = pg.cursors.diamond # Calculate if mouse position is inside circle @@ -84,14 +84,14 @@ def check_circle(mouse_pos_x, mouse_pos_y, center_x, center_y, radius): def main(): - pygame.init() - pygame.display.set_caption("Cursors Example") + pg.init() + pg.display.set_caption("Cursors Example") - pygame.font.init() - font = pygame.Font(None, 30) - font1 = pygame.Font(None, 24) + pg.font.init() + font = pg.font.Font(None, 30) + font1 = pg.font.Font(None, 24) - bg = pygame.display.set_mode((500, 400)) + bg = pg.display.set_mode((500, 400)) bg.fill((183, 201, 226)) # Initialize circles @@ -119,17 +119,17 @@ def main(): pos_y6 = 220 pos_y7 = 140 - circle1 = pygame.draw.circle(bg, (255, 255, 255), (pos_x1, pos_y1), radius1) - circle2 = pygame.draw.circle(bg, (255, 255, 255), (pos_x2, pos_y2), radius2) - circle3 = pygame.draw.circle(bg, (255, 255, 255), (pos_x3, pos_y3), radius3) - circle4 = pygame.draw.circle(bg, (255, 255, 255), (pos_x4, pos_y4), radius4) - circle5 = pygame.draw.circle(bg, (255, 255, 255), (pos_x5, pos_y5), radius5) - circle6 = pygame.draw.circle(bg, (255, 255, 255), (pos_x6, pos_y6), radius6) - circle7 = pygame.draw.circle(bg, (255, 255, 255), (pos_x7, pos_y7), radius7) + circle1 = pg.draw.circle(bg, (255, 255, 255), (pos_x1, pos_y1), radius1) + circle2 = pg.draw.circle(bg, (255, 255, 255), (pos_x2, pos_y2), radius2) + circle3 = pg.draw.circle(bg, (255, 255, 255), (pos_x3, pos_y3), radius3) + circle4 = pg.draw.circle(bg, (255, 255, 255), (pos_x4, pos_y4), radius4) + circle5 = pg.draw.circle(bg, (255, 255, 255), (pos_x5, pos_y5), radius5) + circle6 = pg.draw.circle(bg, (255, 255, 255), (pos_x6, pos_y6), radius6) + circle7 = pg.draw.circle(bg, (255, 255, 255), (pos_x7, pos_y7), radius7) # Initialize button button_text = font1.render("Click here to change cursor", True, (0, 0, 0)) - button = pygame.draw.rect( + button = pg.draw.rect( bg, (180, 180, 180), (139, 300, button_text.get_width() + 5, button_text.get_height() + 50), @@ -137,7 +137,7 @@ def main(): button_text_rect = button_text.get_rect(center=button.center) bg.blit(button_text, button_text_rect) - pygame.display.update() + pg.display.update() cursors = [ system_cursor1, @@ -150,60 +150,60 @@ def main(): ] index = 0 - pygame.mouse.set_cursor(cursors[index]) + pg.mouse.set_cursor(cursors[index]) - was_pressed = False - clock = pygame.Clock() + pressed = False + clock = pg.time.Clock() while True: clock.tick(50) - mouse_x, mouse_y = pygame.mouse.get_pos() + mouse_x, mouse_y = pg.mouse.get_pos() # Check if mouse is inside a circle to change its color if check_circle(mouse_x, mouse_y, circle1.centerx, circle1.centery, radius1): - circle1 = pygame.draw.circle(bg, (255, 0, 0), (pos_x1, pos_y1), radius1) + circle1 = pg.draw.circle(bg, (255, 0, 0), (pos_x1, pos_y1), radius1) else: - circle1 = pygame.draw.circle(bg, (255, 255, 255), (pos_x1, pos_y1), radius1) + circle1 = pg.draw.circle(bg, (255, 255, 255), (pos_x1, pos_y1), radius1) if check_circle(mouse_x, mouse_y, circle2.centerx, circle2.centery, radius2): - circle2 = pygame.draw.circle(bg, (255, 127, 0), (pos_x2, pos_y2), radius2) + circle2 = pg.draw.circle(bg, (255, 127, 0), (pos_x2, pos_y2), radius2) else: - circle2 = pygame.draw.circle(bg, (255, 255, 255), (pos_x2, pos_y2), radius2) + circle2 = pg.draw.circle(bg, (255, 255, 255), (pos_x2, pos_y2), radius2) if check_circle(mouse_x, mouse_y, circle3.centerx, circle3.centery, radius3): - circle3 = pygame.draw.circle(bg, (255, 255, 0), (pos_x3, pos_y3), radius3) + circle3 = pg.draw.circle(bg, (255, 255, 0), (pos_x3, pos_y3), radius3) else: - circle3 = pygame.draw.circle(bg, (255, 255, 255), (pos_x3, pos_y3), radius3) + circle3 = pg.draw.circle(bg, (255, 255, 255), (pos_x3, pos_y3), radius3) if check_circle(mouse_x, mouse_y, circle4.centerx, circle4.centery, radius3): - circle4 = pygame.draw.circle(bg, (0, 255, 0), (pos_x4, pos_y4), radius4) + circle4 = pg.draw.circle(bg, (0, 255, 0), (pos_x4, pos_y4), radius4) else: - circle4 = pygame.draw.circle(bg, (255, 255, 255), (pos_x4, pos_y4), radius4) + circle4 = pg.draw.circle(bg, (255, 255, 255), (pos_x4, pos_y4), radius4) if check_circle(mouse_x, mouse_y, circle5.centerx, circle5.centery, radius4): - circle5 = pygame.draw.circle(bg, (0, 0, 255), (pos_x5, pos_y5), radius5) + circle5 = pg.draw.circle(bg, (0, 0, 255), (pos_x5, pos_y5), radius5) else: - circle5 = pygame.draw.circle(bg, (255, 255, 255), (pos_x5, pos_y5), radius5) + circle5 = pg.draw.circle(bg, (255, 255, 255), (pos_x5, pos_y5), radius5) if check_circle(mouse_x, mouse_y, circle6.centerx, circle6.centery, radius6): - circle6 = pygame.draw.circle(bg, (75, 0, 130), (pos_x6, pos_y6), radius6) + circle6 = pg.draw.circle(bg, (75, 0, 130), (pos_x6, pos_y6), radius6) else: - circle6 = pygame.draw.circle(bg, (255, 255, 255), (pos_x6, pos_y6), radius6) + circle6 = pg.draw.circle(bg, (255, 255, 255), (pos_x6, pos_y6), radius6) if check_circle(mouse_x, mouse_y, circle7.centerx, circle7.centery, radius7): - circle7 = pygame.draw.circle(bg, (148, 0, 211), (pos_x7, pos_y7), radius7) + circle7 = pg.draw.circle(bg, (148, 0, 211), (pos_x7, pos_y7), radius7) else: - circle7 = pygame.draw.circle(bg, (255, 255, 255), (pos_x7, pos_y7), radius7) + circle7 = pg.draw.circle(bg, (255, 255, 255), (pos_x7, pos_y7), radius7) bg.fill((183, 201, 226), (0, 15, bg.get_width(), 50)) text1 = font.render( - (f"This is a {pygame.mouse.get_cursor().type} cursor"), True, (0, 0, 0) + (f"This is a {pg.mouse.get_cursor().type} cursor"), True, (0, 0, 0) ) text_rect1 = text1.get_rect(center=(bg.get_width() / 2, 40)) bg.blit(text1, text_rect1) - button = pygame.draw.rect( + button = pg.draw.rect( bg, (100, 149, 240), (139, 300, button_text.get_width() + 5, button_text.get_height() + 50), @@ -212,7 +212,7 @@ def main(): # Check if button was clicked and change cursor if button.collidepoint(mouse_x, mouse_y): - button = pygame.draw.rect( + button = pg.draw.rect( bg, (60, 100, 255), ( @@ -224,8 +224,8 @@ def main(): ) bg.blit(button_text, button_text_rect) - if pygame.mouse.get_pressed()[0] and not was_pressed: - button = pygame.draw.rect( + if pg.mouse.get_pressed()[0] == 1 and pressed is False: + button = pg.draw.rect( bg, (0, 0, 139), ( @@ -238,18 +238,21 @@ def main(): bg.blit(button_text, button_text_rect) index += 1 index %= len(cursors) - pygame.mouse.set_cursor(cursors[index]) - pygame.display.update() - pygame.time.delay(40) + pg.mouse.set_cursor(cursors[index]) + pg.display.update() + pg.time.delay(40) - was_pressed = pygame.mouse.get_pressed()[0] + if pg.mouse.get_pressed()[0] == 1: + pressed = True + elif pg.mouse.get_pressed()[0] == 0: + pressed = False - for event in pygame.event.get(): - if event.type == pygame.QUIT: - pygame.quit() + for event in pg.event.get(): + if event.type == pg.QUIT: + pg.quit() raise SystemExit - pygame.display.update() + pg.display.update() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/MIDI_sample.mid b/.venv/lib/python3.14/site-packages/pygame/examples/data/MIDI_sample.mid deleted file mode 100644 index a52838c..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/MIDI_sample.mid and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/animated_sample.gif b/.venv/lib/python3.14/site-packages/pygame/examples/data/animated_sample.gif deleted file mode 100644 index d41b6a1..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/animated_sample.gif and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/arraydemo.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/arraydemo.webp deleted file mode 100644 index 2a20e52..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/arraydemo.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/attributions.txt b/.venv/lib/python3.14/site-packages/pygame/examples/data/attributions.txt deleted file mode 100644 index 9c46647..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/examples/data/attributions.txt +++ /dev/null @@ -1,7 +0,0 @@ -surfonasinewave.xm: -By FearofDark -https://modarchive.org/index.php?request=view_by_moduleid&query=169104 - -MIDI_sample.mid -Dogman15 at English Wikipedia -https://en.wikipedia.org/wiki/File:MIDI_sample.mid diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/chimp.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/chimp.webp deleted file mode 100644 index 43b7d91..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/chimp.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/cursor.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/cursor.webp deleted file mode 100644 index 7415c2a..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/cursor.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/fist.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/fist.webp deleted file mode 100644 index 925a713..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/fist.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/frame.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/frame.webp deleted file mode 100644 index 30302ce..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/frame.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.flac b/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.flac deleted file mode 100644 index 34134ab..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.flac and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.opus b/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.opus deleted file mode 100644 index 2bc9e4e..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.opus and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.wv b/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.wv deleted file mode 100644 index 1d99c69..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/house_lo.wv and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/liquid.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/liquid.webp deleted file mode 100644 index 70df9c4..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/liquid.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/magenta.lbm b/.venv/lib/python3.14/site-packages/pygame/examples/data/magenta.lbm deleted file mode 100644 index 5735550..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/magenta.lbm and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/metadata.mp3 b/.venv/lib/python3.14/site-packages/pygame/examples/data/metadata.mp3 deleted file mode 100644 index 76d791f..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/metadata.mp3 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/midikeys.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/midikeys.webp deleted file mode 100644 index f78126e..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/midikeys.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/peppers3.tif b/.venv/lib/python3.14/site-packages/pygame/examples/data/peppers3.tif deleted file mode 100644 index bada69f..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/peppers3.tif and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/purple.qoi b/.venv/lib/python3.14/site-packages/pygame/examples/data/purple.qoi deleted file mode 100644 index 793c5c6..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/purple.qoi and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/static.webp b/.venv/lib/python3.14/site-packages/pygame/examples/data/static.webp deleted file mode 100644 index ae00323..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/static.webp and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/surfonasinewave.xm b/.venv/lib/python3.14/site-packages/pygame/examples/data/surfonasinewave.xm deleted file mode 100644 index 131f5be..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/surfonasinewave.xm and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/tomato.xcf b/.venv/lib/python3.14/site-packages/pygame/examples/data/tomato.xcf deleted file mode 100644 index ffd0458..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/tomato.xcf and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/data/white.pbm b/.venv/lib/python3.14/site-packages/pygame/examples/data/white.pbm deleted file mode 100644 index a354e49..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/examples/data/white.pbm and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/dropevent.py b/.venv/lib/python3.14/site-packages/pygame/examples/dropevent.py index 055d767..d159616 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/dropevent.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/dropevent.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.dropfile +""" pygame.examples.dropfile Drag and drop an image on here. @@ -10,69 +10,62 @@ Uses these events: * DROPTEXT * DROPFILE """ - -import pygame - -pygame.init() +import pygame as pg def main(): - running = True - screen_size = (640, 480) - surf = pygame.display.set_mode(screen_size) - font = pygame.font.SysFont("Arial", 24) - font.align = pygame.FONT_CENTER - clock = pygame.Clock() + pg.init() - spr_file_text = font.render("Feed me some file or image!", True, (255, 255, 255)) + going = True + surf = pg.display.set_mode((640, 480)) + font = pg.font.SysFont("Arial", 24) + clock = pg.time.Clock() + + spr_file_text = font.render("Drag and drop a file or image!", 1, (255, 255, 255)) spr_file_text_rect = spr_file_text.get_rect() spr_file_text_rect.center = surf.get_rect().center spr_file_image = None spr_file_image_rect = None - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - running = False - elif event.type == pygame.DROPBEGIN: - print(event) + while going: + for ev in pg.event.get(): + if ev.type == pg.QUIT: + going = False + elif ev.type == pg.DROPBEGIN: + print(ev) print("File drop begin!") - elif event.type == pygame.DROPCOMPLETE: - print(event) + elif ev.type == pg.DROPCOMPLETE: + print(ev) print("File drop complete!") - elif event.type == pygame.DROPTEXT: - print(event) - spr_file_text = font.render( - event.text, True, (255, 255, 255), wraplength=screen_size[0] - 10 - ) + elif ev.type == pg.DROPTEXT: + print(ev) + spr_file_text = font.render(ev.text, 1, (255, 255, 255)) spr_file_text_rect = spr_file_text.get_rect() spr_file_text_rect.center = surf.get_rect().center - elif event.type == pygame.DROPFILE: - print(event) - spr_file_text = font.render( - event.file, True, (255, 255, 255), None, screen_size[0] - 10 - ) + elif ev.type == pg.DROPFILE: + print(ev) + spr_file_text = font.render(ev.file, 1, (255, 255, 255)) spr_file_text_rect = spr_file_text.get_rect() spr_file_text_rect.center = surf.get_rect().center # Try to open the file if it's an image - filetype = event.file[-3:] + filetype = ev.file[-3:] if filetype in ["png", "bmp", "jpg"]: - spr_file_image = pygame.image.load(event.file).convert() + spr_file_image = pg.image.load(ev.file).convert() spr_file_image.set_alpha(127) spr_file_image_rect = spr_file_image.get_rect() spr_file_image_rect.center = surf.get_rect().center surf.fill((0, 0, 0)) surf.blit(spr_file_text, spr_file_text_rect) - if spr_file_image: + if spr_file_image and spr_file_image_rect is not None: surf.blit(spr_file_image, spr_file_image_rect) - pygame.display.flip() + pg.display.flip() clock.tick(30) - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/eventlist.py b/.venv/lib/python3.14/site-packages/pygame/examples/eventlist.py index 66c3871..3afe5bc 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/eventlist.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/eventlist.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.eventlist +""" pygame.examples.eventlist Learn about pygame events and input. @@ -12,7 +12,7 @@ usage = """ Mouse Controls ============== -- 1st button on mouse (left click) to toggle events 'grabbed'. +- 1st button on mouse (left click) to toggle events 'grabed'. - 3rd button on mouse (right click) to toggle mouse visible. - The window can be resized. - Mouse the mouse around to see mouse events. @@ -24,20 +24,17 @@ Keyboard Joystick Controls - press keys up an down to see events. - you can see joystick events if any are plugged in. +- press "c" to toggle events generated by controllers. """ -import pygame +from typing import List +import pygame as pg -try: - import pygame._sdl2.controller +import pygame._sdl2.controller - pygame._sdl2.controller.init() - SDL2 = True -except ImportError: - SDL2 = False -img_on_off = [] -font = None +img_on_off: List[pg.Surface] = [] +font: pg.font.Font last_key = None # these are a running counter of mouse.get_rel() calls. @@ -58,36 +55,36 @@ def drawstatus(win): win.blit(font.render("Status Area", 1, (155, 155, 155), bgcolor), (2, 2)) pos = showtext(win, (10, 30), "Mouse Focus", (255, 255, 255), bgcolor) - win.blit(img_on_off[pygame.mouse.get_focused()], pos) + win.blit(img_on_off[pg.mouse.get_focused()], pos) pos = showtext( win, (pos[0] + 50, pos[1]), "Mouse visible", (255, 255, 255), bgcolor ) - win.blit(img_on_off[pygame.mouse.get_visible()], pos) + win.blit(img_on_off[pg.mouse.get_visible()], pos) pos = showtext(win, (330, 30), "Keyboard Focus", (255, 255, 255), bgcolor) - win.blit(img_on_off[pygame.key.get_focused()], pos) + win.blit(img_on_off[pg.key.get_focused()], pos) pos = showtext(win, (10, 60), "Mouse Position(rel)", (255, 255, 255), bgcolor) - rel = pygame.mouse.get_rel() + rel = pg.mouse.get_rel() virtual_x += rel[0] virtual_y += rel[1] - mouse_data = tuple(list(pygame.mouse.get_pos()) + list(rel)) + mouse_data = tuple(list(pg.mouse.get_pos()) + list(rel)) p = "%s, %s (%s, %s)" % mouse_data showtext(win, pos, p, bgcolor, (255, 255, 55)) pos = showtext(win, (330, 60), "Last Keypress", (255, 255, 255), bgcolor) if last_key: - p = "%d, %s" % (last_key, pygame.key.name(last_key)) + p = "%d, %s" % (last_key, pg.key.name(last_key)) else: p = "None" showtext(win, pos, p, bgcolor, (255, 255, 55)) pos = showtext(win, (10, 90), "Input Grabbed", (255, 255, 255), bgcolor) - win.blit(img_on_off[pygame.event.get_grab()], pos) + win.blit(img_on_off[pg.event.get_grab()], pos) - is_virtual_mouse = pygame.event.get_grab() and not pygame.mouse.get_visible() + is_virtual_mouse = pg.event.get_grab() and not pg.mouse.get_visible() pos = showtext(win, (330, 90), "Virtual Mouse", (255, 255, 255), bgcolor) win.blit(img_on_off[is_virtual_mouse], pos) if is_virtual_mouse: @@ -98,84 +95,98 @@ def drawstatus(win): def drawhistory(win, history): img = font.render("Event History Area", 1, (155, 155, 155), (0, 0, 0)) win.blit(img, (2, 132)) - - img = font.render("\n".join(history), 1, (50, 200, 50), (0, 0, 0), wraplength=640) - win.blit(img, (10, 250)) + ypos = 450 + h = list(history) + h.reverse() + for line in h: + r = win.blit(line, (10, ypos)) + win.fill(0, (r.right, r.top, 620, r.height)) + ypos -= font.get_height() def draw_usage_in_history(history, text): - for line in text.split("\n"): - if "===" not in line and line != "": - history.append(line) + lines = text.split("\n") + for line in lines: + if line == "" or "===" in line: + continue + img = font.render(line, 1, (50, 200, 50), (0, 0, 0)) + history.append(img) def main(): - pygame.init() + pg.init() + pygame._sdl2.controller.init() + print(usage) - win = pygame.display.set_mode((640, 480), pygame.RESIZABLE) - pygame.display.set_caption("Mouse Focus Workout. h key for help") + win = pg.display.set_mode((640, 480), pg.RESIZABLE) + pg.display.set_caption("Mouse Focus Workout. h key for help") global font - font = pygame.Font(None, 26) + font = pg.font.Font(None, 26) global img_on_off img_on_off.append(font.render("Off", 1, (0, 0, 0), (255, 50, 50))) img_on_off.append(font.render("On", 1, (0, 0, 0), (50, 255, 50))) - # stores lines of text representing what has gone through the event queue + # stores surfaces of text representing what has gone through the event queue history = [] # let's turn on the joysticks just so we can play with em - for x in range(pygame.joystick.get_count()): - if SDL2 and pygame._sdl2.controller.is_controller(x): + for x in range(pg.joystick.get_count()): + if pygame._sdl2.controller.is_controller(x): c = pygame._sdl2.controller.Controller(x) - txt = f"Enabled controller: {c.name}" + txt = "Enabled controller: " + c.name else: - j = pygame.joystick.Joystick(x) - txt = f"Enabled joystick: {j.get_name()}" + j = pg.joystick.Joystick(x) + txt = "Enabled joystick: " + j.get_name() - history.append(txt) - - if not pygame.joystick.get_count(): - history.append("No Joysticks to Initialize") + img = font.render(txt, 1, (50, 200, 50), (0, 0, 0)) + history.append(img) + if not pg.joystick.get_count(): + img = font.render("No Joysticks to Initialize", 1, (50, 200, 50), (0, 0, 0)) + history.append(img) going = True while going: - for e in pygame.event.get(): - if e.type == pygame.KEYDOWN: - if e.key == pygame.K_ESCAPE: + for e in pg.event.get(): + if e.type == pg.KEYDOWN: + if e.key == pg.K_ESCAPE: going = False else: global last_key last_key = e.key - if e.key == pygame.K_h: + if e.key == pg.K_h: draw_usage_in_history(history, usage) + if e.key == pg.K_c: + current_state = pygame._sdl2.controller.get_eventstate() + pygame._sdl2.controller.set_eventstate(not current_state) - if e.type == pygame.MOUSEBUTTONDOWN and e.button == 1: - pygame.event.set_grab(not pygame.event.get_grab()) + if e.type == pg.MOUSEBUTTONDOWN and e.button == 1: + pg.event.set_grab(not pg.event.get_grab()) - if e.type == pygame.MOUSEBUTTONDOWN and e.button == 3: - pygame.mouse.set_visible(not pygame.mouse.get_visible()) + if e.type == pg.MOUSEBUTTONDOWN and e.button == 3: + pg.mouse.set_visible(not pg.mouse.get_visible()) - if e.type != pygame.MOUSEMOTION: - txt = f"{pygame.event.event_name(e.type)}: {e.dict}" - history.append(txt) + if e.type != pg.MOUSEMOTION: + txt = f"{pg.event.event_name(e.type)}: {e.dict}" + img = font.render(txt, 1, (50, 200, 50), (0, 0, 0)) + history.append(img) history = history[-13:] - if e.type == pygame.VIDEORESIZE: - win = pygame.display.set_mode(e.size, pygame.RESIZABLE) + if e.type == pg.VIDEORESIZE: + win = pg.display.set_mode(e.size, pg.RESIZABLE) - if e.type == pygame.QUIT: + if e.type == pg.QUIT: going = False drawstatus(win) drawhistory(win, history) - pygame.display.flip() - pygame.time.wait(10) + pg.display.flip() + pg.time.wait(10) - pygame.quit() + pg.quit() raise SystemExit diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/font_viewer.py b/.venv/lib/python3.14/site-packages/pygame/examples/font_viewer.py index dc544b0..fb7efb4 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/font_viewer.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/font_viewer.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.font_viewer +""" pygame.examples.font_viewer Scroll through your system fonts from a list of surfaces or one huge buffer. This example exhibits: @@ -22,11 +22,10 @@ Keyboard Controls: * Press up or down to scroll * Press escape to exit """ - -import os import sys +import os -import pygame +import pygame as pg use_big_surface = False # draw into large buffer and save png file @@ -42,15 +41,16 @@ class FontViewer: MOUSE_SCROLL_SPEED = 50 def __init__(self): - pygame.init() + pg.init() # create a window that uses 80 percent of the screen - info = pygame.display.Info() - self.screen_size = (int(info.current_w * 0.8), int(info.current_h * 0.8)) - pygame.display.set_mode(self.screen_size) - self.font_size = self.screen_size[1] // 16 + info = pg.display.Info() + w = info.current_w + h = info.current_h + pg.display.set_mode((int(w * 0.8), int(h * 0.8))) + self.font_size = h // 20 - self.clock = pygame.Clock() + self.clock = pg.time.Clock() self.y_offset = 0 self.grabbed = False self.render_fonts("&N abcDEF789") @@ -70,10 +70,11 @@ class FontViewer: path = "" if len(sys.argv) > 1 and os.path.exists(sys.argv[1]): path = os.path.join(sys.argv[1], "") - fonts = [] if os.path.exists(path): fonts = [font for font in os.listdir(path) if font.endswith(".ttf")] - return fonts or pygame.font.get_fonts(), path + else: + fonts = pg.font.get_fonts() + return fonts, path def render_fonts(self, text="A display of font &N"): """ @@ -91,27 +92,23 @@ class FontViewer: total_height = 0 max_width = 0 - load_font = pygame.Font if path else pygame.font.SysFont + load_font = pg.font.Font if path else pg.font.SysFont # display instructions at the top of the display - font = pygame.font.SysFont(pygame.font.get_default_font(), font_size) - font.align = pygame.FONT_CENTER - instructions = ( - "Use the scroll wheel or click and drag to scroll up " - "and down. Fonts that don't use the Latin Alphabet " - "might render incorrectly. Here are your " - f"{len(fonts)} fonts" + font = pg.font.SysFont(pg.font.get_default_font(), font_size) + lines = ( + "Use the scroll wheel or click and drag", + "to scroll up and down.", + "Fonts that don't use the Latin Alphabet", + "might render incorrectly.", + f"Here are your {len(fonts)} fonts", + "", ) - surf = font.render( - instructions, - True, - instruction_color, - self.back_color, - self.screen_size[0] - 20, - ) - font_surfaces.append((surf, total_height)) - total_height += surf.get_height() - max_width = max(max_width, surf.get_width()) + for line in lines: + surf = font.render(line, 1, instruction_color, self.back_color) + font_surfaces.append((surf, total_height)) + total_height += surf.get_height() + max_width = max(max_width, surf.get_width()) # render all the fonts and store them with the total height for name in sorted(fonts): @@ -121,10 +118,8 @@ class FontViewer: continue line = text.replace("&N", name) try: - surf = font.render( - line, True, color, self.back_color, self.screen_size[0] - 20 - ) - except pygame.error as e: + surf = font.render(line, 1, color, self.back_color) + except pg.error as e: print(e) break @@ -136,16 +131,16 @@ class FontViewer: self.total_height = total_height self.max_width = max_width self.font_surfaces = font_surfaces - self.max_y = total_height - pygame.display.get_surface().get_height() + self.max_y = total_height - pg.display.get_surface().get_height() def display_fonts(self): """ Display the visible fonts based on the y_offset value(updated in handle_events) and the height of the pygame window. """ - pygame.display.set_caption("Font Viewer") - display = pygame.display.get_surface() - clock = pygame.Clock() + pg.display.set_caption("Font Viewer") + display = pg.display.get_surface() + clock = pg.time.Clock() center = display.get_width() // 2 while True: @@ -157,12 +152,12 @@ class FontViewer: bottom >= self.y_offset and top <= self.y_offset + display.get_height() ): - x = center - surface.get_width() / 2 + x = center - surface.get_width() // 2 display.blit(surface, (x, top - self.y_offset)) # get input and update the screen if not self.handle_events(): break - pygame.display.flip() + pg.display.flip() clock.tick(30) def render_surface(self): @@ -175,7 +170,7 @@ class FontViewer: be useful for testing large surfaces. """ - large_surface = pygame.surface.Surface( + large_surface = pg.surface.Surface( (self.max_width, self.total_height) ).convert() large_surface.fill(self.back_color) @@ -197,9 +192,7 @@ class FontViewer: x = center - int(w / 2) large_surface.blit(surface, (x, y)) y += surface.get_height() - self.max_y = ( - large_surface.get_height() - pygame.display.get_surface().get_height() - ) + self.max_y = large_surface.get_height() - pg.display.get_surface().get_height() self.surface = large_surface def display_surface(self, time=10): @@ -208,12 +201,12 @@ class FontViewer: based on the y_offset value(set in handle_events) and the height of the pygame window. """ - screen = pygame.display.get_surface() + screen = pg.display.get_surface() # Create a Rect equal to size of screen. Then we can just change its # top attribute to draw the desired part of the rendered font surface # to the display surface - rect = pygame.rect.Rect( + rect = pg.rect.Rect( 0, 0, self.surface.get_width(), @@ -228,11 +221,11 @@ class FontViewer: screen.fill(self.back_color) rect.top = self.y_offset screen.blit(self.surface, (x, 0), rect) - pygame.display.flip() + pg.display.flip() self.clock.tick(20) def save_png(self, name="font_viewer.png"): - pygame.image.save(self.surface, name) + pg.image.save(self.surface, name) file_size = os.path.getsize(name) // 1024 print(f"font surface saved to {name}\nsize: {file_size:,}Kb") @@ -243,37 +236,37 @@ class FontViewer: changed based on mouse and keyboard input. display_fonts() and display_surface() use the y_offset to scroll display. """ - events = pygame.event.get() + events = pg.event.get() for e in events: - if e.type == pygame.QUIT: + if e.type == pg.QUIT: return False - elif e.type == pygame.KEYDOWN: - if e.key == pygame.K_ESCAPE: + elif e.type == pg.KEYDOWN: + if e.key == pg.K_ESCAPE: return False - elif e.type == pygame.MOUSEWHEEL: + elif e.type == pg.MOUSEWHEEL: self.y_offset += e.y * self.MOUSE_SCROLL_SPEED * -1 - elif e.type == pygame.MOUSEBUTTONDOWN: + elif e.type == pg.MOUSEBUTTONDOWN: # enter dragging mode on mouse down self.grabbed = True - pygame.event.set_grab(True) - elif e.type == pygame.MOUSEBUTTONUP: + pg.event.set_grab(True) + elif e.type == pg.MOUSEBUTTONUP: # exit drag mode on mouse up self.grabbed = False - pygame.event.set_grab(False) + pg.event.set_grab(False) # allow simple accelerated scrolling with the keyboard - keys = pygame.key.get_pressed() - if keys[pygame.K_UP]: + keys = pg.key.get_pressed() + if keys[pg.K_UP]: self.key_held += 1 self.y_offset -= int(self.KEY_SCROLL_SPEED * (self.key_held // 10)) - elif keys[pygame.K_DOWN]: + elif keys[pg.K_DOWN]: self.key_held += 1 self.y_offset += int(self.KEY_SCROLL_SPEED * (self.key_held // 10)) else: self.key_held = 20 # set the y_offset for scrolling and keep it between 0 and max_y - y = pygame.mouse.get_rel()[1] + y = pg.mouse.get_rel()[1] if y and self.grabbed: self.y_offset -= y @@ -281,6 +274,5 @@ class FontViewer: return True -if __name__ == "__main__": - viewer = FontViewer() - pygame.quit() +viewer = FontViewer() +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/fonty.py b/.venv/lib/python3.14/site-packages/pygame/examples/fonty.py index badade2..786f741 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/fonty.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/fonty.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.fonty +""" pygame.examples.fonty Here we load a .TTF True Type font file, and display it in a basic pygame window. @@ -8,17 +8,16 @@ Demonstrating several Font object attributes. - basic window, event, and font management. """ - -import pygame +import pygame as pg def main(): # initialize - pygame.init() + pg.init() resolution = 400, 200 - screen = pygame.display.set_mode(resolution) + screen = pg.display.set_mode(resolution) - ## pygame.mouse.set_cursor(*pygame.cursors.diamond) + ## pg.mouse.set_cursor(*pg.cursors.diamond) fg = 250, 240, 230 bg = 5, 5, 5 @@ -28,7 +27,7 @@ def main(): screen.fill(wincolor) # load font, prepare values - font = pygame.Font(None, 80) + font = pg.font.Font(None, 80) text = "Fonty" size = font.size(text) @@ -42,7 +41,7 @@ def main(): screen.blit(ren, (10, 40 + size[1])) font.set_underline(0) - a_sys_font = pygame.font.SysFont("Arial", 60) + a_sys_font = pg.font.SysFont("Arial", 60) # AA, no transparency, bold a_sys_font.set_bold(1) @@ -70,16 +69,12 @@ def main(): ##screen.blit(ren, (30 + size[0], 40 + size[1])) # show the surface and await user quit - pygame.display.flip() + pg.display.flip() while True: # use event.wait to keep from polling 100% cpu - if pygame.event.wait().type in ( - pygame.QUIT, - pygame.KEYDOWN, - pygame.MOUSEBUTTONDOWN, - ): + if pg.event.wait().type in (pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN): break - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/freetype_misc.py b/.venv/lib/python3.14/site-packages/pygame/examples/freetype_misc.py index e4041d6..70a6090 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/freetype_misc.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/freetype_misc.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.freetype_misc +""" pygame.examples.freetype_misc Miscellaneous (or misc) means: @@ -29,20 +29,18 @@ Herein lies a *BOLD* demo consisting of a mixture of various things. Enjoy! """ - import os - -import pygame +import pygame as pg import pygame.freetype as freetype def run(): - pygame.init() + pg.init() fontdir = os.path.dirname(os.path.abspath(__file__)) font = freetype.Font(os.path.join(fontdir, "data", "sans.ttf")) - screen = pygame.display.set_mode((800, 600)) + screen = pg.display.set_mode((800, 600)) screen.fill("gray") font.underline_adjustment = 0.5 @@ -146,17 +144,13 @@ def run(): style=freetype.STYLE_NORMAL, ) - pygame.display.flip() + pg.display.flip() while True: - if pygame.event.wait().type in ( - pygame.QUIT, - pygame.KEYDOWN, - pygame.MOUSEBUTTONDOWN, - ): + if pg.event.wait().type in (pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN): break - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/glcube.py b/.venv/lib/python3.14/site-packages/pygame/examples/glcube.py index 892442a..9d85c24 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/glcube.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/glcube.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.glcube +""" pygame.examples.glcube Draw a cube on the screen. @@ -23,11 +23,10 @@ Keyboard Controls * f key to toggle fullscreen. """ - -import ctypes import math +import ctypes -import pygame +import pygame as pg try: import OpenGL.GL as GL @@ -37,11 +36,12 @@ except ImportError: raise SystemExit try: - from numpy import array, dot, eye, float32, uint32, zeros + from numpy import array, dot, eye, zeros, float32, uint32 except ImportError: print("numpy missing. The GLCUBE example requires: pyopengl numpy") raise SystemExit + # do we want to use the 'modern' OpenGL API or the old one? # This example shows you how to do both. USE_MODERN_GL = True @@ -259,16 +259,16 @@ def init_gl_modern(display_size): uniform mat4 view; uniform mat4 projection; - uniform vec4 color_mul; - uniform vec4 color_add; + uniform vec4 colour_mul; + uniform vec4 colour_add; - in vec4 vertex_color; // vertex color in + in vec4 vertex_colour; // vertex colour in in vec3 vertex_position; - out vec4 vertex_color_out; // vertex color out + out vec4 vertex_color_out; // vertex colour out void main() { - vertex_color_out = (color_mul * vertex_color) + color_add; + vertex_color_out = (colour_mul * vertex_colour) + colour_add; gl_Position = projection * view * model * vec4(vertex_position, 1.0); } @@ -276,7 +276,7 @@ def init_gl_modern(display_size): fragment_code = """ #version 150 - in vec4 vertex_color_out; // vertex color from vertex shader + in vec4 vertex_color_out; // vertex colour from vertex shader out vec4 fragColor; void main() { @@ -320,7 +320,9 @@ def init_gl_modern(display_size): # ------------------------------------------ # Cube Data - vertices = zeros(8, [("vertex_position", float32, 3), ("vertex_color", float32, 4)]) + vertices = zeros( + 8, [("vertex_position", float32, 3), ("vertex_colour", float32, 4)] + ) vertices["vertex_position"] = [ [1, 1, 1], @@ -333,7 +335,7 @@ def init_gl_modern(display_size): [-1, -1, -1], ] - vertices["vertex_color"] = [ + vertices["vertex_colour"] = [ [0, 1, 1, 1], [0, 0, 1, 1], [0, 0, 0, 1], @@ -408,7 +410,7 @@ def init_gl_modern(display_size): offset = ctypes.c_void_p(vertices.dtype["vertex_position"].itemsize) - loc = GL.glGetAttribLocation(program, "vertex_color") + loc = GL.glGetAttribLocation(program, "vertex_colour") GL.glEnableVertexAttribArray(loc) GL.glVertexAttribPointer(loc, 4, GL.GL_FLOAT, False, stride, offset) @@ -442,19 +444,19 @@ def init_gl_modern(display_size): ) GL.glUniformMatrix4fv(shader_data["constants"]["projection"], 1, False, eye(4)) - # This color is multiplied with the base vertex color in producing + # This colour is multiplied with the base vertex colour in producing # the final output - shader_data["constants"]["color_mul"] = GL.glGetUniformLocation( - program, "color_mul" + shader_data["constants"]["colour_mul"] = GL.glGetUniformLocation( + program, "colour_mul" ) - GL.glUniform4f(shader_data["constants"]["color_mul"], 1, 1, 1, 1) + GL.glUniform4f(shader_data["constants"]["colour_mul"], 1, 1, 1, 1) - # This color is added on to the base vertex color in producing + # This colour is added on to the base vertex colour in producing # the final output - shader_data["constants"]["color_add"] = GL.glGetUniformLocation( - program, "color_add" + shader_data["constants"]["colour_add"] = GL.glGetUniformLocation( + program, "colour_add" ) - GL.glUniform4f(shader_data["constants"]["color_add"], 0, 0, 0, 0) + GL.glUniform4f(shader_data["constants"]["colour_add"], 0, 0, 0, 0) # Set GL drawing data # ------------------- @@ -489,8 +491,8 @@ def draw_cube_modern(shader_data, filled_cube_indices, outline_cube_indices, rot GL.glDisable(GL.GL_BLEND) GL.glEnable(GL.GL_DEPTH_TEST) GL.glEnable(GL.GL_POLYGON_OFFSET_FILL) - GL.glUniform4f(shader_data["constants"]["color_mul"], 1, 1, 1, 1) - GL.glUniform4f(shader_data["constants"]["color_add"], 0, 0, 0, 0.0) + GL.glUniform4f(shader_data["constants"]["colour_mul"], 1, 1, 1, 1) + GL.glUniform4f(shader_data["constants"]["colour_add"], 0, 0, 0, 0.0) GL.glBindBuffer(GL.GL_ELEMENT_ARRAY_BUFFER, shader_data["buffer"]["filled"]) GL.glDrawElements( GL.GL_TRIANGLES, len(filled_cube_indices), GL.GL_UNSIGNED_INT, None @@ -499,14 +501,14 @@ def draw_cube_modern(shader_data, filled_cube_indices, outline_cube_indices, rot # Outlined cube GL.glDisable(GL.GL_POLYGON_OFFSET_FILL) GL.glEnable(GL.GL_BLEND) - GL.glUniform4f(shader_data["constants"]["color_mul"], 0, 0, 0, 0.0) - GL.glUniform4f(shader_data["constants"]["color_add"], 1, 1, 1, 1.0) + GL.glUniform4f(shader_data["constants"]["colour_mul"], 0, 0, 0, 0.0) + GL.glUniform4f(shader_data["constants"]["colour_add"], 1, 1, 1, 1.0) GL.glBindBuffer(GL.GL_ELEMENT_ARRAY_BUFFER, shader_data["buffer"]["outline"]) GL.glDrawElements(GL.GL_LINES, len(outline_cube_indices), GL.GL_UNSIGNED_INT, None) # Rotate cube # rotation.theta += 1.0 # degrees - # rotation.phi += 1.0 # degrees + rotation.phi += 1.0 # degrees # rotation.psi += 1.0 # degrees model = eye(4, dtype=float32) # rotate(model, rotation.theta, 0, 0, 1) @@ -518,10 +520,8 @@ def draw_cube_modern(shader_data, filled_cube_indices, outline_cube_indices, rot def main(): """run the demo""" - # initialize pygame-ce and setup an opengl display - - pygame.init() - clock = pygame.time.Clock() + # initialize pygame and setup an opengl display + pg.init() gl_version = (3, 0) # GL Version number (Major, Minor) if USE_MODERN_GL: @@ -529,22 +529,16 @@ def main(): # By setting these attributes we can choose which Open GL Profile # to use, profiles greater than 3.2 use a different rendering path - pygame.display.gl_set_attribute(pygame.GL_CONTEXT_MAJOR_VERSION, gl_version[0]) - pygame.display.gl_set_attribute(pygame.GL_CONTEXT_MINOR_VERSION, gl_version[1]) - pygame.display.gl_set_attribute( - pygame.GL_CONTEXT_PROFILE_MASK, pygame.GL_CONTEXT_PROFILE_CORE + pg.display.gl_set_attribute(pg.GL_CONTEXT_MAJOR_VERSION, gl_version[0]) + pg.display.gl_set_attribute(pg.GL_CONTEXT_MINOR_VERSION, gl_version[1]) + pg.display.gl_set_attribute( + pg.GL_CONTEXT_PROFILE_MASK, pg.GL_CONTEXT_PROFILE_CORE ) - # start in windowed mode + fullscreen = False # start in windowed mode + display_size = (640, 480) - try: - pygame.display.set_mode( - display_size, pygame.OPENGL | pygame.DOUBLEBUF | pygame.RESIZABLE, vsync=1 - ) - except: - pygame.display.set_mode( - display_size, pygame.OPENGL | pygame.DOUBLEBUF | pygame.RESIZABLE - ) + pg.display.set_mode(display_size, pg.OPENGL | pg.DOUBLEBUF | pg.RESIZABLE) if USE_MODERN_GL: gpu, f_indices, o_indices = init_gl_modern(display_size) @@ -552,55 +546,45 @@ def main(): else: init_gl_stuff_old() - delta_time = 0 going = True while going: # check for quit'n events - events = pygame.event.get() + events = pg.event.get() for event in events: - if event.type == pygame.QUIT or ( - event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE + if event.type == pg.QUIT or ( + event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE ): going = False - elif event.type == pygame.KEYDOWN and event.key == pygame.K_f: - if not pygame.display.is_fullscreen(): + elif event.type == pg.KEYDOWN and event.key == pg.K_f: + if not fullscreen: print("Changing to FULLSCREEN") - pygame.display.set_mode( - display_size, - pygame.OPENGL | pygame.DOUBLEBUF | pygame.FULLSCREEN, + pg.display.set_mode( + (640, 480), pg.OPENGL | pg.DOUBLEBUF | pg.FULLSCREEN ) else: print("Changing to windowed mode") - pygame.display.set_mode( - display_size, pygame.OPENGL | pygame.DOUBLEBUF - ) - + pg.display.set_mode((640, 480), pg.OPENGL | pg.DOUBLEBUF) + fullscreen = not fullscreen if gl_version[0] >= 4 or (gl_version[0] == 3 and gl_version[1] >= 2): gpu, f_indices, o_indices = init_gl_modern(display_size) rotation = Rotation() else: init_gl_stuff_old() - # orbit camera around by 60 degrees per second - angle = (delta_time / 1000) * 60 if USE_MODERN_GL: - rotation.phi += angle draw_cube_modern(gpu, f_indices, o_indices, rotation) else: # clear screen and move camera GL.glClear(GL.GL_COLOR_BUFFER_BIT | GL.GL_DEPTH_BUFFER_BIT) - # rotate camera to angle - GL.glRotatef(angle, 0, 1, 0) + # orbit camera around by 1 degree + GL.glRotatef(1, 0, 1, 0) drawcube_old() - pygame.display.flip() - if pygame.display.is_vsync(): - delta_time = clock.tick() - else: - delta_time = clock.tick(60) + pg.display.flip() + pg.time.wait(10) - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/go_over_there.py b/.venv/lib/python3.14/site-packages/pygame/examples/go_over_there.py index 56d1baa..ebf45a8 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/go_over_there.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/go_over_there.py @@ -1,4 +1,4 @@ -"""pygame.examples.go_over_there +""" pg.examples.go_over_there This simple tech demo is showcasing the use of Vector2.move_towards() using multiple circles to represent Vectors. Each circle will have a random position and speed once the demo starts. @@ -10,16 +10,19 @@ Keyboard Controls: * Press R to restart the demo """ +import pygame as pg import random -import pygame - MIN_SPEED = 0.25 MAX_SPEED = 5 MAX_BALLS = 1600 -SCREEN_SIZE = pygame.Vector2(1000, 600) +SCREEN_SIZE = pg.Vector2(1000, 600) CIRCLE_RADIUS = 5 +pg.init() +screen = pg.display.set_mode(SCREEN_SIZE) +clock = pg.time.Clock() + target_position = None balls = [] @@ -37,7 +40,7 @@ def reset(): target_position = None balls = [] for x in range(MAX_BALLS): - pos = pygame.Vector2( + pos = pg.Vector2( random.randint(0, int(SCREEN_SIZE.x)), random.randint(0, int(SCREEN_SIZE.y)) ) speed = random.uniform(MIN_SPEED, MAX_SPEED) @@ -46,47 +49,41 @@ def reset(): balls.append(b) -def main(): - global target_position - global balls +reset() +delta_time = 0 +running = True +while running: + for event in pg.event.get(): + if event.type == pg.QUIT: + running = False - pygame.init() - screen = pygame.display.set_mode(SCREEN_SIZE) - clock = pygame.Clock() + if event.type == pg.MOUSEBUTTONUP: + target_position = pg.mouse.get_pos() - reset() - delta_time = 0 - running = True - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: + if event.type == pg.KEYUP: + if event.key == pg.K_ESCAPE: running = False - if event.type == pygame.MOUSEBUTTONUP: - target_position = pygame.mouse.get_pos() + if event.key == pg.K_r: + reset() - if event.type == pygame.KEYUP: - if event.key == pygame.K_ESCAPE: - running = False + screen.fill((31, 143, 65)) - if event.key == pygame.K_r: - reset() - - screen.fill((31, 143, 65)) - - for o in balls: - if target_position is not None: + for o in balls: + if target_position is not None: + try: o.position.move_towards_ip(target_position, o.speed * delta_time) - pygame.draw.circle(screen, (118, 207, 145), o.position, CIRCLE_RADIUS) + except AttributeError: + raise RuntimeError( + f"""Version {pg.__version__} doesn't have Vector.move_towards_ip function. + Please update to >=2.1.3""" + ) + pg.draw.circle(screen, (118, 207, 145), o.position, CIRCLE_RADIUS) - pygame.display.flip() - delta_time = clock.tick(60) - pygame.display.set_caption( - f"fps: {round(clock.get_fps(), 2)}, ball count: {len(balls)}" - ) + pg.display.flip() + delta_time = clock.tick(60) + pg.display.set_caption( + f"fps: {round(clock.get_fps(), 2)}, ball count: {len(balls)}" + ) - pygame.quit() - - -if __name__ == "__main__": - main() +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/headless_no_windows_needed.py b/.venv/lib/python3.14/site-packages/pygame/examples/headless_no_windows_needed.py index f55ac26..1b5a943 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/headless_no_windows_needed.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/headless_no_windows_needed.py @@ -1,13 +1,12 @@ #!/usr/bin/env python -"""pygame.examples.headless_no_windows_needed +""" pygame.examples.headless_no_windows_needed -How to use pygame-ce with no windowing system, like on headless servers. +How to use pygame with no windowing system, like on headless servers. Thumbnail generation with scaling is an example of what you can do with pygame. NOTE: the pygame scale function uses mmx/sse if available, and can be run in multiple threads. """ - usage = """-scale inputimage outputimage new_width new_height eg. -scale in.png out.png 50 50 @@ -16,22 +15,25 @@ eg. -scale in.png out.png 50 50 import os import sys -import pygame - -# set SDL to use the NULL video driver, +# set SDL to use the dummy NULL video driver, # so it doesn't need a windowing system. -os.environ["SDL_VIDEODRIVER"] = pygame.NULL_VIDEODRIVER +os.environ["SDL_VIDEODRIVER"] = "dummy" +import pygame as pg -# Some platforms need to init the display for some parts of pygame. -pygame.display.init() -screen = pygame.display.set_mode((1, 1)) +# Some platforms need to init the display for some parts of pg. +pg.display.init() +screen = pg.display.set_mode((1, 1)) def scaleit(fin, fout, w, h): - i = pygame.image.load(fin) - scaled_image = pygame.transform.smoothscale(i, (w, h)) - pygame.image.save(scaled_image, fout) + i = pg.image.load(fin) + + if hasattr(pg.transform, "smoothscale"): + scaled_image = pg.transform.smoothscale(i, (w, h)) + else: + scaled_image = pg.transform.scale(i, (w, h)) + pg.image.save(scaled_image, fout) def main(fin, fout, w, h): diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/joystick.py b/.venv/lib/python3.14/site-packages/pygame/examples/joystick.py index f9781ec..3635195 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/joystick.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/joystick.py @@ -3,24 +3,43 @@ import pygame pygame.init() -def indent(text, indentation_level=0): - return (" " * indentation_level) + text +# This is a simple class that will help us print to the screen. +# It has nothing to do with the joysticks, just outputting the +# information. +class TextPrint: + def __init__(self): + self.reset() + self.font = pygame.font.Font(None, 25) + + def tprint(self, screen, text): + text_bitmap = self.font.render(text, True, (0, 0, 0)) + screen.blit(text_bitmap, (self.x, self.y)) + self.y += self.line_height + + def reset(self): + self.x = 10 + self.y = 10 + self.line_height = 15 + + def indent(self): + self.x += 10 + + def unindent(self): + self.x -= 10 def main(): - # Set the size of the screen (width, height), and name the window. - size = (500, 700) - screen = pygame.display.set_mode(size) + # Set the width and height of the screen (width, height), and name the window. + screen = pygame.display.set_mode((500, 700)) pygame.display.set_caption("Joystick example") # Used to manage how fast the screen updates. - clock = pygame.Clock() + clock = pygame.time.Clock() # Get ready to print. - font = pygame.font.SysFont(None, 25) - wraplength = size[0] - 20 + text_print = TextPrint() - # This dict can be left as-is, since pygame-ce will generate a + # This dict can be left as-is, since pygame will generate a # pygame.JOYDEVICEADDED event for every joystick connected # at the start of the program. joysticks = {} @@ -50,82 +69,73 @@ def main(): # joystick, filling up the list without needing to create them manually. joy = pygame.joystick.Joystick(event.device_index) joysticks[joy.get_instance_id()] = joy - print(f"Joystick {joy.get_instance_id()} connected") + print(f"Joystick {joy.get_instance_id()} connencted") if event.type == pygame.JOYDEVICEREMOVED: - if event.instance_id in joysticks: - del joysticks[event.instance_id] - print(f"Joystick {event.instance_id} disconnected") - else: - print( - f"Tried to disconnect Joystick {event.instance_id}, " - "but couldn't find it in the joystick list" - ) + del joysticks[event.instance_id] + print(f"Joystick {event.instance_id} disconnected") # Drawing step # First, clear the screen to white. Don't put other drawing commands # above this, or they will be erased with this command. screen.fill((255, 255, 255)) - indentation = 0 - lines = [] + text_print.reset() # Get count of joysticks. joystick_count = pygame.joystick.get_count() - lines.append(indent(f"Number of joysticks: {joystick_count}", indentation)) - indentation += 1 + + text_print.tprint(screen, f"Number of joysticks: {joystick_count}") + text_print.indent() # For each joystick: for joystick in joysticks.values(): jid = joystick.get_instance_id() - lines.append(indent(f"Joystick {jid}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Joystick {jid}") + text_print.indent() # Get the name from the OS for the controller/joystick. name = joystick.get_name() - lines.append(indent(f"Joystick name: {name}", indentation)) + text_print.tprint(screen, f"Joystick name: {name}") guid = joystick.get_guid() - lines.append(indent(f"GUID: {guid}", indentation)) + text_print.tprint(screen, f"GUID: {guid}") power_level = joystick.get_power_level() - lines.append(indent(f"Joystick's power level: {power_level}", indentation)) + text_print.tprint(screen, f"Joystick's power level: {power_level}") # Usually axis run in pairs, up/down for one, and left/right for # the other. Triggers count as axes. axes = joystick.get_numaxes() - lines.append(indent(f"Number of axes: {axes}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Number of axes: {axes}") + text_print.indent() for i in range(axes): axis = joystick.get_axis(i) - lines.append(indent(f"Axis {i} value: {axis:>6.3f}", indentation)) - indentation -= 1 + text_print.tprint(screen, f"Axis {i} value: {axis:>6.3f}") + text_print.unindent() buttons = joystick.get_numbuttons() - lines.append(indent(f"Number of buttons: {buttons}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Number of buttons: {buttons}") + text_print.indent() for i in range(buttons): button = joystick.get_button(i) - lines.append(indent(f"Button {i:>2} value: {button}", indentation)) - indentation -= 1 + text_print.tprint(screen, f"Button {i:>2} value: {button}") + text_print.unindent() hats = joystick.get_numhats() - lines.append(indent(f"Number of hats: {hats}", indentation)) - indentation += 1 + text_print.tprint(screen, f"Number of hats: {hats}") + text_print.indent() # Hat position. All or nothing for direction, not a float like # get_axis(). Position is a tuple of int values (x, y). for i in range(hats): hat = joystick.get_hat(i) - lines.append(indent(f"Hat {i} value: {str(hat)}", indentation)) - indentation -= 2 + text_print.tprint(screen, f"Hat {i} value: {str(hat)}") + text_print.unindent() - # draw the accumulated text - screen.blit( - font.render("\n".join(lines), True, "black", "white", wraplength), (10, 10) - ) + text_print.unindent() # Go ahead and update the screen with what we've drawn. pygame.display.flip() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/liquid.py b/.venv/lib/python3.14/site-packages/pygame/examples/liquid.py index 793dbed..22431ba 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/liquid.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/liquid.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.liquid +""" pygame.examples.liquid This example demonstrates a simplish water effect of an image. It attempts to create a hardware display surface that @@ -13,24 +13,24 @@ pygame to compare the results. I didn't bother porting the text and sound stuff, that's an easy enough challenge for the reader :] """ +import pygame as pg import os from math import sin - -import pygame +import time main_dir = os.path.split(os.path.abspath(__file__))[0] def main(): # initialize and setup screen - pygame.init() - screen = pygame.display.set_mode((640, 480), pygame.DOUBLEBUF) + pg.init() + screen = pg.display.set_mode((640, 480), pg.HWSURFACE | pg.DOUBLEBUF) # load image and quadruple - imagename = os.path.join(main_dir, "data", "liquid.webp") - bitmap = pygame.image.load(imagename) - bitmap = pygame.transform.scale2x(bitmap) - bitmap = pygame.transform.scale2x(bitmap) + imagename = os.path.join(main_dir, "data", "liquid.bmp") + bitmap = pg.image.load(imagename) + bitmap = pg.transform.scale2x(bitmap) + bitmap = pg.transform.scale2x(bitmap) # get the image and screen in the same format if screen.get_bitsize() == 8: @@ -44,15 +44,10 @@ def main(): # mainloop xblocks = range(0, 640, 20) yblocks = range(0, 480, 20) - stop_events = pygame.QUIT, pygame.KEYDOWN, pygame.MOUSEBUTTONDOWN - - clock = pygame.Clock() - + stopevents = pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN while True: - clock.tick(60) - - for event in pygame.event.get(): - if event.type in stop_events: + for e in pg.event.get(): + if e.type in stopevents: return anim = anim + 0.02 @@ -62,12 +57,13 @@ def main(): ypos = (y + (sin(anim + y * 0.01) * 15)) + 20 screen.blit(bitmap, (x, y), (xpos, ypos, 20, 20)) - pygame.display.flip() + pg.display.flip() + time.sleep(0.01) if __name__ == "__main__": main() - pygame.quit() + pg.quit() """BTW, here is the code from the BlitzBasic example this was derived diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/mask.py b/.venv/lib/python3.14/site-packages/pygame/examples/mask.py index 95efb3d..c0ec097 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/mask.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/mask.py @@ -41,12 +41,12 @@ import os import random import sys -import pygame +import pygame as pg class Sprite: """ - Moving Sprite demonstrating pixel-perfect collisions between pygame.mask.Mask objects + Moving Sprite demonstrating pixel-perfect collisions between pg.mask.Mask objects """ def __init__(self, pos, vel, surface, mask=None): @@ -54,18 +54,18 @@ class Sprite: Positional arguments: pos: Position of the sprite (sequence of 2 integers) vel: Movement velocity of the sprite (sequence of 2 integers) - surface: Image (as a pygame.Surface) of the sprite - mask: pygame.mask.Mask object (optional) + surface: Image (as a pg.Surface) of the sprite + mask: pg.mask.Mask object (optional) """ self.surface = surface self.width, self.height = self.surface.get_size() if mask is not None: self.mask = mask else: - self.mask = pygame.mask.from_surface(self.surface) + self.mask = pg.mask.from_surface(self.surface) - self.pos = pygame.Vector2(pos) - self.vel = pygame.Vector2(vel) + self.pos = pg.Vector2(pos) + self.vel = pg.Vector2(vel) def collide(self, sprite): """ @@ -82,7 +82,7 @@ class Sprite: # Calculate collision normal # Number of collisions - n_collisions = pygame.Vector2( + n_collisions = pg.Vector2( # x axis self.mask.overlap_area(sprite.mask, (offset[0] + 1, offset[1])) - self.mask.overlap_area(sprite.mask, (offset[0] - 1, offset[1])), @@ -122,23 +122,23 @@ def main(*args): Positional arguments: one or more image file names. - This pygame.masks demo will display multiple moving sprites bouncing + This pg.masks demo will display multiple moving sprites bouncing off each other. More than one sprite image can be provided. """ if len(args) == 0: raise ValueError("Require at least one image file name: non given") - pygame.init() + pg.init() screen_size = (640, 480) - screen = pygame.display.set_mode(screen_size) - clock = pygame.Clock() + screen = pg.display.set_mode(screen_size) + clock = pg.time.Clock() images = [] masks = [] for image_path in args: - images.append(pygame.image.load(image_path).convert_alpha()) - masks.append(pygame.mask.from_surface(images[-1])) + images.append(pg.image.load(image_path).convert_alpha()) + masks.append(pg.mask.from_surface(images[-1])) sprites = [] for i in range(20): @@ -158,8 +158,8 @@ def main(*args): sprites.append(sprite) while True: - for event in pygame.event.get(): - if event.type in (pygame.QUIT, pygame.KEYDOWN): + for event in pg.event.get(): + if event.type in (pg.QUIT, pg.KEYDOWN): return screen.fill((240, 220, 100)) @@ -186,7 +186,7 @@ def main(*args): screen.blit(sprite.surface, sprite.pos) clock.tick(30) - pygame.display.flip() + pg.display.flip() if __name__ == "__main__": @@ -199,4 +199,4 @@ if __name__ == "__main__": else: main(*sys.argv[1:]) - pygame.quit() + pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/midi.py b/.venv/lib/python3.14/site-packages/pygame/examples/midi.py index 988bf56..f087ae6 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/midi.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/midi.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.midi +""" pygame.examples.midi midi input, and a separate example of midi output. @@ -10,10 +10,12 @@ python -m pygame.examples.midi --input python -m pygame.examples.midi --input """ -import os +from dataclasses import dataclass import sys +import os +from typing import Any, Dict, List, Literal, Optional, Set, Tuple, Union -import pygame +import pygame as pg import pygame.midi # black and white piano keys use b/w color values directly @@ -44,7 +46,7 @@ def _print_device_info(): def input_main(device_id=None): - pygame.init() + pg.init() pygame.midi.init() @@ -58,15 +60,15 @@ def input_main(device_id=None): print(f"using input_id :{input_id}:") i = pygame.midi.Input(input_id) - pygame.display.set_mode((1, 1)) + pg.display.set_mode((1, 1)) going = True while going: events = pygame.event.get() for e in events: - if e.type in [pygame.QUIT]: + if e.type in [pg.QUIT]: going = False - if e.type in [pygame.KEYDOWN]: + if e.type in [pg.KEYDOWN]: going = False if e.type in [pygame.midi.MIDIIN]: print(e) @@ -135,35 +137,35 @@ def output_main(device_id=None): key_mapping = make_key_mapping( [ - pygame.K_TAB, - pygame.K_1, - pygame.K_q, - pygame.K_2, - pygame.K_w, - pygame.K_3, - pygame.K_e, - pygame.K_r, - pygame.K_5, - pygame.K_t, - pygame.K_6, - pygame.K_y, - pygame.K_u, - pygame.K_8, - pygame.K_i, - pygame.K_9, - pygame.K_o, - pygame.K_0, - pygame.K_p, - pygame.K_LEFTBRACKET, - pygame.K_EQUALS, - pygame.K_RIGHTBRACKET, - pygame.K_BACKSPACE, - pygame.K_BACKSLASH, + pg.K_TAB, + pg.K_1, + pg.K_q, + pg.K_2, + pg.K_w, + pg.K_3, + pg.K_e, + pg.K_r, + pg.K_5, + pg.K_t, + pg.K_6, + pg.K_y, + pg.K_u, + pg.K_8, + pg.K_i, + pg.K_9, + pg.K_o, + pg.K_0, + pg.K_p, + pg.K_LEFTBRACKET, + pg.K_EQUALS, + pg.K_RIGHTBRACKET, + pg.K_BACKSPACE, + pg.K_BACKSLASH, ], start_note, ) - pygame.init() + pg.init() pygame.midi.init() _print_device_info() @@ -180,25 +182,25 @@ def output_main(device_id=None): midi_out.set_instrument(instrument) keyboard = Keyboard(start_note, n_notes) - screen = pygame.display.set_mode(keyboard.rect.size) + screen = pg.display.set_mode(keyboard.rect.size) screen.fill(BACKGROUNDCOLOR) - pygame.display.flip() + pg.display.flip() - background = pygame.Surface(screen.get_size()) + background = pg.Surface(screen.get_size()) background.fill(BACKGROUNDCOLOR) dirty_rects = [] keyboard.draw(screen, background, dirty_rects) - pygame.display.update(dirty_rects) + pg.display.update(dirty_rects) - regions = pygame.Surface(screen.get_size()) # initial color (0,0,0) + regions = pg.Surface(screen.get_size()) # initial color (0,0,0) keyboard.map_regions(regions) - pygame.event.set_blocked(pygame.MOUSEMOTION) + pg.event.set_blocked(pg.MOUSEMOTION) mouse_note = 0 on_notes = set() while True: - e = pygame.event.wait() - if e.type == pygame.MOUSEBUTTONDOWN: + e = pg.event.wait() + if e.type == pg.MOUSEBUTTONDOWN: mouse_note, velocity, __, __ = regions.get_at(e.pos) if mouse_note and mouse_note not in on_notes: keyboard.key_down(mouse_note) @@ -206,16 +208,16 @@ def output_main(device_id=None): on_notes.add(mouse_note) else: mouse_note = 0 - elif e.type == pygame.MOUSEBUTTONUP: + elif e.type == pg.MOUSEBUTTONUP: if mouse_note: midi_out.note_off(mouse_note) keyboard.key_up(mouse_note) on_notes.remove(mouse_note) mouse_note = 0 - elif e.type == pygame.QUIT: + elif e.type == pg.QUIT: break - elif e.type == pygame.KEYDOWN: - if e.key == pygame.K_ESCAPE: + elif e.type == pg.KEYDOWN: + if e.key == pg.K_ESCAPE: break try: note, velocity = key_mapping[e.key] @@ -226,7 +228,7 @@ def output_main(device_id=None): keyboard.key_down(note) midi_out.note_on(note, velocity) on_notes.add(note) - elif e.type == pygame.KEYUP: + elif e.type == pg.KEYUP: try: note, __ = key_mapping[e.key] except KeyError: @@ -239,7 +241,7 @@ def output_main(device_id=None): dirty_rects = [] keyboard.draw(screen, background, dirty_rects) - pygame.display.update(dirty_rects) + pg.display.update(dirty_rects) finally: del midi_out pygame.midi.quit() @@ -254,7 +256,7 @@ def make_key_mapping(keys, start_note): class NullKey: - """A null key that ignores events passed to it by other keys + """A dummy key that ignores events passed to it by other keys A NullKey instance is the left key instance used by default for the left most keyboard key. @@ -277,7 +279,169 @@ class NullKey: null_key = NullKey() -def key_class(updates, image_strip, image_rects, is_white_key=True): +@dataclass +class KeyData: + """Used for passing in data to subclasses of the Key class.""" + + is_white_key: bool + c_width: int + c_height: int + c_down_state_initial: int + c_down_state_rect_initial: pg.Rect + c_notify_down_method: str + c_notify_up_method: str + c_updates: Set[Any] + c_event_down: Dict[int, Tuple[int, pg.Rect]] + c_event_up: Dict[int, Tuple[int, pg.Rect]] + c_image_strip: pg.Surface + c_event_right_white_down: Dict[int, Tuple[int, Union[pg.Rect, None]]] + c_event_right_white_up: Dict[int, Tuple[int, Union[pg.Rect, None]]] + c_event_right_black_down: Dict[int, Tuple[int, Union[pg.Rect, None]]] + c_event_right_black_up: Dict[int, Tuple[int, Union[pg.Rect, None]]] + + +class Key: + """A key widget, maintains key state and draws the key's image + + Constructor arguments: + ident - A unique key identifier. Any immutable type suitable as a key. + posn - The location of the key on the display surface. + key_left - Optional, the adjacent white key to the left. Changes in + up and down state are propagated to that key. + + A key has an associated position and state. Related to state is the + image drawn. State changes are managed with method calls, one method + per event type. The up and down event methods are public. Other + internal methods are for passing on state changes to the key_left + key instance. + + """ + + key_data: KeyData + + def __init__(self, ident, posn, key_left=None): + """Return a new Key instance + + The initial state is up, with all adjacent keys to the right also + up. + + """ + if key_left is None: + key_left = null_key + rect = pg.Rect(posn[0], posn[1], self.key_data.c_width, self.key_data.c_height) + self.rect = rect + self._state = self.key_data.c_down_state_initial + self._source_rect = self.key_data.c_down_state_rect_initial + self._ident = ident + self._hash = hash(ident) + self._notify_down = getattr(key_left, self.key_data.c_notify_down_method) + self._notify_up = getattr(key_left, self.key_data.c_notify_up_method) + self._key_left = key_left + self._background_rect = pg.Rect( + rect.left, rect.bottom - 10, self.key_data.c_width, 10 + ) + self.key_data.c_updates.add(self) + self.is_white = self.key_data.is_white_key + + def down(self): + """Signal that this key has been depressed (is down)""" + + self._state, source_rect = self.key_data.c_event_down[self._state] + if source_rect is not None: + self._source_rect = source_rect + self.key_data.c_updates.add(self) + self._notify_down() + + def up(self): + """Signal that this key has been released (is up)""" + + self._state, source_rect = self.key_data.c_event_up[self._state] + if source_rect is not None: + self._source_rect = source_rect + self.key_data.c_updates.add(self) + self._notify_up() + + def _right_white_down(self): + """Signal that the adjacent white key has been depressed + + This method is for internal propagation of events between + key instances. + + """ + + self._state, source_rect = self.key_data.c_event_right_white_down[self._state] + if source_rect is not None: + self._source_rect = source_rect + self.key_data.c_updates.add(self) + + def _right_white_up(self): + """Signal that the adjacent white key has been released + + This method is for internal propagation of events between + key instances. + + """ + + self._state, source_rect = self.key_data.c_event_right_white_up[self._state] + if source_rect is not None: + self._source_rect = source_rect + self.key_data.c_updates.add(self) + + def _right_black_down(self): + """Signal that the adjacent black key has been depressed + + This method is for internal propagation of events between + key instances. + + """ + + self._state, source_rect = self.key_data.c_event_right_black_down[self._state] + if source_rect is not None: + self._source_rect = source_rect + self.key_data.c_updates.add(self) + + def _right_black_up(self): + """Signal that the adjacent black key has been released + + This method is for internal propagation of events between + key instances. + + """ + + self._state, source_rect = self.key_data.c_event_right_black_up[self._state] + if source_rect is not None: + self._source_rect = source_rect + self.key_data.c_updates.add(self) + + def __eq__(self, other): + """True if same identifiers""" + + return self._ident == other._ident + + def __hash__(self): + """Return the immutable hash value""" + + return self._hash + + def __str__(self): + """Return the key's identifier and position as a string""" + + return "" % (self._ident, self.rect.top, self.rect.left) + + def draw(self, surf, background, dirty_rects): + """Redraw the key on the surface surf + + The background is redrawn. The altered region is added to the + dirty_rects list. + + """ + + surf.blit(background, self._background_rect, self._background_rect) + surf.blit(self.key_data.c_image_strip, self.rect, self._source_rect) + dirty_rects.append(self.rect) + + +def key_class(updates, image_strip, image_rects: List[pg.Rect], is_white_key=True): """Return a keyboard key widget class Arguments: @@ -362,9 +526,13 @@ def key_class(updates, image_strip, image_rects, is_white_key=True): # along with corresponding image, for the related event. If no redrawing # is required for the state change then the image rect is simply None. # - c_event_down = {down_state_none: (down_state_self, image_rects[1])} - c_event_up = {down_state_self: (down_state_none, image_rects[0])} - c_event_right_white_down = { + c_event_down: Dict[int, Tuple[int, pygame.Rect]] = { + down_state_none: (down_state_self, image_rects[1]) + } + c_event_up: Dict[int, Tuple[int, pygame.Rect]] = { + down_state_self: (down_state_none, image_rects[0]) + } + c_event_right_white_down: Dict[int, Tuple[int, Union[pygame.Rect, None]]] = { down_state_none: (down_state_none, None), down_state_self: (down_state_self, None), } @@ -424,153 +592,32 @@ def key_class(updates, image_strip, image_rects, is_white_key=True): ) c_event_right_black_up[down_state_all] = (down_state_self_white, image_rects[2]) - class Key: - """A key widget, maintains key state and draws the key's image + class OurKey(Key): + key_data = KeyData( + is_white_key, + c_width, + c_height, + c_down_state_initial, + c_down_state_rect_initial, + c_notify_down_method, + c_notify_up_method, + c_updates, + c_event_down, + c_event_up, + c_image_strip, + c_event_right_white_down, + c_event_right_white_up, + c_event_right_black_down, + c_event_right_black_up, + ) - Constructor arguments: - ident - A unique key identifier. Any immutable type suitable as a key. - posn - The location of the key on the display surface. - key_left - Optional, the adjacent white key to the left. Changes in - up and down state are propagated to that key. - - A key has an associated position and state. Related to state is the - image drawn. State changes are managed with method calls, one method - per event type. The up and down event methods are public. Other - internal methods are for passing on state changes to the key_left - key instance. - - """ - - is_white = is_white_key - - def __init__(self, ident, posn, key_left=None): - """Return a new Key instance - - The initial state is up, with all adjacent keys to the right also - up. - - """ - if key_left is None: - key_left = null_key - rect = pygame.Rect(posn[0], posn[1], c_width, c_height) - self.rect = rect - self._state = c_down_state_initial - self._source_rect = c_down_state_rect_initial - self._ident = ident - self._hash = hash(ident) - self._notify_down = getattr(key_left, c_notify_down_method) - self._notify_up = getattr(key_left, c_notify_up_method) - self._key_left = key_left - self._background_rect = pygame.Rect( - rect.left, rect.bottom - 10, c_width, 10 - ) - c_updates.add(self) - - def down(self): - """Signal that this key has been depressed (is down)""" - - self._state, source_rect = c_event_down[self._state] - if source_rect is not None: - self._source_rect = source_rect - c_updates.add(self) - self._notify_down() - - def up(self): - """Signal that this key has been released (is up)""" - - self._state, source_rect = c_event_up[self._state] - if source_rect is not None: - self._source_rect = source_rect - c_updates.add(self) - self._notify_up() - - def _right_white_down(self): - """Signal that the adjacent white key has been depressed - - This method is for internal propagation of events between - key instances. - - """ - - self._state, source_rect = c_event_right_white_down[self._state] - if source_rect is not None: - self._source_rect = source_rect - c_updates.add(self) - - def _right_white_up(self): - """Signal that the adjacent white key has been released - - This method is for internal propagation of events between - key instances. - - """ - - self._state, source_rect = c_event_right_white_up[self._state] - if source_rect is not None: - self._source_rect = source_rect - c_updates.add(self) - - def _right_black_down(self): - """Signal that the adjacent black key has been depressed - - This method is for internal propagation of events between - key instances. - - """ - - self._state, source_rect = c_event_right_black_down[self._state] - if source_rect is not None: - self._source_rect = source_rect - c_updates.add(self) - - def _right_black_up(self): - """Signal that the adjacent black key has been released - - This method is for internal propagation of events between - key instances. - - """ - - self._state, source_rect = c_event_right_black_up[self._state] - if source_rect is not None: - self._source_rect = source_rect - c_updates.add(self) - - def __eq__(self, other): - """True if same identifiers""" - - return self._ident == other._ident - - def __hash__(self): - """Return the immutable hash value""" - - return self._hash - - def __str__(self): - """Return the key's identifier and position as a string""" - - return "" % (self._ident, self.rect.top, self.rect.left) - - def draw(self, surf, background, dirty_rects): - """Redraw the key on the surface surf - - The background is redrawn. The altered region is added to the - dirty_rects list. - - """ - - surf.blit(background, self._background_rect, self._background_rect) - surf.blit(c_image_strip, self.rect, self._source_rect) - dirty_rects.append(self.rect) - - return Key + return OurKey -def key_images(): +def key_images() -> Tuple[pg.Surface, Dict[str, pg.Rect]]: """Return a keyboard keys image strip and a mapping of image locations - The return tuple is a surface and a dictionary of rects mapped to key - type. + The return tuple is a pygame.Surface and a dictionary keyed by key name and valued by a pygame.Rect. This function encapsulates the constants relevant to the keyboard image file. There are five key types. One is the black key. The other four @@ -583,12 +630,12 @@ def key_images(): """ my_dir = os.path.split(os.path.abspath(__file__))[0] - strip_file = os.path.join(my_dir, "data", "midikeys.webp") + strip_file = os.path.join(my_dir, "data", "midikeys.png") white_key_width = 42 white_key_height = 160 black_key_width = 22 black_key_height = 94 - strip = pygame.image.load(strip_file) + strip = pg.image.load(strip_file) names = [ "black none", "black self", @@ -613,11 +660,11 @@ def key_images(): ] rects = {} for i in range(2): - rects[names[i]] = pygame.Rect( + rects[names[i]] = pg.Rect( i * white_key_width, 0, black_key_width, black_key_height ) for i in range(2, len(names)): - rects[names[i]] = pygame.Rect( + rects[names[i]] = pg.Rect( i * white_key_width, 0, white_key_width, white_key_height ) return strip, rects @@ -641,7 +688,7 @@ class Keyboard: white_key_width, white_key_height = _rects["white none"].size black_key_width, black_key_height = _rects["black none"].size - _updates = set() + _updates: Set[Any] = set() # There are five key classes, representing key shape: # black key (BlackKey), plain white key (WhiteKey), white key to the left @@ -690,14 +737,14 @@ class Keyboard: ], ) - def __init__(self, start_note, n_notes): + def __init__(self, start_note: int, n_notes: int): """Return a new Keyboard instance with n_note keys""" self._start_note = start_note self._end_note = start_note + n_notes - 1 self._add_keys() - def _add_keys(self): + def _add_keys(self) -> None: """Populate the keyboard with key instances Set the _keys and rect attributes. @@ -709,7 +756,7 @@ class Keyboard: # note positions should never be accessed, so are set None to ensure # the bug is quickly detected. # - key_map = [None] * 128 + key_map: list[Key | Literal[None]] = [None] * 128 start_note = self._start_note end_note = self._end_note @@ -743,9 +790,13 @@ class Keyboard: key_map[note] = key self._keys = key_map - kb_width = key_map[self._end_note].rect.right + the_key = key_map[self._end_note] + if the_key is None: + kb_width = 0 + else: + kb_width = the_key.rect.right kb_height = self.white_key_height - self.rect = pygame.Rect(0, 0, kb_width, kb_height) + self.rect = pg.Rect(0, 0, kb_width, kb_height) def map_regions(self, regions): """Draw the key regions onto surface regions. @@ -763,12 +814,13 @@ class Keyboard: black_keys = [] for note in range(self._start_note, self._end_note + 1): key = self._keys[note] - if key.is_white: + if key is not None and key.is_white: fill_region(regions, note, key.rect, cutoff) else: black_keys.append((note, key)) for note, key in black_keys: - fill_region(regions, note, key.rect, cutoff) + if key is not None: + fill_region(regions, note, key.rect, cutoff) def draw(self, surf, background, dirty_rects): """Redraw all altered keyboard keys""" @@ -779,13 +831,15 @@ class Keyboard: def key_down(self, note): """Signal a key down event for note""" - - self._keys[note].down() + key = self._keys[note] + if key is not None: + key.down() def key_up(self, note): """Signal a key up event for note""" - - self._keys[note].up() + key = self._keys[note] + if key is not None: + key.up() def fill_region(regions, note, rect, cutoff): @@ -859,6 +913,7 @@ def main(mode="output", device_id=None): if __name__ == "__main__": + device_id: Optional[int] = None try: device_id = int(sys.argv[-1]) except ValueError: @@ -874,4 +929,4 @@ if __name__ == "__main__": else: usage() - pygame.quit() + pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/moveit.py b/.venv/lib/python3.14/site-packages/pygame/examples/moveit.py index 3af127d..ffcc7f9 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/moveit.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/moveit.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.moveit +""" pygame.examples.moveit This is the full and final example from the Pygame Tutorial, "How Do I Make It Move". It creates 10 objects and animates @@ -11,10 +11,8 @@ Note it's a bit scant on error checking, but it's easy to read. :] Fortunately, this is python, and we needn't wrestle with a pile of error codes. """ - import os - -import pygame +import pygame as pg main_dir = os.path.split(os.path.abspath(__file__))[0] @@ -58,23 +56,23 @@ class GameObject: # quick function to load an image def load_image(name): path = os.path.join(main_dir, "data", name) - return pygame.image.load(path).convert() + return pg.image.load(path).convert() # here's the full code def main(): - pygame.init() - clock = pygame.Clock() - screen = pygame.display.set_mode((WIDTH, HEIGHT)) + pg.init() + clock = pg.time.Clock() + screen = pg.display.set_mode((WIDTH, HEIGHT)) player = load_image("player1.gif") entity = load_image("alien1.gif") - background = load_image("liquid.webp") + background = load_image("liquid.bmp") # scale the background image so that it fills the window and # successfully overwrites the old sprite position. - background = pygame.transform.scale2x(background) - background = pygame.transform.scale2x(background) + background = pg.transform.scale2x(background) + background = pg.transform.scale2x(background) screen.blit(background, (0, 0)) @@ -84,26 +82,26 @@ def main(): o = GameObject(entity, x * 40, x) objects.append(o) - pygame.display.set_caption("Move It!") + pg.display.set_caption("Move It!") # This is a simple event handler that enables player input. while True: # Get all keys currently pressed, and move when an arrow key is held. - keys = pygame.key.get_pressed() - if keys[pygame.K_UP]: + keys = pg.key.get_pressed() + if keys[pg.K_UP]: p.move(up=True) - if keys[pygame.K_DOWN]: + if keys[pg.K_DOWN]: p.move(down=True) - if keys[pygame.K_LEFT]: + if keys[pg.K_LEFT]: p.move(left=True) - if keys[pygame.K_RIGHT]: + if keys[pg.K_RIGHT]: p.move(right=True) # Draw the background screen.blit(background, (0, 0)) - for e in pygame.event.get(): + for e in pg.event.get(): # quit upon screen exit - if e.type == pygame.QUIT: + if e.type == pg.QUIT: return for o in objects: screen.blit(background, o.pos, o.pos) @@ -111,10 +109,11 @@ def main(): o.move(right=True) screen.blit(o.image, o.pos) screen.blit(p.image, p.pos) - pygame.display.update() clock.tick(60) + pg.display.update() + pg.time.delay(100) if __name__ == "__main__": main() - pygame.quit() + pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/multiplayer_joystick.py b/.venv/lib/python3.14/site-packages/pygame/examples/multiplayer_joystick.py deleted file mode 100644 index 769b4fc..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/examples/multiplayer_joystick.py +++ /dev/null @@ -1,157 +0,0 @@ -import sys - -import pygame - -WIDTH, HEIGHT = 500, 500 - - -def connect_joystick(index, active_players, players, colors): - if len(active_players) < len(players): - joy = pygame.Joystick(index) - index = players.index(None) - # player data - players[index] = { - "joy": joy, - "pos": [WIDTH * 0.25 + index * 64, 128], - "surf_idx": index, - "surf": colors[index], - "joined": False, - } - active_players[joy.get_instance_id()] = index - print(f"P{index + 1} Connected") - - -def disconnect_joystick(instance_id: int, active_players, players): - index = active_players[instance_id] - players[index] = None - del active_players[instance_id] - print(f"P{index + 1} Disconnected") - - -def control_player(player): # move player - joy = player["joy"] - if not player["joined"]: - return - player["pos"][0] += joy.get_axis(0) * 5 - player["pos"][1] += joy.get_axis(1) * 5 - - -def create_surf(size, color): - surf = pygame.Surface(size) - surf.fill(color) - return surf - - -def main(): - pygame.init() - - screen = pygame.display.set_mode((WIDTH, HEIGHT)) - pygame.display.set_caption("Multiplayer Joystick example") - clock = pygame.Clock() - font_b = pygame.font.SysFont(None, 25) - font_a = pygame.font.SysFont(None, 16) - - players = [None, None] # two players limit - active_players = {} - - colors = [ - create_surf((32, 32), (220, 180, 10)), - create_surf((32, 32), (60, 230, 170)), - create_surf((32, 32), (230, 20, 70)), - create_surf((32, 32), (20, 170, 230)), - ] - are_no_controllers_connected = True - - while True: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - pygame.quit() - sys.exit() - elif event.type == pygame.JOYDEVICEADDED: - if len(active_players) < len(players): - # connect controller - connect_joystick( - event.device_index, active_players, players, colors - ) - are_no_controllers_connected = False - elif event.type == pygame.JOYDEVICEREMOVED: - # disconnect controller - if event.instance_id in active_players: - disconnect_joystick(event.instance_id, active_players, players) - # check if there is at least one controller connected - are_no_controllers_connected = True - for player in players: - if player: - are_no_controllers_connected = False - break - elif event.type == pygame.JOYBUTTONDOWN: - if event.instance_id in active_players: - # join player - if event.button == 0: - index = active_players[event.instance_id] - players[index]["joined"] = True - print(f"P{index + 1} joined") - # leave player - if event.button == 1: - index = active_players[event.instance_id] - if players[index]["joined"]: - players[index]["joined"] = False - players[index]["pos"] = [WIDTH * 0.25 + index * 64, 128] - print(f"P{index + 1} leave") - elif event.type == pygame.JOYAXISMOTION: - if event.instance_id in active_players: - # change the color if player still hasn't joined - if event.axis == 0: - index = active_players[event.instance_id] - player = players[index] - if not player["joined"]: - if event.value >= 1.0: - player["surf_idx"] += 1 - elif event.value <= -1.0: - player["surf_idx"] -= 1 - player["surf_idx"] = player["surf_idx"] % len(colors) - player["surf"] = colors[player["surf_idx"]] - - screen.fill((30, 30, 30)) - pygame.draw.line(screen, (230, 230, 230), (0, 96), (WIDTH, 96), 2) - - # update and draw players - for player in players: - if player: - control_player(player) - screen.blit(player["surf"], player["pos"]) - - # draw available colors - for i, surf in enumerate(colors): - screen.blit(surf, (WIDTH * 0.25 + i * 64, 32)) - - # show message for connecting a controller - if are_no_controllers_connected: - screen.blit( - font_b.render( - "Please connect a controller.", - True, - (230, 230, 230), - None, - 500 - 20, - ), - (WIDTH * 0.3, HEIGHT * 0.5), - ) - - screen.blit( - font_a.render( - "A: join B: leave Joystick: move / change color", - True, - (230, 230, 230), - None, - WIDTH - 20, - ), - (10, HEIGHT - 20), - ) - - clock.tick(60) - pygame.display.update() - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/music_drop_fade.py b/.venv/lib/python3.14/site-packages/pygame/examples/music_drop_fade.py index cf48744..8988cd3 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/music_drop_fade.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/music_drop_fade.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.music_drop_fade +""" pygame.examples.music_drop_fade Fade in and play music from a list while observing several events Adds music files to a playlist whenever played by one of the following methods @@ -15,24 +15,11 @@ Keyboard Controls: * Press any other button to skip to the next music file in the list """ -import os -import sys - -import pygame +from typing import List +import pygame as pg +import os, sys VOLUME_CHANGE_AMOUNT = 0.02 # how fast should up and down arrows change the volume? -SCREEN_SIZE = (640, 480) - -MUSIC_DONE = pygame.event.custom_type() # event to be set as mixer.music.set_endevent() -main_dir = os.path.split(os.path.abspath(__file__))[0] -data_dir = os.path.join(main_dir, "data") - -starting_pos = 0 # needed to fast forward and rewind -volume = 0.75 -music_file_list = [] -music_file_types = ("mp3", "ogg", "mid", "mod", "it", "xm", "wav") -music_can_seek = ("mp3", "ogg", "mod", "it", "xm") -screen = None def add_file(filename): @@ -72,15 +59,15 @@ def play_file(filename): if add_file(filename): try: # we must do this in case the file is not a valid audio file - pygame.mixer.music.load(music_file_list[-1]) - except pygame.error as e: + pg.mixer.music.load(music_file_list[-1]) + except pg.error as e: print(e) # print description such as 'Not an Ogg Vorbis audio stream' if filename in music_file_list: music_file_list.remove(filename) print(f"{filename} removed from file list") return - pygame.mixer.music.play(fade_ms=4000) - pygame.mixer.music.set_volume(volume) + pg.mixer.music.play(fade_ms=4000) + pg.mixer.music.set_volume(volume) if filename.rpartition(".")[2].lower() in music_can_seek: print("file supports seeking") @@ -88,7 +75,7 @@ def play_file(filename): else: print("file does not support seeking") starting_pos = -1 - pygame.mixer.music.set_endevent(MUSIC_DONE) + pg.mixer.music.set_endevent(MUSIC_DONE) def play_next(): @@ -103,8 +90,8 @@ def play_next(): nxt = music_file_list.pop(0) try: - pygame.mixer.music.load(nxt) - except pygame.error as e: + pg.mixer.music.load(nxt) + except pg.error as e: print(e) print(f"{nxt} removed from file list") @@ -112,9 +99,9 @@ def play_next(): print("starting next song: ", nxt) else: nxt = music_file_list[0] - pygame.mixer.music.play(fade_ms=4000) - pygame.mixer.music.set_volume(volume) - pygame.mixer.music.set_endevent(MUSIC_DONE) + pg.mixer.music.play(fade_ms=4000) + pg.mixer.music.set_volume(volume) + pg.mixer.music.set_endevent(MUSIC_DONE) if nxt.rpartition(".")[2].lower() in music_can_seek: starting_pos = 0 @@ -122,6 +109,20 @@ def play_next(): starting_pos = -1 +def draw_text_line(text, y=0): + """ + Draws a line of text onto the display surface + The text will be centered horizontally at the given y position + The text's height is added to y and returned to the caller + """ + screen = pg.display.get_surface() + surf = font.render(text, 1, (255, 255, 255)) + y += surf.get_height() + x = (screen.get_width() - surf.get_width()) / 2 + screen.blit(surf, (x, y)) + return y + + def change_music_position(amount): """ Changes current playback position by amount seconds. @@ -133,17 +134,27 @@ def change_music_position(amount): global starting_pos if starting_pos >= 0: # will be -1 unless play_file() was OGG or MP3 - played_for = pygame.mixer.music.get_pos() / 1000.0 + played_for = pg.mixer.music.get_pos() / 1000.0 old_pos = starting_pos + played_for starting_pos = old_pos + amount - pygame.mixer.music.play(start=starting_pos) + pg.mixer.music.play(start=starting_pos) print(f"jumped from {old_pos} to {starting_pos}") +MUSIC_DONE = pg.event.custom_type() # event to be set as mixer.music.set_endevent() +main_dir = os.path.split(os.path.abspath(__file__))[0] +data_dir = os.path.join(main_dir, "data") + +starting_pos = 0 # needed to fast forward and rewind +volume = 0.75 +music_file_list: List[str] = [] +music_file_types = ("mp3", "ogg", "mid", "mod", "it", "xm", "wav") +music_can_seek = ("mp3", "ogg", "mod", "it", "xm") + + def main(): global font # this will be used by the draw_text_line function global volume, starting_pos - global screen running = True paused = False @@ -152,15 +163,16 @@ def main(): # the change_volume variable will be set by key down events and cleared by key up events change_volume = 0 - pygame.init() - screen = pygame.display.set_mode(SCREEN_SIZE) - font = pygame.font.SysFont("Arial", 24) - font.align = pygame.FONT_CENTER - clock = pygame.Clock() + pg.init() + pg.display.set_mode((640, 480)) + font = pg.font.SysFont("Arial", 24) + clock = pg.time.Clock() - clipped = "" - if pygame.scrap.has_text(): - clipped = pygame.scrap.get_text() + pg.scrap.init() + pg.SCRAP_TEXT = pg.scrap.get_types()[0] # TODO remove when scrap module is fixed + scrap_get = pg.scrap.get(pg.SCRAP_TEXT) + clipped = "" if scrap_get is None else scrap_get.decode("UTF-8") + # store the current text from the clipboard TODO remove decode # add the command line arguments to the music_file_list for arg in sys.argv[1:]: @@ -168,74 +180,73 @@ def main(): play_file("house_lo.ogg") # play default music included with pygame # draw instructions on screen - text = """ -Drop music files or path names onto this window -Copy file names into the clipboard -Or feed them from the command line -If it's music it will play! + y = draw_text_line("Drop music files or path names onto this window", 20) + y = draw_text_line("Copy file names into the clipboard", y) + y = draw_text_line("Or feed them from the command line", y) + y = draw_text_line("If it's music it will play!", y) + y = draw_text_line("SPACE to pause or UP/DOWN to change volume", y) + y = draw_text_line("LEFT and RIGHT will skip around the track", y) + draw_text_line("Other keys will start the next track", y) -LEFT and RIGHT will skip around the track -UP and DOWN will change volume -ENTER or SPACE will pause/unpause the track -Other keys will start the next track""" - screen.blit(font.render(text, True, "white", "black", SCREEN_SIZE[0] - 20), (10, 5)) """ This is the main loop It will respond to drag and drop, clipboard changes, and key presses """ while running: - for ev in pygame.event.get(): - if ev.type == pygame.QUIT: + for ev in pg.event.get(): + if ev.type == pg.QUIT: running = False - elif ev.type == pygame.DROPTEXT: + elif ev.type == pg.DROPTEXT: play_file(ev.text) - elif ev.type == pygame.DROPFILE: + elif ev.type == pg.DROPFILE: play_file(ev.file) elif ev.type == MUSIC_DONE: play_next() - elif ev.type == pygame.KEYDOWN: - if ev.key == pygame.K_ESCAPE: + elif ev.type == pg.KEYDOWN: + if ev.key == pg.K_ESCAPE: running = False # exit loop - elif ev.key in (pygame.K_SPACE, pygame.K_RETURN): + elif ev.key in (pg.K_SPACE, pg.K_RETURN): if paused: - pygame.mixer.music.unpause() + pg.mixer.music.unpause() paused = False else: - pygame.mixer.music.pause() + pg.mixer.music.pause() paused = True - elif ev.key == pygame.K_UP: + elif ev.key == pg.K_UP: change_volume = VOLUME_CHANGE_AMOUNT - elif ev.key == pygame.K_DOWN: + elif ev.key == pg.K_DOWN: change_volume = -VOLUME_CHANGE_AMOUNT - elif ev.key == pygame.K_RIGHT: + elif ev.key == pg.K_RIGHT: change_music_position(+5) - elif ev.key == pygame.K_LEFT: + elif ev.key == pg.K_LEFT: change_music_position(-5) else: play_next() - elif ev.type == pygame.KEYUP: - if ev.key in (pygame.K_UP, pygame.K_DOWN): + elif ev.type == pg.KEYUP: + if ev.key in (pg.K_UP, pg.K_DOWN): change_volume = 0 # is the user holding up or down? if change_volume: volume += change_volume volume = min(max(0, volume), 1) # volume should be between 0 and 1 - pygame.mixer.music.set_volume(volume) + pg.mixer.music.set_volume(volume) print("volume:", volume) - if pygame.scrap.has_text(): - new_text = pygame.scrap.get_text() - if new_text != clipped: - clipped = new_text - play_file(clipped) + # TODO remove decode when SDL2 scrap is fixed + scrap_get = pg.scrap.get(pg.SCRAP_TEXT) + new_text = "" if scrap_get is None else scrap_get.decode("UTF-8") - pygame.display.flip() + if new_text != clipped: # has the clipboard changed? + clipped = new_text + play_file(clipped) # try to play the file if it has + + pg.display.flip() clock.tick(9) # keep CPU use down by updating screen less often - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/ninepatch.py b/.venv/lib/python3.14/site-packages/pygame/examples/ninepatch.py deleted file mode 100644 index e9a5614..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/examples/ninepatch.py +++ /dev/null @@ -1,164 +0,0 @@ -#!/usr/bin/env python -"""pygame.examples.ninepatch -Demonstrate the purpose of the 9-patch scale method and a way to implement it. - -9-patch scaling allows us to scale a surface while keeping 4 corners intact. -This is very useful for GUI applications. - -How it works: -The 4 corners are extracted from the original surface and pasted on the new surface. -The 4 sides in between the corners are scaled horizontally or vertically to fit -between the new surface corners. -The central part of the image is scaled and pasted. - -In this example a green fill is used which can be done faster and easier with pygame.draw.rect -but usually you'd have a custom surface that needs intact corners. -""" - -import os - -import pygame - -SCREEN_SIZE = pygame.Vector2(600, 500) -SCALE_SIZE = pygame.Vector2(500, 150) -INNER_SCALE_SIZE = pygame.Vector2(400, 115) -CORNER_SIZE = 20 -INNER_CORNER_SIZE = 7 - - -def ninepatch_scale( - surface: pygame.Surface, - size: pygame.typing.Point, - corner_size: int, - alpha: bool = True, - smooth: bool = False, - dest_surface: pygame.Surface | None = None, -) -> pygame.Surface: - # the code of this function also emulates how a transform-like ninepatch function would likely behave - if dest_surface is not None: - ret_surface = dest_surface - if ret_surface.size != size: - raise ValueError("Destination surface doesn't match the provided size") - else: - ret_surface = pygame.Surface( - size, pygame.SRCALPHA * alpha - ) # when alpha is False the flags become 0 - - # aliases - ret_w, ret_h = size # non-sequence argument caught by python - src_w, src_h = surface.size - c = corner_size - scale_func = pygame.transform.smoothscale if smooth else pygame.transform.scale - subsurface = surface.subsurface # alias for performance/clarity - - if corner_size < 0 or corner_size > min(ret_w, ret_h): - raise ValueError( - "Corner size must be nonnegative and not greater than the smaller between width and height" - ) - if corner_size == 0: # default to normal scaling - return scale_func(surface, size) - - src_x_side, src_y_side = surface.size - pygame.Vector2(c) * 2 - ret_x_side, ret_y_side = size - pygame.Vector2(c) * 2 - - ret_surface.blit( # topleft corner - subsurface(0, 0, c, c), (0, 0) - ) - ret_surface.blit( # topright corner - subsurface(src_w - c, 0, c, c), (ret_w - c, 0) - ) - ret_surface.blit( # bottomleft corner - subsurface(0, src_h - c, c, c), (0, ret_h - c) - ) - ret_surface.blit( # bottomright corner - subsurface(src_w - c, src_h - c, c, c), (ret_w - c, ret_h - c) - ) - - if src_x_side > 0: - ret_surface.blit( # top side - scale_func(subsurface(c, 0, src_x_side, c), (ret_x_side, c)), (c, 0) - ) - ret_surface.blit( # bottom side - scale_func(subsurface(c, src_h - c, src_x_side, c), (ret_x_side, c)), - (c, ret_h - c), - ) - - if src_y_side > 0: - ret_surface.blit( # left side - scale_func(subsurface(0, c, c, src_y_side), (c, ret_y_side)), (0, c) - ) - ret_surface.blit( # right side - scale_func(subsurface(src_w - c, c, c, src_y_side), (c, ret_y_side)), - (ret_w - c, c), - ) - - if src_x_side > 0 and src_y_side > 0: - ret_surface.blit( # central area - scale_func( - subsurface(c, c, src_x_side, src_y_side), (ret_x_side, ret_y_side) - ), - (c, c), - ) - - return ret_surface - - -def main(): - pygame.init() - screen = pygame.display.set_mode(SCREEN_SIZE) - pygame.display.set_caption("9-Patch Scale and Normal Scale Example") - clock = pygame.Clock() - font = pygame.Font(None, 30) - - main_dir = os.path.split(os.path.abspath(__file__))[0] - example_image = pygame.image.load(os.path.join(main_dir, "data", "frame.webp")) - - original_surface = pygame.Surface((100, 100), pygame.SRCALPHA) - pygame.draw.rect( - original_surface, "green", original_surface.get_rect(), 0, CORNER_SIZE - ) - - normal_scale = pygame.transform.scale(original_surface, SCALE_SIZE) - normal_center = SCREEN_SIZE.elementwise() / pygame.Vector2(2, 4) - normal_rect = normal_scale.get_rect(center=normal_center) - example_normal_scale = pygame.transform.scale(example_image, INNER_SCALE_SIZE) - example_normal_rect = example_normal_scale.get_rect(center=normal_center) - - ninepatch = ninepatch_scale( - original_surface, SCALE_SIZE, CORNER_SIZE, True, False, None - ) - ninepatch_center = SCREEN_SIZE.elementwise() / pygame.Vector2(2, 4 / 3) - ninepatch_rect = ninepatch.get_rect(center=ninepatch_center) - example_ninepatch = ninepatch_scale( - example_image, INNER_SCALE_SIZE, INNER_CORNER_SIZE, True, False, None - ) - example_ninepatch_rect = example_ninepatch.get_rect(center=ninepatch_center) - - text_normal = font.render("Normal Scale", True, "black") - text_normal_rect = text_normal.get_rect(center=normal_center) - text_9patch = font.render("9-Patch Scale", True, "black") - text_9patch_rect = text_9patch.get_rect(center=ninepatch_center) - - running = True - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - running = False - - screen.fill(0) - - screen.blit(normal_scale, normal_rect) - screen.blit(example_normal_scale, example_normal_rect) - screen.blit(ninepatch, ninepatch_rect) - screen.blit(example_ninepatch, example_ninepatch_rect) - screen.blit(text_normal, text_normal_rect) - screen.blit(text_9patch, text_9patch_rect) - - pygame.display.flip() - clock.tick(60) - - pygame.quit() - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/pixelarray.py b/.venv/lib/python3.14/site-packages/pygame/examples/pixelarray.py index 1e6a0dc..6f5d58d 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/pixelarray.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/pixelarray.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.pixelarray +""" pygame.examples.pixelarray PixelArray does array processing of pixels. Sort of like another array processor called 'numpy' - But for pixels. @@ -13,39 +13,38 @@ Controls To see different effects - press a key or click a mouse. """ - import os +import pygame as pg -import pygame main_dir = os.path.split(os.path.abspath(__file__))[0] data_dir = os.path.join(main_dir, "data") def show(image): - screen = pygame.display.get_surface() + screen = pg.display.get_surface() screen.fill((255, 255, 255)) screen.blit(image, (0, 0)) - pygame.display.flip() + pg.display.flip() while True: - event = pygame.event.wait() - if event.type == pygame.QUIT: - pygame.quit() + event = pg.event.wait() + if event.type == pg.QUIT: + pg.quit() raise SystemExit - if event.type in [pygame.MOUSEBUTTONDOWN, pygame.KEYDOWN]: + if event.type in [pg.MOUSEBUTTONDOWN, pg.KEYDOWN]: break def main(): - pygame.init() + pg.init() - pygame.display.set_mode((255, 255)) - surface = pygame.Surface((255, 255)) + pg.display.set_mode((255, 255)) + surface = pg.Surface((255, 255)) - pygame.display.flip() + pg.display.flip() # Create the PixelArray. - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) # Do some easy gradient effect. for y in range(255): @@ -55,83 +54,83 @@ def main(): show(surface) # We have made some gradient effect, now flip it. - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) ar[:] = ar[:, ::-1] del ar show(surface) # Every second column will be made blue - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) ar[::2] = (0, 0, 255) del ar show(surface) # Every second row will be made green - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) ar[:, ::2] = (0, 255, 0) del ar show(surface) # Manipulate the image. Flip it around the y axis. - surface = pygame.image.load(os.path.join(data_dir, "arraydemo.webp")) - ar = pygame.PixelArray(surface) + surface = pg.image.load(os.path.join(data_dir, "arraydemo.bmp")) + ar = pg.PixelArray(surface) ar[:] = ar[:, ::-1] del ar show(surface) # Flip the image around the x axis. - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) ar[:] = ar[::-1, :] del ar show(surface) # Every second column will be made white. - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) ar[::2] = (255, 255, 255) del ar show(surface) # Flip the image around both axes, restoring its original layout. - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) ar[:] = ar[::-1, ::-1] del ar show(surface) # Rotate 90 degrees clockwise. w, h = surface.get_size() - surface2 = pygame.Surface((h, w), surface.get_flags(), surface) - ar = pygame.PixelArray(surface) - ar2 = pygame.PixelArray(surface2) + surface2 = pg.Surface((h, w), surface.get_flags(), surface) + ar = pg.PixelArray(surface) + ar2 = pg.PixelArray(surface2) ar2[...] = ar.transpose()[::-1, :] del ar, ar2 show(surface2) # Scale it by throwing each second pixel away. - surface = pygame.image.load(os.path.join(data_dir, "arraydemo.webp")) - ar = pygame.PixelArray(surface) + surface = pg.image.load(os.path.join(data_dir, "arraydemo.bmp")) + ar = pg.PixelArray(surface) sf2 = ar[::2, ::2].make_surface() del ar show(sf2) # Replace anything looking like the blue color from the text. - ar = pygame.PixelArray(surface) + ar = pg.PixelArray(surface) ar.replace((60, 60, 255), (0, 255, 0), 0.06) del ar show(surface) # Extract anything which might be somewhat black. - surface = pygame.image.load(os.path.join(data_dir, "arraydemo.webp")) - ar = pygame.PixelArray(surface) + surface = pg.image.load(os.path.join(data_dir, "arraydemo.bmp")) + ar = pg.PixelArray(surface) ar2 = ar.extract((0, 0, 0), 0.07) sf2 = ar2.surface del ar, ar2 show(sf2) # Compare two images. - surface = pygame.image.load(os.path.join(data_dir, "alien1.gif")) - surface2 = pygame.image.load(os.path.join(data_dir, "alien2.gif")) - ar1 = pygame.PixelArray(surface) - ar2 = pygame.PixelArray(surface2) + surface = pg.image.load(os.path.join(data_dir, "alien1.gif")) + surface2 = pg.image.load(os.path.join(data_dir, "alien2.gif")) + ar1 = pg.PixelArray(surface) + ar2 = pg.PixelArray(surface2) ar3 = ar1.compare(ar2, 0.07) sf3 = ar3.surface del ar1, ar2, ar3 @@ -140,4 +139,4 @@ def main(): if __name__ == "__main__": main() - pygame.quit() + pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/playmus.py b/.venv/lib/python3.14/site-packages/pygame/examples/playmus.py index 5358e38..8c67733 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/playmus.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/playmus.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.playmus +""" pygame.examples.playmus A simple music player. @@ -17,110 +17,144 @@ f - fade out q - stop """ - import sys -import pygame - -pygame.init() +import pygame as pg +import pygame.freetype -def write_lines( - dest: pygame.Surface, - text: str, - font=pygame.Font(None, 30), - color=(254, 231, 21, 255), - starting_line=0, -): - text_surface = font.render(text, True, color) +class Window: + """The application's Pygame window - y_offset = 0 - if starting_line >= 0: - y_offset = font.get_height() * starting_line - else: - y_offset = dest.get_height() + starting_line * font.get_height() + A Window instance manages the creation of and drawing to a + window. It is a singleton class. Only one instance can exist. - dest.fill( - (16, 24, 32, 255), - pygame.Rect((0, y_offset), (text_surface.get_width(), dest.get_width())), - ) - dest.blit(text_surface, (16, y_offset)) + """ + + instance = None + + def __new__(cls, *args, **kwds): + """Return an open Pygame window""" + + if Window.instance is not None: + return Window.instance + self = object.__new__(cls) + pg.display.init() + self.screen = pg.display.set_mode((600, 400)) + Window.instance = self + return self + + def __init__(self, title): + pg.display.set_caption(title) + self.text_color = (254, 231, 21, 255) + self.background_color = (16, 24, 32, 255) + self.screen.fill(self.background_color) + pg.display.flip() + + pygame.freetype.init() + self.font = pygame.freetype.Font(None, 20) + self.font.origin = True + self.ascender = int(self.font.get_sized_ascender() * 1.5) + self.descender = int(self.font.get_sized_descender() * 1.5) + self.line_height = self.ascender - self.descender + + self.write_lines( + "\nPress 'q' or 'ESCAPE' or close this window to quit\n" + "Press 'SPACE' to play / pause\n" + "Press 'r' to rewind to the beginning (restart)\n" + "Press 'f' to fade music out over 5 seconds\n\n" + "Window will quit automatically when music ends\n", + 0, + ) + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + self.close() + return False + + def close(self): + pg.display.quit() + Window.instance = None + + def write_lines(self, text, line=0): + w, h = self.screen.get_size() + line_height = self.line_height + nlines = h // line_height + if line < 0: + line = nlines + line + for i, text_line in enumerate(text.split("\n"), line): + y = i * line_height + self.ascender + # Clear the line first. + self.screen.fill( + self.background_color, (0, i * line_height, w, line_height) + ) + # Write new text. + self.font.render_to(self.screen, (15, y), text_line, self.text_color) + pg.display.flip() def show_usage_message(): - print( - "Usage: python playmus.py \n" - " python -m pygame.examples.playmus " - ) + print("Usage: python playmus.py ") + print(" python -m pygame.examples.playmus ") def main(file_path): - """Play an audio file with pygame.mixer.music""" + """Play an audio file with pg.mixer.music""" - screen = pygame.display.set_mode((600, 400)) - screen.fill((16, 24, 32, 255)) + with Window(file_path) as win: + win.write_lines("Loading ...", -1) + pg.mixer.init(frequency=44100) + try: + paused = False + pg.mixer.music.load(file_path) - write_lines(screen, "Loading ...", starting_line=-1) - pygame.mixer.init(frequency=44100) - pygame.mixer.music.load(file_path) + # Make sure the event loop ticks over at least every 0.5 seconds. + pg.time.set_timer(pg.USEREVENT, 500) - pygame.display.set_caption(f"File : {file_path}") + pg.mixer.music.play() + win.write_lines("Playing ...\n", -1) - write_lines( - screen, - "Press 'q' or 'ESCAPE' or close this window to quit\n" - "Press 'SPACE' to play / pause\n" - "Press 'r' to rewind to the beginning (restart)\n" - "Press 'f' to fade music out over 5 seconds", - starting_line=1, - ) - - pygame.mixer.music.play() - write_lines(screen, "Playing ...\n", starting_line=-1) - - running = True - paused = False - - while running: - pygame.display.flip() - - for event in pygame.event.get(): - if event.type == pygame.KEYDOWN: - key = event.key - if key == pygame.K_SPACE: - if paused: - pygame.mixer.music.unpause() + while pg.mixer.music.get_busy() or paused: + e = pg.event.wait() + if e.type == pg.KEYDOWN: + key = e.key + if key == pg.K_SPACE: + if paused: + pg.mixer.music.unpause() + paused = False + win.write_lines("Playing ...\n", -1) + else: + pg.mixer.music.pause() + paused = True + win.write_lines("Paused ...\n", -1) + elif key == pg.K_r: + if file_path[-3:].lower() in ("ogg", "mp3", "mod"): + status = "Rewound." + pg.mixer.music.rewind() + else: + status = "Restarted." + pg.mixer.music.play() + if paused: + pg.mixer.music.pause() + win.write_lines(status, -1) + elif key == pg.K_f: + win.write_lines("Fading out ...\n", -1) + pg.mixer.music.fadeout(5000) + # when finished get_busy() will return False. + elif key in [pg.K_q, pg.K_ESCAPE]: paused = False - write_lines(screen, "Playing ...", starting_line=-1) - else: - pygame.mixer.music.pause() - paused = True - write_lines(screen, "Paused ...", starting_line=-1) - elif key == pygame.K_r: - if file_path[-3:].lower() in ("ogg", "mp3", "mod"): - status = "Rewound." - pygame.mixer.music.rewind() - else: - status = "Restarted." - pygame.mixer.music.play() - if paused: - pygame.mixer.music.pause() - write_lines(screen, status, starting_line=-1) - elif key == pygame.K_f: - write_lines(screen, "Fading out ...", starting_line=-1) - pygame.mixer.music.fadeout(5000) - # when finished get_busy() will return False. - elif key in [pygame.K_q, pygame.K_ESCAPE]: + pg.mixer.music.stop() + # get_busy() will now return False. + elif e.type == pg.QUIT: paused = False - pygame.mixer.music.stop() + pg.mixer.music.stop() # get_busy() will now return False. - elif event.type == pygame.QUIT: - running = False - - if not pygame.mixer.music.get_busy() and not paused: - running = False - - pygame.quit() + pg.time.set_timer(pg.USEREVENT, 0) + finally: + pg.mixer.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/prevent_display_stretching.py b/.venv/lib/python3.14/site-packages/pygame/examples/prevent_display_stretching.py deleted file mode 100644 index efd8390..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/examples/prevent_display_stretching.py +++ /dev/null @@ -1,98 +0,0 @@ -#!/usr/bin/env python -"""pygame.examples.prevent_display_stretching - -Prevent display stretching on Windows. - -On some computers, the display environment can be configured to stretch -all windows so that they will not appear too small on the screen for -the user. This configuration is especially common on high-DPI displays. -pygame-ce graphics appear distorted when automatically stretched by the -display environment. This script demonstrates a technique for preventing -this stretching and distortion. - -Limitations: -This script makes an API call that is only available on Windows (versions -Vista and newer). - -""" - -# Ensure that the computer is running Windows Vista or newer -import os -import sys - -# game constants -TEXTCOLOR = "green" -BACKGROUNDCOLOR = "black" -AXISCOLOR = "white" - -if os.name != "nt" or sys.getwindowsversion()[0] < 6: - raise NotImplementedError("this script requires Windows Vista or newer") - -import ctypes - -import pygame - - -def main(): - # Determine whether or not the user would like to prevent stretching - if os.path.basename(sys.executable) == "pythonw.exe": - selection = "y" - else: - selection = None - while selection not in ("y", "n"): - selection = input("Prevent stretching? (y/n): ").strip().lower() - - if selection == "y": - msg = "Stretching is prevented." - else: - msg = "Stretching is not prevented." - - # Prevent stretching - if selection == "y": - user32 = ctypes.windll.user32 - user32.SetProcessDPIAware() - - # Show screen - pygame.display.init() - RESOLUTION = (350, 350) - screen = pygame.display.set_mode(RESOLUTION) - - # Render message onto a surface - pygame.font.init() - font = pygame.Font(None, 36) - msg_surf = font.render(msg, True, TEXTCOLOR) - res_surf = font.render("Intended resolution: %ix%i" % RESOLUTION, 1, TEXTCOLOR) - - # Control loop - running = True - clock = pygame.Clock() - counter = 0 - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - running = False - - screen.fill(BACKGROUNDCOLOR) - - # Draw lines which will be blurry if the window is stretched - # or clear if the window is not stretched. - pygame.draw.line(screen, AXISCOLOR, (0, counter), (RESOLUTION[0] - 1, counter)) - pygame.draw.line(screen, AXISCOLOR, (counter, 0), (counter, RESOLUTION[1] - 1)) - - # Blit message onto screen surface - msg_blit_rect = screen.blit(msg_surf, (0, 0)) - screen.blit(res_surf, (0, msg_blit_rect.bottom)) - - clock.tick(10) - - pygame.display.flip() - - counter += 1 - if counter == RESOLUTION[0]: - counter = 0 - - pygame.quit() - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/resizing_new.py b/.venv/lib/python3.14/site-packages/pygame/examples/resizing_new.py index 48eeadf..cda01f2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/resizing_new.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/resizing_new.py @@ -1,49 +1,44 @@ #!/usr/bin/env python -import pygame +import pygame as pg -RESOLUTION = (160, 120) +pg.init() + +RES = (160, 120) FPS = 30 +clock = pg.time.Clock() +screen = pg.display.set_mode(RES, pg.RESIZABLE) +pg.display._set_autoresize(False) -def main(): - pygame.init() +# MAIN LOOP - clock = pygame.Clock() +done = False - screen = pygame.display.set_mode(RESOLUTION, pygame.RESIZABLE) - pygame.display._set_autoresize(False) +i = 0 +j = 0 - # MAIN LOOP +while not done: + for event in pg.event.get(): + if event.type == pg.KEYDOWN and event.key == pg.K_q: + done = True + if event.type == pg.QUIT: + done = True + # if event.type==pg.WINDOWRESIZED: + # screen=pg.display.get_surface() + if event.type == pg.VIDEORESIZE: + screen = pg.display.get_surface() + i += 1 + i = i % screen.get_width() + j += i % 2 + j = j % screen.get_height() - done = False + screen.fill((255, 0, 255)) + pg.draw.circle(screen, (0, 0, 0), (100, 100), 20) + pg.draw.circle(screen, (0, 0, 200), (0, 0), 10) + pg.draw.circle(screen, (200, 0, 0), (160, 120), 30) + pg.draw.line(screen, (250, 250, 0), (0, 120), (160, 0)) + pg.draw.circle(screen, (255, 255, 255), (i, j), 5) - i = 0 - j = 0 - - while not done: - for event in pygame.event.get(): - if event.type == pygame.KEYDOWN and event.key == pygame.K_q: - done = True - elif event.type == pygame.VIDEORESIZE: - screen = pygame.display.get_surface() - elif event.type == pygame.QUIT: - done = True - i += 1 - i = i % screen.get_width() - j += i % 2 - j = j % screen.get_height() - - screen.fill((255, 0, 255)) - pygame.draw.circle(screen, (0, 0, 0), (100, 100), 20) - pygame.draw.circle(screen, (0, 0, 200), (0, 0), 10) - pygame.draw.circle(screen, (200, 0, 0), (160, 120), 30) - pygame.draw.line(screen, (250, 250, 0), (0, 120), (160, 0)) - pygame.draw.circle(screen, (255, 255, 255), (i, j), 5) - - pygame.display.flip() - clock.tick(FPS) - pygame.quit() - - -if __name__ == "__main__": - main() + pg.display.flip() + clock.tick(FPS) +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/retro_scaling.py b/.venv/lib/python3.14/site-packages/pygame/examples/retro_scaling.py deleted file mode 100644 index e226bad..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/examples/retro_scaling.py +++ /dev/null @@ -1,78 +0,0 @@ -import math - -import pygame - - -def new_canvas(): - # Return a new blank canvas. - return pygame.Surface((320, 240)) - - -def main(): - pygame.init() - clock = pygame.Clock() - - # Screen is a resizable window. - screen = pygame.display.set_mode((320, 240), pygame.RESIZABLE) - - # Canvas is the surface to draw to. - canvas = new_canvas() - - pygame.display.set_caption("Pygame - Retro scaling") - - running = True - - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - running = False - - # A fresh canvas to work on. - canvas = new_canvas() - - # Fill the screen-surface with a background-color. - screen.fill((128, 0, 0)) - - # Fill the canvas-surface with a background-color. - canvas.fill((0, 128, 0)) - - # Render a circle to demonstrate the scaling. - pygame.draw.circle(canvas, (255, 255, 255), (160, 120), 32) - - # Calculate the scale-factor for the canvas-surface. - scale_width = math.floor(screen.get_width() / canvas.get_width()) - scale_height = math.floor(screen.get_height() / canvas.get_height()) - - # Set scale to the smallest of width and height. - scale = min(scale_width, scale_height) - - # Set scale to a minimum of 1. - scale = max(scale, 1) - - # Scale the canvas-surface. - canvas = pygame.transform.scale_by(canvas, scale) - - # Calculate the center for the screen-surface. - screen_center_x = math.floor(screen.get_width() / 2) - screen_center_y = math.floor(screen.get_height() / 2) - - # Calculate the center for the canvas-surface. - canvas_center_x = math.floor(canvas.get_width() / 2) - canvas_center_y = math.floor(canvas.get_height() / 2) - - # Calculate the new canvas-position. - canvas_x = screen_center_x - canvas_center_x - canvas_y = screen_center_y - canvas_center_y - - # Render the canvas-surface in the center of screen-surface. - screen.blit(canvas, (canvas_x, canvas_y)) - - pygame.display.flip() - - clock.tick(30) - - pygame.quit() - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/scaletest.py b/.venv/lib/python3.14/site-packages/pygame/examples/scaletest.py index faf43e1..0a79f6f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/scaletest.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/scaletest.py @@ -1,14 +1,12 @@ #!/usr/bin/env python -"""pygame.examples.scaletest +""" pygame.examples.scaletest Shows an interactive image scaler. """ - import sys import time - -import pygame +import pygame as pg def main(imagefile, convert_alpha=False, run_speed_test=False): @@ -21,69 +19,78 @@ def main(imagefile, convert_alpha=False, run_speed_test=False): """ # initialize display - pygame.display.init() + pg.display.init() # load background image - background = pygame.image.load(imagefile) + background = pg.image.load(imagefile) if run_speed_test: if convert_alpha: # convert_alpha() requires the display mode to be set - pygame.display.set_mode((1, 1)) + pg.display.set_mode((1, 1)) background = background.convert_alpha() - speed_test(background) + SpeedTest(background) return - # start FULLSCREEN mode - # On Windows, the fullscreen mode doesn't work properly, to fix the problem, - # add with it pygame.SCALED flag - screen = pygame.display.set_mode((1024, 768), pygame.FULLSCREEN | pygame.SCALED) + # start fullscreen mode + screen = pg.display.set_mode((1024, 768), pg.FULLSCREEN) if convert_alpha: background = background.convert_alpha() # turn off the mouse pointer - pygame.mouse.set_visible(False) - - running = True - cursize = [background.get_width(), background.get_height()] - - clock = pygame.Clock() - + pg.mouse.set_visible(0) # main loop - while running: - clock.tick(60) - - image = pygame.transform.smoothscale(background, cursize) + bRunning = True + bUp = False + bDown = False + bLeft = False + bRight = False + cursize = [background.get_width(), background.get_height()] + while bRunning: + image = pg.transform.smoothscale(background, cursize) imgpos = image.get_rect(centerx=512, centery=384) screen.fill((255, 255, 255)) screen.blit(image, imgpos) - - pygame.display.flip() - - for event in pygame.event.get(): - if event.type == pygame.QUIT or ( - event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE + pg.display.flip() + for event in pg.event.get(): + if event.type == pg.QUIT or ( + event.type == pg.KEYDOWN and event.key == pg.K_ESCAPE ): - running = False - - pressed_keys = pygame.key.get_pressed() - - if pressed_keys[pygame.K_UP]: + bRunning = False + if event.type == pg.KEYDOWN: + if event.key == pg.K_UP: + bUp = True + if event.key == pg.K_DOWN: + bDown = True + if event.key == pg.K_LEFT: + bLeft = True + if event.key == pg.K_RIGHT: + bRight = True + if event.type == pg.KEYUP: + if event.key == pg.K_UP: + bUp = False + if event.key == pg.K_DOWN: + bDown = False + if event.key == pg.K_LEFT: + bLeft = False + if event.key == pg.K_RIGHT: + bRight = False + if bUp: cursize[1] -= 2 if cursize[1] < 1: cursize[1] = 1 - if pressed_keys[pygame.K_DOWN]: + if bDown: cursize[1] += 2 - if pressed_keys[pygame.K_LEFT]: + if bLeft: cursize[0] -= 2 if cursize[0] < 1: cursize[0] = 1 - if pressed_keys[pygame.K_RIGHT]: + if bRight: cursize[0] += 2 - pygame.quit() + pg.quit() -def speed_test(image): +def SpeedTest(image): print(f"\nImage Scaling Speed Test - Image Size {str(image.get_size())}\n") imgsize = [image.get_width(), image.get_height()] @@ -92,7 +99,7 @@ def speed_test(image): shrinkx = (imgsize[0] * i) // 128 shrinky = (imgsize[1] * i) // 128 start = time.time() - tempimg = pygame.transform.smoothscale(image, (shrinkx, shrinky)) + tempimg = pg.transform.smoothscale(image, (shrinkx, shrinky)) duration += time.time() - start del tempimg @@ -103,7 +110,7 @@ def speed_test(image): expandx = (imgsize[0] * (i + 129)) // 128 expandy = (imgsize[1] * (i + 129)) // 128 start = time.time() - tempimg = pygame.transform.smoothscale(image, (expandx, expandy)) + tempimg = pg.transform.smoothscale(image, (expandx, expandy)) duration += time.time() - start del tempimg @@ -114,7 +121,7 @@ def speed_test(image): shrinkx = (imgsize[0] * i) // 128 shrinky = (imgsize[1] * i) // 128 start = time.time() - tempimg = pygame.transform.scale(image, (shrinkx, shrinky)) + tempimg = pg.transform.scale(image, (shrinkx, shrinky)) duration += time.time() - start del tempimg @@ -125,7 +132,7 @@ def speed_test(image): expandx = (imgsize[0] * (i + 129)) // 128 expandy = (imgsize[1] * (i + 129)) // 128 start = time.time() - tempimg = pygame.transform.scale(image, (expandx, expandy)) + tempimg = pg.transform.scale(image, (expandx, expandy)) duration += time.time() - start del tempimg @@ -138,7 +145,7 @@ if __name__ == "__main__": print(f"\nUsage: {sys.argv[0]} imagefile [-t] [-convert_alpha]") print(" imagefile image filename (required)") print(" -t run speed test") - print(" -convert_alpha use convert_alpha() on the image's surface\n") + print(" -convert_alpha use convert_alpha() on the image's " "surface\n") else: main( sys.argv[1], diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/scrap_clipboard.py b/.venv/lib/python3.14/site-packages/pygame/examples/scrap_clipboard.py index f5f957c..e6b9773 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/scrap_clipboard.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/scrap_clipboard.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.scrap_clipboard +""" pygame.examples.scrap_clipboard Demonstrates the clipboard capabilities of pygame. @@ -8,66 +8,87 @@ Copy/paste! Keyboard Controls ----------------- - v - View the current clipboard data. - c - Copy some text into the clipboard. +g - get and print types in clipboard. If, image blit to screen. +p - place some text into clipboard +a - print types available in the clipboard +i - put image into the clipboard """ +import os -import pygame +import pygame as pg +import pygame.scrap as scrap + +from io import BytesIO -def main(): - pygame.init() - pygame.display.set_caption("Clipboard Example") - width, height = (960, 540) - screen = pygame.display.set_mode((width, height)) - clock = pygame.Clock() - font = pygame.Font(None, 30) - - clipboard_text = "" - running = True - - while running: - screen.fill("black") - - instruction = "Keyboard Controls:\nV - View the current clipboard data.\nC - Copy some text into the clipboard.\nEscape - Quit" - text = font.render(instruction, True, "white") - screen.blit(text, (0, 0)) - - text = font.render( - f"Text on the clipboard:\n{clipboard_text}", True, "white", None, width - 20 - ) - screen.blit(text, (0, 100)) - - for event in pygame.event.get(): - if event.type == pygame.QUIT: - running = False - - elif event.type == pygame.KEYDOWN: - if event.key == pygame.K_v: - # Look for any text data in the clipboard. - print("Looking for text in the clipboard.") - if pygame.scrap.has_text(): - print("Text found in the clipboard.") - clipboard_text = pygame.scrap.get_text() - else: - print("No text in the clipboard.") - - elif event.key == pygame.K_c: - # put some text into the clipboard. - print("Putting text into the clipboard.") - - pygame.scrap.put_text( - "Hello World! This is some text from the pygame scrap example.", - ) - - elif event.key == pygame.K_ESCAPE: - running = False - - pygame.display.flip() - clock.tick(60) - pygame.quit() +def usage(): + print("Press the 'g' key to get all of the current clipboard data") + print("Press the 'p' key to put a string into the clipboard") + print("Press the 'a' key to get a list of the currently available types") + print("Press the 'i' key to put an image into the clipboard") -if __name__ == "__main__": - main() +main_dir = os.path.split(os.path.abspath(__file__))[0] + +pg.init() +screen = pg.display.set_mode((200, 200)) +c = pg.time.Clock() +going = True + +# Initialize the scrap module and use the clipboard mode. +scrap.init() +scrap.set_mode(pg.SCRAP_CLIPBOARD) + +usage() + +while going: + for e in pg.event.get(): + if e.type == pg.QUIT or (e.type == pg.KEYDOWN and e.key == pg.K_ESCAPE): + going = False + + elif e.type == pg.KEYDOWN and e.key == pg.K_g: + # This means to look for data. + print("Getting the different clipboard data..") + for t in scrap.get_types(): + r = scrap.get(t) + if r and len(r) > 500: + print(f"Type {t} : (large {len(r)} byte buffer)") + elif r is None: + print(f"Type {t} : None") + else: + print(f"Type {t} : '{r.decode('ascii', 'ignore')}'") + if "image" in t: + namehint = t.split("/")[1] + if namehint in ["bmp", "png", "jpg"]: + f = BytesIO(r) + loaded_surf = pg.image.load(f, "." + namehint) + screen.blit(loaded_surf, (0, 0)) + + elif e.type == pg.KEYDOWN and e.key == pg.K_p: + # Place some text into the selection. + print("Placing clipboard text.") + scrap.put(pg.SCRAP_TEXT, b"Hello. This is a message from scrap.") + + elif e.type == pg.KEYDOWN and e.key == pg.K_a: + # Get all available types. + print("Getting the available types from the clipboard.") + types = scrap.get_types() + print(types) + if len(types) > 0: + print(f"Contains {types[0]}: {scrap.contains(types[0])}") + print("Contains _INVALID_: ", scrap.contains("_INVALID_")) + + elif e.type == pg.KEYDOWN and e.key == pg.K_i: + print("Putting image into the clipboard.") + scrap.set_mode(pg.SCRAP_CLIPBOARD) + fp = open(os.path.join(main_dir, "data", "liquid.bmp"), "rb") + buf = fp.read() + scrap.put("image/bmp", buf) + fp.close() + + elif e.type in (pg.KEYDOWN, pg.MOUSEBUTTONDOWN): + usage() + pg.display.flip() + c.tick(40) +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/scroll.py b/.venv/lib/python3.14/site-packages/pygame/examples/scroll.py index 66296a0..7c61ebb 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/scroll.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/scroll.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.scroll +""" pygame.examples.scroll An zoomed image viewer that demonstrates Surface.scroll @@ -14,16 +14,15 @@ When running click on a black triangle to move one pixel in the direction the triangle points. Or use the arrow keys. Close the window or press ESC to quit. """ - -import os import sys +import os -import pygame +import pygame as pg from pygame.transform import scale main_dir = os.path.dirname(os.path.abspath(__file__)) -# game constants + DIR_UP = 1 DIR_DOWN = 2 DIR_LEFT = 3 @@ -32,7 +31,7 @@ DIR_RIGHT = 4 zoom_factor = 8 -def draw_arrow(surf, color, posn, direction): +def draw_arrow(surf, color, posn, direction: int): x, y = posn if direction == DIR_UP: pointlist = ((x - 29, y + 30), (x + 30, y + 30), (x + 1, y - 29), (x, y - 29)) @@ -42,7 +41,7 @@ def draw_arrow(surf, color, posn, direction): pointlist = ((x + 30, y - 29), (x + 30, y + 30), (x - 29, y + 1), (x - 29, y)) else: pointlist = ((x - 29, y - 29), (x - 29, y + 30), (x + 30, y + 1), (x + 30, y)) - pygame.draw.polygon(surf, color, pointlist) + pg.draw.polygon(surf, color, pointlist) def add_arrow_button(screen, regions, posn, direction): @@ -50,8 +49,9 @@ def add_arrow_button(screen, regions, posn, direction): draw_arrow(regions, (direction, 0, 0), posn, direction) -def scroll_view(screen, image, direction, view_rect): +def scroll_view(screen, image: pg.Surface, direction: int, view_rect): src_rect = None + dst_rect = None zoom_view_rect = screen.get_clip() image_w, image_h = image.get_size() if direction == DIR_UP: @@ -90,33 +90,34 @@ def scroll_view(screen, image, direction, view_rect): dst_rect = zoom_view_rect.copy() dst_rect.w = zoom_factor dst_rect.right = zoom_view_rect.right - if src_rect is not None: + + if src_rect is not None and dst_rect is not None: scale(image.subsurface(src_rect), dst_rect.size, screen.subsurface(dst_rect)) - pygame.display.update(zoom_view_rect) + pg.display.update(zoom_view_rect) def main(image_file=None): if image_file is None: - image_file = os.path.join(main_dir, "data", "arraydemo.webp") + image_file = os.path.join(main_dir, "data", "arraydemo.bmp") margin = 80 view_size = (30, 20) zoom_view_size = (view_size[0] * zoom_factor, view_size[1] * zoom_factor) win_size = (zoom_view_size[0] + 2 * margin, zoom_view_size[1] + 2 * margin) - background_color = pygame.Color("beige") + background_color = pg.Color("beige") - pygame.init() - pygame.display.set_caption("Scroll Example") + pg.init() + pg.display.set_caption("Scroll Example") # set up key repeating so we can hold down the key to scroll. - old_k_delay, old_k_interval = pygame.key.get_repeat() - pygame.key.set_repeat(500, 30) + old_k_delay, old_k_interval = pg.key.get_repeat() + pg.key.set_repeat(500, 30) try: - screen = pygame.display.set_mode(win_size) + screen = pg.display.set_mode(win_size) screen.fill(background_color) - pygame.display.flip() + pg.display.flip() - image = pygame.image.load(image_file).convert() + image = pg.image.load(image_file).convert() image_w, image_h = image.get_size() if image_w < view_size[0] or image_h < view_size[1]: @@ -124,7 +125,7 @@ def main(image_file=None): print("A %i by %i or larger image is required." % zoom_view_size) return - regions = pygame.Surface(win_size, 0, 24) + regions = pg.Surface(win_size, 0, 24) add_arrow_button(screen, regions, (40, win_size[1] // 2), DIR_LEFT) add_arrow_button( screen, regions, (win_size[0] - 40, win_size[1] // 2), DIR_RIGHT @@ -133,52 +134,53 @@ def main(image_file=None): add_arrow_button( screen, regions, (win_size[0] // 2, win_size[1] - 40), DIR_DOWN ) - pygame.display.flip() + pg.display.flip() screen.set_clip((margin, margin, zoom_view_size[0], zoom_view_size[1])) - view_rect = pygame.Rect(0, 0, view_size[0], view_size[1]) + view_rect = pg.Rect(0, 0, view_size[0], view_size[1]) scale( image.subsurface(view_rect), zoom_view_size, screen.subsurface(screen.get_clip()), ) - pygame.display.flip() + pg.display.flip() # the direction we will scroll in. direction = None - clock = pygame.Clock() + clock = pg.time.Clock() clock.tick() going = True while going: # wait for events before doing anything. - # events = [pygame.event.wait()] + pygame.event.get() - events = pygame.event.get() + # events = [pg.event.wait()] + pg.event.get() + events = pg.event.get() # During the loop, if a key is held, scroll the view. - keys = pygame.key.get_pressed() - if keys[pygame.K_UP]: + keys = pg.key.get_pressed() + if keys[pg.K_UP]: scroll_view(screen, image, DIR_UP, view_rect) - if keys[pygame.K_DOWN]: + if keys[pg.K_DOWN]: scroll_view(screen, image, DIR_DOWN, view_rect) - if keys[pygame.K_LEFT]: + if keys[pg.K_LEFT]: scroll_view(screen, image, DIR_LEFT, view_rect) - if keys[pygame.K_RIGHT]: + if keys[pg.K_RIGHT]: scroll_view(screen, image, DIR_RIGHT, view_rect) for e in events: # quit if the event is quit. - if e.type == pygame.QUIT: + if e.type == pg.QUIT: going = False # handle mouse button presses on arrows. - elif e.type == pygame.MOUSEBUTTONDOWN: + elif e.type == pg.MOUSEBUTTONDOWN: direction = regions.get_at(e.pos)[0] - elif e.type == pygame.MOUSEBUTTONUP: + + elif e.type == pg.MOUSEBUTTONUP: direction = None if direction: @@ -186,13 +188,10 @@ def main(image_file=None): clock.tick(30) finally: - pygame.key.set_repeat(old_k_delay, old_k_interval) - pygame.quit() + pg.key.set_repeat(old_k_delay, old_k_interval) + pg.quit() if __name__ == "__main__": - if len(sys.argv) > 1: - image_file = sys.argv[1] - else: - image_file = None + image_file = sys.argv[1] if len(sys.argv) > 1 else None main(image_file) diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/setmodescale.py b/.venv/lib/python3.14/site-packages/pygame/examples/setmodescale.py index 6348dd4..3f427d2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/setmodescale.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/setmodescale.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.setmodescale +""" pygame.examples.setmodescale On high resolution displays(4k, 1080p) and tiny graphics games (640x480) show up very small so that they are unplayable. SCALED scales up the window @@ -10,82 +10,58 @@ Passing SCALED to pygame.display.set_mode means the resolution depends on desktop size and the graphics are scaled. """ -import sys +import pygame as pg -import pygame +pg.init() RES = (160, 120) FPS = 30 +clock = pg.time.Clock() +print("desktops", pg.display.get_desktop_sizes()) +screen = pg.display.set_mode(RES, pg.SCALED | pg.RESIZABLE) -def main(): - pygame.init() +# MAIN LOOP - clock = pygame.Clock() +done = False - print("desktops", pygame.display.get_desktop_sizes()) +i = 0 +j = 0 - do_vsync = bool("--vsync" in sys.argv) +r_name, r_flags = pg.display._get_renderer_info() +print("renderer:", r_name, "flags:", bin(r_flags)) +for flag, name in [ + (1, "software"), + (2, "accelerated"), + (4, "VSync"), + (8, "render to texture"), +]: + if flag & r_flags: + print(name) - if do_vsync: - screen = pygame.display.set_mode(RES, pygame.SCALED | pygame.RESIZABLE, vsync=1) - else: - screen = pygame.display.set_mode(RES, pygame.SCALED | pygame.RESIZABLE) +while not done: + for event in pg.event.get(): + if event.type == pg.KEYDOWN and event.key == pg.K_q: + done = True + if event.type == pg.QUIT: + done = True + if event.type == pg.KEYDOWN and event.key == pg.K_f: + pg.display.toggle_fullscreen() + if event.type == pg.VIDEORESIZE: + pg.display._resize_event(event) - # MAIN LOOP + i += 1 + i = i % screen.get_width() + j += i % 2 + j = j % screen.get_height() - done = False + screen.fill((255, 0, 255)) + pg.draw.circle(screen, (0, 0, 0), (100, 100), 20) + pg.draw.circle(screen, (0, 0, 200), (0, 0), 10) + pg.draw.circle(screen, (200, 0, 0), (160, 120), 30) + pg.draw.line(screen, (250, 250, 0), (0, 120), (160, 0)) + pg.draw.circle(screen, (255, 255, 255), (i, j), 5) - i = 0 - j = 0 - - r_name, r_flags = pygame.display._get_renderer_info() - print("renderer:", r_name, "flags:", bin(r_flags)) - for flag, name in [ - (1, "software"), - (2, "accelerated"), - (4, "VSync"), - (8, "render to texture"), - ]: - if flag & r_flags: - print(name) - - while not done: - for event in pygame.event.get(): - if event.type == pygame.KEYDOWN and event.key == pygame.K_q: - done = True - if event.type == pygame.QUIT: - done = True - if event.type == pygame.KEYDOWN and event.key == pygame.K_f: - pygame.display.toggle_fullscreen() - i += 1 - i = i % screen.get_width() - j += i % 2 - j = j % screen.get_height() - - screen.fill((255, 0, 255)) - pygame.draw.circle(screen, (0, 0, 0), (100, 100), 20) - pygame.draw.circle(screen, (0, 0, 200), (0, 0), 10) - pygame.draw.circle(screen, (200, 0, 0), (160, 120), 30) - if do_vsync: - # vertical line that moves horizontally to make screen tearing obvious - pygame.draw.line(screen, (250, 250, 0), (i, 0), (i, 120)) - else: - pygame.draw.line(screen, (250, 250, 0), (0, 120), (160, 0)) - pygame.draw.circle(screen, (255, 255, 255), (i, j), 5) - - pygame.display.set_caption("FPS:" + str(clock.get_fps())) - if do_vsync: - pygame.display.flip() - # FPS should be limited by vsync, so we tick really fast - # we only need to have the clock tick to track FPS - clock.tick() - else: - clock.tick(FPS) - pygame.display.flip() - - pygame.quit() - - -if __name__ == "__main__": - main() + pg.display.flip() + clock.tick(FPS) +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/sound.py b/.venv/lib/python3.14/site-packages/pygame/examples/sound.py index 49bf2d5..c5a23b9 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/sound.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/sound.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.sound +""" pygame.examples.sound Playing a soundfile and waiting for it to finish. You'll need the pygame.mixer module for this to work. Note how in this simple example @@ -8,11 +8,9 @@ Just pick the mixer for sound and time for the delay function. Optional command line argument: audio file name """ - import os import sys - -import pygame +import pygame as pg main_dir = os.path.split(os.path.abspath(__file__))[0] @@ -23,10 +21,10 @@ def main(file_path=None): :param str file_path: audio file (default data/secosmic_low.wav) """ # choose a desired audio format - pygame.mixer.init(11025) # raises exception on fail + pg.mixer.init(11025) # raises exception on fail # load the sound - sound = pygame.mixer.Sound(file_path) + sound = pg.mixer.Sound(file_path) # start playing print("Playing Sound...") @@ -35,9 +33,9 @@ def main(file_path=None): # poll until finished while channel.get_busy(): # still playing print(" ...still going...") - pygame.time.wait(1000) + pg.time.wait(1000) print("...Finished") - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/sound_array_demos.py b/.venv/lib/python3.14/site-packages/pygame/examples/sound_array_demos.py index 6defd03..855808b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/sound_array_demos.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/sound_array_demos.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.sound_array_demos +""" pygame.examples.sound_array_demos Creates an echo effect on any Sound object. @@ -13,17 +13,16 @@ version 2. changes: - put into a function. - Uses numpy by default, but falls back on Numeric. """ - import os +import pygame as pg +from numpy import zeros, int32, int16 import time -import pygame -from numpy import int16, int32, zeros -# pygame.mixer.init(44100, -16, 0) -pygame.mixer.init() -# pygame.mixer.init(11025, -16, 0) -# pygame.mixer.init(11025) +# pg.mixer.init(44100, -16, 0) +pg.mixer.init() +# pg.mixer.init(11025, -16, 0) +# pg.mixer.init(11025) def make_echo(sound, samples_per_second, mydebug=True): @@ -31,7 +30,7 @@ def make_echo(sound, samples_per_second, mydebug=True): echo_length = 3.5 - a1 = pygame.sndarray.array(sound) + a1 = pg.sndarray.array(sound) if mydebug: print(f"SHAPE1: {a1.shape}") @@ -74,7 +73,7 @@ def make_echo(sound, samples_per_second, mydebug=True): if mydebug: print(f"SHAPE2: {myarr.shape}") - sound2 = pygame.sndarray.make_sound(myarr.astype(int16)) + sound2 = pg.sndarray.make_sound(myarr.astype(int16)) return sound2 @@ -87,10 +86,10 @@ def slow_down_sound(sound, rate): raise NotImplementedError() # grow_rate = 1 / rate # make it 1/rate times longer. - # a1 = pygame.sndarray.array(sound) - # surf = pygame.surfarray.make_surface(a1) + # a1 = pg.sndarray.array(sound) + # surf = pg.surfarray.make_surface(a1) # print(a1.shape[0] * grow_rate) - # scaled_surf = pygame.transform.scale(surf, (int(a1.shape[0] * grow_rate), a1.shape[1])) + # scaled_surf = pg.transform.scale(surf, (int(a1.shape[0] * grow_rate), a1.shape[1])) # print(scaled_surf) # print(surf) @@ -98,7 +97,7 @@ def slow_down_sound(sound, rate): # print(a1.shape) # print(a2.shape) # print(a2) - # sound2 = pygame.sndarray.make_sound(a2.astype(int16)) + # sound2 = pg.sndarray.make_sound(a2.astype(int16)) # return sound2 @@ -110,14 +109,14 @@ def sound_from_pos(sound, start_pos, samples_per_second=None, inplace=1): # see if we want to reuse the sound data or not. if inplace: - a1 = pygame.sndarray.samples(sound) + a1 = pg.sndarray.samples(sound) else: - a1 = pygame.sndarray.array(sound) + a1 = pg.sndarray.array(sound) - # see if samples per second has been given. If not, query the pygame.mixer. + # see if samples per second has been given. If not, query the pg.mixer. # eg. it might be set to 22050 if samples_per_second is None: - samples_per_second = pygame.mixer.get_init()[0] + samples_per_second = pg.mixer.get_init()[0] # figure out the start position in terms of samples. start_pos_in_samples = int(start_pos * samples_per_second) @@ -126,7 +125,7 @@ def sound_from_pos(sound, start_pos, samples_per_second=None, inplace=1): a2 = a1[start_pos_in_samples:] # make the Sound instance from the array. - sound2 = pygame.sndarray.make_sound(a2) + sound2 = pg.sndarray.make_sound(a2) return sound2 @@ -135,13 +134,13 @@ def main(): """play various sndarray effects""" main_dir = os.path.split(os.path.abspath(__file__))[0] - print(f"mixer.get_init {pygame.mixer.get_init()}") + print(f"mixer.get_init {pg.mixer.get_init()}") - samples_per_second = pygame.mixer.get_init()[0] + samples_per_second = pg.mixer.get_init()[0] print(("-" * 30) + "\n") print("loading sound") - sound = pygame.mixer.Sound(os.path.join(main_dir, "data", "car_door.wav")) + sound = pg.mixer.Sound(os.path.join(main_dir, "data", "car_door.wav")) print("-" * 30) print("start positions") @@ -153,19 +152,19 @@ def main(): print(f"sound.get_length {sound.get_length()}") print(f"sound2.get_length {sound2.get_length()}") sound2.play() - while pygame.mixer.get_busy(): - pygame.time.wait(200) + while pg.mixer.get_busy(): + pg.time.wait(200) print("waiting 2 seconds") - pygame.time.wait(2000) + pg.time.wait(2000) print("playing original sound") sound.play() - while pygame.mixer.get_busy(): - pygame.time.wait(200) + while pg.mixer.get_busy(): + pg.time.wait(200) print("waiting 2 seconds") - pygame.time.wait(2000) + pg.time.wait(2000) # if 0: # #TODO: this is broken. @@ -174,8 +173,8 @@ def main(): # rate = 0.2 # slowed_sound = slow_down_sound(sound, rate) # slowed_sound.play() - # while pygame.mixer.get_busy(): - # pygame.time.wait(200) + # while pg.mixer.get_busy(): + # pg.time.wait(200) print("-" * 30) print("echoing") @@ -187,15 +186,15 @@ def main(): print("original sound") sound.play() - while pygame.mixer.get_busy(): - pygame.time.wait(200) + while pg.mixer.get_busy(): + pg.time.wait(200) print("echoed sound") sound2.play() - while pygame.mixer.get_busy(): - pygame.time.wait(200) + while pg.mixer.get_busy(): + pg.time.wait(200) - sound = pygame.mixer.Sound(os.path.join(main_dir, "data", "secosmic_lo.wav")) + sound = pg.mixer.Sound(os.path.join(main_dir, "data", "secosmic_lo.wav")) t1 = time.time() sound3 = make_echo(sound, samples_per_second) @@ -203,15 +202,15 @@ def main(): print("original sound") sound.play() - while pygame.mixer.get_busy(): - pygame.time.wait(200) + while pg.mixer.get_busy(): + pg.time.wait(200) print("echoed sound") sound3.play() - while pygame.mixer.get_busy(): - pygame.time.wait(200) + while pg.mixer.get_busy(): + pg.time.wait(200) - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/sprite_texture.py b/.venv/lib/python3.14/site-packages/pygame/examples/sprite_texture.py index 07dedab..fd7a63b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/sprite_texture.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/sprite_texture.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.sprite_texture +""" pygame.examples.sprite_texture Experimental! Uses APIs which may disappear in the next release (_sdl2 is private). @@ -9,97 +9,102 @@ Hardware accelerated Image objects with pygame.sprite. _sdl2.video.Image is a backwards compatible way with to use Texture with pygame.sprite groups. """ - import os +import pygame as pg + +if pg.get_sdl_version()[0] < 2: + raise SystemExit("This example requires pygame 2 and SDL2.") +from pygame._sdl2 import Window, Texture, Image, Renderer -import pygame -from pygame._sdl2 import Image, Renderer, Texture, Window data_dir = os.path.join(os.path.split(os.path.abspath(__file__))[0], "data") def load_img(file): - return pygame.image.load(os.path.join(data_dir, file)) + return pg.image.load(os.path.join(data_dir, file)) -def main(): - pygame.display.init() - pygame.key.set_repeat(10, 10) +pg.display.init() +pg.key.set_repeat(10, 10) - win = Window("asdf", resizable=True) - renderer = Renderer(win) - tex = Texture.from_surface(renderer, load_img("alien1.gif")) +win = Window("asdf", resizable=True) +renderer = Renderer(win) +tex = Texture.from_surface(renderer, load_img("alien1.gif")) - class Something(pygame.sprite.Sprite): - def __init__(self, img): - pygame.sprite.Sprite.__init__(self) - self.rect = img.get_rect() - self.image = img +class Something(pg.sprite.Sprite): + def __init__(self, img): + pg.sprite.Sprite.__init__(self) - self.rect.w *= 5 - self.rect.h *= 5 + self.rect = img.get_rect() + self.image = img - img.origin = self.rect.w / 2, self.rect.h / 2 + self.rect.w *= 5 + self.rect.h *= 5 - sprite = Something(Image(tex, (0, 0, tex.width / 2, tex.height / 2))) - sprite.rect.x = 250 - sprite.rect.y = 50 + img.origin = self.rect.w / 2, self.rect.h / 2 - # sprite2 = Something(Image(sprite.image)) - sprite2 = Something(Image(tex)) - sprite2.rect.x = 250 - sprite2.rect.y = 250 - sprite2.rect.w /= 2 - sprite2.rect.h /= 2 - group = pygame.sprite.Group() - group.add(sprite2) - group.add(sprite) +sprite = Something(Image(tex, (0, 0, tex.width / 2, tex.height / 2))) +sprite.rect.x = 250 +sprite.rect.y = 50 - import math +# sprite2 = Something(Image(sprite.image)) +sprite2 = Something(Image(tex)) +sprite2.rect.x = 250 +sprite2.rect.y = 250 +sprite2.rect.w /= 2 +sprite2.rect.h /= 2 - t = 0 - running = True - clock = pygame.Clock() - renderer.draw_color = (255, 0, 0, 255) +group = pg.sprite.Group() +group.add(sprite2) +group.add(sprite) - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: +import math + +t = 0 +running = True +clock = pg.time.Clock() +renderer.draw_color = (255, 0, 0, 255) + +while running: + for event in pg.event.get(): + if event.type == pg.QUIT: + running = False + elif event.type == pg.KEYDOWN: + if event.key == pg.K_ESCAPE: running = False - elif event.type == pygame.KEYDOWN: - if event.key == pygame.K_ESCAPE: - running = False - elif event.key == pygame.K_LEFT: - sprite.rect.x -= 5 - elif event.key == pygame.K_RIGHT: - sprite.rect.x += 5 - elif event.key == pygame.K_DOWN: - sprite.rect.y += 5 - elif event.key == pygame.K_UP: - sprite.rect.y -= 5 + elif event.key == pg.K_LEFT: + sprite.rect.x -= 5 + elif event.key == pg.K_RIGHT: + sprite.rect.x += 5 + elif event.key == pg.K_DOWN: + sprite.rect.y += 5 + elif event.key == pg.K_UP: + sprite.rect.y -= 5 - renderer.clear() - t += 1 + renderer.clear() + t += 1 - img = sprite.image - img.angle += 1 + img = sprite.image + img.angle += 1 + try: img.flip_x = t % 50 < 25 img.flip_y = t % 100 < 50 - img.color[0] = int(255.0 * (0.5 + math.sin(0.5 * t + 10.0) / 2.0)) - img.alpha = int(255.0 * (0.5 + math.sin(0.1 * t) / 2.0)) - # img.draw(dstrect=(x, y, 5 * img.srcrect['w'], 5 * img.srcrect['h'])) + except AttributeError: + # backwards compatibility for <=2.1.2 + img.flipX = t % 50 < 25 + img.flipY = t % 100 < 50 - group.draw(renderer) + img.color[0] = int(255.0 * (0.5 + math.sin(0.5 * t + 10.0) / 2.0)) + img.alpha = int(255.0 * (0.5 + math.sin(0.1 * t) / 2.0)) + # img.draw(dstrect=(x, y, 5 * img.srcrect['w'], 5 * img.srcrect['h'])) - renderer.present() + group.draw(renderer) - clock.tick(60) - win.title = str(f"FPS: {clock.get_fps()}") + renderer.present() - pygame.quit() + clock.tick(60) + win.title = str(f"FPS: {clock.get_fps()}") - -if __name__ == "__main__": - main() +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/stars.py b/.venv/lib/python3.14/site-packages/pygame/examples/stars.py index 0b63d92..f154511 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/stars.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/stars.py @@ -1,135 +1,100 @@ #!/usr/bin/env python -"""pygame.examples.stars +""" pg.examples.stars -We are all in the gutter, -but some of us are looking at the stars. - -- Oscar Wilde + We are all in the gutter, + but some of us are looking at the stars. + -- Oscar Wilde -A simple starfield example. Note you can move the center of -the starfield by leftclicking in the window. This example shows -the basics of creating a window, simple pixel plotting, and event management. +A simple starfield example. Note you can move the 'center' of +the starfield by leftclicking in the window. This example show +the basics of creating a window, simple pixel plotting, and input +event management. """ - import random +import math +import pygame as pg -import pygame +# constants +WINSIZE = [640, 480] +WINCENTER = [320, 240] +NUMSTARS = 150 -class Particle: - def __init__( - self, - pos: list[int], - vel: pygame.Vector2, - ): - """ - Parameters: - pos: Position of the particle - vel: How far does the particle move (x, y) every frame - """ +def init_star(steps=-1): + "creates new star values" + dir = random.randrange(100000) + steps_velocity = 1 if steps == -1 else steps * 0.09 + velmult = steps_velocity * (random.random() * 0.6 + 0.4) + vel = [math.sin(dir) * velmult, math.cos(dir) * velmult] - self.pos = pos - self.vel = vel - self.color_list = [ - (255, 210, 125), - (255, 163, 113), - (166, 168, 255), - (255, 250, 134), - (168, 123, 255), - ] - - def draw(self, display: pygame.Surface): - """ - Draws the particle on a pygame.Surface - Parameters: - display: The surface the particle is drawn on - """ - - pygame.draw.line(display, random.choice(self.color_list), self.pos, self.pos) - - def update(self): - """ - Moves the particle - """ - - self.pos += self.vel + if steps is None: + return [vel, [WINCENTER[0] + (vel[0] * steps), WINCENTER[1] + (vel[1] * steps)]] + return [vel, WINCENTER[:]] -def create_particle(particle_list: list[Particle], pos: pygame.Vector2): - """ - Creates a new particle - Parameters: - particle_list: List of existing particles - pos: The coordinates the new particle will be spawned on - """ - - particle_list.append( - Particle( - pos=pos.copy(), - vel=pygame.Vector2(random.uniform(-5, 5), random.uniform(-5, 5)), - ) - ) +def initialize_stars(): + "creates a new starfield" + random.seed() + stars = [init_star(steps=random.randint(0, WINCENTER[0])) for _ in range(NUMSTARS)] + move_stars(stars) + return stars -def update_particles(particle_list: list[Particle], screen_rect: pygame.Rect): - """ - Updates the particles - Parameters: - particle_list: List of existing particles - screen_rect: A pygame.Rect that represents the screen - (used to determine whether a particle is visible on the screen) - """ - - for particle in particle_list: - if not screen_rect.collidepoint(particle.pos): - particle_list.remove(particle) - - particle.update() +def draw_stars(surface, stars, color): + "used to draw (and clear) the stars" + for _, pos in stars: + pos = (int(pos[0]), int(pos[1])) + surface.set_at(pos, color) -def draw_particles(particle_list: list[Particle], display: pygame.Surface): - """ - Draws the particles - Parameters: - particle_list: List of existing particles - display: The surface the particle is drawn on - """ - for particle in particle_list: - particle.draw(display) +def move_stars(stars): + "animate the star values" + for vel, pos in stars: + pos[0] = pos[0] + vel[0] + pos[1] = pos[1] + vel[1] + if not 0 <= pos[0] <= WINSIZE[0] or not 0 <= pos[1] <= WINSIZE[1]: + vel[:], pos[:] = init_star() + else: + vel[0] = vel[0] * 1.05 + vel[1] = vel[1] * 1.05 def main(): - """ - Contains the game variables and loop - """ - screen = pygame.display.set_mode((600, 500)) - clock = pygame.Clock() - pygame.display.set_caption("Pygame Stars") - particles = [] - # how many particles to spawn every frame - particle_density = 10 + "This is the starfield code" + # create our starfield + stars = initialize_stars() - screen_rect = screen.get_rect() - spawn_point = pygame.Vector2(screen_rect.center) + # initialize and prepare screen + pg.init() + screen = pg.display.set_mode(WINSIZE) + pg.display.set_caption("pygame Stars Example") + white = 255, 240, 200 + black = 20, 20, 40 + screen.fill(black) - running = True - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - running = False - if event.type == pygame.MOUSEBUTTONDOWN: - spawn_point = pygame.Vector2(event.pos) + clock = pg.time.Clock() - screen.fill((20, 20, 40)) - for _ in range(particle_density): - create_particle(particles, spawn_point) - update_particles(particles, screen_rect) - draw_particles(particles, screen) - - pygame.display.flip() - clock.tick(60) - - pygame.quit() + # main game loop + done = 0 + while not done: + draw_stars(screen, stars, black) + move_stars(stars) + draw_stars(screen, stars, white) + pg.display.update() + for e in pg.event.get(): + if e.type == pg.QUIT or (e.type == pg.KEYUP and e.key == pg.K_ESCAPE): + done = 1 + break + if e.type == pg.MOUSEBUTTONDOWN and e.button == 1: + WINCENTER[:] = list(e.pos) + clock.tick(50) + pg.quit() +# So `python -m pygame.example.stars` will work. if __name__ == "__main__": main() + + # I prefer the time of insects to the time of stars. + # + # -- Wisława Szymborska diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/testsprite.py b/.venv/lib/python3.14/site-packages/pygame/examples/testsprite.py index da7e9c3..100ec25 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/testsprite.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/testsprite.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.testsprite +""" pg.examples.testsprite Like the testsprite.c that comes with libsdl, this pygame version shows lots of sprites moving around. @@ -7,15 +7,16 @@ lots of sprites moving around. It is an abomination of ugly code, and mostly used for testing. -See pygame.examples.aliens for some prettier code. +See pg.examples.aliens for some prettyier code. """ - -import os import sys +import os + from random import randint from time import time +from typing import List -import pygame +import pygame as pg main_dir = os.path.split(os.path.abspath(__file__))[0] data_dir = os.path.join(main_dir, "data") @@ -42,18 +43,22 @@ if "-layered_dirty" in sys.argv: flags = 0 if "-flip" in sys.argv: - flags ^= pygame.DOUBLEBUF + flags ^= pg.DOUBLEBUF if "-fullscreen" in sys.argv: - flags ^= pygame.FULLSCREEN + flags ^= pg.FULLSCREEN if "-sw" in sys.argv: - flags ^= pygame.SWSURFACE + flags ^= pg.SWSURFACE use_rle = True +if "-hw" in sys.argv: + flags ^= pg.HWSURFACE + use_rle = False + if "-scaled" in sys.argv: - flags ^= pygame.SCALED + flags ^= pg.SCALED screen_dims = [640, 480] @@ -65,20 +70,37 @@ if "-width" in sys.argv: i = sys.argv.index("-width") screen_dims[0] = int(sys.argv[i + 1]) -if "-alpha" in sys.argv: - use_alpha = True -else: - use_alpha = False +use_alpha = "-alpha" in sys.argv print(screen_dims) -class Thingy(pygame.sprite.DirtySprite): - images = None +##class Thingy(pg.sprite.Sprite): +## images = None +## def __init__(self): +## pg.sprite.Sprite.__init__(self) +## self.image = Thingy.images[0] +## self.rect = self.image.get_rect() +## self.rect.x = randint(0, screen_dims[0]) +## self.rect.y = randint(0, screen_dims[1]) +## #self.vel = [randint(-10, 10), randint(-10, 10)] +## self.vel = [randint(-1, 1), randint(-1, 1)] +## +## def move(self): +## for i in [0, 1]: +## nv = self.rect[i] + self.vel[i] +## if nv >= screen_dims[i] or nv < 0: +## self.vel[i] = -self.vel[i] +## nv = self.rect[i] + self.vel[i] +## self.rect[i] = nv + + +class Thingy(pg.sprite.DirtySprite): + images: List[pg.Surface] = [] def __init__(self): - ## pygame.sprite.Sprite.__init__(self) - pygame.sprite.DirtySprite.__init__(self) + ## pg.sprite.Sprite.__init__(self) + pg.sprite.DirtySprite.__init__(self) self.image = Thingy.images[0] self.rect = self.image.get_rect() self.rect.x = randint(0, screen_dims[0]) @@ -87,7 +109,7 @@ class Thingy(pygame.sprite.DirtySprite): self.vel = [randint(-1, 1), randint(-1, 1)] self.dirty = 2 - def update(self): + def update(self, *args, **kwargs): for i in [0, 1]: nv = self.rect[i] + self.vel[i] if nv >= screen_dims[i] or nv < 0: @@ -96,22 +118,22 @@ class Thingy(pygame.sprite.DirtySprite): self.rect[i] = nv -class Static(pygame.sprite.DirtySprite): - images = None +class Static(pg.sprite.DirtySprite): + images: List[pg.Surface] = [] def __init__(self): - pygame.sprite.DirtySprite.__init__(self) + pg.sprite.DirtySprite.__init__(self) self.image = Static.images[0] self.rect = self.image.get_rect() - self.rect.x = randint(0, int(3 * screen_dims[0] / 4)) - self.rect.y = randint(0, int(3 * screen_dims[1] / 4)) + self.rect.x = randint(0, 3 * screen_dims[0] // 4) + self.rect.y = randint(0, 3 * screen_dims[1] // 4) def main( update_rects=True, use_static=False, use_layered_dirty=False, - screen_dims=[640, 480], + screen_dims=(640, 480), use_alpha=False, flags=0, ): @@ -130,35 +152,31 @@ def main( if use_layered_dirty: update_rects = True - pygame.init() # needed to initialise time module for get_ticks() - pygame.display.init() + pg.init() # needed to initialise time module for get_ticks() + pg.display.init() # if "-fast" in sys.argv: - screen = pygame.display.set_mode(screen_dims, flags, vsync="-vsync" in sys.argv) + screen = pg.display.set_mode(screen_dims, flags, vsync="-vsync" in sys.argv) # this is mainly for GP2X, so it can quit. - pygame.joystick.init() - num_joysticks = pygame.joystick.get_count() + pg.joystick.init() + num_joysticks = pg.joystick.get_count() if num_joysticks > 0: - stick = pygame.joystick.Joystick(0) + stick = pg.joystick.Joystick(0) stick.init() # now we will receive events for the joystick screen.fill([0, 0, 0]) - pygame.display.flip() - sprite_surface = pygame.image.load(os.path.join(data_dir, "asprite.bmp")) - sprite_surface2 = pygame.image.load(os.path.join(data_dir, "static.webp")) + pg.display.flip() + sprite_surface = pg.image.load(os.path.join(data_dir, "asprite.bmp")) + sprite_surface2 = pg.image.load(os.path.join(data_dir, "static.png")) if use_rle: - sprite_surface.set_colorkey( - [0xFF, 0xFF, 0xFF], pygame.SRCCOLORKEY | pygame.RLEACCEL - ) - sprite_surface2.set_colorkey( - [0xFF, 0xFF, 0xFF], pygame.SRCCOLORKEY | pygame.RLEACCEL - ) + sprite_surface.set_colorkey([0xFF, 0xFF, 0xFF], pg.SRCCOLORKEY | pg.RLEACCEL) + sprite_surface2.set_colorkey([0xFF, 0xFF, 0xFF], pg.SRCCOLORKEY | pg.RLEACCEL) else: - sprite_surface.set_colorkey([0xFF, 0xFF, 0xFF], pygame.SRCCOLORKEY) - sprite_surface2.set_colorkey([0xFF, 0xFF, 0xFF], pygame.SRCCOLORKEY) + sprite_surface.set_colorkey([0xFF, 0xFF, 0xFF], pg.SRCCOLORKEY) + sprite_surface2.set_colorkey([0xFF, 0xFF, 0xFF], pg.SRCCOLORKEY) if use_alpha: sprite_surface = sprite_surface.convert_alpha() @@ -180,13 +198,13 @@ def main( numsprites = 100 sprites = None if use_layered_dirty: - ## sprites = pygame.sprite.FastRenderGroup() - sprites = pygame.sprite.LayeredDirty() + ## sprites = pg.sprite.FastRenderGroup() + sprites = pg.sprite.LayeredDirty() else: if update_rects: - sprites = pygame.sprite.RenderUpdates() + sprites = pg.sprite.RenderUpdates() else: - sprites = pygame.sprite.Group() + sprites = pg.sprite.Group() for i in range(0, numsprites): if use_static and i % 2 == 0: @@ -196,7 +214,7 @@ def main( frames = 0 start = time() - background = pygame.Surface(screen.get_size()) + background = pg.Surface(screen.get_size()) background = background.convert() background.fill([0, 0, 0]) @@ -214,23 +232,18 @@ def main( rects = sprites.draw(screen) if update_rects: - pygame.display.update(rects) + pg.display.update(rects) else: - pygame.display.flip() + pg.display.flip() - for event in pygame.event.get(): - if event.type in [ - pygame.QUIT, - pygame.KEYDOWN, - pygame.QUIT, - pygame.JOYBUTTONDOWN, - ]: + for event in pg.event.get(): + if event.type in [pg.QUIT, pg.KEYDOWN, pg.QUIT, pg.JOYBUTTONDOWN]: going = False frames += 1 end = time() print(f"FPS: {frames / (end - start):f}") - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/textinput.py b/.venv/lib/python3.14/site-packages/pygame/examples/textinput.py index fcf891d..8852a8f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/textinput.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/textinput.py @@ -1,15 +1,17 @@ #!/usr/bin/env python -"""pygame.examples.textinput +""" pg.examples.textinput A little "console" where you can write in text. Shows how to use the TEXTEDITING and TEXTINPUT events. """ - -import os import sys +import os +from typing import List import pygame +import pygame as pg +import pygame.freetype as freetype # This environment variable is important # If not added the candidate list will not show @@ -23,34 +25,28 @@ class TextInput: # Add font name for each language, # otherwise some text can't be correctly displayed. - FONT_NAMES = [ - "notosanscjktcregular", - "notosansmonocjktcregular", - "notosansregular", - "microsoftjhenghei", - "microsoftyahei", - "msgothic", - "msmincho", - "unifont", - "Arial", - ] + FONT_NAMES = ",".join( + str(x) + for x in [ + "notosanscjktcregular", + "notosansmonocjktcregular", + "notosansregular,", + "microsoftjhengheimicrosoftjhengheiuilight", + "microsoftyaheimicrosoftyaheiuilight", + "msgothicmsuigothicmspgothic", + "msmincho", + "Arial", + ] + ) def __init__( - self, - prompt: str, - pos: tuple[int, int], - screen_dimensions: tuple[int, int], - print_event: bool, - text_color="white", - fps: int = 50, + self, prompt: str, pos, screen_dimensions, print_event: bool, text_color="white" ) -> None: self.prompt = prompt self.print_event = print_event # position of chatlist and chatbox - self.CHAT_LIST_POS = pygame.Rect( - (pos[0], pos[1] + 50), (screen_dimensions[0], 400) - ) - self.CHAT_BOX_POS = pygame.Rect(pos, (screen_dimensions[1], 40)) + self.CHAT_LIST_POS = pg.Rect((pos[0], pos[1] + 50), (screen_dimensions[0], 400)) + self.CHAT_BOX_POS = pg.Rect(pos, (screen_dimensions[1], 40)) self.CHAT_LIST_MAXSIZE = 20 self._ime_editing = False @@ -58,197 +54,123 @@ class TextInput: self._ime_text_pos = 0 self._ime_editing_text = "" self._ime_editing_pos = 0 - self.chat = "" + self.chat_list: List[str] = [] + # Freetype # The font name can be a comma separated list # of font names to search for. - self.font_names = ",".join(self.FONT_NAMES) - self.font = pygame.font.SysFont(self.font_names, 24) - self.font_height = self.font.get_height() - self.font_small = pygame.font.SysFont(self.font_names, 16) + self.font = freetype.SysFont(self.FONT_NAMES, 24) + self.font_small = freetype.SysFont(self.FONT_NAMES, 16) self.text_color = text_color - self.prompt_surf = self.font.render(self.prompt, True, self.text_color) - self.prompt_rect = self.prompt_surf.get_rect(topleft=self.CHAT_BOX_POS.topleft) - - self.fps = fps - self.second_counter = 0 - print("Using font: " + self.font.name) - def update(self, events: list[pygame.Event]) -> None: + def update(self, events) -> None: """ Updates the text input widget """ for event in events: - self.handle_event(event) + if event.type == pg.KEYDOWN: + if self.print_event: + print(event) - self.second_counter += 1 + if self._ime_editing: + if len(self._ime_editing_text) == 0: + self._ime_editing = False + continue - if self.second_counter >= self.fps: - self.second_counter = 0 + if event.key == pg.K_BACKSPACE: + if len(self._ime_text) > 0 and self._ime_text_pos > 0: + self._ime_text = ( + self._ime_text[0 : self._ime_text_pos - 1] + + self._ime_text[self._ime_text_pos :] + ) + self._ime_text_pos = max(0, self._ime_text_pos - 1) - # Check if input fits in chat box - input_size = self.font.size(self._get_ime_text()) - while input_size[0] > self.CHAT_BOX_POS.w - self.prompt_rect.w: - if self._ime_editing_text: - # Don't block. - break - self._ime_text = self._ime_text[:-1] - input_size = self.font.size(self._get_ime_text()) + elif event.key == pg.K_DELETE: + self._ime_text = ( + self._ime_text[0 : self._ime_text_pos] + + self._ime_text[self._ime_text_pos + 1 :] + ) + elif event.key == pg.K_LEFT: + self._ime_text_pos = max(0, self._ime_text_pos - 1) + elif event.key == pg.K_RIGHT: + self._ime_text_pos = min( + len(self._ime_text), self._ime_text_pos + 1 + ) + # Handle ENTER key + elif event.key in [pg.K_RETURN, pg.K_KP_ENTER]: + # Block if we have no text to append + if len(self._ime_text) == 0: + continue - def _clamp_to_text_range(self, num: int): - return min(len(self._ime_text), max(0, num)) + # Append chat list + self.chat_list.append(self._ime_text) + if len(self.chat_list) > self.CHAT_LIST_MAXSIZE: + self.chat_list.pop(0) + self._ime_text = "" + self._ime_text_pos = 0 - def move_cursor_by(self, by: int): - self._ime_text_pos = self._clamp_to_text_range(self._ime_text_pos + by) + elif event.type == pg.TEXTEDITING: + if self.print_event: + print(event) + self._ime_editing = True + self._ime_editing_text = event.text + self._ime_editing_pos = event.start - def replace_chars( - self, - remove_count: int = 0, - to_insert: str = "", - text_after_cursor: bool = False, - ): - """ - Removes given number of characters from the cursor location - and adds an optional string there, then adjusts the cursor location. - """ - loc = self._clamp_to_text_range(remove_count + self._ime_text_pos) - - if remove_count < 0: - self._ime_text = ( - self._ime_text[0:loc] + to_insert + self._ime_text[self._ime_text_pos :] - ) - - if text_after_cursor: - self.move_cursor_by(remove_count) - else: - self.move_cursor_by(remove_count + len(to_insert)) - else: - self._ime_text = ( - self._ime_text[0 : self._ime_text_pos] - + to_insert - + self._ime_text[loc:] - ) - - # Don't move cursor if not inserting text - # after removing the characters in front of the cursor - if not text_after_cursor: - self.move_cursor_by(len(to_insert)) - - def handle_event(self, event: pygame.Event): - """ - Handle an event - """ - if self.print_event: - print(event) - - if event.type == pygame.KEYDOWN: - if self._ime_editing: - if len(self._ime_editing_text) == 0: - self._ime_editing = False - return - - if event.key == pygame.K_BACKSPACE: - self.replace_chars(-1) - - elif event.key == pygame.K_DELETE: - self.replace_chars(1) - - elif event.key == pygame.K_LEFT: - self.move_cursor_by(-1) - - elif event.key == pygame.K_RIGHT: - self.move_cursor_by(1) - - # Handle ENTER key - elif event.key in (pygame.K_RETURN, pygame.K_KP_ENTER): - # Block if we have no text to append - if len(self._ime_text) == 0: - return - - # Add to chat log - self.chat += self._ime_text + "\n" - - chat_lines = self.chat.split("\n") - if len(chat_lines) > self.CHAT_LIST_MAXSIZE: - chat_lines.pop(0) - self.chat = "\n".join(chat_lines) - - self._ime_text = "" - self._ime_text_pos = 0 - - elif event.type == pygame.TEXTEDITING: - self._ime_editing = True - self._ime_editing_text = event.text - self._ime_editing_pos = event.start - - elif event.type == pygame.TEXTINPUT: - self._ime_editing = False - self._ime_editing_text = "" - self.replace_chars(to_insert=event.text) - - def _get_ime_text(self): - """ - Returns text that is currently in input. - """ - if self._ime_editing_text: - return ( - f"{self._ime_text[0 : self._ime_text_pos]}" - f"[{self._ime_editing_text}]" - f"{self._ime_text[self._ime_text_pos :]}" - ) - return ( - f"{self._ime_text[0 : self._ime_text_pos]}" - f"{self._ime_text[self._ime_text_pos :]}" - ) + elif event.type == pg.TEXTINPUT: + if self.print_event: + print(event) + self._ime_editing = False + self._ime_editing_text = "" + self._ime_text = ( + self._ime_text[0 : self._ime_text_pos] + + event.text + + self._ime_text[self._ime_text_pos :] + ) + self._ime_text_pos += len(event.text) def draw(self, screen: pygame.Surface) -> None: """ Draws the text input widget onto the provided surface """ - chat_list_surf = self.font_small.render( - self.chat, True, self.text_color, wraplength=self.CHAT_LIST_POS.width - ) - - screen.blit(chat_list_surf, self.CHAT_LIST_POS) + # Chat List updates + chat_height = self.CHAT_LIST_POS.height / self.CHAT_LIST_MAXSIZE + for i, chat in enumerate(self.chat_list): + self.font_small.render_to( + screen, + (self.CHAT_LIST_POS.x, self.CHAT_LIST_POS.y + i * chat_height), + chat, + self.text_color, + ) # Chat box updates - cursor_loc = self._ime_text_pos + self._ime_editing_pos - ime_text = self._get_ime_text() - - text_surf = self.font.render( - ime_text, True, self.text_color, wraplength=self.CHAT_BOX_POS.width + start_pos = self.CHAT_BOX_POS.copy() + ime_text_l = self.prompt + self._ime_text[0 : self._ime_text_pos] + ime_text_m = ( + self._ime_editing_text[0 : self._ime_editing_pos] + + "|" + + self._ime_editing_text[self._ime_editing_pos :] ) + ime_text_r = self._ime_text[self._ime_text_pos :] - text_rect = text_surf.get_rect(topleft=self.prompt_rect.topright) - screen.blit(self.prompt_surf, self.prompt_rect) - screen.blit(text_surf, text_rect) + rect_text_l = self.font.render_to( + screen, start_pos, ime_text_l, self.text_color + ) + start_pos.x += rect_text_l.width - # Show blinking cursor, blink twice a second. - if self.second_counter * 2 < self.fps: - # Characters can have different widths, - # so calculating the correct location for the cursor is required. - metrics = self.font.metrics(ime_text) - x_location = 0 - - index = 0 - for metric in metrics: - if metric is None: - continue - - _, _, _, _, x_advance = metric - - if index >= cursor_loc: - break - x_location += x_advance - index += 1 - - cursor_rect = pygame.Rect( - x_location + text_rect.x, text_rect.y, 2, self.font_height - ) - pygame.draw.rect(screen, self.text_color, cursor_rect) + # Editing texts should be underlined + rect_text_m = self.font.render_to( + screen, + start_pos, + ime_text_m, + self.text_color, + None, + freetype.STYLE_UNDERLINE, + ) + start_pos.x += rect_text_m.width + self.font.render_to(screen, start_pos, ime_text_r, self.text_color) class Game: @@ -265,10 +187,10 @@ class Game: def __init__(self, caption: str) -> None: # Initialize - pygame.init() - self.screen = pygame.display.set_mode((self.SCREEN_WIDTH, self.SCREEN_HEIGHT)) - pygame.display.set_caption(caption) - self.clock = pygame.Clock() + pg.init() + self.screen = pg.display.set_mode((self.SCREEN_WIDTH, self.SCREEN_HEIGHT)) + pg.display.set_caption(caption) + self.clock = pg.time.Clock() # Text input # Set to true or add 'showevent' in argv to see IME and KEYDOWN events @@ -279,19 +201,18 @@ class Game: screen_dimensions=(self.SCREEN_WIDTH, self.SCREEN_HEIGHT), print_event=self.print_event, text_color="green", - fps=self.FPS, ) def main_loop(self) -> None: - pygame.key.start_text_input() - input_rect = pygame.Rect(80, 80, 320, 40) - pygame.key.set_text_input_rect(input_rect) + pg.key.start_text_input() + input_rect = pg.Rect(80, 80, 320, 40) + pg.key.set_text_input_rect(input_rect) while True: - events = pygame.event.get() + events = pg.event.get() for event in events: - if event.type == pygame.QUIT: - pygame.quit() + if event.type == pg.QUIT: + pg.quit() return self.text_input.update(events) @@ -300,7 +221,7 @@ class Game: self.screen.fill(self.BG_COLOR) self.text_input.draw(self.screen) - pygame.display.update() + pg.display.update() self.clock.tick(self.FPS) diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/vgrade.py b/.venv/lib/python3.14/site-packages/pygame/examples/vgrade.py index 3b8cf6b..06202c2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/vgrade.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/vgrade.py @@ -1,12 +1,12 @@ #!/usr/bin/env python -"""pygame.examples.vgrade +""" pg.examples.vgrade This example demonstrates creating an image with numpy python, and displaying that through SDL. You can look at the -method of importing numpy and pygame.surfarray. This method +method of importing numpy and pg.surfarray. This method will fail 'gracefully' if it is not available. I've tried mixing in a lot of comments where the code might -not be self-explanatory, nonetheless it may still seem a bit +not be self explanatory, nonetheless it may still seem a bit strange. Learning to use numpy for images like this takes a bit of learning, but the payoff is extremely fast image manipulation in python. @@ -26,9 +26,9 @@ The window will have no border decorations. The code also demonstrates use of the timer events. """ -import os -import pygame +import os +import pygame as pg try: import numpy as np @@ -40,19 +40,19 @@ timer = 0 def stopwatch(message=None): - """simple routine to time python code""" + "simple routine to time python code" global timer if not message: - timer = pygame.time.get_ticks() + timer = pg.time.get_ticks() return - now = pygame.time.get_ticks() + now = pg.time.get_ticks() runtime = (now - timer) / 1000.0 + 0.001 print(f"{message} {runtime} seconds\t{(1.0 / runtime):.2f}fps") timer = now -def vert_gradient_column(surf, topcolor, bottomcolor): - """creates a new 3d vertical gradient array""" +def VertGradientColumn(surf, topcolor, bottomcolor): + "creates a new 3d vertical gradient array" topcolor = np.array(topcolor, copy=False) bottomcolor = np.array(bottomcolor, copy=False) diff = bottomcolor - topcolor @@ -65,39 +65,37 @@ def vert_gradient_column(surf, topcolor, bottomcolor): # make the column a 3d image column by adding X column = column.astype("uint8")[np.newaxis, :, :] # 3d array into 2d array - return pygame.surfarray.map_array(surf, column) + return pg.surfarray.map_array(surf, column) -def display_gradient(surf): - """choose random colors and show them""" +def DisplayGradient(surf): + "choose random colors and show them" stopwatch() colors = np_random.randint(0, 255, (2, 3)) - column = vert_gradient_column(surf, colors[0], colors[1]) - pygame.surfarray.blit_array(surf, column) - pygame.display.flip() + column = VertGradientColumn(surf, colors[0], colors[1]) + pg.surfarray.blit_array(surf, column) + pg.display.flip() stopwatch("Gradient:") def main(): - pygame.init() - pygame.mixer.quit() # remove ALSA underflow messages for Debian squeeze + pg.init() + pg.mixer.quit() # remove ALSA underflow messages for Debian squeeze size = 600, 400 os.environ["SDL_VIDEO_CENTERED"] = "1" - screen = pygame.display.set_mode(size, pygame.NOFRAME) + screen = pg.display.set_mode(size, pg.NOFRAME, 0) - pygame.event.set_blocked(pygame.MOUSEMOTION) # keep our queue cleaner - - TIMER_EVENT = pygame.event.custom_type() - pygame.time.set_timer(TIMER_EVENT, 500) + pg.event.set_blocked(pg.MOUSEMOTION) # keep our queue cleaner + pg.time.set_timer(pg.USEREVENT, 500) while True: - event = pygame.event.wait() - if event.type in (pygame.QUIT, pygame.KEYDOWN, pygame.MOUSEBUTTONDOWN): + event = pg.event.wait() + if event.type in (pg.QUIT, pg.KEYDOWN, pg.MOUSEBUTTONDOWN): break - elif event.type == TIMER_EVENT: - display_gradient(screen) + elif event.type == pg.USEREVENT: + DisplayGradient(screen) - pygame.quit() + pg.quit() if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/video.py b/.venv/lib/python3.14/site-packages/pygame/examples/video.py index f867c8a..7104f47 100644 --- a/.venv/lib/python3.14/site-packages/pygame/examples/video.py +++ b/.venv/lib/python3.14/site-packages/pygame/examples/video.py @@ -1,5 +1,5 @@ #!/usr/bin/env python -"""pygame.examples.video +""" pg.examples.video Experimental! @@ -9,155 +9,150 @@ Experimental! * Renderer, Texture, and Image classes * Drawing lines, rects, and such onto Renderers. """ - import os - -import pygame -from pygame._sdl2 import Image, Renderer, Texture, Window, get_drivers +import pygame as pg +from pygame._sdl2 import Window, Texture, Image, Renderer, get_drivers, messagebox data_dir = os.path.join(os.path.split(os.path.abspath(__file__))[0], "data") def load_img(file): - return pygame.image.load(os.path.join(data_dir, file)) + return pg.image.load(os.path.join(data_dir, file)) -def main(): - pygame.display.init() - pygame.key.set_repeat(1000, 10) +pg.display.init() +pg.key.set_repeat(1000, 10) - for driver in get_drivers(): - print(driver) +for driver in get_drivers(): + print(driver) - import random +import random - answer = pygame.display.message_box( +try: + answer = messagebox( "I will open two windows! Continue?", "Hello!", - message_type="info", + info=True, buttons=("Yes", "No", "Chance"), return_button=0, escape_button=1, ) - if answer == 1 or (answer == 2 and random.random() < 0.5): import sys sys.exit(0) +except: + pass - win = Window("asdf", resizable=True) - renderer = Renderer(win) - tex = Texture.from_surface(renderer, load_img("alien1.gif")) +win = Window("asdf", resizable=True) +renderer = Renderer(win) +tex = Texture.from_surface(renderer, load_img("alien1.gif")) +img = Image(tex) - running = True +running = True - x, y = 250, 50 - clock = pygame.Clock() +x, y = 250, 50 +clock = pg.time.Clock() - backgrounds = [(255, 0, 0, 255), (0, 255, 0, 255), (0, 0, 255, 255)] - bg_index = 0 +backgrounds = [(255, 0, 0, 255), (0, 255, 0, 255), (0, 0, 255, 255)] +bg_index = 0 +renderer.draw_color = backgrounds[bg_index] + +win2 = Window("2nd window", size=(256, 256), always_on_top=True) +win2.opacity = 0.5 +win2.set_icon(load_img("bomb.gif")) +renderer2 = Renderer(win2) +tex2 = Texture.from_surface(renderer2, load_img("asprite.bmp")) +renderer2.clear() +tex2.draw() +renderer2.present() +del tex2 + +full = 0 + +surf = pg.Surface((64, 64)) +streamtex = Texture(renderer, (64, 64), streaming=True) +tex_update_interval = 1000 +next_tex_update = pg.time.get_ticks() + + +while running: + for event in pg.event.get(): + if event.type == pg.QUIT: + running = False + elif getattr(event, "window", None) == win2: + if ( + event.type == pg.KEYDOWN + and event.key == pg.K_ESCAPE + or event.type == pg.WINDOWCLOSE + ): + win2.destroy() + elif event.type == pg.KEYDOWN: + if event.key == pg.K_ESCAPE: + running = False + elif event.key == pg.K_LEFT: + x -= 5 + elif event.key == pg.K_RIGHT: + x += 5 + elif event.key == pg.K_DOWN: + y += 5 + elif event.key == pg.K_UP: + y -= 5 + elif event.key == pg.K_f: + if full == 0: + win.set_fullscreen(True) + full = 1 + else: + win.set_windowed() + full = 0 + elif event.key == pg.K_s: + readsurf = renderer.to_surface() + pg.image.save(readsurf, "test.png") + + elif event.key == pg.K_SPACE: + bg_index = (bg_index + 1) % len(backgrounds) + renderer.draw_color = backgrounds[bg_index] + + renderer.clear() + + # update texture + curtime = pg.time.get_ticks() + if curtime >= next_tex_update: + for x_ in range(streamtex.width // 4): + for y_ in range(streamtex.height // 4): + newcol = ( + random.randint(0, 255), + random.randint(0, 255), + random.randint(0, 255), + 255, + ) + area = (4 * x_, 4 * y_, 4, 4) + surf.fill(newcol, area) + streamtex.update(surf) + next_tex_update = curtime + tex_update_interval + streamtex.draw(dstrect=pg.Rect(64, 128, 64, 64)) + + img.draw(dstrect=(x, y)) + + # TODO: should these be? + # - line instead of draw_line + # - point instead of draw_point + # - rect(rect, width=1)->draw 1 pixel, instead of draw_rect + # - rect(rect, width=0)->filled ? , instead of fill_rect + # + # TODO: should these work with pg.draw.line(renderer, ...) functions? + renderer.draw_color = (255, 255, 255, 255) + renderer.draw_line((0, 0), (64, 64)) + renderer.draw_line((64, 64), (128, 0)) + renderer.draw_point((72, 32)) + renderer.draw_rect(pg.Rect(0, 64, 64, 64)) + renderer.fill_rect(pg.Rect(0, 128, 64, 64)) renderer.draw_color = backgrounds[bg_index] - win2 = Window("2nd window", size=(256, 256), always_on_top=True) - win2.opacity = 0.5 - win2.set_icon(load_img("bomb.gif")) - renderer2 = Renderer(win2) - tex2 = Texture.from_surface(renderer2, load_img("asprite.bmp")) - renderer2.clear() - tex2.draw() - renderer2.present() - del tex2 + renderer.present() - full = 0 + clock.tick(60) + win.title = str(f"FPS: {clock.get_fps()}") - tex = Image(tex) - - surf = pygame.Surface((64, 64)) - streamtex = Texture(renderer, (64, 64), streaming=True) - tex_update_interval = 1000 - next_tex_update = pygame.time.get_ticks() - - while running: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - running = False - elif getattr(event, "window", None) == win2: - if ( - event.type == pygame.KEYDOWN - and event.key == pygame.K_ESCAPE - or event.type == pygame.WINDOWCLOSE - ): - win2.destroy() - elif event.type == pygame.KEYDOWN: - if event.key == pygame.K_ESCAPE: - running = False - elif event.key == pygame.K_LEFT: - x -= 5 - elif event.key == pygame.K_RIGHT: - x += 5 - elif event.key == pygame.K_DOWN: - y += 5 - elif event.key == pygame.K_UP: - y -= 5 - elif event.key == pygame.K_f: - if full == 0: - win.set_fullscreen(True) - full = 1 - else: - win.set_windowed() - full = 0 - elif event.key == pygame.K_s: - readsurf = renderer.to_surface() - pygame.image.save(readsurf, "test.png") - - elif event.key == pygame.K_SPACE: - bg_index = (bg_index + 1) % len(backgrounds) - renderer.draw_color = backgrounds[bg_index] - - renderer.clear() - - # update texture - curtime = pygame.time.get_ticks() - if curtime >= next_tex_update: - for x_ in range(streamtex.width // 4): - for y_ in range(streamtex.height // 4): - newcol = ( - random.randint(0, 255), - random.randint(0, 255), - random.randint(0, 255), - 255, - ) - area = (4 * x_, 4 * y_, 4, 4) - surf.fill(newcol, area) - streamtex.update(surf) - next_tex_update = curtime + tex_update_interval - streamtex.draw(dstrect=pygame.Rect(64, 128, 64, 64)) - - tex.draw(dstrect=(x, y)) - - # TODO: should these be? - # - line instead of draw_line - # - point instead of draw_point - # - rect(rect, width=1)->draw 1 pixel, instead of draw_rect - # - rect(rect, width=0)->filled ? , instead of fill_rect - # - # TODO: should these work with pygame.draw.line(renderer, ...) functions? - renderer.draw_color = (255, 255, 255, 255) - renderer.draw_line((0, 0), (64, 64)) - renderer.draw_line((64, 64), (128, 0)) - renderer.draw_point((72, 32)) - renderer.draw_rect(pygame.Rect(0, 64, 64, 64)) - renderer.fill_rect(pygame.Rect(0, 128, 64, 64)) - renderer.draw_color = backgrounds[bg_index] - - renderer.present() - - clock.tick(60) - win.title = str(f"FPS: {clock.get_fps()}") - - pygame.quit() - - -if __name__ == "__main__": - main() +pg.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/examples/window_opengl.py b/.venv/lib/python3.14/site-packages/pygame/examples/window_opengl.py deleted file mode 100644 index 253e5de..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/examples/window_opengl.py +++ /dev/null @@ -1,82 +0,0 @@ -"""pygame.examples.window_opengl - -Slightly modified version of the example at https://github.com/szabolcsdombi/zengl/blob/main/examples/pygame/hello_world.py -Modified to use Window API instead of the display module - -Posted here with permission from https://github.com/szabolcsdombi given in the PGC discord server -""" - -import pygame -import zengl - - -def main(): - window_size = (1280, 720) - - pygame.init() - window = pygame.Window(size=window_size, opengl=True) - - ctx = zengl.context() - - image = ctx.image(window_size, "rgba8unorm", samples=4) - - pipeline = ctx.pipeline( - vertex_shader=""" - #version 330 core - - out vec3 v_color; - - vec2 vertices[3] = vec2[]( - vec2(0.0, 0.8), - vec2(-0.6, -0.8), - vec2(0.6, -0.8) - ); - - vec3 colors[3] = vec3[]( - vec3(1.0, 0.0, 0.0), - vec3(0.0, 1.0, 0.0), - vec3(0.0, 0.0, 1.0) - ); - - void main() { - gl_Position = vec4(vertices[gl_VertexID], 0.0, 1.0); - v_color = colors[gl_VertexID]; - } - """, - fragment_shader=""" - #version 330 core - - in vec3 v_color; - - layout (location = 0) out vec4 out_color; - - void main() { - out_color = vec4(v_color, 1.0); - out_color.rgb = pow(out_color.rgb, vec3(1.0 / 2.2)); - } - """, - framebuffer=[image], - topology="triangles", - vertex_count=3, - ) - - clock = pygame.Clock() - - while True: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - pygame.quit() - quit() - - ctx.new_frame() - image.clear() - pipeline.render() - image.blit() - ctx.end_frame() - - window.flip() - clock.tick(60) - - -if __name__ == "__main__": - main() diff --git a/.venv/lib/python3.14/site-packages/pygame/font.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/font.cpython-314-x86_64-linux-gnu.so index 4190296..2288086 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/font.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/font.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/font.pyi b/.venv/lib/python3.14/site-packages/pygame/font.pyi index 9480f5d..c49cd89 100644 --- a/.venv/lib/python3.14/site-packages/pygame/font.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/font.pyi @@ -1,9 +1,8 @@ -from collections.abc import Callable, Hashable, Iterable -from typing import Literal +from typing import Callable, Hashable, Iterable, List, Optional, Tuple, Union from pygame.surface import Surface -from pygame.typing import ColorLike, FileLike -from typing_extensions import deprecated # added in 3.13 + +from ._common import ColorValue, FileArg, Literal # TODO: Figure out a way to type this attribute such that mypy knows it's not # always defined at runtime @@ -12,338 +11,51 @@ UCS4: Literal[1] def init() -> None: ... def quit() -> None: ... def get_init() -> bool: ... -def get_sdl_ttf_version(linked: bool = True) -> tuple[int, int, int]: - """ - Gets SDL_ttf version. - - Returns a tuple of integers that identify SDL_ttf's version, - ``(major, minor, patch)``. SDL_ttf is the underlying font rendering library, - written in C, on which pygame's font module depends. If 'linked' is True - (the default), the function returns the version of the linked TTF library. - Otherwise this function returns the version of TTF pygame was compiled with. - - .. versionadded:: 2.1.3 - """ - -def get_default_font() -> str: - """ - Get the filename of the default font. - - Return the filename of the system font. This is not the full path to the - file. This file can usually be found in the same directory as the font - module, but it can also be bundled in separate archives. - """ - -def get_fonts() -> list[str]: - """Get all available fonts. - - Returns a list of all the fonts available on the system. The names of the - fonts will be set to lowercase with all spaces and punctuation removed. This - works on most systems, but some will return an empty list if they cannot - find fonts. - - .. versionchanged:: 2.1.3 Checks through user fonts instead of just global fonts for Windows. - """ - +def get_sdl_ttf_version(linked: bool = True) -> Tuple[int, int, int]: ... +def get_default_font() -> str: ... +def get_fonts() -> List[str]: ... def match_font( - name: str | bytes | Iterable[str | bytes], + name: Union[str, bytes, Iterable[Union[str, bytes]]], bold: Hashable = False, italic: Hashable = False, -) -> str | None: - """Find a specific font on the system. - - Returns the full path to a font file on the system. If bold or italic are - set to true, this will attempt to find the correct family of font. - - The font name can also be an iterable of font names, a string of - comma-separated font names, or a bytes of comma-separated font names, in - which case the set of names will be searched in order. - If none of the given names are found, None is returned. - - .. versionaddedold:: 2.0.1 Accept an iterable of font names. - - .. versionchanged:: 2.1.3 Checks through user fonts instead of just global fonts for Windows. - - Example:: - - >>> pygame.font.match_font('Arial') - 'C:\\WINDOWS\\Fonts\\arial.ttf' - """ - +) -> str: ... def SysFont( - name: str | bytes | Iterable[str | bytes] | None, + name: Union[str, bytes, Iterable[Union[str, bytes]], None], size: int, bold: Hashable = False, italic: Hashable = False, - constructor: Callable[[str | None, int, bool, bool], Font] | None = None, + constructor: Optional[Callable[[Optional[str], int, bool, bool], Font]] = None, ) -> Font: ... class Font: - @property - def name(self) -> str: ... - @property - def style_name(self) -> str: ... - @property - def bold(self) -> bool: ... - @bold.setter - def bold(self, value: bool) -> None: ... - @property - def italic(self) -> bool: ... - @italic.setter - def italic(self, value: bool) -> None: ... - @property - def underline(self) -> bool: ... - @underline.setter - def underline(self, value: bool) -> None: ... - @property - def strikethrough(self) -> bool: ... - @strikethrough.setter - def strikethrough(self, value: bool) -> None: ... - @property - def align(self) -> int: ... - @align.setter - def align(self, value: int) -> None: ... - @property - def point_size(self) -> int: ... - @point_size.setter - def point_size(self, value: int) -> None: ... - @property - def outline(self) -> int: ... - @outline.setter - def outline(self, value: int) -> None: ... - def __init__(self, filename: FileLike | None = None, size: int = 20) -> None: ... + bold: bool + italic: bool + underline: bool + strikethrough: bool + def __init__(self, name: Optional[FileArg], size: int) -> None: ... def render( self, - text: str | bytes | None, - antialias: bool, - color: ColorLike, - bgcolor: ColorLike | None = None, - wraplength: int = 0, + text: Union[str, bytes, None], + antialias: bool | Literal[0] | Literal[1], + color: ColorValue, + background: Optional[ColorValue] = None, ) -> Surface: ... - def size(self, text: str | bytes, /) -> tuple[int, int]: - """ - Determine the amount of space needed to render text. - - Returns the dimensions (width, height) needed to render the text. - This can be used to help determine the positioning needed for text - before it is rendered. It can also be used for word wrapping and other - layout effects. - - Be aware that most fonts use kerning which adjusts the widths for - specific letter pairs. For example, the width for "ae" will not always - match the width for "a" + "e". - """ - - def set_underline(self, value: bool, /) -> None: - """ - Control if text is rendered with an underline. - - When enabled, all rendered fonts will include an underline. The underline - is always one pixel thick, regardless of font size. This can be mixed - with the bold, italic and strikethrough modes. - - .. note:: This is the same as the :attr:`underline` attribute. - """ - - def get_underline(self) -> bool: - """ - Check if text will be rendered with an underline. - - Return True when the font underline is enabled. - - .. note:: This is the same as the :attr:`underline` attribute. - """ - - def set_strikethrough(self, value: bool, /) -> None: - """ - Control if text is rendered with a strikethrough. - - When enabled, all rendered fonts will include a strikethrough. The - strikethrough is always one pixel thick, regardless of font size. - This can be mixed with the bold, italic and underline modes. - - .. note:: This is the same as the :attr:`strikethrough` attribute. - - .. versionadded:: 2.1.3 - """ - - def get_strikethrough(self) -> bool: - """ - Check if text will be rendered with a strikethrough. - - Return True when the font strikethrough is enabled. - - .. note:: This is the same as the :attr:`strikethrough` attribute. - - .. versionadded:: 2.1.3 - """ - - def set_bold(self, value: bool, /) -> None: - """ - Enable fake rendering of bold text. - - Enables the bold rendering of text. This is a fake stretching of the font - that doesn't look good on many font types. If possible load the font from - a real bold font file. While bold, the font will have a different width - than when normal. This can be mixed with the italic, underline and - strikethrough modes. - - .. note:: This is the same as the :attr:`bold` attribute. - """ - - def get_bold(self) -> bool: - """ - Check if text will be rendered bold. - - Return True when the font bold rendering mode is enabled. - - .. note:: This is the same as the :attr:`bold` attribute. - """ - - def set_italic(self, value: bool, /) -> None: - """ - Enable fake rendering of italic text. - - Enables fake rendering of italic text. This is a fake skewing of the font - that doesn't look good on many font types. If possible load the font from - a real italic font file. While italic the font will have a different - width than when normal. This can be mixed with the bold, underline and - strikethrough modes. - - .. note:: This is the same as the :attr:`italic` attribute. - """ + def size(self, text: Union[str, bytes]) -> Tuple[int, int]: ... + def set_underline(self, value: bool) -> None: ... + def get_underline(self) -> bool: ... + def set_strikethrough(self, value: bool) -> None: ... + def get_strikethrough(self) -> bool: ... + def set_bold(self, value: bool) -> None: ... + def get_bold(self) -> bool: ... + def set_italic(self, value: bool | Literal[0] | Literal[1]) -> None: ... def metrics( - self, text: str | bytes, / - ) -> list[tuple[int, int, int, int, int] | None]: - """ - Gets the metrics for each character in the passed string. + self, text: Union[str, bytes] + ) -> List[Tuple[int, int, int, int, int]]: ... + def get_italic(self) -> bool: ... + def get_linesize(self) -> int: ... + def get_height(self) -> int: ... + def get_ascent(self) -> int: ... + def get_descent(self) -> int: ... + def set_script(self, script_code: str) -> None: ... - The list contains tuples for each character, which contain the minimum - ``X`` offset, the maximum ``X`` offset, the minimum ``Y`` offset, the - maximum ``Y`` offset and the advance offset (bearing plus width) of the - character. [(minx, maxx, miny, maxy, advance), (minx, maxx, miny, maxy, - advance), ...]. None is entered in the list for each unrecognized - character. - - .. versionchanged:: 2.5.4 This function now supports all unicode codepoints. - Previously, only a subset that was representable in UCS-2 was supported. - """ - - def get_italic(self) -> bool: - """ - Check if the text will be rendered italic. - - Return True when the font italic rendering mode is enabled. - - .. note:: This is the same as the :attr:`italic` attribute. - """ - - def get_linesize(self) -> int: - """ - Get the line space of the font text. - - Return the height in pixels for a line of text with the font. When - rendering multiple lines of text this is the recommended amount of space - between lines. - - See also :meth:`set_linesize`. - """ - - def set_linesize(self, linesize: int, /) -> None: - """ - Set the line space of the font text. - - Set the height in pixels for a line of text with the font. When rendering - multiple lines of text this refers to the amount of space between lines. - The value must be non-negative. - - See also :meth:`get_linesize`. - - .. versionadded:: 2.5.4 - """ - - def get_height(self) -> int: - """ - Get the height of the font. - - Return the height in pixels of the actual rendered text. This is the - average size for each glyph in the font. - """ - - def get_point_size(self) -> int: - """ - Get the point size of the font. - - Returns the point size of the font. Will not be accurate upon - initializing the font object when the font name is initialized - as ``None``. - - .. note:: This is the same as the :attr:`point_size` attribute. - - .. versionadded:: 2.3.1 - """ - - def set_point_size(self, val: int, /) -> None: - """ - Set the point size of the font. - - .. note:: This is the same as the :attr:`point_size` attribute. - - .. versionadded:: 2.3.1 - """ - - def get_ascent(self) -> int: - """ - Get the ascent of the font. - - Return the height in pixels for the font ascent. The ascent is the number - of pixels from the font baseline to the top of the font. - """ - - def get_descent(self) -> int: - """ - Get the descent of the font. - - Return the height in pixels for the font descent. The descent is the - number of pixels from the font baseline to the bottom of the font. - """ - - def set_script(self, script_code: str, /) -> None: - """ - Set the script code for text shaping. - - Sets the script used by HarfBuzz text shaping, taking a 4 character - script code as input. For example, Hindi is written in the Devanagari - script, for which the script code is `"Deva"`. See the full list of - script codes in `ISO 15924 `_. - - This method requires pygame built with SDL_ttf 2.20.0 or above. Otherwise the - method will raise a pygame.error. - - .. versionadded:: 2.1.4 - """ - - def set_direction(self, direction: int) -> None: - """ - Set the script direction for text shaping. - - Sets the font direction for HarfBuzz text rendering, taking in an integer - between 0 and 3 (inclusive) as input. There are convenient constants defined - for use in this method. - - * ``pygame.DIRECTION_LTR`` is for left-to-right text - * ``pygame.DIRECTION_RTL`` is for right-to-left text - * ``pygame.DIRECTION_TTB`` is for top-to-bottom text - * ``pygame.DIRECTION_BTT`` is for bottom-to-top text - - This method requires pygame built with SDL_ttf 2.20.0 or above. Otherwise the - method will raise a pygame.error. - - .. note:: multiline renders with :meth:`render` do not play nicely with top-to-bottom - or bottom-to-top rendering. - - .. versionadded:: 2.1.4 - """ - -@deprecated("Use `Font` instead (FontType is an old alias)") -class FontType(Font): ... +FontType = Font diff --git a/.venv/lib/python3.14/site-packages/pygame/freetype.py b/.venv/lib/python3.14/site-packages/pygame/freetype.py index 146e675..50a63cf 100644 --- a/.venv/lib/python3.14/site-packages/pygame/freetype.py +++ b/.venv/lib/python3.14/site-packages/pygame/freetype.py @@ -1,25 +1,25 @@ """Enhanced Pygame module for loading and rendering computer fonts""" from pygame._freetype import ( - STYLE_DEFAULT, + Font, STYLE_NORMAL, STYLE_OBLIQUE, STYLE_STRONG, STYLE_UNDERLINE, STYLE_WIDE, - Font, + STYLE_DEFAULT, + init, + quit, + get_init, + was_init, get_cache_size, get_default_font, get_default_resolution, get_error, - get_init, get_version, - init, - quit, set_default_resolution, - was_init, ) -from pygame.sysfont import SysFont as _SysFont, get_fonts, match_font +from pygame.sysfont import match_font, get_fonts, SysFont as _SysFont __all__ = [ "Font", @@ -53,7 +53,7 @@ def SysFont(name, size, bold=False, italic=False, constructor=None): the appropriate system font will be selected if available. This will always return a valid Font object, and will - fall back on the builtin pygame font if the given font + fallback on the builtin pygame font if the given font is not found. Name can also be an iterable of font names, a string of diff --git a/.venv/lib/python3.14/site-packages/pygame/freetype.pyi b/.venv/lib/python3.14/site-packages/pygame/freetype.pyi index 63bf254..f097e3b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/freetype.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/freetype.pyi @@ -1,33 +1,31 @@ -from collections.abc import Callable, Iterable -from typing import Any +from typing import Any, Callable, Iterable, List, Optional, Tuple, Union from pygame.color import Color from pygame.rect import Rect from pygame.surface import Surface -from pygame.typing import ColorLike, FileLike, RectLike -from typing_extensions import deprecated # added in 3.13 + +from ._common import ColorValue, FileArg, RectValue def get_error() -> str: ... -def get_version(linked: bool = True) -> tuple[int, int, int]: ... +def get_version(linked: bool = True) -> Tuple[int, int, int]: ... def init(cache_size: int = 64, resolution: int = 72) -> None: ... def quit() -> None: ... def get_init() -> bool: ... -@deprecated("Use `pygame.freetype.get_init` instead") def was_init() -> bool: ... def get_cache_size() -> int: ... def get_default_resolution() -> int: ... -def set_default_resolution(resolution: int = 0, /) -> None: ... +def set_default_resolution(resolution: int) -> None: ... def SysFont( - name: str | bytes | Iterable[str | bytes] | None, + name: Union[str, bytes, Iterable[Union[str, bytes]], None], size: int, bold: int = False, italic: int = False, - constructor: Callable[[str | None, int, bool, bool], Font] | None = None, + constructor: Optional[Callable[[Optional[str], int, bool, bool], Font]] = None, ) -> Font: ... def get_default_font() -> str: ... -def get_fonts() -> list[str]: ... +def get_fonts() -> List[str]: ... def match_font( - name: str | bytes | Iterable[str | bytes], + name: Union[str, bytes, Iterable[Union[str, bytes]]], bold: Any = False, italic: Any = False, ) -> str: ... @@ -40,101 +38,36 @@ STYLE_WIDE: int STYLE_DEFAULT: int class Font: - @property - def size(self) -> float | tuple[float, float]: ... - @size.setter - def size(self, value: float | tuple[float, float]) -> None: ... - @property - def style(self) -> int: ... - @style.setter - def style(self, value: int) -> None: ... - @property - def height(self) -> int: ... - @property - def ascender(self) -> int: ... - @property - def descender(self) -> int: ... - @property - def name(self) -> str: ... - @property - def style_name(self) -> str: ... - @property - def path(self) -> str: ... - @property - def scalable(self) -> bool: ... - @property - def fixed_width(self) -> bool: ... - @property - def fixed_sizes(self) -> int: ... - @property - def antialiased(self) -> bool: ... - @antialiased.setter - def antialiased(self, value: bool) -> None: ... - @property - def kerning(self) -> bool: ... - @kerning.setter - def kerning(self, value: bool) -> None: ... - @property - def vertical(self) -> bool: ... - @vertical.setter - def vertical(self, value: bool) -> None: ... - @property - def pad(self) -> bool: ... - @pad.setter - def pad(self, value: bool) -> None: ... - @property - def oblique(self) -> bool: ... - @oblique.setter - def oblique(self, value: bool) -> None: ... - @property - def strong(self) -> bool: ... - @strong.setter - def strong(self, value: bool) -> None: ... - @property - def underline(self) -> bool: ... - @underline.setter - def underline(self, value: bool) -> None: ... - @property - def wide(self) -> bool: ... - @wide.setter - def wide(self, value: bool) -> None: ... - @property - def strength(self) -> float: ... - @strength.setter - def strength(self, value: float) -> None: ... - @property - def underline_adjustment(self) -> float: ... - @underline_adjustment.setter - def underline_adjustment(self, value: float) -> None: ... - @property - def ucs4(self) -> bool: ... - @ucs4.setter - def ucs4(self, value: bool) -> None: ... - @property - def use_bitmap_strikes(self) -> bool: ... - @use_bitmap_strikes.setter - def use_bitmap_strikes(self, value: bool) -> None: ... - @property - def resolution(self) -> int: ... - @property - def rotation(self) -> int: ... - @rotation.setter - def rotation(self, value: int) -> None: ... - @property - def fgcolor(self) -> Color: ... - @fgcolor.setter - def fgcolor(self, value: ColorLike) -> None: ... - @property - def bgcolor(self) -> Color: ... - @bgcolor.setter - def bgcolor(self, value: ColorLike) -> None: ... - @property - def origin(self) -> bool: ... - @origin.setter - def origin(self, value: bool) -> None: ... + name: str + path: str + size: Union[float, Tuple[float, float]] + height: int + ascender: int + descender: int + style: int + underline: bool + strong: bool + oblique: bool + wide: bool + strength: float + underline_adjustment: float + fixed_width: bool + fixed_sizes: int + scalable: bool + use_bitmap_strikes: bool + antialiased: bool + kerning: bool + vertical: bool + rotation: int + fgcolor: Color + bgcolor: Color + origin: bool + pad: bool + ucs4: bool + resolution: int def __init__( self, - file: FileLike | None, + file: Optional[FileArg], size: float = 0, font_index: int = 0, resolution: int = 0, @@ -142,77 +75,54 @@ class Font: ) -> None: ... def get_rect( self, - text: str | None, + text: str, style: int = STYLE_DEFAULT, rotation: int = 0, size: float = 0, ) -> Rect: ... def get_metrics( self, text: str, size: float = 0 - ) -> list[tuple[int, int, int, int, float, float]]: ... - def get_sized_ascender(self, size: float, /) -> int: ... - def get_sized_descender(self, size: float, /) -> int: ... - def get_sized_height(self, size: float, /) -> int: ... - def get_sized_glyph_height(self, size: float, /) -> int: ... - def get_sizes(self) -> list[tuple[int, int, int, float, float]]: ... + ) -> List[Tuple[int, int, int, int, float, float]]: ... + def get_sized_ascender(self, size: float) -> int: ... + def get_sized_descender(self, size: float) -> int: ... + def get_sized_height(self, size: float) -> int: ... + def get_sized_glyph_height(self, size: float) -> int: ... + def get_sizes(self) -> List[Tuple[int, int, int, float, float]]: ... def render( self, - text: str | None, - fgcolor: ColorLike | None = None, - bgcolor: ColorLike | None = None, + text: str, + fgcolor: Optional[ColorValue] = None, + bgcolor: Optional[ColorValue] = None, style: int = STYLE_DEFAULT, rotation: int = 0, size: float = 0, - ) -> tuple[Surface, Rect]: ... + ) -> Tuple[Surface, Rect]: ... def render_to( self, surf: Surface, - dest: RectLike, - text: str | None, - fgcolor: ColorLike | None = None, - bgcolor: ColorLike | None = None, + dest: RectValue, + text: str, + fgcolor: Optional[ColorValue] = None, + bgcolor: Optional[ColorValue] = None, style: int = STYLE_DEFAULT, rotation: int = 0, size: float = 0, ) -> Rect: ... def render_raw( self, - text: str | None, + text: str, style: int = STYLE_DEFAULT, rotation: int = 0, size: float = 0, invert: bool = False, - ) -> tuple[bytes, tuple[int, int]]: ... + ) -> Tuple[bytes, Tuple[int, int]]: ... def render_raw_to( self, array: Any, - text: str | None, - dest: RectLike | None = None, + text: str, + dest: Optional[RectValue] = None, style: int = STYLE_DEFAULT, rotation: int = 0, size: float = 0, invert: bool = False, ) -> Rect: ... - -# keep in sync with freetype.py -__all__ = [ - "Font", - "STYLE_NORMAL", - "STYLE_OBLIQUE", - "STYLE_STRONG", - "STYLE_UNDERLINE", - "STYLE_WIDE", - "STYLE_DEFAULT", - "init", - "quit", - "get_init", - "was_init", - "get_cache_size", - "get_default_font", - "get_default_resolution", - "get_error", - "get_version", - "set_default_resolution", - "match_font", - "get_fonts", -] diff --git a/.venv/lib/python3.14/site-packages/pygame/ftfont.py b/.venv/lib/python3.14/site-packages/pygame/ftfont.py index 00041a9..abd55f7 100644 --- a/.venv/lib/python3.14/site-packages/pygame/ftfont.py +++ b/.venv/lib/python3.14/site-packages/pygame/ftfont.py @@ -11,17 +11,11 @@ __all__ = [ "get_fonts", ] -from pygame import draw, encode_file_path -from pygame._freetype import ( - Font as _Font, - _internal_mod_init, - get_default_font, - get_default_resolution, - get_init as _get_init, - init, - quit, -) -from pygame.sysfont import SysFont as _SysFont, get_fonts, match_font +from pygame._freetype import init, Font as _Font, get_default_resolution +from pygame._freetype import quit, get_default_font, get_init as _get_init +from pygame._freetype import _internal_mod_init +from pygame.sysfont import match_font, get_fonts, SysFont as _SysFont +from pygame import encode_file_path class Font(_Font): @@ -40,7 +34,7 @@ class Font(_Font): __unull = "\x00" __bnull = b"\x00" - def __init__(self, file=None, size=20): + def __init__(self, file=None, size=-1): size = max(size, 1) if isinstance(file, str): try: @@ -64,12 +58,8 @@ class Font(_Font): self.pad = True self.ucs4 = True self.underline_adjustment = 1.0 - self.strikethrough = False - lower_style_name = self.style_name.lower() if file is not None else "" - self._bold = "bold" in lower_style_name - self._italic = "italic" in lower_style_name or "slanted" in lower_style_name - def render(self, text, antialias, color, bgcolor=None): + def render(self, text, antialias, color, background=None): """render(text, antialias, color, background=None) -> Surface draw text on a new Surface""" @@ -84,14 +74,7 @@ class Font(_Font): ) self.antialiased = bool(antialias) try: - s, _ = super().render(text, color, bgcolor) - if self.strikethrough: - s_size = s.get_size() - asc = self.get_ascent() - start_pos = (0, asc * 15 // 24) - end_pos = (s_size[0], start_pos[1]) - width = max(s_size[1] // 20, 1) - draw.line(s, color, start_pos, end_pos, width) + s, _ = super().render(text, color, background) return s finally: self.antialiased = save_antialiased @@ -100,14 +83,13 @@ class Font(_Font): """set_bold(bool) -> None enable fake rendering of bold text""" - if not self._bold: - self.wide = bool(value) + self.wide = bool(value) def get_bold(self): """get_bold() -> bool check if text will be rendered bold""" - return self.wide or self._bold + return self.wide bold = property(get_bold, set_bold) @@ -115,14 +97,13 @@ class Font(_Font): """set_italic(bool) -> None enable fake rendering of italic text""" - if not self._italic: - self.oblique = bool(value) + self.oblique = bool(value) def get_italic(self): """get_italic() -> bool check if the text will be rendered italic""" - return self.oblique or self._italic + return self.oblique italic = property(get_italic, set_italic) @@ -138,16 +119,6 @@ class Font(_Font): return self.underline - def set_strikethrough(self, value): - """set_strikethrough(bool) -> None - control if the text is rendered struck through""" - self.strikethrough = value - - def get_strikethrough(self): - """get_strikethrough() -> bool - check if the text will be rendered struck through""" - return self.strikethrough - def metrics(self, text): """metrics(text) -> list Gets the metrics for each character in the passed string.""" @@ -204,7 +175,7 @@ def SysFont(name, size, bold=0, italic=0, constructor=None): the appropriate system font will be selected if available. This will always return a valid Font object, and will - fall back on the builtin pygame font if the given font + fallback on the builtin pygame font if the given font is not found. Name can also be an iterable of font names, a string of diff --git a/.venv/lib/python3.14/site-packages/pygame/geometry.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/geometry.cpython-314-x86_64-linux-gnu.so deleted file mode 100755 index 6f5a04a..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/geometry.cpython-314-x86_64-linux-gnu.so and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/geometry.pyi b/.venv/lib/python3.14/site-packages/pygame/geometry.pyi deleted file mode 100644 index 04c8f7e..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/geometry.pyi +++ /dev/null @@ -1,202 +0,0 @@ -from collections.abc import Callable -from typing import Protocol, TypeAlias, overload - -from pygame import FRect, Rect -from pygame.typing import Point, RectLike, SequenceLike - -class _HasCircleAttribute(Protocol): - # An object that has a circle attribute that is either a circle, or a function - # that returns a circle - @property - def circle(self) -> _CircleLike | Callable[[], _CircleLike]: ... - -_CircleLike: TypeAlias = ( - Circle | tuple[Point, float] | SequenceLike[float] | _HasCircleAttribute -) - -class _HasLineAttribute(Protocol): - # An object that has a line attribute that is either a line, or a function - # that returns a line - @property - def line(self) -> _LineLike | Callable[[], _LineLike]: ... - -_LineLike: TypeAlias = ( - Line | SequenceLike[float] | SequenceLike[Point] | _HasLineAttribute -) - -_CanBeCollided: TypeAlias = Circle | Rect | FRect | Point -_CanBeIntersected: TypeAlias = Circle - -class Circle: - @property - def x(self) -> float: ... - @x.setter - def x(self, value: float) -> None: ... - @property - def y(self) -> float: ... - @y.setter - def y(self, value: float) -> None: ... - @property - def r(self) -> float: ... - @r.setter - def r(self, value: float) -> None: ... - @property - def radius(self) -> float: ... - @radius.setter - def radius(self, value: float) -> None: ... - @property - def r_sqr(self) -> float: ... - @r_sqr.setter - def r_sqr(self, value: float) -> None: ... - @property - def d(self) -> float: ... - @d.setter - def d(self, value: float) -> None: ... - @property - def diameter(self) -> float: ... - @diameter.setter - def diameter(self, value: float) -> None: ... - @property - def area(self) -> float: ... - @area.setter - def area(self, value: float) -> None: ... - @property - def circumference(self) -> float: ... - @circumference.setter - def circumference(self, value: float) -> None: ... - @property - def center(self) -> tuple[float, float]: ... - @center.setter - def center(self, value: Point) -> None: ... - @property - def top(self) -> tuple[float, float]: ... - @top.setter - def top(self, value: Point) -> None: ... - @property - def left(self) -> tuple[float, float]: ... - @left.setter - def left(self, value: Point) -> None: ... - @property - def bottom(self) -> tuple[float, float]: ... - @bottom.setter - def bottom(self, value: Point) -> None: ... - @property - def right(self) -> tuple[float, float]: ... - @right.setter - def right(self, value: Point) -> None: ... - @overload - def __init__(self, x: float, y: float, r: float) -> None: ... - @overload - def __init__(self, pos: Point, r: float) -> None: ... - @overload - def __init__(self, circle: _CircleLike) -> None: ... - @overload - def move(self, x: float, y: float, /) -> Circle: ... - @overload - def move(self, move_by: Point, /) -> Circle: ... - @overload - def move_ip(self, x: float, y: float, /) -> None: ... - @overload - def move_ip(self, move_by: Point, /) -> None: ... - @overload - def collidepoint(self, x: float, y: float, /) -> bool: ... - @overload - def collidepoint(self, point: Point, /) -> bool: ... - @overload - def collidecircle(self, circle: _CircleLike, /) -> bool: ... - @overload - def collidecircle(self, x: float, y: float, r: float, /) -> bool: ... - @overload - def collidecircle(self, center: Point, r: float, /) -> bool: ... - @overload - def colliderect(self, rect: RectLike, /) -> bool: ... - @overload - def colliderect(self, x: float, y: float, w: float, h: float, /) -> bool: ... - @overload - def colliderect(self, topleft: Point, size: Point, /) -> bool: ... - def collideswith(self, other: _CanBeCollided, /) -> bool: ... - def collidelist(self, colliders: SequenceLike[_CanBeCollided], /) -> int: ... - def collidelistall( - self, colliders: SequenceLike[_CanBeCollided], / - ) -> list[int]: ... - def intersect(self, other: _CanBeIntersected, /) -> list[tuple[float, float]]: ... - def contains(self, shape: _CanBeCollided, /) -> bool: ... - @overload - def update(self, circle: _CircleLike, /) -> None: ... - @overload - def update(self, x: float, y: float, r: float, /) -> None: ... - @overload - def update(self, center: Point, r: float, /) -> None: ... - @overload - def rotate(self, angle: float, rotation_point: Point, /) -> Circle: ... - @overload - def rotate(self, angle: float, /) -> Circle: ... - @overload - def rotate_ip(self, angle: float, rotation_point: Point, /) -> None: ... - @overload - def rotate_ip(self, angle: float, /) -> None: ... - def as_rect(self) -> Rect: ... - def as_frect(self) -> FRect: ... - def copy(self) -> Circle: ... - def __copy__(self) -> Circle: ... - -class Line: - @property - def ax(self) -> float: ... - @ax.setter - def ax(self, value: float) -> None: ... - @property - def ay(self) -> float: ... - @ay.setter - def ay(self, value: float) -> None: ... - @property - def bx(self) -> float: ... - @bx.setter - def bx(self, value: float) -> None: ... - @property - def by(self) -> float: ... - @by.setter - def by(self, value: float) -> None: ... - @property - def a(self) -> tuple[float, float]: ... - @a.setter - def a(self, value: Point) -> None: ... - @property - def b(self) -> tuple[float, float]: ... - @b.setter - def b(self, value: Point) -> None: ... - @property - def length(self) -> float: ... - @overload - def __init__(self, ax: float, ay: float, bx: float, by: float) -> None: ... - @overload - def __init__(self, a: Point, b: Point) -> None: ... - @overload - def __init__(self, line: _LineLike) -> None: ... - def __copy__(self) -> Line: ... - def copy(self) -> Line: ... - @overload - def update(self, ax: float, ay: float, bx: float, by: float, /) -> None: ... - @overload - def update(self, a: Point, b: Point, /) -> None: ... - @overload - def update(self, line: _LineLike, /) -> None: ... - @overload - def move(self, x: float, y: float, /) -> Line: ... - @overload - def move(self, move_by: Point, /) -> Line: ... - @overload - def move_ip(self, x: float, y: float, /) -> None: ... - @overload - def move_ip(self, move_by: Point, /) -> None: ... - @overload - def scale(self, factor: float, origin: float, /) -> Line: ... - @overload - def scale(self, factor_and_origin: Point, /) -> Line: ... - @overload - def scale_ip(self, factor: float, origin: float, /) -> None: ... - @overload - def scale_ip(self, factor_and_origin: Point, /) -> None: ... - def flip_ab(self) -> Line: ... - def flip_ab_ip(self) -> None: ... - def project(self, point: Point, clamp: bool = False) -> tuple[float, float]: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/gfxdraw.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/gfxdraw.cpython-314-x86_64-linux-gnu.so index df8ed09..2283a2b 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/gfxdraw.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/gfxdraw.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/gfxdraw.pyi b/.venv/lib/python3.14/site-packages/pygame/gfxdraw.pyi index 7434b4b..dca1334 100644 --- a/.venv/lib/python3.14/site-packages/pygame/gfxdraw.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/gfxdraw.pyi @@ -1,27 +1,30 @@ -from pygame.surface import Surface -from pygame.typing import ColorLike, Point, RectLike, SequenceLike +from typing import Sequence -def pixel(surface: Surface, x: int, y: int, color: ColorLike, /) -> None: ... -def hline(surface: Surface, x1: int, x2: int, y: int, color: ColorLike, /) -> None: ... -def vline(surface: Surface, x: int, y1: int, y2: int, color: ColorLike, /) -> None: ... +from pygame.surface import Surface + +from ._common import ColorValue, Coordinate, RectValue + +def pixel(surface: Surface, x: int, y: int, color: ColorValue) -> None: ... +def hline(surface: Surface, x1: int, x2: int, y: int, color: ColorValue) -> None: ... +def vline(surface: Surface, x: int, y1: int, y2: int, color: ColorValue) -> None: ... def line( - surface: Surface, x1: int, y1: int, x2: int, y2: int, color: ColorLike, / + surface: Surface, x1: int, y1: int, x2: int, y2: int, color: ColorValue ) -> None: ... -def rectangle(surface: Surface, rect: RectLike, color: ColorLike, /) -> None: ... -def box(surface: Surface, rect: RectLike, color: ColorLike, /) -> None: ... -def circle(surface: Surface, x: int, y: int, r: int, color: ColorLike, /) -> None: ... -def aacircle(surface: Surface, x: int, y: int, r: int, color: ColorLike, /) -> None: ... +def rectangle(surface: Surface, rect: RectValue, color: ColorValue) -> None: ... +def box(surface: Surface, rect: RectValue, color: ColorValue) -> None: ... +def circle(surface: Surface, x: int, y: int, r: int, color: ColorValue) -> None: ... +def aacircle(surface: Surface, x: int, y: int, r: int, color: ColorValue) -> None: ... def filled_circle( - surface: Surface, x: int, y: int, r: int, color: ColorLike, / + surface: Surface, x: int, y: int, r: int, color: ColorValue ) -> None: ... def ellipse( - surface: Surface, x: int, y: int, rx: int, ry: int, color: ColorLike, / + surface: Surface, x: int, y: int, rx: int, ry: int, color: ColorValue ) -> None: ... def aaellipse( - surface: Surface, x: int, y: int, rx: int, ry: int, color: ColorLike, / + surface: Surface, x: int, y: int, rx: int, ry: int, color: ColorValue ) -> None: ... def filled_ellipse( - surface: Surface, x: int, y: int, rx: int, ry: int, color: ColorLike, / + surface: Surface, x: int, y: int, rx: int, ry: int, color: ColorValue ) -> None: ... def arc( surface: Surface, @@ -30,8 +33,7 @@ def arc( r: int, start_angle: int, atp_angle: int, - color: ColorLike, - /, + color: ColorValue, ) -> None: ... def pie( surface: Surface, @@ -40,8 +42,7 @@ def pie( r: int, start_angle: int, atp_angle: int, - color: ColorLike, - /, + color: ColorValue, ) -> None: ... def trigon( surface: Surface, @@ -51,8 +52,7 @@ def trigon( y2: int, x3: int, y3: int, - color: ColorLike, - /, + color: ColorValue, ) -> None: ... def aatrigon( surface: Surface, @@ -62,8 +62,7 @@ def aatrigon( y2: int, x3: int, y3: int, - color: ColorLike, - /, + color: ColorValue, ) -> None: ... def filled_trigon( surface: Surface, @@ -73,21 +72,20 @@ def filled_trigon( y2: int, x3: int, y3: int, - color: ColorLike, - /, + color: ColorValue, ) -> None: ... def polygon( - surface: Surface, points: SequenceLike[Point], color: ColorLike, / + surface: Surface, points: Sequence[Coordinate], color: ColorValue ) -> None: ... def aapolygon( - surface: Surface, points: SequenceLike[Point], color: ColorLike, / + surface: Surface, points: Sequence[Coordinate], color: ColorValue ) -> None: ... def filled_polygon( - surface: Surface, points: SequenceLike[Point], color: ColorLike, / + surface: Surface, points: Sequence[Coordinate], color: ColorValue ) -> None: ... def textured_polygon( - surface: Surface, points: SequenceLike[Point], texture: Surface, tx: int, ty: int, / + surface: Surface, points: Sequence[Coordinate], texture: Surface, tx: int, ty: int ) -> None: ... def bezier( - surface: Surface, points: SequenceLike[Point], steps: int, color: ColorLike, / + surface: Surface, points: Sequence[Coordinate], steps: int, color: ColorValue ) -> None: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/image.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/image.cpython-314-x86_64-linux-gnu.so index 17f23fa..a3b30d9 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/image.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/image.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/image.pyi b/.venv/lib/python3.14/site-packages/pygame/image.pyi index c7d9a19..69e90cd 100644 --- a/.venv/lib/python3.14/site-packages/pygame/image.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/image.pyi @@ -1,429 +1,45 @@ -"""Pygame module for image transfer. - -The image module contains functions for loading and saving pictures, as well as -transferring Surfaces to formats usable by other packages. - -Note that there is no Image class; an image is loaded as a Surface object. The -Surface class allows manipulation (drawing lines, setting pixels, capturing -regions, etc.). - -In the vast majority of installations, pygame is built to support extended -formats, using the SDL_Image library behind the scenes. However, some -installations may only support uncompressed ``BMP`` images. With full image -support, the :func:`pygame.image.load()` function can load the following -formats. - - * ``BMP`` - - * ``GIF`` (non-animated) - - * ``JPEG`` - - * ``LBM`` - - * ``PCX`` - - * ``PNG`` - - * ``PNM`` (``PBM``, ``PGM``, ``PPM``) - - * ``QOI`` - - * ``SVG`` (limited support, using Nano SVG) - - * ``TGA`` (uncompressed) - - * ``TIFF`` - - * ``WEBP`` - - * ``XPM`` - - * ``XCF`` - -.. versionaddedold:: 2.0.0 Loading SVG, WebP, PNM - -.. versionadded:: 2.4.0 Loading QOI (Relies on SDL_Image 2.6.0+) - -Saving images only supports a limited set of formats. You can save to the -following formats. - - * ``BMP`` - - * ``JPEG`` - - * ``PNG`` - - * ``TGA`` - - -``JPEG`` and ``JPG``, as well as ``TIF`` and ``TIFF`` refer to the same file format. - -.. versionaddedold:: 1.8 Saving PNG and JPEG files. -""" - -from typing import Literal, TypeAlias +from typing import Optional, Sequence, Tuple, Union +from pygame.bufferproxy import BufferProxy from pygame.surface import Surface -from pygame.typing import FileLike, IntPoint, Point -from typing_extensions import ( - Buffer, # collections.abc 3.12 - deprecated, # added in 3.13 -) -_FromBufferFormat: TypeAlias = Literal[ - "P", "RGB", "BGR", "BGRA", "RGBX", "RGBA", "ARGB" -] -_ToBytesFormat: TypeAlias = Literal[ - "P", "RGB", "RGBX", "RGBA", "ARGB", "BGRA", "ABGR", "RGBA_PREMULT", "ARGB_PREMULT" -] -_FromBytesFormat: TypeAlias = Literal[ - "P", "RGB", "RGBX", "RGBA", "ARGB", "BGRA", "ABGR" +from ._common import FileArg, Literal + +_BufferStyle = Union[BufferProxy, bytes, bytearray, memoryview] +_to_string_format = Literal[ + "P", "RGB", "RGBX", "RGBA", "ARGB", "BGRA", "RGBA_PREMULT", "ARGB_PREMULT" ] +_from_buffer_format = Literal["P", "RGB", "BGR", "BGRA", "RGBX", "RGBA", "ARGB"] +_from_string_format = Literal["P", "RGB", "RGBX", "RGBA", "ARGB", "BGRA"] -def load(file: FileLike, namehint: str = "") -> Surface: - """Load new image from a file (or file-like object). - - Load an image from a file source. You can pass either a filename, a Python - file-like object, or a pathlib.Path. - - Pygame will automatically determine the image type (e.g., ``GIF`` or bitmap) - and create a new Surface object from the data. In some cases it will need to - know the file extension (e.g., ``GIF`` images should end in ".gif"). If you - pass a raw file-like object, you may also want to pass the original filename - as the namehint argument. - - The returned Surface will contain the same color format, colorkey and alpha - transparency as the file it came from. You will often want to call - :func:`pygame.Surface.convert()` with no arguments, to create a copy that - will draw more quickly on the screen. - - For alpha transparency, like in .png images, use the - :func:`pygame.Surface.convert_alpha()` method after loading so that the - image has per pixel transparency. - - Pygame may not always be built to support all image formats. At minimum it - will support uncompressed ``BMP``. If :func:`pygame.image.get_extended()` - returns ``True``, you should be able to load most images (including PNG, JPG - and GIF). - - You should use :func:`os.path.join()` for compatibility. - - :: - - surf = pygame.image.load(os.path.join('data', 'bla.png')) - - .. versionchanged:: 2.2.0 Now supports keyword arguments. - """ - -def load_sized_svg(file: FileLike, size: Point) -> Surface: - """Load an SVG image from a file (or file-like object) with the given size. - - This function rasterizes the input SVG at the size specified by the ``size`` - argument. The ``file`` argument can be either a filename, a Python file-like - object, or a pathlib.Path. - - The usage of this function for handling SVGs is recommended, as calling the - regular ``load`` function and then scaling the returned surface would not - preserve the quality that an SVG can provide. - - It is to be noted that this function does not return a surface whose - dimensions exactly match the ``size`` argument. This function preserves - aspect ratio, so the returned surface could be smaller along at most one - dimension. - - This function requires SDL_image 2.6.0 or above. If pygame was compiled with - an older version, ``pygame.error`` will be raised when this function is - called. - - .. versionadded:: 2.4.0 - """ - -def load_animation(file: FileLike, namehint: str = "") -> list[tuple[Surface, float]]: - """Load an animation (GIF/WEBP) from a file (or file-like object) as a list of frames. - - Load an animation (GIF/WEBP) from a file source. You can pass either a - filename, a Python file-like object, or a pathlib.Path. If you pass a raw - file-like object, you may also want to pass the original filename as the - namehint argument so that the file extension can be used to infer the file - format. - - This returns a list of tuples (corresponding to every frame of the animation), - where each tuple is a (surface, delay in milliseconds) pair for that frame. - - This function requires SDL_image 2.6.0 or above. If pygame was compiled with - an older version, ``pygame.error`` will be raised when this function is - called. - - .. versionadded:: 2.5.4 - """ - -def save(surface: Surface, file: FileLike, namehint: str = "") -> None: - """Save an image to file (or file-like object). - - This will save your Surface as either a ``BMP``, ``TGA``, ``PNG``, or - ``JPEG`` image. If the filename extension is unrecognized it will default to - ``TGA``. Both ``TGA``, and ``BMP`` file formats create uncompressed files. - You can pass a filename, a pathlib.Path or a Python file-like object. - For file-like object, the image is saved to ``TGA`` format unless - a namehint with a recognizable extension is passed in. - - .. note:: When saving to a file-like object, it seems that for most formats, - the object needs to be flushed after saving to it to make loading - from it possible. - - .. versionchangedold:: 1.8 Saving PNG and JPEG files. - .. versionchangedold:: 2.0.0 - The ``namehint`` parameter was added to make it possible - to save other formats than ``TGA`` to a file-like object. - Saving to a file-like object with JPEG is possible. - .. versionchanged:: 2.2.0 Now supports keyword arguments. - """ - -def get_sdl_image_version(linked: bool = True) -> tuple[int, int, int] | None: - """Get version number of the SDL_Image library being used. - - If pygame is built with extended image formats, then this function will - return the SDL_Image library's version number as a tuple of 3 integers - ``(major, minor, patch)``. If not, then it will return ``None``. - - ``linked=True`` is the default behavior and the function will return the - version of the library that Pygame is linked against, while ``linked=False`` - will return the version of the library that Pygame is compiled against. - - .. versionaddedold:: 2.0.0 - - .. versionchanged:: 2.1.4 ``linked`` keyword argument added and default - behavior changed from returning compiled version to returning linked - version - """ - -def get_extended() -> bool: - """Test if extended image formats can be loaded. - - If pygame is built with extended image formats this function will return - True. It is still not possible to determine which formats will be available, - but generally you will be able to load them all. - """ - -@deprecated("since 2.3.0. Use `pygame.image.tobytes` instead") +def load(filename: FileArg, namehint: str = "") -> Surface: ... +def save(surface: Surface, filename: FileArg, namehint: str = "") -> None: ... +def get_sdl_image_version(linked: bool = True) -> Optional[Tuple[int, int, int]]: ... +def get_extended() -> bool: ... def tostring( - surface: Surface, - format: _ToBytesFormat, - flipped: bool = False, - pitch: int = -1, -) -> bytes: - """Transfer image to byte buffer. - - DEPRECATED: This function has the same functionality as :func:`tobytes()`, - which is preferred and should be used. - - .. deprecated:: 2.3.0 - """ - -def tobytes( - surface: Surface, - format: _ToBytesFormat, - flipped: bool = False, - pitch: int = -1, -) -> bytes: - """Transfer image to byte buffer. - - Creates a bytes object that can be transferred with the ``fromstring`` - or ``frombytes`` methods in other Python imaging packages. Some Python - image packages prefer their images in bottom-to-top format (PyOpenGL for - example). If you pass ``True`` for the flipped argument, the byte buffer - will be vertically flipped. - - The format argument is a string of one of the following values. Note that - only 8-bit Surfaces can use the "P" format. The other formats will work for - any Surface. Also note that other Python image packages support more formats - than pygame. - - * ``P``, 8-bit palettized Surfaces - - * ``RGB``, 24-bit image - - * ``RGBX``, 32-bit image with unused space - - * ``RGBA``, 32-bit image with an alpha channel - - * ``ARGB``, 32-bit image with alpha channel first - - * ``BGRA``, 32-bit image with alpha channel, red and blue channels swapped - - * ``ABGR``, 32-bit image with alpha channel, reverse order - - * ``RGBA_PREMULT``, 32-bit image with colors scaled by alpha channel - - * ``ARGB_PREMULT``, 32-bit image with colors scaled by alpha channel, alpha channel first - - The 'pitch' argument can be used to specify the pitch/stride per horizontal line - of the image in bytes. It must be equal to or greater than how many bytes - the pixel data of each horizontal line in the image bytes occupies without any - extra padding. By default, it is ``-1``, which means that the pitch/stride is - the same size as how many bytes the pure pixel data of each horizontal line takes. - - .. note:: The use of this function is recommended over :func:`tostring` as of pygame 2.1.3. - This function was introduced so it matches nicely with other - libraries (PIL, NumPy, etc), and with people's expectations. - - .. versionadded:: 2.1.3 - .. versionchanged:: 2.2.0 Now supports keyword arguments. - .. versionchanged:: 2.5.0 Added a 'pitch' argument. - .. versionchanged:: 2.5.1 Added support for ABGR image format - """ - -@deprecated("since 2.3.0. Use `pygame.image.frombytes` instead") + surface: Surface, format: _to_string_format, flipped: bool = False +) -> bytes: ... def fromstring( bytes: bytes, - size: IntPoint, - format: _FromBytesFormat, + size: Union[Sequence[int], Tuple[int, int]], + format: _from_string_format, flipped: bool = False, - pitch: int = -1, -) -> Surface: - """Create new Surface from a byte buffer. - - DEPRECATED: This function has the same functionality as :func:`frombytes()`, - which is preferred and should be used. - - .. deprecated:: 2.3.0 - """ - +) -> Surface: ... +# the use of tobytes/frombytes is preferred over tostring/fromstring +def tobytes( + surface: Surface, format: _to_string_format, flipped: bool = False +) -> bytes: ... def frombytes( bytes: bytes, - size: IntPoint, - format: _FromBytesFormat, + size: Union[Sequence[int], Tuple[int, int]], + format: _from_string_format, flipped: bool = False, - pitch: int = -1, -) -> Surface: - """Create new Surface from a byte buffer. - - This function takes arguments similar to :func:`pygame.image.tobytes()`. - The size argument is a pair of numbers representing the width and height. - Once the new Surface is created it is independent from the memory of the - bytes passed in. - - The bytes and format passed must compute to the exact size of image - specified. Otherwise a ``ValueError`` will be raised. - - The format argument is a string of one of the following values. Note that - only 8-bit Surfaces can use the "P" format. The other formats will work for - any Surface. - - * ``P``, 8-bit palettized Surfaces - - * ``RGB``, 24-bit image - - * ``RGBX``, 32-bit image with unused space - - * ``RGBA``, 32-bit image with an alpha channel - - * ``ARGB``, 32-bit image with alpha channel first - - * ``BGRA``, 32-bit image with alpha channel, red and blue channels swapped - - * ``ABGR``, 32-bit image with alpha channel, reverse order - - The 'pitch' argument can be used to specify the pitch/stride per horizontal line - of the image bytes in bytes. It must be equal to or greater than how many bytes - the pixel data of each horizontal line in the image bytes occupies without any - extra padding. By default, it is ``-1``, which means that the pitch/stride is - the same size as how many bytes the pure pixel data of each horizontal line takes. - - See the :func:`pygame.image.frombuffer()` method for a potentially faster - way to transfer images into pygame. - - .. note:: The use of this function is recommended over :func:`fromstring` as of pygame 2.1.3. - This function was introduced so it matches nicely with other - libraries (PIL, NumPy, etc), and with people's expectations. - - .. versionadded:: 2.1.3 - .. versionadded:: 2.1.4 Added a 'pitch' argument and support for keyword arguments. - """ - +) -> Surface: ... def frombuffer( - buffer: Buffer, - size: IntPoint, - format: _FromBufferFormat, - pitch: int = -1, -) -> Surface: - """Create a new Surface that shares data inside a bytes buffer. - - Create a new Surface that shares pixel data directly from a buffer. This - buffer can be bytes, a bytearray, a memoryview, a - :class:`pygame.BufferProxy`, or any object that supports the buffer protocol. - This method takes similar arguments to :func:`pygame.image.frombytes()`, but - is unable to vertically flip the source data. - - This will run much faster than :func:`pygame.image.frombytes`, since no - pixel data must be allocated and copied. - - It accepts the following 'format' arguments: - - * ``P``, 8-bit palettized Surfaces - - * ``RGB``, 24-bit image - - * ``BGR``, 24-bit image, red and blue channels swapped. - - * ``RGBX``, 32-bit image with unused space - - * ``RGBA``, 32-bit image with an alpha channel - - * ``ARGB``, 32-bit image with alpha channel first - - * ``BGRA``, 32-bit image with alpha channel, red and blue channels swapped - - The 'pitch' argument can be used to specify the pitch/stride per horizontal line - of the image buffer in bytes. It must be equal to or greater than how many bytes - the pixel data of each horizontal line in the image buffer occupies without any - extra padding. By default, it is ``-1``, which means that the pitch/stride is - the same size as how many bytes the pure pixel data of each horizontal line takes. - - .. versionadded:: 2.1.3 BGRA format - .. versionadded:: 2.1.4 Added a 'pitch' argument and support for keyword arguments. - """ - -def load_basic(file: FileLike, /) -> Surface: - """Load new BMP image from a file (or file-like object). - - Load an image from a file source. You can pass either a filename or a Python - file-like object, or a pathlib.Path. - - This function only supports loading "basic" image format, ie ``BMP`` - format. This function is always available, no matter how pygame was built. - """ - -def load_extended(file: FileLike, namehint: str = "") -> Surface: - """Load an image from a file (or file-like object). - - This function is similar to :func:`pygame.image.load()`, except that this - function will raise a ``NotImplementedError`` if pygame was built without - extended image format support. - - .. versionchangedold:: 2.0.1 This function is always available, but raises an - ``NotImplementedError`` if extended image formats are not supported. - Previously, this function may or may not be available, depending on the - state of extended image format support. - - .. versionchanged:: 2.2.0 Now supports keyword arguments. - """ - -def save_extended(surface: Surface, file: FileLike, namehint: str = "") -> None: - """Save a png/jpg image to file (or file-like object). - - This will save your Surface as either a ``PNG`` or ``JPEG`` image. - - In case the image is being saved to a file-like object, this function - uses the namehint argument to determine the format of the file being - saved. Saves to ``JPEG`` in case the namehint was not specified while - saving to a file-like object. - - .. versionchangedold:: 2.0.1 This function is always available, but raises an - ``NotImplementedError`` if extended image formats are not supported. - Previously, this function may or may not be available, depending on the - state of extended image format support. - - .. versionchanged:: 2.2.0 Now supports keyword arguments. - """ + bytes: _BufferStyle, + size: Union[Sequence[int], Tuple[int, int]], + format: _from_buffer_format, +) -> Surface: ... +def load_basic(filename: FileArg) -> Surface: ... +def load_extended(filename: FileArg, namehint: str = "") -> Surface: ... +def save_extended(surface: Surface, filename: FileArg, namehint: str = "") -> None: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/imageext.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/imageext.cpython-314-x86_64-linux-gnu.so index 1aa5988..9bad85a 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/imageext.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/imageext.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/joystick.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/joystick.cpython-314-x86_64-linux-gnu.so index 618a85a..f0f0c56 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/joystick.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/joystick.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/joystick.pyi b/.venv/lib/python3.14/site-packages/pygame/joystick.pyi index 08a67ea..760a39d 100644 --- a/.venv/lib/python3.14/site-packages/pygame/joystick.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/joystick.pyi @@ -1,7 +1,4 @@ -from typing import final - -from pygame.typing import ColorLike -from typing_extensions import deprecated # added in 3.13 +from typing import Tuple, final def init() -> None: ... def quit() -> None: ... @@ -9,33 +6,30 @@ def get_init() -> bool: ... def get_count() -> int: ... @final class JoystickType: - def __new__(cls, id: int) -> JoystickType: ... - @deprecated("since 2.0.0. Multiple initializations are not supported anymore") + def __init__(self, id: int) -> None: ... def init(self) -> None: ... def quit(self) -> None: ... def get_init(self) -> bool: ... - @deprecated("since 2.0.0. Use `pygame.Joystick.get_instance_id` instead") def get_id(self) -> int: ... def get_instance_id(self) -> int: ... def get_guid(self) -> str: ... def get_power_level(self) -> str: ... def get_name(self) -> str: ... def get_numaxes(self) -> int: ... - def get_axis(self, axis_number: int, /) -> float: ... + def get_axis(self, axis_number: int) -> float: ... def get_numballs(self) -> int: ... - def get_ball(self, ball_number: int, /) -> tuple[float, float]: ... + def get_ball(self, ball_number: int) -> Tuple[float, float]: ... def get_numbuttons(self) -> int: ... - def get_button(self, button: int, /) -> bool: ... + def get_button(self, button: int) -> bool: ... def get_numhats(self) -> int: ... - def get_hat(self, hat_number: int, /) -> tuple[float, float]: ... + def get_hat(self, hat_number: int) -> Tuple[float, float]: ... def rumble( self, low_frequency: float, high_frequency: float, duration: int ) -> bool: ... def stop_rumble(self) -> None: ... - def set_led(self, color: ColorLike, /) -> bool: ... # according to the current implementation, Joystick is a function that returns # a JoystickType instance. In the future, when the C implementation is fixed to # add __init__/__new__ to Joystick and it's exported directly, the typestubs # here must be updated too -def Joystick(id: int, /) -> JoystickType: ... +def Joystick(id: int) -> JoystickType: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/key.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/key.cpython-314-x86_64-linux-gnu.so index bc2eaef..863b7b6 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/key.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/key.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/key.pyi b/.venv/lib/python3.14/site-packages/pygame/key.pyi index a368015..fa75a16 100644 --- a/.venv/lib/python3.14/site-packages/pygame/key.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/key.pyi @@ -1,469 +1,17 @@ -"""Pygame module to work with the keyboard. - -This module contains functions for dealing with the keyboard. - -The :mod:`pygame.event` queue gets ``pygame.KEYDOWN`` and ``pygame.KEYUP`` -events when the keyboard buttons are pressed and released. Both events have -``key`` and ``mod`` attributes. - - * ``key``: an :ref:`integer ID ` representing every key - on the keyboard - * ``mod``: a bitmask of all the :ref:`modifier keys ` - that were in a pressed state when the event occurred - -The ``pygame.KEYDOWN`` event has the additional attributes ``unicode`` and -``scancode``. - - * ``unicode``: a single character string that is the fully translated - character entered, this takes into account the shift and composition keys - * ``scancode``: the platform-specific key code, which could be different from - keyboard to keyboard, but is useful for key selection of weird keys like - the multimedia keys - -.. versionaddedold:: 2.0.0 - The ``pygame.TEXTINPUT`` event is preferred to the ``unicode`` attribute - of ``pygame.KEYDOWN``. The attribute ``text`` contains the input. - - -.. _key-constants-label: - -The following is a list of all the constants (from :mod:`pygame.locals`) used to -represent keyboard keys. - -Portability note: The integers for key constants differ between pygame 1 and 2. -Always use key constants (``K_a``) rather than integers directly (``97``) so -that your key handling code works well on both pygame 1 and pygame 2. - - -:: - - pygame - Constant ASCII Description - --------------------------------- - K_BACKSPACE \\b backspace - K_TAB \\t tab - K_CLEAR clear - K_RETURN \\r return - K_PAUSE pause - K_ESCAPE ^[ escape - K_SPACE space - K_EXCLAIM ! exclaim - K_QUOTEDBL " quotedbl - K_HASH # hash - K_DOLLAR $ dollar - K_AMPERSAND & ampersand - K_QUOTE quote - K_LEFTPAREN ( left parenthesis - K_RIGHTPAREN ) right parenthesis - K_ASTERISK * asterisk - K_PLUS + plus sign - K_COMMA , comma - K_MINUS - minus sign - K_PERIOD . period - K_SLASH / forward slash - K_0 0 0 - K_1 1 1 - K_2 2 2 - K_3 3 3 - K_4 4 4 - K_5 5 5 - K_6 6 6 - K_7 7 7 - K_8 8 8 - K_9 9 9 - K_COLON : colon - K_SEMICOLON ; semicolon - K_LESS < less-than sign - K_EQUALS = equals sign - K_GREATER > greater-than sign - K_QUESTION ? question mark - K_AT @ at - K_LEFTBRACKET [ left bracket - K_BACKSLASH \\ backslash - K_RIGHTBRACKET ] right bracket - K_CARET ^ caret - K_UNDERSCORE _ underscore - K_BACKQUOTE ` grave - K_a a a - K_b b b - K_c c c - K_d d d - K_e e e - K_f f f - K_g g g - K_h h h - K_i i i - K_j j j - K_k k k - K_l l l - K_m m m - K_n n n - K_o o o - K_p p p - K_q q q - K_r r r - K_s s s - K_t t t - K_u u u - K_v v v - K_w w w - K_x x x - K_y y y - K_z z z - K_DELETE delete - K_KP0 keypad 0 - K_KP1 keypad 1 - K_KP2 keypad 2 - K_KP3 keypad 3 - K_KP4 keypad 4 - K_KP5 keypad 5 - K_KP6 keypad 6 - K_KP7 keypad 7 - K_KP8 keypad 8 - K_KP9 keypad 9 - K_KP_PERIOD . keypad period - K_KP_DIVIDE / keypad divide - K_KP_MULTIPLY * keypad multiply - K_KP_MINUS - keypad minus - K_KP_PLUS + keypad plus - K_KP_ENTER \\r keypad enter - K_KP_EQUALS = keypad equals - K_UP up arrow - K_DOWN down arrow - K_RIGHT right arrow - K_LEFT left arrow - K_INSERT insert - K_HOME home - K_END end - K_PAGEUP page up - K_PAGEDOWN page down - K_F1 F1 - K_F2 F2 - K_F3 F3 - K_F4 F4 - K_F5 F5 - K_F6 F6 - K_F7 F7 - K_F8 F8 - K_F9 F9 - K_F10 F10 - K_F11 F11 - K_F12 F12 - K_F13 F13 - K_F14 F14 - K_F15 F15 - K_NUMLOCK numlock - K_CAPSLOCK capslock - K_SCROLLOCK scrollock - K_RSHIFT right shift - K_LSHIFT left shift - K_RCTRL right control - K_LCTRL left control - K_RALT right alt - K_LALT left alt - K_RMETA right meta - K_LMETA left meta - K_LSUPER left Windows key - K_RSUPER right Windows key - K_MODE mode shift - K_HELP help - K_PRINT print screen - K_SYSREQ sysrq - K_BREAK break - K_MENU menu - K_POWER power - K_EURO Euro - K_AC_BACK Android back button - - -.. _key-modifiers-label: - -The keyboard also has a list of modifier states (from :mod:`pygame.locals`) that -can be assembled by bitwise-ORing them together. - -:: - - pygame - Constant Description - ------------------------- - KMOD_NONE no modifier keys pressed - KMOD_LSHIFT left shift - KMOD_RSHIFT right shift - KMOD_SHIFT left shift or right shift or both - KMOD_LCTRL left control - KMOD_RCTRL right control - KMOD_CTRL left control or right control or both - KMOD_LALT left alt - KMOD_RALT right alt - KMOD_ALT left alt or right alt or both - KMOD_LMETA left meta - KMOD_RMETA right meta - KMOD_META left meta or right meta or both - KMOD_CAPS caps lock - KMOD_NUM num lock - KMOD_MODE AltGr - - -The modifier information is contained in the ``mod`` attribute of the -``pygame.KEYDOWN`` and ``pygame.KEYUP`` events. The ``mod`` attribute is a -bitmask of all the modifier keys that were in a pressed state when the event -occurred. The modifier information can be decoded using a bitwise AND (except -for ``KMOD_NONE``, which should be compared using equals ``==``). For example: - -:: - - for event in pygame.event.get(): - if event.type == pygame.KEYDOWN or event.type == pygame.KEYUP: - if event.mod == pygame.KMOD_NONE: - print('No modifier keys were in a pressed state when this ' - 'event occurred.') - else: - if event.mod & pygame.KMOD_LSHIFT: - print('Left shift was in a pressed state when this event ' - 'occurred.') - if event.mod & pygame.KMOD_RSHIFT: - print('Right shift was in a pressed state when this event ' - 'occurred.') - if event.mod & pygame.KMOD_SHIFT: - print('Left shift or right shift or both were in a ' - 'pressed state when this event occurred.') -""" - -from typing import NoReturn - -from pygame.typing import RectLike - -class ScancodeWrapper(tuple[bool, ...]): - def __iter__(self) -> NoReturn: ... - -def get_focused() -> bool: - """True if the display is receiving keyboard input from the system. - - Returns ``True`` when the display window has keyboard focus from the - system. If the display needs to ensure it does not lose keyboard focus, it - can use :func:`pygame.event.set_grab()` to grab all input. - """ - -def get_pressed() -> ScancodeWrapper: - """Get the state of all keyboard buttons. - - Returns a sequence of boolean values representing the state of every key on - the keyboard. Use the key constant values to index the array. A ``True`` - value means that the button is pressed. - - .. note:: - Getting the list of pushed buttons with this function is not the proper - way to handle text entry from the user. There is no way to know the order - of keys pressed, and rapidly pushed keys can be completely unnoticed - between two calls to ``pygame.key.get_pressed()``. There is also no way to - translate these pushed keys into a fully translated character value. See - the ``pygame.KEYDOWN`` events on the :mod:`pygame.event` queue for this - functionality. - - .. versionchanged:: 2.1.4 - The collection of bools returned by ``get_pressed`` can not be iterated - over because the indexes of the internal tuple does not correspond to the - keycodes. - """ - -def get_just_pressed() -> ScancodeWrapper: - """Returns a ScancodeWrapper containing the most recent key presses. - - Returns a mapping from key codes to booleans indicating which keys were - newly pressed as of the last time events were processed. This can be used - as a convenience function to detect keys that were pressed "this frame." - - The result of this function is updated when new events are processed, - e.g. in :func:`pygame.event.get()` or :func:`pygame.event.pump()`. - - A key can be marked as "just pressed" even if it is not currently pressed - according to :func:`pygame.key.get_pressed()`, if it was pressed and released - again during the same frame. Multiple presses and releases of the same key - are not distinguished from a single press with this function. - - .. seealso:: :func:`pygame.key.get_just_released()` - - .. note:: - If you require getting the key presses in order, use the event queue - ``KEYDOWN`` events - - :: - - if pygame.key.get_just_pressed()[pygame.K_b]: - print("B key just pressed") - - .. versionadded:: 2.4.0 - """ - -def get_just_released() -> ScancodeWrapper: - """Returns a ScancodeWrapper containing the most recent key releases. - - Returns a mapping from key codes to booleans indicating which keys were - newly released as of the last time events were processed. This can be used - as a convenience function to detect keys that were released "this frame." - - The result of this function is updated when new events are processed, - e.g. in :func:`pygame.event.get()` or :func:`pygame.event.pump()`. - - A key can be marked as "just released" even if it is currently pressed - according to :func:`pygame.key.get_pressed()`, if it was released and pressed - again during the same frame. Multiple releases and presses of the same key - are not distinguished from a single release with this function. - - .. seealso:: :func:`pygame.key.get_just_pressed()` - - .. note:: - If you require getting the key releases in order, use the event queue - ``KEYUP`` events. - - :: - - if pygame.key.get_just_released()[pygame.K_b]: - print("B key just released") - - .. versionadded:: 2.4.0 - """ - -def get_mods() -> int: - """Determine which modifier keys are being held. - - Returns a single integer representing a bitmask of all the modifier keys - being held. Using bitwise operators you can test if specific - :ref:`modifier keys ` are pressed. - """ - -def set_mods(mods: int, /) -> None: - """Temporarily set which modifier keys are pressed. - - Create a bitmask of the :ref:`modifier key constants ` - you want to impose on your program. - """ - -def set_repeat(delay: int = 0, interval: int = 0, /) -> None: - """Control how held keys are repeated. - - When the keyboard repeat is enabled, keys that are held down will generate - multiple ``pygame.KEYDOWN`` events. The ``delay`` parameter is the number of - milliseconds before the first repeated ``pygame.KEYDOWN`` event will be sent. - After that, another ``pygame.KEYDOWN`` event will be sent every ``interval`` - milliseconds. If a ``delay`` value is provided and an ``interval`` value is - not provided or is 0, then the ``interval`` will be set to the same value as - ``delay``. - - To disable key repeat call this function with no arguments or with ``delay`` - set to 0. - - When pygame is initialized the key repeat is disabled. - - :raises ValueError: if ``delay`` or ``interval`` is < 0 - - .. versionchangedold:: 2.0.0 A ``ValueError`` is now raised (instead of a - ``pygame.error``) if ``delay`` or ``interval`` is < 0. - """ - -def get_repeat() -> tuple[int, int]: - """See how held keys are repeated. - - Get the ``delay`` and ``interval`` keyboard repeat values. Refer to - :func:`pygame.key.set_repeat()` for a description of these values. - - .. versionaddedold:: 1.8 - """ - -def name(key: int, use_compat: bool = True) -> str: - """Get the name of a key identifier. - - Get the descriptive name of the button from a keyboard button id constant. - Returns an empty string (``""``) if the key is not found. - - If ``use_compat`` argument is ``True`` (which is the default), this function - returns the legacy name of a key where applicable. The return value is - expected to be the same across different pygame versions (provided the - corresponding key constant exists and is unique). If the return value is - passed to the ``key_code`` function, the original constant will be returned. - - If this argument is ``False``, the returned name may be prettier to display - and may cover a wider range of keys than with ``use_compat``, but there are - no guarantees that this name will be the same across different pygame - versions. If the name returned is passed to the ``key_code`` function, the - original constant is returned back (this is an implementation detail which - may change later, do not rely on this) - - .. versionchanged:: 2.1.3 Added ``use_compat`` argument and guaranteed API stability for it - """ - -def key_code(name: str) -> int: - """Get the key identifier from a key name. - - Get the key identifier code from the descriptive name of the key. This - returns an integer matching one of the K_* keycodes. For example: - - :: - - >>> pygame.key.key_code("return") == pygame.K_RETURN - True - >>> pygame.key.key_code("0") == pygame.K_0 - True - >>> pygame.key.key_code("space") == pygame.K_SPACE - True - - :raises ValueError: if the key name is not known. - - .. versionaddedold:: 2.0.0 - """ - -def start_text_input() -> None: - """Start handling Unicode text input events. - - Start receiving ``pygame.TEXTEDITING`` and ``pygame.TEXTINPUT`` - events. If applicable, show the on-screen keyboard or IME editor. - - For many languages, key presses will automatically generate a - corresponding ``pygame.TEXTINPUT`` event. Special keys like - escape or function keys, and certain key combinations will not - generate ``pygame.TEXTINPUT`` events. - - In other languages, entering a single symbol may require multiple - key presses, or a language-specific user interface. In this case, - ``pygame.TEXTINPUT`` events are preferable to ``pygame.KEYDOWN`` - events for text input. - - A ``pygame.TEXTEDITING`` event is received when an IME composition - is started or changed. It contains the composition ``text``, ``length``, - and editing ``start`` position within the composition (attributes - ``text``, ``length``, and ``start``, respectively). - When the composition is committed (or non-IME input is received), - a ``pygame.TEXTINPUT`` event is generated. - - Text input events handling is on by default. - - .. seealso:: :func:`pygame.key.stop_text_input()` - - .. versionaddedold:: 2.0.0 - """ - -def stop_text_input() -> None: - """Stop handling Unicode text input events. - - Stop receiving ``pygame.TEXTEDITING`` and ``pygame.TEXTINPUT`` - events. If an on-screen keyboard or IME editor was shown with - :func:`pygame.key.start_text_input()`, hide it again. - - Text input events handling is on by default. - - To avoid triggering the IME editor or the on-screen keyboard - when the user is holding down a key during gameplay, text input - should be disabled once text entry is finished, or when the user - clicks outside of a text box. - - .. versionaddedold:: 2.0.0 - """ - -def set_text_input_rect(rect: RectLike, /) -> None: - """Controls the position of the candidate list. - - This sets the rectangle used for typing with an IME. - It controls where the candidate list will open, if supported. - - .. versionaddedold:: 2.0.0 - """ +from typing import Tuple + +from ._common import RectValue + +class ScancodeWrapper(Tuple[bool, ...]): ... + +def get_focused() -> bool: ... +def get_pressed() -> ScancodeWrapper: ... +def get_mods() -> int: ... +def set_mods(mods: int) -> None: ... +def set_repeat(delay: int = 0, interval: int = 0) -> None: ... +def get_repeat() -> Tuple[int, int]: ... +def name(key: int, use_compat: bool = True) -> str: ... +def key_code(name: str) -> int: ... +def start_text_input() -> None: ... +def stop_text_input() -> None: ... +def set_text_input_rect(rect: RectValue) -> None: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/locals.py b/.venv/lib/python3.14/site-packages/pygame/locals.py index acdcdcd..38801d5 100644 --- a/.venv/lib/python3.14/site-packages/pygame/locals.py +++ b/.venv/lib/python3.14/site-packages/pygame/locals.py @@ -1,4 +1,4 @@ -# pygame-ce - Python Game Library +# pygame - Python Game Library # Copyright (C) 2000-2003 Pete Shinners # # This library is free software; you can redistribute it and/or @@ -23,8 +23,8 @@ the local namespace for your module""" import pygame -from pygame.color import Color -from pygame.constants import * # pylint: disable=wildcard-import,unused-wildcard-import; lgtm[py/polluting-import] +from pygame.constants import * # pylint: disable=wildcard-import; lgtm[py/polluting-import] from pygame.rect import Rect +from pygame.color import Color __all__ = pygame.constants.__all__ + ["Rect", "Color"] diff --git a/.venv/lib/python3.14/site-packages/pygame/locals.pyi b/.venv/lib/python3.14/site-packages/pygame/locals.pyi index 95b838f..b6c2dd0 100644 --- a/.venv/lib/python3.14/site-packages/pygame/locals.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/locals.pyi @@ -31,26 +31,10 @@ AUDIO_U16MSB: int AUDIO_U16SYS: int AUDIO_U8: int BIG_ENDIAN: int -BLENDFACTOR_DST_ALPHA: int -BLENDFACTOR_DST_COLOR: int -BLENDFACTOR_ONE: int -BLENDFACTOR_ONE_MINUS_DST_ALPHA: int -BLENDFACTOR_ONE_MINUS_DST_COLOR: int -BLENDFACTOR_ONE_MINUS_SRC_ALPHA: int -BLENDFACTOR_ONE_MINUS_SRC_COLOR: int -BLENDFACTOR_SRC_ALPHA: int -BLENDFACTOR_SRC_COLOR: int -BLENDFACTOR_ZERO: int BLENDMODE_ADD: int BLENDMODE_BLEND: int BLENDMODE_MOD: int -BLENDMODE_MUL: int BLENDMODE_NONE: int -BLENDOPERATION_ADD: int -BLENDOPERATION_MAXIMUM: int -BLENDOPERATION_MINIMUM: int -BLENDOPERATION_REV_SUBTRACT: int -BLENDOPERATION_SUBTRACT: int BLEND_ADD: int BLEND_ALPHA_SDL2: int BLEND_MAX: int @@ -112,10 +96,6 @@ CONTROLLER_BUTTON_START: int CONTROLLER_BUTTON_X: int CONTROLLER_BUTTON_Y: int Color: type -DIRECTION_BTT: int -DIRECTION_LTR: int -DIRECTION_RTL: int -DIRECTION_TTB: int DOUBLEBUF: int DROPBEGIN: int DROPCOMPLETE: int @@ -124,15 +104,6 @@ DROPTEXT: int FINGERDOWN: int FINGERMOTION: int FINGERUP: int -FLASH_BRIEFLY: int -FLASH_CANCEL: int -FLASH_UNTIL_FOCUSED: int -FLIP_HORIZONTAL: int -FLIP_NONE: int -FLIP_VERTICAL: int -FONT_CENTER: int -FONT_LEFT: int -FONT_RIGHT: int FULLSCREEN: int GL_ACCELERATED_VISUAL: int GL_ACCUM_ALPHA_SIZE: int @@ -180,7 +151,6 @@ HIDDEN: int HWACCEL: int HWPALETTE: int HWSURFACE: int -IS_CE: int JOYAXISMOTION: int JOYBALLMOTION: int JOYBUTTONDOWN: int @@ -530,7 +500,6 @@ MOUSEWHEEL: int MULTIGESTURE: int NOEVENT: int NOFRAME: int -NULL_VIDEODRIVER: str NUMEVENTS: int OPENGL: int OPENGLBLIT: int @@ -549,8 +518,6 @@ SCRAP_PBM: str SCRAP_PPM: str SCRAP_SELECTION: int SCRAP_TEXT: str -SCROLL_ERASE: int -SCROLL_REPEAT: int SHOWN: int SRCALPHA: int SRCCOLORKEY: int @@ -570,9 +537,6 @@ SYSTEM_CURSOR_WAITARROW: int SYSWMEVENT: int TEXTEDITING: int TEXTINPUT: int -TEXTUREACCESS_STATIC: int -TEXTUREACCESS_STREAMING: int -TEXTUREACCESS_TARGET: int TIMER_RESOLUTION: int USEREVENT: int USEREVENT_DROPFILE: int @@ -591,608 +555,8 @@ WINDOWLEAVE: int WINDOWMAXIMIZED: int WINDOWMINIMIZED: int WINDOWMOVED: int -WINDOWPOS_CENTERED: int -WINDOWPOS_UNDEFINED: int WINDOWRESIZED: int WINDOWRESTORED: int WINDOWSHOWN: int WINDOWSIZECHANGED: int WINDOWTAKEFOCUS: int -__all__ = [ - "LIL_ENDIAN", - "BIG_ENDIAN", - "SWSURFACE", - "HWSURFACE", - "RESIZABLE", - "ASYNCBLIT", - "OPENGL", - "OPENGLBLIT", - "ANYFORMAT", - "HWPALETTE", - "DOUBLEBUF", - "FULLSCREEN", - "HWACCEL", - "SRCCOLORKEY", - "RLEACCELOK", - "RLEACCEL", - "SRCALPHA", - "PREALLOC", - "NOFRAME", - "SHOWN", - "HIDDEN", - "SCROLL_ERASE", - "SCROLL_REPEAT", - "SCALED", - "GL_RED_SIZE", - "GL_GREEN_SIZE", - "GL_BLUE_SIZE", - "GL_ALPHA_SIZE", - "GL_BUFFER_SIZE", - "GL_DOUBLEBUFFER", - "GL_DEPTH_SIZE", - "GL_STENCIL_SIZE", - "GL_ACCUM_RED_SIZE", - "GL_ACCUM_GREEN_SIZE", - "GL_ACCUM_BLUE_SIZE", - "GL_ACCUM_ALPHA_SIZE", - "GL_ACCELERATED_VISUAL", - "GL_CONTEXT_MAJOR_VERSION", - "GL_CONTEXT_MINOR_VERSION", - "GL_SHARE_WITH_CURRENT_CONTEXT", - "GL_CONTEXT_FLAGS", - "GL_CONTEXT_DEBUG_FLAG", - "GL_CONTEXT_FORWARD_COMPATIBLE_FLAG", - "GL_CONTEXT_ROBUST_ACCESS_FLAG", - "GL_CONTEXT_RESET_ISOLATION_FLAG", - "GL_CONTEXT_PROFILE_MASK", - "GL_CONTEXT_PROFILE_CORE", - "GL_CONTEXT_PROFILE_COMPATIBILITY", - "GL_CONTEXT_PROFILE_ES", - "GL_FRAMEBUFFER_SRGB_CAPABLE", - "GL_CONTEXT_RELEASE_BEHAVIOR", - "GL_CONTEXT_RELEASE_BEHAVIOR_NONE", - "GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH", - "BLENDMODE_NONE", - "BLENDMODE_BLEND", - "BLENDMODE_ADD", - "BLENDMODE_MOD", - "BLENDMODE_MUL", - "BLENDFACTOR_ZERO", - "BLENDFACTOR_ONE", - "BLENDFACTOR_SRC_COLOR", - "BLENDFACTOR_ONE_MINUS_SRC_COLOR", - "BLENDFACTOR_SRC_ALPHA", - "BLENDFACTOR_ONE_MINUS_SRC_ALPHA", - "BLENDFACTOR_DST_COLOR", - "BLENDFACTOR_ONE_MINUS_DST_COLOR", - "BLENDFACTOR_DST_ALPHA", - "BLENDFACTOR_ONE_MINUS_DST_ALPHA", - "BLENDOPERATION_ADD", - "BLENDOPERATION_SUBTRACT", - "BLENDOPERATION_REV_SUBTRACT", - "BLENDOPERATION_MINIMUM", - "BLENDOPERATION_MAXIMUM", - "GL_STEREO", - "GL_MULTISAMPLEBUFFERS", - "GL_MULTISAMPLESAMPLES", - "GL_SWAP_CONTROL", - "TIMER_RESOLUTION", - "AUDIO_U8", - "AUDIO_S8", - "AUDIO_U16LSB", - "AUDIO_S16LSB", - "AUDIO_U16MSB", - "AUDIO_S16MSB", - "AUDIO_U16", - "AUDIO_S16", - "AUDIO_U16SYS", - "AUDIO_S16SYS", - "SCRAP_TEXT", - "SCRAP_BMP", - "SCRAP_PPM", - "SCRAP_PBM", - "SCRAP_CLIPBOARD", - "SCRAP_SELECTION", - "BLEND_ADD", - "BLEND_SUB", - "BLEND_MULT", - "BLEND_MIN", - "BLEND_MAX", - "BLEND_RGB_ADD", - "BLEND_RGB_SUB", - "BLEND_RGB_MULT", - "BLEND_RGB_MIN", - "BLEND_RGB_MAX", - "BLEND_RGBA_ADD", - "BLEND_RGBA_SUB", - "BLEND_RGBA_MULT", - "BLEND_RGBA_MIN", - "BLEND_RGBA_MAX", - "BLEND_PREMULTIPLIED", - "BLEND_ALPHA_SDL2", - "NOEVENT", - "ACTIVEEVENT", - "KEYDOWN", - "KEYUP", - "MOUSEMOTION", - "MOUSEBUTTONDOWN", - "MOUSEBUTTONUP", - "JOYAXISMOTION", - "JOYBALLMOTION", - "JOYHATMOTION", - "JOYBUTTONDOWN", - "JOYBUTTONUP", - "VIDEORESIZE", - "VIDEOEXPOSE", - "QUIT", - "SYSWMEVENT", - "MIDIIN", - "MIDIOUT", - "USEREVENT", - "NUMEVENTS", - "APP_TERMINATING", - "APP_LOWMEMORY", - "APP_WILLENTERBACKGROUND", - "APP_DIDENTERBACKGROUND", - "APP_WILLENTERFOREGROUND", - "APP_DIDENTERFOREGROUND", - "CLIPBOARDUPDATE", - "KEYMAPCHANGED", - "RENDER_TARGETS_RESET", - "RENDER_DEVICE_RESET", - "HAT_CENTERED", - "HAT_UP", - "HAT_RIGHTUP", - "HAT_RIGHT", - "HAT_RIGHTDOWN", - "HAT_DOWN", - "HAT_LEFTDOWN", - "HAT_LEFT", - "HAT_LEFTUP", - "BUTTON_LEFT", - "BUTTON_MIDDLE", - "BUTTON_RIGHT", - "FINGERMOTION", - "FINGERDOWN", - "FINGERUP", - "MULTIGESTURE", - "AUDIODEVICEADDED", - "AUDIODEVICEREMOVED", - "MOUSEWHEEL", - "TEXTINPUT", - "TEXTEDITING", - "WINDOWSHOWN", - "WINDOWHIDDEN", - "WINDOWEXPOSED", - "WINDOWMOVED", - "WINDOWRESIZED", - "WINDOWSIZECHANGED", - "WINDOWMINIMIZED", - "WINDOWMAXIMIZED", - "WINDOWRESTORED", - "WINDOWENTER", - "WINDOWLEAVE", - "WINDOWFOCUSGAINED", - "WINDOWFOCUSLOST", - "WINDOWCLOSE", - "WINDOWTAKEFOCUS", - "WINDOWHITTEST", - "WINDOWICCPROFCHANGED", - "WINDOWDISPLAYCHANGED", - "TEXTUREACCESS_STATIC", - "TEXTUREACCESS_STREAMING", - "TEXTUREACCESS_TARGET", - "FLIP_NONE", - "FLIP_HORIZONTAL", - "FLIP_VERTICAL", - "CONTROLLERAXISMOTION", - "CONTROLLERBUTTONDOWN", - "CONTROLLERBUTTONUP", - "CONTROLLERDEVICEADDED", - "CONTROLLERDEVICEREMOVED", - "CONTROLLERDEVICEREMAPPED", - "CONTROLLERTOUCHPADDOWN", - "CONTROLLERTOUCHPADMOTION", - "CONTROLLERTOUCHPADUP", - "CONTROLLERSENSORUPDATE", - "LOCALECHANGED", - "JOYDEVICEADDED", - "JOYDEVICEREMOVED", - "BUTTON_X1", - "BUTTON_X2", - "BUTTON_WHEELUP", - "BUTTON_WHEELDOWN", - "AUDIO_ALLOW_FREQUENCY_CHANGE", - "AUDIO_ALLOW_FORMAT_CHANGE", - "AUDIO_ALLOW_CHANNELS_CHANGE", - "AUDIO_ALLOW_ANY_CHANGE", - "DROPFILE", - "DROPTEXT", - "DROPBEGIN", - "DROPCOMPLETE", - "CONTROLLER_AXIS_INVALID", - "CONTROLLER_AXIS_LEFTX", - "CONTROLLER_AXIS_LEFTY", - "CONTROLLER_AXIS_RIGHTX", - "CONTROLLER_AXIS_RIGHTY", - "CONTROLLER_AXIS_TRIGGERLEFT", - "CONTROLLER_AXIS_TRIGGERRIGHT", - "CONTROLLER_AXIS_MAX", - "CONTROLLER_BUTTON_INVALID", - "CONTROLLER_BUTTON_A", - "CONTROLLER_BUTTON_B", - "CONTROLLER_BUTTON_X", - "CONTROLLER_BUTTON_Y", - "CONTROLLER_BUTTON_BACK", - "CONTROLLER_BUTTON_GUIDE", - "CONTROLLER_BUTTON_START", - "CONTROLLER_BUTTON_LEFTSTICK", - "CONTROLLER_BUTTON_RIGHTSTICK", - "CONTROLLER_BUTTON_LEFTSHOULDER", - "CONTROLLER_BUTTON_RIGHTSHOULDER", - "CONTROLLER_BUTTON_DPAD_UP", - "CONTROLLER_BUTTON_DPAD_DOWN", - "CONTROLLER_BUTTON_DPAD_LEFT", - "CONTROLLER_BUTTON_DPAD_RIGHT", - "CONTROLLER_BUTTON_MAX", - "K_AC_BACK", - "KSCAN_AC_BACK", - "K_UNKNOWN", - "KSCAN_UNKNOWN", - "K_BACKSPACE", - "KSCAN_BACKSPACE", - "K_TAB", - "KSCAN_TAB", - "K_CLEAR", - "KSCAN_CLEAR", - "K_RETURN", - "KSCAN_RETURN", - "K_PAUSE", - "KSCAN_PAUSE", - "K_ESCAPE", - "KSCAN_ESCAPE", - "K_SPACE", - "KSCAN_SPACE", - "K_QUOTE", - "KSCAN_APOSTROPHE", - "K_COMMA", - "KSCAN_COMMA", - "K_MINUS", - "KSCAN_MINUS", - "K_PERIOD", - "KSCAN_PERIOD", - "K_SLASH", - "KSCAN_SLASH", - "K_0", - "KSCAN_0", - "K_1", - "KSCAN_1", - "K_2", - "KSCAN_2", - "K_3", - "KSCAN_3", - "K_4", - "KSCAN_4", - "K_5", - "KSCAN_5", - "K_6", - "KSCAN_6", - "K_7", - "KSCAN_7", - "K_8", - "KSCAN_8", - "K_9", - "KSCAN_9", - "K_SEMICOLON", - "KSCAN_SEMICOLON", - "K_EQUALS", - "KSCAN_EQUALS", - "K_LEFTBRACKET", - "KSCAN_LEFTBRACKET", - "K_BACKSLASH", - "KSCAN_BACKSLASH", - "K_RIGHTBRACKET", - "KSCAN_RIGHTBRACKET", - "K_BACKQUOTE", - "KSCAN_GRAVE", - "K_a", - "KSCAN_A", - "K_b", - "KSCAN_B", - "K_c", - "KSCAN_C", - "K_d", - "KSCAN_D", - "K_e", - "KSCAN_E", - "K_f", - "KSCAN_F", - "K_g", - "KSCAN_G", - "K_h", - "KSCAN_H", - "K_i", - "KSCAN_I", - "K_j", - "KSCAN_J", - "K_k", - "KSCAN_K", - "K_l", - "KSCAN_L", - "K_m", - "KSCAN_M", - "K_n", - "KSCAN_N", - "K_o", - "KSCAN_O", - "K_p", - "KSCAN_P", - "K_q", - "KSCAN_Q", - "K_r", - "KSCAN_R", - "K_s", - "KSCAN_S", - "K_t", - "KSCAN_T", - "K_u", - "KSCAN_U", - "K_v", - "KSCAN_V", - "K_w", - "KSCAN_W", - "K_x", - "KSCAN_X", - "K_y", - "KSCAN_Y", - "K_z", - "KSCAN_Z", - "K_DELETE", - "KSCAN_DELETE", - "K_KP_0", - "KSCAN_KP_0", - "K_KP_1", - "KSCAN_KP_1", - "K_KP_2", - "KSCAN_KP_2", - "K_KP_3", - "KSCAN_KP_3", - "K_KP_4", - "KSCAN_KP_4", - "K_KP_5", - "KSCAN_KP_5", - "K_KP_6", - "KSCAN_KP_6", - "K_KP_7", - "KSCAN_KP_7", - "K_KP_8", - "KSCAN_KP_8", - "K_KP_9", - "KSCAN_KP_9", - "K_KP0", - "KSCAN_KP0", - "K_KP1", - "KSCAN_KP1", - "K_KP2", - "KSCAN_KP2", - "K_KP3", - "KSCAN_KP3", - "K_KP4", - "KSCAN_KP4", - "K_KP5", - "KSCAN_KP5", - "K_KP6", - "KSCAN_KP6", - "K_KP7", - "KSCAN_KP7", - "K_KP8", - "KSCAN_KP8", - "K_KP9", - "KSCAN_KP9", - "K_KP_PERIOD", - "KSCAN_KP_PERIOD", - "K_KP_DIVIDE", - "KSCAN_KP_DIVIDE", - "K_KP_MULTIPLY", - "KSCAN_KP_MULTIPLY", - "K_KP_MINUS", - "KSCAN_KP_MINUS", - "K_KP_PLUS", - "KSCAN_KP_PLUS", - "K_KP_ENTER", - "KSCAN_KP_ENTER", - "K_KP_EQUALS", - "KSCAN_KP_EQUALS", - "K_UP", - "KSCAN_UP", - "K_DOWN", - "KSCAN_DOWN", - "K_RIGHT", - "KSCAN_RIGHT", - "K_LEFT", - "KSCAN_LEFT", - "K_INSERT", - "KSCAN_INSERT", - "K_HOME", - "KSCAN_HOME", - "K_END", - "KSCAN_END", - "K_PAGEUP", - "KSCAN_PAGEUP", - "K_PAGEDOWN", - "KSCAN_PAGEDOWN", - "K_F1", - "KSCAN_F1", - "K_F2", - "KSCAN_F2", - "K_F3", - "KSCAN_F3", - "K_F4", - "KSCAN_F4", - "K_F5", - "KSCAN_F5", - "K_F6", - "KSCAN_F6", - "K_F7", - "KSCAN_F7", - "K_F8", - "KSCAN_F8", - "K_F9", - "KSCAN_F9", - "K_F10", - "KSCAN_F10", - "K_F11", - "KSCAN_F11", - "K_F12", - "KSCAN_F12", - "K_F13", - "KSCAN_F13", - "K_F14", - "KSCAN_F14", - "K_F15", - "KSCAN_F15", - "K_NUMLOCKCLEAR", - "KSCAN_NUMLOCKCLEAR", - "K_NUMLOCK", - "KSCAN_NUMLOCK", - "K_CAPSLOCK", - "KSCAN_CAPSLOCK", - "K_SCROLLLOCK", - "KSCAN_SCROLLLOCK", - "K_SCROLLOCK", - "KSCAN_SCROLLOCK", - "K_RSHIFT", - "KSCAN_RSHIFT", - "K_LSHIFT", - "KSCAN_LSHIFT", - "K_RCTRL", - "KSCAN_RCTRL", - "K_LCTRL", - "KSCAN_LCTRL", - "K_RALT", - "KSCAN_RALT", - "K_LALT", - "KSCAN_LALT", - "K_RGUI", - "KSCAN_RGUI", - "K_RMETA", - "KSCAN_RMETA", - "K_LGUI", - "KSCAN_LGUI", - "K_LMETA", - "KSCAN_LMETA", - "K_LSUPER", - "KSCAN_LSUPER", - "K_RSUPER", - "KSCAN_RSUPER", - "K_MODE", - "KSCAN_MODE", - "K_HELP", - "KSCAN_HELP", - "K_PRINTSCREEN", - "KSCAN_PRINTSCREEN", - "K_PRINT", - "KSCAN_PRINT", - "K_SYSREQ", - "KSCAN_SYSREQ", - "K_BREAK", - "KSCAN_BREAK", - "K_MENU", - "KSCAN_MENU", - "K_POWER", - "KSCAN_POWER", - "K_CURRENCYUNIT", - "KSCAN_CURRENCYUNIT", - "K_CURRENCYSUBUNIT", - "KSCAN_CURRENCYSUBUNIT", - "K_EURO", - "KSCAN_EURO", - "KSCAN_INTERNATIONAL1", - "KSCAN_INTERNATIONAL2", - "KSCAN_INTERNATIONAL3", - "KSCAN_INTERNATIONAL4", - "KSCAN_INTERNATIONAL5", - "KSCAN_INTERNATIONAL6", - "KSCAN_INTERNATIONAL7", - "KSCAN_INTERNATIONAL8", - "KSCAN_INTERNATIONAL9", - "KSCAN_LANG1", - "KSCAN_LANG2", - "KSCAN_LANG3", - "KSCAN_LANG4", - "KSCAN_LANG5", - "KSCAN_LANG6", - "KSCAN_LANG7", - "KSCAN_LANG8", - "KSCAN_LANG9", - "KSCAN_NONUSBACKSLASH", - "KSCAN_NONUSHASH", - "K_EXCLAIM", - "K_QUOTEDBL", - "K_HASH", - "K_DOLLAR", - "K_AMPERSAND", - "K_PERCENT", - "K_LEFTPAREN", - "K_RIGHTPAREN", - "K_ASTERISK", - "K_PLUS", - "K_COLON", - "K_LESS", - "K_GREATER", - "K_QUESTION", - "K_AT", - "K_CARET", - "K_UNDERSCORE", - "KMOD_NONE", - "KMOD_LSHIFT", - "KMOD_RSHIFT", - "KMOD_LCTRL", - "KMOD_RCTRL", - "KMOD_LALT", - "KMOD_RALT", - "KMOD_LGUI", - "KMOD_LMETA", - "KMOD_RGUI", - "KMOD_RMETA", - "KMOD_NUM", - "KMOD_CAPS", - "KMOD_MODE", - "KMOD_CTRL", - "KMOD_SHIFT", - "KMOD_ALT", - "KMOD_GUI", - "KMOD_META", - "APPMOUSEFOCUS", - "APPINPUTFOCUS", - "APPACTIVE", - "SYSTEM_CURSOR_ARROW", - "SYSTEM_CURSOR_IBEAM", - "SYSTEM_CURSOR_WAIT", - "SYSTEM_CURSOR_CROSSHAIR", - "SYSTEM_CURSOR_WAITARROW", - "SYSTEM_CURSOR_SIZENWSE", - "SYSTEM_CURSOR_SIZENESW", - "SYSTEM_CURSOR_SIZEWE", - "SYSTEM_CURSOR_SIZENS", - "SYSTEM_CURSOR_SIZEALL", - "SYSTEM_CURSOR_NO", - "SYSTEM_CURSOR_HAND", - "USEREVENT_DROPFILE", - "DIRECTION_LTR", - "DIRECTION_RTL", - "DIRECTION_TTB", - "DIRECTION_BTT", - "FONT_LEFT", - "FONT_CENTER", - "FONT_RIGHT", - "IS_CE", - "NULL_VIDEODRIVER", - "WINDOWPOS_UNDEFINED", - "WINDOWPOS_CENTERED", - "FLASH_CANCEL", - "FLASH_BRIEFLY", - "FLASH_UNTIL_FOCUSED", - "Rect", - "Color", -] diff --git a/.venv/lib/python3.14/site-packages/pygame/macosx.py b/.venv/lib/python3.14/site-packages/pygame/macosx.py index 73229d1..0a16d31 100644 --- a/.venv/lib/python3.14/site-packages/pygame/macosx.py +++ b/.venv/lib/python3.14/site-packages/pygame/macosx.py @@ -1,5 +1,5 @@ -import os import platform +import os import sys __all__ = ["Video_AutoInit"] diff --git a/.venv/lib/python3.14/site-packages/pygame/mask.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/mask.cpython-314-x86_64-linux-gnu.so index 0f0ddd6..99c94d9 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/mask.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/mask.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/mask.pyi b/.venv/lib/python3.14/site-packages/pygame/mask.pyi index 723603e..dbe248f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/mask.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/mask.pyi @@ -1,590 +1,59 @@ -"""Pygame module for image masks. - -Useful for fast pixel perfect collision detection. A mask uses 1 bit per-pixel -to store which parts collide. - -.. versionaddedold:: 1.8 - -.. versionchangedold:: 2.0.2 Mask functions now support keyword arguments. - -.. versionchangedold:: 2.0.2 Mask functions that take positions or offsets now - support :class:`pygame.math.Vector2` arguments. -""" - -import sys -from typing import Any +from typing import Any, List, Optional, Sequence, Tuple, Union from pygame.rect import Rect from pygame.surface import Surface -from pygame.typing import ColorLike, Point, RectLike -from typing_extensions import deprecated # added in 3.13 -def from_surface(surface: Surface, threshold: int = 127) -> Mask: - """Creates a Mask from the given surface. - - Creates a :class:`Mask` object from the given surface by setting all the - opaque pixels and not setting the transparent pixels. - - If the surface uses a color-key, then it is used to decide which bits in - the resulting mask are set. All the pixels that are **not** equal to the - color-key are **set** and the pixels equal to the color-key are not set. - - If a color-key is not used, then the alpha value of each pixel is used to - decide which bits in the resulting mask are set. All the pixels that have an - alpha value **greater than** the ``threshold`` parameter are **set** and the - pixels with an alpha value less than or equal to the ``threshold`` are - not set. - - :param Surface surface: the surface to create the mask from - :param int threshold: (optional) the alpha threshold (default is 127) to - compare with each surface pixel's alpha value, if the ``surface`` is - color-keyed this parameter is ignored - - :returns: a newly created :class:`Mask` object from the given surface - :rtype: Mask - - .. note:: - This function is used to create the masks for - :func:`pygame.sprite.collide_mask`. - """ +from ._common import ColorValue, Coordinate, RectValue +def from_surface(surface: Surface, threshold: int = 127) -> Mask: ... def from_threshold( surface: Surface, - color: ColorLike, - threshold: ColorLike = (0, 0, 0, 255), - othersurface: Surface | None = None, + color: ColorValue, + threshold: ColorValue = (0, 0, 0, 255), + othersurface: Optional[Surface] = None, palette_colors: int = 1, -) -> Mask: - """Creates a mask by thresholding Surfaces. - - This is a more featureful method of getting a :class:`Mask` from a surface. - - If the optional ``othersurface`` is not used, all the pixels **within** the - ``threshold`` of the ``color`` parameter are **set** in the resulting mask. - - If the optional ``othersurface`` is used, every pixel in the first surface - that is **within** the ``threshold`` of the corresponding pixel in - ``othersurface`` is **set** in the resulting mask. - - :param Surface surface: the surface to create the mask from - :param color: color used to check if the surface's pixels are within the - given ``threshold`` range, this parameter is ignored if the optional - ``othersurface`` parameter is supplied - :type color: :data:`pygame.typing.ColorLike` - :param threshold: (optional) the threshold range used to check the difference - between two colors (default is ``(0, 0, 0, 255)``) - :type threshold: :data:`pygame.typing.ColorLike` - :param Surface othersurface: (optional) used to check whether the pixels of - the first surface are within the given ``threshold`` range of the pixels - from this surface (default is ``None``) - :param int palette_colors: (optional) indicates whether to use the palette - colors or not, a nonzero value causes the palette colors to be used and a - 0 causes them not to be used (default is 1) - - :returns: a newly created :class:`Mask` object from the given surface - :rtype: Mask - """ +) -> Mask: ... class Mask: - """Pygame object for representing 2D bitmasks. - - A ``Mask`` object is used to represent a 2D bitmask. Each bit in - the mask represents a pixel. 1 is used to indicate a set bit and 0 is used - to indicate an unset bit. Set bits in a mask can be used to detect collisions - with other masks and their set bits. - - A filled mask has all of its bits set to 1, conversely an - unfilled/cleared/empty mask has all of its bits set to 0. Masks can be - created unfilled (default) or filled by using the ``fill`` parameter. Masks - can also be cleared or filled using the :func:`pygame.mask.Mask.clear()` and - :func:`pygame.mask.Mask.fill()` methods respectively. - - A mask's coordinates start in the top left corner at ``(0, 0)`` just like - :mod:`pygame.Surface`. Individual bits can be accessed using the - :func:`pygame.mask.Mask.get_at()` and :func:`pygame.mask.Mask.set_at()` - methods. - - .. _mask-offset-label: - - The methods :meth:`overlap`, :meth:`overlap_area`, :meth:`overlap_mask`, - :meth:`draw`, :meth:`erase`, and :meth:`convolve` use an offset parameter - to indicate the offset of another mask's top left corner from the calling - mask's top left corner. The calling mask's top left corner is considered to - be the origin ``(0, 0)``. Offsets are a sequence of two values - ``(x_offset, y_offset)``. Positive and negative offset values are supported. - - :: - - 0 to x (x_offset) - : : - 0 ..... +----:---------+ - to | : | - y .......... +-----------+ - (y_offset) | | othermask | - | +-----------+ - | calling_mask | - +--------------+ - - :param size: the dimensions of the mask (width and height) - :param bool fill: (optional) create an unfilled mask (default: ``False``) or - filled mask (``True``) - - :returns: a newly created :class:`Mask` object - :rtype: Mask - - .. versionchangedold:: 2.0.0 - Shallow copy support added. The :class:`Mask` class supports the special - method ``__copy__()`` and shallow copying via ``copy.copy(mask)``. - .. versionchangedold:: 2.0.0 Subclassing support added. The :class:`Mask` class - can be used as a base class. - .. versionchangedold:: 1.9.5 Added support for keyword arguments. - .. versionchangedold:: 1.9.5 Added the optional keyword parameter ``fill``. - .. versionchangedold:: 1.9.5 Added support for masks with a width and/or a - height of 0. - """ - - def __init__(self, size: Point, fill: bool = False) -> None: ... + def __init__(self, size: Coordinate, fill: bool = False) -> None: ... def __copy__(self) -> Mask: ... - def copy(self) -> Mask: - """Returns a new copy of the mask. - - :returns: a new copy of this mask, the new mask will have the same width, - height, and set/unset bits as the original - :rtype: Mask - - .. note:: - If a mask subclass needs to copy any instance specific attributes - then it should override the ``__copy__()`` method. The overridden - ``__copy__()`` method needs to call ``super().__copy__()`` and then - copy the required data as in the following example code. - - :: - - class SubMask(pygame.mask.Mask): - def __copy__(self): - new_mask = super().__copy__() - # Do any SubMask attribute copying here. - return new_mask - - .. versionaddedold:: 2.0.0 - """ - - def get_size(self) -> tuple[int, int]: - """Returns the size of the mask. - - :returns: the size of the mask, (width, height) - :rtype: tuple(int, int) - """ - - def get_rect(self, **kwargs: Any) -> Rect: # Dict type needs to be completed - """Returns a Rect based on the size of the mask. - - Returns a new :class:`pygame.Rect` object based on the size of this mask. - The rect's default position will be ``(0, 0)`` and its default width and - height will be the same as this mask's. The rect's attributes can be - altered via :class:`pygame.Rect` attribute keyword arguments/values passed - into this method. As an example, ``a_mask.get_rect(center=(10, 5))`` would - create a :class:`pygame.Rect` based on the mask's size centered at the - given position. - - :param dict kwargs: :class:`pygame.Rect` attribute keyword arguments/values - that will be applied to the rect - - :returns: A new :class:`pygame.Rect` object based on the size of this mask - with any :class:`pygame.Rect` attribute keyword arguments/values applied - to it - :rtype: Rect - - .. versionaddedold:: 2.0.0 - """ - - def get_at(self, pos: Point) -> int: - """Gets the bit at the given position. - - :param pos: the position of the bit to get (x, y) - - :returns: 1 if the bit is set, 0 if the bit is not set - :rtype: int - - :raises IndexError: if the position is outside of the mask's bounds - """ - - def set_at(self, pos: Point, value: int = 1) -> None: - """Sets the bit at the given position. - - :param pos: the position of the bit to set (x, y) - :param int value: any nonzero int will set the bit to 1, 0 will set the - bit to 0 (default is 1) - - :returns: ``None`` - :rtype: NoneType - - :raises IndexError: if the position is outside of the mask's bounds - """ - - def overlap(self, other: Mask, offset: Point) -> tuple[int, int] | None: - """Returns the point of intersection. - - Returns the first point of intersection encountered between this mask and - ``other``. A point of intersection is 2 overlapping set bits. - - The current algorithm searches the overlapping area in - ``sizeof(unsigned long int) * CHAR_BIT`` bit wide column blocks (the value - of ``sizeof(unsigned long int) * CHAR_BIT`` is platform dependent, for - clarity it will be referred to as ``W``). Starting at the top left corner - it checks bits 0 to ``W - 1`` of the first row (``(0, 0)`` to - ``(W - 1, 0)``) then continues to the next row (``(0, 1)`` to - ``(W - 1, 1)``). Once this entire column block is checked, it continues to - the next one (``W`` to ``2 * W - 1``). This is repeated until it finds a - point of intersection or the entire overlapping area is checked. - - :param Mask other: the other mask to overlap with this mask - :param offset: the offset of ``other`` from this mask, for more - details refer to the :ref:`Mask offset notes ` - - :returns: point of intersection or ``None`` if no intersection - :rtype: tuple(int, int) or NoneType - """ - - def overlap_area(self, other: Mask, offset: Point) -> int: - """Returns the number of overlapping set bits. - - Returns the number of overlapping set bits between this mask and - ``other``. - - This can be useful for collision detection. An approximate collision - normal can be found by calculating the gradient of the overlapping area - through the finite difference. - - :: - - dx = mask.overlap_area(other, (x + 1, y)) - mask.overlap_area(other, (x - 1, y)) - dy = mask.overlap_area(other, (x, y + 1)) - mask.overlap_area(other, (x, y - 1)) - - :param Mask other: the other mask to overlap with this mask - :param offset: the offset of ``other`` from this mask, for more - details refer to the :ref:`Mask offset notes ` - - :returns: the number of overlapping set bits - :rtype: int - """ - - def overlap_mask(self, other: Mask, offset: Point) -> Mask: - """Returns a mask of the overlapping set bits. - - Returns a :class:`Mask`, the same size as this mask, containing the - overlapping set bits between this mask and ``other``. - - :param Mask other: the other mask to overlap with this mask - :param offset: the offset of ``other`` from this mask, for more - details refer to the :ref:`Mask offset notes ` - - :returns: a newly created :class:`Mask` with the overlapping bits set - :rtype: Mask - """ - - def fill(self) -> None: - """Sets all bits to 1. - - Sets all bits in the mask to 1. - - :returns: ``None`` - :rtype: NoneType - """ - - def clear(self) -> None: - """Sets all bits to 0. - - Sets all bits in the mask to 0. - - :returns: ``None`` - :rtype: NoneType - """ - - def invert(self) -> None: - """Flips all the bits. - - Flips all of the bits in the mask. All the set bits are cleared to 0 and - all the unset bits are set to 1. - - :returns: ``None`` - :rtype: NoneType - """ - - def scale(self, scale: Point) -> Mask: - """Resizes a mask. - - Creates a new :class:`Mask` of the requested size with its bits scaled - from this mask. - - :param scale: the width and height (size) of the mask to create - - :returns: a new :class:`Mask` object with its bits scaled from this mask - :rtype: Mask - - :raises ValueError: if ``width < 0`` or ``height < 0`` - """ - - def draw(self, other: Mask, offset: Point) -> None: - """Draws a mask onto another. - - Performs a bitwise OR, drawing ``other`` onto this mask. - - :param Mask other: the mask to draw onto this mask - :param offset: the offset of ``other`` from this mask, for more - details refer to the :ref:`Mask offset notes ` - - :returns: ``None`` - :rtype: NoneType - """ - - def erase(self, other: Mask, offset: Point) -> None: - """Erases a mask from another. - - Erases (clears) all bits set in ``other`` from this mask. - - :param Mask other: the mask to erase from this mask - :param offset: the offset of ``other`` from this mask, for more - details refer to the :ref:`Mask offset notes ` - - :returns: ``None`` - :rtype: NoneType - """ - - def count(self) -> int: - """Returns the number of set bits. - - :returns: the number of set bits in the mask - :rtype: int - """ - - def centroid(self) -> tuple[int, int]: - """Returns the centroid of the set bits. - - Finds the centroid (the center mass of the set bits) for this mask. - - :returns: a coordinate tuple indicating the centroid of the mask, it will - return ``(0, 0)`` if the mask has no bits set - :rtype: tuple(int, int) - """ - - def angle(self) -> float: - """Returns the orientation of the set bits. - - Finds the approximate orientation (from -90 to 90 degrees) of the set bits - in the mask. This works best if performed on a mask with only one - connected component. - - :returns: the orientation of the set bits in the mask, it will return - ``0.0`` if the mask has no bits set - :rtype: float - - .. note:: - See :meth:`connected_component` for details on how a connected - component is calculated. - """ - - def outline(self, every: int = 1) -> list[tuple[int, int]]: - """Returns a list of points outlining an object. - - Returns a list of points of the outline of the first connected component - encountered in the mask. To find a connected component, the mask is - searched per row (left to right) starting in the top left corner. - - The ``every`` optional parameter skips set bits in the outline. For - example, setting it to 10 would return a list of every 10th set bit in the - outline. - - :param int every: (optional) indicates the number of bits to skip over in - the outline (default is 1) - - :returns: a list of points outlining the first connected component - encountered, an empty list is returned if the mask has no bits set - :rtype: list[tuple(int, int)] - - .. note:: - See :meth:`connected_component` for details on how a connected - component is calculated. - """ - + copy = __copy__ + def get_size(self) -> Tuple[int, int]: ... + def get_rect(self, **kwargs: Any) -> Rect: ... # Dict type needs to be completed + def get_at(self, pos: Coordinate) -> int: ... + def set_at(self, pos: Coordinate, value: int = 1) -> None: ... + def overlap(self, other: Mask, offset: Coordinate) -> Optional[Tuple[int, int]]: ... + def overlap_area(self, other: Mask, offset: Coordinate) -> int: ... + def overlap_mask(self, other: Mask, offset: Coordinate) -> Mask: ... + def fill(self) -> None: ... + def clear(self) -> None: ... + def invert(self) -> None: ... + def scale(self, scale: Coordinate) -> Mask: ... + def draw(self, other: Mask, offset: Coordinate) -> None: ... + def erase(self, other: Mask, offset: Coordinate) -> None: ... + def count(self) -> int: ... + def centroid(self) -> Tuple[int, int]: ... + def angle(self) -> float: ... + def outline(self, every: int = 1) -> List[Tuple[int, int]]: ... def convolve( self, other: Mask, - output: Mask | None = None, - offset: Point = (0, 0), - ) -> Mask: - """Returns the convolution of this mask with another mask. - - Convolve this mask with the given ``other`` Mask. - - :param Mask other: mask to convolve this mask with - :param output: (optional) mask for output (default is ``None``) - :type output: Mask or NoneType - :param offset: the offset of ``other`` from this mask, (default is - ``(0, 0)``) - - :returns: a :class:`Mask` with the ``(i - offset[0], j - offset[1])`` bit - set, if shifting ``other`` (such that its bottom right corner is at - ``(i, j)``) causes it to overlap with this mask - - If an ``output`` Mask is specified, the output is drawn onto it and - it is returned. Otherwise a mask of size ``(MAX(0, width + other mask's - width - 1), MAX(0, height + other mask's height - 1))`` is created and - returned. - - :rtype: Mask - """ - - def connected_component(self, pos: Point = ...) -> Mask: - """Returns a mask containing a connected component. - - A connected component is a group (1 or more) of connected set bits - (orthogonally and diagonally). The SAUF algorithm, which checks 8 point - connectivity, is used to find a connected component in the mask. - - By default this method will return a :class:`Mask` containing the largest - connected component in the mask. Optionally, a bit coordinate can be - specified and the connected component containing it will be returned. If - the bit at the given location is not set, the returned :class:`Mask` will - be empty (no bits set). - - :param pos: (optional) selects the connected component that contains the - bit at this position - - :returns: a :class:`Mask` object (same size as this mask) with the largest - connected component from this mask, if this mask has no bits set then - an empty mask will be returned - - If the ``pos`` parameter is provided then the mask returned will have - the connected component that contains this position. An empty mask will - be returned if the ``pos`` parameter selects an unset bit. - :rtype: Mask - - :raises IndexError: if the optional ``pos`` parameter is outside of the - mask's bounds - """ - - def connected_components(self, minimum: int = 0) -> list[Mask]: - """Returns a list of masks of connected components. - - Provides a list containing a :class:`Mask` object for each connected - component. - - :param int minimum: (optional) indicates the minimum number of bits (to - filter out noise) per connected component (default is 0, which equates - to no minimum and is equivalent to setting it to 1, as a connected - component must have at least 1 bit set) - - :returns: a list containing a :class:`Mask` object for each connected - component, an empty list is returned if the mask has no bits set - :rtype: list[Mask] - - .. note:: - See :meth:`connected_component` for details on how a connected - component is calculated. - """ - - def get_bounding_rects(self) -> list[Rect]: - """Returns a list of bounding rects of connected components. - - Provides a list containing a bounding rect for each connected component. - - :returns: a list containing a bounding rect for each connected component, - an empty list is returned if the mask has no bits set - :rtype: list[Rect] - - .. note:: - See :meth:`connected_component` for details on how a connected - component is calculated. - """ - + output: Optional[Mask] = None, + offset: Coordinate = (0, 0), + ) -> Mask: ... + def connected_component( + self, pos: Union[Sequence[int], Tuple[int, int]] = ... + ) -> Mask: ... + def connected_components(self, minimum: int = 0) -> List[Mask]: ... + def get_bounding_rects(self) -> Rect: ... def to_surface( self, - surface: Surface | None = None, - setsurface: Surface | None = None, - unsetsurface: Surface | None = None, - setcolor: ColorLike | None = (255, 255, 255, 255), - unsetcolor: ColorLike | None = (0, 0, 0, 255), - dest: RectLike | Point = (0, 0), - area: RectLike | None = None, - ) -> Surface: - """Returns a surface with the mask drawn on it. + surface: Optional[Surface] = None, + setsurface: Optional[Surface] = None, + unsetsurface: Optional[Surface] = None, + setcolor: Optional[ColorValue] = (255, 255, 255, 255), + unsetcolor: Optional[ColorValue] = (0, 0, 0, 255), + dest: Union[RectValue, Coordinate] = (0, 0), + ) -> Surface: ... - Draws this mask on the given surface. Set bits (bits set to 1) and unset - bits (bits set to 0) can be drawn onto a surface. - - :param surface: (optional) Surface to draw mask onto, if no surface is - provided one will be created (default is ``None``, which will cause a - surface with the parameters - ``Surface(size=mask.get_size(), flags=SRCALPHA, depth=32)`` to be - created, drawn on, and returned) - :type surface: Surface or None - :param setsurface: (optional) use this surface's color values to draw - set bits (default is ``None``), if this surface is smaller than the - mask any bits outside its bounds will use the ``setcolor`` value - :type setsurface: Surface or None - :param unsetsurface: (optional) use this surface's color values to draw - unset bits (default is ``None``), if this surface is smaller than the - mask any bits outside its bounds will use the ``unsetcolor`` value - :type unsetsurface: Surface or None - :param setcolor: (optional) color to draw set bits (default is - ``(255, 255, 255, 255)``, white), use ``None`` to skip drawing the set - bits, the ``setsurface`` parameter (if set) will takes precedence over - this parameter - :type setcolor: :data:`pygame.typing.ColorLike` or ``None`` - :param unsetcolor: (optional) color to draw unset bits (default is - ``(0, 0, 0, 255)``, black), use ``None`` to skip drawing the unset - bits, the ``unsetsurface`` parameter (if set) will takes precedence - over this parameter - :type unsetcolor: :data:`pygame.typing.ColorLike` or ``None`` - :param dest: (optional) surface destination of where to position the - topleft corner of the mask being drawn (default is ``(0, 0)``), if a - Rect is used as the ``dest`` parameter, its ``x`` and ``y`` attributes - will be used as the destination, **NOTE1:** rects with a negative width - or height value will not be normalized before using their ``x`` and - ``y`` values, **NOTE2:** this destination value is only used to - position the mask on the surface, it does not offset the ``setsurface`` - and ``unsetsurface`` from the mask, they are always aligned with the - mask (i.e. position ``(0, 0)`` on the mask always corresponds to - position ``(0, 0)`` on the ``setsurface`` and ``unsetsurface``) - :type dest: Rect or tuple(int, int) or list(int, int) or Vector2(int, int) - :param area: (optional) rectangular portion of the mask to draw. It can be a - rect-like object (a Rect, a tuple or a list with 4 numbers or an object with a - rect attribute, etc) or it can be None (the default) in which case it will use the - entire mask. If the given rect protrudes outside the bounds of the mask (as returned - by :meth:`get_rect`), it will get clipped to fit those boundaries. If the final rect - is smaller than the mask and no destination ``surface`` is given, the returned surface - will have the same size as this final rect. - :type area: Rect or rect-like object - - :returns: the ``surface`` parameter (or a newly created surface if no - ``surface`` parameter was provided) with this mask drawn on it - :rtype: Surface - - :raises ValueError: if the ``setsurface`` parameter or ``unsetsurface`` - parameter does not have the same format (bytesize/bitsize/alpha) as - the ``surface`` parameter - - .. note :: - To skip drawing the set bits, both ``setsurface`` and ``setcolor`` must - be ``None``. The ``setsurface`` parameter defaults to ``None``, but - ``setcolor`` defaults to a color value and therefore must be set to - ``None``. - - .. note :: - To skip drawing the unset bits, both ``unsetsurface`` and - ``unsetcolor`` must be ``None``. The ``unsetsurface`` parameter - defaults to ``None``, but ``unsetcolor`` defaults to a color value and - therefore must be set to ``None``. - - .. versionaddedold:: 2.0.0 - - .. versionchanged:: 2.5.6 Added the area keyword argument. - """ - - if sys.version_info >= (3, 12): - def __buffer__(self, flags: int, /) -> memoryview[int]: ... - def __release_buffer__(self, view: memoryview[int], /) -> None: ... - -@deprecated("Use `Mask` instead (MaskType is an old alias)") -class MaskType(Mask): ... +MaskType = Mask diff --git a/.venv/lib/python3.14/site-packages/pygame/math.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/math.cpython-314-x86_64-linux-gnu.so index 4e48da6..dc216e1 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/math.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/math.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/math.pyi b/.venv/lib/python3.14/site-packages/pygame/math.pyi index 6b2a32a..5ee662c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/math.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/math.pyi @@ -1,116 +1,29 @@ -"""Pygame module for vector classes. - -The pygame math module currently provides Vector classes in two and three -dimensions, ``Vector2`` and ``Vector3`` respectively. - -They support the following numerical operations: ``vec + vec``, ``vec - vec``, -``vec * number``, ``number * vec``, ``vec / number``, ``vec // number``, ``vec += vec``, -``vec -= vec``, ``vec *= number``, ``vec /= number``, ``vec //= number``, ``round(vec, ndigits=0)``. - -All these operations will be performed elementwise. -In addition ``vec * vec`` will perform a scalar-product (a.k.a. dot-product). -If you want to multiply every element from vector v with every element from -vector w you can use the elementwise method: ``v.elementwise() * w`` - -The coordinates of a vector can be retrieved or set using attributes or -subscripts - -:: - - v = pygame.Vector3() - - v.x = 5 - v[1] = 2 * v.x - print(v[1]) # 10 - - v.x == v[0] - v.y == v[1] - v.z == v[2] - -Multiple coordinates can be set and retrieved using slices or swizzling. - -:: - - v = pygame.Vector2() - v.xy = 1, 2 - v[:] = 1, 2 - print(v) # Vector2(1, 2) - print(v.x) # 1.0 - print(v.y) # 2.0 - print(v.xy) # Vector2(1, 2) - print(v.yx) # Vector2(2, 1) - print(v.xyyx) # (1.0, 2.0, 2.0, 1.0) - -Note above, that swizzling with 2 components will return a Vector2 instance, -swizzling with 3 components will return a Vector3 instance, and swizzles of 4 -or more components will result in a tuple. But since vectors support the -iterator protocol, they can be unpacked, or converted to lists or tuples. - -:: - - v = Vector2(1, 2) - print(*v) # 1.0 2.0 - print(tuple(v)) # (1.0, 2.0) - print(tuple(v.yx)) # (2.0, 1.0) - - -A vector can be converted to other data types using the built-in constructors - -:: - - v = pygame.Vector2(1, 2) - - list(v) == [1.0, 2.0] - tuple(v) == (1.0, 2.0) - set(v) == {1.0, 2.0} - -Conversion can be combined with swizzling or slicing to create a new order - -:: - - v = pygame.Vector3(1, 2, 3) - - list(v.xz) == [1.0, 3.0] - list(v.zyx) == [3.0, 2.0, 1.0] - list(v.yyy) == [2.0, 2.0, 2.0] - tuple(v.xyyzzz) == (1.0, 2.0, 2.0, 3.0, 3.0, 3.0) - tuple(v.zxyxzzyx) == (3.0, 1.0, 2.0, 1.0, 3.0, 3.0, 2.0, 1.0) - set(v.yxzxzyzxyx) == {1.0, 2.0, 3.0} # sets remove duplicates - - list(v[:]) == [1.0, 2.0, 3.0] - tuple(v[::-1]) == (3.0, 2.0, 1.0) - set(v[1:3]) == {2.0, 3.0} - -.. versionaddedold:: 1.9.2pre -.. versionchangedold:: 1.9.4 Removed experimental notice. -.. versionchangedold:: 1.9.4 Allow scalar construction like GLSL Vector2(2) == Vector2(2.0, 2.0) -.. versionchangedold:: 1.9.4 :mod:`pygame.math` import not required. More convenient ``pygame.Vector2`` and ``pygame.Vector3``. -.. versionchanged:: 2.1.4 `round` returns a new vector with components rounded to the specified digits. -""" - -from collections.abc import Collection, Iterator +import sys from typing import ( Any, - ClassVar, Generic, + Iterator, + List, Literal, - SupportsIndex, + Sequence, + Tuple, + Type, TypeVar, + Union, final, overload, + Optional, ) -from pygame.typing import SequenceLike -from typing_extensions import deprecated # added in 3.13 +from typing_extensions import Protocol -def clamp(value: float, min: float, max: float, /) -> float: - """Returns value clamped to min and max. +if sys.version_info >= (3, 9): + from collections.abc import Collection +else: + from typing import Collection - Clamps a numeric ``value`` so that it's no lower than ``min``, and no higher - than ``max``. - - .. versionadded:: 2.1.3 - """ +def lerp(a: float, b: float, weight: float) -> float: ... +def clamp(value: float, min: float, max: float) -> float: ... _TVec = TypeVar("_TVec", bound=_GenericVector) @@ -119,23 +32,23 @@ _TVec = TypeVar("_TVec", bound=_GenericVector) # Also used with _TVec generics class _GenericVector(Collection[float]): epsilon: float - __hash__: ClassVar[None] # type: ignore[assignment] + __hash__: None # type: ignore def __len__(self) -> int: ... @overload def __setitem__(self, key: int, value: float) -> None: ... @overload - def __setitem__(self, key: slice, value: SequenceLike[float] | _TVec) -> None: ... + def __setitem__(self, key: slice, value: Union[Sequence[float], _TVec]) -> None: ... @overload - def __getitem__(self, i: SupportsIndex) -> float: ... + def __getitem__(self, i: int) -> float: ... @overload - def __getitem__(self, s: slice) -> list[float]: ... + def __getitem__(self, s: slice) -> List[float]: ... def __iter__(self) -> VectorIterator: ... - def __add__(self: _TVec, other: SequenceLike[float] | _TVec) -> _TVec: ... - def __radd__(self: _TVec, other: SequenceLike[float] | _TVec) -> _TVec: ... - def __sub__(self: _TVec, other: SequenceLike[float] | _TVec) -> _TVec: ... - def __rsub__(self: _TVec, other: SequenceLike[float] | _TVec) -> _TVec: ... + def __add__(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... + def __radd__(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... + def __sub__(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... + def __rsub__(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... @overload - def __mul__(self: _TVec, other: SequenceLike[float] | _TVec) -> float: ... + def __mul__(self: _TVec, other: Union[Sequence[float], _TVec]) -> float: ... @overload def __mul__(self: _TVec, other: float) -> _TVec: ... def __rmul__(self: _TVec, other: float) -> _TVec: ... @@ -145,16 +58,17 @@ class _GenericVector(Collection[float]): def __neg__(self: _TVec) -> _TVec: ... def __pos__(self: _TVec) -> _TVec: ... def __bool__(self) -> bool: ... - def __iadd__(self: _TVec, other: SequenceLike[float] | _TVec) -> _TVec: ... - def __isub__(self: _TVec, other: SequenceLike[float] | _TVec) -> _TVec: ... + def __iadd__(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... + def __isub__(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... @overload - def __imul__(self: _TVec, other: SequenceLike[float] | _TVec) -> float: ... + def __imul__(self: _TVec, other: Union[Sequence[float], _TVec]) -> float: ... @overload def __imul__(self: _TVec, other: float) -> _TVec: ... def __copy__(self: _TVec) -> _TVec: ... - def copy(self: _TVec) -> _TVec: ... + copy = __copy__ + def __safe_for_unpickling__(self) -> Literal[True]: ... def __contains__(self, other: float) -> bool: ... # type: ignore[override] - def dot(self: _TVec, other: SequenceLike[float] | _TVec, /) -> float: ... + def dot(self: _TVec, other: Union[Sequence[float], _TVec]) -> float: ... def magnitude(self) -> float: ... def magnitude_squared(self) -> float: ... def length(self) -> float: ... @@ -162,42 +76,47 @@ class _GenericVector(Collection[float]): def normalize(self: _TVec) -> _TVec: ... def normalize_ip(self) -> None: ... def is_normalized(self) -> bool: ... - def scale_to_length(self, value: float, /) -> None: ... - def reflect(self: _TVec, other: SequenceLike[float] | _TVec, /) -> _TVec: ... - def reflect_ip(self: _TVec, other: SequenceLike[float] | _TVec, /) -> None: ... - def distance_to(self: _TVec, other: SequenceLike[float] | _TVec, /) -> float: ... + def scale_to_length(self, value: float) -> None: ... + def reflect(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... + def reflect_ip(self: _TVec, other: Union[Sequence[float], _TVec]) -> None: ... + def distance_to(self: _TVec, other: Union[Sequence[float], _TVec]) -> float: ... def distance_squared_to( - self: _TVec, other: SequenceLike[float] | _TVec, / + self: _TVec, other: Union[Sequence[float], _TVec] ) -> float: ... def lerp( - self: _TVec, other: SequenceLike[float] | _TVec, value: float, / + self: _TVec, + other: Union[Sequence[float], _TVec], + value: float, ) -> _TVec: ... def slerp( - self: _TVec, other: SequenceLike[float] | _TVec, value: float, / - ) -> _TVec: ... - def smoothstep( - self: _TVec, other: SequenceLike[float] | _TVec, value: float, / + self: _TVec, + other: Union[Sequence[float], _TVec], + value: float, ) -> _TVec: ... def elementwise(self: _TVec) -> VectorElementwiseProxy[_TVec]: ... - def angle_to(self: _TVec, other: SequenceLike[float] | _TVec, /) -> float: ... + def angle_to(self: _TVec, other: Union[Sequence[float], _TVec]) -> float: ... def move_towards( - self: _TVec, target: SequenceLike[float] | _TVec, max_distance: float, / + self: _TVec, + target: Union[Sequence[float], _TVec], + max_distance: float, ) -> _TVec: ... def move_towards_ip( - self: _TVec, target: SequenceLike[float] | _TVec, max_distance: float, / + self: _TVec, + target: Union[Sequence[float], _TVec], + max_distance: float, ) -> None: ... @overload - def clamp_magnitude(self: _TVec, max_length: float, /) -> _TVec: ... + def clamp_magnitude(self: _TVec, max_length: float) -> _TVec: ... @overload def clamp_magnitude( - self: _TVec, min_length: float, max_length: float, / + self: _TVec, min_length: float, max_length: float ) -> _TVec: ... @overload - def clamp_magnitude_ip(self, max_length: float, /) -> None: ... + def clamp_magnitude_ip(self, max_length: float) -> None: ... @overload - def clamp_magnitude_ip(self, min_length: float, max_length: float, /) -> None: ... - def project(self: _TVec, other: SequenceLike[float] | _TVec, /) -> _TVec: ... - def __round__(self: _TVec, ndigits: int | None = None, /) -> _TVec: ... + def clamp_magnitude_ip(self, min_length: float, max_length: float) -> None: ... + def project(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... + def __round__(self: _TVec, ndigits: Optional[int]) -> _TVec: ... # VectorElementwiseProxy is a generic, it can be an elementwiseproxy object for # Vector2, Vector3 and vector subclass objects @@ -205,79 +124,79 @@ class _GenericVector(Collection[float]): class VectorElementwiseProxy(Generic[_TVec]): def __add__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __radd__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __sub__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __rsub__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __mul__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __rmul__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __truediv__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __rtruediv__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __floordiv__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __rfloordiv__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __mod__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __rmod__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> _TVec: ... def __pow__( self, - power: float | _TVec | VectorElementwiseProxy[_TVec], + power: Union[float, _TVec, VectorElementwiseProxy[_TVec]], mod: None = None, ) -> _TVec: ... def __rpow__( self, - power: float | _TVec | VectorElementwiseProxy[_TVec], + power: Union[float, _TVec, VectorElementwiseProxy[_TVec]], mod: None = None, ) -> _TVec: ... def __eq__(self, other: Any) -> bool: ... def __ne__(self, other: Any) -> bool: ... def __gt__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> bool: ... def __lt__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> bool: ... def __ge__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> bool: ... def __le__( self, - other: float | _TVec | VectorElementwiseProxy[_TVec], + other: Union[float, _TVec, VectorElementwiseProxy[_TVec]], ) -> bool: ... def __abs__(self) -> _TVec: ... def __neg__(self) -> _TVec: ... @@ -290,6 +209,10 @@ class VectorIterator: def __iter__(self) -> Iterator[float]: ... def __next__(self) -> float: ... +# Not defined in code, only for type checking from_polar ClassObjectMethod +class _from_polar_protocol(Protocol): + def __call__(self, value: Tuple[float, float]) -> Optional[_TVec]: ... + class Vector2(_GenericVector): x: float y: float @@ -297,35 +220,34 @@ class Vector2(_GenericVector): xy: Vector2 yx: Vector2 yy: Vector2 - @property - def angle(self) -> float: ... - @property - def angle_rad(self) -> float: ... + from_polar: _from_polar_protocol @overload def __init__( self: _TVec, - x: str | float | SequenceLike[float] | _TVec = 0, + x: Union[str, float, Sequence[float], _TVec] = 0, ) -> None: ... @overload def __init__(self, x: float, y: float) -> None: ... - def __reduce__(self: _TVec) -> tuple[type[_TVec], tuple[float, float]]: ... - def rotate(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_rad(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_ip(self, angle: float, /) -> None: ... - def rotate_rad_ip(self, angle: float, /) -> None: ... - @deprecated("since 2.1.1. Use `pygame.Vector2.rotate_rad_ip` instead") - def rotate_ip_rad(self, angle: float, /) -> None: ... - def cross(self: _TVec, other: SequenceLike[float] | _TVec, /) -> float: ... - def as_polar(self) -> tuple[float, float]: ... - def from_polar(self, polar_value: SequenceLike[float], /) -> None: ... + def __reduce__(self: _TVec) -> Tuple[Type[_TVec], Tuple[float, float]]: ... + def rotate(self: _TVec, angle: float) -> _TVec: ... + def rotate_rad(self: _TVec, angle: float) -> _TVec: ... + def rotate_ip(self, angle: float) -> None: ... + def rotate_rad_ip(self, angle: float) -> None: ... + def rotate_ip_rad(self, angle: float) -> None: ... + def cross(self: _TVec, other: Union[Sequence[float], _TVec]) -> float: ... + def as_polar(self) -> Tuple[float, float]: ... @overload def update( self: _TVec, - x: str | float | SequenceLike[float] | _TVec = 0, + x: Union[str, float, Sequence[float], _TVec] = 0, ) -> None: ... @overload def update(self, x: float = 0, y: float = 0) -> None: ... +# Not defined in code, only for type checking from_spherical ClassObjectMethod +class _from_spherical_protocol(Protocol): + def __call__(self, value: Tuple[float, float, float]) -> Optional[_TVec]: ... + class Vector3(_GenericVector): x: float y: float @@ -366,145 +288,55 @@ class Vector3(_GenericVector): zzx: Vector3 zzy: Vector3 zzz: Vector3 + from_spherical: _from_spherical_protocol @overload def __init__( self: _TVec, - x: str | float | SequenceLike[float] | _TVec = 0, + x: Union[str, float, Sequence[float], _TVec] = 0, ) -> None: ... @overload def __init__(self, x: float, y: float, z: float) -> None: ... - def __reduce__(self: _TVec) -> tuple[type[_TVec], tuple[float, float, float]]: ... - def cross(self: _TVec, other: SequenceLike[float] | _TVec, /) -> _TVec: ... + def __reduce__(self: _TVec) -> Tuple[Type[_TVec], Tuple[float, float, float]]: ... + def cross(self: _TVec, other: Union[Sequence[float], _TVec]) -> _TVec: ... def rotate( - self: _TVec, angle: float, axis: SequenceLike[float] | _TVec, / + self: _TVec, angle: float, axis: Union[Sequence[float], _TVec] ) -> _TVec: ... def rotate_rad( - self: _TVec, angle: float, axis: SequenceLike[float] | _TVec, / + self: _TVec, angle: float, axis: Union[Sequence[float], _TVec] ) -> _TVec: ... def rotate_ip( - self: _TVec, angle: float, axis: SequenceLike[float] | _TVec, / + self: _TVec, angle: float, axis: Union[Sequence[float], _TVec] ) -> None: ... def rotate_rad_ip( - self: _TVec, angle: float, axis: SequenceLike[float] | _TVec, / + self: _TVec, angle: float, axis: Union[Sequence[float], _TVec] ) -> None: ... - @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_rad_ip` instead") def rotate_ip_rad( - self: _TVec, angle: float, axis: SequenceLike[float] | _TVec, / + self: _TVec, angle: float, axis: Union[Sequence[float], _TVec] ) -> None: ... - def rotate_x(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_x_rad(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_x_ip(self, angle: float, /) -> None: ... - def rotate_x_rad_ip(self, angle: float, /) -> None: ... - @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_x_rad_ip` instead") - def rotate_x_ip_rad(self, angle: float, /) -> None: ... - def rotate_y(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_y_rad(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_y_ip(self, angle: float, /) -> None: ... - def rotate_y_rad_ip(self, angle: float, /) -> None: ... - @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_y_rad_ip` instead") - def rotate_y_ip_rad(self, angle: float, /) -> None: ... - def rotate_z(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_z_rad(self: _TVec, angle: float, /) -> _TVec: ... - def rotate_z_ip(self, angle: float, /) -> None: ... - def rotate_z_rad_ip(self, angle: float, /) -> None: ... - @deprecated("since 2.1.1. Use `pygame.Vector3.rotate_z_rad_ip` instead") - def rotate_z_ip_rad(self, angle: float, /) -> None: ... - def as_spherical(self) -> tuple[float, float, float]: ... - def from_spherical(self, spherical: tuple[float, float, float], /) -> None: ... + def rotate_x(self: _TVec, angle: float) -> _TVec: ... + def rotate_x_rad(self: _TVec, angle: float) -> _TVec: ... + def rotate_x_ip(self, angle: float) -> None: ... + def rotate_x_rad_ip(self, angle: float) -> None: ... + def rotate_x_ip_rad(self, angle: float) -> None: ... + def rotate_y(self: _TVec, angle: float) -> _TVec: ... + def rotate_y_rad(self: _TVec, angle: float) -> _TVec: ... + def rotate_y_ip(self, angle: float) -> None: ... + def rotate_y_rad_ip(self, angle: float) -> None: ... + def rotate_y_ip_rad(self, angle: float) -> None: ... + def rotate_z(self: _TVec, angle: float) -> _TVec: ... + def rotate_z_rad(self: _TVec, angle: float) -> _TVec: ... + def rotate_z_ip(self, angle: float) -> None: ... + def rotate_z_rad_ip(self, angle: float) -> None: ... + def rotate_z_ip_rad(self, angle: float) -> None: ... + def as_spherical(self) -> Tuple[float, float, float]: ... @overload def update( self: _TVec, - x: str | float | SequenceLike[float] | _TVec = 0, + x: Union[str, float, Sequence[float], _TVec] = 0, ) -> None: ... @overload - def update(self, x: float = 0, y: float = 0, z: float = 0) -> None: ... + def update(self, x: int, y: int, z: int) -> None: ... -def lerp(a: float, b: float, value: float, do_clamp: bool = True, /) -> float: - """Returns value linearly interpolated between a and b. - - Returns a number which is a linear interpolation between ``a`` - and ``b``. The third parameter determines how far between ``a`` and - ``b`` the result is going to be. - If ``do_clamp`` is false, ``value`` is not clamped to ``[0, 1]``, - allowing extrapolation outside the range ``[a, b]``. - - The formula is: - - ``a + (b - a) * value``. - - .. versionadded:: 2.4.0 - """ - -def invlerp(a: float, b: float, value: float, /) -> float: - """Returns value inverse interpolated between a and b. - - Returns a number which is an inverse interpolation between ``a`` - and ``b``. The third parameter ``value`` is the result of the linear interpolation - between a and b with a certain coefficient. In other words, this coefficient - will be the result of this function. - If ``b`` and ``a`` are equal, it raises a ``ValueError``. - - The formula is: - - ``(v - a)/(b - a)``. - - This is an example explaining what is above : - - .. code-block:: python - - >>> a = 10 - >>> b = 20 - >>> pygame.math.invlerp(10, 20, 11.5) - 0.15 - >>> pygame.math.lerp(10, 20, 0.15) - 11.5 - - - .. versionadded:: 2.5.0 - """ - -def smoothstep(a: float, b: float, value: float, /) -> float: - """Returns value smoothly interpolated between a and b. - - Returns a number which is a smooth interpolation between ``a`` - and ``b``. This means that the interpolation follows an s-shaped curve, with - change happening more slowly near the limits (0.0 and 1.0) and faster in the middle. - The third parameter determines how far between ``a`` and - ``b`` the result is going to be. Value is clamped to ``[0, 1]``. - - The formula is: - - ``a * (1 - interp) + b * interp`` - - where: - - ``interp = value * value * (3 - 2 * value)`` - - .. versionadded:: 2.4.0 - """ - -def remap( - i_min: float, i_max: float, o_min: float, o_max: float, value: float, / -) -> float: - """Remaps value from given input range to given output range. - - Returns a number which is the value remapped from ``[i_min, i_max]`` range to - ``[o_min, o_max]`` range. - If ``i_min`` and ``i_max`` are equal, it raises a ``ValueError``. - - Example: - - .. code-block:: python - - >>> value = 50 - >>> pygame.math.remap(0, 100, 0, 200, value) - 100.0 - - - .. versionadded:: 2.5.0 - """ - -@deprecated("Functionality is removed") +# typehints for deprecated functions, to be removed in a future version def enable_swizzling() -> None: ... -@deprecated("Functionality is removed") def disable_swizzling() -> None: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/midi.py b/.venv/lib/python3.14/site-packages/pygame/midi.py index 4838726..24830f6 100644 --- a/.venv/lib/python3.14/site-packages/pygame/midi.py +++ b/.venv/lib/python3.14/site-packages/pygame/midi.py @@ -22,11 +22,12 @@ New in pygame 1.9.0. # - that can automatically inject input into the event queue # once the input object is running. Like joysticks. -import atexit import math +import atexit import pygame import pygame.locals + import pygame.pypm as _pypm # For backward compatibility. @@ -232,8 +233,8 @@ def get_device_info(an_id): input, output, opened) - interf - a text string describing the device interface, eg 'ALSA'. - name - a text string for the name of the device, eg 'Midi Through Port-0' + interf - a byte string describing the device interface, eg b'ALSA'. + name - a byte string for the name of the device, eg b'Midi Through Port-0' input - 0, or 1 if the device is an input device. output - 0, or 1 if the device is an output device. opened - 0, or 1 if the device is opened. @@ -500,7 +501,7 @@ class Output: Output.write_short(status) Output.write_short(status, data1 = 0, data2 = 0) - output MIDI information of 3 bytes or fewer. + output MIDI information of 3 bytes or less. data fields are optional status byte could be: 0xc0 = program change @@ -610,7 +611,7 @@ class Output: # # 0x80 Note Off (note_off) # 0x90 Note On (note_on) -# 0xA0 After-touch +# 0xA0 Aftertouch # 0xB0 Continuous controller # 0xC0 Patch change (set_instrument?) # 0xD0 Channel Pressure diff --git a/.venv/lib/python3.14/site-packages/pygame/midi.pyi b/.venv/lib/python3.14/site-packages/pygame/midi.pyi index b70433d..ee383ef 100644 --- a/.venv/lib/python3.14/site-packages/pygame/midi.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/midi.pyi @@ -1,7 +1,6 @@ -from collections.abc import Iterable +from typing import List, Sequence, Tuple, Union from pygame.event import Event -from pygame.typing import SequenceLike MIDIIN: int MIDIOUT: int @@ -15,10 +14,10 @@ def get_init() -> bool: ... def get_count() -> int: ... def get_default_input_id() -> int: ... def get_default_output_id() -> int: ... -def get_device_info(an_id: int) -> tuple[str, str, int, int, int]: ... +def get_device_info(an_id: int) -> Tuple[bytes, bytes, int, int, int]: ... def midis2events( - midis: Iterable[SequenceLike[SequenceLike[int] | int]], device_id: int -) -> list[Event]: ... + midis: Sequence[Sequence[Union[Sequence[int], int]]], device_id: int +) -> List[Event]: ... def time() -> int: ... def frequency_to_midi(frequency: float) -> int: ... def midi_to_frequency(midi_note: int) -> float: ... @@ -29,7 +28,7 @@ class Input: def __init__(self, device_id: int, buffer_size: int = 4096) -> None: ... def close(self) -> None: ... def poll(self) -> bool: ... - def read(self, num_events: int) -> list[list[list[int] | int]]: ... + def read(self, num_events: int) -> List[List[Union[List[int], int]]]: ... class Output: device_id: int @@ -45,27 +44,6 @@ class Output: def note_on(self, note: int, velocity: int, channel: int = 0) -> None: ... def set_instrument(self, instrument_id: int, channel: int = 0) -> None: ... def pitch_bend(self, value: int = 0, channel: int = 0) -> None: ... - def write(self, data: Iterable[SequenceLike[SequenceLike[int] | int]]) -> None: ... + def write(self, data: List[List[Union[List[int], int]]]) -> None: ... def write_short(self, status: int, data1: int = 0, data2: int = 0) -> None: ... - def write_sys_ex(self, when: int, msg: list[int] | str) -> None: ... - -# keep in sync with midi.py -__all__ = [ - "Input", - "MIDIIN", - "MIDIOUT", - "MidiException", - "Output", - "get_count", - "get_default_input_id", - "get_default_output_id", - "get_device_info", - "init", - "midis2events", - "quit", - "get_init", - "time", - "frequency_to_midi", - "midi_to_frequency", - "midi_to_ansi_note", -] + def write_sys_ex(self, when: int, msg: Union[List[int], str]) -> None: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/mixer.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/mixer.cpython-314-x86_64-linux-gnu.so index fb57962..496e3eb 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/mixer.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/mixer.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/mixer.pyi b/.venv/lib/python3.14/site-packages/pygame/mixer.pyi index 0e16d7e..5b0e13a 100644 --- a/.venv/lib/python3.14/site-packages/pygame/mixer.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/mixer.pyi @@ -1,14 +1,11 @@ -import sys -from typing import Any, Literal, overload +from typing import Any, Dict, Optional, Tuple, Union, final, overload -from pygame.typing import FileLike -from typing_extensions import ( - Buffer, # collections.abc 3.12 - Self, - deprecated, # added in 3.13 -) +import numpy + +from pygame.event import Event from . import mixer_music +from ._common import FileArg # export mixer_music as mixer.music music = mixer_music @@ -18,7 +15,7 @@ def init( size: int = -16, channels: int = 2, buffer: int = 512, - devicename: str | None = None, + devicename: Optional[str] = None, allowedchanges: int = 5, ) -> None: ... def pre_init( @@ -26,33 +23,33 @@ def pre_init( size: int = -16, channels: int = 2, buffer: int = 512, - devicename: str | None = None, + devicename: Optional[str] = None, allowedchanges: int = 5, ) -> None: ... def quit() -> None: ... -def get_init() -> tuple[int, int, int] | None: ... -def get_driver() -> str: ... +def get_init() -> Tuple[int, int, int]: ... def stop() -> None: ... def pause() -> None: ... def unpause() -> None: ... -def fadeout(time: int, /) -> None: ... -def set_num_channels(count: int, /) -> None: ... +def fadeout(time: int) -> None: ... +def set_num_channels(count: int) -> None: ... def get_num_channels() -> int: ... -def set_reserved(count: int, /) -> int: ... -@overload -def find_channel(force: Literal[True]) -> Channel: ... -@overload -def find_channel(force: bool = False) -> Channel | None: ... -def set_soundfont(paths: str | None = None, /) -> None: ... -def get_soundfont() -> str | None: ... +def set_reserved(count: int) -> int: ... +def find_channel(force: bool = False) -> Channel: ... def get_busy() -> bool: ... -def get_sdl_mixer_version(linked: bool = True) -> tuple[int, int, int]: ... +def get_sdl_mixer_version(linked: bool = True) -> Tuple[int, int, int]: ... class Sound: @overload - def __init__(self, file: FileLike) -> None: ... + def __init__(self, file: FileArg) -> None: ... @overload - def __init__(self, buffer: Buffer) -> None: ... + def __init__( + self, buffer: Any + ) -> None: ... # Buffer protocol is still not implemented in typing + @overload + def __init__( + self, array: numpy.ndarray + ) -> None: ... # Buffer protocol is still not implemented in typing def play( self, loops: int = 0, @@ -61,27 +58,19 @@ class Sound: ) -> Channel: ... # possibly going to be deprecated/removed soon, in which case these # typestubs must be removed too - @property - def __array_interface__(self) -> dict[str, Any]: ... - @property - def __array_struct__(self) -> Any: ... - if sys.version_info >= (3, 12): - def __buffer__(self, flags: int, /) -> memoryview[int]: ... - def __release_buffer__(self, view: memoryview[int], /) -> None: ... + __array_interface__: Dict[str, Any] + __array_struct__: Any def stop(self) -> None: ... - def fadeout(self, time: int, /) -> None: ... - def set_volume(self, value: float, /) -> None: ... + def fadeout(self, time: int) -> None: ... + def set_volume(self, value: float) -> None: ... def get_volume(self) -> float: ... def get_num_channels(self) -> int: ... def get_length(self) -> float: ... def get_raw(self) -> bytes: ... - def copy(self) -> Self: ... - def __copy__(self) -> Self: ... +@final class Channel: def __init__(self, id: int) -> None: ... - @property - def id(self) -> int: ... def play( self, sound: Sound, @@ -92,22 +81,18 @@ class Channel: def stop(self) -> None: ... def pause(self) -> None: ... def unpause(self) -> None: ... - def fadeout(self, time: int, /) -> None: ... - def queue(self, sound: Sound, /) -> None: ... - def set_source_location(self, angle: float, distance: float, /) -> None: ... + def fadeout(self, time: int) -> None: ... + def queue(self, sound: Sound) -> None: ... @overload - def set_volume(self, value: float, /) -> None: ... + def set_volume(self, value: float) -> None: ... @overload - def set_volume(self, left: float, right: float, /) -> None: ... + def set_volume(self, left: float, right: float) -> None: ... def get_volume(self) -> float: ... def get_busy(self) -> bool: ... - def get_sound(self) -> Sound | None: ... - def get_queue(self) -> Sound | None: ... - def set_endevent(self, type: int = 0, /) -> None: ... + def get_sound(self) -> Sound: ... + def get_queue(self) -> Sound: ... + def set_endevent(self, type: Union[int, Event] = 0) -> None: ... def get_endevent(self) -> int: ... -@deprecated("Use `Sound` instead (SoundType is an old alias)") -class SoundType(Sound): ... - -@deprecated("Use `Channel` instead (ChannelType is an old alias)") -class ChannelType(Channel): ... +SoundType = Sound +ChannelType = Channel diff --git a/.venv/lib/python3.14/site-packages/pygame/mixer_music.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/mixer_music.cpython-314-x86_64-linux-gnu.so index cf988af..2545d56 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/mixer_music.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/mixer_music.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/mixer_music.pyi b/.venv/lib/python3.14/site-packages/pygame/mixer_music.pyi index ec61c92..0c0f198 100644 --- a/.venv/lib/python3.14/site-packages/pygame/mixer_music.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/mixer_music.pyi @@ -1,30 +1,20 @@ -from typing import TypedDict, overload +from typing import Optional -from pygame.typing import FileLike +from ._common import FileArg -class _MusicMetadataDict(TypedDict): - title: str - album: str - artist: str - copyright: str - -def load(filename: FileLike, namehint: str = "") -> None: ... +def load(filename: FileArg, namehint: Optional[str] = "") -> None: ... def unload() -> None: ... def play(loops: int = 0, start: float = 0.0, fade_ms: int = 0) -> None: ... def rewind() -> None: ... def stop() -> None: ... def pause() -> None: ... def unpause() -> None: ... -def fadeout(time: int, /) -> None: ... -def set_volume(volume: float, /) -> None: ... +def fadeout(time: int) -> None: ... +def set_volume(volume: float) -> None: ... def get_volume() -> float: ... def get_busy() -> bool: ... -def set_pos(pos: float, /) -> None: ... +def set_pos(pos: float) -> None: ... def get_pos() -> int: ... -def queue(filename: FileLike, namehint: str = "", loops: int = 0) -> None: ... -def set_endevent(event_type: int, /) -> None: ... +def queue(filename: FileArg, namehint: str = "", loops: int = 0) -> None: ... +def set_endevent(event_type: int) -> None: ... def get_endevent() -> int: ... -@overload -def get_metadata() -> _MusicMetadataDict: ... -@overload -def get_metadata(filename: FileLike, namehint: str = "") -> _MusicMetadataDict: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/mouse.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/mouse.cpython-314-x86_64-linux-gnu.so index 140505d..ab296f9 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/mouse.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/mouse.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/mouse.pyi b/.venv/lib/python3.14/site-packages/pygame/mouse.pyi index c47d60d..088f2ea 100644 --- a/.venv/lib/python3.14/site-packages/pygame/mouse.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/mouse.pyi @@ -1,297 +1,35 @@ -"""Pygame module to work with the mouse. - -The mouse functions can be used to get the current state of the mouse device. -These functions can also alter the system cursor for the mouse. - -When the display mode is set, the event queue will start receiving mouse -events. The mouse buttons generate ``pygame.MOUSEBUTTONDOWN`` and -``pygame.MOUSEBUTTONUP`` events when they are pressed and released. These -events contain a button attribute representing which button was pressed. The -mouse wheel will generate ``pygame.MOUSEBUTTONDOWN`` and -``pygame.MOUSEBUTTONUP`` events when rolled. The button will be set to 4 -when the wheel is rolled up, and to button 5 when the wheel is rolled down. -Whenever the mouse is moved it generates a ``pygame.MOUSEMOTION`` event. The -mouse movement is broken into small and accurate motion events. As the mouse -is moving many motion events will be placed on the queue. Mouse motion events -that are not properly cleaned from the event queue are the primary reason the -event queue fills up. - -If the mouse cursor is hidden, and input is grabbed to the current display the -mouse will enter a virtual input mode, where the relative movements of the -mouse will never be stopped by the borders of the screen. See the functions -``pygame.mouse.set_visible()`` and ``pygame.event.set_grab()`` to get this -configured. - -**Mouse Wheel Behavior in pygame 2** - -There is proper functionality for mouse wheel behaviour with pygame 2 supporting -``pygame.MOUSEWHEEL`` events. The new events support horizontal and vertical -scroll movements, with signed integer values representing the amount scrolled -(``x`` and ``y``), as well as ``flipped`` direction (the set positive and -negative values for each axis is flipped). Read more about SDL2 -input-related changes here ``_ - -In pygame 2, the mouse wheel functionality can be used by listening for the -``pygame.MOUSEWHEEL`` type of an event (Bear in mind they still emit -``pygame.MOUSEBUTTONDOWN`` events like in pygame 1.x, as well). -When this event is triggered, a developer can access the appropriate ``Event`` object -with ``pygame.event.get()``. The object can be used to access data about the mouse -scroll, such as ``which`` (it will tell you what exact mouse device trigger the event). - -.. code-block:: python - :caption: Code example of mouse scroll (tested on 2.0.0.dev7) - :name: test.py - - # Taken from husano896's PR thread (slightly modified) - import pygame - from pygame.locals import * - pygame.init() - screen = pygame.display.set_mode((640, 480)) - clock = pygame.time.Clock() - - def main(): - while True: - for event in pygame.event.get(): - if event.type == QUIT: - pygame.quit() - return - elif event.type == MOUSEWHEEL: - print(event) - print(event.x, event.y) - print(event.flipped) - print(event.which) - # can access properties with - # proper notation(ex: event.y) - clock.tick(60) - - # Execute game: - main() -""" - -from typing import Any, Literal, overload - +from typing import Sequence, Tuple, Union, overload +from typing_extensions import Literal from pygame.cursors import Cursor from pygame.surface import Surface -from pygame.typing import IntPoint, Point, SequenceLike -from typing_extensions import deprecated # added in 3.13 @overload -def get_pressed( - num_buttons: Literal[3] = 3, desktop: bool = False -) -> tuple[bool, bool, bool]: ... +def get_pressed(num_buttons: Literal[3] = 3) -> Tuple[bool, bool, bool]: ... @overload -def get_pressed( - num_buttons: Literal[5], desktop: bool = False -) -> tuple[bool, bool, bool, bool, bool]: ... -def get_pressed(*args, **kwargs) -> Any: # type: ignore - """Get the state of the mouse buttons. - - Returns a sequence of booleans representing the state of all the mouse - buttons. A true value means the mouse is currently being pressed at the time - of the call. - - To get all of the mouse events it is better to use either - ``pygame.event.wait()`` or ``pygame.event.get()`` and check all of those - events to see if they are ``MOUSEBUTTONDOWN``, ``MOUSEBUTTONUP``, or - ``MOUSEMOTION``. Remember to call ``pygame.event.get()`` or ``pygame.event.pump()`` - before this function, otherwise it will not work as expected. - - To support five button mice, an optional parameter ``num_buttons`` has been - added in pygame 2. When this is set to ``5``, ``button4`` and ``button5`` - are added to the returned tuple. Only ``3`` and ``5`` are valid values - for this parameter. - - If the ``desktop`` argument is ``True`` the mouse state will be correct even - if the window has no focus. In addition since it queries the OS it does not depend - on the last event pump while being slightly slower. - - .. note:: On ``X11`` some X servers use middle button emulation. When you - click both buttons ``1`` and ``3`` at the same time a ``2`` button event - can be emitted. - - .. warning:: Due to design constraints it is impossible to retrieve the desktop - mouse state on Wayland. The normal mouse state is returned instead. - - .. versionchangedold:: 2.0.0 ``num_buttons`` argument added - - .. versionchanged:: 2.5.2 Added the ``desktop`` argument - """ - -def get_just_pressed() -> tuple[bool, bool, bool, bool, bool]: - """Get the most recently pressed buttons. - - Very similar to :func:`pygame.mouse.get_pressed()`, returning a tuple - of length 5 with the important difference that the buttons are - True only in the frame they start being pressed. This can be convenient - for checking the buttons pressed "this frame", but for more precise results - and correct ordering prefer using the ``pygame.MOUSEBUTTONDOWN`` event. - - The result of this function is updated when new events are processed, - e.g. in :func:`pygame.event.get()` or :func:`pygame.event.pump()`. - - .. seealso:: :func:`pygame.mouse.get_just_released()` - - :: - - if pygame.mouse.get_just_pressed()[0]: - print("LMB just pressed") - - .. versionadded:: 2.5.0 - """ - -def get_just_released() -> tuple[bool, bool, bool, bool, bool]: - """Get the most recently released buttons. - - Similar to :func:`pygame.mouse.get_pressed()`, returning a tuple - of length 5 with the important difference that the buttons are - True only in the frame they stop being pressed. This can be convenient - for checking the buttons released "this frame", but for more precise results - and correct ordering prefer using the ``pygame.MOUSEBUTTONUP`` event. - - The result of this function is updated when new events are processed, - e.g. in :func:`pygame.event.get()` or :func:`pygame.event.pump()`. - - .. seealso:: :func:`pygame.mouse.get_just_pressed()` - - :: - - if pygame.mouse.get_just_released()[0]: - print("LMB just released") - - .. versionadded:: 2.5.0 - """ - -def get_pos(desktop: bool = False) -> tuple[int, int]: - """Get the mouse cursor position. - - By default returns the ``x`` and ``y`` position of the mouse cursor. The position - is relative to the top-left corner of the display. The cursor position can be - located outside of the display window, but is always constrained to the screen. - - If the ``desktop`` argument is ``True``, the position will be instead relative to the - top-left corner of the primary monitor. The position might be negative or exceed - the desktop bounds if multiple monitors are present. - - .. warning:: Due to design constraints it is impossible to retrieve the desktop - mouse state on Wayland. The relative mouse position is returned instead. - - .. versionchanged:: 2.5.2 Added the ``desktop`` argument - """ - -def get_rel() -> tuple[int, int]: - """Get the amount of mouse movement. - - Returns the amount of movement in ``x`` and ``y`` since the previous call to - this function. The relative movement of the mouse cursor is constrained to - the edges of the screen, but see the virtual input mouse mode for a way - around this. Virtual input mode is described at the top of the page. - """ - +def get_pressed(num_buttons: Literal[5]) -> Tuple[bool, bool, bool, bool, bool]: ... +def get_pos() -> Tuple[int, int]: ... +def get_rel() -> Tuple[int, int]: ... @overload -def set_pos(pos: Point, /) -> None: ... +def set_pos(pos: Union[Sequence[float], Tuple[float, float]]) -> None: ... @overload -def set_pos(x: float, y: float, /) -> None: ... -def set_pos(*args) -> None: # type: ignore - """Set the mouse cursor position. - - Set the current mouse position to arguments given. If the mouse cursor is - visible it will jump to the new coordinates. Moving the mouse will generate - a new ``pygame.MOUSEMOTION`` event. - """ - -def set_visible(value: bool, /) -> int: - """Hide or show the mouse cursor. - - If the bool argument is true, the mouse cursor will be visible. This will - return the previous visible state of the cursor. - """ - -def get_visible() -> bool: - """Get the current visibility state of the mouse cursor. - - Get the current visibility state of the mouse cursor. ``True`` if the mouse is - visible, ``False`` otherwise. - - .. versionaddedold:: 2.0.0 - """ - -def get_focused() -> bool: - """Check if the display is receiving mouse input. - - Returns true when pygame is receiving mouse input events (or, in windowing - terminology, is "active" or has the "focus"). - - This method is most useful when working in a window. By contrast, in - full-screen mode, this method always returns true. - - Note: under ``MS`` Windows, the window that has the mouse focus also has the - keyboard focus. But under X-Windows, one window can receive mouse events and - another receive keyboard events. ``pygame.mouse.get_focused()`` indicates - whether the pygame window receives mouse events. - """ - +def set_pos(x: float, y: float) -> None: ... +def set_visible(value: bool | Literal[0] | Literal[1]) -> int: ... +def get_visible() -> bool: ... +def get_focused() -> bool: ... @overload def set_cursor(cursor: Cursor) -> None: ... @overload +def set_cursor(constant: int) -> None: ... +@overload def set_cursor( - size: IntPoint, - hotspot: IntPoint, - xormasks: SequenceLike[int], - andmasks: SequenceLike[int], + size: Union[Tuple[int, int], Sequence[int]], + hotspot: Union[Tuple[int, int], Sequence[int]], + xormasks: Sequence[int], + andmasks: Sequence[int], ) -> None: ... @overload -def set_cursor(hotspot: IntPoint, surface: Surface) -> None: ... -@overload -def set_cursor(constant: int) -> None: ... -def set_cursor(*args, **kwargs) -> None: # type: ignore - """Set the mouse cursor to a new cursor. - - Set the mouse cursor to something new. This function accepts either an explicit - ``Cursor`` object or arguments to create a ``Cursor`` object. - - See :class:`pygame.cursors.Cursor` for help creating cursors and for examples. - - .. versionchangedold:: 2.0.1 - """ - -def get_cursor() -> Cursor: - """Get the current mouse cursor. - - Get the information about the mouse system cursor. The return value contains - the same data as the arguments passed into :func:`pygame.mouse.set_cursor()`. - - .. note:: Code that unpacked a get_cursor() call into - ``size, hotspot, xormasks, andmasks`` will still work, - assuming the call returns an old school type cursor. - - .. versionchangedold:: 2.0.1 - """ - -@deprecated("since 2.2.0. Use `pygame.mouse.set_cursor` instead") -def set_system_cursor(cursor: int, /) -> None: ... -def get_relative_mode() -> bool: - """Query whether relative mouse mode is enabled. - - Query whether relative mouse mode is enabled. - - .. versionadded:: 2.4.0 - """ - -def set_relative_mode(enable: bool, /) -> None: - """Set relative mouse mode. - - Sets the relative mouse mode state. - While the mouse is in relative mode, the cursor is hidden, - the mouse position is constrained to the window, and pygame - will report continuous relative mouse motion even if the - mouse is at the edge of the window. - - *This function will flush any pending mouse motion."* - - Calling :func:`pygame.mouse.set_visible` with argument - ``True`` will exit relative mouse mode. - - .. versionadded:: 2.4.0 - .. versionchanged:: 2.5.6 calling this function before calling - :func:`pygame.display.set_mode` is deprecated and may error in the future. - """ +def set_cursor( + hotspot: Union[Tuple[int, int], Sequence[int]], surface: Surface +) -> None: ... +def get_cursor() -> Cursor: ... +def set_system_cursor(cursor: int) -> None: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/newbuffer.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/newbuffer.cpython-314-x86_64-linux-gnu.so index d30630e..35a0634 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/newbuffer.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/newbuffer.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/pixelarray.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/pixelarray.cpython-314-x86_64-linux-gnu.so index a18cca7..6bd4839 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/pixelarray.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/pixelarray.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/pixelarray.pyi b/.venv/lib/python3.14/site-packages/pygame/pixelarray.pyi index f889d58..a4c3e9d 100644 --- a/.venv/lib/python3.14/site-packages/pygame/pixelarray.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/pixelarray.pyi @@ -1,68 +1,41 @@ -import sys -from types import EllipsisType -from typing import Any, TypeAlias, overload +from typing import Any, Dict, Sequence, Tuple -from pygame.color import Color from pygame.surface import Surface -from pygame.typing import SequenceLike -_PixelColor: TypeAlias = int | Color | tuple[int, int, int] | tuple[int, int, int, int] +from ._common import ColorValue class PixelArray: - @property - def surface(self) -> Surface: ... - @property - def itemsize(self) -> int: ... - @property - def ndim(self) -> int: ... - @property - def shape(self) -> tuple[int, ...]: ... - @property - def strides(self) -> tuple[int, ...]: ... + surface: Surface + itemsize: int + ndim: int + shape: Tuple[int, ...] + strides: Tuple[int, ...] # possibly going to be deprecated/removed soon, in which case these # typestubs must be removed too - @property - def __array_interface__(self) -> dict[str, Any]: ... - @property - def __array_struct__(self) -> Any: ... - if sys.version_info >= (3, 12): - def __buffer__(self, flags: int, /) -> memoryview[int]: ... - def __new__(cls, surface: Surface) -> PixelArray: ... + __array_interface__: Dict[str, Any] + __array_struct__: Any + def __init__(self, surface: Surface) -> None: ... def __enter__(self) -> PixelArray: ... def __exit__(self, *args, **kwargs) -> None: ... - # if indexing into a 2D PixelArray, a 1D PixelArray will be returned - # if indexing into a 1D PixelArray, an int will be returned - @overload - def __getitem__(self, index: int) -> PixelArray | int: ... - # complicated, but I'm pretty sure this is guaranteed to return a PixelArray or None - # will only return None if the slice start and end are the same - @overload - def __getitem__(self, index_range: slice) -> PixelArray | None: ... - # only valid for a 2D PixelArray - @overload - def __getitem__(self, indices: tuple[int, int]) -> int: ... - # returns self - @overload - def __getitem__(self, ell: EllipsisType) -> PixelArray: ... def make_surface(self) -> Surface: ... def replace( self, - color: _PixelColor, - repcolor: _PixelColor, + color: ColorValue, + repcolor: ColorValue, distance: float = 0, - weights: SequenceLike[float] = (0.299, 0.587, 0.114), + weights: Sequence[float] = (0.299, 0.587, 0.114), ) -> None: ... def extract( self, - color: _PixelColor, + color: ColorValue, distance: float = 0, - weights: SequenceLike[float] = (0.299, 0.587, 0.114), + weights: Sequence[float] = (0.299, 0.587, 0.114), ) -> PixelArray: ... def compare( self, array: PixelArray, distance: float = 0, - weights: SequenceLike[float] = (0.299, 0.587, 0.114), + weights: Sequence[float] = (0.299, 0.587, 0.114), ) -> PixelArray: ... def transpose(self) -> PixelArray: ... - def close(self) -> None: ... + def close(self) -> PixelArray: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/pixelcopy.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/pixelcopy.cpython-314-x86_64-linux-gnu.so index 07ef29a..2fce06c 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/pixelcopy.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/pixelcopy.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/pixelcopy.pyi b/.venv/lib/python3.14/site-packages/pygame/pixelcopy.pyi index 6e60e0e..8bcbe89 100644 --- a/.venv/lib/python3.14/site-packages/pygame/pixelcopy.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/pixelcopy.pyi @@ -1,98 +1,20 @@ -"""Pygame module for general pixel array copying. - -The ``pygame.pixelcopy`` module contains functions for copying between -surfaces and objects exporting an array structure interface. It is a backend -for :mod:`pygame.surfarray`, adding NumPy support. But pixelcopy is more -general, and intended for direct use. - -The array struct interface exposes an array's data in a standard way. -It was introduced in NumPy. In Python 2.7 and above it is replaced by the -new buffer protocol, though the buffer protocol is still a work in progress. -The array struct interface, on the other hand, is stable and works with earlier -Python versions. So for now the array struct interface is the predominate way -pygame handles array introspection. - -For 2d arrays of integer pixel values, the values are mapped to the -pixel format of the related surface. To get the actual color of a pixel -value use :meth:`pygame.Surface.unmap_rgb`. 2d arrays can only be used -directly between surfaces having the same pixel layout. - -New in pygame 1.9.2. -""" - -from typing import Literal, TypeAlias - import numpy + from pygame.surface import Surface -_Kind: TypeAlias = Literal["P", "p", "R", "r", "G", "g", "B", "b", "A", "a", "C", "c"] +from ._common import Literal + +_kind = Literal["P", "p", "R", "r", "G", "g", "B", "b", "A", "a", "C", "c"] def surface_to_array( array: numpy.ndarray, surface: Surface, - kind: _Kind = "P", + kind: _kind = "P", opaque: int = 255, clear: int = 0, -) -> None: - """Copy surface pixels to an array object. - - The surface_to_array function copies pixels from a Surface object - to a 2D or 3D array. Depending on argument ``kind`` and the target array - dimension, a copy may be raw pixel value, RGB, a color component slice, - or colorkey alpha transparency value. Recognized ``kind`` values are the - single character codes 'P', 'R', 'G', 'B', 'A', and 'C'. Kind codes are case - insensitive, so 'p' is equivalent to 'P'. The first two dimensions - of the target must be the surface size (w, h). - - The default 'P' kind code does a direct raw integer pixel (mapped) value - copy to a 2D array and a 'RGB' pixel component (unmapped) copy to a 3D array - having shape (w, h, 3). For an 8 bit colormap surface this means the - table index is copied to a 2D array, not the table value itself. A 2D - array's item size must be at least as large as the surface's pixel - byte size. The item size of a 3D array must be at least one byte. - - For the 'R', 'G', 'B', and 'A' copy kinds a single color component - of the unmapped surface pixels are copied to the target 2D array. - For kind 'A' and surfaces with source alpha (the surface was created with - the SRCALPHA flag), has a colorkey - (set with :meth:`Surface.set_colorkey() `), - or has a blanket alpha - (set with :meth:`Surface.set_alpha() `) - then the alpha values are those expected for a SDL surface. - If a surface has no explicit alpha value, then the target array - is filled with the value of the optional ``opaque`` surface_to_array - argument (default 255: not transparent). - - Copy kind 'C' is a special case for alpha copy of a source surface - with colorkey. Unlike the 'A' color component copy, the ``clear`` - argument value is used for colorkey matches, ``opaque`` otherwise. - By default, a match has alpha 0 (totally transparent), while everything - else is alpha 255 (totally opaque). It is a more general implementation - of :meth:`pygame.surfarray.array_colorkey`. - - Specific to surface_to_array, a ValueError is raised for target arrays - with incorrect shape or item size. A TypeError is raised for an incorrect - kind code. Surface specific problems, such as locking, raise a pygame.error. - """ - -def array_to_surface(surface: Surface, array: numpy.ndarray, /) -> None: - """Copy an array object to a surface. - - See :func:`pygame.surfarray.blit_array`. - """ - +) -> None: ... +def array_to_surface(surface: Surface, array: numpy.ndarray) -> None: ... def map_array( - array1: numpy.ndarray, array2: numpy.ndarray, surface: Surface, / -) -> None: - """Copy an array to another array, using surface format. - - Map an array of color element values - (w, h, ..., 3) - to an array of - pixels - (w, h) according to the format of . - """ - -def make_surface(array: numpy.ndarray, /) -> Surface: - """Copy an array to a new surface. - - Create a new Surface that best resembles the data and format of the array. - The array can be 2D or 3D with any sized integer values. - """ + array1: numpy.ndarray, array2: numpy.ndarray, surface: Surface +) -> None: ... +def make_surface(array: numpy.ndarray) -> Surface: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/pkgdata.py b/.venv/lib/python3.14/site-packages/pygame/pkgdata.py index ddb6177..767cbdf 100644 --- a/.venv/lib/python3.14/site-packages/pygame/pkgdata.py +++ b/.venv/lib/python3.14/site-packages/pygame/pkgdata.py @@ -18,21 +18,11 @@ object (such as StringIO). """ __all__ = ["getResource"] -import os import sys +import os try: - from importlib.resources import files - - def resource_exists(_package_or_requirement, _resource_name): - _package_or_requirement = _package_or_requirement.split(".")[0] - return files(_package_or_requirement).joinpath(_resource_name).is_file() - - def resource_stream(_package_or_requirement, _resource_name): - _package_or_requirement = _package_or_requirement.split(".")[0] - ref = files(_package_or_requirement).joinpath(_resource_name) - return ref.open("rb") - + from pkg_resources import resource_stream, resource_exists except ImportError: def resource_exists(_package_or_requirement, _resource_name): @@ -43,7 +33,7 @@ except ImportError: """ return False - def resource_stream(_package_or_requirement, _resource_name): + def resource_stream(_package_of_requirement, _resource_name): """ A stub for when we fail to import this function. diff --git a/.venv/lib/python3.14/site-packages/pygame/pypm.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/pypm.cpython-314-x86_64-linux-gnu.so deleted file mode 100755 index ad2ccae..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/pypm.cpython-314-x86_64-linux-gnu.so and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/rect.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/rect.cpython-314-x86_64-linux-gnu.so index a4e9262..b8a0c5d 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/rect.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/rect.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/rect.pyi b/.venv/lib/python3.14/site-packages/pygame/rect.pyi index 285426f..52f79cc 100644 --- a/.venv/lib/python3.14/site-packages/pygame/rect.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/rect.pyi @@ -1,305 +1,208 @@ import sys -from collections.abc import Callable, Collection, Iterator from typing import ( - ClassVar, - Literal, - SupportsIndex, + Dict, + Iterator, + List, + Sequence, + Tuple, TypeVar, + Union, overload, + Callable, + Any, + Optional, ) -from pygame.typing import Point, RectLike, SequenceLike -from typing_extensions import deprecated # added in 3.13 +from ._common import Coordinate, Literal, RectValue -if sys.version_info >= (3, 11): - from typing import Self +if sys.version_info >= (3, 9): + from collections.abc import Collection else: - from typing_extensions import Self + from typing import Collection -from types import EllipsisType - -_N = TypeVar("_N", int, float) _K = TypeVar("_K") _V = TypeVar("_V") _T = TypeVar("_T") -_RectTypeCompatible_co = TypeVar( - "_RectTypeCompatible_co", bound=RectLike, covariant=True -) - -class _GenericRect(Collection[_N]): - @property - def x(self) -> _N: ... - @x.setter - def x(self, value: float) -> None: ... - @property - def y(self) -> _N: ... - @y.setter - def y(self, value: float) -> None: ... - @property - def top(self) -> _N: ... - @top.setter - def top(self, value: float) -> None: ... - @property - def left(self) -> _N: ... - @left.setter - def left(self, value: float) -> None: ... - @property - def bottom(self) -> _N: ... - @bottom.setter - def bottom(self, value: float) -> None: ... - @property - def right(self) -> _N: ... - @right.setter - def right(self, value: float) -> None: ... - @property - def topleft(self) -> tuple[_N, _N]: ... - @topleft.setter - def topleft(self, value: Point) -> None: ... - @property - def bottomleft(self) -> tuple[_N, _N]: ... - @bottomleft.setter - def bottomleft(self, value: Point) -> None: ... - @property - def topright(self) -> tuple[_N, _N]: ... - @topright.setter - def topright(self, value: Point) -> None: ... - @property - def bottomright(self) -> tuple[_N, _N]: ... - @bottomright.setter - def bottomright(self, value: Point) -> None: ... - @property - def midtop(self) -> tuple[_N, _N]: ... - @midtop.setter - def midtop(self, value: Point) -> None: ... - @property - def midleft(self) -> tuple[_N, _N]: ... - @midleft.setter - def midleft(self, value: Point) -> None: ... - @property - def midbottom(self) -> tuple[_N, _N]: ... - @midbottom.setter - def midbottom(self, value: Point) -> None: ... - @property - def midright(self) -> tuple[_N, _N]: ... - @midright.setter - def midright(self, value: Point) -> None: ... - @property - def center(self) -> tuple[_N, _N]: ... - @center.setter - def center(self, value: Point) -> None: ... - @property - def relcenter(self) -> tuple[_N, _N]: ... - @relcenter.setter - def relcenter(self, value: Point) -> None: ... - @property - def centerx(self) -> _N: ... - @centerx.setter - def centerx(self, value: float) -> None: ... - @property - def centery(self) -> _N: ... - @centery.setter - def centery(self, value: float) -> None: ... - @property - def size(self) -> tuple[_N, _N]: ... - @size.setter - def size(self, value: Point) -> None: ... - @property - def width(self) -> _N: ... - @width.setter - def width(self, value: float) -> None: ... - @property - def height(self) -> _N: ... - @height.setter - def height(self, value: float) -> None: ... - @property - def w(self) -> _N: ... - @w.setter - def w(self, value: float) -> None: ... - @property - def h(self) -> _N: ... - @h.setter - def h(self, value: float) -> None: ... - __hash__: ClassVar[None] # type: ignore[assignment] - @overload - def __init__( - self, left: float, top: float, width: float, height: float, / - ) -> None: ... - @overload - def __init__(self, left_top: Point, width_height: Point, /) -> None: ... - @overload - def __init__(self, single_arg: RectLike, /) -> None: ... - @overload - def __init__(self) -> None: ... - def __len__(self) -> Literal[4]: ... - def __iter__(self) -> Iterator[_N]: ... - @overload - def __getitem__(self, i: SupportsIndex) -> _N: ... - @overload - def __getitem__(self, s: slice | EllipsisType) -> list[_N]: ... - @overload - def __setitem__(self, key: int, value: float) -> None: ... - @overload - def __setitem__( - self, key: slice | EllipsisType, value: float | RectLike - ) -> None: ... - def __copy__(self) -> Self: ... - def copy(self) -> Self: ... - @overload - def move(self, x: float, y: float, /) -> Self: ... - @overload - def move(self, move_by: Point, /) -> Self: ... - @overload - def move_ip(self, x: float, y: float, /) -> None: ... - @overload - def move_ip(self, move_by: Point, /) -> None: ... - def move_to(self, **kwargs: float | Point) -> Self: ... - @overload - def inflate(self, x: float, y: float, /) -> Self: ... - @overload - def inflate(self, inflate_by: Point, /) -> Self: ... - @overload - def inflate_ip(self, x: float, y: float, /) -> None: ... - @overload - def inflate_ip(self, inflate_by: Point, /) -> None: ... - @overload - def scale_by(self, x: float, y: float = ...) -> Self: ... - @overload - def scale_by(self, scale_by: Point) -> Self: ... - @overload - def scale_by_ip(self, x: float, y: float = ...) -> None: ... - @overload - def scale_by_ip(self, scale_by: Point) -> None: ... - @overload - def update( - self, left: float, top: float, width: float, height: float, / - ) -> None: ... - @overload - def update(self, left_top: Point, width_height: Point, /) -> None: ... - @overload - def update(self, single_arg: RectLike, /) -> None: ... - @overload - def clamp(self, rect: RectLike, /) -> Self: ... - @overload - def clamp(self, left_top: Point, width_height: Point, /) -> Self: ... - @overload - def clamp( - self, left: float, top: float, width: float, height: float, / - ) -> Self: ... - @overload - def clamp_ip(self, rect: RectLike, /) -> None: ... - @overload - def clamp_ip(self, left_top: Point, width_height: Point, /) -> None: ... - @overload - def clamp_ip( - self, left: float, top: float, width: float, height: float, / - ) -> None: ... - @overload - def clip(self, rect: RectLike, /) -> Self: ... - @overload - def clip(self, left_top: Point, width_height: Point, /) -> Self: ... - @overload - def clip(self, left: float, top: float, width: float, height: float, /) -> Self: ... - @overload - def clipline( - self, x1: float, x2: float, x3: float, x4: float, / - ) -> tuple[tuple[_N, _N], tuple[_N, _N]] | tuple[()]: ... - @overload - def clipline( - self, first_point: Point, second_point: Point, / - ) -> tuple[tuple[_N, _N], tuple[_N, _N]] | tuple[()]: ... - @overload - def clipline( - self, rect_arg: RectLike, / - ) -> tuple[tuple[_N, _N], tuple[_N, _N]] | tuple[()]: ... - @overload - def union(self, rect: RectLike, /) -> Self: ... - @overload - def union(self, left_top: Point, width_height: Point, /) -> Self: ... - @overload - def union( - self, left: float, top: float, width: float, height: float, / - ) -> Self: ... - @overload - def union_ip(self, rect: RectLike, /) -> None: ... - @overload - def union_ip(self, left_top: Point, width_height: Point, /) -> None: ... - @overload - def union_ip( - self, left: float, top: float, width: float, height: float, / - ) -> None: ... - def unionall(self, rect: SequenceLike[_RectTypeCompatible_co], /) -> Self: ... - def unionall_ip( - self, rect_SequenceLike: SequenceLike[_RectTypeCompatible_co], / - ) -> None: ... - @overload - def fit(self, rect: RectLike, /) -> Self: ... - @overload - def fit(self, left_top: Point, width_height: Point, /) -> Self: ... - @overload - def fit(self, left: float, top: float, width: float, height: float, /) -> Self: ... - def normalize(self) -> None: ... - def __contains__(self, rect: RectLike | _N, /) -> bool: ... # type: ignore[override] - @overload - def contains(self, rect: RectLike, /) -> bool: ... - @overload - def contains(self, left_top: Point, width_height: Point, /) -> bool: ... - @overload - def contains( - self, left: float, top: float, width: float, height: float, / - ) -> bool: ... - @overload - def collidepoint(self, x: float, y: float, /) -> bool: ... - @overload - def collidepoint(self, x_y: Point, /) -> bool: ... - @overload - def colliderect(self, rect: RectLike, /) -> bool: ... - @overload - def colliderect(self, left_top: Point, width_height: Point, /) -> bool: ... - @overload - def colliderect( - self, left: float, top: float, width: float, height: float, / - ) -> bool: ... - def collidelist( - self, rect_list: SequenceLike[_RectTypeCompatible_co], / - ) -> int: ... - def collidelistall( - self, rect_list: SequenceLike[_RectTypeCompatible_co], / - ) -> list[int]: ... - def collideobjectsall( - self, objects: SequenceLike[_T], key: Callable[[_T], RectLike] | None = None - ) -> list[_T]: ... - def collideobjects( - self, objects: SequenceLike[_T], key: Callable[[_T], RectLike] | None = None - ) -> _T | None: ... - @overload - def collidedict( - self, - rect_dict: dict[_RectTypeCompatible_co, _V], - values: Literal[False] = False, - ) -> tuple[_RectTypeCompatible_co, _V] | None: ... - @overload - def collidedict( - self, rect_dict: dict[_K, _RectTypeCompatible_co], values: Literal[True] - ) -> tuple[_K, _RectTypeCompatible_co] | None: ... - @overload - def collidedictall( - self, - rect_dict: dict[_RectTypeCompatible_co, _V], - values: Literal[False] = False, - ) -> list[tuple[_RectTypeCompatible_co, _V]]: ... - @overload - def collidedictall( - self, rect_dict: dict[_K, _RectTypeCompatible_co], values: Literal[True] - ) -> list[tuple[_K, _RectTypeCompatible_co]]: ... - # Rect confirms to the Collection ABC, since it also confirms to # Sized, Iterable and Container ABCs -class Rect(_GenericRect[int]): ... -class FRect(_GenericRect[float]): ... +class Rect(Collection[int]): + x: int + y: int + top: int + left: int + bottom: int + right: int + topleft: Tuple[int, int] + bottomleft: Tuple[int, int] + topright: Tuple[int, int] + bottomright: Tuple[int, int] + midtop: Tuple[int, int] + midleft: Tuple[int, int] + midbottom: Tuple[int, int] + midright: Tuple[int, int] + center: Tuple[int, int] + centerx: int + centery: int + size: Tuple[int, int] + width: int + height: int + w: int + h: int + __hash__: None # type: ignore + __safe_for_unpickling__: Literal[True] + @overload + def __init__( + self, left: float, top: float, width: float, height: float + ) -> None: ... + @overload + def __init__(self, left_top: Coordinate, width_height: Coordinate) -> None: ... + @overload + def __init__(self, single_arg: RectValue) -> None: ... + def __len__(self) -> Literal[4]: ... + def __iter__(self) -> Iterator[int]: ... + @overload + def __getitem__(self, i: int) -> int: ... + @overload + def __getitem__(self, s: slice) -> List[int]: ... + @overload + def __setitem__(self, key: int, value: int) -> None: ... + @overload + def __setitem__(self, key: slice, value: Union[int, Rect]) -> None: ... + def __copy__(self) -> Rect: ... + copy = __copy__ + @overload + def move(self, x: float, y: float) -> Rect: ... + @overload + def move(self, move_by: Coordinate) -> Rect: ... + @overload + def move_ip(self, x: float, y: float) -> None: ... + @overload + def move_ip(self, move_by: Coordinate) -> None: ... + @overload + def inflate(self, x: float, y: float) -> Rect: ... + @overload + def inflate(self, inflate_by: Coordinate) -> Rect: ... + @overload + def inflate_ip(self, x: float, y: float) -> None: ... + @overload + def inflate_ip(self, inflate_by: Coordinate) -> None: ... + @overload + def scale_by(self, x: float, y: float) -> Rect: ... + @overload + def scale_by(self, scale_by: Coordinate) -> Rect: ... + @overload + def scale_by_ip(self, x: float, y: float) -> None: ... + @overload + def scale_by_ip(self, scale_by: Coordinate) -> None: ... + @overload + def update(self, left: float, top: float, width: float, height: float) -> None: ... + @overload + def update(self, left_top: Coordinate, width_height: Coordinate) -> None: ... + @overload + def update(self, single_arg: RectValue) -> None: ... + @overload + def clamp(self, rect: RectValue) -> Rect: ... + @overload + def clamp(self, left_top: Coordinate, width_height: Coordinate) -> Rect: ... + @overload + def clamp(self, left: float, top: float, width: float, height: float) -> Rect: ... + @overload + def clamp_ip(self, rect: RectValue) -> None: ... + @overload + def clamp_ip(self, left_top: Coordinate, width_height: Coordinate) -> None: ... + @overload + def clamp_ip( + self, left: float, top: float, width: float, height: float + ) -> None: ... + @overload + def clip(self, rect: RectValue) -> Rect: ... + @overload + def clip(self, left_top: Coordinate, width_height: Coordinate) -> Rect: ... + @overload + def clip(self, left: float, top: float, width: float, height: float) -> Rect: ... + @overload + def clipline( + self, x1: float, x2: float, x3: float, x4: float + ) -> Union[Tuple[Tuple[int, int], Tuple[int, int]], Tuple[()]]: ... + @overload + def clipline( + self, first_coordinate: Coordinate, second_coordinate: Coordinate + ) -> Union[Tuple[Tuple[int, int], Tuple[int, int]], Tuple[()]]: ... + @overload + def clipline( + self, rect_arg: RectValue + ) -> Union[Tuple[Tuple[int, int], Tuple[int, int]], Tuple[()]]: ... + @overload + def union(self, rect: RectValue) -> Rect: ... + @overload + def union(self, left_top: Coordinate, width_height: Coordinate) -> Rect: ... + @overload + def union(self, left: float, top: float, width: float, height: float) -> Rect: ... + @overload + def union_ip(self, rect: RectValue) -> None: ... + @overload + def union_ip(self, left_top: Coordinate, width_height: Coordinate) -> None: ... + @overload + def union_ip( + self, left: float, top: float, width: float, height: float + ) -> None: ... + def unionall(self, rect: Sequence[RectValue]) -> Rect: ... + def unionall_ip(self, rects: Sequence[RectValue]) -> None: ... + @overload + def fit(self, rect: RectValue) -> Rect: ... + @overload + def fit(self, left_top: Coordinate, width_height: Coordinate) -> Rect: ... + @overload + def fit(self, left: float, top: float, width: float, height: float) -> Rect: ... + def normalize(self) -> None: ... + def __contains__(self, rect: Union[RectValue, int]) -> bool: ... # type: ignore[override] + @overload + def contains(self, rect: RectValue) -> bool: ... + @overload + def contains(self, left_top: Coordinate, width_height: Coordinate) -> bool: ... + @overload + def contains( + self, left: float, top: float, width: float, height: float + ) -> bool: ... + @overload + def collidepoint(self, x: float, y: float) -> bool: ... + @overload + def collidepoint(self, x_y: Coordinate) -> bool: ... + @overload + def colliderect(self, rect: RectValue) -> bool: ... + @overload + def colliderect(self, left_top: Coordinate, width_height: Coordinate) -> bool: ... + @overload + def colliderect( + self, left: float, top: float, width: float, height: float + ) -> bool: ... + def collidelist(self, rects: Sequence[RectValue]) -> int: ... + def collidelistall(self, rects: Sequence[RectValue]) -> List[int]: ... + def collideobjectsall( + self, objects: Sequence[_T], key: Optional[Callable[[_T], RectValue]] = None + ) -> List[_T]: ... + def collideobjects( + self, objects: Sequence[_T], key: Optional[Callable[[_T], RectValue]] = None + ) -> Optional[_T]: ... + # Also undocumented: the dict collision methods take a 'values' argument + # that defaults to False. If it is False, the keys in rect_dict must be + # Rect-like; otherwise, the values must be Rects. + @overload + def collidedict( + self, rect_dict: Dict[RectValue, _V], values: bool = ... + ) -> Tuple[RectValue, _V]: ... + @overload + def collidedict( + self, rect_dict: Dict[_K, "Rect"], values: bool + ) -> Tuple[_K, "Rect"]: ... + @overload + def collidedictall( + self, rect_dict: Dict[RectValue, _V], values: bool = ... + ) -> List[Tuple[RectValue, _V]]: ... + @overload + def collidedictall( + self, rect_dict: Dict[_K, "Rect"], values: bool + ) -> List[Tuple[_K, "Rect"]]: ... -@deprecated("Use `Rect` instead (RectType is an old alias)") -class RectType(Rect): ... - -@deprecated("Use `FRect` instead (FRectType is an old alias)") -class FRectType(FRect): ... +RectType = Rect diff --git a/.venv/lib/python3.14/site-packages/pygame/rwobject.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/rwobject.cpython-314-x86_64-linux-gnu.so index 186c42b..7037398 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/rwobject.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/rwobject.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/rwobject.pyi b/.venv/lib/python3.14/site-packages/pygame/rwobject.pyi index f686414..3688279 100644 --- a/.venv/lib/python3.14/site-packages/pygame/rwobject.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/rwobject.pyi @@ -1,18 +1,18 @@ -from typing import Any, overload +from typing import Any, Optional, overload, Type -from pygame.typing import _PathLike +from ._common import AnyPath def encode_string( - obj: _PathLike | None, - encoding: str | None = "unicode_escape", - errors: str | None = "backslashreplace", - etype: type[Exception] | None = UnicodeEncodeError, + obj: Optional[AnyPath], + encoding: Optional[str] = "unicode_escape", + errors: Optional[str] = "backslashreplace", + etype: Optional[Type[Exception]] = UnicodeEncodeError, ) -> bytes: ... @overload def encode_file_path( - obj: _PathLike | None, etype: type[Exception] | None = UnicodeEncodeError + obj: Optional[AnyPath], etype: Optional[Type[Exception]] = UnicodeEncodeError ) -> bytes: ... @overload def encode_file_path( - obj: Any, etype: type[Exception] | None = UnicodeEncodeError + obj: Any, etype: Optional[Type[Exception]] = UnicodeEncodeError ) -> bytes: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/scrap.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/scrap.cpython-314-x86_64-linux-gnu.so index 2aa3b19..db73494 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/scrap.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/scrap.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/scrap.pyi b/.venv/lib/python3.14/site-packages/pygame/scrap.pyi index ab2900e..762c36f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/scrap.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/scrap.pyi @@ -1,72 +1,11 @@ -"""pygame module for clipboard support. +from typing import List, Optional +from collections.abc import ByteString -**EXPERIMENTAL!**: This API may change or disappear in later pygame releases. If -you use this, your code may break with the next pygame release. - -The scrap module is for transferring data to/from the clipboard. This allows for -transferring of strings between pygame and other applications. Currently, only strings -are supported with the ``scrap.put_text``, ``scrap.get_text``, and ``scrap.has_text`` -functions. All other functions are deprecated as of pygame 2.2.0 and will be removed -in a future release of pygame. - -.. note:: ``scrap.put_text``, ``scrap.get_text``, and ``scrap.has_text`` use the same - clipboard as the rest of the current API, but only strings are compatible with the - new API as of right now. -""" - -from typing_extensions import ( - Buffer, # added in 3.12, - deprecated, # added in 3.13 -) - -def put_text(text: str, /) -> None: - """ - Places text into the clipboard. - - Places the input text into the clipboard. The data should be a string. - This is the same clipboard as the legacy scrap API when using ``SCRAP_TEXT``. - - :raises pygame.error: if video mode has not been set_mode - - .. note:: ``pygame.display.set_mode()`` should be called before using the ``scrap`` module - - .. versionadded:: 2.2.0 - """ - -def get_text() -> str: - """ - Gets text from the clipboard. - - Gets text from the clipboard and returns it. If the clipboard is empty, - returns an empty string. This is the same clipboard as the legacy scrap - API when using ``SCRAP_TEXT``. - - .. versionadded:: 2.2.0 - """ - -def has_text() -> bool: - """ - Checks if text is in the clipboard. - - Returns ``True`` if the clipboard has a string, otherwise returns ``False``. - This is the same clipboard as the legacy scrap API when using ``SCRAP_TEXT``. - - .. versionadded:: 2.2.0 - """ - -@deprecated("since 2.2.0. Use the new API instead, which only requires display init") def init() -> None: ... -@deprecated("since 2.2.0. Use the new API instead, which doesn't require scrap init") def get_init() -> bool: ... -@deprecated("since 2.2.0. Use the new API instead: `pygame.scrap.get_text`") -def get(data_type: str, /) -> bytes | None: ... -@deprecated("since 2.2.0. Use the new API instead, which only supports strings") -def get_types() -> list[str]: ... -@deprecated("since 2.2.0. Use the new API instead: `pygame.scrap.put_text`") -def put(data_type: str, data: Buffer, /) -> None: ... -@deprecated("since 2.2.0. Use the new API instead: `pygame.scrap.has_text`") -def contains(data_type: str, /) -> bool: ... -@deprecated("since 2.2.0. Use the new API instead, which uses system clipboard") +def get(data_type: str) -> Optional[bytes]: ... +def get_types() -> List[str]: ... +def put(data_type: str, data: ByteString) -> None: ... +def contains(data_type: str) -> bool: ... def lost() -> bool: ... -@deprecated("since 2.2.0. Use the new API instead, which only supports strings") -def set_mode(mode: int, /) -> None: ... +def set_mode(mode: int) -> None: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/sndarray.py b/.venv/lib/python3.14/site-packages/pygame/sndarray.py index 1035c0a..99ac4c7 100644 --- a/.venv/lib/python3.14/site-packages/pygame/sndarray.py +++ b/.venv/lib/python3.14/site-packages/pygame/sndarray.py @@ -1,4 +1,4 @@ -## pygame-ce - Python Game Library +## pygame - Python Game Library ## Copyright (C) 2008 Marcus von Appen ## ## This library is free software; you can redistribute it and/or @@ -22,7 +22,7 @@ Functions to convert between NumPy arrays and Sound objects. This module will only be functional when pygame can use the external NumPy package. -If NumPy can't be imported, sndarray becomes a MissingModule object. +If NumPy can't be imported, surfarray becomes a MissingModule object. Sound data is made of thousands of samples per second, and each sample is the amplitude of the wave at a particular moment in time. For @@ -37,10 +37,11 @@ Sounds with 16-bit data will be treated as unsigned integers, if the sound sample type requests this. """ +from pygame import mixer +import numpy + import warnings -import numpy -from pygame import mixer __all__ = [ "array", diff --git a/.venv/lib/python3.14/site-packages/pygame/sndarray.pyi b/.venv/lib/python3.14/site-packages/pygame/sndarray.pyi index 8ad739f..8b0dd65 100644 --- a/.venv/lib/python3.14/site-packages/pygame/sndarray.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/sndarray.pyi @@ -1,87 +1,12 @@ -"""Pygame module for accessing sound sample data. - -Functions to convert between NumPy arrays and Sound objects. This -module will only be functional when pygame can use the external NumPy -package. If NumPy can't be imported, ``sndarray`` becomes a ``MissingModule`` -object. - -Sound data is made of thousands of samples per second, and each sample is the -amplitude of the wave at a particular moment in time. For example, in 22-kHz -format, element number 5 of the array is the amplitude of the wave after -5/22000 seconds. - -The arrays are indexed by the ``X`` axis first, followed by the ``Y`` axis. -Each sample is an 8-bit or 16-bit integer, depending on the data format. A -stereo sound file has two values per sample, while a mono sound file only has -one. - -.. versionchanged:: 2.5.6 sndarray module is lazily loaded to avoid an expensive NumPy import when unnecessary -""" +from typing import Tuple import numpy + from pygame.mixer import Sound -from typing_extensions import deprecated # added in 3.13 -def array(sound: Sound) -> numpy.ndarray: - """Copy Sound samples into an array. - - Creates a new array for the sound data and copies the samples. The array - will always be in the format returned from ``pygame.mixer.get_init()``. - """ - -def samples(sound: Sound) -> numpy.ndarray: - """Reference Sound samples into an array. - - Creates a new array that directly references the samples in a Sound object. - Modifying the array will change the Sound. The array will always be in the - format returned from ``pygame.mixer.get_init()``. - """ - -def make_sound(array: numpy.ndarray) -> Sound: - """Convert an array into a Sound object. - - Create a new playable Sound object from an array. The mixer module must be - initialized and the array format must be similar to the mixer audio format. - """ - -@deprecated("Only numpy is supported") -def use_arraytype(arraytype: str) -> None: - """Sets the array system to be used for sound arrays. - - DEPRECATED: Uses the requested array type for the module functions. The - only supported arraytype is ``'numpy'``. Other values will raise ValueError. - Using this function will raise a ``DeprecationWarning``. - """ - -@deprecated("Only numpy is supported") -def get_arraytype() -> str: - """Gets the currently active array type. - - DEPRECATED: Returns the currently active array type. This will be a value of the - ``get_arraytypes()`` tuple and indicates which type of array module is used - for the array creation. Using this function will raise a ``DeprecationWarning``. - - .. versionaddedold:: 1.8 - """ - -@deprecated("Only numpy is supported") -def get_arraytypes() -> tuple[str]: - """Gets the array system types currently supported. - - DEPRECATED: Checks which array systems are available and returns them as a tuple of - strings. The values of the tuple can be used directly in the - :func:`pygame.sndarray.use_arraytype` method. Using this function will - raise a ``DeprecationWarning``. - - .. versionaddedold:: 1.8 - """ - -# keep in sync with sndarray.py -__all__ = [ - "array", - "samples", - "make_sound", - "use_arraytype", - "get_arraytype", - "get_arraytypes", -] +def array(sound: Sound) -> numpy.ndarray: ... +def samples(sound: Sound) -> numpy.ndarray: ... +def make_sound(array: numpy.ndarray) -> Sound: ... +def use_arraytype(arraytype: str) -> Sound: ... +def get_arraytype() -> str: ... +def get_arraytypes() -> Tuple[str]: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/sprite.py b/.venv/lib/python3.14/site-packages/pygame/sprite.py index 5eebc03..0d9c422 100644 --- a/.venv/lib/python3.14/site-packages/pygame/sprite.py +++ b/.venv/lib/python3.14/site-packages/pygame/sprite.py @@ -1,4 +1,4 @@ -# pygame-ce - Python Game Library +# pygame - Python Game Library # Copyright (C) 2000-2003, 2007 Pete Shinners # (C) 2004 Joe Wreschnig # This library is free software; you can redistribute it and/or @@ -35,7 +35,8 @@ The basic Sprite class can draw the Sprites it contains to a Surface. The Group.draw() method requires that each Sprite have a Surface.image attribute and a Surface.rect. The Group.clear() method requires these same attributes and can be used to erase all the Sprites with background. There are also -more advanced Groups: pygame.sprite.RenderUpdates(). +more advanced Groups: pygame.sprite.RenderUpdates() and +pygame.sprite.OrderedUpdates(). Lastly, this module contains several collision functions. These help find sprites inside multiple groups that have intersecting bounding rectangles. @@ -83,14 +84,16 @@ Sprites are not thread safe, so lock them yourself if using threads. # should handle just about every need, but perhaps more optimized # specific ones that aren't quite so general but fit into common # specialized cases. +from typing import Generic, TypeVar -import types +from weakref import WeakSet from warnings import warn import pygame -from pygame.mask import from_surface + from pygame.rect import Rect from pygame.time import get_ticks +from pygame.mask import from_surface class Sprite: @@ -109,28 +112,10 @@ class Sprite: """ def __init__(self, *groups): - self.__g = {} # The groups the sprite is in - self.__image: pygame.surface.Surface | None = None - self.__rect: pygame.rect.Rect | None = None + self.__g = set() # The groups the sprite is in if groups: self.add(*groups) - @property - def image(self): - return self.__image - - @image.setter - def image(self, value: pygame.surface.Surface | None): - self.__image = value - - @property - def rect(self): - return self.__rect - - @rect.setter - def rect(self, value: pygame.rect.Rect | None): - self.__rect = value - def add(self, *groups): """add the sprite to groups @@ -173,7 +158,7 @@ class Sprite: :param group: The group we are adding to. """ - self.__g[group] = 0 + self.__g.add(group) def remove_internal(self, group): """ @@ -181,7 +166,7 @@ class Sprite: :param group: The group we are removing from. """ - del self.__g[group] + self.__g.remove(group) def update(self, *args, **kwargs): """method to control sprite behavior @@ -248,12 +233,12 @@ class Sprite: :return: layer as an int, or raise AttributeError. """ - return getattr(self, "_layer") + return self._layer @layer.setter def layer(self, value): if not self.alive(): - setattr(self, "_layer", value) + self._layer = value else: raise AttributeError( "Can't set layer directly after " @@ -263,6 +248,17 @@ class Sprite: ) +class WeakSprite(Sprite): + """A subclass of Sprite that references its Groups weakly. This + means that any group this belongs to that is not referenced anywhere + else is garbage collected automatically. + """ + + def __init__(self, *groups): + super().__init__(*groups) + self.__dict__["_Sprite__g"] = WeakSet(self._Sprite__g) + + class DirtySprite(Sprite): """a more featureful subclass of Sprite with more attributes @@ -290,7 +286,7 @@ class DirtySprite(Sprite): the screen.) _layer = 0 - 0 is the default value but this can be set differently + 0 is the default value but this is able to be set differently when subclassing. """ @@ -358,7 +354,13 @@ class DirtySprite(Sprite): ) -class AbstractGroup: +class WeakDirtySprite(WeakSprite, DirtySprite): + """A subclass of WeakSprite and DirtySprite that combines the benefits + of both classes. + """ + + +class AbstractGroup(Generic[TypeVar("T")]): """base class for containers of sprites AbstractGroup does everything needed to behave as a normal group. You can @@ -370,9 +372,7 @@ class AbstractGroup: """ - __class_getitem__ = classmethod(types.GenericAlias) - - # protected identifier value to identify sprite groups, and avoid infinite recursion + # dummy val to identify sprite groups, and avoid infinite recursion _spritegroup = True def __init__(self): @@ -382,7 +382,7 @@ class AbstractGroup: def sprites(self): """get a list of sprites in the group - Group.sprite(): return list + Group.sprites(): return list Returns an object that can be looped over with a 'for' loop. (For now, it is always a list, but this could change in a future version of @@ -411,7 +411,8 @@ class AbstractGroup: :param sprite: The sprite we are removing. """ - if lost_rect := self.spritedict[sprite]: + lost_rect = self.spritedict[sprite] + if lost_rect: self.lostsprites.append(lost_rect) del self.spritedict[sprite] @@ -554,10 +555,12 @@ class AbstractGroup: for sprite in self.sprites(): sprite.update(*args, **kwargs) - def draw(self, surface, bgd=None, special_flags=0): # noqa pylint: disable=unused-argument; bgd arg used in LayeredDirty + def draw( + self, surface, bgsurf=None, special_flags=0 + ): # noqa pylint: disable=unused-argument; bgsurf arg used in LayeredDirty """draw all sprites onto the surface - Group.draw(surface, bgd=None, special_flags=0): return Rect_list + Group.draw(surface, special_flags=0): return Rect_list Draws all of the member sprites onto the given surface. @@ -661,24 +664,8 @@ class Group(AbstractGroup): self.add(*sprites) -class RenderPlain(Group): - def __init__(self, *sprites): - super().__init__(*sprites) - warn( - "This class is deprecated and will be removed in a future version.", - DeprecationWarning, - stacklevel=2, - ) - - -class RenderClear(Group): - def __init__(self, *sprites): - super().__init__(*sprites) - warn( - "This class is deprecated and will be removed in a future version.", - DeprecationWarning, - stacklevel=2, - ) +RenderPlain = Group +RenderClear = Group class RenderUpdates(Group): @@ -691,7 +678,7 @@ class RenderUpdates(Group): """ - def draw(self, surface, bgd=None, special_flags=0): + def draw(self, surface, bgsurf=None, special_flags=0): surface_blit = surface.blit dirty = self.lostsprites self.lostsprites = [] @@ -712,19 +699,35 @@ class RenderUpdates(Group): class OrderedUpdates(RenderUpdates): + """RenderUpdates class that draws Sprites in order of addition + + pygame.sprite.OrderedUpdates(*sprites): return OrderedUpdates + + This class derives from pygame.sprite.RenderUpdates(). It maintains + the order in which the Sprites were added to the Group for rendering. + This makes adding and removing Sprites from the Group a little + slower than regular Groups. + + """ + def __init__(self, *sprites): - super().__init__(*sprites) - warn( - "OrderedUpdates is now just an alias to RenderUpdates, order of " - "sprites is now maintained in all sprite Group classes. This " - "class is deprecated and will be removed in a future version.", - DeprecationWarning, - stacklevel=2, - ) + self._spritelist = [] + RenderUpdates.__init__(self, *sprites) + + def sprites(self): + return self._spritelist.copy() + + def add_internal(self, sprite, layer=None): + RenderUpdates.add_internal(self, sprite) + self._spritelist.append(sprite) + + def remove_internal(self, sprite): + RenderUpdates.remove_internal(self, sprite) + self._spritelist.remove(sprite) class LayeredUpdates(AbstractGroup): - """LayeredUpdates Group handles layers, which are drawn like RenderUpdates + """LayeredUpdates Group handles layers, which are drawn like OrderedUpdates pygame.sprite.LayeredUpdates(*sprites, **kwargs): return LayeredUpdates @@ -853,17 +856,17 @@ class LayeredUpdates(AbstractGroup): del self._spritelayers[sprite] def sprites(self): - """return an ordered list of sprites (first back, last top). + """return a ordered list of sprites (first back, last top). LayeredUpdates.sprites(): return sprites """ return self._spritelist.copy() - def draw(self, surface, bgd=None, special_flags=0): + def draw(self, surface, bgsurf=None, special_flags=0): """draw all sprites in the right order onto the passed surface - LayeredUpdates.draw(surface, bgd=None, special_flags=0): return Rect_list + LayeredUpdates.draw(surface, special_flags=0): return Rect_list """ spritedict = self.spritedict @@ -1020,13 +1023,13 @@ class LayeredUpdates(AbstractGroup): return self._spritelist[-1] def get_sprites_from_layer(self, layer): - """return all sprites from a layer ordered as they were added + """return all sprites from a layer ordered as they where added LayeredUpdates.get_sprites_from_layer(layer): return sprites Returns all sprites from a layer. The sprites are ordered in the - sequence that they were added. (The sprites are not removed from the - layer). + sequence that they where added. (The sprites are not removed from the + layer. """ sprites = [] @@ -1068,7 +1071,7 @@ class LayeredDirty(LayeredUpdates): It uses the dirty flag technique and is therefore faster than pygame.sprite.RenderUpdates if you have many static sprites. It also switches automatically between dirty rect updating and full - screen drawing, so you do not have to worry which would be faster. + screen drawing, so you do no have to worry which would be faster. As with the pygame.sprite.Group, you can specify some additional attributes through kwargs: @@ -1133,16 +1136,16 @@ class LayeredDirty(LayeredUpdates): LayeredUpdates.add_internal(self, sprite, layer) - def draw(self, surface, bgd=None, special_flags=None): + def draw(self, surface, bgsurf=None, special_flags=None): """draw all sprites in the right order onto the given surface - LayeredDirty.draw(surface, bgd=None, special_flags=0): return Rect_list + LayeredDirty.draw(surface, bgsurf=None, special_flags=None): return Rect_list You can pass the background too. If a self.bgd is already set to some - value that is not None, then the bgd argument has no effect. + value that is not None, then the bgsurf argument has no effect. Passing a value to special_flags will pass that value as the - special_flags argument to all Surface.blit calls, overriding - the sprite.blendmode attribute. + special_flags argument to pass to all Surface.blit calls, overriding + the sprite.blendmode attribute """ # functions and classes assigned locally to speed up loops @@ -1157,8 +1160,8 @@ class LayeredDirty(LayeredUpdates): rect_type = Rect surf_blit_func = surface.blit - if bgd is not None: - self._bgd = bgd + if bgsurf is not None: + self._bgd = bgsurf local_bgd = self._bgd surface.set_clip(latest_clip) @@ -1565,7 +1568,7 @@ def collide_circle(left, right): except AttributeError: leftrect = left.rect # approximating the radius of a square by using half of the diagonal, - # might give false positives (especially if it's a long small rect) + # might give false positives (especially if its a long small rect) leftradius = 0.5 * ((leftrect.width**2 + leftrect.height**2) ** 0.5) # store the radius on the sprite for next time left.radius = leftradius @@ -1575,7 +1578,7 @@ def collide_circle(left, right): except AttributeError: rightrect = right.rect # approximating the radius of a square by using half of the diagonal - # might give false positives (especially if it's a long small rect) + # might give false positives (especially if its a long small rect) rightradius = 0.5 * ((rightrect.width**2 + rightrect.height**2) ** 0.5) # store the radius on the sprite for next time right.radius = rightradius @@ -1706,21 +1709,36 @@ def spritecollide(sprite, group, dokill, collided=None): which will be used to calculate the collision. """ + # pull the default collision function in as a local variable outside + # the loop as this makes the loop run faster + default_sprite_collide_func = sprite.rect.colliderect + + if dokill: + crashed = [] + append = crashed.append + + for group_sprite in group.sprites(): + if collided is not None: + if collided(sprite, group_sprite): + group_sprite.kill() + append(group_sprite) + else: + if default_sprite_collide_func(group_sprite.rect): + group_sprite.kill() + append(group_sprite) + + return crashed + if collided is not None: - collided_sprites = [ + return [ group_sprite for group_sprite in group if collided(sprite, group_sprite) ] - else: - sprite_rect_collide = sprite.rect.colliderect - collided_sprites = [ - group_sprite - for group_sprite in group - if sprite_rect_collide(group_sprite.rect) - ] - if dokill: - for group_sprite in collided_sprites: - group_sprite.kill() - return collided_sprites + + return [ + group_sprite + for group_sprite in group + if default_sprite_collide_func(group_sprite.rect) + ] def groupcollide(groupa, groupb, dokilla, dokillb, collided=None): @@ -1741,18 +1759,22 @@ def groupcollide(groupa, groupb, dokilla, dokillb, collided=None): that will be used to calculate the collision. """ - collided_sprites = {} + crashed = {} # pull the collision function in as a local variable outside # the loop as this makes the loop run faster sprite_collide_func = spritecollide - for group_a_sprite in groupa: - collisions = sprite_collide_func(group_a_sprite, groupb, dokillb, collided) - if collisions: - collided_sprites[group_a_sprite] = collisions if dokilla: - for group_a_sprite in collided_sprites: - group_a_sprite.kill() - return collided_sprites + for group_a_sprite in groupa.sprites(): + collision = sprite_collide_func(group_a_sprite, groupb, dokillb, collided) + if collision: + crashed[group_a_sprite] = collision + group_a_sprite.kill() + else: + for group_a_sprite in groupa: + collision = sprite_collide_func(group_a_sprite, groupb, dokillb, collided) + if collision: + crashed[group_a_sprite] = collision + return crashed def spritecollideany(sprite, group, collided=None): @@ -1773,16 +1795,19 @@ def spritecollideany(sprite, group, collided=None): sprites must have a "rect" value, which is a rectangle of the sprite area, which will be used to calculate the collision. + """ + # pull the default collision function in as a local variable outside + # the loop as this makes the loop run faster + default_sprite_collide_func = sprite.rect.colliderect + if collided is not None: for group_sprite in group: if collided(sprite, group_sprite): return group_sprite else: - # pull the default collision function in as a local variable outside - # the loop as this makes the loop run faster - sprite_rect_collide = sprite.rect.colliderect + # Special case old behaviour for speed. for group_sprite in group: - if sprite_rect_collide(group_sprite.rect): + if default_sprite_collide_func(group_sprite.rect): return group_sprite return None diff --git a/.venv/lib/python3.14/site-packages/pygame/sprite.pyi b/.venv/lib/python3.14/site-packages/pygame/sprite.pyi index e78292f..752cc1f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/sprite.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/sprite.pyi @@ -1,165 +1,238 @@ -import sys -import types -from collections.abc import Callable, Iterable, Iterator from typing import ( Any, + Callable, + Dict, Generic, - Protocol, + Iterable, + Iterator, + List, + Literal, + Optional, SupportsFloat, - TypeAlias, + Tuple, TypeVar, + Union, ) -# use typing_extensions for compatibility with older Python versions -if sys.version_info >= (3, 13): - from warnings import deprecated -else: - from typing_extensions import deprecated +# Protocol added in python 3.8 +from typing_extensions import Protocol -if sys.version_info >= (3, 11): - from typing import Self -else: - from typing_extensions import Self - -from pygame.mask import Mask -from pygame.rect import FRect, Rect +from pygame.rect import Rect from pygame.surface import Surface -from pygame.typing import Point, RectLike +from pygame.mask import Mask -# Some sprite functions only need objects with certain attributes, not always a sprite -class _HasRect(Protocol): - @property - def rect(self) -> FRect | Rect | None: ... +from ._common import RectValue, Coordinate -# image in addition to rect -class _HasImageAndRect(_HasRect, Protocol): - @property - def image(self) -> Surface | None: ... +# non-generic Group, used in Sprite +_Group = AbstractGroup[_SpriteSupportsGroup] -# mask in addition to rect -class _HasMaskAndRect(_HasRect, Protocol): - @property - def mask(self) -> Mask: ... - -class Sprite(_HasImageAndRect): - @property - def image(self) -> Surface | None: ... - @image.setter - def image(self, value: Surface | None) -> None: ... - @property - def rect(self) -> FRect | Rect | None: ... - @rect.setter - def rect(self, value: FRect | Rect | None) -> None: ... +# protocol helps with structural subtyping for typevars in sprite group generics +class _SupportsSprite(Protocol): @property def layer(self) -> int: ... @layer.setter def layer(self, value: int) -> None: ... - def __init__(self, *groups: _GroupOrGroups[Any]) -> None: ... - def add_internal(self, group: AbstractGroup[Any]) -> None: ... - def remove_internal(self, group: AbstractGroup[Any]) -> None: ... + def __init__(self, *groups: _Group) -> None: ... + def add_internal(self, group: _Group) -> None: ... + def remove_internal(self, group: _Group) -> None: ... def update(self, *args: Any, **kwargs: Any) -> None: ... - def add(self, *groups: _GroupOrGroups[Any]) -> None: ... - def remove(self, *groups: _GroupOrGroups[Any]) -> None: ... + def add(self, *groups: _Group) -> None: ... + def remove(self, *groups: _Group) -> None: ... def kill(self) -> None: ... def alive(self) -> bool: ... - def groups(self) -> list[AbstractGroup[Sprite]]: ... + def groups(self) -> List[_Group]: ... -class DirtySprite(Sprite): +# also a protocol +class _SupportsDirtySprite(_SupportsSprite, Protocol): dirty: int blendmode: int - source_rect: FRect | Rect + source_rect: Rect visible: int _layer: int + def _set_visible(self, val: int) -> None: ... + def _get_visible(self) -> int: ... -_SpriteT = TypeVar("_SpriteT", bound=Sprite) -_SpriteT2 = TypeVar("_SpriteT2", bound=Sprite) -_DirtySpriteT = TypeVar("_DirtySpriteT", bound=DirtySprite) +# concrete sprite implementation class +class Sprite(_SupportsSprite): + @property + def layer(self) -> int: ... + @layer.setter + def layer(self, value: int) -> None: ... + def __init__(self, *groups: _Group) -> None: ... + def add_internal(self, group: _Group) -> None: ... + def remove_internal(self, group: _Group) -> None: ... + def update(self, *args: Any, **kwargs: Any) -> None: ... + def add(self, *groups: _Group) -> None: ... + def remove(self, *groups: _Group) -> None: ... + def kill(self) -> None: ... + def alive(self) -> bool: ... + def groups(self) -> List[_Group]: ... -_GroupOrGroups: TypeAlias = AbstractGroup[_SpriteT] | Iterable[_GroupOrGroups[_SpriteT]] -_SpriteOrSprites: TypeAlias = _SpriteT | Iterable[_SpriteOrSprites[_SpriteT]] +class WeakSprite(Sprite): + ... -class AbstractGroup(Generic[_SpriteT]): - spritedict: dict[_SpriteT, FRect | Rect | None] - lostsprites: list[FRect | Rect] - def __class_getitem__(cls, item: Any, /) -> types.GenericAlias: ... +# concrete dirty sprite implementation class +class DirtySprite(_SupportsDirtySprite): + dirty: int + blendmode: int + source_rect: Rect + visible: int + _layer: int + def _set_visible(self, val: int) -> None: ... + def _get_visible(self) -> int: ... + +class WeakDirtySprite(WeakSprite, DirtySprite): + ... + +# used as a workaround for typing.Self because it is added in python 3.11 +_TGroup = TypeVar("_TGroup", bound=AbstractGroup) + +# define some useful protocols first, which sprite functions accept +# sprite functions don't need all sprite attributes to be present in the +# arguments passed, they only use a few which are marked in the below protocols +class _HasRect(Protocol): + rect: Rect + +# image in addition to rect +class _HasImageAndRect(_HasRect, Protocol): + image: Surface + +# mask in addition to rect +class _HasMaskAndRect(_HasRect, Protocol): + mask: Mask + +# radius in addition to rect +class _HasRadiusAndRect(_HasRect, Protocol): + radius: float + +class _SpriteSupportsGroup(_SupportsSprite, _HasImageAndRect, Protocol): ... +class _DirtySpriteSupportsGroup(_SupportsDirtySprite, _HasImageAndRect, Protocol): ... + +# typevar bound to Sprite, _SpriteSupportsGroup Protocol ensures sprite +# subclass passed to group has image and rect attributes +_TSprite = TypeVar("_TSprite", bound=_SpriteSupportsGroup) +_TSprite2 = TypeVar("_TSprite2", bound=_SpriteSupportsGroup) + +# almost the same as _TSprite but bound to DirtySprite +_TDirtySprite = TypeVar("_TDirtySprite", bound=_DirtySpriteSupportsGroup) + +# Below code demonstrates the advantages of the _SpriteSupportsGroup protocol + +# typechecker should error, regular Sprite does not support Group.draw due to +# missing image and rect attributes +# a = Group(Sprite()) + +# typechecker should error, other Sprite attributes are also needed for Group +# class MySprite: +# image: Surface +# rect: Rect +# +# b = Group(MySprite()) + +# typechecker should pass +# class MySprite(Sprite): +# image: Surface +# rect: Rect +# +# b = Group(MySprite()) + +class AbstractGroup(Generic[_TSprite]): + spritedict: Dict[_TSprite, Optional[Rect]] + lostsprites: List[Rect] def __init__(self) -> None: ... def __len__(self) -> int: ... - def __iter__(self) -> Iterator[_SpriteT]: ... + def __iter__(self) -> Iterator[_TSprite]: ... def __bool__(self) -> bool: ... def __contains__(self, item: Any) -> bool: ... - def add_internal(self, sprite: _SpriteT, layer: int | None = None) -> None: ... - def remove_internal(self, sprite: _SpriteT) -> None: ... - def has_internal(self, sprite: _SpriteT) -> bool: ... - def copy(self) -> Self: ... - def sprites(self) -> list[_SpriteT]: ... - def add(self, *sprites: _SpriteOrSprites[_SpriteT]) -> None: ... - def remove(self, *sprites: _SpriteOrSprites[_SpriteT]) -> None: ... - def has(self, *sprites: _SpriteOrSprites[_SpriteT]) -> bool: ... + def add_internal(self, sprite: _TSprite, layer: None = None) -> None: ... + def remove_internal(self, sprite: _TSprite) -> None: ... + def has_internal(self, sprite: _TSprite) -> bool: ... + def copy(self: _TGroup) -> _TGroup: ... # typing.Self is py3.11+ + def sprites(self) -> List[_TSprite]: ... + def add( + self, *sprites: Union[_TSprite, AbstractGroup[_TSprite], Iterable[_TSprite]] + ) -> None: ... + def remove( + self, *sprites: Union[_TSprite, AbstractGroup[_TSprite], Iterable[_TSprite]] + ) -> None: ... + def has( + self, *sprites: Union[_TSprite, AbstractGroup[_TSprite], Iterable[_TSprite]] + ) -> bool: ... def update(self, *args: Any, **kwargs: Any) -> None: ... def draw( - self, surface: Surface, bgd: Surface | None = None, special_flags: int = 0 - ) -> list[FRect | Rect]: ... + self, surface: Surface, bgsurf: Optional[Surface] = None, special_flags: int = 0 + ) -> List[Rect]: ... def clear( - self, - surface: Surface, - bgd: Surface | Callable[[Surface, FRect | Rect], Any], + self, surface: Surface, bgd: Union[Surface, Callable[[Surface, Rect], Any]] ) -> None: ... def empty(self) -> None: ... -class Group(AbstractGroup[_SpriteT]): - def __init__(self, *sprites: _SpriteOrSprites[_SpriteT]) -> None: ... +class Group(AbstractGroup[_TSprite]): + def __init__( + self, *sprites: Union[_TSprite, AbstractGroup[_TSprite], Iterable[_TSprite]] + ) -> None: ... -# These deprecated types are just aliases in the code too -@deprecated("Use `pygame.sprite.Group` instead") -class RenderPlain(Group[_SpriteT]): ... +# these are aliased in the code too +RenderPlain = Group +RenderClear = Group -@deprecated("Use `pygame.sprite.Group` instead") -class RenderClear(Group[_SpriteT]): ... +class RenderUpdates(Group[_TSprite]): ... +class OrderedUpdates(RenderUpdates[_TSprite]): ... -class RenderUpdates(Group[_SpriteT]): ... - -@deprecated("Use `pygame.sprite.RenderUpdates` instead") -class OrderedUpdates(RenderUpdates[_SpriteT]): ... - -class LayeredUpdates(AbstractGroup[_SpriteT]): - def __init__(self, *sprites: _SpriteOrSprites[_SpriteT], **kwargs: Any) -> None: ... - def add(self, *sprites: _SpriteOrSprites[_SpriteT], **kwargs: Any) -> None: ... - def get_sprites_at(self, pos: Point) -> list[_SpriteT]: ... - def get_sprite(self, idx: int) -> _SpriteT: ... - def remove_sprites_of_layer(self, layer_nr: int) -> list[_SpriteT]: ... - def layers(self) -> list[int]: ... - def change_layer(self, sprite: _SpriteT, new_layer: int) -> None: ... - def get_layer_of_sprite(self, sprite: _SpriteT) -> int: ... +class LayeredUpdates(AbstractGroup[_TSprite]): + def __init__( + self, + *sprites: Union[ + _TSprite, + AbstractGroup[_TSprite], + Iterable[Union[_TSprite, AbstractGroup[_TSprite]]], + ], + **kwargs: Any + ) -> None: ... + def add( + self, + *sprites: Union[ + _TSprite, + AbstractGroup[_TSprite], + Iterable[Union[_TSprite, AbstractGroup[_TSprite]]], + ], + **kwargs: Any + ) -> None: ... + def get_sprites_at(self, pos: Coordinate) -> List[_TSprite]: ... + def get_sprite(self, idx: int) -> _TSprite: ... + def remove_sprites_of_layer(self, layer_nr: int) -> List[_TSprite]: ... + def layers(self) -> List[int]: ... + def change_layer(self, sprite: _TSprite, new_layer: int) -> None: ... + def get_layer_of_sprite(self, sprite: _TSprite) -> int: ... def get_top_layer(self) -> int: ... def get_bottom_layer(self) -> int: ... - def move_to_front(self, sprite: _SpriteT) -> None: ... - def move_to_back(self, sprite: _SpriteT) -> None: ... - def get_top_sprite(self) -> _SpriteT: ... - def get_sprites_from_layer(self, layer: int) -> list[_SpriteT]: ... + def move_to_front(self, sprite: _TSprite) -> None: ... + def move_to_back(self, sprite: _TSprite) -> None: ... + def get_top_sprite(self) -> _TSprite: ... + def get_sprites_from_layer(self, layer: int) -> List[_TSprite]: ... def switch_layer(self, layer1_nr: int, layer2_nr: int) -> None: ... -class LayeredDirty(LayeredUpdates[_DirtySpriteT]): +class LayeredDirty(LayeredUpdates[_TDirtySprite]): + def __init__(self, *sprites: _TDirtySprite, **kwargs: Any) -> None: ... def draw( - self, - surface: Surface, - bgd: Surface | None = None, - special_flags: int | None = None, - ) -> list[FRect | Rect]: ... + self, surface: Surface, bgsurf: Optional[Surface] = None, special_flags: Optional[int] = None + ) -> List[Rect]: ... # clear breaks Liskov substitution principle in code def clear(self, surface: Surface, bgd: Surface) -> None: ... # type: ignore[override] - def repaint_rect(self, screen_rect: RectLike) -> None: ... - def set_clip(self, screen_rect: RectLike | None = None) -> None: ... - def get_clip(self) -> FRect | Rect: ... - def set_timing_threshold(self, time_ms: SupportsFloat) -> None: ... - @deprecated( - "since 2.1.1. Use `pygame.sprite.LayeredDirty.set_timing_threshold` instead" - ) - def set_timing_treshold(self, time_ms: SupportsFloat) -> None: ... + def repaint_rect(self, screen_rect: RectValue) -> None: ... + def set_clip(self, screen_rect: Optional[RectValue] = None) -> None: ... + def get_clip(self) -> Rect: ... + def set_timing_threshold( + self, time_ms: SupportsFloat + ) -> None: ... # This actually accept any value + # deprecated alias + set_timing_treshold = set_timing_threshold -class GroupSingle(AbstractGroup[_SpriteT]): - sprite: _SpriteT | None - def __init__(self, sprite: _SpriteT | None = None) -> None: ... +class GroupSingle(AbstractGroup[_TSprite]): + sprite: _TSprite + def __init__(self, sprite: Optional[_TSprite] = None) -> None: ... +# argument to collide_rect must have rect attribute def collide_rect(left: _HasRect, right: _HasRect) -> bool: ... class collide_rect_ratio: @@ -167,8 +240,8 @@ class collide_rect_ratio: def __init__(self, ratio: float) -> None: ... def __call__(self, left: _HasRect, right: _HasRect) -> bool: ... -# Must have rect attribute, may optionally have radius attribute -_SupportsCollideCircle: TypeAlias = _HasRect +# must have rect attribute, may optionally have radius attribute +_SupportsCollideCircle = Union[_HasRect, _HasRadiusAndRect] def collide_circle( left: _SupportsCollideCircle, right: _SupportsCollideCircle @@ -181,31 +254,34 @@ class collide_circle_ratio: self, left: _SupportsCollideCircle, right: _SupportsCollideCircle ) -> bool: ... -# Arguments to collide_mask must either have mask or have image attribute, in +# argument to collide_mask must either have mask or have image attribute, in # addition to mandatorily having a rect attribute -_SupportsCollideMask: TypeAlias = _HasImageAndRect | _HasMaskAndRect +_SupportsCollideMask = Union[_HasImageAndRect, _HasMaskAndRect] def collide_mask( left: _SupportsCollideMask, right: _SupportsCollideMask -) -> tuple[int, int] | None: ... - -_HasRectT = TypeVar("_HasRectT", bound=_HasRect) - +) -> Optional[Tuple[int, int]]: ... def spritecollide( - sprite: _HasRectT, - group: AbstractGroup[_SpriteT], - dokill: bool, - collided: Callable[[_HasRectT, _SpriteT], bool] | None = None, -) -> list[_SpriteT]: ... + sprite: _TSprite, + group: AbstractGroup[_TSprite2], + dokill: bool | Literal[1] | Literal[0], + collided: Optional[ + Callable[[_TSprite, _TSprite2], bool | Optional[Tuple[int, int]]] + ] = None, +) -> List[_TSprite2]: ... def groupcollide( - groupa: AbstractGroup[_SpriteT], - groupb: AbstractGroup[_SpriteT2], - dokilla: bool, - dokillb: bool, - collided: Callable[[_SpriteT, _SpriteT2], bool] | None = None, -) -> dict[_SpriteT, list[_SpriteT2]]: ... + groupa: AbstractGroup[_TSprite], + groupb: AbstractGroup[_TSprite2], + dokilla: bool | Literal[1] | Literal[0], + dokillb: bool | Literal[1] | Literal[0], + collided: Optional[ + Callable[[_TSprite, _TSprite2], bool | Optional[Tuple[int, int]]] + ] = None, +) -> Dict[_TSprite, List[_TSprite2]]: ... def spritecollideany( - sprite: _HasRectT, - group: AbstractGroup[_SpriteT], - collided: Callable[[_HasRectT, _SpriteT], bool] | None = None, -) -> _SpriteT | None: ... + sprite: _TSprite, + group: AbstractGroup[_TSprite2], + collided: Optional[ + Callable[[_TSprite, _TSprite2], bool | Optional[Tuple[int, int]]] + ] = None, +) -> Optional[_TSprite2]: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/surface.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/surface.cpython-314-x86_64-linux-gnu.so index a0fe02c..e697c65 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/surface.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/surface.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/surface.pyi b/.venv/lib/python3.14/site-packages/pygame/surface.pyi index 2359f07..b1facba 100644 --- a/.venv/lib/python3.14/site-packages/pygame/surface.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/surface.pyi @@ -1,18 +1,12 @@ -from collections.abc import Iterable -from typing import Any, Literal, TypeAlias, overload +from typing import Any, List, Optional, Sequence, Tuple, Union, overload from pygame.bufferproxy import BufferProxy from pygame.color import Color -from pygame.rect import FRect, Rect -from pygame.typing import ( - ColorLike, - Point, - RectLike, - SequenceLike, -) -from typing_extensions import deprecated # added in 3.13 +from pygame.rect import Rect -_ViewKind: TypeAlias = Literal[ +from ._common import ColorValue, Coordinate, Literal, RectValue, RGBAOutput + +_ViewKind = Literal[ "0", "1", "2", @@ -40,1018 +34,116 @@ _ViewKind: TypeAlias = Literal[ ] class Surface: - """Pygame object for representing images. - - A pygame Surface is used to represent any image. The Surface has a fixed - resolution and pixel format. Surfaces with 8-bit pixels use a color palette - to map to 24-bit color. - - Call :meth:`pygame.Surface()` to create a new image object. The Surface will - be cleared to all black. The only required arguments are the sizes. With no - additional arguments, the Surface will be created in a format that best - matches the display Surface. - - The pixel format can be controlled by passing the bit depth or an existing - Surface. The flags argument is a bitmask of additional features for the - Surface. You can pass any combination of these flags: - - :: - - HWSURFACE (obsolete in pygame 2) creates the image in video memory - SRCALPHA the pixel format will include a per-pixel alpha - - Both flags are only a request, and may not be possible for all displays and - formats. - - Advanced users can combine a set of bitmasks with a depth value. The masks - are a set of 4 integers representing which bits in a pixel will represent - each color. Normal Surfaces should not require the masks argument. - - Surfaces can have many extra attributes like alpha planes, colorkeys, source - rectangle clipping. These functions mainly effect how the Surface is blitted - to other Surfaces. The blit routines will attempt to use hardware - acceleration when possible, otherwise they will use highly optimized - software blitting methods. - - There are three types of transparency supported in pygame: colorkeys, - Surface alphas, and pixel alphas. Surface alphas can be mixed with - colorkeys, but an image with per pixel alphas cannot use the other modes. - Colorkey transparency makes a single color value transparent. Any pixels - matching the colorkey will not be drawn. The Surface alpha value is a single - value that changes the transparency for the entire image. A Surface alpha of - 255 is opaque, and a value of 0 is completely transparent. - - Per pixel alphas are different because they store a transparency value for - every pixel. This allows for the most precise transparency effects, but it - also the slowest. Per pixel alphas cannot be mixed with Surface alpha and - colorkeys. - - There is support for pixel access for the Surfaces. Pixel access on hardware - Surfaces is slow and not recommended. Pixels can be accessed using the - :meth:`get_at()` and :meth:`set_at()` functions. These methods are fine for - simple access, but will be considerably slow when doing of pixel work with - them. If you plan on doing a lot of pixel level work, it is recommended to - use a :class:`pygame.PixelArray`, which gives an array like view of the - Surface. For involved mathematical manipulations try the - :mod:`pygame.surfarray` module (It's quite quick, but requires NumPy.) - - Any functions that directly access a Surface's pixel data will need that - Surface to be lock()'ed. These functions can :meth:`lock()` and - :meth:`unlock()` the Surfaces themselves without assistance. But, if a - function will be called many times, there will be a lot of overhead for - multiple locking and unlocking of the Surface. It is best to lock the - Surface manually before making the function call many times, and then - unlocking when you are finished. All functions that need a locked Surface - will say so in their docs. Remember to leave the Surface locked only while - necessary. - - Surface pixels are stored internally as a single number that has all the - colors encoded into it. Use the :meth:`map_rgb()` and - :meth:`unmap_rgb()` to convert between individual red, green, and blue - values into a packed integer for that Surface. - - Surfaces can also reference sections of other Surfaces. These are created - with the :meth:`subsurface()` method. Any change to either Surface will - effect the other. - - Each Surface contains a clipping area. By default the clip area covers the - entire Surface. If it is changed, all drawing operations will only effect - the smaller area. - """ - + _pixels_address: int @overload def __init__( self, - size: Point, + size: Coordinate, flags: int = 0, depth: int = 0, - masks: ColorLike | None = None, + masks: Optional[ColorValue] = None, ) -> None: ... @overload def __init__( self, - size: Point, + size: Coordinate, flags: int = 0, surface: Surface = ..., ) -> None: ... def __copy__(self) -> Surface: ... - def __deepcopy__(self, memo) -> Surface: ... + copy = __copy__ def blit( self, source: Surface, - dest: Point | RectLike = (0, 0), - area: RectLike | None = None, + dest: Union[Coordinate, RectValue], + area: Optional[RectValue] = None, special_flags: int = 0, - ) -> Rect: - """Draw another Surface onto this one. - - Draws another Surface onto this Surface. - - **Parameters** - - ``source`` - The ``Surface`` object to draw onto this ``Surface``. - If it has transparency, transparent pixels will be ignored when blitting to an 8-bit ``Surface``. - - ``dest`` *(optional)* - The ``source`` draw position onto this ``Surface``, defaults to (0, 0). - It can be a coordinate pair ``(x, y)`` or a ``Rect`` (using its top-left corner). - If a ``Rect`` is passed, its size will not affect the blit. - - ``area`` *(optional)* - The rectangular portion of the ``source`` to draw. - It can be a ``Rect`` object representing that section. If ``None`` or not provided, - the entire source Surface will be drawn. - If the ``Rect`` has negative position, the final blit position will be - ``dest`` - ``Rect.topleft``. - - ``special_flags`` *(optional)* - Controls how the colors of the ``source`` are combined with this Surface. - If not provided it defaults to ``BLENDMODE_NONE`` (``0``). - See :doc:`special_flags_list` for a list of possible values. - **Return** - A :doc:`rect` object representing the affected area of this ``Surface`` that was modified - by the blit operation. This area includes only the pixels within this ``Surface`` or - its clipping area (see :meth:`set_clip`). - Generally you don't need to use this return value, as it was initially designed to - pass it to :meth:`pygame.display.update` to optimize the updating of the display. - Since modern computers are fast enough to update the entire display at high speeds, - this return value is rarely used nowadays. - **Example Use** - .. code-block:: python - - # create a Surface of size 50x50 and fill it with red color - red_surf = pygame.Surface((50, 50)) - red_surf.fill("red") - - # draw the Surface on another Surface at position (0, 0) - another_surface.blit(red_surf, (0, 0)) - - **Notes** - - When self-blitting and there is a colorkey or alpha transparency set, resulting colors - may appear slightly different compared to a non-self blit. - - - The blit is ignored if the ``source`` is positioned completely outside this ``Surface``'s - clipping area. Otherwise only the overlapping area will be drawn. - - .. versionchanged:: 2.5.1 The dest argument is optional and defaults to (0, 0) - """ - + ) -> Rect: ... def blits( self, - blit_sequence: Iterable[ - ( - tuple[Surface, Point | RectLike] - | tuple[Surface, Point | RectLike, RectLike | int] - | tuple[Surface, Point | RectLike, RectLike, int] - ) + blit_sequence: Sequence[ + Union[ + Tuple[Surface, Union[Coordinate, RectValue]], + Tuple[Surface, Union[Coordinate, RectValue], Union[RectValue, int]], + Tuple[Surface, Union[Coordinate, RectValue], RectValue, int], + ] ], - doreturn: int | bool = 1, - ) -> list[Rect] | None: - """Draw many Surfaces onto this Surface at their corresponding location. - - The ``blits`` method efficiently draws a sequence of Surfaces onto this ``Surface``. - - **Parameters** - - ``blit_sequence`` - A sequence that contains each Surface to be drawn along with its associated blit - arguments. See the **Sequence Item Formats** section below for the possible formats. - - ``doreturn`` (optional) - The ``doreturn`` parameter controls the return value. When set to ``True``, it returns - a list of rectangles representing the changed areas. When set to ``False``, returns - ``None``. - - **Return** - - A list of rectangles or ``None``. - - **Sequence Item Formats** - - ``(source, dest)`` - - ``source``: Surface object to be drawn. - - ``dest``: Position where the source Surface should be blitted. - - ``(source, dest, area)`` - - ``area``: (optional) Specific area of the source Surface to be drawn. - - ``(source, dest, area, special_flags)`` - - ``special_flags``: (optional) Controls the blending mode for drawing colors. - See :doc:`special_flags_list` for a list of possible values. - - **Notes** - - - ``blits`` is an advanced method. It is recommended to read the documentation - of :meth:`blit` first. - - - To draw a ``Surface`` with a special flag, you must specify an area as well, e.g., - ``(source, dest, None, special_flags)``. - - - Prefer using :meth:`blits` over :meth:`blit` when drawing multiple Surfaces - for better performance. Use :meth:`blit` if you need to draw a single Surface. - - - For drawing a sequence of (source, dest) pairs with whole source Surface - and a singular special_flag, use the :meth:`fblits()` method. - - .. versionaddedold:: 1.9.4 - """ - - def fblits( - self, - blit_sequence: Iterable[tuple[Surface, Point | RectLike]], - special_flags: int = 0, - /, - ) -> None: - """Draw many Surfaces onto this Surface at their corresponding location and with the same special_flags. - - This method takes a sequence of tuples (source, dest) as input, where source is a Surface - object and dest is its destination position on this Surface. It draws each source Surface - fully (meaning that unlike `blit()` you cannot pass an "area" parameter to represent - a smaller portion of the source Surface to draw) on this Surface with the same blending - mode specified by special_flags. - - :param blit_sequence: a sequence of (source, dest) - :param special_flags: the flag(s) representing the blend mode used for each Surface. - See :doc:`special_flags_list` for a list of possible values. - - :returns: ``None`` (unlike `blit()` and `blits()`) - - .. note:: This method only accepts a sequence of (source, dest) pairs and a single - special_flags value that's applied to all Surfaces drawn. This allows faster - iteration over the sequence and better performance over `blits()`. Further - optimizations are applied if blit_sequence is a list or a tuple (using one - of them is recommended). - - .. versionadded:: 2.1.4 - """ - + doreturn: Union[int, bool] = 1, + ) -> Union[List[Rect], None]: ... @overload - def convert(self, surface: Surface, /) -> Surface: ... + def convert(self, surface: Surface) -> Surface: ... @overload - def convert(self, depth: int, flags: int = 0, /) -> Surface: ... + def convert(self, depth: int, flags: int = 0) -> Surface: ... @overload - def convert(self, masks: ColorLike, flags: int = 0, /) -> Surface: ... + def convert(self, masks: ColorValue, flags: int = 0) -> Surface: ... @overload def convert(self) -> Surface: ... - def convert(self, *args): # type: ignore - """Change the pixel format of a Surface. - - Creates a new copy of the Surface with the pixel format changed. The new - pixel format can be determined from another existing Surface. Otherwise - depth, flags, and masks arguments can be used, similar to the - :meth:`pygame.Surface()` call. - - If no arguments are passed the new Surface will have the same pixel - format as the display Surface. This is always the fastest format for - blitting. It is a good idea to convert all Surfaces before they are - blitted many times. - - The converted Surface will have no pixel alphas. They will be stripped if - the original had them. See :meth:`convert_alpha()` for preserving or - creating per-pixel alphas. - - The new copy will have the same class as the copied Surface. This lets - a Surface subclass inherit this method without the need to override, - unless subclass specific instance attributes also need copying. - - .. versionchanged:: 2.5.0 converting to a known format will succeed without - a window/display Surface. - """ - - def convert_alpha(self) -> Surface: - """Change the pixel format of a Surface including per pixel alphas. - - Creates a new copy of the Surface with the desired pixel format. The new - Surface will be in a format suited for quick blitting to the display Surface - with per pixel alpha. - - Unlike the :meth:`convert()` method, the pixel format for the new - Surface will not be exactly the same as the display Surface, but it will - be optimized for fast alpha blitting to it. - - As with :meth:`convert()` the returned Surface has the same class as - the converted Surface. - - .. versionchanged:: 2.4.0 'Surface' argument deprecated. - """ - - def copy(self) -> Surface: - """Create a new copy of a Surface. - - Makes a duplicate copy of a Surface. The new Surface will have the same - pixel formats, color palettes, transparency settings, and class as the - original. If a Surface subclass also needs to copy any instance specific - attributes then it should override ``copy()``. Shallow copy and deepcopy - are supported, Surface implements __copy__ and __deepcopy__ respectively. - - If the Surface is a subsurface, the returned Surface will *not* retain - the parent and will be a regular Surface with its own pixel data. - - .. versionadded:: 2.3.1 - Added support for deepcopy by implementing __deepcopy__, calls copy() internally. - """ - + @overload + def convert_alpha(self, surface: Surface) -> Surface: ... + @overload + def convert_alpha(self) -> Surface: ... def fill( self, - color: ColorLike, - rect: RectLike | None = None, + color: ColorValue, + rect: Optional[RectValue] = None, special_flags: int = 0, - ) -> Rect: - """Fill Surface with a solid color. - - Fill the Surface with a solid color. If no rect argument is given the - entire Surface will be filled. The rect argument will limit the fill to a - specific area. The fill will also be contained by the Surface clip area. - - The color argument should be compatible with :data:`pygame.typing.ColorLike`. - If using ``RGBA``, the Alpha (A part of ``RGBA``) is ignored unless the Surface - uses per pixel alpha (Surface has the ``SRCALPHA`` flag). - - The special_flags argument controls how the colors are combined. See :doc:`special_flags_list` - for a list of possible values. - - This will return the affected Surface area. - - .. note:: As of pygame-ce version 2.5.1, a long-standing bug has been fixed! - Now when passing in a ``Rect`` with negative ``x`` or negative ``y`` (or both), - the ``Rect`` filled will no longer be shifted to ``(0, 0)``, but instead only the - part of the ``Rect`` overlapping the window's ``Rect`` will be filled. - """ - - def scroll(self, dx: int = 0, dy: int = 0, scroll_flag: int = 0, /) -> None: - """Shift the Surface pixels in place. - - Move the Surface by dx pixels right and dy pixels down. dx and dy may be - negative for left and up scrolls respectively. - - Scrolling is contained by the Surface clip area. It is safe to have dx - and dy values that exceed the Surface size. - - The scroll flag can be: - * ``0`` (default): the pixels are shifted but previous pixels are - not modified. - - * ``pygame.SCROLL_ERASE``: the space created by the shifting pixels - is filled with black or transparency. - - * ``pygame.SCROLL_REPEAT``: the pixels that disappear out of the - Surface or clip bounds are brought back on the opposite side - resulting in an infinitely scrolling and repeating Surface. - - .. versionaddedold:: 1.9 - - .. versionchanged:: 2.5.3 Add repeating scroll and allow erasing pixels - """ - + ) -> Rect: ... + def scroll(self, dx: int = 0, dy: int = 0) -> None: ... @overload - def set_colorkey(self, color: ColorLike, flags: int = 0, /) -> None: ... + def set_colorkey(self, color: ColorValue, flags: int = 0) -> None: ... @overload - def set_colorkey(self, color: None, /) -> None: ... - def set_colorkey(self, *args): # type: ignore - """Set the transparent colorkey. - - Set the current color key for the Surface. When blitting this Surface - onto a destination, any pixels that have the same color as the colorkey - will be transparent. The color should be compatible with :data:`pygame.typing.ColorLike`. - If ``None`` is passed, the colorkey will be unset. - - The colorkey will be ignored if the Surface is formatted to use per pixel - alpha values. The colorkey can be mixed with the full Surface alpha - value. - - The optional flags argument can be set to ``pygame.RLEACCEL`` to provide - better performance on non accelerated displays. An ``RLEACCEL`` Surface - will be slower to modify, but quicker to blit as a source. - """ - - def get_colorkey(self) -> tuple[int, int, int, int] | None: - """Get the current transparent colorkey. - - Return the current colorkey value for the Surface. If the colorkey is not - set then ``None`` is returned. - """ - + def set_colorkey(self, color: None) -> None: ... + def get_colorkey(self) -> Optional[RGBAOutput]: ... @overload - def set_alpha(self, value: int, flags: int = 0, /) -> None: ... + def set_alpha(self, value: int, flags: int = 0) -> None: ... @overload - def set_alpha(self, value: None, /) -> None: ... - def set_alpha(self, *args): # type: ignore - """Set the alpha value for the full Surface. - - Set the current alpha value for the Surface. When blitting this Surface - onto a destination, the pixels will be drawn slightly transparent. The - alpha value is an integer from 0 to 255, 0 is fully transparent and 255 - is fully opaque. If ``None`` is passed for the alpha value, then alpha - blending will be disabled. This full alpha is compatible with other - kinds of transparency. - - The optional flags argument can be set to ``pygame.RLEACCEL`` to provide - better performance on non accelerated displays. An ``RLEACCEL`` Surface - will be slower to modify, but quicker to blit as a source. - - .. versionchangedold:: 2.0 per-Surface alpha can be combined with per-pixel - alpha. - """ - - def get_alpha(self) -> int | None: - """Get the current Surface transparency value. - - Return the current alpha value for the Surface, which is an integer in the - range 0 (fully transparent) - 255 (fully opaque) set by :meth:`set_alpha()`. - Until an alpha is set this method will return None. - """ - - def lock(self) -> None: - """Lock the Surface memory for pixel access. - - Lock the pixel data of a Surface for access. On accelerated Surfaces, the - pixel data may be stored in volatile video memory or nonlinear compressed - forms. When a Surface is locked the pixel memory becomes available to - access by regular software. Code that reads or writes pixel values will - need the Surface to be locked. - - Surfaces should not remain locked for more than necessary. A locked - Surface can often not be displayed or managed by pygame. - - Not all Surfaces require locking. The :meth:`mustlock()` method can - determine if it is actually required. There is no performance penalty for - locking and unlocking a Surface that does not need it. - - All pygame functions will automatically lock and unlock the Surface data - as needed. If a section of code is going to make calls that will - repeatedly lock and unlock the Surface many times, it can be helpful to - wrap the block inside a lock and unlock pair. - - It is safe to nest locking and unlocking calls. The Surface will only be - unlocked after the final lock is released. - """ - - def unlock(self) -> None: - """Unlock the Surface memory from pixel access. - - Unlock the Surface pixel data after it has been locked. The unlocked - Surface can once again be drawn and managed by pygame. See the - :meth:`lock()` documentation for more details. - - All pygame functions will automatically lock and unlock the Surface data - as needed. If a section of code is going to make calls that will - repeatedly lock and unlock the Surface many times, it can be helpful to - wrap the block inside a lock and unlock pair. - - It is safe to nest locking and unlocking calls. The Surface will only be - unlocked after the final lock is released. - """ - - def mustlock(self) -> bool: - """Test if the Surface requires locking. - - Returns ``True`` if the Surface is required to be locked to access pixel - data. Usually pure software Surfaces do not require locking. This method - is rarely needed, since it is safe and quickest to just lock all Surfaces - as needed. - - All pygame functions will automatically lock and unlock the Surface data - as needed. If a section of code is going to make calls that will - repeatedly lock and unlock the Surface many times, it can be helpful to - wrap the block inside a lock and unlock pair. - """ - - def get_locked(self) -> bool: - """Test if the Surface is current locked. - - Returns ``True`` when the Surface is locked. It doesn't matter how many - times the Surface is locked. - """ - - def get_locks(self) -> tuple[Any, ...]: - """Gets the locks for the Surface. - - Returns the currently existing locks for the Surface. - """ - - def get_at(self, x_y: Point, /) -> Color: - """Get the color value at a single pixel. - - Return a copy of the ``RGBA`` Color value at the given pixel. If the - Surface has no per pixel alpha, then the alpha value will always be 255 - (opaque). If the pixel position is outside the area of the Surface an - ``IndexError`` exception will be raised. - - Getting and setting pixels one at a time is generally too slow to be used - in a game or realtime situation. It is better to use methods which - operate on many pixels at a time like with the blit, fill and draw - methods - or by using :mod:`pygame.surfarray`/:mod:`pygame.PixelArray`. - - This function will temporarily lock and unlock the Surface as needed. - - .. versionchanged:: 2.3.1 can now also accept both float coordinates and - Vector2s for pixels. - - .. versionchangedold:: 1.9 - Returning a Color instead of tuple. Use ``tuple(surf.get_at((x,y)))`` - if you want a tuple, and not a Color. This should only matter if - you want to use the color as a key in a dict. - """ - - def set_at(self, x_y: Point, color: ColorLike, /) -> None: - """Set the color value for a single pixel. - - Set the color of a single pixel at the specified coordinates to be a - :data:`pygame.typing.ColorLike` value. If the Surface does not have per pixel alphas, - the alpha value is ignored. Setting pixels outside the Surface area or outside - the Surface clipping will have no effect. - - Getting and setting pixels one at a time is generally too slow to be used - in a game or realtime situation. - - This function will temporarily lock and unlock the Surface as needed. - - .. note:: If the Surface is palettized, the pixel color will be set to the - most similar color in the palette. - - .. versionchanged:: 2.3.1 can now also accept both float coordinates and - Vector2s for pixels. - """ - - def get_at_mapped(self, x_y: Point, /) -> int: - """Get the mapped color value at a single pixel. - - Return the integer value of the given pixel. If the pixel position is - outside the area of the Surface an ``IndexError`` exception will be - raised. - - This method is intended for pygame unit testing. It unlikely has any use - in an application. - - This function will temporarily lock and unlock the Surface as needed. - - .. versionaddedold:: 1.9.2 - - .. versionchanged:: 2.3.1 can now also accept both float coordinates and - Vector2s for pixels. - """ - - def get_palette(self) -> list[Color]: - """Get the color index palette for an 8-bit Surface. - - Return a list of up to 256 color elements that represent the indexed - colors used in an 8-bit Surface. The returned list is a copy of the - palette, and changes will have no effect on the Surface. - - Returning a list of ``Color(with length 3)`` instances instead of tuples. - - .. versionaddedold:: 1.9 - """ - - def get_palette_at(self, index: int, /) -> Color: - """Get the color for a single entry in a palette. - - Returns the red, green, and blue color values for a single index in a - Surface palette. The index should be a value from 0 to 255. - - .. versionaddedold:: 1.9 - Returning ``Color(with length 3)`` instance instead of a tuple. - """ - - def set_palette(self, palette: SequenceLike[ColorLike], /) -> None: - """Set the color palette for an 8-bit Surface. - - Set the full palette for an 8-bit Surface. This will replace the colors in - the existing palette. A partial palette can be passed and only the first - colors in the original palette will be changed. - - This function has no effect on a Surface with more than 8-bits per pixel. - """ - - def set_palette_at(self, index: int, color: ColorLike, /) -> None: - """Set the color for a single index in an 8-bit Surface palette. - - Set the palette value for a single entry in a Surface palette. The index - should be a value from 0 to 255. - - This function has no effect on a Surface with more than 8-bits per pixel. - """ - - def map_rgb(self, color: ColorLike, /) -> int: - """Convert a color into a mapped color value. - - Convert a :data:`pygame.typing.ColorLike` into the mapped integer value - for this Surface. The returned integer will contain no more bits than the - bit depth of the Surface. Mapped color values are not often used inside pygame, - but can be passed to most functions that require a Surface and a color. - - See the Surface object documentation for more information about colors - and pixel formats. - """ - - def unmap_rgb(self, mapped_int: int, /) -> Color: - """Convert a mapped integer color value into a Color. - - Convert an mapped integer color into the ``RGB`` color components for - this Surface. Mapped color values are not often used inside pygame, but - can be passed to most functions that require a Surface and a color. - - See the Surface object documentation for more information about colors - and pixel formats. - """ - - def set_clip(self, rect: RectLike | None, /) -> None: - """Set the current clipping area of the Surface. - - Each Surface has an active clipping area. This is a rectangle that - represents the only pixels on the Surface that can be modified. If - ``None`` is passed for the rectangle the full Surface will be available - for changes. - - The clipping area is always restricted to the area of the Surface itself. - If the clip rectangle is too large it will be shrunk to fit inside the - Surface. - """ - - def get_clip(self) -> Rect: - """Get the current clipping area of the Surface. - - Return a rectangle of the current clipping area. The Surface will always - return a valid rectangle that will never be outside the bounds of the - Surface. If the Surface has had ``None`` set for the clipping area, the - Surface will return a rectangle with the full area of the Surface. - """ - + def set_alpha(self, value: None) -> None: ... + def get_alpha(self) -> Optional[int]: ... + def lock(self) -> None: ... + def unlock(self) -> None: ... + def mustlock(self) -> bool: ... + def get_locked(self) -> bool: ... + def get_locks(self) -> Tuple[Any, ...]: ... + def get_at(self, x_y: Sequence[int]) -> Color: ... + def set_at(self, x_y: Sequence[int], color: ColorValue) -> None: ... + def get_at_mapped(self, x_y: Sequence[int]) -> int: ... + def get_palette(self) -> List[Color]: ... + def get_palette_at(self, index: int) -> Color: ... + def set_palette(self, palette: Sequence[ColorValue]) -> None: ... + def set_palette_at(self, index: int, color: ColorValue) -> None: ... + def map_rgb(self, color: ColorValue) -> int: ... + def unmap_rgb(self, mapped_int: int) -> Color: ... + def set_clip(self, rect: Optional[RectValue]) -> None: ... + def get_clip(self) -> Rect: ... @overload - def subsurface(self, rect: RectLike, /) -> Surface: ... + def subsurface(self, rect: RectValue) -> Surface: ... @overload - def subsurface(self, left_top: Point, width_height: Point, /) -> Surface: ... + def subsurface(self, left_top: Coordinate, width_height: Coordinate) -> Surface: ... @overload def subsurface( - self, left: float, top: float, width: float, height: float, / + self, left: float, top: float, width: float, height: float ) -> Surface: ... - def subsurface(self, *args): # type: ignore - """Create a new Surface that references its parent. - - Returns a new Surface that shares its pixels with its new parent. The new - Surface is considered a child of the original. Modifications to either - Surface pixels will effect each other. Surface information like clipping - area and color keys are unique to each Surface. - - The new Surface will inherit the palette, color key, and alpha settings - from its parent. - - It is possible to have any number of subsurfaces and subsubsurfaces on - the parent. It is also possible to subsurface the display Surface if the - display mode is not hardware accelerated. - - See :meth:`get_offset()` and :meth:`get_parent()` to learn more - about the state of a subsurface. - - A subsurface will have the same class as the parent Surface. - """ - - def get_parent(self) -> Surface: - """Find the parent of a subsurface. - - Returns the parent Surface of a subsurface. If this is not a subsurface - then ``None`` will be returned. - """ - - def get_abs_parent(self) -> Surface: - """Find the top level parent of a subsurface. - - Returns the top level parent Surface of a subsurface. If this is not - a subsurface then this Surface will be returned. - """ - - def get_offset(self) -> tuple[int, int]: - """Find the position of a child subsurface inside a parent. - - Get the offset position of a child subsurface inside of a parent. If the - Surface is not a subsurface this will return (0, 0). - """ - - def get_abs_offset(self) -> tuple[int, int]: - """Find the absolute position of a child subsurface inside its top level parent. - - Get the offset position of a child subsurface inside of its top level - parent Surface. If the Surface is not a subsurface this will return (0, - 0). - """ - - def get_size(self) -> tuple[int, int]: - """Get the dimensions of the Surface. - - Return the width and height of the Surface in pixels. Can also be accessed - with :attr:`size` - """ - - def get_width(self) -> int: - """Get the width of the Surface. - - Return the width of the Surface in pixels. Can also be accessed with :attr:`width` - """ - - def get_height(self) -> int: - """Get the height of the Surface. - - Return the height of the Surface in pixels. Can also be accessed with :attr:`height` - """ - - def get_rect(self, **kwargs: Any) -> Rect: - """Get the rectangular area of the Surface. - - Returns a new rectangle covering the entire Surface. This rectangle will - always start at (0, 0) with a width and height the same size as the Surface. - - You can pass keyword argument values to this function. These named values - will be applied to the attributes of the Rect before it is returned. An - example would be ``mysurf.get_rect(center=(100, 100))`` to create a - rectangle for the Surface centered at a given position. Size attributes - such as ``size`` or ``w`` can also be applied to resize the Rect. - """ - - def get_frect(self, **kwargs: Any) -> FRect: - """Get the rectangular area of the Surface. - - This is the same as :meth:`Surface.get_rect` but returns an FRect. FRect is similar - to Rect, except it stores float values instead. - - You can pass keyword argument values to this function. These named values - will be applied to the attributes of the FRect before it is returned. An - example would be ``mysurf.get_frect(center=(100.5, 100.5))`` to create a - rectangle for the Surface centered at a given position. Size attributes - such as ``size`` or ``w`` can also be applied to resize the FRect. - - .. versionadded:: 2.3.0 - """ - - def get_bitsize(self) -> int: - """Get the bit depth of the Surface pixel format. - - Returns the number of bits used to represent each pixel. This value may - not exactly fill the number of bytes used per pixel. For example a 15 bit - Surface still requires a full 2 bytes. - """ - - def get_bytesize(self) -> int: - """Get the bytes used per Surface pixel. - - Return the number of bytes used per pixel. - """ - - def get_flags(self) -> int: - """Get the additional flags used for the Surface. - - Returns a set of current Surface features. Each feature is a bit in the - flags bitmask. Typical flags are ``RLEACCEL``, ``SRCALPHA``, and - ``SRCCOLORKEY``. - - Here is a more complete list of flags. A full list can be found in - ``SDL_video.h`` - - :: - - SWSURFACE 0x00000000 # Surface is in system memory - HWSURFACE 0x00000001 # (obsolete in pygame 2) Surface is in video memory - ASYNCBLIT 0x00000004 # (obsolete in pygame 2) Use asynchronous blits if possible - - See :func:`pygame.display.set_mode()` for flags exclusive to the - display Surface. - - Used internally (read-only) - - :: - - HWACCEL 0x00000100 # Blit uses hardware acceleration - SRCCOLORKEY 0x00001000 # Blit uses a source color key - RLEACCELOK 0x00002000 # Private flag - RLEACCEL 0x00004000 # Surface is RLE encoded - SRCALPHA 0x00010000 # Blit uses source alpha blending - PREALLOC 0x01000000 # Surface uses preallocated memory - """ - - def get_pitch(self) -> int: - """Get the number of bytes used per Surface row. - - Return the number of bytes separating each row in the Surface. Surfaces - in video memory are not always linearly packed. Subsurfaces will also - have a larger pitch than their real width. - - This value is not needed for normal pygame usage. - """ - - def get_masks(self) -> tuple[int, int, int, int]: - """The bitmasks needed to convert between a color and a mapped integer. - - Returns the bitmasks used to isolate each color in a mapped integer. - - This value is not needed for normal pygame usage. - """ - - @deprecated("since 2.0.0. Immutable in SDL2") - def set_masks(self, color: ColorLike, /) -> None: - """Set the bitmasks needed to convert between a color and a mapped integer. - - This is not needed for normal pygame usage. - - .. note:: Starting in pygame 2.0, the masks are read-only and - accordingly this method will raise a TypeError if called. - - .. deprecatedold:: 2.0.0 - - .. versionaddedold:: 1.8.1 - """ - - def get_shifts(self) -> tuple[int, int, int, int]: - """The bit shifts needed to convert between a color and a mapped integer. - - Returns the pixel shifts need to convert between each color and a mapped - integer. - - This value is not needed for normal pygame usage. - """ - - @deprecated("since 2.0.0. Immutable in SDL2") - def set_shifts(self, color: ColorLike, /) -> None: - """Sets the bit shifts needed to convert between a color and a mapped integer. - - This is not needed for normal pygame usage. - - .. note:: Starting in pygame 2.0, the shifts are read-only and - accordingly this method will raise a TypeError if called. - - .. deprecatedold:: 2.0.0 - - .. versionaddedold:: 1.8.1 - """ - - def get_losses(self) -> tuple[int, int, int, int]: - """The significant bits used to convert between a color and a mapped integer. - - Return the least significant number of bits stripped from each color in a - mapped integer. - - This value is not needed for normal pygame usage. - """ - - def get_bounding_rect(self, min_alpha: int = 1) -> Rect: - """Find the smallest rect containing data. - - Returns the smallest rectangular region that contains all the pixels in - the Surface that have an alpha value greater than or equal to the minimum - alpha value. - - This function will temporarily lock and unlock the Surface as needed. - - .. versionaddedold:: 1.8 - """ - - def get_view(self, kind: _ViewKind = "2", /) -> BufferProxy: - """Return a buffer view of the Surface's pixels. - - Return an object which exports a Surface's internal pixel buffer as - a C level array struct, Python level array interface or a C level - buffer interface. The new buffer protocol is supported. - - The kind argument is the length 1 string '0', '1', '2', '3', - 'r', 'g', 'b', or 'a'. The letters are case insensitive; - 'A' will work as well. The argument can be either a Unicode or byte (char) - string. The default is '2'. - - '0' returns a contiguous unstructured bytes view. No Surface shape - information is given. A ``ValueError`` is raised if the Surface's pixels - are discontinuous. - - '1' returns a (Surface.width * Surface.height) array of continuous - pixels. A ``ValueError`` is raised if the Surface pixels are - discontinuous. - - '2' returns a (Surface.width, Surface.height) array of raw pixels. - The pixels are Surface-bytesize-d unsigned integers. The pixel format is - Surface specific. The 3 byte unsigned integers of 24 bit Surfaces are - unlikely accepted by anything other than other pygame functions. - - '3' returns a (Surface.width, Surface.height, 3) array of ``RGB`` color - components. Each of the red, green, and blue components are unsigned - bytes. Only 24-bit and 32-bit Surfaces are supported. The color - components must be in either ``RGB`` or ``BGR`` order within the pixel. - - 'r' for red, 'g' for green, 'b' for blue, and 'a' for alpha return a - (Surface.width, Surface.height) view of a single color component within a - Surface: a color plane. Color components are unsigned bytes. Both 24-bit - and 32-bit Surfaces support 'r', 'g', and 'b'. Only 32-bit Surfaces with - ``SRCALPHA`` support 'a'. - - The Surface is locked only when an exposed interface is accessed. - For new buffer interface accesses, the Surface is unlocked once the - last buffer view is released. For array interface and old buffer - interface accesses, the Surface remains locked until the BufferProxy - object is released. - - .. versionaddedold:: 1.9.2 - """ - - def get_buffer(self) -> BufferProxy: - """Acquires a buffer object for the pixels of the Surface. - - Return a buffer object for the pixels of the Surface. The buffer can be - used for direct pixel access and manipulation. Surface pixel data is - represented as an unstructured block of memory, with a start address - and length in bytes. The data need not be contiguous. Any gaps are - included in the length, but otherwise ignored. - - This method implicitly locks the Surface. The lock will be released when - the returned :mod:`pygame.BufferProxy` object is garbage collected. - - .. versionaddedold:: 1.8 - """ - + def get_parent(self) -> Surface: ... + def get_abs_parent(self) -> Surface: ... + def get_offset(self) -> Tuple[int, int]: ... + def get_abs_offset(self) -> Tuple[int, int]: ... + def get_size(self) -> Tuple[int, int]: ... + def get_width(self) -> int: ... + def get_height(self) -> int: ... + def get_rect(self, **kwargs: Any) -> Rect: ... + def get_bitsize(self) -> int: ... + def get_bytesize(self) -> int: ... + def get_flags(self) -> int: ... + def get_pitch(self) -> int: ... + def get_masks(self) -> RGBAOutput: ... + def set_masks(self, color: ColorValue) -> None: ... + def get_shifts(self) -> RGBAOutput: ... + def set_shifts(self, color: ColorValue) -> None: ... + def get_losses(self) -> RGBAOutput: ... + def get_bounding_rect(self, min_alpha: int = 1) -> Rect: ... + def get_view(self, kind: _ViewKind = "2") -> BufferProxy: ... + def get_buffer(self) -> BufferProxy: ... def get_blendmode(self) -> int: ... - def premul_alpha(self) -> Surface: - """Returns a copy of the Surface with the RGB channels pre-multiplied by the alpha channel. + def premul_alpha(self) -> Surface: ... - Returns a copy of the initial Surface with the red, green and blue color - channels multiplied by the alpha channel. This is intended to make it - easier to work with the BLEND_PREMULTIPLED blend mode flag of the blit() - method. Surfaces which have called this method will only look correct - after blitting if the BLEND_PREMULTIPLED special flag is used. - - It is worth noting that after calling this method, methods that return the - color of a pixel such as get_at() will return the alpha multiplied color - values. It is not possible to fully reverse an alpha multiplication of - the colors in a Surface as integer color channel data is generally - reduced by the operation (e.g. 255 x 0 = 0, from there it is not - possible to reconstruct the original 255 from just the two remaining - zeros in the color and alpha channels). - - If you call this method, and then call it again, it will multiply the color - channels by the alpha channel twice. There are many possible ways to obtain - a Surface with the color channels pre-multiplied by the alpha channel in - pygame, and it is not possible to tell the difference just from the - information in the pixels. It is completely possible to have two identical - Surfaces - one intended for pre-multiplied alpha blending and one intended - for normal blending. For this reason we do not store state on Surfaces - intended for pre-multiplied alpha blending. - - Surfaces without an alpha channel cannot use this method and will return - an error if you use it on them. It is best used on 32 bit Surfaces (the - default on most platforms) as the blitting on these Surfaces can be - accelerated by SIMD versions of the pre-multiplied blitter. - - In general pre-multiplied alpha blitting is faster then 'straight alpha' - blitting and produces superior results when blitting an alpha Surface onto - another Surface with alpha - assuming both Surfaces contain pre-multiplied - alpha colors. - - There is a `tutorial on premultiplied alpha blending here. <../tutorials/en/premultiplied-alpha.html>`_ - - .. versionadded:: 2.1.4 - """ - - def premul_alpha_ip(self) -> Surface: - """Multiplies the RGB channels by the Surface alpha channel. - - Multiplies the RGB channels of the Surface by the alpha channel in place - and returns the Surface. - - Surfaces without an alpha channel cannot use this method and will return - an error if you use it on them. It is best used on 32 bit Surfaces (the - default on most platforms) as the blitting on these Surfaces can be - accelerated by SIMD versions of the pre-multiplied blitter. - - Refer to the :meth:`premul_alpha` method for more information. - - .. versionadded:: 2.5.1 - """ - - @property - def width(self) -> int: - """Surface width in pixels (read-only). - - Read-only attribute. Same as :meth:`get_width()` - - .. versionadded:: 2.5.0 - """ - @property - def height(self) -> int: - """Surface height in pixels (read-only). - - Read-only attribute. Same as :meth:`get_height()` - - .. versionadded:: 2.5.0 - """ - - @property - def size(self) -> tuple[int, int]: - """Surface size in pixels (read-only). - - Read-only attribute. Same as :meth:`get_size()` - - .. versionadded:: 2.5.0 - """ - - @property - def _pixels_address(self) -> int: - """Pixel buffer address. - - The starting address of the surface's raw pixel bytes. - - .. versionaddedold:: 1.9.2 - """ - -@deprecated("Use `Surface` instead (SurfaceType is an old alias)") -class SurfaceType(Surface): ... +SurfaceType = Surface diff --git a/.venv/lib/python3.14/site-packages/pygame/surfarray.py b/.venv/lib/python3.14/site-packages/pygame/surfarray.py index 83ae196..0bcd431 100644 --- a/.venv/lib/python3.14/site-packages/pygame/surfarray.py +++ b/.venv/lib/python3.14/site-packages/pygame/surfarray.py @@ -1,4 +1,4 @@ -## pygame-ce - Python Game Library +## pygame - Python Game Library ## Copyright (C) 2007 Marcus von Appen ## ## This library is free software; you can redistribute it and/or @@ -37,21 +37,23 @@ to as 3D arrays, and the last index is 0 for red, 1 for green, and 2 for blue. """ -import warnings # will be removed in the future +from pygame.pixelcopy import ( + array_to_surface, + surface_to_array, + map_array as pix_map_array, + make_surface as pix_make_surface, +) import numpy from numpy import ( array as numpy_array, empty as numpy_empty, - ndarray as numpy_ndarray, uint32 as numpy_uint32, + ndarray as numpy_ndarray, ) -from pygame.pixelcopy import ( - array_to_surface, - make_surface as pix_make_surface, - map_array as pix_map_array, - surface_to_array, -) + +import warnings # will be removed in the future + # float96 not available on all numpy versions. numpy_floats = [ @@ -59,7 +61,7 @@ numpy_floats = [ for type_name in "float32 float64 float96".split() if hasattr(numpy, type_name) ] -# Added below due to deprecation of numpy.float. See pygame-ce issue #1440 +# Added below due to deprecation of numpy.float. See issue #2814 numpy_floats.append(float) # Pixel sizes corresponding to NumPy supported integer sizes, and therefore @@ -95,19 +97,12 @@ __all__ = [ def blit_array(surface, array): """pygame.surfarray.blit_array(Surface, array): return None - Blit directly from an array of values. + Blit directly from a array values. Directly copy values from an array into a Surface. This is faster than converting the array into a Surface and blitting. The array must be the same dimensions as the Surface and will completely replace all pixel - values. Accepted array types are integer, ascii character and record - arrays, as well as ``float32``, ``float64`` and (where available) - ``float96`` NumPy arrays. - - Float arrays are first rounded to the nearest integer and copied into - a new array before blitting. This extra copy defeats the performance - benefit this function is meant to provide, so pass an integer array - directly whenever possible. + values. Only integer, ascii character and record arrays are accepted. This function will temporarily lock the Surface as the new values are copied. @@ -123,11 +118,7 @@ def make_surface(array): Copy an array to a new surface. Create a new Surface that best resembles the data and format on the - array. The array can be 2D or 3D with any sized integer values, or - ``float32``, ``float64`` or (where available) ``float96`` NumPy arrays. - - Float arrays are first rounded to the nearest integer and copied into - a new array before creating the surface. + array. The array can be 2D or 3D with any sized integer values. """ if isinstance(array, numpy_ndarray) and array.dtype in numpy_floats: array = array.round(0).astype(numpy_uint32) @@ -395,9 +386,9 @@ def map_array(surface, array): format to control the conversion. Note: arrays do not need to be 3D, as long as the minor axis has - three elements giving the component colors, any array shape can be - used (for example, a single color can be mapped, or an array of - colors). The array shape is limited to eleven dimensions maximum, + three elements giving the component colours, any array shape can be + used (for example, a single colour can be mapped, or an array of + colours). The array shape is limited to eleven dimensions maximum, including the three element minor axis. """ if array.ndim == 0: diff --git a/.venv/lib/python3.14/site-packages/pygame/surfarray.pyi b/.venv/lib/python3.14/site-packages/pygame/surfarray.pyi index 421524b..bf15758 100644 --- a/.venv/lib/python3.14/site-packages/pygame/surfarray.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/surfarray.pyi @@ -1,12 +1,14 @@ +from typing import Tuple + import numpy +from pygame.surface import Surface + # importing this way exports the functions in the typestubs from pygame.pixelcopy import ( array_to_surface as array_to_surface, surface_to_array as surface_to_array, ) -from pygame.surface import Surface -from typing_extensions import deprecated # added in 3.13 def array2d(surface: Surface) -> numpy.ndarray: ... def pixels2d(surface: Surface) -> numpy.ndarray: ... @@ -24,34 +26,6 @@ def array_colorkey(surface: Surface) -> numpy.ndarray: ... def make_surface(array: numpy.ndarray) -> Surface: ... def blit_array(surface: Surface, array: numpy.ndarray) -> None: ... def map_array(surface: Surface, array: numpy.ndarray) -> numpy.ndarray: ... -@deprecated("Only numpy is supported") def use_arraytype(arraytype: str) -> None: ... -@deprecated("Only numpy is supported") def get_arraytype() -> str: ... -@deprecated("Only numpy is supported") -def get_arraytypes() -> tuple[str]: ... - -# keep in sync with surfarray.py -__all__ = [ - "array2d", - "array3d", - "array_alpha", - "array_blue", - "array_colorkey", - "array_green", - "array_red", - "array_to_surface", - "blit_array", - "get_arraytype", - "get_arraytypes", - "make_surface", - "map_array", - "pixels2d", - "pixels3d", - "pixels_alpha", - "pixels_blue", - "pixels_green", - "pixels_red", - "surface_to_array", - "use_arraytype", -] +def get_arraytypes() -> Tuple[str]: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/surflock.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/surflock.cpython-314-x86_64-linux-gnu.so index f91cc51..117ba9b 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/surflock.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/surflock.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/sysfont.py b/.venv/lib/python3.14/site-packages/pygame/sysfont.py index 4c2efe5..6ddcb78 100644 --- a/.venv/lib/python3.14/site-packages/pygame/sysfont.py +++ b/.venv/lib/python3.14/site-packages/pygame/sysfont.py @@ -1,4 +1,4 @@ -# pygame-ce - Python Game Library +# pygame - Python Game Library # Copyright (C) 2000-2003 Pete Shinners # # This library is free software; you can redistribute it and/or @@ -19,16 +19,19 @@ # pete@shinners.org """sysfont, used in the font module to find system fonts""" -import difflib -import itertools import os import sys import warnings from os.path import basename, dirname, exists, join, splitext -from pygame import __file__ as pygame_main_file from pygame.font import Font +if sys.platform != "emscripten": + if os.name == "nt": + import winreg as _winreg + import subprocess + + OpenType_extensions = frozenset((".ttf", ".ttc", ".otf")) Sysfonts = {} Sysalias = {} @@ -51,7 +54,6 @@ def _addfont(name, bold, italic, font, fontdict): def initsysfonts_win32(): """initialize fonts dictionary on Windows""" - import winreg as _winreg fontdir = join(os.environ.get("WINDIR", "C:\\Windows"), "Fonts") fonts = {} @@ -77,12 +79,6 @@ def initsysfonts_win32(): except OSError: break - # https://github.com/pygame-community/pygame-ce/issues/3742 - # Registry values could be other types besides strings. - # Lets skip those. - if not isinstance(font, str): - continue - if splitext(font)[1].lower() not in OpenType_extensions: continue if not dirname(font): @@ -91,8 +87,7 @@ def initsysfonts_win32(): # Some are named A & B, both names should be processed separately # Ex: the main Cambria file is marked as "Cambria & Cambria Math" for name in name.split("&"): - if os.path.exists(font): # check if the file actually exists - _parse_font_entry_win(name, font, fonts) + _parse_font_entry_win(name, font, fonts) return fonts @@ -104,8 +99,6 @@ def _parse_font_entry_win(name, font, fonts): :param name: The font name :param font: The font file path :param fonts: The pygame font dictionary - - :return: Tuple of (bold, italic, name) """ true_type_suffix = "(TrueType)" mods = ("demibold", "narrow", "light", "unicode", "bt", "mt") @@ -164,14 +157,13 @@ def _font_finder_darwin(): "/System/Library/Fonts/Supplemental", ] - if username := os.getenv("USER"): + username = os.getenv("USER") + if username: locations.append(f"/Users/{username}/Library/Fonts") strange_root = "/System/Library/Assets/com_apple_MobileAsset_Font3" if exists(strange_root): - locations += [ - f"{strange_root}/{loc}/AssetData" for loc in os.listdir(strange_root) - ] + locations += [f"{strange_root}/{loc}" for loc in os.listdir(strange_root)] fonts = {} @@ -189,17 +181,20 @@ def _font_finder_darwin(): def initsysfonts_darwin(): - """Read the fonts on macOS, and OS X.""" - # if the X11 binary exists... try to use that. - # Not likely to be there on pre 10.4.x ... or macOS 10.10+ - if exists("/usr/X11/bin/fc-list"): - fonts = initsysfonts_unix("/usr/X11/bin/fc-list") - # This fc-list path will work with the X11 from the OS X 10.3 installation - # disc - elif exists("/usr/X11R6/bin/fc-list"): - fonts = initsysfonts_unix("/usr/X11R6/bin/fc-list") - else: - # eventually this should probably be the preferred solution + """Read the fonts on MacOS, and OS X.""" + # fc-list is not likely to be there on pre 10.4.x, or MacOS 10.10+ + fonts = {} + + fclist_locations = [ + "/usr/X11/bin/fc-list", # apple x11 + "/usr/X11R6/bin/fc-list", # apple x11 + ] + for bin_location in fclist_locations: + if exists(bin_location): + fonts = initsysfonts_unix(bin_location) + break + + if len(fonts) == 0: fonts = _font_finder_darwin() return fonts @@ -213,8 +208,6 @@ def initsysfonts_unix(path="fc-list"): if sys.platform == "emscripten": return fonts - import subprocess - try: proc = subprocess.run( [path, ":", "file", "family", "style"], @@ -245,7 +238,7 @@ def initsysfonts_unix(path="fc-list"): for entry in proc.stdout.decode("ascii", "ignore").splitlines(): try: _parse_font_entry_unix(entry, fonts) - except ValueError: + except ValueError: # noqa: PERF203 # try the next one. pass @@ -257,7 +250,7 @@ def _parse_font_entry_unix(entry, fonts): Parses an entry in the unix font data to add to the pygame font dictionary. - :param entry: An entry from the unix font list. + :param entry: A entry from the unix font list. :param fonts: The pygame font dictionary to add the parsed font data to. """ @@ -365,11 +358,6 @@ def initsysfonts(): else: fonts = initsysfonts_unix() - # Try to add the default font to sys fonts - pygame_folder = os.path.dirname(os.path.abspath(pygame_main_file)) - default_font_path = os.path.join(pygame_folder, "freesansbold.ttf") - _addfont("freesansbold", True, False, default_font_path, fonts) - Sysfonts.update(fonts) create_aliases() is_init = True @@ -396,37 +384,6 @@ def font_constructor(fontpath, size, bold, italic): return font -def _load_single_font(name, bold=False, italic=False): - fontname = None - gotbold = False - gotitalic = False - single_name = _simplename(name) - styles = Sysfonts.get(single_name) - if not styles: - styles = Sysalias.get(single_name) - if styles: - plainname = styles.get((False, False)) - fontname = styles.get((bold, italic)) - if not (fontname or plainname): - # Neither requested style, nor plain font exists, so - # return a font with the name requested, but an - # arbitrary style. - (style, fontname) = list(styles.items())[0] - # Attempt to style it as requested. This can't - # unbold or unitalicize anything, but it can - # fake bold and/or fake italicize. - if bold and style[0]: - gotbold = True - if italic and style[1]: - gotitalic = True - elif not fontname: - fontname = plainname - elif plainname != fontname: - gotbold = bold - gotitalic = italic - return fontname, gotbold, gotitalic - - # the exported functions @@ -439,16 +396,15 @@ def SysFont(name, size, bold=False, italic=False, constructor=None): the appropriate system font will be selected if available. This will always return a valid Font object, and will - fall back on the builtin pygame font if the given font + fallback on the builtin pygame font if the given font is not found. - Name shall be supplied as the plain font name without - file extensions. Name can also be an iterable of font names, - a string of comma-separated font names, or a bytes of - comma-separated font names, in which case the set of names - will be searched in order. Pygame uses a small set of common - font aliases. If the specific font you ask for is not available, - a reasonable alternative may be used. + Name can also be an iterable of font names, a string of + comma-separated font names, or a bytes of comma-separated + font names, in which case the set of names will be searched + in order. Pygame uses a small set of common font aliases. If the + specific font you ask for is not available, a reasonable + alternative may be used. If optional constructor is provided, it must be a function with signature constructor(fontpath, size, bold, italic) which returns @@ -460,51 +416,41 @@ def SysFont(name, size, bold=False, italic=False, constructor=None): initsysfonts() gotbold = gotitalic = False + fontname = None if name: if isinstance(name, (str, bytes)): name = name.split(b"," if isinstance(name, bytes) else ",") - else: - name = list(name) - for idx, single_name in enumerate(name): - if isinstance(single_name, bytes): - name[idx] = single_name.decode() - for single_name in name: - fontname, gotbold, gotitalic = _load_single_font(single_name, bold, italic) + if isinstance(single_name, bytes): + single_name = single_name.decode() + + single_name = _simplename(single_name) + styles = Sysfonts.get(single_name) + if not styles: + styles = Sysalias.get(single_name) + if styles: + plainname = styles.get((False, False)) + fontname = styles.get((bold, italic)) + if not (fontname or plainname): + # Neither requested style, nor plain font exists, so + # return a font with the name requested, but an + # arbitrary style. + (style, fontname) = list(styles.items())[0] + # Attempt to style it as requested. This can't + # unbold or unitalicize anything, but it can + # fake bold and/or fake italicize. + if bold and style[0]: + gotbold = True + if italic and style[1]: + gotitalic = True + elif not fontname: + fontname = plainname + elif plainname != fontname: + gotbold = bold + gotitalic = italic if fontname: break - else: - font_verification_message = ( - "Verify your font name input. Using the default font instead." - ) - - if len(name) > 1: - names = "', '".join(name) - warnings.warn( - "None of the specified system fonts " - f"('{names}') could be found. " - f"{font_verification_message}" - ) - else: - # Identifies the closest matches to the font provided by - # the user from the list of available fonts. - matches = difflib.get_close_matches( - _simplename(name[0]), itertools.chain(Sysfonts, Sysalias), 3 - ) - if matches: - match_text = "Did you mean: '" + "', '".join(matches) + "'? " - else: - match_text = "" - - warnings.warn( - f"The system font '{name[0]}' couldn't be " - f"found. {match_text}" - f"{font_verification_message}" - ) - else: - fontname = None - set_bold = set_italic = False if bold and not gotbold: set_bold = True @@ -528,7 +474,7 @@ def get_fonts(): def match_font(name, bold=False, italic=False): - """pygame.font.match_font(name, bold=False, italic=False) -> name + """pygame.font.match_font(name, bold=0, italic=0) -> name find the filename for the named system font This performs the same font search as the SysFont() diff --git a/.venv/lib/python3.14/site-packages/pygame/system.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/system.cpython-314-x86_64-linux-gnu.so deleted file mode 100755 index 3e1ffe6..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/system.cpython-314-x86_64-linux-gnu.so and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/system.pyi b/.venv/lib/python3.14/site-packages/pygame/system.pyi deleted file mode 100644 index 36e909a..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/system.pyi +++ /dev/null @@ -1,206 +0,0 @@ -"""Pygame module to provide additional context about the system. - -.. versionadded:: 2.2.0 -""" - -from typing import TypedDict - -from pygame._data_classes import PowerState - -class _InstructionSets(TypedDict): - ALTIVEC: bool - MMX: bool - SSE: bool - SSE2: bool - SSE3: bool - SSE41: bool - SSE42: bool - AVX: bool - AVX2: bool - AVX512F: bool - NEON: bool - ARMSIMD: bool - LSX: bool - LASX: bool - -class _Locale(TypedDict): - language: str - country: str | None - -def get_cpu_instruction_sets() -> _InstructionSets: - """Get the information of CPU instruction sets. - - Returns a dict of the information of CPU instruction sets. The keys of - the dict are the names of instruction sets and the values determine - whether the instruction set is available. - - Some of functions like ``Surface.blit`` can be accelerated by SIMD - instruction sets like SSE2 or AVX2. By checking the availability of - instruction sets, you can check if these accelerations are available. - - Here is an example of the returned dict - :: - - { - 'ALTIVEC': False, - 'MMX': True, - 'SSE': True, - 'SSE2': True, - 'SSE3': True, - 'SSE41': True, - 'SSE42': True, - 'AVX': True, - 'AVX2': True, - 'AVX512F': False, - 'NEON': False, - 'ARMSIMD': False, - 'LSX': False, - 'LASX': False - } - - .. note:: The values of ``LSX`` and ``LASX`` will be always False if - SDL version < 2.24.0. - - .. versionadded:: 2.3.1 - - .. versionchanged:: 2.4.0 removed ``RDTSC`` key, - as it has been removed in pre-release SDL3 - """ - -def get_total_ram() -> int: - """Get the amount of RAM configured in the system. - - Returns the amount of RAM configured in the system in MiB. - - .. versionadded:: 2.3.1 - """ - -def get_pref_path(org: str, app: str) -> str: - """Get a writeable folder for your app. - - When distributing apps, it's helpful to have a way to get a writeable path, - because it's what apps are expected to do, and because sometimes the local - space around the app isn't writeable to the app. - - This function returns a platform specific path for your app to store - savegames, settings, and the like. This path is unique per user and - per app name. - - It takes two strings, ``org`` and ``app``, referring to the "organization" - and "application name." For example, the organization could be "Valve," - and the application name could be "Half Life 2." It then will figure out the - preferred path, **creating the folders referenced by the path if necessary**, - and return a string containing the absolute path. - - For example:: - - On Windows, it would resemble - C:\\Users\\bob\\AppData\\Roaming\\My Company\\My Program Name\\ - - On macOS, it would resemble - /Users/bob/Library/Application Support/My Company/My Program Name/ - - And on Linux it would resemble - /home/bob/.local/share/My Company/My Program Name/ - - .. note:: - Since the organization and app names can potentially be used as - a folder name, it is highly encouraged to avoid punctuation. - Instead stick to letters, numbers, and spaces. - - .. note:: - The ``appdirs`` library has similar functionality for this use case, - but has more "folder types" to choose from. - - .. versionadded:: 2.2.0 - """ - -def get_pref_locales() -> list[_Locale]: - """Get preferred locales set on the system. - - Returns a list of "locale" dicts, sorted in descending order of preference - set on the host OS (the most preferred locale is the first element). May - also be an empty list if pygame could not find this information. - - Each "locale" dict contains the language code which can be accessed by the - key ``"language"``. This language code is an ISO-639 language specifier - (such as "en" for English, "de" for German, etc). - A "locale" dict may also optionally contain a ``"country"`` field, whose - value is an ISO-3166 country code (such as "US" for the United States, - "CA" for Canada, etc). If this field is not set or undetermined, it is - ``None``. - A "locale" dict which looks like ``{'language': 'en', 'country': 'US'}`` - indicates the user prefers American English, while - ``{'language': 'en', 'country': None}`` indicates that the user prefers - English, generically. - - This might be a bit of an expensive call because it has to query the OS. So - this function must not be called in a game loop, instead it's best to ask - for this once and save the results. However, this list can change when the - user changes a system preference outside of your program. pygame will send - a ``LOCALECHANGED`` event in this case, if possible, and you can call this - function again to get an updated copy of preferred locales. - - .. versionadded:: 2.2.0 - """ - -def get_power_state() -> PowerState | None: - """Get the current power supply state. - - **Experimental:** feature available for testing and feedback. - We don't anticipate it changing, but it might if something important - is brought up. `Please leave get_power_state feedback with - authors `_ - - Returns a ``PowerState`` object representing the power supply state. - - Returns ``None`` if the power state is unknown. - - The PowerState object has several attributes: - - .. code-block:: text - - battery_percent: - An integer between 0 and 100, representing the percentage of - battery life left. - - battery_seconds: - An integer, representing the seconds of battery life left. - Could be None if the value is unknown. - - on_battery: - True if the device is running on the battery (not plugged in). - - no_battery: - True if the device has no battery available (plugged in). - - charging: - True if the device is charging battery (plugged in). - - charged: - True if the battery of the device is fully charged (plugged in). - - plugged_in: - True if the device is plugged in. - Equivalent to `not on_battery`. - - has_battery: - True if the device has battery. - Equivalent to `on_battery or not no_battery`. - - - You should never take a battery status as absolute truth. Batteries - (especially failing batteries) are delicate hardware, and the values - reported here are best estimates based on what that hardware reports. It's - not uncommon for older batteries to lose stored power much faster than it - reports, or completely drain when reporting it has 20 percent left, etc. - - Battery status can change at any time; if you are concerned with power - state, you should call this function frequently, and perhaps ignore changes - until they seem to be stable for a few seconds. - - It's possible a platform can only report battery percentage or time left - but not both. - - .. versionadded:: 2.4.0 - """ diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/__init__.py b/.venv/lib/python3.14/site-packages/pygame/tests/__init__.py index 7cf1695..dd26586 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/__init__.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/__init__.py @@ -12,7 +12,7 @@ correspond to the pygame.tests.run arguments. The xxxx_test submodules of the tests package are unit test suites for individual parts of Pygame. Each can also be run as a main program. This is -useful if the test is interactive. +useful if the test, such as cdrom_test, is interactive. For Pygame development the test suite can be run from a Pygame distribution root directory using run_tests.py. Alternately, test/__main__.py can be run diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/__main__.py b/.venv/lib/python3.14/site-packages/pygame/tests/__main__.py index 364b98a..9b4cedd 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/__main__.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/__main__.py @@ -103,7 +103,7 @@ opt_parser.add_option("-S", "--seed", type="int", help="Randomisation seed") ########################################################################### # Set run() keyword arguments according to command line arguments. -# args will be the test module list, passed as positional arguments. +# args will be the test module list, passed as positional argumemts. options, args = opt_parser.parse_args() kwds = {} diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/base_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/base_test.py index 01d19bc..b11d2d6 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/base_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/base_test.py @@ -1,7 +1,8 @@ -import platform import sys import unittest +import platform + IS_PYPY = "PyPy" == platform.python_implementation() try: @@ -10,6 +11,7 @@ except NameError: pass import pygame + quit_count = 0 @@ -113,8 +115,7 @@ class BaseModuleTest(unittest.TestCase): # verified by first checking the weak reference both before and # after the regular reference held by o is removed. - import gc - import weakref + import weakref, gc class NoDictError(RuntimeError): pass @@ -192,7 +193,8 @@ class BaseModuleTest(unittest.TestCase): o = Exporter(shape, typechar, itemsize) self.assertEqual(getrefcount(o.__array_struct__), 1) - from pygame.tests.test_utils import buftools + if pygame.HAVE_NEWBUF: + from pygame.tests.test_utils import buftools def NEWBUF_assertSame(self, proxy, exp): buftools = self.buftools @@ -207,6 +209,7 @@ class BaseModuleTest(unittest.TestCase): self.assertEqual(imp.strides, exp.strides) self.assertTrue(imp.suboffsets is None) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") @unittest.skipIf(IS_PYPY, "pypy no likey") def test_newbuf(self): from pygame.bufferproxy import BufferProxy @@ -247,11 +250,11 @@ class BaseModuleTest(unittest.TestCase): v = BufferProxy(o) self.NEWBUF_assertSame(v, o) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_bad_format(self): - from ctypes import addressof, create_string_buffer - from pygame.bufferproxy import BufferProxy from pygame.newbuffer import BufferMixin + from ctypes import create_string_buffer, addressof buftools = self.buftools Exporter = buftools.Exporter @@ -277,6 +280,7 @@ class BaseModuleTest(unittest.TestCase): b = BufferProxy(exp) self.assertRaises(ValueError, Importer, b, PyBUF_FORMAT) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") @unittest.skipIf(IS_PYPY, "fails on pypy") def test_PgDict_AsBuffer_PyBUF_flags(self): from pygame.bufferproxy import BufferProxy @@ -378,11 +382,10 @@ class BaseModuleTest(unittest.TestCase): self.assertEqual(b.buf, 1000000) self.assertRaises(BufferError, Importer, a, buftools.PyBUF_FULL) - @unittest.skipIf(IS_PYPY, "newbuf with ctypes") + @unittest.skipIf(IS_PYPY or (not pygame.HAVE_NEWBUF), "newbuf with ctypes") def test_PgObject_AsBuffer_PyBUF_flags(self): - import ctypes - from pygame.bufferproxy import BufferProxy + import ctypes is_lil_endian = pygame.get_sdl_byteorder() == pygame.LIL_ENDIAN fsys, frev = ("<", ">") if is_lil_endian else (">", "<") @@ -507,6 +510,7 @@ class BaseModuleTest(unittest.TestCase): # Scrap is optional. pass + # pygame.cdrom # pygame.joystick def init_assertions(self): diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/blit_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/blit_test.py index b9e0f3d..dcd7d4c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/blit_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/blit_test.py @@ -3,6 +3,8 @@ import unittest import pygame from pygame.locals import * +from time import time + class BlitTest(unittest.TestCase): def test_SRCALPHA(self): @@ -71,7 +73,21 @@ class BlitTest(unittest.TestCase): s.blit(d, (0, 0), None, BLEND_SUB) self.assertEqual(s.get_at((0, 0))[0], 0) + +class BlitsTest(unittest.TestCase): + """Tests for pygame.Surface.blits""" + + def setUp(self): + self.NUM_SURFS = 255 + self.PRINT_TIMING = 0 + self.dst = pygame.Surface((self.NUM_SURFS * 10, 10), SRCALPHA, 32) + self.dst.fill((230, 230, 230)) + self.blit_list = self.make_blit_list(self.NUM_SURFS) + def make_blit_list(self, num_surfs): + """Generate a list of tuples representing surfaces and destinations + for blitting""" + blit_list = [] for i in range(num_surfs): dest = (i * 10, 0) @@ -81,172 +97,95 @@ class BlitTest(unittest.TestCase): blit_list.append((surf, dest)) return blit_list - def test_blits(self): - NUM_SURFS = 255 - PRINT_TIMING = 0 - dst = pygame.Surface((NUM_SURFS * 10, 10), SRCALPHA, 32) - dst.fill((230, 230, 230)) - blit_list = self.make_blit_list(NUM_SURFS) + def custom_blits(self, blit_list): + """Custom blits method that manually iterates over the blit_list and blits + each surface onto the destination.""" - def blits(blit_list): - for surface, dest in blit_list: - dst.blit(surface, dest) + for surface, dest in blit_list: + self.dst.blit(surface, dest) - from time import time + def test_custom_blits_performance(self): + """Checks time performance of the custom blits method""" t0 = time() - results = blits(blit_list) + results = self.custom_blits(self.blit_list) t1 = time() - if PRINT_TIMING: + if self.PRINT_TIMING: print(f"python blits: {t1 - t0}") - dst.fill((230, 230, 230)) - t0 = time() - results = dst.blits(blit_list) - t1 = time() - if PRINT_TIMING: - print(f"Surface.blits :{t1 - t0}") - - # check if we blit all the different colors in the correct spots. - for i in range(NUM_SURFS): - color = (i * 1, i * 1, i * 1) - self.assertEqual(dst.get_at((i * 10, 0)), color) - self.assertEqual(dst.get_at(((i * 10) + 5, 5)), color) - - self.assertEqual(len(results), NUM_SURFS) + def test_blits_performance(self): + """Checks time performance of blits""" t0 = time() - results = dst.blits(blit_list, doreturn=0) + results = self.dst.blits(self.blit_list) t1 = time() - if PRINT_TIMING: + if self.PRINT_TIMING: + print(f"Surface.blits: {t1 - t0}") + + # Measure time performance of blits with doreturn=0 + t0 = time() + results = self.dst.blits(self.blit_list, doreturn=0) + t1 = time() + if self.PRINT_TIMING: print(f"Surface.blits doreturn=0: {t1 - t0}") - self.assertEqual(results, None) + # Measure time performance of blits using a generator t0 = time() - results = dst.blits(((surf, dest) for surf, dest in blit_list)) + results = self.dst.blits(((surf, dest) for surf, dest in self.blit_list)) t1 = time() - if PRINT_TIMING: + if self.PRINT_TIMING: print(f"Surface.blits generator: {t1 - t0}") - def test_fblits(self): - NUM_SURFS = 255 - PRINT_TIMING = 0 - dst = pygame.Surface((NUM_SURFS * 10, 10), SRCALPHA, 32) - dst.fill((230, 230, 230)) - blit_list = self.make_blit_list(NUM_SURFS) + def test_blits_correctness(self): + """Checks the correctness of the colors on the destination + after blitting and tests that the length of the results list + matches the number of surfaces blitted.""" - def blits(blit_list): - for surface, dest in blit_list: - dst.blit(surface, dest) - - from time import time - - # tests for number of parameters - self.assertRaises(ValueError, dst.fblits) # no params - - # tests for the blit_sequence parameter - self.assertRaises(ValueError, dst.fblits, [-1]) - self.assertRaises(ValueError, dst.fblits, (-1,)) - self.assertRaises(ValueError, dst.fblits, "str") - self.assertRaises(ValueError, dst.fblits, 1) - - # tests for the special_flags parameter - self.assertRaises(TypeError, dst.fblits, blit_list, -999) # not impl. flag - self.assertRaises(TypeError, dst.fblits, blit_list, 12.245) # float flag - self.assertRaises(TypeError, dst.fblits, blit_list, None) - self.assertRaises(TypeError, dst.fblits, blit_list, []) - self.assertRaises(TypeError, dst.fblits, blit_list, ()) - self.assertRaises(TypeError, dst.fblits, blit_list, "str") - self.assertRaises(TypeError, dst.fblits, blit_list, "str") - - # tests for return value - self.assertEqual(dst.fblits(blit_list, 0), None) - self.assertEqual(dst.fblits(blit_list, 1), dst.blits(blit_list, doreturn=0)) - - # make sure this doesn't segfault - dst.fblits((dst, dst.get_rect().topleft) for _ in range(1)) - - t0 = time() - results = blits(blit_list) - t1 = time() - if PRINT_TIMING: - print(f"python blits: {t1 - t0}") - - dst.fill((230, 230, 230)) - t0 = time() - dst.fblits(blit_list, 0) - t1 = time() - if PRINT_TIMING: - print(f"Surface.fblits :{t1 - t0}") - - # check if we blit all the different colors in the correct spots. - for i in range(NUM_SURFS): + results = self.dst.blits(self.blit_list) + for i in range(self.NUM_SURFS): color = (i * 1, i * 1, i * 1) - self.assertEqual(dst.get_at((i * 10, 0)), color) - self.assertEqual(dst.get_at(((i * 10) + 5, 5)), color) + self.assertEqual(self.dst.get_at((i * 10, 0)), color) + self.assertEqual(self.dst.get_at(((i * 10) + 5, 5)), color) - t0 = time() - result = dst.fblits(blit_list) - t1 = time() - if PRINT_TIMING: - print(f"Surface.fblits: {t1 - t0}") - self.assertEqual(result, None) + self.assertEqual(len(results), self.NUM_SURFS) - t0 = time() - dst.fblits(((surf, dest) for surf, dest in blit_list)) - t1 = time() - if PRINT_TIMING: - print(f"Surface.fblits generator: {t1 - t0}") + def test_blits_doreturn(self): + """Tests that when doreturn=0, it returns None""" - def test_fblits_not_sequence(self): - dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises(ValueError, dst.fblits, None) - - def test_fblits_wrong_length(self): - dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises( - ValueError, dst.fblits, [pygame.Surface((10, 10), SRCALPHA, 32)] - ) - - def test_fblits_bad_surf_args(self): - dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises(TypeError, dst.fblits, [(None, None)]) - - def test_fblits_bad_dest(self): - dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises( - TypeError, dst.fblits, [(pygame.Surface((10, 10), SRCALPHA, 32), None)] - ) - - def test_fblits_generator_exception(self): - dst = pygame.Surface((100, 10), SRCALPHA, 32) - exc_type = Exception - - def generate_exception(): - yield pygame.Surface((10, 10)), (0, 0) - raise exc_type - - self.assertRaises(exc_type, dst.fblits, generate_exception()) + results = self.dst.blits(self.blit_list, doreturn=0) + self.assertEqual(results, None) def test_blits_not_sequence(self): + """Tests that calling blits with an invalid non-sequence None argument + raises a ValueError.""" + dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises(ValueError, dst.blits, None) + with self.assertRaises(ValueError): + dst.blits(None) def test_blits_wrong_length(self): + """Tests that calling blits with an invalid sequence containing a single surface + (without a destination) raises a ValueError.""" + dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises( - ValueError, dst.blits, [pygame.Surface((10, 10), SRCALPHA, 32)] - ) + with self.assertRaises(ValueError): + dst.blits([pygame.Surface((10, 10), SRCALPHA, 32)]) def test_blits_bad_surf_args(self): + """Tests that calling blits with a sequence containing an invalid tuple of + None arguments raises a TypeError.""" + dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises(TypeError, dst.blits, [(None, None)]) + with self.assertRaises(TypeError): + dst.blits([(None, None)]) def test_blits_bad_dest(self): + """Tests that calling blits with a sequence containing an invalid tuple with a + destination of None raises a TypeError.""" + dst = pygame.Surface((100, 10), SRCALPHA, 32) - self.assertRaises( - TypeError, dst.blits, [(pygame.Surface((10, 10), SRCALPHA, 32), None)] - ) + with self.assertRaises(TypeError): + dst.blits([(pygame.Surface((10, 10), SRCALPHA, 32), None)]) if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/bufferproxy_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/bufferproxy_test.py index 01ed49d..1282e35 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/bufferproxy_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/bufferproxy_test.py @@ -1,12 +1,13 @@ -import ctypes -import gc import re -import unittest import weakref +import gc +import ctypes +import unittest import pygame from pygame.bufferproxy import BufferProxy + try: BufferError except NameError: @@ -254,6 +255,7 @@ class BufferProxyTest(unittest.TestCase): self.assertEqual(r[:2], "*<") self.assertEqual(r[-2:], ">*") + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def NEWBUF_test_newbuf(self): from ctypes import string_at @@ -307,7 +309,7 @@ class BufferProxyTest(unittest.TestCase): "shape": (10,), "strides": (1,), "data": (9, True), - } # 9? Will not read the data anyway. + } # 9? Will not reading the data anyway. b = BufferProxy(d) imp = Importer(b, buftools.PyBUF_SIMPLE) self.assertTrue(imp.obj is b) @@ -331,7 +333,7 @@ class BufferProxyTest(unittest.TestCase): self.OLDBUF_test_oldbuf_arg() def OLDBUF_test_oldbuf_arg(self): - from pygame.bufferproxy import get_read_buffer, get_segcount, get_write_buffer + from pygame.bufferproxy import get_segcount, get_read_buffer, get_write_buffer content = b"\x01\x00\x00\x02" * 12 memory = ctypes.create_string_buffer(content) @@ -457,7 +459,7 @@ class BufferProxyLegacyTest(unittest.TestCase): # at the specified offset within the BufferProxy. # If the length of the passed buffer exceeds the length of the # BufferProxy (reduced by the offset), an IndexError will be raised. - from ctypes import addressof, c_byte, memset, sizeof, string_at + from ctypes import c_byte, sizeof, addressof, string_at, memset nullbyte = b"\x00" Buf = c_byte * 10 diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/camera_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/camera_test.py index 79cf0f9..c15d4f0 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/camera_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/camera_test.py @@ -1,5 +1,35 @@ import unittest +import os +import pygame +import pygame.camera class CameraModuleTest(unittest.TestCase): - pass + def setUp(self): + pygame.init() + + pygame.camera.init() + + @unittest.skipIf( + os.environ.get("SDL_VIDEODRIVER") in ["dummy", "android"], + "requires the SDL_VIDEODRIVER to be non dummy", + ) + def test_camera(self): + cameras = pygame.camera.list_cameras() + + if len(cameras) == 0: + self.skipTest("No cameras found") + + cam = pygame.camera.Camera(cameras[0], (640, 480)) + cam.start() + image = cam.get_image() + self.assertIsNotNone(image, "Could not capture image") + cam.stop() + + def tearDown(self): + pygame.camera.quit() + pygame.quit() + + +if __name__ == "__main__": + unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/color_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/color_test.py index 186b6c1..eee5c11 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/color_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/color_test.py @@ -500,7 +500,8 @@ class ColorTypeTest(unittest.TestCase): def test_repr(self): c = pygame.Color(68, 38, 26, 69) - self.assertEqual(repr(c), "Color(68, 38, 26, 69)") + t = "(68, 38, 26, 69)" + self.assertEqual(repr(c), t) def test_add(self): c1 = pygame.Color(0) @@ -527,7 +528,7 @@ class ColorTypeTest(unittest.TestCase): self.assertEqual(c3.b, 164) self.assertEqual(c3.a, 255) - # pygame-ce issue #301: Is type checking done for Python 3.x? + # Issue #286: Is type checking done for Python 3.x? self.assertRaises(TypeError, operator.add, c1, None) self.assertRaises(TypeError, operator.add, None, c1) @@ -556,7 +557,7 @@ class ColorTypeTest(unittest.TestCase): self.assertEqual(c3.b, 91) self.assertEqual(c3.a, 0) - # pygame-ce issue #301: Is type checking done for Python 3.x? + # Issue #286: Is type checking done for Python 3.x? self.assertRaises(TypeError, operator.sub, c1, None) self.assertRaises(TypeError, operator.sub, None, c1) @@ -585,7 +586,7 @@ class ColorTypeTest(unittest.TestCase): self.assertEqual(c3.b, 9) self.assertEqual(c3.a, 255) - # pygame-ce issue #301: Is type checking done for Python 3.x? + # Issue #286: Is type checking done for Python 3.x? self.assertRaises(TypeError, operator.mul, c1, None) self.assertRaises(TypeError, operator.mul, None, c1) @@ -614,7 +615,7 @@ class ColorTypeTest(unittest.TestCase): self.assertEqual(c3.b, 2) self.assertEqual(c3.a, 0) - # pygame-ce issue #301: Is type checking done for Python 3.x? + # Issue #286: Is type checking done for Python 3.x? self.assertRaises(TypeError, operator.floordiv, c1, None) self.assertRaises(TypeError, operator.floordiv, None, c1) @@ -646,7 +647,7 @@ class ColorTypeTest(unittest.TestCase): self.assertEqual(c3.b, 7) self.assertEqual(c3.a, 15) - # pygame-ce issue #301: Is type checking done for Python 3.x? + # Issue #286: Is type checking done for Python 3.x? self.assertRaises(TypeError, operator.mod, c1, None) self.assertRaises(TypeError, operator.mod, None, c1) @@ -773,135 +774,6 @@ class ColorTypeTest(unittest.TestCase): self.assertEqual(c.a, 146) self.assertEqual(int(c), int(0x33727592)) - def test_bytes(self): - c = pygame.Color(0x00012345) - self.assertEqual(c.r, 0x00) - self.assertEqual(c.g, 0x01) - self.assertEqual(c.b, 0x23) - self.assertEqual(c.a, 0x45) - - as_bytes = bytes(c) - self.assertEqual(as_bytes, bytes([0x00, 0x01, 0x23, 0x45])) - self.assertEqual(len(as_bytes), 4) - - def test_from_cmy(self): - cmy = pygame.Color.from_cmy(0.5, 0.5, 0.5) - cmy_tuple = pygame.Color.from_cmy((0.5, 0.5, 0.5)) - cmy_instance = pygame.Color(0, 0, 0, 0).from_cmy(0.5, 0.5, 0.5) - - expected_cmy = (127, 127, 127) - - self.assertEqual(expected_cmy, cmy) - self.assertEqual(expected_cmy, cmy_tuple) - self.assertEqual(expected_cmy, cmy_instance) - - self.assertRaises( - ValueError, lambda: pygame.Color.from_cmy(0.5, 0.5, 0.5, "lel", "foo") - ) - self.assertRaises( - ValueError, lambda: pygame.Color.from_cmy((0.5, 0.5, 0.5, 0.5)) - ) - - def test_from_hsva(self): - hsva = pygame.Color.from_hsva(0, 100, 100, 100) - hsva_tuple = pygame.Color.from_hsva((0, 100, 100, 100)) - hsva_instance = pygame.Color(0, 0, 0, 0).from_hsva(0, 100, 100, 100) - - expected_hsva = (255, 0, 0) - - self.assertEqual(expected_hsva, hsva) - self.assertEqual(expected_hsva, hsva_tuple) - self.assertEqual(expected_hsva, hsva_instance) - - self.assertRaises( - ValueError, lambda: pygame.Color.from_hsva(0, 100, 100, 100, "lel", "foo") - ) - self.assertRaises( - ValueError, lambda: pygame.Color.from_hsva((0, 100, 100, 100, "lel")) - ) - - def test_from_hsla(self): - hsla = pygame.Color.from_hsla(0, 100, 100, 100) - hsla_tuple = pygame.Color.from_hsla((0, 100, 100, 100)) - hsla_instance = pygame.Color(0, 0, 0, 0).from_hsla(0, 100, 100, 100) - - expected_hsla = (255, 255, 255) - - self.assertEqual(expected_hsla, hsla) - self.assertEqual(expected_hsla, hsla_tuple) - self.assertEqual(expected_hsla, hsla_instance) - - self.assertRaises( - ValueError, lambda: pygame.Color.from_hsla(0, 100, 100, 100, "lel") - ) - self.assertRaises( - ValueError, lambda: pygame.Color.from_hsla((0, 100, 100, 100, "lel", "foo")) - ) - - def test_from_i1i2i3(self): - i1i2i3 = pygame.Color.from_i1i2i3(0, 0, 0) - i1i2i3_tuple = pygame.Color.from_i1i2i3((0, 0, 0)) - i1i2i3_instance = pygame.Color(0, 0, 0, 0).from_i1i2i3(0, 0, 0) - - expected_i1i2i3 = (0, 0, 0) - - self.assertEqual(expected_i1i2i3, i1i2i3) - self.assertEqual(expected_i1i2i3, i1i2i3_tuple) - self.assertEqual(expected_i1i2i3, i1i2i3_instance) - - self.assertRaises( - ValueError, lambda: pygame.Color.from_i1i2i3(0, 0, 0, "lel", "foo") - ) - self.assertRaises(ValueError, lambda: pygame.Color.from_i1i2i3((0, 0, 0, 0))) - - def test_from_normalized(self): - normal = pygame.Color.from_normalized(1, 1, 1, 1) - normal_tuple = pygame.Color.from_normalized((1, 1, 1, 1)) - normal_instance = pygame.Color(0, 0, 0, 0).from_normalized(1, 1, 1, 1) - - expected_normal = (255, 255, 255, 255) - - self.assertEqual(expected_normal, normal) - self.assertEqual(expected_normal, normal_tuple) - self.assertEqual(expected_normal, normal_instance) - - self.assertRaises( - ValueError, lambda: pygame.Color.from_normalized(1, 1, 1, 1, "lel") - ) - - def test_from_hex(self): - color1 = pygame.Color.from_hex("#FFFFFF") # White - color2 = pygame.Color.from_hex("#000000") # Black - color3 = pygame.Color.from_hex("#AAFF00") # Random - color4 = pygame.Color.from_hex("#FF000080") # Red (50% opacity) - - color_instance1 = pygame.Color(0, 0, 0, 0).from_hex("#FFFFFF") - color_instance2 = pygame.Color(63, 12, 83).from_hex("#000000") - color_instance3 = pygame.Color(52, 31, 8, 255).from_hex("#AAFF00") - color_instance4 = pygame.Color("#E4A010").from_hex("#FF000080") - - expected_color1 = (255, 255, 255, 255) - expected_color2 = (0, 0, 0, 255) - expected_color3 = (170, 255, 0, 255) - expected_color4 = (255, 0, 0, 128) - - self.assertEqual(color1, expected_color1) - self.assertEqual(color2, expected_color2) - self.assertEqual(color3, expected_color3) - self.assertEqual(color4, expected_color4) - - self.assertEqual(color_instance1, expected_color1) - self.assertEqual(color_instance2, expected_color2) - self.assertEqual(color_instance3, expected_color3) - self.assertEqual(color_instance4, expected_color4) - - self.assertRaises(ValueError, lambda: pygame.Color.from_hex("#FFFFFG")) - self.assertRaises(ValueError, lambda: pygame.Color.from_hex("#FFFFFFF")) - self.assertRaises(ValueError, lambda: pygame.Color.from_hex("not-a-color")) - self.assertRaises( - TypeError, lambda: pygame.Color.from_hex("not-a-color", "lel") - ) - def test_normalize(self): c = pygame.Color(204, 38, 194, 55) self.assertEqual(c.r, 204) @@ -996,46 +868,7 @@ class ColorTypeTest(unittest.TestCase): self.assertTrue(-0.5 <= i2 <= 0.5) self.assertTrue(-0.5 <= i3 <= 0.5) - def test_normalize__all_elements_within_limits(self): - for c in rgba_combos_Color_generator(): - r, g, b, a = c.normalized - self.assertTrue(0 <= r <= 1) - self.assertTrue(0 <= g <= 1) - self.assertTrue(0 <= b <= 1) - self.assertTrue(0 <= a <= 1) - - def test_hex_property(self): - color = pygame.Color(255, 0, 255, 0) - hex = color.hex - self.assertEqual(hex, "#ff00ff00") - - for c in rgba_combos_Color_generator(): - col_hex = c.hex - self.assertIsInstance(col_hex, str) - self.assertEqual(len(col_hex), 9) - self.assertEqual(col_hex[0], "#") - for char in col_hex: - self.assertIn(char, "#0123456789abcdef") - self.assertEqual(c, pygame.Color(col_hex)) - - with self.assertRaises(TypeError): - color.hex = 0xFFFFFFFF - with self.assertRaises(AttributeError): - del color.hex - - for value in ["FFFFFFFF", "#FFzzFF00", "0x FFFFFF", "#FF"]: - for v in [value, value.lower()]: - with self.assertRaises(ValueError): - color.hex = v - - for value in ["#FFFFFFFF", "#FFFFFF", "0xFFFFFFFF", "0xFFFFFF"]: - for v in [value, value.lower()]: - color.hex = v - self.assertEqual( - (color.r, color.g, color.b, color.a), (255, 255, 255, 255) - ) - - def test_issue_284(self): + def test_issue_269(self): """PyColor OverflowError on HSVA with hue value of 360 >>> c = pygame.Color(0) @@ -1089,12 +922,6 @@ class ColorTypeTest(unittest.TestCase): def test_i1i2i3__sanity_testing_converted_should_not_raise(self): self.colorspaces_converted_should_not_raise("i1i2i3") - def test_normalized__sanity_testing_converted_should_not_raise(self): - self.colorspaces_converted_should_not_raise("normalized") - - def test_hex__sanity_testing_converted_should_not_raise(self): - self.colorspaces_converted_should_not_raise("hex") - ################################################################################ def colorspaces_converted_should_equate_bar_rounding(self, prop): @@ -1127,20 +954,6 @@ class ColorTypeTest(unittest.TestCase): def test_i1i2i3__sanity_testing_converted_should_equate_bar_rounding(self): self.colorspaces_converted_should_equate_bar_rounding("i1i2i3") - def test_normalized__sanity_testing_converted_should_equate_bar_rounding(self): - self.colorspaces_converted_should_equate_bar_rounding("normalized") - - def test_hex__sanity_testing_converted_should_equate_bar_rounding(self): - self.colorspaces_converted_should_equate_bar_rounding("hex") - - def test_colorspaces_deprecated_large_sequence(self): - c = pygame.Color("black") - for space in ("hsla", "hsva", "i1i2i3", "cmy", "normalized"): - with self.assertRaises(ValueError): - setattr( - c, space, (0, 0, 0, 0, "HAHAHAHAHAHA, don't ignore 5th member :)") - ) - ################################################################################ def test_correct_gamma__verified_against_python_implementation(self): @@ -1178,9 +991,8 @@ class ColorTypeTest(unittest.TestCase): @unittest.skipIf(IS_PYPY, "PyPy has no ctypes") def test_arraystruct(self): - import ctypes as ct - import pygame.tests.test_utils.arrinter as ai + import ctypes as ct c_byte_p = ct.POINTER(ct.c_byte) c = pygame.Color(5, 7, 13, 23) @@ -1199,10 +1011,10 @@ class ColorTypeTest(unittest.TestCase): for j in range(i): self.assertEqual(data[j], c[j]) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_newbuf(self): - from ctypes import POINTER, c_uint8, cast - from pygame.tests.test_utils import buftools + from ctypes import cast, POINTER, c_uint8 class ColorImporter(buftools.Importer): def __init__(self, color, flags): @@ -1360,51 +1172,6 @@ class ColorTypeTest(unittest.TestCase): self.assertRaises(ValueError, lambda: color0.lerp((0, 0, 0, 256), 0.5)) self.assertRaises(TypeError, lambda: color0.lerp(0.2, 0.5)) - def test_swizzle_get(self): - c = pygame.color.Color(10, 20, 30, 40) - - self.assertEqual(c.rg, (10, 20)) - self.assertEqual(c.rb, (10, 30)) - self.assertEqual(c.rr, (10, 10)) - - self.assertEqual(c.rgb, (10, 20, 30)) - self.assertEqual(c.bgr, (30, 20, 10)) - self.assertEqual(c.rrr, (10, 10, 10)) - self.assertEqual(c.rrg, (10, 10, 20)) - self.assertEqual(c.rrb, (10, 10, 30)) - self.assertEqual(c.ggg, (20, 20, 20)) - self.assertEqual(c.ggb, (20, 20, 30)) - self.assertEqual(c.ggr, (20, 20, 10)) - self.assertEqual(c.bbb, (30, 30, 30)) - self.assertEqual(c.bbg, (30, 30, 20)) - self.assertEqual(c.bbr, (30, 30, 10)) - - c.rgba = c.abgr - self.assertEqual(c.rgba, (40, 30, 20, 10)) - c.rgba = c.rgga - self.assertEqual(c.rgba, (40, 30, 30, 10)) - c.rg = c.gg - self.assertEqual(c.rgba, (30, 30, 30, 10)) - - with self.assertRaises(AttributeError): - c.rr = (10, 10) - c.bb = (10, 10) - c.gg = (10, 10) - c.aa = (10, 10) - c.aaa = (10, 10, 100) - c.rgb = (256, 256, 256) - - def test_swizzle_return_types(self): - c = pygame.color.Color(10, 20, 30, 40) - - self.assertEqual(type(c.rgb), tuple) - self.assertEqual(type(c.rgba), pygame.color.Color) - self.assertEqual(type(c.bgra), pygame.color.Color) - self.assertEqual(type(c.bg), tuple) - self.assertEqual(type(c.gr), tuple) - self.assertEqual(type(c.rr), tuple) - self.assertEqual(type(c.rrggbb), tuple) - def test_premul_alpha(self): # setup Color = pygame.color.Color @@ -1421,7 +1188,7 @@ class ColorTypeTest(unittest.TestCase): # type checking self.assertTrue(isinstance(color0.premul_alpha(), Color)) - # handcrafted value testing + # hand crafted value testing self.assertEqual(alpha0.premul_alpha(), Color(0, 0, 0, 0)) self.assertEqual(alpha49.premul_alpha(), Color(49, 0, 0, 49)) self.assertEqual(alpha67.premul_alpha(), Color(0, 67, 0, 67)) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/constants_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/constants_test.py index 9ee72bd..a028f98 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/constants_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/constants_test.py @@ -1,7 +1,7 @@ import unittest - import pygame.constants + # K_* and KSCAN_* common names. K_AND_KSCAN_COMMON_NAMES = ( "UNKNOWN", @@ -138,7 +138,7 @@ K_AND_KSCAN_COMMON_OVERLAPS = ( def create_overlap_set(constant_names): """Helper function to find overlapping constant values/names. - Returns a set of frozensets: + Returns a set of fronzensets: set(frozenset(names of overlapping constants), ...) """ # Create an overlap dict. diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/controller_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/controller_test.py index 4175d63..f05c00c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/controller_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/controller_test.py @@ -1,5 +1,4 @@ import unittest - import pygame import pygame._sdl2.controller as controller from pygame.tests.test_utils import prompt, question @@ -34,6 +33,15 @@ class ControllerModuleTest(unittest.TestCase): def test_get_init(self): self.assertTrue(controller.get_init()) + def test_get_eventstate(self): + controller.set_eventstate(True) + self.assertTrue(controller.get_eventstate()) + + controller.set_eventstate(False) + self.assertFalse(controller.get_eventstate()) + + controller.set_eventstate(True) + def test_get_count(self): self.assertGreaterEqual(controller.get_count(), 0) @@ -44,12 +52,15 @@ class ControllerModuleTest(unittest.TestCase): self.assertIsInstance(c, controller.Controller) c.quit() else: - with self.assertRaises(pygame.error): + with self.assertRaises(pygame._sdl2.sdl2.error): c = controller.Controller(i) with self.assertRaises(TypeError): controller.is_controller("Test") + def test_name_forindex(self): + self.assertIsNone(controller.name_forindex(-1)) + class ControllerTypeTest(unittest.TestCase): def setUp(self): @@ -64,19 +75,22 @@ class ControllerTypeTest(unittest.TestCase): return controller.Controller(i) def test_construction(self): - if c := self._get_first_controller(): + c = self._get_first_controller() + if c: self.assertIsInstance(c, controller.Controller) else: self.skipTest("No controller connected") def test__auto_init(self): - if c := self._get_first_controller(): + c = self._get_first_controller() + if c: self.assertTrue(c.get_init()) else: self.skipTest("No controller connected") def test_get_init(self): - if c := self._get_first_controller(): + c = self._get_first_controller() + if c: self.assertTrue(c.get_init()) c.quit() self.assertFalse(c.get_init()) @@ -95,14 +109,16 @@ class ControllerTypeTest(unittest.TestCase): self.assertIsInstance(c, controller.Controller) def test_as_joystick(self): - if c := self._get_first_controller(): + c = self._get_first_controller() + if c: joy = c.as_joystick() self.assertIsInstance(joy, type(pygame.joystick.Joystick(0))) else: self.skipTest("No controller connected") def test_get_mapping(self): - if c := self._get_first_controller(): + c = self._get_first_controller() + if c: mapping = c.get_mapping() self.assertIsInstance(mapping, dict) self.assertIsNotNone(mapping["a"]) @@ -110,7 +126,8 @@ class ControllerTypeTest(unittest.TestCase): self.skipTest("No controller connected") def test_set_mapping(self): - if c := self._get_first_controller(): + c = self._get_first_controller() + if c: mapping = c.get_mapping() mapping["a"] = "b3" mapping["y"] = "b0" @@ -162,6 +179,75 @@ class ControllerInteractiveTest(unittest.TestCase): self.assertTrue(ans) + def test_set_eventstate_on_interactive(self): + c = self._get_first_controller() + if not c: + self.skipTest("No controller connected") + + pygame.display.init() + pygame.font.init() + + screen = pygame.display.set_mode((400, 400)) + font = pygame.font.Font(None, 20) + running = True + + screen.fill((255, 255, 255)) + screen.blit( + font.render("Press button 'x' (on ps4) or 'a' (on xbox).", True, (0, 0, 0)), + (0, 0), + ) + pygame.display.update() + + controller.set_eventstate(True) + + while running: + for event in pygame.event.get(): + if event.type == pygame.QUIT: + running = False + + if event.type == pygame.CONTROLLERBUTTONDOWN: + running = False + + pygame.display.quit() + pygame.font.quit() + + def test_set_eventstate_off_interactive(self): + c = self._get_first_controller() + if not c: + self.skipTest("No controller connected") + + pygame.display.init() + pygame.font.init() + + screen = pygame.display.set_mode((400, 400)) + font = pygame.font.Font(None, 20) + running = True + + screen.fill((255, 255, 255)) + screen.blit( + font.render("Press button 'x' (on ps4) or 'a' (on xbox).", True, (0, 0, 0)), + (0, 0), + ) + pygame.display.update() + + controller.set_eventstate(False) + + while running: + for event in pygame.event.get(pygame.QUIT): + if event: + running = False + + if c.get_button(pygame.CONTROLLER_BUTTON_A): + if pygame.event.peek(pygame.CONTROLLERBUTTONDOWN): + pygame.display.quit() + pygame.font.quit() + self.fail() + else: + running = False + + pygame.display.quit() + pygame.font.quit() + def test_get_button_interactive(self): c = self._get_first_controller() if not c: diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/ctest_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/ctest_test.py deleted file mode 100644 index 73f30fd..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/ctest_test.py +++ /dev/null @@ -1,17 +0,0 @@ -import unittest - -base_ctest = None -try: - import pygame.base_ctest as base_ctest -except ModuleNotFoundError: - pass - - -class Ctest(unittest.TestCase): - @unittest.skipIf(base_ctest is None, "base_ctest not built") - def test_run_base_ctests(self): - self.assertEqual(base_ctest.run_tests(), 0) - - -if __name__ == "__main__": - unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/cursors_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/cursors_test.py index abc7f44..8132c51 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/cursors_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/cursors_test.py @@ -1,7 +1,6 @@ import unittest - -import pygame from pygame.tests.test_utils import fixture_path +import pygame class CursorsModuleTest(unittest.TestCase): @@ -53,154 +52,151 @@ class CursorsModuleTest(unittest.TestCase): # Test that checks whether the byte data from compile function is equal to actual byte data actual_byte_data = ( - ( - 192, - 0, - 0, - 224, - 0, - 0, - 240, - 0, - 0, - 216, - 0, - 0, - 204, - 0, - 0, - 198, - 0, - 0, - 195, - 0, - 0, - 193, - 128, - 0, - 192, - 192, - 0, - 192, - 96, - 0, - 192, - 48, - 0, - 192, - 56, - 0, - 192, - 248, - 0, - 220, - 192, - 0, - 246, - 96, - 0, - 198, - 96, - 0, - 6, - 96, - 0, - 3, - 48, - 0, - 3, - 48, - 0, - 1, - 224, - 0, - 1, - 128, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - ), - ( - 192, - 0, - 0, - 224, - 0, - 0, - 240, - 0, - 0, - 248, - 0, - 0, - 252, - 0, - 0, - 254, - 0, - 0, - 255, - 0, - 0, - 255, - 128, - 0, - 255, - 192, - 0, - 255, - 224, - 0, - 255, - 240, - 0, - 255, - 248, - 0, - 255, - 248, - 0, - 255, - 192, - 0, - 247, - 224, - 0, - 199, - 224, - 0, - 7, - 224, - 0, - 3, - 240, - 0, - 3, - 240, - 0, - 1, - 224, - 0, - 1, - 128, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - 0, - ), + 192, + 0, + 0, + 224, + 0, + 0, + 240, + 0, + 0, + 216, + 0, + 0, + 204, + 0, + 0, + 198, + 0, + 0, + 195, + 0, + 0, + 193, + 128, + 0, + 192, + 192, + 0, + 192, + 96, + 0, + 192, + 48, + 0, + 192, + 56, + 0, + 192, + 248, + 0, + 220, + 192, + 0, + 246, + 96, + 0, + 198, + 96, + 0, + 6, + 96, + 0, + 3, + 48, + 0, + 3, + 48, + 0, + 1, + 224, + 0, + 1, + 128, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + ), ( + 192, + 0, + 0, + 224, + 0, + 0, + 240, + 0, + 0, + 248, + 0, + 0, + 252, + 0, + 0, + 254, + 0, + 0, + 255, + 0, + 0, + 255, + 128, + 0, + 255, + 192, + 0, + 255, + 224, + 0, + 255, + 240, + 0, + 255, + 248, + 0, + 255, + 248, + 0, + 255, + 192, + 0, + 247, + 224, + 0, + 199, + 224, + 0, + 7, + 224, + 0, + 3, + 240, + 0, + 3, + 240, + 0, + 1, + 224, + 0, + 1, + 128, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, ) cursor = pygame.cursors.compile(pygame.cursors.thickarrow_strings) @@ -222,7 +218,7 @@ class CursorsModuleTest(unittest.TestCase): # __doc__ (as of 2008-06-25) for pygame.cursors.load_xbm: # pygame.cursors.load_xbm(cursorfile, maskfile) -> cursor_args - # reads a pair of XBM files into set_cursor arguments. + # reads a pair of XBM files into set_cursor arguments # # Arguments can either be filenames or filelike objects # with the readlines method. Not largely tested, but diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/debug_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/debug_test.py deleted file mode 100644 index 622ff45..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/debug_test.py +++ /dev/null @@ -1,24 +0,0 @@ -import io -import unittest -import unittest.mock - -import pygame - - -class DebugTest(unittest.TestCase): - @unittest.mock.patch("sys.stdout", new_callable=io.StringIO) - def assert_stdout(self, expected_output, mock_stdout): - pygame.print_debug_info() - self.assertEqual(mock_stdout.getvalue(), expected_output) - - def test_print_debug(self): - import os - - pygame.print_debug_info("temp_file.txt") - with open("temp_file.txt", "r") as temp_file: - text = temp_file.read() - - self.assertNotEqual(text, "") - self.assert_stdout(text + "\n") - - os.remove("temp_file.txt") diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/display_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/display_test.py index 4836f25..eec521f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/display_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/display_test.py @@ -1,16 +1,13 @@ +import unittest import os import sys import time -import unittest -import pygame -import pygame.transform -from pygame import display +import pygame, pygame.transform + from pygame.tests.test_utils import question -pygame.display.init() -is_wayland = pygame.display.get_driver() == "wayland" -pygame.display.quit() +from pygame import display class DisplayModuleTest(unittest.TestCase): @@ -72,10 +69,9 @@ class DisplayModuleTest(unittest.TestCase): self.assertEqual(pygame.display.get_active(), False) @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires the SDL_VIDEODRIVER to be a non-null value", + os.environ.get("SDL_VIDEODRIVER") == "dummy", + "requires the SDL_VIDEODRIVER to be a non dummy value", ) - @unittest.skipIf(is_wayland, "broken on wayland") def test_get_active_iconify(self): """Test the get_active function after an iconify""" @@ -105,6 +101,14 @@ class DisplayModuleTest(unittest.TestCase): self.assertEqual(display.get_caption()[0], TEST_CAPTION) self.assertEqual(display.get_caption()[1], TEST_CAPTION) + def test_set_caption_kwargs(self): + TEST_CAPTION = "test" + screen = display.set_mode((100, 100)) + + self.assertIsNone(display.set_caption(title=TEST_CAPTION)) + self.assertEqual(display.get_caption()[0], TEST_CAPTION) + self.assertEqual(display.get_caption()[1], TEST_CAPTION) + def test_caption_unicode(self): TEST_CAPTION = "台" display.set_caption(TEST_CAPTION) @@ -119,7 +123,7 @@ class DisplayModuleTest(unittest.TestCase): "dga", "directx", "directfb", - pygame.NULL_VIDEODRIVER, + "dummy", "emscripten", "fbcon", "ggi", @@ -154,31 +158,22 @@ class DisplayModuleTest(unittest.TestCase): # display.init() already called in setUp() self.assertTrue(display.get_init()) + # This test can be uncommented when issues #991 and #993 are resolved. + @unittest.skipIf(True, "SDL2 issues") def test_get_surface(self): - """Ensures get_surface gets the current display surface. - We can't guarantee small screen sizes get respected, so the - sizes of the surfaces returned from set_mode must be compared - to the size of the surface from get_surface. - """ + """Ensures get_surface gets the current display surface.""" lengths = (1, 5, 100) - correct_depth = pygame.display.Info().bitsize for expected_size in ((w, h) for w in lengths for h in lengths): - for set_depth in (8, 16, 24, 32): - if set_depth == correct_depth: - expected_surface = display.set_mode(expected_size, 0, set_depth) - else: - with self.assertWarns(DeprecationWarning): - expected_surface = pygame.display.set_mode( - expected_size, 0, set_depth - ) + for expected_depth in (8, 16, 24, 32): + expected_surface = display.set_mode(expected_size, 0, expected_depth) surface = pygame.display.get_surface() self.assertEqual(surface, expected_surface) self.assertIsInstance(surface, pygame.Surface) - self.assertEqual(surface.get_size(), expected_surface.get_size()) - self.assertEqual(surface.get_bitsize(), correct_depth) + self.assertEqual(surface.get_size(), expected_size) + self.assertEqual(surface.get_bitsize(), expected_depth) def test_get_surface__mode_not_set(self): """Ensures get_surface handles the display mode not being set.""" @@ -224,9 +219,9 @@ class DisplayModuleTest(unittest.TestCase): @unittest.skipIf( ( "skipping for all because some failures on rasppi and maybe other platforms" - or os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER + or os.environ.get("SDL_VIDEODRIVER") == "dummy" ), - "OpenGL requires a non-null SDL_VIDEODRIVER", + 'OpenGL requires a non-"dummy" SDL_VIDEODRIVER', ) def test_gl_get_attribute(self): screen = display.set_mode((0, 0), pygame.OPENGL) @@ -348,9 +343,159 @@ class DisplayModuleTest(unittest.TestCase): @unittest.skipIf( ( "skipping for all because some failures on rasppi and maybe other platforms" - or os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER + or os.environ.get("SDL_VIDEODRIVER") == "dummy" ), - "OpenGL requires a non-null SDL_VIDEODRIVER", + 'OpenGL requires a non-"dummy" SDL_VIDEODRIVER', + ) + def test_gl_get_attribute_kwargs(self): + screen = display.set_mode((0, 0), pygame.OPENGL) + + # We create a list where we store the original values of the + # flags before setting them with a different value. + original_values = [] + + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ALPHA_SIZE) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_DEPTH_SIZE) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_STENCIL_SIZE) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_RED_SIZE) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_GREEN_SIZE) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_BLUE_SIZE) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_ALPHA_SIZE) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_MULTISAMPLEBUFFERS) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_MULTISAMPLESAMPLES) + ) + original_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_STEREO)) + + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCELERATED_VISUAL) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_MAJOR_VERSION) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_MINOR_VERSION) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_FLAGS) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_PROFILE_MASK) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_SHARE_WITH_CURRENT_CONTEXT) + ) + original_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_FRAMEBUFFER_SRGB_CAPABLE) + ) + + # Setting the flags with values supposedly different from the original values + + # assign SDL1-supported values with gl_set_attribute + pygame.display.gl_set_attribute(flag=pygame.GL_ALPHA_SIZE, value=8) + pygame.display.gl_set_attribute(flag=pygame.GL_DEPTH_SIZE, value=24) + pygame.display.gl_set_attribute(flag=pygame.GL_STENCIL_SIZE, value=8) + pygame.display.gl_set_attribute(flag=pygame.GL_ACCUM_RED_SIZE, value=16) + pygame.display.gl_set_attribute(flag=pygame.GL_ACCUM_GREEN_SIZE, value=16) + pygame.display.gl_set_attribute(flag=pygame.GL_ACCUM_BLUE_SIZE, value=16) + pygame.display.gl_set_attribute(flag=pygame.GL_ACCUM_ALPHA_SIZE, value=16) + pygame.display.gl_set_attribute(flag=pygame.GL_MULTISAMPLEBUFFERS, value=1) + pygame.display.gl_set_attribute(flag=pygame.GL_MULTISAMPLESAMPLES, value=1) + pygame.display.gl_set_attribute(flag=pygame.GL_STEREO, value=0) + pygame.display.gl_set_attribute(flag=pygame.GL_ACCELERATED_VISUAL, value=0) + pygame.display.gl_set_attribute(flag=pygame.GL_CONTEXT_MAJOR_VERSION, value=1) + pygame.display.gl_set_attribute(flag=pygame.GL_CONTEXT_MINOR_VERSION, value=1) + pygame.display.gl_set_attribute(flag=pygame.GL_CONTEXT_FLAGS, value=0) + pygame.display.gl_set_attribute(flag=pygame.GL_CONTEXT_PROFILE_MASK, value=0) + pygame.display.gl_set_attribute( + flag=pygame.GL_SHARE_WITH_CURRENT_CONTEXT, value=0 + ) + pygame.display.gl_set_attribute( + flag=pygame.GL_FRAMEBUFFER_SRGB_CAPABLE, value=0 + ) + + # We create a list where we store the values that we set each flag to + set_values = [8, 24, 8, 16, 16, 16, 16, 1, 1, 0, 0, 1, 1, 0, 0, 0, 1, 0] + + # We create a list where we store the values after getting them + get_values = [] + + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_ALPHA_SIZE)) + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_DEPTH_SIZE)) + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_STENCIL_SIZE)) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_RED_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_GREEN_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_BLUE_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_ALPHA_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_MULTISAMPLEBUFFERS) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_MULTISAMPLESAMPLES) + ) + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_STEREO)) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCELERATED_VISUAL) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_MAJOR_VERSION) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_MINOR_VERSION) + ) + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_FLAGS)) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_CONTEXT_PROFILE_MASK) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_SHARE_WITH_CURRENT_CONTEXT) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_FRAMEBUFFER_SRGB_CAPABLE) + ) + + # We check to see if the values that we get correspond to the values that we set + # them to or to the original values. + for i in range(len(original_values)): + self.assertTrue( + (get_values[i] == original_values[i]) + or (get_values[i] == set_values[i]) + ) + + # test using non-flag argument + with self.assertRaises(TypeError): + pygame.display.gl_get_attribute("DUMMY") + + @unittest.skipIf( + ( + "skipping for all because some failures on rasppi and maybe other platforms" + or os.environ.get("SDL_VIDEODRIVER") == "dummy" + ), + 'OpenGL requires a non-"dummy" SDL_VIDEODRIVER', ) def test_gl_set_attribute(self): # __doc__ (as of 2008-08-02) for pygame.display.gl_set_attribute: @@ -413,10 +558,102 @@ class DisplayModuleTest(unittest.TestCase): pygame.display.gl_get_attribute("DUMMY") @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") in [pygame.NULL_VIDEODRIVER, "android"], + ( + "skipping for all because some failures on rasppi and maybe other platforms" + or os.environ.get("SDL_VIDEODRIVER") == "dummy" + ), + 'OpenGL requires a non-"dummy" SDL_VIDEODRIVER', + ) + def test_gl_set_attribute_kwargs(self): + # __doc__ (as of 2008-08-02) for pygame.display.gl_set_attribute: + + # pygame.display.gl_set_attribute(flag, value): return None + # request an opengl display attribute for the display mode + # + # When calling pygame.display.set_mode() with the pygame.OPENGL flag, + # Pygame automatically handles setting the OpenGL attributes like + # color and doublebuffering. OpenGL offers several other attributes + # you may want control over. Pass one of these attributes as the flag, + # and its appropriate value. This must be called before + # pygame.display.set_mode() + # + # The OPENGL flags are; + # GL_ALPHA_SIZE, GL_DEPTH_SIZE, GL_STENCIL_SIZE, GL_ACCUM_RED_SIZE, + # GL_ACCUM_GREEN_SIZE, GL_ACCUM_BLUE_SIZE, GL_ACCUM_ALPHA_SIZE, + # GL_MULTISAMPLEBUFFERS, GL_MULTISAMPLESAMPLES, GL_STEREO + + screen = display.set_mode((0, 0), pygame.OPENGL) + + # We create a list where we store the values that we set each flag to + set_values = [8, 24, 8, 16, 16, 16, 16, 1, 1, 0] + + # Setting the flags with values supposedly different from the original values + + # assign SDL1-supported values with gl_set_attribute + pygame.display.gl_set_attribute(flag=pygame.GL_ALPHA_SIZE, value=set_values[0]) + pygame.display.gl_set_attribute(flag=pygame.GL_DEPTH_SIZE, value=set_values[1]) + pygame.display.gl_set_attribute( + flag=pygame.GL_STENCIL_SIZE, value=set_values[2] + ) + pygame.display.gl_set_attribute( + flag=pygame.GL_ACCUM_RED_SIZE, value=set_values[3] + ) + pygame.display.gl_set_attribute( + flag=pygame.GL_ACCUM_GREEN_SIZE, value=set_values[4] + ) + pygame.display.gl_set_attribute( + flag=pygame.GL_ACCUM_BLUE_SIZE, value=set_values[5] + ) + pygame.display.gl_set_attribute( + flag=pygame.GL_ACCUM_ALPHA_SIZE, value=set_values[6] + ) + pygame.display.gl_set_attribute( + flag=pygame.GL_MULTISAMPLEBUFFERS, value=set_values[7] + ) + pygame.display.gl_set_attribute( + flag=pygame.GL_MULTISAMPLESAMPLES, value=set_values[8] + ) + pygame.display.gl_set_attribute(flag=pygame.GL_STEREO, value=set_values[9]) + + # We create a list where we store the values after getting them + get_values = [] + + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_ALPHA_SIZE)) + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_DEPTH_SIZE)) + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_STENCIL_SIZE)) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_RED_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_GREEN_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_BLUE_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_ACCUM_ALPHA_SIZE) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_MULTISAMPLEBUFFERS) + ) + get_values.append( + pygame.display.gl_get_attribute(flag=pygame.GL_MULTISAMPLESAMPLES) + ) + get_values.append(pygame.display.gl_get_attribute(flag=pygame.GL_STEREO)) + + # We check to see if the values that we get correspond to the values that we set + # them to or to the original values. + for i in range(len(set_values)): + self.assertTrue(get_values[i] == set_values[i]) + + # test using non-flag argument + with self.assertRaises(TypeError): + pygame.display.gl_get_attribute("DUMMY") + + @unittest.skipIf( + os.environ.get("SDL_VIDEODRIVER") in ["dummy", "android"], "iconify is only supported on some video drivers/platforms", ) - @unittest.skipIf(is_wayland, "broken on wayland") def test_iconify(self): pygame.display.set_mode((640, 480)) @@ -518,14 +755,8 @@ class DisplayModuleTest(unittest.TestCase): self.assertFalse(display.get_init()) @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "Needs a non-null videodriver", + os.environ.get("SDL_VIDEODRIVER") == "dummy", "Needs a not dummy videodriver" ) - @unittest.skipIf( - pygame.version.SDL >= (2, 32, 50), - "set_gamma is removed in SDL3, does not work in sdl2-compat either", - ) - @unittest.skipIf(is_wayland, "not supported on wayland") def test_set_gamma(self): pygame.display.set_mode((1, 1)) @@ -537,14 +768,8 @@ class DisplayModuleTest(unittest.TestCase): self.assertEqual(pygame.display.set_gamma(gamma), True) @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "Needs a non-null videodriver", + os.environ.get("SDL_VIDEODRIVER") == "dummy", "Needs a not dummy videodriver" ) - @unittest.skipIf( - pygame.version.SDL >= (2, 32, 50), - "set_gamma is removed in SDL3, does not work in sdl2-compat either", - ) - @unittest.skipIf(is_wayland, "not supported on wayland") def test_set_gamma__tuple(self): pygame.display.set_mode((1, 1)) @@ -554,8 +779,8 @@ class DisplayModuleTest(unittest.TestCase): self.assertEqual(pygame.display.set_gamma(r, g, b), True) @unittest.skipIf( - pygame.version.SDL >= (2, 32, 50), - "set_gamma_ramp is removed in SDL3, does not work in sdl2-compat either", + not hasattr(pygame.display, "set_gamma_ramp"), + "Not all systems and hardware support gamma ramps", ) def test_set_gamma_ramp(self): # __doc__ (as of 2008-08-02) for pygame.display.set_gamma_ramp: @@ -608,7 +833,7 @@ class DisplayModuleTest(unittest.TestCase): def test_set_mode_unscaled(self): """Ensures a window created with SCALED can become smaller.""" - # see https://github.com/pygame-community/pygame-ce/issues/1194 + # see https://github.com/pygame/pygame/issues/2327 screen = pygame.display.set_mode((300, 300), pygame.SCALED) self.assertEqual(screen.get_size(), (300, 300)) @@ -653,11 +878,41 @@ class DisplayModuleTest(unittest.TestCase): palette = [1, 2, 3] pygame.display.set_palette(palette) - skip_list = [pygame.NULL_VIDEODRIVER, "android"] + skip_list = ["dummy", "android"] + + @unittest.skipIf(True, "set_palette() not supported in SDL2") + def test_set_palette_kwargs(self): + with self.assertRaises(pygame.error): + palette = [1, 2, 3] + pygame.display.set_palette(palette=palette) + pygame.display.set_mode((1024, 768), 0, 8) + palette = [] + self.assertIsNone(pygame.display.set_palette(palette=palette)) + + with self.assertRaises(ValueError): + palette = 12 + pygame.display.set_palette(palette=palette) + with self.assertRaises(TypeError): + palette = [[1, 2], [1, 2]] + pygame.display.set_palette(palette=palette) + with self.assertRaises(TypeError): + palette = [[0, 0, 0, 0, 0]] + [[x, x, x, x, x] for x in range(1, 255)] + pygame.display.set_palette(palette=palette) + with self.assertRaises(TypeError): + palette = "qwerty" + pygame.display.set_palette(palette=palette) + with self.assertRaises(TypeError): + palette = [[123, 123, 123] * 10000] + pygame.display.set_palette(palette=palette) + with self.assertRaises(TypeError): + palette = [1, 2, 3] + pygame.display.set_palette(palette=palette) + + skip_list = ["dummy", "android"] @unittest.skipIf( os.environ.get("SDL_VIDEODRIVER") in skip_list, - "requires the SDL_VIDEODRIVER to be non-null", + "requires the SDL_VIDEODRIVER to be non dummy", ) def test_toggle_fullscreen(self): """Test for toggle fullscreen""" @@ -698,14 +953,6 @@ class DisplayModuleTest(unittest.TestCase): (test_surf.get_width(), test_surf.get_height()), width_height ) - @unittest.skipIf(is_wayland, "not supported on wayland") - def test_get_set_window_position(self): - pygame.display.set_mode((500, 500)) - pygame.display.set_window_position((420, 360)) - position = pygame.display.get_window_position() - self.assertEqual(position[0], 420) - self.assertEqual(position[1], 360) - class DisplayUpdateTest(unittest.TestCase): def question(self, qstr): @@ -734,9 +981,6 @@ class DisplayUpdateTest(unittest.TestCase): r3 = pygame.Rect(-10, 0, -100, -100) pygame.display.update(r3) - # random point in rect - self.assertEqual(self.screen.get_at((50, 50)), (0, 255, 0)) - self.question("Is the screen green in (0, 0, 100, 100)?") def test_update_sequence(self): @@ -751,47 +995,6 @@ class DisplayUpdateTest(unittest.TestCase): pygame.display.update(rects) pygame.event.pump() # so mac updates - # random points in rect - for random_point in ((50, 50), (150, 50), (250, 50), (350, 350)): - self.assertEqual(self.screen.get_at(random_point), (0, 255, 0)) - - self.question(f"Is the screen green in {rects}?") - - def test_update_dict_values(self): - """only updates the part of the display given by the rects.""" - self.screen.fill("green") - rects = { - "foo": pygame.Rect(0, 0, 100, 100), - "foobar": pygame.Rect(100, 0, 100, 100), - "hello": pygame.Rect(200, 0, 100, 100), - "hi": pygame.Rect(300, 300, 100, 100), - } - pygame.display.update(rects.values()) - pygame.event.pump() # so mac updates - - # random points in rect - for random_point in ((50, 50), (150, 50), (250, 50), (350, 350)): - self.assertEqual(self.screen.get_at(random_point), (0, 255, 0)) - - self.question(f"Is the screen green in {' '.join(map(str, rects.values()))}?") - - def test_update_generator(self): - """only updates the part of the display given by the rects.""" - self.screen.fill("green") - rects = [ - pygame.Rect(0, 0, 100, 100), - pygame.Rect(100, 0, 100, 100), - pygame.Rect(200, 0, 100, 100), - pygame.Rect(300, 300, 100, 100), - ] - # make a generator from list, pass list with rect duplicates - pygame.display.update(i for i in (rects * 5)) - pygame.event.pump() # so mac updates - - # random points in rect - for random_point in ((50, 50), (150, 50), (250, 50), (350, 350)): - self.assertEqual(self.screen.get_at(random_point), (0, 255, 0)) - self.question(f"Is the screen green in {rects}?") def test_update_none_skipped(self): @@ -807,10 +1010,6 @@ class DisplayUpdateTest(unittest.TestCase): pygame.display.update(rects) pygame.event.pump() # so mac updates - # random points in rect - for random_point in ((50, 50), (150, 50), (250, 50), (350, 350)): - self.assertEqual(self.screen.get_at(random_point), (0, 255, 0)) - self.question(f"Is the screen green in {rects}?") def test_update_none(self): @@ -818,19 +1017,14 @@ class DisplayUpdateTest(unittest.TestCase): self.screen.fill("green") pygame.display.update(None) pygame.event.pump() # so mac updates - self.question(f"Is the screen black and NOT green?") + self.question("Is the screen black and NOT green?") def test_update_no_args(self): """does NOT update the display.""" self.screen.fill("green") pygame.display.update() pygame.event.pump() # so mac updates - - # random points in rect - for random_point in ((50, 50), (150, 50), (250, 50), (350, 350)): - self.assertEqual(self.screen.get_at(random_point), (0, 255, 0)) - - self.question(f"Is the WHOLE screen green?") + self.question("Is the WHOLE screen green?") def test_update_args(self): """updates the display using the args as a rect.""" @@ -839,9 +1033,6 @@ class DisplayUpdateTest(unittest.TestCase): pygame.event.pump() # so mac updates self.question("Is the screen green in (100, 100, 100, 100)?") - # random points in rect - self.assertEqual(self.screen.get_at((150, 150)), (0, 255, 0)) - def test_update_incorrect_args(self): """raises a ValueError when inputs are wrong.""" @@ -889,10 +1080,6 @@ class DisplayInteractiveTest(unittest.TestCase): self.assertTrue(response) pygame.display.quit() - @unittest.skipIf( - pygame.version.SDL >= (2, 32, 50), - "set_gamma_ramp is removed in SDL3, does not work in sdl2-compat either", - ) def test_set_gamma_ramp(self): os.environ["SDL_VIDEO_WINDOW_POS"] = "100,250" pygame.display.quit() @@ -919,7 +1106,7 @@ class DisplayInteractiveTest(unittest.TestCase): pygame.display.quit() -class FullscreenToggleTestsInteractive(unittest.TestCase): +class FullscreenToggleTests(unittest.TestCase): __tags__ = ["interactive"] screen = None @@ -985,8 +1172,8 @@ class FullscreenToggleTestsInteractive(unittest.TestCase): @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "OpenGL requires a non-null SDL_VIDEODRIVER", + os.environ.get("SDL_VIDEODRIVER") == "dummy", + 'OpenGL requires a non-"dummy" SDL_VIDEODRIVER', ) class DisplayOpenGLTest(unittest.TestCase): def test_screen_size_opengl(self): @@ -1000,7 +1187,7 @@ class DisplayOpenGLTest(unittest.TestCase): class X11CrashTest(unittest.TestCase): def test_x11_set_mode_crash_gh1654(self): - # Test for https://github.com/pygame-community/pygame-ce/issues/924 + # Test for https://github.com/pygame/pygame/issues/1654 # If unfixed, this will trip a segmentation fault pygame.display.init() pygame.display.quit() @@ -1008,105 +1195,5 @@ class X11CrashTest(unittest.TestCase): self.assertEqual((640, 480), screen.get_size()) -class MessageBoxTest(unittest.TestCase): - def test_messagebox_args(self): - mb = pygame.display.message_box - self.assertRaises(IndexError, lambda: mb("", escape_button=1)) - self.assertRaises(IndexError, lambda: mb("", escape_button=-2)) - self.assertRaises(IndexError, lambda: mb("", return_button=1)) - self.assertRaises(IndexError, lambda: mb("", return_button=-2)) - self.assertRaises( - IndexError, - lambda: mb("", buttons=("A", "B", "C"), return_button=3), - ) - self.assertRaises( - IndexError, - lambda: mb("", buttons=("A", "B", "C"), return_button=-4), - ) - self.assertRaises( - IndexError, - lambda: mb("", buttons=("A", "B", "C"), escape_button=3), - ) - self.assertRaises( - IndexError, - lambda: mb("", buttons=("A", "B", "C"), escape_button=-4), - ) - self.assertRaises(ValueError, lambda: mb("", message_type="random_str")) - self.assertRaises(TypeError, lambda: mb("", buttons=())) - self.assertRaises(TypeError, lambda: mb("", parent_window=123456)) - - -class MessageBoxInteractiveTest(unittest.TestCase): - __tags__ = ["interactive"] - - def test_message_box_type(self): - result = pygame.display.message_box( - "Test", - "Is this an error message box?", - message_type="error", - buttons=("Yes", "No"), - ) - self.assertEqual(result, 0) - - result = pygame.display.message_box( - "Test", - "Is this an info message box?", - message_type="info", - buttons=("Yes", "No"), - ) - self.assertEqual(result, 0) - - result = pygame.display.message_box( - "Test", - "Is this a warn message box?", - message_type="warn", - buttons=("Yes", "No"), - ) - self.assertEqual(result, 0) - - def test_message_box_buttons(self): - result = pygame.display.message_box("Hit the 'OK' button") - self.assertEqual(result, 0) - - result = pygame.display.message_box( - "Hit the 'Hello' button", - buttons=("Nope", "Nope", "Nope", "Hello", "Nope", "Nope"), - ) - self.assertEqual(result, 3) - - result = pygame.display.message_box( - "Press Enter on your keyboard", - buttons=("O", "O", "O", "O", "O", "O"), - return_button=4, - ) - self.assertEqual(result, 4) - - result = pygame.display.message_box( - "Press Enter on your keyboard", - buttons=("O", "O", "O", "O", "O", "O"), - return_button=-3, - ) - self.assertEqual(result, 3) - - result = pygame.display.message_box( - "Press Esc on your keyboard", - buttons=("O", "O", "O", "O", "O", "O"), - escape_button=2, - ) - self.assertEqual(result, 2) - - result = pygame.display.message_box( - "Test", - "You saw 'Yes' on the left and 'No' on the right. Is this correct?", - buttons=("Yes", "No"), - ) - self.assertEqual(result, 0) - - def test_message_box_parent_window_none(self): - pygame.display.message_box( - "Test", "Just close this messagebox", parent_window=None - ) - - if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/docs_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/docs_test.py index 05f0726..de021a8 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/docs_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/docs_test.py @@ -6,11 +6,11 @@ import unittest class DocsIncludedTest(unittest.TestCase): def test_doc_import_works(self): - from pygame.docs import PKG_DIR, has_local_docs + from pygame.docs.__main__ import has_local_docs, open_docs @unittest.skipIf("CI" not in os.environ, "Docs not required for local builds") def test_docs_included(self): - from pygame.docs import has_local_docs + from pygame.docs.__main__ import has_local_docs self.assertTrue(has_local_docs()) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/draw_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/draw_test.py index 3329b1c..a33f864 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/draw_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/draw_test.py @@ -1,14 +1,15 @@ -import itertools import math -import sys import unittest +import sys import warnings import pygame from pygame import draw +from pygame import draw_py from pygame.locals import SRCALPHA -from pygame.math import Vector2 from pygame.tests import test_utils +from pygame.math import Vector2 + RED = BG_RED = pygame.Color("red") GREEN = FG_GREEN = pygame.Color("green") @@ -150,7 +151,7 @@ def create_bounding_rect(surface, surf_color, default_pos): surface.unlock() if -1 == xmax: - # No points mean a 0 sized rect positioned at default_pos. + # No points means a 0 sized rect positioned at default_pos. return pygame.Rect(default_pos, (0, 0)) return pygame.Rect((xmin, ymin), (xmax - xmin + 1, ymax - ymin + 1)) @@ -167,7 +168,6 @@ class DrawTestCase(unittest.TestCase): draw_rect = staticmethod(draw.rect) draw_polygon = staticmethod(draw.polygon) draw_circle = staticmethod(draw.circle) - draw_aacircle = staticmethod(draw.aacircle) draw_ellipse = staticmethod(draw.ellipse) draw_arc = staticmethod(draw.arc) draw_line = staticmethod(draw.line) @@ -176,6 +176,21 @@ class DrawTestCase(unittest.TestCase): draw_aalines = staticmethod(draw.aalines) +class PythonDrawTestCase(unittest.TestCase): + """Base class to test draw_py module functions.""" + + # draw_py is currently missing some functions. + # draw_rect = staticmethod(draw_py.draw_rect) + draw_polygon = staticmethod(draw_py.draw_polygon) + # draw_circle = staticmethod(draw_py.draw_circle) + # draw_ellipse = staticmethod(draw_py.draw_ellipse) + # draw_arc = staticmethod(draw_py.draw_arc) + draw_line = staticmethod(draw_py.draw_line) + draw_lines = staticmethod(draw_py.draw_lines) + draw_aaline = staticmethod(draw_py.draw_aaline) + draw_aalines = staticmethod(draw_py.draw_aalines) + + ### Ellipse Testing ########################################################### @@ -1045,6 +1060,17 @@ class DrawEllipseTest(DrawEllipseMixin, DrawTestCase): """ +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever properly supports drawing ellipses. +# @unittest.skip('draw_py.draw_ellipse not supported yet') +# class PythonDrawEllipseTest(DrawEllipseMixin, PythonDrawTestCase): +# """Test draw_py module function draw_ellipse. +# +# This class inherits the general tests from DrawEllipseMixin. It is also +# the class to add any draw_py.draw_ellipse specific tests to. +# """ + + ### Line/Lines/AALine/AALines Testing ######################################### @@ -1073,7 +1099,7 @@ class BaseLineMixin: for size in ((49, 49), (50, 50)): for depth in (8, 16, 24, 32): for flags in (0, SRCALPHA): - surface = pygame.display.set_mode(size, flags) + surface = pygame.display.set_mode(size, flags, depth) surfaces.append(surface) surfaces.append(surface.convert_alpha()) return surfaces @@ -1552,9 +1578,11 @@ class LineMixin(BaseLineMixin): def test_line__bounding_rect(self): """Ensures draw line returns the correct bounding rect. - Test lines with endpoints on and off the surface and a range of + Tests lines with endpoints on and off the surface and a range of width/thickness values. """ + if isinstance(self, PythonDrawTestCase): + self.skipTest("bounding rects not supported in draw_py.draw_line") line_color = pygame.Color("red") surf_color = pygame.Color("black") @@ -1649,6 +1677,17 @@ class LineMixin(BaseLineMixin): surface.unlock() +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever fully supports drawing single lines. +# @unittest.skip('draw_py.draw_line not fully supported yet') +# class PythonDrawLineTest(LineMixin, PythonDrawTestCase): +# """Test draw_py module function line. +# +# This class inherits the general tests from LineMixin. It is also the class +# to add any draw_py.draw_line specific tests to. +# """ + + class DrawLineTest(LineMixin, DrawTestCase): """Test draw module function line. @@ -1689,7 +1728,7 @@ class DrawLineTest(LineMixin, DrawTestCase): for pt in test_utils.rect_outer_bounds(drawn): self.assertNotEqual(self.surf.get_at(pt), self.color) - # Line width greater than 1 + # Line width greater that 1 line_width = 2 offset = 5 a = (offset, offset) @@ -1792,61 +1831,6 @@ class DrawLineTest(LineMixin, DrawTestCase): check_white_line((50, 50), (0, 120)) check_white_line((50, 50), (199, 198)) - def test_line_clipping_with_thickness(self): - width = 200 - height = 200 - start_points = [ - (-50, -50), - (-50, 50), - (50, 50), - (250, 250), - (200, 203), - (-29, 131), - (203, 0), - (-10, -10), - (-10, 210), - ] - end_points = [ - (20, 200), - (20, -20), - (-20, -10), - (120, 20), - (0, 202), - (21, 106), - (200, 200), - (210, 210), - (100, 150), - ] - check_points = [ - ((2, 126), (255, 255, 255)), - ((2, 3), (255, 255, 255)), - ((50, 55), (255, 255, 255)), - ((199, 165), (255, 255, 255)), - ((99, 198), (255, 255, 255)), - ((70, 80), (0, 0, 0)), - ((199, 0), (255, 255, 255)), - ((105, 100), (255, 255, 255)), - ((5, 198), (255, 255, 255)), - ] - - surf = pygame.Surface((width, height), pygame.SRCALPHA) - for n in range(len(start_points)): - surf.fill((0, 0, 0)) - pygame.draw.line(surf, (255, 255, 255), start_points[n], end_points[n], 10) - self.assertEqual( - surf.get_at(check_points[n][0]), - check_points[n][1], - "start={}, end={}".format(start_points[n], end_points[n]), - ) - surf.fill((0, 0, 0)) - pygame.draw.line(surf, (255, 255, 255), end_points[n], start_points[n], 10) - - self.assertEqual( - surf.get_at(check_points[n][0]), - check_points[n][1], - "start={}, end={}".format(end_points[n], start_points[n]), - ) - ### Lines Testing ############################################################# @@ -2246,7 +2230,7 @@ class LinesMixin(BaseLineMixin): def test_lines__color(self): """Tests if the lines drawn are the correct color. - Draw lines around the border of the given surface and check if all + Draws lines around the border of the given surface and checks if all borders of the surface only contain the given color. """ for surface in self._create_surfaces(): @@ -2292,7 +2276,7 @@ class LinesMixin(BaseLineMixin): def test_lines__gaps(self): """Tests if the lines drawn contain any gaps. - Draw lines around the border of the given surface and check if + Draws lines around the border of the given surface and checks if all borders of the surface contain any gaps. """ expected_color = (255, 255, 255) @@ -2328,7 +2312,7 @@ class LinesMixin(BaseLineMixin): def test_lines__bounding_rect(self): """Ensures draw lines returns the correct bounding rect. - Test lines with endpoints on and off the surface and a range of + Tests lines with endpoints on and off the surface and a range of width/thickness values. """ line_color = pygame.Color("red") @@ -2382,7 +2366,7 @@ class LinesMixin(BaseLineMixin): clip_rect = pygame.Rect((0, 0), (11, 11)) clip_rect.center = surface.get_rect().center - pos_rect = clip_rect.copy() # Manages the lines' pos. + pos_rect = clip_rect.copy() # Manages the lines's pos. # Test centering the pos_rect along the clip rect's edge to allow for # drawing the lines over the clip_rect's bounds. @@ -2421,6 +2405,16 @@ class LinesMixin(BaseLineMixin): surface.unlock() +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever fully supports drawing lines. +# class PythonDrawLinesTest(LinesMixin, PythonDrawTestCase): +# """Test draw_py module function lines. +# +# This class inherits the general tests from LinesMixin. It is also the +# class to add any draw_py.draw_lines specific tests to. +# """ + + class DrawLinesTest(LinesMixin, DrawTestCase): """Test draw module function lines. @@ -2441,33 +2435,31 @@ class AALineMixin(BaseLineMixin): def test_aaline__args(self): """Ensures draw aaline accepts the correct args.""" bounds_rect = self.draw_aaline( - pygame.Surface((3, 3)), (0, 10, 0, 50), (0, 0), (1, 1) + pygame.Surface((3, 3)), (0, 10, 0, 50), (0, 0), (1, 1), 1 + ) + + self.assertIsInstance(bounds_rect, pygame.Rect) + + def test_aaline__args_without_blend(self): + """Ensures draw aaline accepts the args without a blend.""" + bounds_rect = self.draw_aaline( + pygame.Surface((2, 2)), (0, 0, 0, 50), (0, 0), (2, 2) ) self.assertIsInstance(bounds_rect, pygame.Rect) def test_aaline__blend_warning(self): - """Using the blend argument should raise a DeprecationWarning""" - faulty_blend_values = [0, 1, True, False] + """From pygame 2, blend=False should raise DeprecationWarning.""" with warnings.catch_warnings(record=True) as w: - for count, blend in enumerate(faulty_blend_values): - # Cause all warnings to always be triggered. - warnings.simplefilter("always") - # Trigger DeprecationWarning. - bounding1 = self.draw_aaline( - pygame.Surface((2, 2)), (0, 0, 0, 50), (0, 0), (2, 2), blend=blend - ) - # Doesn't trigger DeprecationWarning, interepreted as width - bounding2 = self.draw_aaline( - pygame.Surface((2, 2)), (0, 0, 0, 50), (0, 0), (2, 2), blend - ) - # Check if there is only one warning and is a DeprecationWarning. - self.assertEqual(len(w), count + 1) - self.assertTrue(issubclass(w[-1].category, DeprecationWarning)) - - # check that the line gets drawn - self.assertEqual(bounding1, bounding2) - self.assertEqual(bounding1, (0, 0, 2, 2)) + # Cause all warnings to always be triggered. + warnings.simplefilter("always") + # Trigger DeprecationWarning. + self.draw_aaline( + pygame.Surface((2, 2)), (0, 0, 0, 50), (0, 0), (2, 2), False + ) + # Check if there is only one warning and is a DeprecationWarning. + self.assertEqual(len(w), 1) + self.assertTrue(issubclass(w[-1].category, DeprecationWarning)) def test_aaline__kwargs(self): """Ensures draw aaline accepts the correct kwargs""" @@ -2475,14 +2467,12 @@ class AALineMixin(BaseLineMixin): color = pygame.Color("yellow") start_pos = (1, 1) end_pos = (2, 2) - width = 2 kwargs_list = [ { "surface": surface, "color": color, "start_pos": start_pos, "end_pos": end_pos, - "width": width, }, ] @@ -2495,7 +2485,6 @@ class AALineMixin(BaseLineMixin): """Ensures draw aaline's kwargs are not order dependent.""" bounds_rect = self.draw_aaline( start_pos=(1, 2), - width=2, end_pos=(2, 1), color=(10, 20, 30), surface=pygame.Surface((3, 2)), @@ -2527,7 +2516,6 @@ class AALineMixin(BaseLineMixin): "color": pygame.Color("red"), "start_pos": (2, 1), "end_pos": (2, 2), - "width": 2, } for name in ("end_pos", "start_pos", "color", "surface"): @@ -2566,42 +2554,30 @@ class AALineMixin(BaseLineMixin): color = pygame.Color("green") start_pos = (1, 0) end_pos = (2, 0) - width = 1 kwargs_list = [ { "surface": pygame.Surface, # Invalid surface. "color": color, "start_pos": start_pos, "end_pos": end_pos, - "width": width, }, { "surface": surface, "color": 2.3, # Invalid color. "start_pos": start_pos, "end_pos": end_pos, - "width": width, }, { "surface": surface, "color": color, "start_pos": (0, 0, 0), # Invalid start_pos. "end_pos": end_pos, - "width": width, }, { "surface": surface, "color": color, "start_pos": start_pos, "end_pos": (0,), # Invalid end_pos. - "width": width, - }, - { - "surface": surface, - "color": color, - "start_pos": start_pos, - "end_pos": (0,), - "width": 1.2, # Invalid width. }, ] @@ -2615,14 +2591,12 @@ class AALineMixin(BaseLineMixin): color = pygame.Color("cyan") start_pos = (1, 1) end_pos = (2, 0) - width = 1 kwargs_list = [ { "surface": surface, "color": color, "start_pos": start_pos, "end_pos": end_pos, - "width": width, "invalid": 1, }, { @@ -2644,16 +2618,14 @@ class AALineMixin(BaseLineMixin): color = (255, 255, 0, 0) start_pos = (0, 1) end_pos = (1, 2) - width = 1 kwargs = { "surface": surface, "color": color, "start_pos": start_pos, "end_pos": end_pos, - "width": width, } - for name in ("surface", "color", "start_pos", "end_pos", "width"): + for name in ("surface", "color", "start_pos", "end_pos"): kwargs.pop(name) if "surface" == name: @@ -2673,29 +2645,6 @@ class AALineMixin(BaseLineMixin): self.assertIsInstance(bounds_rect, pygame.Rect) - def test_aaline__valid_width_values(self): - """Ensures draw aaline accepts different width values.""" - line_color = pygame.Color("yellow") - surface_color = pygame.Color("white") - surface = pygame.Surface((3, 4)) - pos = (2, 1) - kwargs = { - "surface": surface, - "color": line_color, - "start_pos": pos, - "end_pos": (2, 2), - "width": None, - } - - for width in (-100, -10, -1, 0, 1, 10, 100): - surface.fill(surface_color) # Clear for each test. - kwargs["width"] = width - - bounds_rect = self.draw_aaline(**kwargs) - - self.assertEqual(surface.get_at(pos), line_color) - self.assertIsInstance(bounds_rect, pygame.Rect) - def test_aaline__valid_start_pos_formats(self): """Ensures draw aaline accepts different start_pos formats.""" expected_color = pygame.Color("red") @@ -2706,7 +2655,6 @@ class AALineMixin(BaseLineMixin): "color": expected_color, "start_pos": None, "end_pos": (2, 2), - "width": 2, } x, y = 2, 1 # start position positions = ((x, y), (x + 0.01, y), (x, y + 0.01), (x + 0.01, y + 0.01)) @@ -2735,7 +2683,6 @@ class AALineMixin(BaseLineMixin): "color": expected_color, "start_pos": (2, 1), "end_pos": None, - "width": 2, } x, y = 2, 2 # end position positions = ((x, y), (x + 0.02, y), (x, y + 0.02), (x + 0.02, y + 0.02)) @@ -2761,7 +2708,6 @@ class AALineMixin(BaseLineMixin): "color": pygame.Color("red"), "start_pos": None, "end_pos": (2, 2), - "width": 2, } start_pos_fmts = ( @@ -2785,7 +2731,6 @@ class AALineMixin(BaseLineMixin): "color": pygame.Color("red"), "start_pos": (2, 2), "end_pos": None, - "width": 2, } end_pos_fmts = ( @@ -2813,7 +2758,6 @@ class AALineMixin(BaseLineMixin): "color": None, "start_pos": pos, "end_pos": (2, 1), - "width": 2, } greens = ( (0, 255, 0), @@ -2843,7 +2787,6 @@ class AALineMixin(BaseLineMixin): "color": None, "start_pos": (1, 1), "end_pos": (2, 1), - "width": 2, } for expected_color in (2.3, self): @@ -2861,17 +2804,6 @@ class AALineMixin(BaseLineMixin): self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}") - def test_aaline__color_with_thickness(self): - """Ensures a thick aaline is drawn using the correct color.""" - from_x = 5 - to_x = 10 - y = 5 - for surface in self._create_surfaces(): - for expected_color in self.COLORS: - self.draw_aaline(surface, expected_color, (from_x, y), (to_x, y), 5) - for pos in ((x, y + i) for i in (-2, 0, 2) for x in (from_x, to_x)): - self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}") - def test_aaline__gaps(self): """Tests if the aaline drawn contains any gaps. @@ -2886,30 +2818,11 @@ class AALineMixin(BaseLineMixin): pos = (x, 0) self.assertEqual(surface.get_at(pos), expected_color, f"pos={pos}") - def test_aaline__gaps_with_thickness(self): - """Ensures a thick aaline is drawn without any gaps.""" - background_color = (0, 0, 0) - thickness = 5 - for surface in self._create_surfaces(): - width = surface.get_width() - 1 - h = width // 5 - w = h * 5 - self.draw_aaline(surface, (255, 255, 255), (0, 5), (w, 5 + h), thickness) - - for x in range(w + 1): - for y in range(3, 8): - pos = (x, y + ((x + 2) // 5)) - self.assertNotEqual( - surface.get_at(pos), background_color, f"pos={pos}" - ) - def test_aaline__bounding_rect(self): """Ensures draw aaline returns the correct bounding rect. - Test lines with endpoints on and off the surface and a range of - width/thickness values. + Tests lines with endpoints on and off the surface. """ - line_color = pygame.Color("red") surf_color = pygame.Color("blue") width = height = 30 @@ -2927,24 +2840,16 @@ class AALineMixin(BaseLineMixin): for pos in rect_corners_mids_and_center(surf_rect): helper_rect.center = pos - # Draw using different thicknesses. - for thickness in range(-1, 5): - for start, end in self._rect_lines(helper_rect): - surface.fill(surf_color) # Clear for each test. + for start, end in self._rect_lines(helper_rect): + surface.fill(surf_color) # Clear for each test. - bounding_rect = self.draw_aaline( - surface, line_color, start, end, thickness - ) + bounding_rect = self.draw_aaline(surface, line_color, start, end) - # Calculating the expected_rect after the line is - # drawn (it uses what is actually drawn). - expected_rect = create_bounding_rect(surface, surf_color, start) + # Calculating the expected_rect after the line is + # drawn (it uses what is actually drawn). + expected_rect = create_bounding_rect(surface, surf_color, start) - self.assertEqual( - bounding_rect, - expected_rect, - f"start={start}, end={end}, size={size}, thickness={thickness}", - ) + self.assertEqual(bounding_rect, expected_rect) def test_aaline__surface_clip(self): """Ensures draw aaline respects a surface's clip area.""" @@ -2958,62 +2863,47 @@ class AALineMixin(BaseLineMixin): clip_rect.center = surface.get_rect().center pos_rect = clip_rect.copy() # Manages the aaline's pos. - for thickness in (1, 3): # Test different line widths. - # Test centering the pos_rect along the clip rect's edge to allow for - # drawing the aaline over the clip_rect's bounds. - for center in rect_corners_mids_and_center(clip_rect): - pos_rect.center = center - start = pos_rect.midtop - end = pos_rect.midbottom + # Test centering the pos_rect along the clip rect's edge to allow for + # drawing the aaline over the clip_rect's bounds. + for center in rect_corners_mids_and_center(clip_rect): + pos_rect.center = center - # Get the expected points by drawing the aaline without the - # clip area set. - surface.set_clip(None) - surface.fill(surface_color) - self.draw_aaline( - surface, - aaline_color, - start, - end, - thickness, - ) + # Get the expected points by drawing the aaline without the + # clip area set. + surface.set_clip(None) + surface.fill(surface_color) + self.draw_aaline(surface, aaline_color, pos_rect.midtop, pos_rect.midbottom) - expected_pts = get_color_points( - surface, surface_color, clip_rect, False - ) + expected_pts = get_color_points(surface, surface_color, clip_rect, False) - # Clear the surface and set the clip area. Redraw the aaline - # and check that only the clip area is modified. - surface.fill(surface_color) - surface.set_clip(clip_rect) + # Clear the surface and set the clip area. Redraw the aaline + # and check that only the clip area is modified. + surface.fill(surface_color) + surface.set_clip(clip_rect) - self.draw_aaline( - surface, - aaline_color, - start, - end, - thickness, - ) + self.draw_aaline(surface, aaline_color, pos_rect.midtop, pos_rect.midbottom) - surface.lock() # For possible speed up. + surface.lock() # For possible speed up. - # Check all the surface points to ensure the expected_pts - # are not surface_color. - for pt in ((x, y) for x in range(surfw) for y in range(surfh)): - if pt in expected_pts: - self.assertNotEqual( - surface.get_at(pt), - surface_color, - f"start={start}, end={end}, thickness={thickness}, point={pt}", - ) - else: - self.assertEqual( - surface.get_at(pt), - surface_color, - f"start={start}, end={end}, thickness={thickness}, point={pt}", - ) + # Check all the surface points to ensure the expected_pts + # are not surface_color. + for pt in ((x, y) for x in range(surfw) for y in range(surfh)): + if pt in expected_pts: + self.assertNotEqual(surface.get_at(pt), surface_color, pt) + else: + self.assertEqual(surface.get_at(pt), surface_color, pt) - surface.unlock() + surface.unlock() + + +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever fully supports drawing single aalines. +# class PythonDrawAALineTest(AALineMixin, PythonDrawTestCase): +# """Test draw_py module function aaline. +# +# This class inherits the general tests from AALineMixin. It is also the +# class to add any draw_py.draw_aaline specific tests to. +# """ class DrawAALineTest(AALineMixin, DrawTestCase): @@ -3028,12 +2918,12 @@ class DrawAALineTest(AALineMixin, DrawTestCase): for depth in (24, 32): surface = pygame.Surface((5, 3), 0, depth) surface.fill(pygame.Color(0, 0, 0)) - self.draw_aaline(surface, pygame.Color(255, 0, 0), (0, 1), (2, 1)) + self.draw_aaline(surface, pygame.Color(255, 0, 0), (0, 1), (2, 1), 1) self.assertGreater(surface.get_at((1, 1)).r, 0, "there should be red here") surface.fill(pygame.Color(0, 0, 0)) - self.draw_aaline(surface, pygame.Color(0, 0, 255), (0, 1), (2, 1)) + self.draw_aaline(surface, pygame.Color(0, 0, 255), (0, 1), (2, 1), 1) self.assertGreater(surface.get_at((1, 1)).b, 0, "there should be blue here") @@ -3045,7 +2935,7 @@ class DrawAALineTest(AALineMixin, DrawTestCase): should[from_point] = should[to_point] = FG_GREEN def check_one_direction(from_point, to_point, should): - self.draw_aaline(self.surface, FG_GREEN, from_point, to_point) + self.draw_aaline(self.surface, FG_GREEN, from_point, to_point, True) for pt in check_points: color = should.get(pt, BG_RED) @@ -3300,29 +3190,31 @@ class AALinesMixin(BaseLineMixin): def test_aalines__args(self): """Ensures draw aalines accepts the correct args.""" bounds_rect = self.draw_aalines( - pygame.Surface((3, 3)), (0, 10, 0, 50), False, ((0, 0), (1, 1)) + pygame.Surface((3, 3)), (0, 10, 0, 50), False, ((0, 0), (1, 1)), 1 + ) + + self.assertIsInstance(bounds_rect, pygame.Rect) + + def test_aalines__args_without_blend(self): + """Ensures draw aalines accepts the args without a blend.""" + bounds_rect = self.draw_aalines( + pygame.Surface((2, 2)), (0, 0, 0, 50), False, ((0, 0), (1, 1)) ) self.assertIsInstance(bounds_rect, pygame.Rect) def test_aalines__blend_warning(self): - """Using the blend argument should raise a DeprecationWarning""" - faulty_blend_values = [0, 1, True, False, None, "", [], type] + """From pygame 2, blend=False should raise DeprecationWarning.""" with warnings.catch_warnings(record=True) as w: - for count, blend in enumerate(faulty_blend_values): - # Cause all warnings to always be triggered. - warnings.simplefilter("always") - # Trigger DeprecationWarning. - self.draw_aalines( - pygame.Surface((2, 2)), - (0, 0, 0, 50), - False, - ((0, 0), (1, 1)), - blend, - ) - # Check if there is only one warning and is a DeprecationWarning. - self.assertEqual(len(w), count + 1) - self.assertTrue(issubclass(w[-1].category, DeprecationWarning)) + # Cause all warnings to always be triggered. + warnings.simplefilter("always") + # Trigger DeprecationWarning. + self.draw_aalines( + pygame.Surface((2, 2)), (0, 0, 0, 50), False, ((0, 0), (1, 1)), False + ) + # Check if there is only one warning and is a DeprecationWarning. + self.assertEqual(len(w), 1) + self.assertTrue(issubclass(w[-1].category, DeprecationWarning)) def test_aalines__kwargs(self): """Ensures draw aalines accepts the correct kwargs.""" @@ -3389,6 +3281,10 @@ class AALinesMixin(BaseLineMixin): closed = 0 points = ((1, 2), (2, 1)) + with self.assertRaises(TypeError): + # Invalid blend. + bounds_rect = self.draw_aalines(surface, color, closed, points, "1") + with self.assertRaises(TypeError): # Invalid points. bounds_rect = self.draw_aalines(surface, color, closed, (1, 2, 3)) @@ -3677,7 +3573,7 @@ class AALinesMixin(BaseLineMixin): def test_aalines__bounding_rect(self): """Ensures draw aalines returns the correct bounding rect. - Test lines with endpoints on and off the surface and blending + Tests lines with endpoints on and off the surface and blending enabled and disabled. """ line_color = pygame.Color("red") @@ -3759,6 +3655,16 @@ class AALinesMixin(BaseLineMixin): surface.unlock() +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever fully supports drawing aalines. +# class PythonDrawAALinesTest(AALinesMixin, PythonDrawTestCase): +# """Test draw_py module function aalines. +# +# This class inherits the general tests from AALinesMixin. It is also the +# class to add any draw_py.draw_aalines specific tests to. +# """ + + class DrawAALinesTest(AALinesMixin, DrawTestCase): """Test draw module function aalines. @@ -3766,66 +3672,11 @@ class DrawAALinesTest(AALinesMixin, DrawTestCase): class to add any draw.aalines specific tests to. """ - def test_aalines__overlap(self): - """Ensures that two adjacent antialiased lines are not overlapping. - - Draws two lines, and checks if 2 pixels, at shared point between those - two lines, are too bright. - - See: https://github.com/pygame-community/pygame-ce/pull/2912 - """ - line_color = (150, 150, 150) - max_expected_colors = ((70, 70, 70), (100, 100, 100)) - test_points = [[20.1, 25.4], [25.1, 25.6], [30.1, 25.8]] - - surface = pygame.display.set_mode((50, 50)) - self.draw_aalines(surface, line_color, False, test_points) - - for i, y in enumerate((25, 26)): - check_color = tuple(surface.get_at((25, y))) - self.assertLess( - check_color, - max_expected_colors[i], - f"aalines are overlapping, pos={(25, y)}", - ) - - def test_aalines__steep_missing_pixel(self): - """Ensures there are no missing pixels between steep and non-steep lines. - - Draws two adjacent lines: first is not steep and second is, then - checks if there is missing pixel at shared point between those two lines. - - See: https://github.com/pygame-community/pygame-ce/pull/2912 - """ - line_color = (150, 150, 150) - min_expected_color = (40, 40, 40) - test_points = [[11.2, 8.5], [17.1, 25.7], [35.8, 25.5], [47.6, 41.8]] - - surface = pygame.display.set_mode((50, 50)) - self.draw_aalines(surface, line_color, False, test_points) - - # First line is steep, and other line is not steep - check_color = tuple(surface.get_at((17, 26))) - self.assertGreater( - check_color, - min_expected_color, - "Pixel is missing between steep and non-steep line, pos=(17, 26)", - ) - - # First line is not steep, and other line is steep - check_color = tuple(surface.get_at((36, 25))) - self.assertGreater( - check_color, - min_expected_color, - "Pixel is missing between non-steep and steep line, pos=(26, 25)", - ) - ### Polygon Testing ########################################################### SQUARE = ([0, 0], [3, 0], [3, 3], [0, 3]) DIAMOND = [(1, 3), (3, 5), (5, 3), (3, 1)] -RHOMBUS = [(1, 3), (4, 5), (7, 3), (4, 1)] CROSS = ( [2, 0], [4, 0], @@ -4186,7 +4037,7 @@ class DrawPolygonMixin: self.draw_polygon(self.surface, RED, SQUARE, 0) # note : there is a discussion (#234) if draw.polygon should include or # not the right or lower border; here we stick with current behavior, - # e.g. include those borders ... + # eg include those borders ... for x in range(4): for y in range(4): self.assertEqual(self.surface.get_at((x, y)), RED) @@ -4233,7 +4084,7 @@ class DrawPolygonMixin: self.assertEqual(self.surface.get_at((5, y)), RED) def test_draw_symetric_cross(self): - """non-regression on pygame-ce issue #249 : x and y where handled inconsistently. + """non-regression on issue #234 : x and y where handled inconsistently. Also, the result is/was different whether we fill or not the polygon. """ @@ -4268,7 +4119,7 @@ class DrawPolygonMixin: self.assertEqual(self.surface.get_at((x, y)), RED) def test_illumine_shape(self): - """non-regression on pygame-ce issue #328""" + """non-regression on issue #313""" rect = pygame.Rect((0, 0, 20, 20)) path_data = [ (0, 0), @@ -4428,16 +4279,74 @@ class DrawPolygonMixin: surface.unlock() - def test_polygon_filled_shape(self): - """non-regression on issue #515 (644) - Ensures the outline of a filled polygon is drawn the same as an - unfilled polygon. + # Test cases for Issue #3989 (fixed on #4191) + # This tests the fill polygon bug to avoid + def test_polygon_large_coords_3989(self): """ - key_polygon_points = [(2, 2), (6, 2), (2, 4), (6, 4)] - pygame.draw.rect(self.surface, RED, (0, 0, 10, 10), 0) - pygame.draw.polygon(self.surface, GREEN, RHOMBUS, 0) - for x, y in key_polygon_points: - self.assertEqual(self.surface.get_at((x, y)), GREEN, msg=str((x, y))) + Ensures draw polygon works correctly with large points. + Testing the drawings of filled polygons + """ + point_a = (600, 50) + point_b = (50, 600) + extreme_points_coords = (58000, 100000) + extreme_negative_coords = (-58000, -100000) + extreme_negative_x = (-58000, 100000) + extreme_negative_y = (58000, -100000) + + surf_w = surf_h = 650 + surface = pygame.Surface((surf_w, surf_h)) + + green = (0, 255, 0) + white = (0, 0, 0, 255) + + # Draw white background + pygame.draw.rect(surface, white, (0, 0, surf_w, surf_h), 0) + + # Extreme points case + def extreme_points(self): + self.assertEqual(surface.get_at((640, 50)), white) + self.assertEqual(surface.get_at((50, 640)), white) + + # Extreme negative points case + def extreme_negative_pass(self): + self.assertEqual(surface.get_at((600, 25)), white) + + def extreme_negative_fail(self): + self.assertNotEqual(surface.get_at((5, 5)), white) + + # Extreme negative x case + def extreme_x_pass(self): + self.assertEqual(surface.get_at((600, 600)), white) + + def extreme_x_fail(self): + self.assertNotEqual(surface.get_at((100, 640)), white) + + # Extreme negative y case + def extreme_y_pass(self): + self.assertEqual(surface.get_at((600, 600)), white) + + def extreme_y_fail(self): + self.assertNotEqual(surface.get_at((300, 300)), white) + + # Checks the surface point to ensure the polygon has been drawn correctly. + # Uses multiple passing and failing test cases depending on the polygon + self.draw_polygon(surface, green, (point_a, point_b, extreme_points_coords)) + extreme_points(self) + + pygame.draw.rect(surface, white, (0, 0, surf_w, surf_h), 0) + self.draw_polygon(surface, green, (point_a, point_b, extreme_negative_coords)) + extreme_negative_pass(self) + extreme_negative_fail(self) + + pygame.draw.rect(surface, white, (0, 0, surf_w, surf_h), 0) + self.draw_polygon(surface, green, (point_a, point_b, extreme_negative_x)) + extreme_x_pass(self) + extreme_x_fail(self) + + pygame.draw.rect(surface, white, (0, 0, surf_w, surf_h), 0) + self.draw_polygon(surface, green, (point_a, point_b, extreme_negative_y)) + extreme_y_pass(self) + extreme_y_fail(self) class DrawPolygonTest(DrawPolygonMixin, DrawTestCase): @@ -4448,6 +4357,17 @@ class DrawPolygonTest(DrawPolygonMixin, DrawTestCase): """ +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever fully supports drawing polygons. +# @unittest.skip('draw_py.draw_polygon not fully supported yet') +# class PythonDrawPolygonTest(DrawPolygonMixin, PythonDrawTestCase): +# """Test draw_py module function draw_polygon. +# +# This class inherits the general tests from DrawPolygonMixin. It is also +# the class to add any draw_py.draw_polygon specific tests to. +# """ + + ### Rect Testing ############################################################## @@ -4903,7 +4823,7 @@ class DrawRectMixin: self.assertNotEqual(color_at_pt, self.color) - # pygame-ce issue #325: Cannot draw rectangles that are 1 pixel high + # Issue #310: Cannot draw rectangles that are 1 pixel high bgcolor = pygame.Color("black") self.surf.fill(bgcolor) hrect = pygame.Rect(1, 1, self.surf_w - 2, 1) @@ -5087,6 +5007,17 @@ class DrawRectTest(DrawRectMixin, DrawTestCase): """ +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever properly supports drawing rects. +# @unittest.skip('draw_py.draw_rect not supported yet') +# class PythonDrawRectTest(DrawRectMixin, PythonDrawTestCase): +# """Test draw_py module function draw_rect. +# +# This class inherits the general tests from DrawRectMixin. It is also the +# class to add any draw_py.draw_rect specific tests to. +# """ + + ### Circle Testing ############################################################ @@ -5702,7 +5633,7 @@ class DrawCircleMixin: def test_circle__bounding_rect(self): """Ensures draw circle returns the correct bounding rect. - Test circles on and off the surface and a range of width/thickness + Tests circles on and off the surface and a range of width/thickness values. """ circle_color = pygame.Color("red") @@ -5732,8 +5663,17 @@ class DrawCircleMixin: # Calculating the expected_rect after the circle is # drawn (it uses what is actually drawn). expected_rect = create_bounding_rect(surface, surf_color, pos) + # print("pos:%s:, radius:%s:, thickness:%s:" % (pos, radius, thickness)) - self.assertEqual(bounding_rect, expected_rect) + # self.assertEqual(bounding_rect, expected_rect) + with self.subTest( + surface=surface, + circle_color=circle_color, + pos=pos, + radius=radius, + thickness=thickness, + ): + self.assertEqual(bounding_rect, expected_rect) def test_circle_negative_radius(self): """Ensures negative radius circles return zero sized bounding rect.""" @@ -5848,62 +5788,55 @@ class DrawCircleMixin: self.assertEqual(bounding_rect.width, radius * 2) self.assertEqual(bounding_rect.height, radius * 2) - def test_circle__offscreen(self): - """Ensures that drawing a circle completely off-screen doesn't create - a solid band across the screen - see https://github.com/pygame/pygame/issues/3143 - """ - width = 200 - height = 200 - surf = pygame.Surface((width, height)) - surf_center = surf.get_rect().center + def test_x_bounds(self): + """ensures a circle is drawn properly when there is a negative x, or a big x.""" + + surf = pygame.Surface((200, 200)) + bgcolor = (0, 0, 0, 255) + surf.fill(bgcolor) + color = (255, 0, 0, 255) + width = 1 radius = 10 - # way way outside the screen - test_centers = [ - (-1e30, height / 2), - (1e30, height / 2), - (width / 2, -1e30), - (width / 2, 1e30), - ] - for center in test_centers: - surf.fill("black") - self.draw_circle(surf, "white", center, radius) + where = (0, 30) + bounding_rect1 = self.draw_circle(surf, color, where, radius=radius) + self.assertEqual( + bounding_rect1, + pygame.Rect(0, where[1] - radius, where[0] + radius, radius * 2), + ) + self.assertEqual( + surf.get_at((where[0] if where[0] > 0 else 0, where[1])), color + ) + self.assertEqual(surf.get_at((where[0] + radius + 1, where[1])), bgcolor) + self.assertEqual(surf.get_at((where[0] + radius - 1, where[1])), color) - self.assertEqual( - surf.get_at(surf_center)[0:3], - (0, 0, 0), - msg="pixel at center should be black, not white", - ) + surf.fill(bgcolor) + where = (-1e30, 80) + bounding_rect1 = self.draw_circle(surf, color, where, radius=radius) + self.assertEqual(bounding_rect1, pygame.Rect(where[0], where[1], 0, 0)) + self.assertEqual(surf.get_at((0 + radius, where[1])), bgcolor) - def test_circle__no_band(self): - """Ensures that drawing a circle with the center off-screen doesn't create a - solid band across the screen - This tests a bug introduced in - https://github.com/pygame-community/pygame-ce/commit/c88a1d8f7b31099cec84dc5cb7aeebdada783e83 - """ - width = 200 - height = 200 - surf = pygame.Surface((width, height)) - surf_center = surf.get_rect().center - radius = 10 + surf.fill(bgcolor) + where = (surf.get_width() + radius * 2, 80) + bounding_rect1 = self.draw_circle(surf, color, where, radius=radius) + self.assertEqual(bounding_rect1, pygame.Rect(where[0], where[1], 0, 0)) + self.assertEqual(surf.get_at((0, where[1])), bgcolor) + self.assertEqual(surf.get_at((0 + radius // 2, where[1])), bgcolor) + self.assertEqual(surf.get_at((surf.get_width() - 1, where[1])), bgcolor) + self.assertEqual(surf.get_at((surf.get_width() - radius, where[1])), bgcolor) - # one pixel outside the screen on the center of each edge - test_centers = [ - (-1, height / 2), - (width + 1, height / 2), - (width / 2, -1), - (width / 2, height + 1), - ] - for center in test_centers: - surf.fill("black") - self.draw_circle(surf, "white", center, radius) - - self.assertEqual( - surf.get_at(surf_center)[0:3], - (0, 0, 0), - msg="pixel at center should be black, not white", - ) + surf.fill(bgcolor) + where = (-1, 80) + bounding_rect1 = self.draw_circle(surf, color, where, radius=radius) + self.assertEqual( + bounding_rect1, + pygame.Rect(0, where[1] - radius, where[0] + radius, radius * 2), + ) + self.assertEqual( + surf.get_at((where[0] if where[0] > 0 else 0, where[1])), color + ) + self.assertEqual(surf.get_at((where[0] + radius, where[1])), bgcolor) + self.assertEqual(surf.get_at((where[0] + radius - 1, where[1])), color) class DrawCircleTest(DrawCircleMixin, DrawTestCase): @@ -5914,792 +5847,15 @@ class DrawCircleTest(DrawCircleMixin, DrawTestCase): """ -### AACircle Testing ############################################################ - - -class DrawAACircleMixin: - """Mixin tests for drawing antialiased circles. - - This class contains all the general antialiased aacircle drawing tests. - Most of test are taken from DrawCircleMixin class - """ - - def test_aacircle__args(self): - """Ensures draw aacircle accepts the correct args.""" - bounds_rect = self.draw_aacircle( - pygame.Surface((3, 3)), (0, 10, 0, 50), (0, 0), 3, 1, 1, 0, 1, 1 - ) - - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__args_without_width(self): - """Ensures draw aacircle accepts the args without a width and - quadrants.""" - bounds_rect = self.draw_aacircle( - pygame.Surface((2, 2)), (0, 0, 0, 50), (1, 1), 1 - ) - - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__args_with_negative_width(self): - """Ensures draw aacircle accepts the args with negative width.""" - bounds_rect = self.draw_aacircle( - pygame.Surface((2, 2)), (0, 0, 0, 50), (1, 1), 1, -1 - ) - - self.assertIsInstance(bounds_rect, pygame.Rect) - self.assertEqual(bounds_rect, pygame.Rect(1, 1, 0, 0)) - - def test_aacircle__args_with_width_gt_radius(self): - """Ensures draw aacircle accepts the args with width > radius.""" - bounds_rect = self.draw_aacircle( - pygame.Surface((2, 2)), (0, 0, 0, 50), (1, 1), 2, 3, 0, 0, 0, 0 - ) - - self.assertIsInstance(bounds_rect, pygame.Rect) - self.assertEqual(bounds_rect, pygame.Rect(0, 0, 2, 2)) - - def test_aacircle__kwargs(self): - """Ensures draw aacircle accepts the correct kwargs - with and without a width and quadrant arguments. - """ - kwargs_list = [ - { - "surface": pygame.Surface((4, 4)), - "color": pygame.Color("yellow"), - "center": (2, 2), - "radius": 2, - "width": 1, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": False, - "draw_bottom_right": True, - }, - { - "surface": pygame.Surface((2, 1)), - "color": (0, 10, 20), - "center": (1, 1), - "radius": 1, - }, - ] - - for kwargs in kwargs_list: - bounds_rect = self.draw_aacircle(**kwargs) - - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__kwargs_order_independent(self): - """Ensures draw aacircle's kwargs are not order dependent.""" - bounds_rect = self.draw_aacircle( - draw_top_right=False, - color=(10, 20, 30), - surface=pygame.Surface((3, 2)), - width=0, - draw_bottom_left=False, - center=(1, 0), - draw_bottom_right=False, - radius=2, - draw_top_left=True, - ) - - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__args_missing(self): - """Ensures draw aacircle detects any missing required args.""" - surface = pygame.Surface((1, 1)) - color = pygame.Color("blue") - - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle(surface, color, (0, 0)) - - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle(surface, color) - - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle(surface) - - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle() - - def test_aacircle__kwargs_missing(self): - """Ensures draw aacircle detects any missing required kwargs.""" - kwargs = { - "surface": pygame.Surface((1, 2)), - "color": pygame.Color("red"), - "center": (1, 0), - "radius": 2, - "width": 1, - "draw_top_right": False, - "draw_top_left": False, - "draw_bottom_left": False, - "draw_bottom_right": True, - } - - for name in ("radius", "center", "color", "surface"): - invalid_kwargs = dict(kwargs) - invalid_kwargs.pop(name) # Pop from a copy. - - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle(**invalid_kwargs) - - def test_aacircle__arg_invalid_types(self): - """Ensures draw aacircle detects invalid arg types.""" - surface = pygame.Surface((2, 2)) - color = pygame.Color("blue") - center = (1, 1) - radius = 1 - - with self.assertRaises(TypeError): - # Invalid draw_top_right. - bounds_rect = self.draw_aacircle( - surface, color, center, radius, 1, "a", 1, 1, 1 - ) - - with self.assertRaises(TypeError): - # Invalid draw_top_left. - bounds_rect = self.draw_aacircle( - surface, color, center, radius, 1, 1, "b", 1, 1 - ) - - with self.assertRaises(TypeError): - # Invalid draw_bottom_left. - bounds_rect = self.draw_aacircle( - surface, color, center, radius, 1, 1, 1, "c", 1 - ) - - with self.assertRaises(TypeError): - # Invalid draw_bottom_right. - bounds_rect = self.draw_aacircle( - surface, color, center, radius, 1, 1, 1, 1, "d" - ) - - with self.assertRaises(TypeError): - # Invalid width. - bounds_rect = self.draw_aacircle(surface, color, center, radius, "1") - - with self.assertRaises(TypeError): - # Invalid radius. - bounds_rect = self.draw_aacircle(surface, color, center, "2") - - with self.assertRaises(TypeError): - # Invalid center. - bounds_rect = self.draw_aacircle(surface, color, (1, 2, 3), radius) - - with self.assertRaises(TypeError): - # Invalid color. - bounds_rect = self.draw_aacircle(surface, 2.3, center, radius) - - with self.assertRaises(TypeError): - # Invalid surface. - bounds_rect = self.draw_aacircle((1, 2, 3, 4), color, center, radius) - - def test_aacircle__kwarg_invalid_types(self): - """Ensures draw aacircle detects invalid kwarg types.""" - surface = pygame.Surface((3, 3)) - color = pygame.Color("green") - center = (0, 1) - radius = 1 - width = 1 - quadrant = 1 - kwargs_list = [ - { - "surface": pygame.Surface, # Invalid surface. - "color": color, - "center": center, - "radius": radius, - "width": width, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": 2.3, # Invalid color. - "center": center, - "radius": radius, - "width": width, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": (1, 1, 1), # Invalid center. - "radius": radius, - "width": width, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": center, - "radius": "1", # Invalid radius. - "width": width, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": 1.2, # Invalid width. - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": width, - "draw_top_right": "True", # Invalid draw_top_right - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": width, - "draw_top_right": True, - "draw_top_left": "True", # Invalid draw_top_left - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": width, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": 3.14, # Invalid draw_bottom_left - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": width, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": "quadrant", # Invalid draw_bottom_right - }, - ] - - for kwargs in kwargs_list: - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle(**kwargs) - - def test_aacircle__kwarg_invalid_name(self): - """Ensures draw aacircle detects invalid kwarg names.""" - surface = pygame.Surface((2, 3)) - color = pygame.Color("cyan") - center = (0, 0) - radius = 2 - kwargs_list = [ - { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": 1, - "quadrant": 1, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - }, - { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "invalid": 1, - }, - ] - - for kwargs in kwargs_list: - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle(**kwargs) - - def test_aacircle__args_and_kwargs(self): - """Ensures draw aacircle accepts a combination of args/kwargs""" - surface = pygame.Surface((3, 1)) - color = (255, 255, 0, 0) - center = (1, 0) - radius = 2 - width = 0 - draw_top_right = True - draw_top_left = False - draw_bottom_left = False - draw_bottom_right = True - kwargs = { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": width, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - } - - for name in ( - "surface", - "color", - "center", - "radius", - "width", - "draw_top_right", - "draw_top_left", - "draw_bottom_left", - "draw_bottom_right", - ): - kwargs.pop(name) - - if "surface" == name: - bounds_rect = self.draw_aacircle(surface, **kwargs) - elif "color" == name: - bounds_rect = self.draw_aacircle(surface, color, **kwargs) - elif "center" == name: - bounds_rect = self.draw_aacircle(surface, color, center, **kwargs) - elif "radius" == name: - bounds_rect = self.draw_aacircle( - surface, color, center, radius, **kwargs - ) - elif "width" == name: - bounds_rect = self.draw_aacircle( - surface, color, center, radius, width, **kwargs - ) - elif "draw_top_right" == name: - bounds_rect = self.draw_aacircle( - surface, color, center, radius, width, draw_top_right, **kwargs - ) - elif "draw_top_left" == name: - bounds_rect = self.draw_aacircle( - surface, - color, - center, - radius, - width, - draw_top_right, - draw_top_left, - **kwargs, - ) - elif "draw_bottom_left" == name: - bounds_rect = self.draw_aacircle( - surface, - color, - center, - radius, - width, - draw_top_right, - draw_top_left, - draw_bottom_left, - **kwargs, - ) - else: - bounds_rect = self.draw_aacircle( - surface, - color, - center, - radius, - width, - draw_top_right, - draw_top_left, - draw_bottom_left, - draw_bottom_right, - **kwargs, - ) - - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__valid_width_values(self): - """Ensures draw aacircle accepts different width values.""" - center = (2, 2) - radius = 1 - pos = (center[0] - radius, center[1]) - surface_color = pygame.Color("white") - surface = pygame.Surface((3, 4)) - color = (10, 20, 30, 255) - kwargs = { - "surface": surface, - "color": color, - "center": center, - "radius": radius, - "width": None, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - } - - for width in (-100, -10, -1, 0, 1, 10, 100): - surface.fill(surface_color) # Clear for each test. - kwargs["width"] = width - expected_color = color if width >= 0 else surface_color - - bounds_rect = self.draw_aacircle(**kwargs) - - self.assertEqual(surface.get_at(pos), expected_color) - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__valid_radius_values(self): - """Ensures draw aacircle accepts different radius values.""" - pos = center = (2, 2) - surface_color = pygame.Color("white") - surface = pygame.Surface((3, 4)) - color = (10, 20, 30, 255) - kwargs = { - "surface": surface, - "color": color, - "center": center, - "radius": None, - "width": 0, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - } - - for radius in (-10, -1, 0, 1, 10): - surface.fill(surface_color) # Clear for each test. - kwargs["radius"] = radius - expected_color = color if radius > 0 else surface_color - - bounds_rect = self.draw_aacircle(**kwargs) - - self.assertEqual(surface.get_at(pos), expected_color) - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__valid_center_formats(self): - """Ensures draw aacircle accepts different center formats.""" - expected_color = pygame.Color("red") - surface_color = pygame.Color("black") - surface = pygame.Surface((4, 4)) - kwargs = { - "surface": surface, - "color": expected_color, - "center": None, - "radius": 1, - "width": 0, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - } - x, y = 2, 2 # center position - - # The center values can be ints or floats. - for center in ((x, y), (x + 0.1, y), (x, y + 0.1), (x + 0.1, y + 0.1)): - # The center type can be a tuple/list/Vector2. - for seq_type in (tuple, list, Vector2): - surface.fill(surface_color) # Clear for each test. - kwargs["center"] = seq_type(center) - - bounds_rect = self.draw_aacircle(**kwargs) - - self.assertEqual(surface.get_at((x, y)), expected_color) - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__valid_color_formats(self): - """Ensures draw aacircle accepts different color formats.""" - center = (2, 2) - radius = 1 - pos = (center[0] - radius, center[1]) - green_color = pygame.Color("green") - surface_color = pygame.Color("black") - surface = pygame.Surface((3, 4)) - kwargs = { - "surface": surface, - "color": None, - "center": center, - "radius": radius, - "width": 0, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - } - greens = ( - (0, 255, 0), - (0, 255, 0, 255), - surface.map_rgb(green_color), - green_color, - ) - - for color in greens: - surface.fill(surface_color) # Clear for each test. - kwargs["color"] = color - - if isinstance(color, int): - expected_color = surface.unmap_rgb(color) - else: - expected_color = green_color - - bounds_rect = self.draw_aacircle(**kwargs) - - self.assertEqual(surface.get_at(pos), expected_color) - self.assertIsInstance(bounds_rect, pygame.Rect) - - def test_aacircle__invalid_color_formats(self): - """Ensures draw aacircle handles invalid color formats correctly.""" - kwargs = { - "surface": pygame.Surface((4, 3)), - "color": None, - "center": (1, 2), - "radius": 1, - "width": 0, - "draw_top_right": True, - "draw_top_left": True, - "draw_bottom_left": True, - "draw_bottom_right": True, - } - - for expected_color in (2.3, self): - kwargs["color"] = expected_color - - with self.assertRaises(TypeError): - bounds_rect = self.draw_aacircle(**kwargs) - - def test_aacircle__floats(self): - """Ensure that floats are accepted.""" - draw.aacircle( - surface=pygame.Surface((4, 4)), - color=(255, 255, 127), - center=(1.5, 1.5), - radius=1.3, - width=0, - draw_top_right=True, - draw_top_left=True, - draw_bottom_left=True, - draw_bottom_right=True, - ) - - draw.aacircle( - surface=pygame.Surface((4, 4)), - color=(255, 255, 127), - center=Vector2(1.5, 1.5), - radius=1.3, - width=0, - draw_top_right=True, - draw_top_left=True, - draw_bottom_left=True, - draw_bottom_right=True, - ) - - draw.aacircle(pygame.Surface((2, 2)), (0, 0, 0, 50), (1.3, 1.3), 1.2) - - def test_aacircle__bounding_rect(self): - """Ensures draw aacircle returns the correct bounding rect. - - Test circles on and off the surface and a range of width/thickness - values. - """ - circle_color = pygame.Color("red") - surf_color = pygame.Color("black") - max_radius = 3 - surface = pygame.Surface((30, 30), 0, 32) - surf_rect = surface.get_rect() - # Make a rect that is bigger than the surface to help test drawing - # circles off and partially off the surface. Make this rect such that - # when centering the test aacircle on one of its corners, the aacircle is - # drawn fully off the test surface, but a rect bounding the aacircle - # would still overlap with the test surface. - big_rect = surf_rect.inflate(max_radius * 2 - 1, max_radius * 2 - 1) - - for pos in rect_corners_mids_and_center( - surf_rect - ) + rect_corners_mids_and_center(big_rect): - # Test using different radius and thickness values. - for radius in range(max_radius + 1): - for thickness in range(radius + 1): - surface.fill(surf_color) # Clear for each test. - - bounding_rect = self.draw_aacircle( - surface, circle_color, pos, radius, thickness - ) - - # Calculating the expected_rect after the aacircle is - # drawn (it uses what is actually drawn). - expected_rect = create_bounding_rect(surface, surf_color, pos) - # print("pos:%s:, radius:%s:, thickness:%s:" % (pos, radius, thickness)) - self.assertEqual(bounding_rect, expected_rect) - - def test_aacircle_negative_radius(self): - """Ensures negative radius circles return zero sized bounding rect.""" - surf = pygame.Surface((200, 200)) - color = (0, 0, 0, 50) - center = surf.get_height() // 2, surf.get_height() // 2 - - bounding_rect = self.draw_aacircle(surf, color, center, radius=-1, width=1) - self.assertEqual(bounding_rect.size, (0, 0)) - - def test_aacircle_zero_radius(self): - """Ensures zero radius circles does not draw a center pixel. - - NOTE: This is backwards incompatible behaviour with 1.9.x. - """ - surf = pygame.Surface((200, 200)) - circle_color = pygame.Color("red") - surf_color = pygame.Color("black") - center = (100, 100) - radius = 0 - width = 1 - - bounding_rect = self.draw_aacircle(surf, circle_color, center, radius, width) - expected_rect = create_bounding_rect(surf, surf_color, center) - self.assertEqual(bounding_rect, expected_rect) - self.assertEqual(bounding_rect, pygame.Rect(100, 100, 0, 0)) - - def test_aacircle_shape(self): - """Ensures there are no holes in the aacircle, and no overdrawing. - - Tests drawing a thick aacircle. - Measures the distance of the drawn pixels from the aacircle center. - """ - surfw = surfh = 100 - circle_color = pygame.Color("red") - surface_color = pygame.Color("green") - surface = pygame.Surface((surfw, surfh)) - surface.fill(surface_color) - - (cx, cy) = center = (50, 50) - radius = 45 - width = 25 - - dest_rect = self.draw_aacircle(surface, circle_color, center, radius, width) - - for pt in test_utils.rect_area_pts(dest_rect): - x, y = pt - sqr_distance = (x - cx) ** 2 + (y - cy) ** 2 - if (radius - width + 1) ** 2 < sqr_distance < (radius - 1) ** 2: - self.assertEqual(surface.get_at(pt), circle_color) - if ( - sqr_distance < (radius - width - 1) ** 2 - or sqr_distance > (radius + 1) ** 2 - ): - self.assertEqual(surface.get_at(pt), surface_color) - - def test_aacircle__diameter(self): - """Ensures draw aacircle is twice size of radius high and wide.""" - surf = pygame.Surface((200, 200)) - color = (0, 0, 0, 50) - center = surf.get_height() // 2, surf.get_height() // 2 - width = 1 - radius = 6 - for radius in range(1, 65): - bounding_rect = self.draw_aacircle(surf, color, center, radius, width) - # antialiased circles has off-by-one error - self.assertEqual(bounding_rect.width, radius * 2 + 1) - self.assertEqual(bounding_rect.height, radius * 2 + 1) - - def test_aacircle__offscreen(self): - """Ensures that drawing a aacircle completely off-screen doesn't create - a solid band across the screen - see https://github.com/pygame/pygame/issues/3143 - """ - width = 200 - height = 200 - surf = pygame.Surface((width, height)) - surf_center = surf.get_rect().center - radius = 10 - - # way way outside the screen - test_centers = [ - (-1e30, height / 2), - (1e30, height / 2), - (width / 2, -1e30), - (width / 2, 1e30), - ] - for center in test_centers: - surf.fill("black") - self.draw_aacircle(surf, "white", center, radius) - - self.assertEqual( - surf.get_at(surf_center)[0:3], - (0, 0, 0), - msg="pixel at center should be black, not white", - ) - - def test_aacircle__no_band(self): - """Ensures that drawing a aacircle with the center off-screen doesn't create a - solid band across the screen - This tests a bug introduced in - https://github.com/pygame-community/pygame-ce/commit/c88a1d8f7b31099cec84dc5cb7aeebdada783e83 - """ - width = 200 - height = 200 - surf = pygame.Surface((width, height)) - surf_center = surf.get_rect().center - radius = 10 - - # one pixel outside the screen on the center of each edge - test_centers = [ - (-1, height / 2), - (width + 1, height / 2), - (width / 2, -1), - (width / 2, height + 1), - ] - for center in test_centers: - surf.fill("black") - self.draw_aacircle(surf, "white", center, radius) - - self.assertEqual( - surf.get_at(surf_center)[0:3], - (0, 0, 0), - msg="pixel at center should be black, not white", - ) - - def test_aacircle__width(self): - """Ensures draw aacircle renders the correct width. - see https://github.com/pygame-community/pygame-ce/issues/3682 - """ - bg_color = pygame.Color("white") - fg_color = pygame.Color("black") - size = 10 - radius = size - 1 # radius excludes the center pixel - surf = pygame.Surface((size, size)) - - for width in range(1, radius): # test when width < radius - surf.fill(bg_color) - self.draw_aacircle( - surf, fg_color, (0, 0), radius, width, draw_bottom_right=True - ) - rendered_width = 0 - for x in range(size - 1, -1, -1): - if surf.get_at((x, 0)) == fg_color: - rendered_width += 1 - else: - break - self.assertEqual( - rendered_width, width, msg="draw.aacircle rendered wrong width" - ) - - -class DrawAACircleTest(DrawAACircleMixin, DrawTestCase): - """Test draw module function aacircle. - - This class inherits the general tests from DrawAACircleMixin. It is also - the class to add any draw.aacircle specific tests to.""" +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever properly supports drawing circles. +# @unittest.skip('draw_py.draw_circle not supported yet') +# class PythonDrawCircleTest(DrawCircleMixin, PythonDrawTestCase): +# """Test draw_py module function draw_circle." +# +# This class inherits the general tests from DrawCircleMixin. It is also +# the class to add any draw_py.draw_circle specific tests to. +# """ ### Arc Testing ############################################################### @@ -7157,78 +6313,45 @@ class DrawArcMixin: with self.assertRaises(TypeError): bounds_rect = self.draw_arc(**kwargs) - def test_arc__correct_drawing(self): + def test_arc(self): """Ensure draw arc works correctly.""" - surfw, surfh = 500, 500 - surface = pygame.Surface((surfw, surfh)) - surface_color = pygame.Color("black") - surface.fill(surface_color) - arc_color = pygame.Color("white") - rectangles = [ - pygame.Rect((200, 200), (300 + i, 200 + i)) for i in range(-100, 50, 30) - ] # Test on different bounding rectangles - angle_pairs = [ - (0, 2), - (0, 3.14), - (1, 4), - (2, 5.5), - (0, 6.28), - ] # Test a variety of start and stop angles - widths = [ - -10, - -5, - -1, - 0, - 1, - 2, - 5, - 10, - 20, - 50, - 100, - ] # Test a wider range of stroke width + black = pygame.Color("black") + red = pygame.Color("red") - for rect in rectangles: - for start, stop in angle_pairs: - for width in widths: - # A tolerance value that adapt to the width - tolerance_radius = min(max(0, width // 10), 1) - kwargs = { - "surface": surface, - "color": arc_color, - "rect": rect, - "start_angle": start, - "stop_angle": stop, - "width": width, - } + # create an image object of width 100, height 150, filled with black. + surface = pygame.Surface((100, 150)) + surface.fill(black) - pygame.draw.arc(**kwargs) + # rectangle that contains for the ellipse arc. + # 0 pixel from left, 0 pixel from top + # 80 pixels wide, 40 pixels high + rect = (0, 0, 80, 40) - a, b = rect.width / 2, rect.height / 2 - number_of_valid_arc_points = 0 - number_of_invalid_arc_points = 0 - # Define a threshold for comparison - eps = 0.01 - center_x = rect.centerx - center_y = rect.centery + # angle of the arc in radians + start_angle = 0.0 + stop_angle = 3.14 - for x in range(surfw): - for y in range(surfh): - # Check whether the point on the arc belongs to the ellipse defined by the bounding rectangle - if (surface.get_at((x, y)) == arc_color) and abs( - ((x - center_x) / a) ** 2 + ((y - center_y) / b) ** 2 - 1 - ) <= eps + tolerance_radius: - number_of_valid_arc_points += 1 - elif surface.get_at((x, y)) == arc_color: - number_of_invalid_arc_points += 1 - surface.fill(surface_color) # Clear for the next test + # thickness, and it grows inward from the rectangle + width = 3 - self.assertEqual(number_of_invalid_arc_points, 0) + # draw an elliptical arc + pygame.draw.arc(surface, red, rect, start_angle, stop_angle, width) + + # Save the drawn arc + pygame.image.save(surface, "arc.png") + + # arc is red + x = 20 + for y in range(2, 5): + self.assertEqual(surface.get_at((x, y)), red) + + # the rest area in surface is black + self.assertEqual(surface.get_at((0, 0)), black) def test_arc__bounding_rect(self): """Ensures draw arc returns the correct bounding rect. - Test arcs on and off the surface and a range of width/thickness + Tests arcs on and off the surface and a range of width/thickness values. """ arc_color = pygame.Color("red") @@ -7338,86 +6461,15 @@ class DrawArcTest(DrawArcMixin, DrawTestCase): """ -class DrawFloodFillTest(unittest.TestCase): - """Tests for flood fill.""" - - def test_flood_fill(self): - """Ensures flood fill fills with solid color""" - surf = pygame.Surface((100, 100)) - surf.fill((0, 0, 0)) - - pygame.draw.line(surf, (255, 0, 0), (10, 10), (90, 90), 5) - - self.assertEqual( - surf.get_at((10, 10)), (255, 0, 0), "line drawing precondition" - ) - self.assertEqual( - surf.get_at((90, 90)), (255, 0, 0), "line drawing precondition" - ) - - pygame.draw.flood_fill(surf, (255, 255, 255), (90, 90)) - - self.assertEqual( - surf.get_at((90, 90)), (255, 255, 255), "flood fill start point" - ) - self.assertEqual( - surf.get_at((10, 10)), (255, 255, 255), "flood fill reaching the end" - ) - - def test_flood_pattern(self): - """Ensures flood fill fills in a pattern""" - surf = pygame.Surface((100, 100)) - surf.fill((0, 0, 0)) - - pattern = pygame.Surface((2, 2)) - pattern.fill((255, 255, 255)) - pattern.set_at((0, 0), (255, 0, 0)) - pattern.set_at((1, 1), (0, 0, 255)) - - pygame.draw.line(surf, (0, 0, 0), (5, 95), (95, 5)) - pygame.draw.line(surf, (0, 0, 0), (50, 0), (50, 95)) - - pygame.draw.flood_fill(surf, pattern, (95, 95)) - - for pt in [(0, 0), (0, 1), (1, 0), (1, 1)]: - self.assertEqual(surf.get_at(pt), pattern.get_at(pt), pt) - - def test_flood_circle(self): - """Ensures flood fill doesn't overdraw""" - surf = pygame.Surface((100, 100)) - surf.fill((0, 0, 0)) - pygame.draw.circle(surf, (255, 0, 255), (50, 50), 40, 2) - pygame.draw.flood_fill(surf, (255, 255, 255), (10, 50)) - - surf2 = pygame.Surface((100, 100)) - surf2.fill((0, 0, 0)) - pygame.draw.circle(surf2, (255, 255, 255), (50, 50), 40, 2) - - for pt in itertools.product(range(100), range(100)): - self.assertEqual(surf.get_at(pt), surf2.get_at(pt)) - - surf = pygame.Surface((100, 100)) - surf.fill((0, 0, 0)) - pygame.draw.circle(surf, (255, 0, 255), (50, 50), 40, 1) - # fill outside of circle white - pygame.draw.flood_fill(surf, (255, 255, 255), (1, 1)) - # fill inside red - pygame.draw.flood_fill(surf, (255, 0, 0), (50, 50)) - - surf2 = pygame.Surface((100, 100)) - surf2.fill((255, 255, 255)) - # draw filled circle red - pygame.draw.circle(surf2, (255, 0, 0), (50, 50), 40) - # draw outer edge circle hot pink - pygame.draw.circle(surf2, (255, 0, 255), (50, 50), 40, 1) - - # both should be identical: white outside, thin pink line, red inside - # no black pixels missed, no spillover between inside and outside - # This assumes circle drawing works correctly: - # if circle is broken, this may or may not fail - - for pt in itertools.product(range(100), range(100)): - self.assertEqual(surf.get_at(pt), surf2.get_at(pt)) +# Commented out to avoid cluttering the test output. Add back in if draw_py +# ever properly supports drawing arcs. +# @unittest.skip('draw_py.draw_arc not supported yet') +# class PythonDrawArcTest(DrawArcMixin, PythonDrawTestCase): +# """Test draw_py module function draw_arc. +# +# This class inherits the general tests from DrawArcMixin. It is also the +# class to add any draw_py.draw_arc specific tests to. +# """ ### Draw Module Testing ####################################################### @@ -7427,7 +6479,7 @@ class DrawModuleTest(unittest.TestCase): """General draw module tests.""" def test_path_data_validation(self): - """Test validation of multipoint drawing methods. + """Test validation of multi-point drawing methods. See bug #521 """ @@ -7489,7 +6541,6 @@ class DrawModuleTest(unittest.TestCase): draw.arc(surf, col, pygame.Rect(0, 0, 3, 3), 15, 150) draw.ellipse(surf, col, pygame.Rect(0, 0, 3, 6), 1) draw.circle(surf, col, (7, 3), 2) - draw.aacircle(surf, col, (7, 3), 2) draw.polygon(surf, col, points, 0) # 2. invalid colors @@ -7515,59 +6566,9 @@ class DrawModuleTest(unittest.TestCase): with self.assertRaises(TypeError): draw.circle(surf, col, (7, 3), 2) - with self.assertRaises(TypeError): - draw.aacircle(surf, col, (7, 3), 2) - with self.assertRaises(TypeError): draw.polygon(surf, col, points, 0) - def test_aafunctions_depth_segfault(self): - """Ensure future commits don't break the segfault fixed by pull request - https://github.com/pygame-community/pygame-ce/pull/3008 - """ - - pixels_to_check = [(160, 102), (499, 300), (320, 258), (192, 252)] - pixel_colors_8 = [ - pygame.Color(0, 182, 0, 255), - pygame.Color(0, 0, 170, 255), - pygame.Color(255, 0, 0, 255), - pygame.Color(255, 0, 0, 255), - ] - - pixel_colors_16 = [ - pygame.Color(0, 178, 0, 255), - pygame.Color(0, 0, 213, 255), - pygame.Color(246, 0, 0, 255), - pygame.Color(222, 0, 0, 255), - ] - - pixel_colors_24_32 = [ - pygame.Color(0, 178, 0, 255), - pygame.Color(0, 0, 209, 255), - pygame.Color(247, 0, 0, 255), - pygame.Color(223, 0, 0, 255), - ] - - for depth in (8, 16, 24, 32): - # all values must stay so to reproduce the segfault - surf = pygame.Surface(size=(512, 512), flags=0, depth=depth) - - draw.aacircle(surf, pygame.Color("red"), (256, 256), 64) - draw.aaline(surf, pygame.Color("blue"), (256, 256), (500, 300)) - draw.aalines( - surf, pygame.Color("green"), False, [(100, 100), (100, 500), (160, 100)] - ) - - for i, pixel in enumerate(pixels_to_check): - if depth == 8: - self.assertEqual(surf.get_at(pixel), pixel_colors_8[i]) - elif depth == 16: - # allow small delta difference to account for SDL3 changes. - for x, y in zip(surf.get_at(pixel), pixel_colors_16[i]): - self.assertAlmostEqual(x, y, delta=2) - else: - self.assertEqual(surf.get_at(pixel), pixel_colors_24_32[i]) - ############################################################################### diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/event_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/event_test.py index 73da8a8..eb7c437 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/event_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/event_test.py @@ -1,14 +1,10 @@ import collections -import os import time import unittest +import os import pygame -pygame.display.init() -is_wayland = pygame.display.get_driver() == "wayland" -pygame.display.quit() - EVENT_TYPES = ( # pygame.NOEVENT, # pygame.ACTIVEEVENT, @@ -86,10 +82,6 @@ NAMES_AND_EVENTS = ( class EventTypeTest(unittest.TestCase): - def test_Event_alias(self): - """Check if pygame.Event is present and the correct type.""" - self.assertIs(pygame.Event, pygame.event.Event) - def test_Event(self): """Ensure an Event object can be created.""" e = pygame.event.Event(pygame.USEREVENT, some_attr=1, other_attr="1") @@ -98,7 +90,7 @@ class EventTypeTest(unittest.TestCase): self.assertEqual(e.other_attr, "1") # Event now uses tp_dictoffset and tp_members: - # https://github.com/pygame-community/pygame-ce/issues/77 + # https://github.com/pygame/pygame/issues/62 self.assertEqual(e.type, pygame.USEREVENT) self.assertIs(e.dict, e.__dict__) @@ -151,60 +143,26 @@ class EventTypeTest(unittest.TestCase): c = pygame.event.Event(EVENT_TYPES[1], a=1) d = pygame.event.Event(EVENT_TYPES[0], a=2) - self.assertTrue(a == a) - self.assertFalse(a != a) - self.assertTrue(a == b) - self.assertFalse(a != b) - self.assertTrue(a != c) - self.assertFalse(a == c) - self.assertTrue(a != d) - self.assertFalse(a == d) + # Comparing event a + self.assertEqual(a, a) # Event is equal to itself + self.assertEqual(a, b) # Same type and attributes + self.assertNotEqual(a, c) # Different type but same attributes + self.assertNotEqual(a, d) # Same type but different attributes - def test_event_args(self): - """Test event creation with args""" - NESTED_DICT = {"haha": True, "no": 92138023, "test": ("y", "e", "s")} - EXPECTED_ATTRIBUTES = { - "foo": "bar", - "ratio": 100, - "favourite_numbers": [3, 26, 42], - "nested_dict": NESTED_DICT, - "complex": 3 + 4j, - } - for event in ( - pygame.event.Event(1, EXPECTED_ATTRIBUTES), # pass as dict - pygame.event.Event(1, **EXPECTED_ATTRIBUTES), # pass as kwargs - pygame.event.Event( # test passing both dict and kwargs - 1, - {"nested_dict": NESTED_DICT, "complex": 3 + 4j}, - foo="bar", - ratio=100, - favourite_numbers=[3, 26, 42], - ), - ): - self.assertDictEqual(event.dict, EXPECTED_ATTRIBUTES) + # Comparing event b + self.assertEqual(b, a) # Same type and attributes + self.assertNotEqual(b, c) # Different type but same attributes + self.assertNotEqual(b, d) # Same type but different attributes - for out_of_range_val in (-1, -10, pygame.NUMEVENTS, pygame.NUMEVENTS + 1): - self.assertRaises(ValueError, pygame.event.Event, out_of_range_val) + # Comparing event c + self.assertNotEqual(c, a) # Different type but same attributes + self.assertNotEqual(c, b) # Different type but same attributes + self.assertNotEqual(c, d) # Different type and different attributes - for incorrect_type in ("string", 4 + 3j, [1, 2, 3], {"a": "b"}): - self.assertRaises(TypeError, pygame.event.Event, incorrect_type) - - def test_event_common_dict_changes(self): - d = {} - events = [pygame.Event(pygame.event.custom_type(), d) for _ in range(2)] - self.assertNotEqual(events[0], events[1]) - - d["hi"] = "hello" - events[0].hello = "hi" - events[1].dict["amongus"] = "sus" - - self.assertEqual(d, {"hi": "hello", "hello": "hi", "amongus": "sus"}) - for ev in events: - self.assertIs(d, ev.dict) - self.assertEqual(ev.dict, {"hi": "hello", "hello": "hi", "amongus": "sus"}) - self.assertEqual(ev.hi, "hello") - self.assertEqual(ev.hello, "hi") - self.assertEqual(ev.amongus, "sus") + # Comparing event d + self.assertNotEqual(d, a) # Same type but different attributes + self.assertNotEqual(d, b) # Same type but different attributes + self.assertNotEqual(d, c) # Different type and different attributes race_condition_notification = """ @@ -253,32 +211,16 @@ class EventModuleArgsTest(unittest.TestCase): self.assertRaises(ValueError, pygame.event.clear, 0x0010FFFFF) self.assertRaises(TypeError, pygame.event.get, ["a", "b", "c"]) - def test_peek_no_arg(self): - pygame.event.clear() - # do a strict "is" check and not just a simple truthy-test to check that - # we have a boolean instance. - self.assertIs(pygame.event.peek(), False) - self.assertIs(pygame.event.peek(None), False) - - # peek should return True if there's any event on the queue - pygame.event.post(pygame.event.Event(pygame.USEREVENT)) - self.assertIs(pygame.event.peek(), True) - self.assertIs(pygame.event.peek(None), True) - def test_peek(self): - self.assertIsInstance(pygame.event.peek(), bool) - self.assertIsInstance(pygame.event.peek(None), bool) - self.assertIsInstance(pygame.event.peek(None, True), bool) + pygame.event.peek() + pygame.event.peek(None) + pygame.event.peek(None, True) - self.assertIsInstance(pygame.event.peek(pump=False), bool) - self.assertIsInstance(pygame.event.peek(pump=True), bool) - self.assertIsInstance(pygame.event.peek(eventtype=None), bool) - self.assertIsInstance( - pygame.event.peek(eventtype=[pygame.KEYUP, pygame.KEYDOWN]), bool - ) - self.assertIsInstance( - pygame.event.peek(eventtype=pygame.USEREVENT, pump=False), bool - ) + pygame.event.peek(pump=False) + pygame.event.peek(pump=True) + pygame.event.peek(eventtype=None) + pygame.event.peek(eventtype=[pygame.KEYUP, pygame.KEYDOWN]) + pygame.event.peek(eventtype=pygame.USEREVENT, pump=False) class Foo: pass @@ -492,19 +434,6 @@ class EventModuleTest(unittest.TestCase): self.assertEqual(e.a, "a" * 1024) self.assertEqual(e.test, list(range(100))) - def test_post_same_reference(self): - """ - Test that event.post posts an event with a common reference to a dict. - """ - for event in ( - pygame.event.Event(pygame.event.custom_type(), attr=(1, 2, 3, 4)), - pygame.event.Event(pygame.event.custom_type()), - ): - pygame.event.post(event) - e = pygame.event.poll() - self.assertEqual(e.type, event.type) - self.assertIs(e.dict, event.dict) - def test_post_blocked(self): """ Test blocked events are not posted. Also test whether post() @@ -721,6 +650,13 @@ class EventModuleTest(unittest.TestCase): pygame.event.event_name(event), unexpected_name, f"0x{event:X}" ) + def test_event_name__kwargs(self): + """Ensure event_name() returns the correct event name when kwargs used.""" + for expected_name, event in NAMES_AND_EVENTS: + self.assertEqual( + pygame.event.event_name(type=event), expected_name, f"0x{event:X}" + ) + def test_peek(self): """Ensure queued events can be peeked at.""" event_types = [pygame.KEYDOWN, pygame.KEYUP, pygame.MOUSEMOTION] @@ -839,11 +775,12 @@ class EventModuleTest(unittest.TestCase): """Ensure pump() functions properly.""" pygame.event.pump() - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires the SDL_VIDEODRIVER to be a non-null value", - ) - @unittest.skipIf(is_wayland, "broken on wayland") + # @unittest.skipIf( + # os.environ.get("SDL_VIDEODRIVER") == "dummy", + # 'requires the SDL_VIDEODRIVER to be a non "dummy" value', + # ) + # Fails on SDL 2.0.18 + @unittest.skip("flaky test, and broken on 2.0.18 windows") def test_set_grab__and_get_symmetric(self): """Ensure event grabbing can be enabled and disabled. @@ -908,11 +845,12 @@ class EventModuleTest(unittest.TestCase): self.assertTrue(blocked) - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires the SDL_VIDEODRIVER to be a non-null value", - ) - @unittest.skipIf(is_wayland, "broken on wayland") + # @unittest.skipIf( + # os.environ.get("SDL_VIDEODRIVER") == "dummy", + # 'requires the SDL_VIDEODRIVER to be a non "dummy" value', + # ) + # Fails on SDL 2.0.18 + @unittest.skip("flaky test, and broken on 2.0.18 windows") def test_get_grab(self): """Ensure get_grab() works as expected""" surf = pygame.display.set_mode((10, 10)) @@ -921,6 +859,22 @@ class EventModuleTest(unittest.TestCase): pygame.event.set_grab(i % 2) self.assertEqual(pygame.event.get_grab(), i % 2) + @unittest.skipIf( + os.environ.get("SDL_VIDEODRIVER") == "dummy", + "requires the SDL_VIDEODRIVER to be a non dummy value", + ) + @unittest.skipIf(pygame.get_sdl_version() < (2, 0, 16), "Needs at least SDL 2.0.16") + def test_set_keyboard_grab_and_get_keyboard_grab(self): + """Ensure set_keyboard_grab() and get_keyboard_grab() work as expected""" + + surf = pygame.display.set_mode((10, 10)) + + pygame.event.set_keyboard_grab(True) + self.assertTrue(pygame.event.get_keyboard_grab()) + + pygame.event.set_keyboard_grab(False) + self.assertFalse(pygame.event.get_keyboard_grab()) + def test_poll(self): """Ensure poll() works as expected""" pygame.event.clear() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/fixtures/fonts/PyGameMono.sfd b/.venv/lib/python3.14/site-packages/pygame/tests/fixtures/fonts/PyGameMono.sfd deleted file mode 100644 index b8f5d5c..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/fixtures/fonts/PyGameMono.sfd +++ /dev/null @@ -1,238 +0,0 @@ -SplineFontDB: 3.0 -FontName: PyGameMono -FullName: PyGame Mono -FamilyName: PyGameMono -Weight: Medium -Copyright: Created by Lenard Lindstrom,,, with FontForge 2.0 (http://fontforge.sf.net) -UComments: "2013-10-11: Created.+AAoACgAA-pygame - Python Game Library+AAoA-Test font PyGameMono, Copyright (C) 2013 Lenard Lindstrom+AAoACgAA-This library is free software; you can redistribute it and/or+AAoA-modify it under the terms of the GNU Library General Public+AAoA-License as published by the Free Software Foundation; either+AAoA-version 2 of the License, or (at your option) any later version.+AAoACgAA-This library is distributed in the hope that it will be useful,+AAoA-but WITHOUT ANY WARRANTY; without even the implied warranty of+AAoA-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU+AAoA-Library General Public License for more details.+AAoACgAA-You should have received a copy of the GNU Library General Public+AAoA-License along with this library; if not, write to the Free+AAoA-Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA+AAoACgAA" -Version: 001.000 -ItalicAngle: 0 -UnderlinePosition: -100 -UnderlineWidth: 50 -Ascent: 800 -Descent: 200 -LayerCount: 2 -Layer: 0 0 "Back" 1 -Layer: 1 0 "Fore" 0 -XUID: [1021 912 78401767 10725709] -FSType: 8 -OS2Version: 0 -OS2_WeightWidthSlopeOnly: 0 -OS2_UseTypoMetrics: 1 -CreationTime: 1381544181 -ModificationTime: 1381781368 -PfmFamily: 49 -TTFWeight: 500 -TTFWidth: 5 -LineGap: 90 -VLineGap: 0 -OS2TypoAscent: 0 -OS2TypoAOffset: 1 -OS2TypoDescent: 0 -OS2TypoDOffset: 1 -OS2TypoLinegap: 90 -OS2WinAscent: 0 -OS2WinAOffset: 1 -OS2WinDescent: 0 -OS2WinDOffset: 1 -HheadAscent: 0 -HheadAOffset: 1 -HheadDescent: 0 -HheadDOffset: 1 -OS2FamilyClass: 2319 -OS2Vendor: 'PfEd' -MarkAttachClasses: 1 -DEI: 91125 -LangName: 1033 -Encoding: UnicodeFull -UnicodeInterp: none -NameList: Adobe Glyph List -DisplaySize: -24 -AntiAlias: 1 -FitToEm: 1 -WinInfo: 77904 24 18 -BeginPrivate: 0 -EndPrivate -TeXData: 1 0 0 346030 173015 115343 0 1048576 115343 783286 444596 497025 792723 393216 433062 380633 303038 157286 324010 404750 52429 2506097 1059062 262144 -BeginChars: 1114112 5 - -StartChar: A -Encoding: 65 65 0 -Width: 1000 -VWidth: 0 -HStem: 0 21G<72.5 119.695 682.5 726.5> 384 111<312.148 495.257> 777 123<264.353 535.647> -VStem: 0 139<585.021 689.951> 661 139<585.002 688.082> -LayerCount: 2 -Fore -SplineSet -139 636 m 0 - 139 558.168 255.928 495 400 495 c 0 - 544.072 495 661 558.168 661 636 c 0 - 661 713.832 544.072 777 400 777 c 0 - 255.928 777 139 713.832 139 636 c 0 -100 0 m 1 - 45 234 0 361.682 0 600 c 0 - 0 834 205 900 400 900 c 24 - 595 900 800 822 800 600 c 0 - 800 360.834 753 234 700 0 c 1 - 665 180 590.045 384 400 384 c 24 - 209.955 384 139.39 149.76 100 0 c 1 -EndSplineSet -Validated: 1 -EndChar - -StartChar: B -Encoding: 66 66 1 -Width: 1000 -VWidth: 0 -HStem: 0 91<307.884 570.044> 355 97<317.65 572.008> 724 76.4445<315.347 574.736> -VStem: 120 80<174.135 277.365 535.109 572> 694 106<173.306 274.441 532.71 643.215> -LayerCount: 2 -Fore -SplineSet -200 223 m 0 - 200 150 303 91 437 91 c 0 - 571 91 694 150 694 223 c 0 - 694 296 571 355 437 355 c 0 - 303 355 200 296 200 223 c 0 -202 588 m 0 - 202 513 312 452 448 452 c 0 - 584 452 694 513 694 588 c 0 - 694 663 584 724 448 724 c 0 - 312 724 202 663 202 588 c 0 -800 200 m 0 - 800 92 749 1 552 0 c 0 - 430 -0 253 -0 0 0 c 1 - 85 41 120 216 120 400 c 0 - 120 572 73 756 0 800 c 1 - 150 800 273.778 800.444 372.519 800.444 c 0 - 421.889 800.444 465 800.333 502 800 c 0 - 785 799 800 665 800 600 c 0 - 800 540 781 510 760 490 c 0 - 730 461 694 453 694 400 c 0 - 694 358 723 339 760 310 c 0 - 781 294 800 259 800 200 c 0 -EndSplineSet -Validated: 1 -EndChar - -StartChar: .notdef -Encoding: 0 0 2 -Width: 1000 -VWidth: 0 -HStem: 0 88<283.168 514.832> 712 88<283.168 514.832> -VStem: 0 83<285.634 514.366> 715 85<285.634 514.366> -LayerCount: 2 -Fore -SplineSet -83 400 m 0 - 83 227.776 224.568 88 399 88 c 0 - 573.432 88 715 227.776 715 400 c 0 - 715 572.224 573.432 712 399 712 c 0 - 224.568 712 83 572.224 83 400 c 0 -0 800 m 1 - 800 800 l 1 - 800 0 l 1 - 0 0 l 1 - 0 800 l 1 -EndSplineSet -Validated: 1 -Comment: "Default character" -EndChar - -StartChar: C -Encoding: 67 67 3 -Width: 1000 -VWidth: 0 -HStem: 0 110<323.65 572.264> 690 110<326.99 550.385> -VStem: 0 147<291.893 504.85> -LayerCount: 2 -Fore -SplineSet -425 110 m 0 - 564 110 687 167 788 230 c 1 - 796 230 796 230 800 230 c 1 - 800 222 800 224 800 216 c 1 - 753 98 621 -0 450 0 c 0 - 227 0 0 165 0 400 c 24 - 0 635 235 800 450 800 c 1 - 580 800 745 668 800 584 c 1 - 800 575 799 576 800 570 c 1 - 796 570 796 570 791 570 c 1 - 684 628 535 690 425 690 c 0 - 277 690 147 557 147 400 c 0 - 147 243 268 110 425 110 c 0 -EndSplineSet -Validated: 1 -EndChar - -StartChar: u13079 -Encoding: 77945 77945 4 -Width: 1000 -VWidth: 0 -HStem: 200 66<262.666 534.533> 302 196<339.508 460.492> 534 66<262.278 535.629> -VStem: 302 196<339.508 460.492> -CounterMasks: 1 e0 -LayerCount: 2 -Fore -SplineSet -302 400 m 0 - 302 454.096 345.904 498 400 498 c 0 - 454.096 498 498 454.096 498 400 c 0 - 498 345.904 454.096 302 400 302 c 0 - 345.904 302 302 345.904 302 400 c 0 -146 400 m 0 - 146 326.032 259.792 266 400 266 c 0 - 540.208 266 654 326.032 654 400 c 0 - 654 473.968 540.208 534 400 534 c 0 - 259.792 534 146 473.968 146 400 c 0 -0 400 m 1 - 124 550 225.587 600 400 600 c 24 - 574.413 600 690 532 800 400 c 1 - 720 254 574.413 200 400 200 c 24 - 225.587 200 90 234 0 400 c 1 -EndSplineSet -Validated: 1 -EndChar -EndChars -BitmapFont: 8 6 6 2 1 -BDFChar: 0 65 8 0 5 0 6 -G_CbJKS5!Y -BDFChar: 1 66 8 0 5 0 5 -r'Yd'7/R#b -BDFChar: 2 0 8 0 5 0 5 -r.K`VK_tfM -BDFChar: 3 67 8 0 5 0 5 -Gf7D5`-;7^ -BDFChar: 4 77945 8 0 5 1 4 -GdOi& -EndBitmapFont -BitmapFont: 19 6 15 4 1 -BDFChar: 0 65 19 0 14 0 16 -&)]\IGWbI:i""ZTn/h?gs8N&tr-iT)E#`6o?jo:'5Qh&e -BDFChar: 1 66 19 0 14 0 14 -s7h*AGRcD30EsKH5PRJ<5PR2J0Es38Hlde8s7cQo -BDFChar: 2 0 19 0 14 0 14 -s8N&tr-n,Vi"!O,^]qRY^]qRYi"#5tr-n\Fs8Duu -BDFChar: 3 67 19 0 14 0 14 -"5j^b4:`!'UX<3!"O`!5L8g^b>c(GQGU/#JgB>JH,TK - -BDFChar: 2 0 25 0 19 0 19 -s8VTgs7$!mnG!%Rn,Vt9!-$irE52H-^]6((!&21g0YdZB^]6(H!-$irE: 0) s = f.render("X", False, (255, 255, 255)) - self.assertAlmostEqual(s.get_height(), height, delta=3) + self.assertTrue(s.get_size()[1] == height) def test_get_linesize(self): # Checking linesize would need a custom test font to do properly. @@ -381,35 +312,6 @@ class FontTypeTest(unittest.TestCase): self.assertTrue(isinstance(linesize, int)) self.assertTrue(linesize > 0) - @unittest.skipIf( - pygame.font.get_sdl_ttf_version() < (2, 24, 0), - "supported in SDL_ttf 2.24.0 onwards", - ) - def test_set_linesize(self): - if pygame_font.__name__ == "pygame.ftfont": - return # not a pygame.ftfont thing - - f = pygame_font.Font(None, 20) - linesize = f.get_linesize() - - # check increasing linesize - f.set_linesize(linesize + 1) - self.assertEqual(f.get_linesize(), linesize + 1) - - # check random linesize - expected_linesizes = [30, 1, 22, 34, 5, 10, 0] - for expected_size in expected_linesizes: - f.set_linesize(expected_size) - self.assertEqual(f.get_linesize(), expected_size) - - # check invalid linesize - with self.assertRaises(ValueError): - f.set_linesize(-1) - with self.assertRaises(OverflowError): - f.set_linesize(2**100) - with self.assertRaises(TypeError): - f.set_linesize(12.0) - def test_metrics(self): # Ensure bytes decoding works correctly. Can only compare results # with unicode for now. @@ -422,7 +324,7 @@ class FontTypeTest(unittest.TestCase): self.assertIsNotNone(um[0]) self.assertEqual(um, bm) - u = "\u212a" + u = "\u212A" b = u.encode("UTF-16")[2:] # Keep byte order consistent. [2:] skips BOM bm = f.metrics(b) @@ -441,10 +343,7 @@ class FontTypeTest(unittest.TestCase): bm = f.metrics(u) self.assertEqual(len(bm), 1) - if pygame_font.__name__ != "pygame.ftfont": - self.assertIsNotNone(bm[0]) - else: - self.assertIsNone(bm[0]) + self.assertIsNone(bm[0]) return # unfinished # The documentation is useless here. How large a list? @@ -492,7 +391,7 @@ class FontTypeTest(unittest.TestCase): su = f.render(".", False, [0, 0, 0], [255, 255, 255]) sb = f.render(b".", False, [0, 0, 0], [255, 255, 255]) self.assertTrue(equal_images(su, sb)) - u = "\u212a" + u = "\u212A" b = u.encode("UTF-16")[2:] # Keep byte order consistent. [2:] skips BOM sb = f.render(b, False, [0, 0, 0], [255, 255, 255]) try: # FIXME why do we do this try/except ? @@ -512,7 +411,7 @@ class FontTypeTest(unittest.TestCase): # If the font module is SDL_ttf < 2.0.15 based, then it only supports UCS-2 # it will raise an exception for an out-of-range UCS-4 code point. if hasattr(pygame_font, "UCS4"): - ucs_2 = "\uffee" + ucs_2 = "\uFFEE" s = f.render(ucs_2, False, [0, 0, 0], [255, 255, 255]) ucs_4 = "\U00010000" s = f.render(ucs_4, False, [0, 0, 0], [255, 255, 255]) @@ -542,12 +441,13 @@ class FontTypeTest(unittest.TestCase): self.assertFalse(f.get_underline()) def test_set_strikethrough(self): - f = pygame_font.Font(None, 20) - self.assertFalse(f.get_strikethrough()) - f.set_strikethrough(True) - self.assertTrue(f.get_strikethrough()) - f.set_strikethrough(False) - self.assertFalse(f.get_strikethrough()) + if pygame_font.__name__ != "pygame.ftfont": + f = pygame_font.Font(None, 20) + self.assertFalse(f.get_strikethrough()) + f.set_strikethrough(True) + self.assertTrue(f.get_strikethrough()) + f.set_strikethrough(False) + self.assertFalse(f.get_strikethrough()) def test_bold_attr(self): f = pygame_font.Font(None, 20) @@ -574,31 +474,13 @@ class FontTypeTest(unittest.TestCase): self.assertFalse(f.underline) def test_set_strikethrough_property(self): - f = pygame_font.Font(None, 20) - self.assertFalse(f.strikethrough) - f.strikethrough = True - self.assertTrue(f.strikethrough) - f.strikethrough = False - self.assertFalse(f.strikethrough) - - def test_set_align_property(self): - if pygame_font.__name__ == "pygame.ftfont": - return - - f = pygame_font.Font(None, 20) - - if pygame.font.get_sdl_ttf_version() < (2, 20, 0): - with self.assertRaises(pygame.error): - f.align = pygame.FONT_CENTER - return - - self.assertEqual(f.align, pygame.FONT_LEFT) - f.align = pygame.FONT_CENTER - self.assertEqual(f.align, pygame.FONT_CENTER) - f.align = pygame.FONT_RIGHT - self.assertEqual(f.align, pygame.FONT_RIGHT) - f.align = pygame.FONT_LEFT - self.assertEqual(f.align, pygame.FONT_LEFT) + if pygame_font.__name__ != "pygame.ftfont": + f = pygame_font.Font(None, 20) + self.assertFalse(f.strikethrough) + f.strikethrough = True + self.assertTrue(f.strikethrough) + f.strikethrough = False + self.assertFalse(f.strikethrough) def test_size(self): f = pygame_font.Font(None, 20) @@ -610,116 +492,16 @@ class FontTypeTest(unittest.TestCase): self.assertIsInstance(w, int) self.assertIsInstance(h, int) - - # test width and height match, with a tolerance for 1 pixel errors - self.assertTrue(w - 1 <= s.get_width() <= w + 1) - self.assertTrue(h - 1 <= s.get_height() <= h + 1) + self.assertEqual(s.get_size(), size) self.assertEqual(f.size(btext), size) - text = "\u212a" + text = "\u212A" btext = text.encode("UTF-16")[2:] # Keep the byte order consistent. bsize = f.size(btext) size = f.size(text) self.assertNotEqual(size, bsize) - def test_point_size_property(self): - if pygame_font.__name__ == "pygame.ftfont": - return # not a pygame.ftfont feature - - pygame_font.init() - font_path = os.path.join( - os.path.split(pygame.__file__)[0], pygame_font.get_default_font() - ) - f = pygame_font.Font(pathlib.Path(font_path), 25) - self.assertEqual(25, f.point_size) - f.point_size = 10 - self.assertEqual(10, f.point_size) - f.point_size += 23 - self.assertEqual(33, f.point_size) - f.point_size -= 2 - self.assertEqual(31, f.point_size) - - def test_neg(): - f.point_size = -500 - - def test_incorrect_type(): - f.point_size = "15" - - self.assertRaises(ValueError, test_neg) - self.assertRaises(TypeError, test_incorrect_type) - - def test_point_size_method(self): - if pygame_font.__name__ == "pygame.ftfont": - return # not a pygame.ftfont feature - - pygame_font.init() - font_path = os.path.join( - os.path.split(pygame.__file__)[0], pygame_font.get_default_font() - ) - f = pygame_font.Font(pathlib.Path(font_path), 25) - - self.assertEqual(25, f.get_point_size()) - f = pygame_font.Font(None, 25) - f.set_point_size(10) - self.assertEqual(10, f.get_point_size()) - self.assertRaises(ValueError, f.set_point_size, -500) - self.assertRaises(TypeError, f.set_point_size, "15") - - def test_outline_property(self): - if pygame_font.__name__ == "pygame.ftfont": - return # not a pygame.ftfont feature - - pygame_font.init() - font_path = os.path.join( - os.path.split(pygame.__file__)[0], pygame_font.get_default_font() - ) - f = pygame_font.Font(pathlib.Path(font_path), 25) - - # Default outline should be an integer >= 0 (typically 0) - self.assertIsInstance(f.outline, int) - self.assertGreaterEqual(f.outline, 0) - - orig = f.outline - f.outline = orig + 1 - self.assertEqual(orig + 1, f.outline) - f.outline += 2 - self.assertEqual(orig + 3, f.outline) - f.outline -= 1 - self.assertEqual(orig + 2, f.outline) - - def test_neg(): - f.outline = -1 - - def test_incorrect_type(): - f.outline = "2" - - self.assertRaises(ValueError, test_neg) - self.assertRaises(TypeError, test_incorrect_type) - - def test_font_name(self): - f = pygame_font.Font(None, 20) - self.assertEqual(f.name, "FreeSans") - - def test_set_name(): - f.name = "Say my name." - - self.assertRaises(AttributeError, test_set_name) - - def test_font_style_name(self): - f = pygame_font.Font(None, 20) - self.assertNotEqual(f.style_name, "") - self.assertNotEqual(f.style_name, None) - self.assertIsInstance(f.style_name, str) - - def test_font_style_name_is_readonly(self): - f = pygame_font.Font(None, 20) - - def _set_style_name(): - f.style_name = "Say my other name." - - self.assertRaises(AttributeError, _set_style_name) - def test_font_file_not_found(self): # A per BUG reported by Bo Jangeborg on pygame-user mailing list, # http://www.mail-archive.com/pygame-users@seul.org/msg11675.html @@ -774,12 +556,6 @@ class FontTypeTest(unittest.TestCase): with open(font_path, "rb") as f: font = pygame_font.Font(f) - def test_load_from_invalid_sized_file_obj(self): - pygame.font.init() - f = io.StringIO() - with self.assertRaises(ValueError): - font = pygame.font.Font(f) - def test_load_default_font_filename(self): # In font_init, a special case is when the filename argument is # identical to the default font file name. @@ -793,12 +569,19 @@ class FontTypeTest(unittest.TestCase): def _load_unicode(self, path): import shutil - with TemporaryDirectory() as tmpdir: - fdir = str(FONTDIR) - temp = os.path.join(tmpdir, path) - pgfont = os.path.join(fdir, "test_sans.ttf") - shutil.copy(pgfont, temp) + fdir = str(FONTDIR) + temp = os.path.join(fdir, path) + pgfont = os.path.join(fdir, "test_sans.ttf") + shutil.copy(pgfont, temp) + try: + with open(temp, "rb") as f: + pass + except FileNotFoundError: + raise unittest.SkipTest("the path cannot be opened") + try: pygame_font.Font(temp, 20) + finally: + os.remove(temp) def test_load_from_file_unicode_0(self): """ASCII string as a unicode object""" @@ -820,7 +603,7 @@ class FontTypeTest(unittest.TestCase): bfont_path = font_path.encode(filesystem_encoding, filesystem_errors) f = pygame_font.Font(bfont_path, 20) - def test_issue_1587(self): + def test_issue_3144(self): fpath = os.path.join(FONTDIR, "PlayfairDisplaySemibold.ttf") # issue in SDL_ttf 2.0.18 DLL on Windows @@ -851,224 +634,9 @@ class FontTypeTest(unittest.TestCase): else: self.assertRaises(pygame.error, font.set_script, "Deva") - def test_font_set_direction(self): - if pygame_font.__name__ == "pygame.ftfont": - return # not a pygame.ftfont thing - - font = pygame_font.Font(None, 16) - - ttf_version = pygame.font.get_sdl_ttf_version() - if ttf_version >= (2, 20, 0): - self.assertRaises(TypeError, pygame.font.Font.set_direction) - self.assertRaises(TypeError, pygame.font.Font.set_direction, font) - self.assertRaises(TypeError, pygame.font.Font.set_direction, "font") - self.assertRaises(TypeError, font.set_direction, [1, 1]) - self.assertRaises(TypeError, font.set_direction, "string1", "string2") - - self.assertRaises(ValueError, font.set_direction, -1) - self.assertRaises(ValueError, font.set_direction, 4) - - font.set_direction(pygame.DIRECTION_RTL) - - else: - self.assertRaises(pygame.error, font.set_direction, pygame.DIRECTION_RTL) - - def test_font_method_should_raise_exception_after_quit(self): - # arrange - if pygame_font.__name__ == "pygame.ftfont": - surf = pygame.Surface((1, 1)) - methods = [ - ("get_sized_height", ()), - ("get_sized_ascender", ()), - ("get_sized_glyph_height", ()), - ("get_rect", ("any text",)), - ("get_metrics", ("any text",)), - ("get_sizes", ()), - ("render", ("any text", True, "white")), - ( - "render_to", - ( - surf, - (10, 11), - "text", - ), - ), # surf - ("render_raw", ("any text",)), - ( - "render_raw_to", - ( - surf.get_view("2"), - None, - ), - ), - ("get_ascent", ()), - ("get_bold", ()), - ("get_descent", ()), - ("get_height", ()), - ("get_italic", ()), - ("get_linesize", ()), - ("get_sized_descender", ()), - ("get_underline", ()), - ("metrics", ("any text",)), - ("set_bold", (True,)), - ("set_italic", (True,)), - ("set_underline", (True,)), - ("size", ("any Text",)), - ] - skip_methods = {"get_strikethrough", "set_strikethrough"} - else: - methods = [ - ("get_height", ()), - ("get_descent", ()), - ("get_ascent", ()), - ("get_linesize", ()), - ("get_bold", ()), - ("set_bold", (True,)), - ("get_italic", ()), - ("set_italic", (True,)), - ("get_underline", ()), - ("set_underline", (True,)), - ("get_strikethrough", ()), - ("set_strikethrough", (True,)), - ("metrics", ("any text",)), - ("render", ("hello", True, "white")), - ("size", ("any text",)), - ("set_script", ("is it other text",)), - ("set_direction", ("is it text",)), - ("get_point_size", ()), - ("set_point_size", (34,)), - ] - skip_methods = set() - version = pygame.font.get_sdl_ttf_version() - - if version >= (2, 24, 0): - methods.append(("set_linesize", (2,))) - else: - skip_methods.add("set_linesize") - - if version < (2, 20, 0): - skip_methods.add("align") - - font = pygame_font.Font(None, 10) - actual_names = [] - for n in sorted(dir(font)): - if n in skip_methods: - continue - if n.startswith("_"): - continue - if not callable(getattr(font, n)): - continue - actual_names.append(n) - expected_names = [n for n, a in sorted(methods)] - self.assertEqual( - len(expected_names), - len(actual_names), - msg=f"ensure all methods are checked \n{expected_names} \n!= \n{actual_names}", - ) - - for name, args in methods: - # import sys - # print("###", name,file=sys.__stdout__,flush=True) - with self.subTest(name=name): - # arrange - font = pygame_font.Font(None, 16) - pygame_font.quit() - pygame_font.init() - - # act / assert - self.assertRaises(pygame.error, getattr(font, name), *args) - - def test_font_property_should_raise_exception_after_quit(self): - if pygame_font.__name__ == "pygame.ftfont": - properties = [ - ("style", 10.5), - ("height", None), - ("ascender", None), - ("descender", None), - ("name", None), - ("style_name", None), - ("path", None), - ("scalable", None), - ("fixed_width", None), - ("fixed_sizes", None), - ("antialiased", 45), - ("kerning", 46), - ("vertical", 47), - ("pad", 48), - ("oblique", 1), - ("strong", 1), - ("underline", 1), - ("wide", 1), - ("strength", 49), - ("underline_adjustment", 50), - ("ucs4", 1), - ("use_bitmap_strikes", 1), - ("rotation", 33), - ("fgcolor", (1, 1, 1)), - ("bgcolor", (2, 2, 2)), - ("origin", None), - ("bold", True), - ("italic", True), - ("resolution", None), - ] - skip_properties = {"strikethrough"} - else: - properties = [ - ("name", None), - ("style_name", None), - ("bold", True), - ("italic", True), - ("underline", True), - ("strikethrough", True), - ("outline", 1), - ("point_size", 1), - ] - skip_properties = set() - version = pygame.font.get_sdl_ttf_version() - if version >= (2, 20, 0): - properties.append(("align", 1)) - else: - skip_properties.add("align") - - font = pygame_font.Font(None, 10) - actual_names = [] - - for n in sorted(dir(font)): - if n in skip_properties: - continue - if n.startswith("_"): - continue - if callable(getattr(font, n)): - continue - actual_names.append(n) - - expected_names = [n for n, a in sorted(properties)] - self.assertEqual( - len(expected_names), - len(actual_names), - msg=f"ensure all properties are checked \n{expected_names} \n!= \n{actual_names}", - ) - - for name, arg in properties: - # import sys - # print(">>>", name,file=sys.__stdout__,flush=True) - with self.subTest(name=name + " get"): - # arrange - font = pygame_font.Font(None, 16) - pygame_font.quit() - pygame_font.init() - - # act / assert - self.assertRaises(pygame.error, getattr, font, name) # read - - if arg is not None: - with self.subTest(name=name + " write"): - # act / assert - self.assertRaises(pygame.error, setattr, font, name, arg) # write - @unittest.skipIf(IS_PYPY, "pypy skip known failure") # TODO -class VisualTestsInteractive(unittest.TestCase): +class VisualTests(unittest.TestCase): __tags__ = ["interactive"] screen = None @@ -1094,7 +662,6 @@ class VisualTestsInteractive(unittest.TestCase): underline=False, strikethrough=False, antialiase=False, - outline=0, ): if self.aborted: return False @@ -1105,7 +672,7 @@ class VisualTestsInteractive(unittest.TestCase): screen = self.screen screen.fill((255, 255, 255)) pygame.display.flip() - if not (bold or italic or underline or strikethrough or antialiase or outline): + if not (bold or italic or underline or strikethrough or antialiase): text = "normal" else: modes = [] @@ -1119,22 +686,20 @@ class VisualTestsInteractive(unittest.TestCase): modes.append("strikethrough") if antialiase: modes.append("antialiased") - if outline: - modes.append("outlined") text = f"{'-'.join(modes)} (y/n):" f.set_bold(bold) f.set_italic(italic) f.set_underline(underline) - f.set_strikethrough(strikethrough) - f.outline = outline + if pygame_font.__name__ != "pygame.ftfont": + f.set_strikethrough(strikethrough) s = f.render(text, antialiase, (0, 0, 0)) screen.blit(s, (offset, y)) y += s.get_size()[1] + spacing f.set_bold(False) f.set_italic(False) f.set_underline(False) - f.set_strikethrough(False) - f.outline = 0 + if pygame_font.__name__ != "pygame.ftfont": + f.set_strikethrough(False) s = f.render("(some comparison text)", False, (0, 0, 0)) screen.blit(s, (offset, y)) pygame.display.flip() @@ -1162,7 +727,8 @@ class VisualTestsInteractive(unittest.TestCase): self.assertTrue(self.query(underline=True)) def test_strikethrough(self): - self.assertTrue(self.query(strikethrough=True)) + if pygame_font.__name__ != "pygame.ftfont": + self.assertTrue(self.query(strikethrough=True)) def test_antialiase(self): self.assertTrue(self.query(antialiase=True)) @@ -1174,10 +740,8 @@ class VisualTestsInteractive(unittest.TestCase): self.assertTrue(self.query(italic=True, underline=True)) def test_bold_strikethrough(self): - self.assertTrue(self.query(bold=True, strikethrough=True)) - - def test_outline(self): - self.assertTrue(self.query(outline=1)) + if pygame_font.__name__ != "pygame.ftfont": + self.assertTrue(self.query(bold=True, strikethrough=True)) if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/freetype_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/freetype_test.py index dcd9052..25551d8 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/freetype_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/freetype_test.py @@ -1,12 +1,14 @@ -import ctypes -import gc -import io import os + +if os.environ.get("SDL_VIDEODRIVER") == "dummy": + __tags__ = ("ignore", "subprocess_ignore") + +import unittest +import ctypes +import weakref +import gc import pathlib import platform -import sys -import unittest -import weakref IS_PYPY = "PyPy" == platform.python_implementation() @@ -17,7 +19,12 @@ except NameError: pass import pygame -import pygame.freetype as ft + +try: + import pygame.freetype as ft +except ImportError: + ft = None + FONTDIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "fixtures", "fonts") @@ -57,7 +64,7 @@ class FreeTypeFontTest(unittest.TestCase): def setUpClass(cls): ft.init() - # Set up the test fonts. + # Setup the test fonts. # Inconsolata is an open-source font designed by Raph Levien. # Licensed under the Open Font License. @@ -126,7 +133,7 @@ class FreeTypeFontTest(unittest.TestCase): FileNotFoundError, f.__init__, os.path.join(FONTDIR, "nonexistent.ttf") ) - # Test attribute preservation during reinitialization + # Test attribute preservation during reinitalization f = ft.Font(self._sans_path, size=24, ucs4=True) self.assertEqual(f.name, "Liberation Sans") self.assertTrue(f.scalable) @@ -154,11 +161,6 @@ class FreeTypeFontTest(unittest.TestCase): f.__init__(self._bmp_8_75dpi_path, size=12) self.assertEqual(f.size, 12.0) - def test_load_from_invalid_sized_file_obj(self): - f = io.StringIO() - with self.assertRaises(ValueError): - font = f = ft.Font(f, size=24) - @unittest.skipIf(IS_PYPY, "PyPy doesn't use refcounting") def test_freetype_Font_dealloc(self): import sys @@ -200,7 +202,7 @@ class FreeTypeFontTest(unittest.TestCase): Note: This does not test what changes occur to a rendered font by having kerning enabled. - Related to pygame-ce issue #371. + Related to issue #367. """ surface = pygame.Surface((10, 10), 0, 32) TEST_TEXT = "Freetype Font" @@ -508,11 +510,11 @@ class FreeTypeFontTest(unittest.TestCase): # one code point or two. ufont = self._TEST_FONTS["mono"] rect_utf32 = ufont.get_rect("\U00013079", size=24) - rect_utf16 = ufont.get_rect("\ud80c\udc79", size=24) + rect_utf16 = ufont.get_rect("\uD80C\uDC79", size=24) self.assertEqual(rect_utf16, rect_utf32) ufont.ucs4 = True try: - rect_utf16 = ufont.get_rect("\ud80c\udc79", size=24) + rect_utf16 = ufont.get_rect("\uD80C\uDC79", size=24) finally: ufont.ucs4 = False self.assertNotEqual(rect_utf16, rect_utf32) @@ -545,9 +547,8 @@ class FreeTypeFontTest(unittest.TestCase): f = self._TEST_FONTS["fixed"] self.assertEqual(f.name, "Inconsolata") - with self.assertRaises(AttributeError): - null_font = ft.Font.__new__(ft.Font) - null_font.name + nf = nullfont() + self.assertEqual(nf.name, repr(nf)) def test_freetype_Font_size(self): f = ft.Font(None, size=12) @@ -775,29 +776,29 @@ class FreeTypeFontTest(unittest.TestCase): ucs4 = font2.ucs4 try: font2.ucs4 = False - rend1 = font2.render("\ud80c\udc79", color, size=24) + rend1 = font2.render("\uD80C\uDC79", color, size=24) rend2 = font2.render("\U00013079", color, size=24) self.assertEqual(rend1[1], rend2[1]) font2.ucs4 = True - rend1 = font2.render("\ud80c\udc79", color, size=24) + rend1 = font2.render("\uD80C\uDC79", color, size=24) self.assertNotEqual(rend1[1], rend2[1]) finally: font2.ucs4 = ucs4 # malformed surrogate pairs - self.assertRaises(UnicodeEncodeError, font.render, "\ud80c", color, size=24) - self.assertRaises(UnicodeEncodeError, font.render, "\udca7", color, size=24) + self.assertRaises(UnicodeEncodeError, font.render, "\uD80C", color, size=24) + self.assertRaises(UnicodeEncodeError, font.render, "\uDCA7", color, size=24) self.assertRaises( - UnicodeEncodeError, font.render, "\ud7ff\udca7", color, size=24 + UnicodeEncodeError, font.render, "\uD7FF\uDCA7", color, size=24 ) self.assertRaises( - UnicodeEncodeError, font.render, "\udc00\udca7", color, size=24 + UnicodeEncodeError, font.render, "\uDC00\uDCA7", color, size=24 ) self.assertRaises( - UnicodeEncodeError, font.render, "\ud80c\udbff", color, size=24 + UnicodeEncodeError, font.render, "\uD80C\uDBFF", color, size=24 ) self.assertRaises( - UnicodeEncodeError, font.render, "\ud80c\ue000", color, size=24 + UnicodeEncodeError, font.render, "\uD80C\uE000", color, size=24 ) # raises exception when uninitialized @@ -921,17 +922,15 @@ class FreeTypeFontTest(unittest.TestCase): self.assertEqual( surf.get_at(bottomleft), fill_color, - "Position: {}. Depth: {}. fg_color: {}.".format( - bottomleft, surf.get_bitsize(), fg_color - ), + "Position: {}. Depth: {}." + " fg_color: {}.".format(bottomleft, surf.get_bitsize(), fg_color), ) bottomright = rrect.width - 1, rrect.height - 1 self.assertEqual( surf.get_at(bottomright), r_fg_color, - "Position: {}. Depth: {}. fg_color: {}.".format( - bottomright, surf.get_bitsize(), fg_color - ), + "Position: {}. Depth: {}." + " fg_color: {}.".format(bottomright, surf.get_bitsize(), fg_color), ) for i, surf in enumerate(surfaces): surf.fill(fill_color) @@ -1012,7 +1011,7 @@ class FreeTypeFontTest(unittest.TestCase): font = self._TEST_FONTS["sans"] text = "abc" - # No frills anti aliased render to int1 (__render_glyph_INT) + # No frills antialiased render to int1 (__render_glyph_INT) srect = font.get_rect(text, size=24) surf = pygame.Surface(srect.size, 0, 8) rrect = font.render_raw_to(surf.get_view("2"), text, size=24) @@ -1053,7 +1052,7 @@ class FreeTypeFontTest(unittest.TestCase): finally: font.antialiased = True - # Anti aliased render to ints sized greater than 1 byte + # Antialiased render to ints sized greater than 1 byte # (__render_glyph_INT) srect = font.get_rect(text, size=24) @@ -1244,6 +1243,7 @@ class FreeTypeFontTest(unittest.TestCase): self.assertRaises(AttributeError, setattr, f, "bgcolor", None) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") @unittest.skipIf(IS_PYPY, "pypy no likey") def test_newbuf(self): from pygame.tests.test_utils import buftools @@ -1353,10 +1353,7 @@ class FreeTypeFontTest(unittest.TestCase): def test_freetype_Font_path(self): self.assertEqual(self._TEST_FONTS["sans"].path, self._sans_path) - - with self.assertRaises(AttributeError): - nullfont = ft.Font.__new__(ft.Font) - nullfont.path + self.assertRaises(AttributeError, getattr, nullfont(), "path") # This Font cache test is conditional on freetype being built by a debug # version of Python or with the C macro PGFT_DEBUG_CACHE defined. @@ -1484,10 +1481,10 @@ class FreeTypeFontTest(unittest.TestCase): self.assertIsNone(metrics[0]) self.assertIsInstance(metrics[1], tuple) - def test_issue_257(self): - """pygame-ce issue #257: get_rect() uses 0 as default style""" + def test_issue_242(self): + """Issue #242: get_rect() uses 0 as default style""" - # pygame-ce issue #257: freetype.Font.get_rect() ignores style defaults when + # Issue #242: freetype.Font.get_rect() ignores style defaults when # the style argument is not given # # The text boundary rectangle returned by freetype.Font.get_rect() @@ -1544,10 +1541,10 @@ class FreeTypeFontTest(unittest.TestCase): finally: font.underline = prev_style - def test_issue_252(self): - """pygame-ce issue #252: Memory overrun when rendered with underlining""" + def test_issue_237(self): + """Issue #237: Memory overrun when rendered with underlining""" - # pygame-ce issue #252: Memory overrun when text without descenders is rendered + # Issue #237: Memory overrun when text without descenders is rendered # with underlining # # The bug crashes the Python interpreter. The bug is caught with C @@ -1567,10 +1564,10 @@ class FreeTypeFontTest(unittest.TestCase): font.underline_adjustment = adj s, r = font.render("Amazon", size=19) - def test_issue_258(self): - """pygame-ce issue #258: trailing space ignored in boundary calculation""" + def test_issue_243(self): + """Issue Y: trailing space ignored in boundary calculation""" - # pygame-ce issue #258: For a string with trailing spaces, freetype ignores the + # Issue #243: For a string with trailing spaces, freetype ignores the # last space in boundary calculations # font = self._TEST_FONTS["fixed"] @@ -1598,20 +1595,13 @@ class FreeTypeFontTest(unittest.TestCase): n = len(refs) self.assertTrue(n > 0) - # for pypy we perform garbage collection twice. + # for pypy we garbage collection twice. for i in range(2): gc.collect() for i in range(n): self.assertIsNone(refs[i](), "ref %d not collected" % i) - font2 = ft.Font(self._fixed_path) - ref = weakref.ref(font2) - del font2 - for i in range(2): - gc.collect() - self.assertIsNone(ref(), "ref not collected") - try: from sys import getrefcount except ImportError: @@ -1619,16 +1609,16 @@ class FreeTypeFontTest(unittest.TestCase): else: array = arrinter.Array(rect.size, "u", 1) o = font.render_raw(text) - self.assertIn(getrefcount(o), (1, 2)) + self.assertEqual(getrefcount(o), 2) self.assertEqual(getrefcount(o[0]), 2) self.assertEqual(getrefcount(o[1]), 2) self.assertEqual(getrefcount(font.render_raw_to(array, text)), 1) o = font.get_metrics("AB") - self.assertIn(getrefcount(o), (1, 2)) + self.assertEqual(getrefcount(o), 2) for i in range(len(o)): self.assertEqual(getrefcount(o[i]), 2, "refcount fail for item %d" % i) o = font.get_sizes() - self.assertIn(getrefcount(o), (1, 2)) + self.assertEqual(getrefcount(o), 2) for i in range(len(o)): self.assertEqual(getrefcount(o[i]), 2, "refcount fail for item %d" % i) @@ -1636,7 +1626,7 @@ class FreeTypeFontTest(unittest.TestCase): """Font.render_to() on a closed display surface""" # The Font.render_to() method checks that PySurfaceObject.surf is NULL - # and raise an exception if it is. This fixes a bug in Pygame revision + # and raise a exception if it is. This fixes a bug in Pygame revision # 0600ea4f1cfb and earlier where Pygame segfaults instead. null_surface = pygame.Surface.__new__(pygame.Surface) f = self._TEST_FONTS["sans"] @@ -1703,7 +1693,7 @@ class FreeTypeFontTest(unittest.TestCase): self.assertEqual(font_name_2, font_name) # Check mixed list of bytes and string. - names = [fonts_b[i] if i % 2 else str_font for i, str_font in enumerate(fonts)] + names = [fonts[0], fonts_b[1], fonts[2], fonts_b[3]] font_name_2 = ft.SysFont(names, size).name self.assertEqual(font_name_2, font_name) @@ -1774,10 +1764,6 @@ class FreeTypeTest(unittest.TestCase): # Test if get_init() gets the init state. self.assertTrue(ft.get_init()) - def test_was_init_deprecated(self): - with self.assertWarns(DeprecationWarning): - self.assertTrue(ft.was_init()) - def test_cache_size(self): DEFAULT_CACHE_SIZE = 64 self.assertEqual(ft.get_cache_size(), DEFAULT_CACHE_SIZE) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/ftfont_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/ftfont_test.py index d737aef..cda708b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/ftfont_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/ftfont_test.py @@ -1,11 +1,10 @@ -import os import sys +import os import unittest +from pygame.tests import font_test import pygame.ftfont -from . import font_test - font_test.pygame_font = pygame.ftfont for name in dir(font_test): diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/geometry_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/geometry_test.py deleted file mode 100644 index 606fc08..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/geometry_test.py +++ /dev/null @@ -1,2253 +0,0 @@ -import math -import unittest -from math import sqrt - -from pygame import FRect, Rect, Vector2, Vector3 -from pygame.geometry import Circle, Line - - -def float_range(a, b, step): - result = [] - current_value = a - while current_value < b: - result.append(current_value) - current_value += step - return result - - -class CircleTypeTest(unittest.TestCase): - def testConstruction_invalid_type(self): - """Checks whether passing wrong types to the constructor - raises the appropriate errors - """ - invalid_types = (None, [], "1", (1,), [1, 2, 3], Vector2(1, 1)) - - # Test x - for value in invalid_types: - with self.assertRaises(TypeError): - c = Circle(value, 0, 1) - # Test y - for value in invalid_types: - with self.assertRaises(TypeError): - c = Circle(0, value, 1) - # Test r - for value in invalid_types + (-1,): - with self.assertRaises(TypeError): - c = Circle(0, 0, value) - - def test2ndConstruction_invalid_type(self): - """Checks whether passing wrong types to the 2nd constructor - raises the appropriate errors - """ - invalid_types = (None, [], "1", (1,), [1, 2, 3], Vector2(1, 1)) - - # Test x - for value in invalid_types: - with self.assertRaises(TypeError): - c = Circle((value, 0), 1) - # Test y - for value in invalid_types: - with self.assertRaises(TypeError): - c = Circle((0, value), 1) - # Test r - for value in invalid_types + (-1,): - with self.assertRaises(TypeError): - c = Circle((0, 0), value) - - def testConstruction_invalid_arguments_number(self): - """Checks whether passing the wrong number of arguments to the constructor - raises the appropriate errors - """ - arguments = ( - (1,), # one non vec3 non circle arg - (1, 1, 1, 1), # four args - ) - - for arg_seq in arguments: - with self.assertRaises(TypeError): - c = Circle(*arg_seq) - - def testConstructionXYR_float(self): - c = Circle(1.0, 2.0, 3.0) - - self.assertEqual(1.0, c.x) - self.assertEqual(2.0, c.y) - self.assertEqual(3.0, c.r) - - def testConstructionTUP_XYR_float(self): - c = Circle((1.0, 2.0, 3.0)) - - self.assertEqual(1.0, c.x) - self.assertEqual(2.0, c.y) - self.assertEqual(3.0, c.r) - - def testConstructionXYR_int(self): - c = Circle(1, 2, 3) - - self.assertEqual(1.0, c.x) - self.assertEqual(2.0, c.y) - self.assertEqual(3.0, c.r) - - def testConstructionTUP_XYR_int(self): - c = Circle((1, 2, 3)) - - self.assertEqual(1.0, c.x) - self.assertEqual(2.0, c.y) - self.assertEqual(3.0, c.r) - - def testConstruction_zero_radius(self): - c = Circle(1, 2, 0) - - self.assertEqual(1.0, c.x) - self.assertEqual(2.0, c.y) - self.assertEqual(0, c.r) - - def test_x(self): - """Ensures changing the x attribute moves the circle and does not change - the circle's radius. - """ - expected_x = 10.0 - expected_y = 2.0 - expected_radius = 5.0 - c = Circle(1, expected_y, expected_radius) - - c.x = expected_x - - self.assertEqual(c.x, expected_x) - self.assertEqual(c.y, expected_y) - self.assertEqual(c.r, expected_radius) - - def test_x__invalid_value(self): - """Ensures the x attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.x = value - - def test_x__del(self): - """Ensures the x attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.x - - def test_y(self): - """Ensures changing the y attribute moves the circle and does not change - the circle's radius. - """ - expected_x = 10.0 - expected_y = 2.0 - expected_radius = 5.0 - c = Circle(expected_x, 1, expected_radius) - - c.y = expected_y - - self.assertEqual(c.x, expected_x) - self.assertEqual(c.y, expected_y) - self.assertEqual(c.r, expected_radius) - - def test_y__invalid_value(self): - """Ensures the y attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.y = value - - def test_y__del(self): - """Ensures the y attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.y - - def test_r(self): - """Ensures changing the r attribute changes the radius without moving the circle.""" - expected_x = 10.0 - expected_y = 2.0 - expected_radius = 5.0 - c = Circle(expected_x, expected_y, 1.0) - - c.r = expected_radius - - self.assertEqual(c.x, expected_x) - self.assertEqual(c.y, expected_y) - self.assertEqual(c.r, expected_radius) - - c.radius = expected_radius - self.assertEqual(c.x, expected_x) - self.assertEqual(c.y, expected_y) - self.assertEqual(c.radius, expected_radius) - - def test_r__invalid_value(self): - """Ensures the r attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.r = value - with self.assertRaises(TypeError): - c.radius = value - - for value in (-10.3234, -1): - with self.assertRaises(ValueError): - c.r = value - with self.assertRaises(ValueError): - c.radius = value - - def test_r__del(self): - """Ensures the r attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.r - - with self.assertRaises(AttributeError): - del c.radius - - def test_r_sqr(self): - """Ensures setting the r_sqr attribute matches the r_sqr passed""" - expected_r_sqr = 10.0 - c = Circle(1.0, 1.0, 1.0) - c.r_sqr = expected_r_sqr - - self.assertAlmostEqual(c.r_sqr, expected_r_sqr, places=14) - - def test_r_to_r_sqr(self): - """Ensures changing the r attribute correctly changes the r_sqr attribute.""" - expected_r_sqr = 1.0 - expected_r_sqr2 = 100.0 - - c = Circle(0, 0, 23) - c2 = Circle(0, 0, 4) - - c.r = 1 - self.assertEqual(c.r_sqr, expected_r_sqr) - - c2.r = 10 - self.assertEqual(c2.r_sqr, expected_r_sqr2) - - def test_r_sqr_to_r(self): - """Ensures changing the r_sqr attribute correctly changes the r attribute.""" - expected_r = 2.0 - - c = Circle(0, 0, 23) - - c.r_sqr = 4.0 - self.assertEqual(c.r, expected_r) - self.assertEqual(c.radius, expected_r) - - c.r_sqr = 13.33421 - self.assertEqual(c.r, sqrt(13.33421)) - self.assertEqual(c.radius, sqrt(13.33421)) - - def test_r_sqr__invalid_set(self): - """Ensures the r_sqr attribute can't be set""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.r_sqr = value - - def test_r_sqr__del(self): - """Ensures the r attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.r - - def test_center(self): - """Ensures changing the center moves the circle and does not change - the circle's radius. - """ - expected_x = 10.3 - expected_y = 2.12 - expected_radius = 5.0 - c = Circle(1, 1, expected_radius) - - c.center = (expected_x, expected_y) - - self.assertEqual(c.x, expected_x) - self.assertEqual(c.y, expected_y) - self.assertEqual(c.r, expected_radius) - - def test_center_update(self): - """Ensures changing the x or y value of the circle correctly updates the center.""" - expected_x = 10.3 - expected_y = 2.12 - expected_radius = 5.0 - c = Circle(1, 1, expected_radius) - - c.x = expected_x - self.assertEqual(c.center, (expected_x, c.y)) - - c.y = expected_y - self.assertEqual(c.center, (c.x, expected_y)) - - def test_center_invalid_value(self): - """Ensures the center attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.center = value - - def test_center_del(self): - """Ensures the center attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.center - - def test_top(self): - """Ensures changing the top attribute moves the circle and does not change the circle's radius.""" - expected_radius = 5.0 - - for pos in [ - (1, 0), - (0, 0), - (-1, 0), - (0, -1), - (1, 1), - (-1, -1), - (-1, 1), - (1, -1), - ]: - c = Circle((0, 0), expected_radius) - - c.top = pos - - self.assertEqual(pos[0], c.x) - self.assertEqual(pos[1], c.y - expected_radius) - - self.assertEqual(expected_radius, c.r) - - def test_top_update(self): - """Ensures changing the x or y value of the circle correctly updates the top.""" - expected_x = 10.3 - expected_y = 2.12 - expected_radius = 5.0 - c = Circle(1, 1, expected_radius) - - c.x = expected_x - self.assertEqual(c.top, (expected_x, c.y - expected_radius)) - - c.y = expected_y - self.assertEqual(c.top, (c.x, expected_y - expected_radius)) - - def test_top_invalid_value(self): - """Ensures the top attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3], True, False): - with self.assertRaises(TypeError): - c.top = value - - def test_top_del(self): - """Ensures the top attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.top - - def test_left(self): - """Ensures changing the left attribute moves the circle and does not change the circle's radius.""" - expected_radius = 5.0 - - for pos in [ - (1, 0), - (0, 0), - (-1, 0), - (0, -1), - (1, 1), - (-1, -1), - (-1, 1), - (1, -1), - ]: - c = Circle((0, 0), expected_radius) - - c.left = pos - - self.assertEqual(pos[0], c.x - expected_radius) - self.assertEqual(pos[1], c.y) - - self.assertEqual(expected_radius, c.r) - - def test_left_update(self): - """Ensures changing the x or y value of the circle correctly updates the left.""" - expected_x = 10.3 - expected_y = 2.12 - expected_radius = 5.0 - c = Circle(1, 1, expected_radius) - - c.x = expected_x - self.assertEqual(c.left, (expected_x - expected_radius, c.y)) - - c.y = expected_y - self.assertEqual(c.left, (c.x - expected_radius, expected_y)) - - def test_left_invalid_value(self): - """Ensures the left attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3], True, False): - with self.assertRaises(TypeError): - c.left = value - - def test_left_del(self): - """Ensures the left attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.left - - def test_right(self): - """Ensures changing the right attribute moves the circle and does not change the circle's radius.""" - expected_radius = 5.0 - - for pos in [ - (1, 0), - (0, 0), - (-1, 0), - (0, -1), - (1, 1), - (-1, -1), - (-1, 1), - (1, -1), - ]: - c = Circle((0, 0), expected_radius) - - c.right = pos - - self.assertEqual(pos[0], c.x + expected_radius) - self.assertEqual(pos[1], c.y) - - self.assertEqual(expected_radius, c.r) - - def test_right_update(self): - """Ensures changing the x or y value of the circle correctly updates the right.""" - expected_x = 10.3 - expected_y = 2.12 - expected_radius = 5.0 - c = Circle(1, 1, expected_radius) - - c.x = expected_x - self.assertEqual(c.right, (expected_x + expected_radius, c.y)) - - c.y = expected_y - self.assertEqual(c.right, (c.x + expected_radius, expected_y)) - - def test_right_invalid_value(self): - """Ensures the right attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3], True, False): - with self.assertRaises(TypeError): - c.right = value - - def test_right_del(self): - """Ensures the right attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.right - - def test_bottom(self): - """Ensures changing the bottom attribute moves the circle and does not change the circle's radius.""" - expected_radius = 5.0 - - for pos in [ - (1, 0), - (0, 0), - (-1, 0), - (0, -1), - (1, 1), - (-1, -1), - (-1, 1), - (1, -1), - ]: - c = Circle((0, 0), expected_radius) - - c.bottom = pos - - self.assertEqual(pos[0], c.x) - self.assertEqual(pos[1], c.y + expected_radius) - - self.assertEqual(expected_radius, c.r) - - def test_bottom_update(self): - """Ensures changing the x or y value of the circle correctly updates the bottom.""" - expected_x = 10.3 - expected_y = 2.12 - expected_radius = 5.0 - c = Circle(1, 1, expected_radius) - - c.x = expected_x - self.assertEqual(c.bottom, (expected_x, c.y + expected_radius)) - - c.y = expected_y - self.assertEqual(c.bottom, (c.x, expected_y + expected_radius)) - - def test_bottom_invalid_value(self): - """Ensures the bottom attribute handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3], True, False): - with self.assertRaises(TypeError): - c.bottom = value - - def test_bottom_del(self): - """Ensures the bottom attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.bottom - - def test_area(self): - """Ensures the area is calculated correctly.""" - c = Circle(0, 0, 1) - - self.assertEqual(c.area, math.pi) - - def test_area_update(self): - """Ensures the area is updated correctly.""" - c = Circle(0, 0, 1) - - c.r = 2 - self.assertEqual(c.area, math.pi * 4) - - c.r_sqr = 100 - self.assertEqual(c.area, math.pi * (10**2)) - - def test_area_invalid_value(self): - """Ensures the area handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.area = value - - for value in (-10.3234, -1): - with self.assertRaises(ValueError): - c.area = value - - def test_area_del(self): - """Ensures the area attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.area - - def test_circumference(self): - """Ensures the circumference is calculated correctly.""" - c = Circle(0, 0, 1) - - self.assertEqual(c.circumference, math.tau) - - def test_circumference_update(self): - """Ensures the circumference is updated correctly.""" - c = Circle(0, 0, 1) - - c.r = 2 - self.assertEqual(c.circumference, math.tau * 2) - - c.r_sqr = 100 - self.assertEqual(c.circumference, math.tau * 10) - - def test_circumference_invalid_value(self): - """Ensures the circumference handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.circumference = value - - for value in (-10.3234, -1): - with self.assertRaises(ValueError): - c.circumference = value - - def test_circumference_del(self): - """Ensures the circumference attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.circumference - - def test_diameter(self): - """Ensures the diameter is calculated correctly.""" - c = Circle(0, 0, 1) - - self.assertEqual(c.diameter, 2.0) - self.assertEqual(c.d, 2.0) - - def test_diameter_update(self): - """Ensures the diameter is updated correctly.""" - c = Circle(0, 0, 1) - - c.r = 2 - self.assertEqual(c.diameter, 4.0) - self.assertEqual(c.d, 4.0) - - c.r_sqr = 100 - self.assertEqual(c.diameter, 20.0) - self.assertEqual(c.d, 20.0) - - def test_diameter_invalid_value(self): - """Ensures the diameter handles invalid values correctly.""" - c = Circle(0, 0, 1) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - c.diameter = value - - for value in (-10.3234, -1): - with self.assertRaises(ValueError): - c.diameter = value - with self.assertRaises(ValueError): - c.d = value - - def test_diameter_del(self): - """Ensures the diameter attribute can't be deleted.""" - c = Circle(0, 0, 1) - - with self.assertRaises(AttributeError): - del c.diameter - - with self.assertRaises(AttributeError): - del c.d - - def test__str__(self): - """Checks whether the __str__ method works correctly.""" - c_str = "Circle((10.3, 3.2), 4.3)" - circle = Circle((10.3, 3.2), 4.3) - self.assertEqual(str(circle), c_str) - self.assertEqual(circle.__str__(), c_str) - - def test__repr__(self): - """Checks whether the __repr__ method works correctly.""" - c_repr = "Circle((10.3, 3.2), 4.3)" - circle = Circle((10.3, 3.2), 4.3) - self.assertEqual(repr(circle), c_repr) - self.assertEqual(circle.__repr__(), c_repr) - - def test_copy(self): - c = Circle(10, 10, 4) - # check 1 arg passed - with self.assertRaises(TypeError): - c.copy(10) - - # check copied circle has the same attribute values - c_2 = c.copy() - self.assertEqual(c.x, c_2.x) - self.assertEqual(c.y, c_2.y) - self.assertEqual(c.r, c_2.r) - - # check c2 is not c - self.assertIsNot(c_2, c) - - def test_collidepoint_argtype(self): - """tests if the function correctly handles incorrect types as parameters""" - invalid_types = (None, [], "1", (1,), Vector3(1, 1, 1), 1) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.collidepoint(value) - - def test_collidepoint_argnum(self): - c = Circle(10, 10, 4) - args = [tuple(range(x)) for x in range(3, 13)] - - # no params - with self.assertRaises(TypeError): - c.collidepoint() - - # too many params - for arg in args: - with self.assertRaises(TypeError): - c.collidepoint(*arg) - - def test_collidepoint(self): - c = Circle(0, 0, 5) - - p1 = (3, 3) - p2 = (10, 10) - p3 = Vector2(3, 3) - p4 = Vector2(10, 10) - - # colliding single - self.assertTrue(c.collidepoint(p1), "Expected True, point should collide here") - self.assertTrue(c.collidepoint(p3), "Expected True, point should collide here") - - # not colliding single - self.assertFalse( - c.collidepoint(p2), "Expected False, point should not collide here" - ) - self.assertFalse( - c.collidepoint(p4), "Expected False, point should not collide here" - ) - - # colliding 2 args - self.assertTrue( - c.collidepoint(3, 3), "Expected True, point should collide here" - ) - - # not colliding 2 args - self.assertFalse( - c.collidepoint(10, 10), "Expected False, point should not collide here" - ) - - def test_collidecircle_argtype(self): - """tests if the function correctly handles incorrect types as parameters""" - invalid_types = (None, [], "1", (1,), Vector2(1, 1), 1) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.collidecircle(value) - - def test_collidecircle_argnum(self): - c = Circle(10, 10, 4) - # no params - with self.assertRaises(TypeError): - c.collidecircle() - - with self.assertRaises(TypeError): - c.collidecircle(Circle(10, 10, 4), Circle(10, 10, 4)) - - def test_collidecircle(self): - c = Circle(0, 0, 5) - c_same = c.copy() - c2 = Circle(10, 0, 5) - c3 = Circle(100, 100, 5) - c4 = Circle(10, 0, 4.999999999999) - c5 = Circle(0, 0, 2) - - c6 = Circle(10, 0, 7) - - # touching - self.assertTrue( - c.collidecircle(c2), "Expected True, circles should collide here" - ) - - # partly colliding - self.assertTrue( - c.collidecircle(c6), "Expected True, circles should collide here" - ) - - # self colliding - self.assertTrue( - c.collidecircle(c), "Expected True, circles should collide with self" - ) - - # completely colliding - self.assertTrue( - c.collidecircle(c_same), "Expected True, circles should collide with self" - ) - - # not touching - self.assertFalse( - c.collidecircle(c3), "Expected False, circles should not collide here" - ) - - # barely not touching - self.assertFalse( - c.collidecircle(c4), "Expected False, circles should not collide here" - ) - - # small circle inside big circle - self.assertTrue( - c.collidecircle(c5), "Expected True, circles should collide here" - ) - - # big circle outside small circle - self.assertTrue( - c5.collidecircle(c), "Expected False, circles should collide here" - ) - - def test_colliderect_argtype(self): - """tests if the function correctly handles incorrect types as parameters""" - invalid_types = (None, [], "1", (1,), Vector3(1, 1, 1), 1, True, False) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.colliderect(value) - - def test_colliderect_argnum(self): - """tests if the function correctly handles incorrect number of parameters""" - c = Circle(10, 10, 4) - args = [(1), (1, 1), (1, 1, 1), (1, 1, 1, 1, 1)] - # no params - with self.assertRaises(TypeError): - c.colliderect() - - # invalid num - for arg in args: - with self.assertRaises(TypeError): - c.colliderect(*arg) - - def test_colliderect(self): - """ensures the function correctly detects collisions with rects""" - - msgt = "Expected True, rect should collide here" - msgf = "Expected False, rect should not collide here" - # ==================================================== - c = Circle(0, 0, 5) - - r1, r2, r3 = Rect(2, 2, 4, 4), Rect(10, 15, 43, 24), Rect(0, 5, 4, 4) - fr1, fr2, fr3 = FRect(r1), FRect(r2), FRect(r3) - - # colliding single - for r in (r1, fr1): - self.assertTrue(c.colliderect(r), msgt) - - # not colliding single - for r in (r2, fr2): - self.assertFalse(c.colliderect(r), msgf) - - # barely colliding single - for r in (r3, fr3): - self.assertTrue(c.colliderect(r), msgt) - - # colliding 4 args - self.assertTrue(c.colliderect(2, 2, 4, 4), msgt) - - # not colliding 4 args - self.assertFalse(c.colliderect(10, 15, 43, 24), msgf) - - # barely colliding single - self.assertTrue(c.colliderect(0, 4.9999999999999, 4, 4), msgt) - - # ensure FRects aren't truncated - c2 = Circle(0, 0, 0.35) - c3 = Circle(2, 0, 0.65) - fr9 = FRect(0.4, 0.0, 1, 1) - self.assertFalse(c2.colliderect(fr9), msgf) - self.assertFalse(c2.colliderect(0.4, 0.0, 1, 1), msgf) - self.assertFalse(c2.colliderect((0.4, 0.0), (1, 1)), msgf) - - self.assertTrue(c3.colliderect(fr9), msgt) - self.assertTrue(c3.colliderect(0.4, 0.0, 1, 1), msgt) - self.assertTrue(c3.colliderect((0.4, 0.0), (1, 1)), msgt) - - def test_collideswith_argtype(self): - """tests if the function correctly handles incorrect types as parameters""" - invalid_types = (None, [], "1", (1,), Vector3(1, 1, 1), 1) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.collideswith(value) - - def test_collideswith_argnum(self): - c = Circle(10, 10, 4) - args = [tuple(range(x)) for x in range(2, 4)] - - # no params - with self.assertRaises(TypeError): - c.collideswith() - - # too many params - for arg in args: - with self.assertRaises(TypeError): - c.collideswith(*arg) - - def test_collideswith(self): - """Ensures the collideswith function correctly registers collisions with circles, lines, rects and points""" - c = Circle(0, 0, 5) - - # circle - c2 = Circle(0, 10, 15) - c3 = Circle(100, 100, 1) - self.assertTrue(c.collideswith(c2)) - self.assertFalse(c.collideswith(c3)) - - # rect - r = Rect(0, 0, 10, 10) - r2 = Rect(50, 0, 10, 10) - self.assertTrue(c.collideswith(r)) - self.assertFalse(c.collideswith(r2)) - - # rect - r = FRect(0, 0, 10, 10) - r2 = FRect(50, 0, 10, 10) - self.assertTrue(c.collideswith(r)) - self.assertFalse(c.collideswith(r2)) - - # point - p = (0, 0) - p2 = (50, 0) - self.assertTrue(c.collideswith(p)) - self.assertFalse(c.collideswith(p2)) - - def test_collidelist_argtype(self): - """Tests if the function correctly handles incorrect types as parameters""" - - invalid_types = (None, "1", (1,), 1, (1, 2, 3), True, False) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.collidelist(value) - - def test_collidelist_argnum(self): - """Tests if the function correctly handles incorrect number of parameters""" - c = Circle(10, 10, 4) - - circles = [(Circle(10, 10, 4), Circle(10, 10, 4))] - - with self.assertRaises(TypeError): - c.collidelist() - - with self.assertRaises(TypeError): - c.collidelist(circles, 1) - - def test_collidelist_return_type(self): - """Tests if the function returns the correct type""" - c = Circle(10, 10, 4) - - objects = [ - Circle(10, 10, 4), - Rect(10, 10, 4, 4), - ] - - for object in objects: - self.assertIsInstance(c.collidelist([object]), int) - - def test_collidelist(self): - """Ensures that the collidelist method works correctly""" - c = Circle(10, 10, 4) - - circles = [Circle(1000, 1000, 2), Circle(5, 10, 5), Circle(16, 10, 7)] - rects = [Rect(1000, 1000, 4, 4), Rect(1000, 200, 5, 5), Rect(5, 10, 7, 3)] - points = [(-10, -10), Vector2(1, 1), Vector2(10, -20), (10, 10)] - expected = [1, 2, 3] - - for objects, expected in zip([circles, rects, points], expected): - self.assertEqual(c.collidelist(objects), expected) - - def test_collidelistall_argtype(self): - """Tests if the function correctly handles incorrect types as parameters""" - - invalid_types = (None, "1", (1,), 1, (1, 2, 3), True, False) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.collidelistall(value) - - def test_collidelistall_argnum(self): - """Tests if the function correctly handles incorrect number of parameters""" - c = Circle(10, 10, 4) - - circles = [(Circle(10, 10, 4), Circle(10, 10, 4))] - - with self.assertRaises(TypeError): - c.collidelistall() - - with self.assertRaises(TypeError): - c.collidelistall(circles, 1) - - def test_collidelistall_return_type(self): - """Tests if the function returns the correct type""" - c = Circle(10, 10, 4) - - objects = [ - Circle(10, 10, 4), - Rect(10, 10, 4, 4), - (10, 10), - Vector2(9, 9), - ] - - for object in objects: - self.assertIsInstance(c.collidelistall([object]), list) - - def test_collidelistall(self): - """Ensures that the collidelistall method works correctly""" - c = Circle(10, 10, 4) - - circles = [Circle(1000, 1000, 2), Circle(5, 10, 5), Circle(16, 10, 7)] - rects = [Rect(1000, 1000, 4, 4), Rect(1000, 200, 5, 5), Rect(5, 10, 7, 3)] - points = [Vector2(-10, -10), (8, 8), (10, -20), Vector2(10, 10)] - expected = [[1, 2], [2], [1, 3]] - - for objects, expected in zip([circles, rects, points], expected): - self.assertEqual(c.collidelistall(objects), expected) - - def test_update(self): - """Ensures that updating the circle position - and dimension correctly updates position and dimension""" - c = Circle(0, 0, 10) - - c.update(5, 5, 3) - - self.assertEqual(c.x, 5.0) - self.assertEqual(c.y, 5.0) - self.assertEqual(c.r, 3.0) - self.assertEqual(c.r_sqr, 9.0) - - def test_update_argtype(self): - """tests if the function correctly handles incorrect types as parameters""" - invalid_types = (None, [], "1", (1,), Vector2(1, 1), 1, 0.2324) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.update(value) - - def test_update_argnum(self): - c = Circle(10, 10, 4) - - # no params - with self.assertRaises(TypeError): - c.update() - - # too many params - with self.assertRaises(TypeError): - c.update(1, 1, 1, 1) - - def test_update_twice(self): - """Ensures that updating the circle position - and dimension correctly updates position and dimension""" - c = Circle(0, 0, 10) - - c.update(5, 5, 3) - c.update(0, 0, 10) - - self.assertEqual(c.x, 0.0) - self.assertEqual(c.y, 0.0) - self.assertEqual(c.r, 10) - self.assertEqual(c.r_sqr, 100) - - def test_update_inplace(self): - """Ensures that updating the circle to its position doesn't - move the circle to another position""" - c = Circle(0, 0, 10) - centerx = c.x - centery = c.y - c_r = c.r - c_r_sqr = c.r_sqr - - c.update(0, 0, 10) - - self.assertEqual(c.x, centerx) - self.assertEqual(c.y, centery) - self.assertEqual(c.r, c_r) - self.assertEqual(c.r_sqr, c_r_sqr) - - c.update(c) - - def test_selfupdate(self): - """Ensures that updating the circle to its position doesn't - move the circle to another position""" - c = Circle(0, 0, 10) - centerx = c.x - centery = c.y - c_r = c.r - c_r_sqr = c.r_sqr - - c.update(c) - - self.assertEqual(c.x, centerx) - self.assertEqual(c.y, centery) - self.assertEqual(c.r, c_r) - self.assertEqual(c.r_sqr, c_r_sqr) - - def test_as_rect_invalid_args(self): - c = Circle(0, 0, 10) - - invalid_args = [None, [], "1", (1,), Vector2(1, 1), 1] - - with self.assertRaises(TypeError): - for arg in invalid_args: - c.as_rect(arg) - - def test_as_rect(self): - c = Circle(0, 0, 10) - self.assertEqual(c.as_rect(), Rect(-10, -10, 20, 20)) - - def test_as_frect_invalid_args(self): - c = Circle(0, 0, 10) - - invalid_args = [None, [], "1", (1,), Vector2(1, 1), 1] - - with self.assertRaises(TypeError): - for arg in invalid_args: - c.as_frect(arg) - - def test_as_frect(self): - c = Circle(0, 0, 10) - self.assertEqual(c.as_frect(), FRect(-10, -10, 20, 20)) - - def test_circle_richcompare(self): - """Ensures that the circle correctly compares itself to other circles""" - c = Circle(0, 0, 10) - c2 = Circle(0, 0, 10) - c3 = Circle(0, 0, 5) - c4 = Circle(0, 0, 20) - - self.assertTrue(c == c2) - self.assertFalse(c != c2) - - self.assertFalse(c == c3) - self.assertTrue(c != c3) - - self.assertFalse(c == c4) - self.assertTrue(c != c4) - - # self compare - self.assertTrue(c == c) - self.assertFalse(c != c) - - # not implemented compare - with self.assertRaises(TypeError): - c > c2 - with self.assertRaises(TypeError): - c < c2 - with self.assertRaises(TypeError): - c >= c2 - with self.assertRaises(TypeError): - c <= c2 - - # invalid types - invalid_types = ( - None, - [], - "1", - (1,), - Vector2(1, 1), - 1, - 0.2324, - Rect(0, 0, 10, 10), - True, - ) - - for value in invalid_types: - self.assertFalse(c == value) - self.assertTrue(c != value) - with self.assertRaises(TypeError): - c > value - with self.assertRaises(TypeError): - c < value - with self.assertRaises(TypeError): - c >= value - with self.assertRaises(TypeError): - c <= value - - def test_move_invalid_args(self): - """tests if the function correctly handles incorrect types as parameters""" - invalid_types = (None, [], "1", (1,), Vector3(1, 1, 3), Circle(3, 3, 1)) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.move(value) - - def test_move_argnum(self): - c = Circle(10, 10, 4) - - invalid_args = [(1, 1, 1), (1, 1, 1, 1)] - - for arg in invalid_args: - with self.assertRaises(TypeError): - c.move(*arg) - - def test_move_return_type(self): - c = Circle(10, 10, 4) - - class CircleSub(Circle): - pass - - cs = CircleSub(10, 10, 4) - - self.assertIsInstance(c.move(1, 1), Circle) - self.assertIsInstance(cs.move(1, 1), CircleSub) - - def test_move(self): - """Ensures that moving the circle position correctly updates position""" - c = Circle(0, 0, 3) - - new_c = c.move(5, 5) - - self.assertEqual(new_c.x, 5.0) - self.assertEqual(new_c.y, 5.0) - self.assertEqual(new_c.r, 3.0) - self.assertEqual(new_c.r_sqr, 9.0) - - new_c = new_c.move(-5, -10) - - self.assertEqual(new_c.x, 0.0) - self.assertEqual(new_c.y, -5.0) - - def test_move_inplace(self): - """Ensures that moving the circle position by 0, 0 doesn't move the circle""" - c = Circle(1, 1, 3) - - c.move(0, 0) - - self.assertEqual(c.x, 1.0) - self.assertEqual(c.y, 1.0) - self.assertEqual(c.r, 3.0) - self.assertEqual(c.r_sqr, 9.0) - - def test_move_equality(self): - """Ensures that moving the circle by 0, 0 will - return a circle that's equal to the original""" - c = Circle(1, 1, 3) - - new_c = c.move(0, 0) - - self.assertEqual(new_c, c) - - def test_move_ip_invalid_args(self): - """tests if the function correctly handles incorrect types as parameters""" - invalid_types = (None, [], "1", (1,), Vector3(1, 1, 3), Circle(3, 3, 1)) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.move_ip(value) - - def test_move_ip_argnum(self): - """tests if the function correctly handles incorrect number of args""" - c = Circle(10, 10, 4) - - invalid_args = [(1, 1, 1), (1, 1, 1, 1)] - - for arg in invalid_args: - with self.assertRaises(TypeError): - c.move_ip(*arg) - - def test_move_ip(self): - """Ensures that moving the circle position correctly updates position""" - c = Circle(0, 0, 3) - - c.move_ip(5, 5) - - self.assertEqual(c.x, 5.0) - self.assertEqual(c.y, 5.0) - self.assertEqual(c.r, 3.0) - self.assertEqual(c.r_sqr, 9.0) - - c.move_ip(-5, -10) - self.assertEqual(c.x, 0.0) - self.assertEqual(c.y, -5.0) - - def test_move_ip_inplace(self): - """Ensures that moving the circle position by 0, 0 doesn't move the circle""" - c = Circle(1, 1, 3) - - c.move_ip(0, 0) - - self.assertEqual(c.x, 1.0) - self.assertEqual(c.y, 1.0) - self.assertEqual(c.r, 3.0) - self.assertEqual(c.r_sqr, 9.0) - - def test_move_ip_equality(self): - """Ensures that moving the circle by 0, 0 will - return a circle that's equal to the original""" - c = Circle(1, 1, 3) - - c.move_ip(0, 0) - - self.assertEqual(c, Circle(1, 1, 3)) - - def test_move_ip_return_type(self): - """Ensures that the move_ip method returns None""" - c = Circle(10, 10, 4) - - class CircleSub(Circle): - pass - - cs = CircleSub(10, 10, 4) - - self.assertEqual(type(c.move_ip(1, 1)), type(None)) - self.assertEqual(type(cs.move_ip(1, 1)), type(None)) - - def test_meth_rotate_ip_invalid_argnum(self): - """Ensures that the rotate_ip method correctly deals with invalid numbers of arguments.""" - c = Circle(0, 0, 1) - - with self.assertRaises(TypeError): - c.rotate_ip() - - invalid_args = [ - (1, (2, 2), 2), - (1, (2, 2), 2, 2), - (1, (2, 2), 2, 2, 2), - (1, (2, 2), 2, 2, 2, 2), - (1, (2, 2), 2, 2, 2, 2, 2), - (1, (2, 2), 2, 2, 2, 2, 2, 2), - ] - - for args in invalid_args: - with self.assertRaises(TypeError): - c.rotate_ip(*args) - - def test_meth_rotate_ip_invalid_argtype(self): - """Ensures that the rotate_ip method correctly deals with invalid argument types.""" - c = Circle(0, 0, 1) - - invalid_args = [ - ("a",), # angle str - (None,), # angle str - ((1, 2)), # angle tuple - ([1, 2]), # angle list - (1, "a"), # origin str - (1, None), # origin None - (1, True), # origin True - (1, False), # origin False - (1, (1, 2, 3)), # origin tuple - (1, [1, 2, 3]), # origin list - (1, (1, "a")), # origin str - (1, ("a", 1)), # origin str - (1, (1, None)), # origin None - (1, (None, 1)), # origin None - (1, (1, (1, 2))), # origin tuple - (1, (1, [1, 2])), # origin list - ] - - for value in invalid_args: - with self.assertRaises(TypeError): - c.rotate_ip(*value) - - def test_meth_rotate_ip_return(self): - """Ensures that the rotate_ip method always returns None.""" - c = Circle(0, 0, 1) - - for angle in float_range(-360, 360, 1): - self.assertIsNone(c.rotate_ip(angle)) - self.assertIsInstance(c.rotate_ip(angle), type(None)) - - def test_meth_rotate_invalid_argnum(self): - """Ensures that the rotate method correctly deals with invalid numbers of arguments.""" - c = Circle(0, 0, 1) - - with self.assertRaises(TypeError): - c.rotate() - - invalid_args = [ - (1, (2, 2), 2), - (1, (2, 2), 2, 2), - (1, (2, 2), 2, 2, 2), - (1, (2, 2), 2, 2, 2, 2), - (1, (2, 2), 2, 2, 2, 2, 2), - (1, (2, 2), 2, 2, 2, 2, 2, 2), - ] - - for args in invalid_args: - with self.assertRaises(TypeError): - c.rotate(*args) - - def test_meth_rotate_invalid_argtype(self): - """Ensures that the rotate method correctly deals with invalid argument types.""" - c = Circle(0, 0, 1) - - invalid_args = [ - ("a",), # angle str - (None,), # angle str - ((1, 2)), # angle tuple - ([1, 2]), # angle list - (1, "a"), # origin str - (1, None), # origin None - (1, True), # origin True - (1, False), # origin False - (1, (1, 2, 3)), # origin tuple - (1, [1, 2, 3]), # origin list - (1, (1, "a")), # origin str - (1, ("a", 1)), # origin str - (1, (1, None)), # origin None - (1, (None, 1)), # origin None - (1, (1, (1, 2))), # origin tuple - (1, (1, [1, 2])), # origin list - ] - - for value in invalid_args: - with self.assertRaises(TypeError): - c.rotate(*value) - - def test_meth_rotate_return(self): - """Ensures that the rotate method always returns a Circle.""" - c = Circle(0, 0, 1) - - class CircleSubclass(Circle): - pass - - cs = CircleSubclass(0, 0, 1) - - for angle in float_range(-360, 360, 1): - self.assertIsInstance(c.rotate(angle), Circle) - self.assertIsInstance(cs.rotate(angle), CircleSubclass) - - def test_meth_rotate(self): - """Ensures the Circle.rotate() method rotates the Circle correctly.""" - - def rotate_circle(circle: Circle, angle, center): - def rotate_point(x, y, rang, cx, cy): - x -= cx - y -= cy - x_new = x * math.cos(rang) - y * math.sin(rang) - y_new = x * math.sin(rang) + y * math.cos(rang) - return x_new + cx, y_new + cy - - angle = math.radians(angle) - cx, cy = center if center is not None else circle.center - x, y = rotate_point(circle.x, circle.y, angle, cx, cy) - return Circle(x, y, circle.r) - - def assert_approx_equal(circle1, circle2, eps=1e-12): - self.assertAlmostEqual(circle1.x, circle2.x, delta=eps) - self.assertAlmostEqual(circle1.y, circle2.y, delta=eps) - self.assertAlmostEqual(circle1.r, circle2.r, delta=eps) - - c = Circle(0, 0, 1) - angles = float_range(-360, 360, 0.5) - centers = [(a, b) for a in range(-10, 10) for b in range(-10, 10)] - for angle in angles: - assert_approx_equal(c.rotate(angle), rotate_circle(c, angle, None)) - for center in centers: - assert_approx_equal( - c.rotate(angle, center), rotate_circle(c, angle, center) - ) - - def test_meth_rotate_ip(self): - """Ensures the Circle.rotate_ip() method rotates the Circle correctly.""" - - def rotate_circle(circle: Circle, angle, center): - def rotate_point(x, y, rang, cx, cy): - x -= cx - y -= cy - x_new = x * math.cos(rang) - y * math.sin(rang) - y_new = x * math.sin(rang) + y * math.cos(rang) - return x_new + cx, y_new + cy - - angle = math.radians(angle) - cx, cy = center if center is not None else circle.center - x, y = rotate_point(circle.x, circle.y, angle, cx, cy) - circle.x = x - circle.y = y - return circle - - def assert_approx_equal(circle1, circle2, eps=1e-12): - self.assertAlmostEqual(circle1.x, circle2.x, delta=eps) - self.assertAlmostEqual(circle1.y, circle2.y, delta=eps) - self.assertAlmostEqual(circle1.r, circle2.r, delta=eps) - - c = Circle(0, 0, 1) - angles = float_range(-360, 360, 0.5) - centers = [(a, b) for a in range(-10, 10) for b in range(-10, 10)] - for angle in angles: - c.rotate_ip(angle) - assert_approx_equal(c, rotate_circle(c, angle, None)) - for center in centers: - c.rotate_ip(angle, center) - assert_approx_equal(c, rotate_circle(c, angle, center)) - - def test_contains_argtype(self): - """Tests if the function correctly handles incorrect types as parameters""" - - invalid_types = (None, [], "1", (1,), 1, (1, 2, 3)) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.contains(value) - - def test_contains_argnum(self): - """Tests if the function correctly handles incorrect number of parameters""" - c = Circle(10, 10, 4) - - invalid_args = [(Circle(10, 10, 4), Circle(10, 10, 4))] - - with self.assertRaises(TypeError): - c.contains() - - for arg in invalid_args: - with self.assertRaises(TypeError): - c.contains(*arg) - - def test_contains_return_type(self): - """Tests if the function returns the correct type""" - c = Circle(10, 10, 4) - items = [ - Circle(3, 4, 15), - (0, 0), - Vector2(0, 0), - Rect(0, 0, 10, 10), - FRect(0, 0, 10, 10), - ] - - for item in items: - self.assertIsInstance(c.contains(item), bool) - - def test_contains_circle(self): - """Ensures that the contains method correctly determines if a circle is - contained within the circle""" - c = Circle(10, 10, 4) - c2 = Circle(10, 10, 2) - c3 = Circle(100, 100, 5) - c4 = Circle(16, 10, 7) - - # self - self.assertTrue(c.contains(c)) - - # self-like - c_s = Circle(c) - self.assertTrue(c.contains(c_s)) - - # contained circle - self.assertTrue(c.contains(c2)) - - # not contained circle - self.assertFalse(c.contains(c3)) - - # intersecting circle - self.assertFalse(c.contains(c4)) - - # bigger circle not contained in smaller circle - self.assertFalse(c2.contains(c)) - self.assertFalse(c3.contains(c4)) - - def test_contains_point(self): - """Ensures that the contains method correctly determines if a point is - contained within the circle""" - c = Circle(10, 10, 4) - p1 = (10, 10) - p2 = (10, 15) - p3 = (100, 100) - p4 = (c.x + math.sin(math.pi / 4) * c.r, c.y + math.cos(math.pi / 4) * c.r) - - p1v = Vector2(p1) - p2v = Vector2(p2) - p3v = Vector2(p3) - p4v = Vector2(p4) - - # contained point - self.assertTrue(c.contains(p1)) - - # not contained point - self.assertFalse(c.contains(p2)) - self.assertFalse(c.contains(p3)) - - # on the edge - self.assertTrue(c.contains(p4)) - - # contained point - self.assertTrue(c.contains(p1v)) - - # not contained point - self.assertFalse(c.contains(p2v)) - self.assertFalse(c.contains(p3v)) - - # on the edge - self.assertTrue(c.contains(p4v)) - - def test_contains_rect_frect(self): - """Ensures that the contains method correctly determines if a rect is - contained within the circle""" - c = Circle(0, 0, 10) - r1 = Rect(0, 0, 3, 3) - r2 = Rect(10, 10, 10, 10) - r3 = Rect(10, 10, 5, 5) - - angle = math.pi / 4 - x = c.x - math.sin(angle) * c.r - y = c.y - math.cos(angle) * c.r - rx = c.x + math.sin(angle) * c.r - ry = c.y + math.cos(angle) * c.r - r_edge = Rect(x, y, rx - x, ry - y) - - fr1 = FRect(0, 0, 3, 3) - fr2 = FRect(10, 10, 10, 10) - fr3 = FRect(10, 10, 5, 5) - fr_edge = FRect(x, y, rx - x, ry - y) - - # contained rect - self.assertTrue(c.contains(r1)) - - # not contained rect - self.assertFalse(c.contains(r2)) - self.assertFalse(c.contains(r3)) - - # on the edge - self.assertTrue(c.contains(r_edge)) - - # contained rect - self.assertTrue(c.contains(fr1)) - - # not contained rect - self.assertFalse(c.contains(fr2)) - self.assertFalse(c.contains(fr3)) - - # on the edge - self.assertTrue(c.contains(fr_edge)) - - def test_intersect_argtype(self): - """Tests if the function correctly handles incorrect types as parameters""" - - invalid_types = (None, "1", (1,), 1, (1, 2, 3), True, False) - - c = Circle(10, 10, 4) - - for value in invalid_types: - with self.assertRaises(TypeError): - c.intersect(value) - - def test_intersect_argnum(self): - """Tests if the function correctly handles incorrect number of parameters""" - c = Circle(10, 10, 4) - - circles = [(Circle(10, 10, 4) for _ in range(100))] - for size in range(len(circles)): - with self.assertRaises(TypeError): - c.intersect(*circles[:size]) - - def test_intersect_return_type(self): - """Tests if the function returns the correct type""" - c = Circle(10, 10, 4) - - objects = [ - Circle(10, 10, 4), - Circle(10, 10, 400), - Circle(10, 10, 1), - Circle(15, 10, 10), - ] - - for object in objects: - self.assertIsInstance(c.intersect(object), list) - - def test_intersect(self): - # Circle - c = Circle(10, 10, 4) - c2 = Circle(10, 10, 2) - c3 = Circle(100, 100, 1) - c3_1 = Circle(10, 10, 400) - c4 = Circle(16, 10, 7) - c5 = Circle(18, 10, 4) - - for circle in [c, c2, c3, c3_1]: - self.assertEqual(c.intersect(circle), []) - - # intersecting circle - self.assertEqual( - [(10.25, 6.007820144332172), (10.25, 13.992179855667828)], c.intersect(c4) - ) - - # touching - self.assertEqual([(14.0, 10.0)], c.intersect(c5)) - - -class LineTypeTest(unittest.TestCase): - class ClassWithLineAttrib: - def __init__(self, line): - self.line = line - - class ClassWithLineProperty: - def __init__(self, line): - self._line = line - - @property - def line(self): - return self._line - - class ClassWithLineFunction: - def __init__(self, line): - self._line = line - - def line(self): - return self._line - - def testConstruction_invalid_type(self): - """Checks whether passing wrong types to the constructor - raises the appropriate errors - """ - invalid_types = (None, [], "1", (1,), [1, 2, 3], Vector2(1, 1)) - - # Test ax - for value in invalid_types: - with self.assertRaises(TypeError): - Line(value, 0, 1, 2) - # Test ay - for value in invalid_types: - with self.assertRaises(TypeError): - Line(0, value, 1, 2) - # Test bx - for value in invalid_types: - with self.assertRaises(TypeError): - Line(0, 0, value, 2) - # Test by - for value in invalid_types: - with self.assertRaises(TypeError): - Line(0, 1, 2, value) - - # Test ax - for value in invalid_types: - with self.assertRaises(TypeError): - Line((value, 0), (1, 2)) - # Test ay - for value in invalid_types: - with self.assertRaises(TypeError): - Line((0, value), (1, 2)) - # Test bx - for value in invalid_types: - with self.assertRaises(TypeError): - Line((0, 0), (value, 2)) - # Test by - for value in invalid_types: - with self.assertRaises(TypeError): - Line((0, 1), (2, value)) - - # Test ax - for value in invalid_types: - with self.assertRaises(TypeError): - Line(((value, 0), (1, 2))) - # Test ay - for value in invalid_types: - with self.assertRaises(TypeError): - Line(((0, value), (1, 2))) - # Test bx - for value in invalid_types: - with self.assertRaises(TypeError): - Line(((0, 0), (value, 2))) - # Test by - for value in invalid_types: - with self.assertRaises(TypeError): - Line(((0, 1), (2, value))) - - def testConstruction_invalid_arguments_number(self): - """Checks whether passing the wrong number of arguments to the constructor - raises the appropriate errors - """ - arguments = ( - (1,), # one non vec3 non circle arg - (1, 1), # two args - (1, 1, 1), # three args - (1, 1, 1, 1, 1), # five args - ) - - for arg_seq in arguments: - with self.assertRaises(TypeError): - Line(*arg_seq) - - def testConstructionaxabyxby_float(self): - """Tests the construction of a line with 4 float arguments""" - line = Line(1.0, 2.0, 3.0, 4.0) - - self.assertEqual(line.ax, 1.0) - self.assertEqual(line.ay, 2.0) - self.assertEqual(line.bx, 3.0) - self.assertEqual(line.by, 4.0) - - def testConstructionTUP_axabyxby_float(self): - """Tests the construction of a line with a tuple of 4 float arguments""" - line = Line((1.0, 2.0, 3.0, 4.0)) - - self.assertEqual(line.ax, 1.0) - self.assertEqual(line.ay, 2.0) - self.assertEqual(line.bx, 3.0) - self.assertEqual(line.by, 4.0) - - def testConstructionaxabyxby_int(self): - """Tests the construction of a line with 4 int arguments""" - line = Line(1, 2, 3, 4) - - self.assertEqual(line.ax, 1.0) - self.assertEqual(line.ay, 2.0) - self.assertEqual(line.bx, 3.0) - self.assertEqual(line.by, 4.0) - - def testConstructionTUP_axabyxby_int(self): - """Tests the construction of a line with a tuple of 4 int arguments""" - line = Line((1, 2, 3, 4)) - - self.assertEqual(line.ax, 1.0) - self.assertEqual(line.ay, 2.0) - self.assertEqual(line.bx, 3.0) - self.assertEqual(line.by, 4.0) - - def testConstruction_class_with_line_attrib(self): - """Tests the construction of a line with a class that has a line attribute""" - class_ = self.ClassWithLineAttrib(Line(1.1, 2.2, 3.3, 4.4)) - - line = Line(class_) - - self.assertEqual(line.ax, 1.1) - self.assertEqual(line.ay, 2.2) - self.assertEqual(line.bx, 3.3) - self.assertEqual(line.by, 4.4) - - def testConstruction_class_with_line_property(self): - """Tests the construction of a line with a class that has a line property""" - class_ = self.ClassWithLineProperty(Line(1.1, 2.2, 3.3, 4.4)) - - line = Line(class_) - - self.assertEqual(line.ax, 1.1) - self.assertEqual(line.ay, 2.2) - self.assertEqual(line.bx, 3.3) - self.assertEqual(line.by, 4.4) - - def testConstruction_class_with_line_function(self): - """Tests the construction of a line with a class that has a line function""" - class_ = self.ClassWithLineFunction(Line(1.1, 2.2, 3.3, 4.4)) - - line = Line(class_) - - self.assertEqual(line.ax, 1.1) - self.assertEqual(line.ay, 2.2) - self.assertEqual(line.bx, 3.3) - self.assertEqual(line.by, 4.4) - - def test_attrib_x1(self): - """a full test for the ax attribute""" - expected_x1 = 10.0 - expected_y1 = 2.0 - expected_x2 = 5.0 - expected_y2 = 6.0 - line = Line(1, expected_y1, expected_x2, expected_y2) - - line.ax = expected_x1 - - self.assertEqual(line.ax, expected_x1) - self.assertEqual(line.ay, expected_y1) - self.assertEqual(line.bx, expected_x2) - self.assertEqual(line.by, expected_y2) - - line = Line(0, 0, 1, 0) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - line.ax = value - - line = Line(0, 0, 1, 0) - - with self.assertRaises(AttributeError): - del line.ax - - def test_attrib_y1(self): - """a full test for the ay attribute""" - expected_x1 = 10.0 - expected_y1 = 2.0 - expected_x2 = 5.0 - expected_y2 = 6.0 - line = Line(expected_x1, 1, expected_x2, expected_y2) - - line.ay = expected_y1 - - self.assertEqual(line.ax, expected_x1) - self.assertEqual(line.ay, expected_y1) - self.assertEqual(line.bx, expected_x2) - self.assertEqual(line.by, expected_y2) - - line = Line(0, 0, 1, 0) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - line.ay = value - - line = Line(0, 0, 1, 0) - - with self.assertRaises(AttributeError): - del line.ay - - def test_attrib_x2(self): - """a full test for the ay attribute""" - expected_x1 = 10.0 - expected_y1 = 2.0 - expected_x2 = 5.0 - expected_y2 = 6.0 - line = Line(expected_x1, expected_y1, 1, expected_y2) - - line.bx = expected_x2 - - self.assertEqual(line.ax, expected_x1) - self.assertEqual(line.ay, expected_y1) - self.assertEqual(line.bx, expected_x2) - self.assertEqual(line.by, expected_y2) - - line = Line(0, 0, 1, 0) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - line.bx = value - - line = Line(0, 0, 1, 0) - - with self.assertRaises(AttributeError): - del line.bx - - def test_attrib_y2(self): - """a full test for the ay attribute""" - expected_x1 = 10.0 - expected_y1 = 2.0 - expected_x2 = 5.0 - expected_y2 = 6.0 - line = Line(expected_x1, expected_y1, expected_x2, 1) - - line.by = expected_y2 - - self.assertEqual(line.ax, expected_x1) - self.assertEqual(line.ay, expected_y1) - self.assertEqual(line.bx, expected_x2) - self.assertEqual(line.by, expected_y2) - - line = Line(0, 0, 1, 0) - - for value in (None, [], "1", (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - line.by = value - - line = Line(0, 0, 1, 0) - - with self.assertRaises(AttributeError): - del line.by - - def test_attrib_a(self): - """a full test for the ay attribute""" - expected_x1 = 10.0 - expected_y1 = 2.0 - expected_x2 = 5.0 - expected_y2 = 6.0 - expected_a = expected_x1, expected_y1 - expected_b = expected_x2, expected_y2 - line = Line((0, 1), expected_b) - - line.a = expected_a - - self.assertEqual(line.a, expected_a) - self.assertEqual(line.b, expected_b) - - line = Line(0, 0, 1, 0) - - for value in (None, [], "1", (1,), [1, 2, 3], 1): - with self.assertRaises(TypeError): - line.a = value - - line = Line(0, 0, 1, 0) - - with self.assertRaises(AttributeError): - del line.a - - def test_attrib_b(self): - """a full test for the ay attribute""" - expected_x1 = 10.0 - expected_y1 = 2.0 - expected_x2 = 5.0 - expected_y2 = 6.0 - expected_a = expected_x1, expected_y1 - expected_b = expected_x2, expected_y2 - line = Line(expected_a, (0, 1)) - - line.b = expected_b - - self.assertEqual(line.a, expected_a) - self.assertEqual(line.b, expected_b) - - line = Line(0, 0, 1, 0) - - for value in (None, [], "1", (1,), [1, 2, 3], 1): - with self.assertRaises(TypeError): - line.b = value - - line = Line(0, 0, 1, 0) - - with self.assertRaises(AttributeError): - del line.b - - def test_attrib_length(self): - """a full test for the length attribute""" - expected_length = 3.0 - line = Line(1, 4, 4, 4) - self.assertEqual(line.length, expected_length) - - line.ax = 2 - expected_length = 2.0 - self.assertEqual(line.length, expected_length) - - line.ax = 2.7 - expected_length = 1.2999999999999998 - self.assertAlmostEqual(line.length, expected_length) - - line.ay = 2 - expected_length = 2.3853720883753127 - self.assertAlmostEqual(line.length, expected_length) - - line.ay = 2.7 - expected_length = 1.8384776310850233 - self.assertAlmostEqual(line.length, expected_length) - - line.bx = 2 - expected_length = 1.4764823060233399 - self.assertAlmostEqual(line.length, expected_length) - - line.bx = 2.7 - expected_length = 1.2999999999999998 - self.assertAlmostEqual(line.length, expected_length) - - line.by = 2 - expected_length = 0.7000000000000002 - self.assertAlmostEqual(line.length, expected_length) - - line.by = 2.7 - expected_length = 0.0 - self.assertEqual(line.length, expected_length) - - line1 = Line(7, 3, 2, 3) - line2 = Line(9, 5, 4, 5) - self.assertEqual(line1.length, line2.length) - - line = Line(7.6, 3.2, 2.1, 3.8) - expected_length = 5.532630477449222 - self.assertAlmostEqual(line.length, expected_length) - - line = Line(-9.8, -5.2, -4.4, -5.6) - expected_length = 5.414794548272353 - self.assertAlmostEqual(line.length, expected_length) - - def test_meth_copy(self): - line = Line(1, 2, 3, 4) - # check 1 arg passed - with self.assertRaises(TypeError): - line.copy(10) - - line_2 = line.copy() - self.assertEqual(line.ax, line_2.ax) - self.assertEqual(line.by, line_2.by) - self.assertEqual(line.bx, line_2.bx) - self.assertEqual(line.by, line_2.by) - - self.assertIsNot(line, line_2) - - def test_meth_move(self): - line = Line(1.1, 2.2, 3.3, 4.4) - - ret = line.move(1, 2) - - self.assertEqual(ret.ax, 2.1) - self.assertEqual(ret.ay, 4.2) - self.assertEqual(ret.bx, 4.3) - self.assertEqual(ret.by, 6.4) - - with self.assertRaises(TypeError): - line.move() - - with self.assertRaises(TypeError): - line.move(1) - - with self.assertRaises(TypeError): - line.move(1, 2, 3) - - with self.assertRaises(TypeError): - line.move("1", "2") - - def test_meth_move_ip(self): - line = Line(1.1, 2.2, 3.3, 4.4) - - line.move_ip(1, 2) - - self.assertEqual(line.ax, 2.1) - self.assertEqual(line.ay, 4.2) - self.assertEqual(line.bx, 4.3) - self.assertEqual(line.by, 6.4) - - with self.assertRaises(TypeError): - line.move_ip() - - with self.assertRaises(TypeError): - line.move_ip(1) - - with self.assertRaises(TypeError): - line.move_ip(1, 2, 3) - - with self.assertRaises(TypeError): - line.move_ip("1", "2") - - def test_meth_scale(self): - line = Line(0, 0, 10, 0).scale(2, 0) - self.assertEqual(line.length, 20) - line = Line(0, 0, 20, 0).scale(2.1, 0) - self.assertEqual(line.length, 42) - line = Line(0, 0, 10, 0).scale(4, 0) - self.assertEqual(line.length, 40) - line = Line(0, 0, 10, 0).scale(3, 0) - self.assertEqual(line.length, 30) - line = Line(10, 10, 20, 20).scale(2, 0) - self.assertAlmostEqual(line.length, 28.284271247461902) - line = Line(10, 10, 20, 20).scale(2, 0.5) - self.assertAlmostEqual(line.length, 28.284271247461902) - line = Line(10, 10, 20, 20).scale(2, 1) - self.assertAlmostEqual(line.length, 28.284271247461902) - - with self.assertRaises(ValueError): - line = line.scale(0, 0.5) - - with self.assertRaises(ValueError): - line = line.scale(2, -0.1) - - with self.assertRaises(ValueError): - line = line.scale(-2, -0.5) - - with self.assertRaises(ValueError): - line = line.scale(17, 1.1) - - with self.assertRaises(ValueError): - line = line.scale(17, 10.0) - - def test_meth_scale_ip(self): - line = Line(0, 0, 10, 0) - line.scale_ip(2, 0) - self.assertEqual(line.length, 20) - line = Line(0, 0, 20, 0) - line.scale_ip(2.1, 0) - self.assertEqual(line.length, 42) - line = Line(0, 0, 10, 0) - line.scale_ip(4, 0) - self.assertEqual(line.length, 40) - line = Line(0, 0, 10, 0) - line.scale_ip(3, 0) - self.assertEqual(line.length, 30) - line = Line(10, 10, 20, 20) - line.scale_ip(2, 0) - self.assertAlmostEqual(line.length, 28.284271247461902) - line = Line(10, 10, 20, 20) - line.scale_ip(2, 0.5) - self.assertAlmostEqual(line.length, 28.284271247461902) - line = Line(10, 10, 20, 20) - line.scale_ip(2, 1.0) - self.assertAlmostEqual(line.length, 28.284271247461902) - - with self.assertRaises(ValueError): - line.scale_ip(0, 0.5) - - with self.assertRaises(ValueError): - line.scale_ip(2, -0.1) - - with self.assertRaises(ValueError): - line.scale_ip(-2, -0.5) - - with self.assertRaises(ValueError): - line.scale_ip(17, 1.1) - - with self.assertRaises(ValueError): - line.scale_ip(17, 10.0) - - def test_meth_flip(self): - line = Line(1.1, 2.2, 3.3, 4.4) - - ret = line.flip_ab() - - self.assertIsInstance(ret, Line) - self.assertEqual(ret.ax, 3.3) - self.assertEqual(ret.ay, 4.4) - self.assertEqual(ret.bx, 1.1) - self.assertEqual(ret.by, 2.2) - - with self.assertRaises(TypeError): - line.flip_ab(1) - - def test_meth_flip_ab_ip(self): - line = Line(1.1, 2.2, 3.3, 4.4) - - line.flip_ab_ip() - - self.assertEqual(line.ax, 3.3) - self.assertEqual(line.ay, 4.4) - self.assertEqual(line.bx, 1.1) - self.assertEqual(line.by, 2.2) - - with self.assertRaises(TypeError): - line.flip_ab_ip(1) - - def test_meth_update(self): - line = Line(0, 0, 1, 1) - - line.update(1, 2, 3, 4) - self.assertEqual(line.ax, 1) - self.assertEqual(line.ay, 2) - self.assertEqual(line.bx, 3) - self.assertEqual(line.by, 4) - - line.update((5, 6), (7, 8)) - self.assertEqual(line.ax, 5) - self.assertEqual(line.ay, 6) - self.assertEqual(line.bx, 7) - self.assertEqual(line.by, 8) - - line.update((9, 10, 11, 12)) - self.assertEqual(line.ax, 9) - self.assertEqual(line.ay, 10) - self.assertEqual(line.bx, 11) - self.assertEqual(line.by, 12) - - with self.assertRaises(TypeError): - line.update() - - with self.assertRaises(TypeError): - line.update(1, 2, 3, 4, 5) - - with self.assertRaises(TypeError): - line.update(1, 2, 3) - - def test_meth_project(self): - line = Line(0, 0, 100, 100) - test_point1 = (25, 75) - test_clamp_point1 = (100, 300) - test_clamp_point2 = (-50, -150) - test_clamp_point3 = (-200, -200) - - bad_line = Line(0, 0, 0, 0) - test_bad_line_point = (10, 10) - - projected_point = line.project(test_point1) - self.assertEqual(math.ceil(projected_point[0]), 50) - self.assertEqual(math.ceil(projected_point[1]), 50) - - projected_point = line.project(test_clamp_point1, clamp=True) - self.assertEqual(math.ceil(projected_point[0]), 100) - self.assertEqual(math.ceil(projected_point[1]), 100) - - projected_point = line.project(test_clamp_point2, clamp=True) - self.assertEqual(math.ceil(projected_point[0]), 0) - self.assertEqual(math.ceil(projected_point[1]), 0) - - projected_point = line.project(test_clamp_point3, clamp=True) - self.assertEqual(math.ceil(projected_point[0]), 0) - self.assertEqual(math.ceil(projected_point[1]), 0) - - projected_point = bad_line.project(test_bad_line_point, clamp=True) - self.assertEqual(math.ceil(projected_point[0]), 0) - self.assertEqual(math.ceil(projected_point[1]), 0) - - projected_point = bad_line.project(test_bad_line_point) - self.assertEqual(math.ceil(projected_point[0]), 0) - - def test__str__(self): - """Checks whether the __str__ method works correctly.""" - l_str = "Line((10.1, 10.2), (4.3, 56.4))" - line = Line(10.1, 10.2, 4.3, 56.4) - self.assertEqual(str(line), l_str) - self.assertEqual(line.__str__(), l_str) - - def test__repr__(self): - """Checks whether the __repr__ method works correctly.""" - l_repr = "Line((10.1, 10.2), (4.3, 56.4))" - line = Line(10.1, 10.2, 4.3, 56.4) - self.assertEqual(repr(line), l_repr) - self.assertEqual(line.__repr__(), l_repr) - - -if __name__ == "__main__": - unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/gfxdraw_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/gfxdraw_test.py index 580ab28..33ee2c5 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/gfxdraw_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/gfxdraw_test.py @@ -1,5 +1,4 @@ import unittest - import pygame import pygame.gfxdraw from pygame.locals import * @@ -601,7 +600,7 @@ class GfxdrawDefaultTest(unittest.TestCase): difference between the 2 aatrigons is the order the points are drawn. The order of the points should have no impact on the final drawing. - Related to pygame-ce issue #506. + Related to issue #622. """ bg_color = pygame.Color("white") line_color = pygame.Color("black") @@ -734,7 +733,7 @@ class GfxdrawDefaultTest(unittest.TestCase): aapolygon() and the other using multiple line() calls. They should produce the same final drawing. - Related to pygame-ce issue #506. + Related to issue #622. """ bg_color = pygame.Color("white") line_color = pygame.Color("black") @@ -872,46 +871,6 @@ class GfxdrawDefaultTest(unittest.TestCase): for posn in bg_test_points: self.check_at(surf, posn, bg_adjusted) - def test_no_pal_8bit_surf(self): - """ - Test that gfxdraw methods do not segfault when passed with no palette - 8 bit surface. - """ - s = pygame.Surface( - size=(512, 512), flags=0, depth=8, masks=(0xE0, 0x1C, 0x03, 0x00) - ) - - fg = (255, 255, 255) - points = [(10, 10), (100, 50), (50, 100)] - for name, args in ( - ("pixel", (s, 2, 2, fg)), - ("hline", (s, 5, 50, 10, fg)), - ("vline", (s, 10, 5, 50, fg)), - ("line", (s, 0, 0, 100, 100, fg)), - ("rectangle", (s, pygame.Rect(50, 50, 80, 40), fg)), - ("box", (s, pygame.Rect(60, 60, 80, 40), fg)), - ("circle", (s, 256, 256, 64, fg)), - ("aacircle", (s, 256, 256, 64, fg)), - ("filled_circle", (s, 256, 256, 32, fg)), - ("ellipse", (s, 200, 200, 50, 30, fg)), - ("aaellipse", (s, 200, 200, 50, 30, fg)), - ("filled_ellipse", (s, 200, 200, 50, 30, fg)), - ("arc", (s, 256, 256, 60, 0, 180, fg)), - ("pie", (s, 300, 300, 60, 0, 270, fg)), - ("trigon", (s, 100, 100, 150, 200, 50, 200, fg)), - ("aatrigon", (s, 100, 100, 150, 200, 50, 200, fg)), - ("filled_trigon", (s, 100, 100, 150, 200, 50, 200, fg)), - ("polygon", (s, points, fg)), - ("aapolygon", (s, points, fg)), - ("filled_polygon", (s, points, fg)), - ("textured_polygon", (s, points, s, 0, 0)), # use same surface as texture - ): - try: - func = getattr(pygame.gfxdraw, name) - func(*args) - except Exception as e: - self.fail(f"gfxdraw.{name} raised an exception: {e}") - if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/image__save_gl_surface_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/image__save_gl_surface_test.py index b70a0ba..2932f42 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/image__save_gl_surface_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/image__save_gl_surface_test.py @@ -1,14 +1,14 @@ import os import unittest +from pygame.tests import test_utils import pygame from pygame.locals import * -from pygame.tests import test_utils @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "OpenGL requires a non-null SDL_VIDEODRIVER", + os.environ.get("SDL_VIDEODRIVER") == "dummy", + 'OpenGL requires a non-"dummy" SDL_VIDEODRIVER', ) class GL_ImageSave(unittest.TestCase): def test_image_save_works_with_opengl_surfaces(self): diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/image_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/image_test.py index fee1b98..77dff79 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/image_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/image_test.py @@ -1,18 +1,14 @@ import array import binascii -import glob import io import os -import pathlib -import random import tempfile import unittest -from concurrent.futures import ThreadPoolExecutor +import glob +import pathlib -import pygame -import pygame.image -import pygame.pkgdata from pygame.tests.test_utils import example_path, png, tostring +import pygame, pygame.image, pygame.pkgdata sdl_image_svg_jpeg_save_bug = False _sdl_image_ver = pygame.image.get_sdl_image_version() @@ -21,10 +17,8 @@ if _sdl_image_ver is not None: _sdl_image_ver <= (2, 0, 5) and pygame.get_sdl_byteorder() == pygame.BIG_ENDIAN ) -PG_DEPS_FROM_SYSTEM = "PG_DEPS_FROM_SYSTEM" in os.environ - -def check_magic(f, magic_hexes): +def test_magic(f, magic_hexes): """Tests a given file to see if the magic hex matches.""" data = f.read(len(magic_hexes)) if len(data) != len(magic_hexes): @@ -53,8 +47,8 @@ class ImageModuleTest(unittest.TestCase): reddish_pixel = (210, 0, 0, 255) greenish_pixel = (0, 220, 0, 255) bluish_pixel = (0, 0, 230, 255) - grayish_pixel = (110, 120, 130, 140) - pixel_array = [reddish_pixel + greenish_pixel, bluish_pixel + grayish_pixel] + greyish_pixel = (110, 120, 130, 140) + pixel_array = [reddish_pixel + greenish_pixel, bluish_pixel + greyish_pixel] f_descriptor, f_path = tempfile.mkstemp(suffix=".png") @@ -68,7 +62,7 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(surf.get_at((0, 0)), reddish_pixel) self.assertEqual(surf.get_at((1, 0)), greenish_pixel) self.assertEqual(surf.get_at((0, 1)), bluish_pixel) - self.assertEqual(surf.get_at((1, 1)), grayish_pixel) + self.assertEqual(surf.get_at((1, 1)), greyish_pixel) # Read the PNG file obj. and verify that pygame interprets it correctly with open(f_path, "rb") as f: @@ -77,7 +71,7 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(surf.get_at((0, 0)), reddish_pixel) self.assertEqual(surf.get_at((1, 0)), greenish_pixel) self.assertEqual(surf.get_at((0, 1)), bluish_pixel) - self.assertEqual(surf.get_at((1, 1)), grayish_pixel) + self.assertEqual(surf.get_at((1, 1)), greyish_pixel) os.remove(f_path) @@ -110,7 +104,7 @@ class ImageModuleTest(unittest.TestCase): "SDL_image 2.0.5 and older has a big endian bug in jpeg saving", ) def testSaveJPG(self): - """JPG equivalent to pygame-ce issue #226 - color channel swapping + """JPG equivalent to issue #211 - color channel swapping Make sure the SDL surface color masks represent the rgb memory format required by the JPG library. The masks are machine endian dependent @@ -151,9 +145,12 @@ class ImageModuleTest(unittest.TestCase): # Assume pygame.image.Load works correctly as it is handled by the # third party SDL_image library. - f_path = tempfile.mktemp(suffix=".jpg") - pygame.image.save(surf, f_path) - jpg_surf = pygame.image.load(f_path) + + with tempfile.NamedTemporaryFile(suffix=".jpg", delete=False) as f: + temp_filename = f.name + + pygame.image.save(surf, temp_filename) + jpg_surf = pygame.image.load(temp_filename) # Allow for small differences in the restored colors. def approx(c): @@ -165,7 +162,7 @@ class ImageModuleTest(unittest.TestCase): posn = rect.move((offset, offset)).topleft self.assertEqual(approx(jpg_surf.get_at(posn)), approx(color)) - os.remove(f_path) + os.remove(temp_filename) def testSavePNG32(self): """see if we can save a png with color values in the proper channels.""" @@ -173,84 +170,74 @@ class ImageModuleTest(unittest.TestCase): reddish_pixel = (215, 0, 0, 255) greenish_pixel = (0, 225, 0, 255) bluish_pixel = (0, 0, 235, 255) - grayish_pixel = (115, 125, 135, 145) + greyish_pixel = (115, 125, 135, 145) surf = pygame.Surface((1, 4), pygame.SRCALPHA, 32) surf.set_at((0, 0), reddish_pixel) surf.set_at((0, 1), greenish_pixel) surf.set_at((0, 2), bluish_pixel) - surf.set_at((0, 3), grayish_pixel) + surf.set_at((0, 3), greyish_pixel) - f_path = tempfile.mktemp(suffix=".png") - pygame.image.save(surf, f_path) + with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: + temp_filename = f.name + + pygame.image.save(surf, temp_filename) try: # Read the PNG file and verify that pygame saved it correctly - reader = png.Reader(filename=f_path) + reader = png.Reader(filename=temp_filename) width, height, pixels, metadata = reader.asRGBA8() # pixels is a generator self.assertEqual(tuple(next(pixels)), reddish_pixel) self.assertEqual(tuple(next(pixels)), greenish_pixel) self.assertEqual(tuple(next(pixels)), bluish_pixel) - self.assertEqual(tuple(next(pixels)), grayish_pixel) + self.assertEqual(tuple(next(pixels)), greyish_pixel) finally: # Ensures proper clean up. if not reader.file.closed: reader.file.close() del reader - os.remove(f_path) + os.remove(temp_filename) - @unittest.skipIf( - pygame.image.get_sdl_image_version() == (2, 0, 5), - "SDL image 2.0.5 png saving will save this 24 bit as RGBA, causing reader.asRGB8 to fail", - ) - @unittest.skipIf( - PG_DEPS_FROM_SYSTEM, - "If we are using system dependencies, we don't know the backend used " - "for PNG saving, and this test only works with libpng.", - ) def testSavePNG24(self): """see if we can save a png with color values in the proper channels.""" # Create a PNG file with known colors reddish_pixel = (215, 0, 0) greenish_pixel = (0, 225, 0) bluish_pixel = (0, 0, 235) - grayish_pixel = (115, 125, 135) + greyish_pixel = (115, 125, 135) surf = pygame.Surface((1, 4), 0, 24) surf.set_at((0, 0), reddish_pixel) surf.set_at((0, 1), greenish_pixel) surf.set_at((0, 2), bluish_pixel) - surf.set_at((0, 3), grayish_pixel) + surf.set_at((0, 3), greyish_pixel) - f_path = tempfile.mktemp(suffix=".png") - pygame.image.save(surf, f_path) + with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: + temp_filename = f.name + + pygame.image.save(surf, temp_filename) try: # Read the PNG file and verify that pygame saved it correctly - reader = png.Reader(filename=f_path) + reader = png.Reader(filename=temp_filename) width, height, pixels, metadata = reader.asRGB8() # pixels is a generator self.assertEqual(tuple(next(pixels)), reddish_pixel) self.assertEqual(tuple(next(pixels)), greenish_pixel) self.assertEqual(tuple(next(pixels)), bluish_pixel) - self.assertEqual(tuple(next(pixels)), grayish_pixel) + self.assertEqual(tuple(next(pixels)), greyish_pixel) finally: # Ensures proper clean up. if not reader.file.closed: reader.file.close() del reader - os.remove(f_path) + os.remove(temp_filename) - @unittest.skipIf( - PG_DEPS_FROM_SYSTEM, - "If we are using system dependencies, we don't know the backend used " - "for PNG saving, and this test only works with libpng.", - ) def testSavePNG8(self): """see if we can save an 8 bit png correctly""" # Create an 8-bit PNG file with known colors @@ -261,12 +248,14 @@ class ImageModuleTest(unittest.TestCase): for cnt, pix in enumerate(set_pixels): surf.set_at((0, cnt), pix) - f_path = tempfile.mktemp(suffix=".png") - pygame.image.save(surf, f_path) + with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: + temp_filename = f.name + + pygame.image.save(surf, temp_filename) try: # Read the PNG file and verify that pygame saved it correctly - reader = png.Reader(filename=f_path) + reader = png.Reader(filename=temp_filename) width, height, pixels, _ = reader.asRGB8() self.assertEqual(size, (width, height)) @@ -279,13 +268,8 @@ class ImageModuleTest(unittest.TestCase): if not reader.file.closed: reader.file.close() del reader - os.remove(f_path) + os.remove(temp_filename) - @unittest.skipIf( - PG_DEPS_FROM_SYSTEM, - "If we are using system dependencies, we don't know the backend used " - "for PNG saving, and this test only works with libpng.", - ) def testSavePaletteAsPNG8(self): """see if we can save a png with color values in the proper channels.""" # Create a PNG file with known colors @@ -294,19 +278,21 @@ class ImageModuleTest(unittest.TestCase): reddish_pixel = (215, 0, 0) greenish_pixel = (0, 225, 0) bluish_pixel = (0, 0, 235) - grayish_pixel = (115, 125, 135) + greyish_pixel = (115, 125, 135) surf = pygame.Surface((1, 4), 0, 8) surf.set_palette_at(0, reddish_pixel) surf.set_palette_at(1, greenish_pixel) surf.set_palette_at(2, bluish_pixel) - surf.set_palette_at(3, grayish_pixel) + surf.set_palette_at(3, greyish_pixel) - f_path = tempfile.mktemp(suffix=".png") - pygame.image.save(surf, f_path) + with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: + temp_filename = f.name + + pygame.image.save(surf, temp_filename) try: # Read the PNG file and verify that pygame saved it correctly - reader = png.Reader(filename=f_path) + reader = png.Reader(filename=temp_filename) reader.read() palette = reader.palette() @@ -314,14 +300,14 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(tuple(next(palette)), reddish_pixel) self.assertEqual(tuple(next(palette)), greenish_pixel) self.assertEqual(tuple(next(palette)), bluish_pixel) - self.assertEqual(tuple(next(palette)), grayish_pixel) + self.assertEqual(tuple(next(palette)), greyish_pixel) finally: # Ensures proper clean up. if not reader.file.closed: reader.file.close() del reader - os.remove(f_path) + os.remove(temp_filename) def test_save(self): s = pygame.Surface((10, 10)) @@ -346,7 +332,7 @@ class ImageModuleTest(unittest.TestCase): # Test the magic numbers at the start of the file to ensure # they are saved as the correct file type. self.assertEqual( - (1, fmt), (check_magic(handle, magic_hex[fmt.lower()]), fmt) + (1, fmt), (test_magic(handle, magic_hex[fmt.lower()]), fmt) ) # load the file to make sure it was saved correctly. @@ -383,83 +369,6 @@ class ImageModuleTest(unittest.TestCase): # clean up the temp file, even if test fails os.remove(temp_filename) - # Test palettized - s = pygame.Surface((3, 3), depth=8) - pixels = [ - (223, 236, 110, 201), - (33, 82, 34, 26), - (226, 194, 83, 208), - (10, 181, 81, 165), - (220, 95, 96, 11), - (208, 7, 143, 158), - (194, 140, 64, 27), - (215, 152, 89, 126), - (36, 83, 107, 225), - ] - result_pixels = [ - (255, 219, 85, 255), - (0, 73, 0, 255), - (255, 182, 85, 255), - (0, 182, 85, 255), - (255, 109, 85, 255), - (170, 0, 170, 255), - (170, 146, 85, 255), - (255, 146, 85, 255), - (0, 73, 85, 255), - ] - for pixelnum, pixelval in enumerate(pixels): - y, x = divmod(pixelnum, 3) - s.set_at((x, y), pixelval) - - # No palette = pygame.error, this asserts there is a palette. - s.get_palette() - - with tempfile.NamedTemporaryFile(suffix=".tga", delete=False) as f: - temp_filename = f.name - - try: - pygame.image.save(s, temp_filename) - s2 = pygame.image.load(temp_filename) - for pixelnum, pixelval in enumerate(result_pixels): - y, x = divmod(pixelnum, 3) - self.assertEqual(s2.get_at((x, y)), pixelval) - finally: - # clean up the temp file, even if test fails - os.remove(temp_filename) - - def test_save_tga_srcalpha(self): - WIDTH = 10 - HEIGHT = 10 - s = pygame.Surface((WIDTH, HEIGHT), pygame.SRCALPHA) - pixels = [ - [ - ( - random.randint(0, 255), - random.randint(0, 255), - random.randint(0, 255), - random.randint(0, 255), - ) - for _ in range(WIDTH) - ] - for _ in range(HEIGHT) - ] - for y in range(HEIGHT): - for x in range(WIDTH): - s.set_at((x, y), pixels[y][x]) - - with tempfile.NamedTemporaryFile(suffix=".tga", delete=False) as f: - temp_filename = f.name - - try: - pygame.image.save(s, temp_filename) - s2 = pygame.image.load(temp_filename) - for y in range(HEIGHT): - for x in range(WIDTH): - self.assertEqual(s2.get_at((x, y)), pixels[y][x]) - finally: - # clean up the temp file, even if test fails - os.remove(temp_filename) - def test_save_pathlib(self): surf = pygame.Surface((1, 1)) surf.fill((23, 23, 23)) @@ -507,7 +416,7 @@ class ImageModuleTest(unittest.TestCase): # ensure they are saved as the correct file type. handle.seek(0) self.assertEqual( - (1, fmt), (check_magic(handle, magic_hex[fmt.lower()]), fmt) + (1, fmt), (test_magic(handle, magic_hex[fmt.lower()]), fmt) ) # load the file to make sure it was saved correctly. handle.flush() @@ -539,22 +448,38 @@ class ImageModuleTest(unittest.TestCase): def test_load_unicode_path(self): import shutil - with tempfile.TemporaryDirectory() as tmpdir: - orig = example_path("data/asprite.bmp") - temp = os.path.join(tmpdir, "你好.bmp") - shutil.copy(orig, temp) - pygame.image.load(temp) + orig = example_path("data/asprite.bmp") + temp = os.path.join(example_path("data"), "你好.bmp") + shutil.copy(orig, temp) + try: + im = pygame.image.load(temp) + finally: + os.remove(temp) def _unicode_save(self, temp_file): im = pygame.Surface((10, 10), 0, 32) + try: + with open(temp_file, "w") as f: + pass + os.remove(temp_file) + except OSError: + raise unittest.SkipTest("the path cannot be opened") + self.assertFalse(os.path.exists(temp_file)) - pygame.image.save(im, temp_file) - self.assertGreater(os.path.getsize(temp_file), 10) + + try: + pygame.image.save(im, temp_file) + + self.assertGreater(os.path.getsize(temp_file), 10) + finally: + try: + os.remove(temp_file) + except OSError: + pass def test_save_unicode_path(self): """save unicode object with non-ASCII chars""" - with tempfile.TemporaryDirectory() as tmpdir: - self._unicode_save(os.path.join(tmpdir, "你好.bmp")) + self._unicode_save("你好.bmp") def assertPremultipliedAreEqual(self, string1, string2, source_string): self.assertEqual(len(string1), len(string2)) @@ -579,17 +504,17 @@ class ImageModuleTest(unittest.TestCase): ) self.fail(msg) - def test_to_bytes__premultiplied(self): - """test to make sure we can export a surface to a premultiplied alpha bytes""" + def test_to_string__premultiplied(self): + """test to make sure we can export a surface to a premultiplied alpha string""" def convertRGBAtoPremultiplied(surface_to_modify): for x in range(surface_to_modify.get_width()): for y in range(surface_to_modify.get_height()): color = surface_to_modify.get_at((x, y)) premult_color = ( - ((color[0] + 1) * color[3]) >> 8, - ((color[1] + 1) * color[3]) >> 8, - ((color[2] + 1) * color[3]) >> 8, + color[0] * color[3] / 255, + color[1] * color[3] / 255, + color[2] * color[3] / 255, color[3], ) surface_to_modify.set_at((x, y), premult_color) @@ -604,19 +529,19 @@ class ImageModuleTest(unittest.TestCase): premultiplied_copy = test_surface.copy() convertRGBAtoPremultiplied(premultiplied_copy) self.assertPremultipliedAreEqual( - pygame.image.tobytes(test_surface, "RGBA_PREMULT"), - pygame.image.tobytes(premultiplied_copy, "RGBA"), - pygame.image.tobytes(test_surface, "RGBA"), + pygame.image.tostring(test_surface, "RGBA_PREMULT"), + pygame.image.tostring(premultiplied_copy, "RGBA"), + pygame.image.tostring(test_surface, "RGBA"), ) self.assertPremultipliedAreEqual( - pygame.image.tobytes(test_surface, "ARGB_PREMULT"), - pygame.image.tobytes(premultiplied_copy, "ARGB"), - pygame.image.tobytes(test_surface, "ARGB"), + pygame.image.tostring(test_surface, "ARGB_PREMULT"), + pygame.image.tostring(premultiplied_copy, "ARGB"), + pygame.image.tostring(test_surface, "ARGB"), ) no_alpha_surface = pygame.Surface((256, 256), 0, 24) self.assertRaises( - ValueError, pygame.image.tobytes, no_alpha_surface, "RGBA_PREMULT" + ValueError, pygame.image.tostring, no_alpha_surface, "RGBA_PREMULT" ) # Custom assert method to check for identical surfaces. @@ -646,12 +571,12 @@ class ImageModuleTest(unittest.TestCase): "%s (pixel: %d, %d)" % (msg, x, y), ) - def test_frombytes__and_tobytes(self): - """Ensure methods tobytes() and frombytes() are symmetric.""" + def test_fromstring__and_tostring(self): + """Ensure methods tostring() and fromstring() are symmetric.""" import itertools - fmts = ("RGBA", "ARGB", "BGRA", "ABGR") + fmts = ("RGBA", "ARGB", "BGRA") fmt_permutations = itertools.permutations(fmts, 2) fmt_combinations = itertools.combinations(fmts, 2) @@ -674,25 +599,24 @@ class ImageModuleTest(unittest.TestCase): #################################################################### test_surface = pygame.Surface((64, 256), flags=pygame.SRCALPHA, depth=32) - byte_width = test_surface.get_width() * 4 for i in range(256): for j in range(16): intensity = j * 16 + 15 test_surface.set_at((j + 0, i), (intensity, i, i, i)) test_surface.set_at((j + 16, i), (i, intensity, i, i)) test_surface.set_at((j + 32, i), (i, i, intensity, i)) - test_surface.set_at((j + 48, i), (i, i, i, intensity)) + test_surface.set_at((j + 32, i), (i, i, i, intensity)) self._assertSurfaceEqual( test_surface, test_surface, "failing with identical surfaces" ) for pair in fmt_combinations: - fmt1_buf = pygame.image.tobytes(test_surface, pair[0]) + fmt1_buf = pygame.image.tostring(test_surface, pair[0]) fmt1_convert_buf = convert( pair[1], pair[0], convert(pair[0], pair[1], fmt1_buf) ) - test_convert_two_way = pygame.image.frombytes( + test_convert_two_way = pygame.image.fromstring( fmt1_convert_buf, test_surface.get_size(), pair[0] ) @@ -702,24 +626,10 @@ class ImageModuleTest(unittest.TestCase): f"converting {pair[0]} to {pair[1]} and back is not symmetric", ) - fmt1_buf = pygame.image.tobytes(test_surface, pair[0], pitch=byte_width + 4) - fmt1_convert_buf = convert( - pair[1], pair[0], convert(pair[0], pair[1], fmt1_buf) - ) - test_convert_two_way = pygame.image.frombytes( - fmt1_convert_buf, test_surface.get_size(), pair[0], pitch=byte_width + 4 - ) - - self._assertSurfaceEqual( - test_surface, - test_convert_two_way, - f"converting {pair[0]} to {pair[1]} and back using pitch is not symmetric", - ) - for pair in fmt_permutations: - fmt1_buf = pygame.image.tobytes(test_surface, pair[0]) + fmt1_buf = pygame.image.tostring(test_surface, pair[0]) fmt2_convert_buf = convert(pair[0], pair[1], fmt1_buf) - test_convert_one_way = pygame.image.frombytes( + test_convert_one_way = pygame.image.fromstring( fmt2_convert_buf, test_surface.get_size(), pair[1] ) @@ -729,88 +639,45 @@ class ImageModuleTest(unittest.TestCase): f"converting {pair[0]} to {pair[1]} failed", ) - fmt1_buf = pygame.image.tobytes(test_surface, pair[0], pitch=byte_width + 4) - fmt2_convert_buf = convert(pair[0], pair[1], fmt1_buf) - test_convert_one_way = pygame.image.frombytes( - fmt2_convert_buf, test_surface.get_size(), pair[1], pitch=byte_width + 4 - ) - - self._assertSurfaceEqual( - test_surface, - test_convert_one_way, - f"converting {pair[0]} to {pair[1]} using pitch failed", - ) - for fmt in fmts: - test_buf = pygame.image.tobytes(test_surface, fmt) - test_to_from_fmt_bytes = pygame.image.frombytes( + test_buf = pygame.image.tostring(test_surface, fmt) + test_to_from_fmt_string = pygame.image.fromstring( test_buf, test_surface.get_size(), fmt ) self._assertSurfaceEqual( test_surface, - test_to_from_fmt_bytes, - f"tobytes/frombytes functions are not symmetric with '{fmt}' format", + test_to_from_fmt_string, + "tostring/fromstring functions are not " + f"symmetric with '{fmt}' format", ) - test_buf = pygame.image.tobytes(test_surface, fmt, pitch=byte_width + 4) - test_to_from_fmt_bytes = pygame.image.frombytes( - test_buf, test_surface.get_size(), fmt, pitch=byte_width + 4 - ) - - self._assertSurfaceEqual( - test_surface, - test_to_from_fmt_bytes, - f"tobytes/frombytes functions are not symmetric using pitch with '{fmt}' format", - ) - - def test_tobytes_depth_24(self): + def test_tostring_depth_24(self): test_surface = pygame.Surface((64, 256), depth=24) - byte_width = test_surface.get_width() * 3 for i in range(256): for j in range(16): intensity = j * 16 + 15 test_surface.set_at((j + 0, i), (intensity, i, i, i)) test_surface.set_at((j + 16, i), (i, intensity, i, i)) test_surface.set_at((j + 32, i), (i, i, intensity, i)) - test_surface.set_at((j + 48, i), (i, i, i, intensity)) + test_surface.set_at((j + 32, i), (i, i, i, intensity)) fmt = "RGB" - fmt_buf = pygame.image.tobytes(test_surface, fmt) - test_to_from_fmt_bytes = pygame.image.frombytes( + fmt_buf = pygame.image.tostring(test_surface, fmt) + test_to_from_fmt_string = pygame.image.fromstring( fmt_buf, test_surface.get_size(), fmt ) self._assertSurfaceEqual( test_surface, - test_to_from_fmt_bytes, - f'tobytes/frombytes functions are not symmetric with "{fmt}" format', + test_to_from_fmt_string, + f'tostring/fromstring functions are not symmetric with "{fmt}" format', ) - fmt_buf = pygame.image.tobytes(test_surface, fmt, pitch=byte_width + 2) - test_to_from_fmt_bytes = pygame.image.frombytes( - fmt_buf, test_surface.get_size(), fmt, pitch=byte_width + 2 - ) - - self._assertSurfaceEqual( - test_surface, - test_to_from_fmt_bytes, - f'tobytes/frombytes functions are not symmetric using pitch with "{fmt}" format', - ) - - def test_from_to_bytes_deprecation(self): - test_surface = pygame.Surface((64, 256), flags=pygame.SRCALPHA, depth=32) - with self.assertWarns(DeprecationWarning): - test_surface_bytes = pygame.image.tostring(test_surface, "RGBA") - with self.assertWarns(DeprecationWarning): - reconstructed_test_surface = pygame.image.fromstring( - test_surface_bytes, (64, 256), "RGBA" - ) - def test_frombuffer_8bit(self): """test reading pixel data from a bytes buffer""" pygame.display.init() - eight_bit_palette_buffer = bytes( + eight_bit_palette_buffer = bytearray( [0, 0, 0, 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 3, 3] ) @@ -824,26 +691,58 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(eight_bit_surf.get_at((3, 3)), pygame.Color(50, 200, 20)) def test_frombuffer_RGB(self): - # fmt: off - rgb_buffer = bytes([ - 255, 10, 20, - 255, 10, 20, - 255, 10, 20, - 255, 10, 20, - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 50, 200, 20, - 50, 200, 20, - 50, 200, 20, - 50, 200, 20, - ]) - # fmt: on + rgb_buffer = bytearray( + [ + 255, + 10, + 20, + 255, + 10, + 20, + 255, + 10, + 20, + 255, + 10, + 20, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 50, + 200, + 20, + 50, + 200, + 20, + 50, + 200, + 20, + 50, + 200, + 20, + ] + ) rgb_surf = pygame.image.frombuffer(rgb_buffer, (4, 4), "RGB") self.assertEqual(rgb_surf.get_at((0, 0)), pygame.Color(255, 10, 20)) @@ -852,26 +751,58 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(rgb_surf.get_at((3, 3)), pygame.Color(50, 200, 20)) def test_frombuffer_BGR(self): - # fmt: off - bgr_buffer = bytes([ - 20, 10, 255, - 20, 10, 255, - 20, 10, 255, - 20, 10, 255, - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 20, 200, 50, - 20, 200, 50, - 20, 200, 50, - 20, 200, 50, - ]) - # fmt: on + bgr_buffer = bytearray( + [ + 20, + 10, + 255, + 20, + 10, + 255, + 20, + 10, + 255, + 20, + 10, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 20, + 200, + 50, + 20, + 200, + 50, + 20, + 200, + 50, + 20, + 200, + 50, + ] + ) bgr_surf = pygame.image.frombuffer(bgr_buffer, (4, 4), "BGR") self.assertEqual(bgr_surf.get_at((0, 0)), pygame.Color(255, 10, 20)) @@ -880,26 +811,74 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(bgr_surf.get_at((3, 3)), pygame.Color(50, 200, 20)) def test_frombuffer_BGRA(self): - # fmt: off - bgra_buffer = bytes([ - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - ]) - # fmt: on + bgra_buffer = bytearray( + [ + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + ] + ) bgra_surf = pygame.image.frombuffer(bgra_buffer, (4, 4), "BGRA") self.assertEqual(bgra_surf.get_at((0, 0)), pygame.Color(20, 10, 255, 200)) @@ -908,26 +887,74 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(bgra_surf.get_at((3, 3)), pygame.Color(20, 200, 50, 255)) def test_frombuffer_RGBX(self): - # fmt: off - rgbx_buffer = bytes([ - 255, 10, 20, 255, - 255, 10, 20, 255, - 255, 10, 20, 255, - 255, 10, 20, 255, - 255, 255, 255, 255, - 255, 255, 255, 255, - 255, 255, 255, 255, - 255, 255, 255, 255, - 0, 0, 0, 255, - 0, 0, 0, 255, - 0, 0, 0, 255, - 0, 0, 0, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - ]) - # fmt: on + rgbx_buffer = bytearray( + [ + 255, + 10, + 20, + 255, + 255, + 10, + 20, + 255, + 255, + 10, + 20, + 255, + 255, + 10, + 20, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 255, + 0, + 0, + 0, + 255, + 0, + 0, + 0, + 255, + 0, + 0, + 0, + 255, + 0, + 0, + 0, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + ] + ) rgbx_surf = pygame.image.frombuffer(rgbx_buffer, (4, 4), "RGBX") self.assertEqual(rgbx_surf.get_at((0, 0)), pygame.Color(255, 10, 20, 255)) @@ -936,26 +963,74 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(rgbx_surf.get_at((3, 3)), pygame.Color(50, 200, 20, 255)) def test_frombuffer_RGBA(self): - # fmt: off - rgba_buffer = bytes([ - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - ]) - # fmt: on + rgba_buffer = bytearray( + [ + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + ] + ) rgba_surf = pygame.image.frombuffer(rgba_buffer, (4, 4), "RGBA") self.assertEqual(rgba_surf.get_at((0, 0)), pygame.Color(255, 10, 20, 200)) @@ -964,26 +1039,74 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(rgba_surf.get_at((3, 3)), pygame.Color(50, 200, 20, 255)) def test_frombuffer_ARGB(self): - # fmt: off - argb_buffer = bytes([ - 200, 255, 10, 20, - 200, 255, 10, 20, - 200, 255, 10, 20, - 200, 255, 10, 20, - 127, 255, 255, 255, - 127, 255, 255, 255, - 127, 255, 255, 255, - 127, 255, 255, 255, - 79, 0, 0, 0, - 79, 0, 0, 0, - 79, 0, 0, 0, - 79, 0, 0, 0, - 255, 50, 200, 20, - 255, 50, 200, 20, - 255, 50, 200, 20, - 255, 50, 200, 20, - ]) - # fmt: on + argb_buffer = bytearray( + [ + 200, + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 200, + 255, + 10, + 20, + 127, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 127, + 255, + 255, + 255, + 79, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 79, + 0, + 0, + 0, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + 255, + 50, + 200, + 20, + ] + ) argb_surf = pygame.image.frombuffer(argb_buffer, (4, 4), "ARGB") self.assertEqual(argb_surf.get_at((0, 0)), pygame.Color(255, 10, 20, 200)) @@ -991,225 +1114,6 @@ class ImageModuleTest(unittest.TestCase): self.assertEqual(argb_surf.get_at((2, 2)), pygame.Color(0, 0, 0, 79)) self.assertEqual(argb_surf.get_at((3, 3)), pygame.Color(50, 200, 20, 255)) - def test_frombuffer_pitched_8bit(self): - """test reading pixel data from a bytes buffer with a pitch""" - pygame.display.init() - # fmt: off - eight_bit_palette_buffer = bytes([ - 0, 0, 0, 0, - 0, 0, # Padding - 1, 1, 1, 1, - 0, 0, # Padding - 2, 2, 2, 2, - 0, 0, # Padding - 3, 3, 3, 3, - 0, 0, # Padding - ]) - # fmt: on - - eight_bit_surf = pygame.image.frombuffer( - eight_bit_palette_buffer, (4, 4), "P", pitch=6 - ) - eight_bit_surf.set_palette( - [(255, 10, 20), (255, 255, 255), (0, 0, 0), (50, 200, 20)] - ) - self.assertEqual(eight_bit_surf.get_at((0, 0)), pygame.Color(255, 10, 20)) - self.assertEqual(eight_bit_surf.get_at((1, 1)), pygame.Color(255, 255, 255)) - self.assertEqual(eight_bit_surf.get_at((2, 2)), pygame.Color(0, 0, 0)) - self.assertEqual(eight_bit_surf.get_at((3, 3)), pygame.Color(50, 200, 20)) - - def test_frombuffer_pitched_RGB(self): - # fmt: off - rgb_buffer = bytes([ - 255, 10, 20, - 255, 10, 20, - 255, 10, 20, - 255, 10, 20, - 0, 0, 0, 0, # Padding - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 0, 0, 0, 0, # Padding - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, 0, # Padding - 50, 200, 20, - 50, 200, 20, - 50, 200, 20, - 50, 200, 20, - 0, 0, 0, 0, # Padding - ]) - # fmt: on - - rgb_surf = pygame.image.frombuffer(rgb_buffer, (4, 4), "RGB", pitch=16) - self.assertEqual(rgb_surf.get_at((0, 0)), pygame.Color(255, 10, 20)) - self.assertEqual(rgb_surf.get_at((1, 1)), pygame.Color(255, 255, 255)) - self.assertEqual(rgb_surf.get_at((2, 2)), pygame.Color(0, 0, 0)) - self.assertEqual(rgb_surf.get_at((3, 3)), pygame.Color(50, 200, 20)) - - def test_frombuffer_pitched_BGR(self): - # fmt: off - bgr_buffer = bytes([ - 20, 10, 255, - 20, 10, 255, - 20, 10, 255, - 20, 10, 255, - 0, 0, 0, 0, # Padding - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 255, 255, 255, - 0, 0, 0, 0, # Padding - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, - 0, 0, 0, 0, # Padding - 20, 200, 50, - 20, 200, 50, - 20, 200, 50, - 20, 200, 50, - 0, 0, 0, 0, # Padding - ]) - # fmt: on - - bgr_surf = pygame.image.frombuffer(bgr_buffer, (4, 4), "BGR", pitch=16) - self.assertEqual(bgr_surf.get_at((0, 0)), pygame.Color(255, 10, 20)) - self.assertEqual(bgr_surf.get_at((1, 1)), pygame.Color(255, 255, 255)) - self.assertEqual(bgr_surf.get_at((2, 2)), pygame.Color(0, 0, 0)) - self.assertEqual(bgr_surf.get_at((3, 3)), pygame.Color(50, 200, 20)) - - def test_frombuffer_pitched_BGRA(self): - # fmt: off - bgra_buffer = bytes([ - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 0, 0, 0, 0, # Padding - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 0, 0, 0, 0, # Padding - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 0, # Padding - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 0, 0, 0, 0, # Padding - ]) - # fmt: on - - bgra_surf = pygame.image.frombuffer(bgra_buffer, (4, 4), "BGRA", pitch=20) - self.assertEqual(bgra_surf.get_at((0, 0)), pygame.Color(20, 10, 255, 200)) - self.assertEqual(bgra_surf.get_at((1, 1)), pygame.Color(255, 255, 255, 127)) - self.assertEqual(bgra_surf.get_at((2, 2)), pygame.Color(0, 0, 0, 79)) - self.assertEqual(bgra_surf.get_at((3, 3)), pygame.Color(20, 200, 50, 255)) - - def test_frombuffer_pitched_RGBX(self): - # fmt: off - rgbx_buffer = bytes([ - 255, 10, 20, 255, - 255, 10, 20, 255, - 255, 10, 20, 255, - 255, 10, 20, 255, - 0, 0, 0, 0, # Padding - 255, 255, 255, 255, - 255, 255, 255, 255, - 255, 255, 255, 255, - 255, 255, 255, 255, - 0, 0, 0, 0, # Padding - 0, 0, 0, 255, - 0, 0, 0, 255, - 0, 0, 0, 255, - 0, 0, 0, 255, - 0, 0, 0, 0, # Padding - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 0, 0, 0, 0, # Padding - ]) - # fmt: on - - rgbx_surf = pygame.image.frombuffer(rgbx_buffer, (4, 4), "RGBX", pitch=20) - self.assertEqual(rgbx_surf.get_at((0, 0)), pygame.Color(255, 10, 20, 255)) - self.assertEqual(rgbx_surf.get_at((1, 1)), pygame.Color(255, 255, 255, 255)) - self.assertEqual(rgbx_surf.get_at((2, 2)), pygame.Color(0, 0, 0, 255)) - self.assertEqual(rgbx_surf.get_at((3, 3)), pygame.Color(50, 200, 20, 255)) - - def test_frombuffer_pitched_RGBA(self): - # fmt: off - rgba_buffer = bytes([ - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 255, 10, 20, 200, - 0, 0, 0, 0, # Padding - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 255, 255, 255, 127, - 0, 0, 0, 0, # Padding - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 79, - 0, 0, 0, 0, # Padding - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 50, 200, 20, 255, - 0, 0, 0, 0, # Padding - ]) - # fmt: on - - rgba_surf = pygame.image.frombuffer(rgba_buffer, (4, 4), "RGBA", pitch=20) - self.assertEqual(rgba_surf.get_at((0, 0)), pygame.Color(255, 10, 20, 200)) - self.assertEqual(rgba_surf.get_at((1, 1)), pygame.Color(255, 255, 255, 127)) - self.assertEqual(rgba_surf.get_at((2, 2)), pygame.Color(0, 0, 0, 79)) - self.assertEqual(rgba_surf.get_at((3, 3)), pygame.Color(50, 200, 20, 255)) - - def test_frombuffer_pitched_ARGB(self): - # fmt: off - argb_buffer = bytes([ - 200, 255, 10, 20, - 200, 255, 10, 20, - 200, 255, 10, 20, - 200, 255, 10, 20, - 0, 0, 0, 0, # Padding - 127, 255, 255, 255, - 127, 255, 255, 255, - 127, 255, 255, 255, - 127, 255, 255, 255, - 0, 0, 0, 0, # Padding - 79, 0, 0, 0, - 79, 0, 0, 0, - 79, 0, 0, 0, - 79, 0, 0, 0, - 0, 0, 0, 0, # Padding - 255, 50, 200, 20, - 255, 50, 200, 20, - 255, 50, 200, 20, - 255, 50, 200, 20, - 0, 0, 0, 0, # Padding - ]) - # fmt: on - - argb_surf = pygame.image.frombuffer(argb_buffer, (4, 4), "ARGB", pitch=20) - self.assertEqual(argb_surf.get_at((0, 0)), pygame.Color(255, 10, 20, 200)) - self.assertEqual(argb_surf.get_at((1, 1)), pygame.Color(255, 255, 255, 127)) - self.assertEqual(argb_surf.get_at((2, 2)), pygame.Color(0, 0, 0, 79)) - self.assertEqual(argb_surf.get_at((3, 3)), pygame.Color(50, 200, 20, 255)) - def test_get_extended(self): # Create a png file and try to load it. If it cannot, get_extended() should return False raw_image = [] @@ -1290,20 +1194,11 @@ class ImageModuleTest(unittest.TestCase): ("purple.xpm", (255, 0, 255, 255)), ("black.ppm", (0, 0, 0, 255)), ("grey.pgm", (120, 120, 120, 255)), - ("white.pbm", (255, 255, 255, 255)), ("teal.svg", (0, 128, 128, 255)), ("crimson.pnm", (220, 20, 60, 255)), ("scarlet.webp", (252, 14, 53, 255)), - ("tomato.xcf", (255, 99, 71, 255)), ] - if pygame.image.get_sdl_image_version() > (2, 0, 5): - filename_expected_color.append(("purple.qoi", (159, 38, 240, 255))) - - # SDL_image 2.8.0 and 2.8.1 have an LBM file loading regression - if not (2, 8, 0) <= pygame.image.get_sdl_image_version() < (2, 8, 2): - filename_expected_color.append(("magenta.lbm", (255, 0, 255, 255))) - for filename, expected_color in filename_expected_color: if filename.endswith("svg") and sdl_image_svg_jpeg_save_bug: # SDL_image 2.0.5 and older has an svg loading bug on big @@ -1318,116 +1213,6 @@ class ImageModuleTest(unittest.TestCase): surf = pygame.image.load_extended(example_path("data/" + filename)) self.assertEqual(surf.get_at((0, 0)), expected_color) - @unittest.skipIf( - pygame.image.get_sdl_image_version() < (2, 6, 0), - "load_sized_svg requires SDL_image 2.6.0+", - ) - def test_load_sized_svg(self): - EXPECTED_COLOR = (0, 128, 128, 255) - EXPECTED_ASPECT_RATIO = pygame.Vector2(1, 1).normalize() - for size in ( - (10, 10), - [100, 100], - pygame.Vector2(1, 1), - [4, 2], - (1000, 30), - ): - with self.subTest( - f"Test loading SVG with size", - size=size, - ): - # test with both keywords and no keywords - surf = pygame.image.load_sized_svg(example_path("data/teal.svg"), size) - surf_kw = pygame.image.load_sized_svg( - file=example_path("data/teal.svg"), size=size - ) - self.assertEqual(surf.get_at((0, 0)), EXPECTED_COLOR) - self.assertEqual(surf_kw.get_at((0, 0)), EXPECTED_COLOR) - ret_size = surf.get_size() - self.assertEqual(surf_kw.get_size(), ret_size) - - # test the returned surface exactly fits the size box - self.assertTrue( - (ret_size[0] == size[0] and ret_size[1] <= size[1]) - or (ret_size[1] == size[1] and ret_size[0] <= size[0]), - f"{ret_size = } must exactly fit {size = }", - ) - - # test that aspect ratio is maintained - self.assertEqual( - pygame.Vector2(ret_size).normalize(), EXPECTED_ASPECT_RATIO - ) - - @unittest.skipIf( - pygame.image.get_sdl_image_version() < (2, 6, 0), - "load_sized_svg requires SDL_image 2.6.0+", - ) - def test_load_sized_svg_erroring(self): - for type_error_size in ( - [100], - (0, 0, 10, 3), - "foo", - pygame.Vector3(-3, 10, 10), - ): - with self.subTest( - f"Test TypeError", - type_error_size=type_error_size, - ): - self.assertRaises( - TypeError, - pygame.image.load_sized_svg, - example_path("data/teal.svg"), - type_error_size, - ) - - for value_error_size in ( - [100, 0], - (0, 0), - [-2, -1], - pygame.Vector2(-3, 10), - ): - with self.subTest( - f"Test ValueError", - value_error_size=value_error_size, - ): - self.assertRaises( - ValueError, - pygame.image.load_sized_svg, - example_path("data/teal.svg"), - value_error_size, - ) - - @unittest.skipIf( - pygame.image.get_sdl_image_version() < (2, 6, 0), - "load_animation requires SDL_image 2.6.0+", - ) - def test_load_animation(self): - # test loading from a file - SAMPLE_FRAMES = 10 - SAMPLE_DELAY = 150.0 - SAMPLE_SIZE = (312, 312) - gif_path = pathlib.Path(example_path("data/animated_sample.gif")) - for inp in ( - (str(gif_path),), # string path, no namehint - (gif_path,), # pathlib.Path path, no namehint - (io.BytesIO(gif_path.read_bytes()),), # file-like object, no namehint - ( - io.BytesIO(gif_path.read_bytes()), - gif_path.name, - ), # file-like object, with namehint - ): - with self.subTest(f"Test load_animation", inp=inp): - s = pygame.image.load_animation(*inp) - self.assertIsInstance(s, list) - self.assertEqual(len(s), SAMPLE_FRAMES) - for val in s: - self.assertIsInstance(val, tuple) - frame, delay = val - self.assertIsInstance(frame, pygame.Surface) - self.assertEqual(frame.size, SAMPLE_SIZE) - self.assertIsInstance(delay, float) - self.assertEqual(delay, SAMPLE_DELAY) - def test_load_pathlib(self): """works loading using a Path argument.""" path = pathlib.Path(example_path("data/asprite.bmp")) @@ -1456,7 +1241,7 @@ class ImageModuleTest(unittest.TestCase): with open(temp_file_name, "rb") as file: # Test the magic numbers at the start of the file to ensure # they are saved as the correct file type. - self.assertEqual(1, (check_magic(file, magic_hex[fmt.lower()]))) + self.assertEqual(1, (test_magic(file, magic_hex[fmt.lower()]))) # load the file to make sure it was saved correctly loaded_file = pygame.image.load(temp_file_name) self.assertEqual(loaded_file.get_at((0, 0)), surf.get_at((0, 0))) @@ -1469,11 +1254,12 @@ class ImageModuleTest(unittest.TestCase): ) def threads_load(self, images): - for _ in range(10): - with ThreadPoolExecutor(max_workers=20) as executor: - surfs = executor.map(pygame.image.load, images) - for s in surfs: - self.assertIsInstance(s, pygame.Surface) + import pygame.threads + + for i in range(10): + surfs = pygame.threads.tmap(pygame.image.load, images) + for s in surfs: + self.assertIsInstance(s, pygame.Surface) def test_load_png_threads(self): self.threads_load(glob.glob(example_path("data/*.png"))) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/imageext_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/imageext_test.py index b8812aa..c5ce759 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/imageext_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/imageext_test.py @@ -2,12 +2,10 @@ import os import os.path import sys import unittest -from tempfile import TemporaryDirectory -import pygame -import pygame.image -import pygame.pkgdata from pygame.tests.test_utils import example_path +import pygame, pygame.image, pygame.pkgdata + imageext = sys.modules["pygame.imageext"] @@ -54,26 +52,41 @@ class ImageextModuleTest(unittest.TestCase): """non-ASCII unicode""" import shutil - with TemporaryDirectory() as tmpdir: - orig = example_path("data/alien1.png") - temp = os.path.join(tmpdir, "你好.png") - shutil.copy(orig, temp) - imageext.load_extended(temp) + orig = example_path("data/alien1.png") + temp = os.path.join(example_path("data"), "你好.png") + shutil.copy(orig, temp) + try: + im = imageext.load_extended(temp) + finally: + os.remove(temp) def _unicode_save(self, temp_file): im = pygame.Surface((10, 10), 0, 32) + try: + with open(temp_file, "w") as f: + pass + os.remove(temp_file) + except OSError: + raise unittest.SkipTest("the path cannot be opened") + self.assertFalse(os.path.exists(temp_file)) - imageext.save_extended(im, temp_file) - self.assertGreater(os.path.getsize(temp_file), 10) + + try: + imageext.save_extended(im, temp_file) + + self.assertGreater(os.path.getsize(temp_file), 10) + finally: + try: + os.remove(temp_file) + except OSError: + pass def test_save_unicode_path_0(self): """unicode object with ASCII chars""" - with TemporaryDirectory() as tmpdir: - self._unicode_save(os.path.join(tmpdir, "temp_file.png")) + self._unicode_save("temp_file.png") def test_save_unicode_path_1(self): - with TemporaryDirectory() as tmpdir: - self._unicode_save(os.path.join(tmpdir, "你好.png")) + self._unicode_save("你好.png") if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/joystick_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/joystick_test.py index 61eb151..47ce3f8 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/joystick_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/joystick_test.py @@ -1,8 +1,8 @@ import unittest +from pygame.tests.test_utils import question, prompt import pygame import pygame._sdl2.controller -from pygame.tests.test_utils import prompt, question class JoystickTypeTest(unittest.TestCase): @@ -31,10 +31,6 @@ class JoystickTypeTest(unittest.TestCase): self.fail() - def test_Joystick_alias(self): - """Check if pygame.Joystick is present and the correct type.""" - self.assertIs(pygame.Joystick, pygame.joystick.Joystick) - class JoystickModuleTest(unittest.TestCase): def test_get_init(self): @@ -122,7 +118,7 @@ class JoystickModuleTest(unittest.TestCase): try: count = pygame.joystick.get_count() self.assertGreaterEqual( - count, 0, ("joystick.get_count() must return a value >= 0") + count, 0, ("joystick.get_count() must " "return a value >= 0") ) finally: pygame.joystick.quit() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/key_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/key_test.py index 95176cf..1899c73 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/key_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/key_test.py @@ -1,5 +1,4 @@ import os -import platform import time import unittest @@ -8,7 +7,6 @@ import pygame.key # keys that are not tested for const-name match SKIPPED_KEYS = {"K_UNKNOWN"} -SKIPPED_KEYS_NEW = {"K_MODE"} # This is the expected compat output KEY_NAME_COMPAT = { @@ -170,7 +168,6 @@ KEY_NAME_COMPAT = { class KeyModuleTest(unittest.TestCase): @classmethod def setUpClass(cls): - pygame.quit() pygame.init() @classmethod @@ -189,10 +186,9 @@ class KeyModuleTest(unittest.TestCase): """does it import?""" import pygame.key - @unittest.skipIf( - not ("Windows" in platform.system() or "Darwin" in platform.system()), - "Not windows or macOS - we skip.", - ) + # fixme: test_get_focused failing systematically in some linux + # fixme: test_get_focused failing on SDL 2.0.18 on Windows + @unittest.skip("flaky test, and broken on 2.0.18 windows") def test_get_focused(self): # This test fails in SDL2 in some linux # This test was skipped in SDL1. @@ -200,14 +196,14 @@ class KeyModuleTest(unittest.TestCase): self.assertFalse(focused) # No window to focus self.assertIsInstance(focused, int) # Dummy video driver never gets keyboard focus. - if os.environ.get("SDL_VIDEODRIVER") != pygame.NULL_VIDEODRIVER: + if os.environ.get("SDL_VIDEODRIVER") != "dummy": # Positive test, fullscreen with events grabbed display_sizes = pygame.display.list_modes() if display_sizes == -1: display_sizes = [(500, 500)] pygame.display.set_mode(size=display_sizes[-1], flags=pygame.FULLSCREEN) pygame.event.set_grab(True) - # Pump event queue to get window focus on macOS + # Pump event queue to get window focus on macos pygame.event.pump() focused = pygame.key.get_focused() self.assertIsInstance(focused, int) @@ -238,21 +234,13 @@ class KeyModuleTest(unittest.TestCase): states = pygame.key.get_pressed() self.assertEqual(states[pygame.K_RIGHT], 0) - def test_get_just_pressed(self): - pressed_keys = pygame.key.get_just_pressed() - self.assertEqual(pressed_keys[pygame.K_RIGHT], 0) - - def test_get_just_released(self): - released_keys = pygame.key.get_just_released() - self.assertEqual(released_keys[pygame.K_RIGHT], 0) - - def test_get_pressed_not_iter(self): - states = pygame.key.get_pressed() - with self.assertRaises(TypeError): - next(states) - with self.assertRaises(TypeError): - for k in states: - pass + # def test_get_pressed_not_iter(self): + # states = pygame.key.get_pressed() + # with self.assertRaises(TypeError): + # next(states) + # with self.assertRaises(TypeError): + # for k in states: + # pass def test_name_and_key_code(self): for const_name in dir(pygame): @@ -270,7 +258,7 @@ class KeyModuleTest(unittest.TestCase): const_val = getattr(pygame, const_name) # with these tests below, we also make sure that key.name and key.key_code - # can work together and handle each other's outputs + # can work together and handle each others outputs # test positional args self.assertEqual(pygame.key.name(const_val), expected_str_name) @@ -288,8 +276,7 @@ class KeyModuleTest(unittest.TestCase): # This is a test for an implementation detail of name with use_compat=False # If this test breaks in the future for any key, it is safe to put skips on # failing keys (the implementation detail is documented as being unreliable) - if const_name not in SKIPPED_KEYS_NEW: - self.assertEqual(pygame.key.key_code(alt_name), const_val) + self.assertEqual(pygame.key.key_code(alt_name), const_val) self.assertRaises(TypeError, pygame.key.name, "fizzbuzz") self.assertRaises(TypeError, pygame.key.key_code, pygame.K_a) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/mask_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/mask_test.py index 9b7235e..bd7daf5 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/mask_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/mask_test.py @@ -1,14 +1,15 @@ +from collections import OrderedDict import copy import platform import random -import sys import unittest -from collections import OrderedDict +import sys import pygame from pygame.locals import * from pygame.math import Vector2 + IS_PYPY = "PyPy" == platform.python_implementation() @@ -24,7 +25,8 @@ def random_mask(size=(100, 100)): def maskFromSurface(surface, threshold=127): mask = pygame.Mask(surface.get_size()) - if key := surface.get_colorkey(): + key = surface.get_colorkey() + if key: for y in range(surface.get_height()): for x in range(surface.get_width()): if surface.get_at((x + 0.1, y + 0.1)) != key: @@ -197,7 +199,7 @@ class MaskTypeTest(unittest.TestCase): """Ensures masks are created correctly using the fill keyword over a range of sizes. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -707,7 +709,7 @@ class MaskTypeTest(unittest.TestCase): def test_overlap__bit_boundaries(self): """Ensures overlap handles masks of different sizes correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -855,7 +857,7 @@ class MaskTypeTest(unittest.TestCase): def test_overlap_area__bit_boundaries(self): """Ensures overlap_area handles masks of different sizes correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1077,7 +1079,7 @@ class MaskTypeTest(unittest.TestCase): def test_overlap_mask__bit_boundaries(self): """Ensures overlap_mask handles masks of different sizes correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1169,7 +1171,7 @@ class MaskTypeTest(unittest.TestCase): def test_fill__bit_boundaries(self): """Ensures masks of different sizes are filled correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1198,7 +1200,7 @@ class MaskTypeTest(unittest.TestCase): def test_clear__bit_boundaries(self): """Ensures masks of different sizes are cleared correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1273,7 +1275,7 @@ class MaskTypeTest(unittest.TestCase): def test_invert__bit_boundaries(self): """Ensures masks of different sizes are inverted correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1467,7 +1469,7 @@ class MaskTypeTest(unittest.TestCase): def test_draw__bit_boundaries(self): """Ensures draw handles masks of different sizes correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1661,7 +1663,7 @@ class MaskTypeTest(unittest.TestCase): def test_erase__bit_boundaries(self): """Ensures erase handles masks of different sizes correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1740,7 +1742,7 @@ class MaskTypeTest(unittest.TestCase): def test_count__bit_boundaries(self): """Ensures the set bits of different sized masks are counted correctly. - Test masks of different sizes, including: + Tests masks of different sizes, including: -masks 31 to 33 bits wide (32 bit boundaries) -masks 63 to 65 bits wide (64 bit boundaries) """ @@ -1919,9 +1921,17 @@ class MaskTypeTest(unittest.TestCase): self.assertEqual(centroid, expected_centroid) - def todo_test_angle(self): + def test_angle(self): """Ensure a mask's orientation angle is correctly calculated.""" - self.fail() + expected_angle = -45.0 + expected_size = (100, 100) + surface = pygame.Surface(expected_size) + mask = pygame.mask.from_surface(surface) + + angle = mask.angle() # Returns the orientation of the pixels + + self.assertIsInstance(angle, float) + self.assertEqual(angle, expected_angle) def test_angle__empty_mask(self): """Ensure an empty mask's angle is correctly calculated.""" @@ -2569,7 +2579,7 @@ class MaskTypeTest(unittest.TestCase): @unittest.skipIf(IS_PYPY, "Segfaults on pypy") def test_to_surface(self): """Ensures empty and full masks can be drawn onto surfaces.""" - expected_ref_count = (2, 3) + expected_ref_count = 3 size = (33, 65) surface = pygame.Surface(size, SRCALPHA, 32) surface_color = pygame.Color("red") @@ -2583,13 +2593,13 @@ class MaskTypeTest(unittest.TestCase): self.assertIs(to_surface, surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertEqual(to_surface.get_size(), size) assertSurfaceFilled(self, to_surface, expected_color) def test_to_surface__create_surface(self): """Ensures empty and full masks can be drawn onto a created surface.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 size = (33, 65) @@ -2606,7 +2616,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), size) @@ -2614,7 +2624,7 @@ class MaskTypeTest(unittest.TestCase): def test_to_surface__surface_param(self): """Ensures to_surface accepts a surface arg/kwarg.""" - expected_ref_count = (3, 4) + expected_ref_count = 4 expected_color = pygame.Color("white") surface_color = pygame.Color("red") size = (5, 3) @@ -2632,13 +2642,13 @@ class MaskTypeTest(unittest.TestCase): self.assertIs(to_surface, surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertEqual(to_surface.get_size(), size) assertSurfaceFilled(self, to_surface, expected_color) def test_to_surface__setsurface_param(self): """Ensures to_surface accepts a setsurface arg/kwarg.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 expected_color = pygame.Color("red") @@ -2657,7 +2667,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), size) @@ -2665,7 +2675,7 @@ class MaskTypeTest(unittest.TestCase): def test_to_surface__unsetsurface_param(self): """Ensures to_surface accepts a unsetsurface arg/kwarg.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 expected_color = pygame.Color("red") @@ -2683,7 +2693,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), size) @@ -2691,7 +2701,7 @@ class MaskTypeTest(unittest.TestCase): def test_to_surface__setcolor_param(self): """Ensures to_surface accepts a setcolor arg/kwarg.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 expected_color = pygame.Color("red") @@ -2707,7 +2717,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), size) @@ -2727,8 +2737,8 @@ class MaskTypeTest(unittest.TestCase): assertSurfaceFilled(self, to_surface, expected_color) def test_to_surface__unsetcolor_param(self): - """Ensures to_surface accepts an unsetcolor arg/kwarg.""" - expected_ref_count = (1, 2) + """Ensures to_surface accepts a unsetcolor arg/kwarg.""" + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 expected_color = pygame.Color("red") @@ -2746,7 +2756,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), size) @@ -2767,7 +2777,7 @@ class MaskTypeTest(unittest.TestCase): def test_to_surface__dest_param(self): """Ensures to_surface accepts a dest arg/kwarg.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 default_surface_color = (0, 0, 0, 0) @@ -2791,7 +2801,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), size) @@ -2820,9 +2830,10 @@ class MaskTypeTest(unittest.TestCase): assertSurfaceFilled(self, to_surface, expected_color, mask_rect) assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, mask_rect) + @unittest.expectedFailure def test_to_surface__area_param(self): """Ensures to_surface accepts an area arg/kwarg.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 default_surface_color = (0, 0, 0, 0) @@ -2845,294 +2856,12 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), size) assertSurfaceFilled(self, to_surface, expected_color) - def test_to_surface__area_output(self): - dst = pygame.Surface((2, 2)) - mask = pygame.mask.Mask((2, 2), fill=True) - - white = (255, 255, 255, 255) - black = (0, 0, 0, 255) - - # make sure the surface is black, this is to make sure the test surface and mask are different colors - self.assertEqual(dst.get_at((0, 0)), black) - # make sure the mask is set and the default color after conversion is white - self.assertEqual(mask.to_surface().get_at((0, 0)), white) - - test_areas_plus_destinations_and_expected_pattern = [ - [{"dest": (0, 0), "area": None}, [[white, white], [white, white]]], - [{"dest": (0, 0), "area": (0, 0, 1, 1)}, [[white, black], [black, black]]], - [{"dest": (0, 0), "area": (0, 0, 2, 2)}, [[white, white], [white, white]]], - [{"dest": (1, 0), "area": (0, 0, 1, 2)}, [[black, white], [black, white]]], - [{"dest": (0, 0), "area": (0, 0, 0, 0)}, [[black, black], [black, black]]], - [{"dest": (1, 0), "area": (-1, 0, 1, 1)}, [[black, black], [black, black]]], - [{"dest": (0, 0), "area": (-1, 0, 2, 1)}, [[white, black], [black, black]]], - [ - {"dest": (1, 1), "area": (-2, -2, 1, 1)}, - [[black, black], [black, black]], - ], - [ - {"dest": (0, 1), "area": (0, 0, 50, 50)}, - [[black, black], [white, white]], - ], - [ - {"dest": (-1, 0), "area": (-1, 0, 2, 2)}, - [[black, black], [black, black]], - ], - [ - {"dest": (0, -1), "area": (-1, 0, 3, 2)}, - [[white, white], [black, black]], - ], - [{"dest": (0, 0), "area": (2, 2, 2, 2)}, [[black, black], [black, black]]], - [ - {"dest": (-5, -5), "area": (-5, -5, 6, 6)}, - [[black, black], [black, black]], - ], - [ - {"dest": (-5, -5), "area": (-5, -5, 1, 1)}, - [[black, black], [black, black]], - ], - ] - - for kwargs, pattern in test_areas_plus_destinations_and_expected_pattern: - surface = dst.copy() - mask.to_surface(surface=surface, **kwargs) - for y, row in enumerate(pattern): - for x, value in enumerate(row): - self.assertEqual(surface.get_at((x, y)), value) - - def create_surface_from_array( - self, size: tuple[int, int], array: list[list[pygame.Color]], *args, **kwargs - ) -> pygame.Surface: - assert (len(array), len(array[0])) == size - - surface = pygame.Surface(size, *args, **kwargs) - for y, row in enumerate(array): - for x, color in enumerate(row): - surface.set_at((x, y), color) - - return surface - - def assert_surface_matches_array( - self, surface: pygame.Surface, array: list[list[pygame.Color]] - ) -> None: - assert (len(array), len(array[0])) == surface.get_size() - - for y, row in enumerate(array): - for x, color in enumerate(row): - with self.subTest(x=x, y=y, color=color): - self.assertEqual(color, surface.get_at((x, y))) - - def test_to_surface__area_with_setsurface_create_new(self): - c_1 = pygame.Color("red") - c_2 = pygame.Color("green") - size = (4, 4) - - mask = pygame.Mask(size, fill=True) - - set_surface = self.create_surface_from_array( - size=size, - array=[ - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_1, c_1], - [c_1, c_1, c_1, c_1], - ], - flags=SRCALPHA, - ) - - area = pygame.Rect(0, 0, 2, 2) - expected_pixels = [ - [c_1, c_1], - [c_1, c_1], - ] - surface = mask.to_surface(area=area, setsurface=set_surface) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(1, 1, 2, 2) - expected_pixels = [ - [c_1, c_2], - [c_1, c_1], - ] - surface = mask.to_surface(area=area, setsurface=set_surface) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(2, 1, 2, 2) - expected_pixels = [ - [c_2, c_2], - [c_1, c_1], - ] - surface = mask.to_surface(area=area, setsurface=set_surface) - self.assert_surface_matches_array(surface, expected_pixels) - - def test_to_surface__area_with_unsetsurface_create_new(self): - c_1 = pygame.Color("red") - c_2 = pygame.Color("green") - size = (4, 4) - - mask = pygame.Mask(size, fill=False) - - unset_surface = self.create_surface_from_array( - size=size, - array=[ - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_1, c_1], - [c_1, c_1, c_1, c_1], - ], - flags=SRCALPHA, - ) - - area = pygame.Rect(0, 0, 2, 2) - expected_pixels = [ - [c_1, c_1], - [c_1, c_1], - ] - surface = mask.to_surface(area=area, unsetsurface=unset_surface) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(1, 1, 2, 2) - expected_pixels = [ - [c_1, c_2], - [c_1, c_1], - ] - surface = mask.to_surface(area=area, unsetsurface=unset_surface) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(2, 1, 2, 2) - expected_pixels = [ - [c_2, c_2], - [c_1, c_1], - ] - surface = mask.to_surface(area=area, unsetsurface=unset_surface) - self.assert_surface_matches_array(surface, expected_pixels) - - def test_to_surface__area_with_setsurface_to_destination(self): - c_1 = pygame.Color("red") - c_2 = pygame.Color("green") - c_3 = pygame.Color("blue") - size = (4, 4) - - mask = pygame.Mask(size, fill=True) - - set_surface = self.create_surface_from_array( - size=size, - array=[ - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_1, c_1], - [c_1, c_1, c_1, c_1], - ], - ) - - area = pygame.Rect(0, 0, 2, 2) - expected_pixels = [ - [c_1, c_1, c_3, c_3], - [c_1, c_1, c_3, c_3], - [c_3, c_3, c_3, c_3], - [c_3, c_3, c_3, c_3], - ] - surface = pygame.Surface(size) - surface.fill(c_3) - surface = mask.to_surface(surface=surface, area=area, setsurface=set_surface) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(1, 1, 2, 2) - dest = (2, 0) - expected_pixels = [ - [c_3, c_3, c_1, c_2], - [c_3, c_3, c_1, c_1], - [c_3, c_3, c_3, c_3], - [c_3, c_3, c_3, c_3], - ] - surface = pygame.Surface(size) - surface.fill(c_3) - surface = mask.to_surface( - surface=surface, dest=dest, area=area, setsurface=set_surface - ) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(2, 1, 2, 2) - dest = (1, 1) - expected_pixels = [ - [c_3, c_3, c_3, c_3], - [c_3, c_2, c_2, c_3], - [c_3, c_1, c_1, c_3], - [c_3, c_3, c_3, c_3], - ] - surface = pygame.Surface(size) - surface.fill(c_3) - surface = mask.to_surface( - surface=surface, dest=dest, area=area, setsurface=set_surface - ) - self.assert_surface_matches_array(surface, expected_pixels) - - def test_to_surface__area_with_unsetsurface_to_destination(self): - c_1 = pygame.Color("red") - c_2 = pygame.Color("green") - c_3 = pygame.Color("blue") - size = (4, 4) - - mask = pygame.Mask(size, fill=False) - - unset_surface = self.create_surface_from_array( - size=size, - array=[ - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_2, c_2], - [c_1, c_1, c_1, c_1], - [c_1, c_1, c_1, c_1], - ], - ) - - area = pygame.Rect(0, 0, 2, 2) - expected_pixels = [ - [c_1, c_1, c_3, c_3], - [c_1, c_1, c_3, c_3], - [c_3, c_3, c_3, c_3], - [c_3, c_3, c_3, c_3], - ] - surface = pygame.Surface(size) - surface.fill(c_3) - surface = mask.to_surface( - surface=surface, area=area, unsetsurface=unset_surface - ) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(1, 1, 2, 2) - dest = (2, 0) - expected_pixels = [ - [c_3, c_3, c_1, c_2], - [c_3, c_3, c_1, c_1], - [c_3, c_3, c_3, c_3], - [c_3, c_3, c_3, c_3], - ] - surface = pygame.Surface(size) - surface.fill(c_3) - surface = mask.to_surface( - surface=surface, dest=dest, area=area, unsetsurface=unset_surface - ) - self.assert_surface_matches_array(surface, expected_pixels) - - area = pygame.Rect(2, 1, 2, 2) - dest = (1, 1) - expected_pixels = [ - [c_3, c_3, c_3, c_3], - [c_3, c_2, c_2, c_3], - [c_3, c_1, c_1, c_3], - [c_3, c_3, c_3, c_3], - ] - surface = pygame.Surface(size) - surface.fill(c_3) - surface = mask.to_surface( - surface=surface, dest=dest, area=area, unsetsurface=unset_surface - ) - self.assert_surface_matches_array(surface, expected_pixels) - def test_to_surface__area_default(self): """Ensures the default area is correct.""" expected_color = pygame.Color("white") @@ -3492,6 +3221,7 @@ class MaskTypeTest(unittest.TestCase): assertSurfaceFilled(self, to_surface, expected_color) + @unittest.expectedFailure def test_to_surface__valid_area_formats(self): """Ensures to_surface handles valid area formats correctly.""" size = (3, 5) @@ -3524,6 +3254,7 @@ class MaskTypeTest(unittest.TestCase): assertSurfaceFilled(self, to_surface, expected_color, area_rect) assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, area_rect) + @unittest.expectedFailure def test_to_surface__invalid_area_formats(self): """Ensures to_surface handles invalid area formats correctly.""" mask = pygame.mask.Mask((3, 5)) @@ -3539,9 +3270,10 @@ class MaskTypeTest(unittest.TestCase): ) for area in invalid_areas: - with self.assertRaisesRegex(TypeError, "invalid rectstyle argument"): - mask.to_surface(area=area) + with self.assertRaisesRegex(TypeError, "invalid area argument"): + unused_to_surface = mask.to_surface(area=area) + @unittest.expectedFailure def test_to_surface__negative_sized_area_rect(self): """Ensures to_surface correctly handles negative sized area rects.""" size = (3, 5) @@ -3566,6 +3298,7 @@ class MaskTypeTest(unittest.TestCase): assertSurfaceFilled(self, to_surface, expected_color, area) assertSurfaceFilledIgnoreArea(self, to_surface, surface_color, area) + @unittest.expectedFailure def test_to_surface__zero_sized_area_rect(self): """Ensures to_surface correctly handles zero sized area rects.""" size = (3, 5) @@ -3591,10 +3324,10 @@ class MaskTypeTest(unittest.TestCase): """Ensures to_surface works with a default surface value and combinations of other parameters. - This tests many parameter combinations with full and empty + This tests many different parameter combinations with full and empty masks. """ - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 size = (5, 3) @@ -3661,7 +3394,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn( + self.assertEqual( sys.getrefcount(to_surface), expected_ref_count ) self.assertTrue(to_surface.get_flags() & expected_flag) @@ -3675,10 +3408,10 @@ class MaskTypeTest(unittest.TestCase): """Ensures to_surface works with a surface value and combinations of other parameters. - This tests many parameter combinations with full and empty + This tests many different parameter combinations with full and empty masks. """ - expected_ref_count = (3, 4) + expected_ref_count = 4 expected_flag = SRCALPHA expected_depth = 32 size = (5, 3) @@ -3748,7 +3481,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIs(to_surface, surface) if not IS_PYPY: - self.assertIn( + self.assertEqual( sys.getrefcount(to_surface), expected_ref_count ) self.assertTrue(to_surface.get_flags() & expected_flag) @@ -3759,7 +3492,7 @@ class MaskTypeTest(unittest.TestCase): assertSurfaceFilled(self, to_surface, expected_color) def test_to_surface__set_and_unset_bits(self): - """Ensures that to_surface works correctly with set/unset bits + """Ensures that to_surface works correctly with with set/unset bits when using the defaults for setcolor and unsetcolor. """ default_setcolor = pygame.Color("white") @@ -3796,7 +3529,7 @@ class MaskTypeTest(unittest.TestCase): to_surface.unlock() def test_to_surface__set_and_unset_bits_with_setsurface_unsetsurface(self): - """Ensures that to_surface works correctly with set/unset bits + """Ensures that to_surface works correctly with with set/unset bits when using setsurface and unsetsurface. """ width, height = size = (10, 20) @@ -4778,12 +4511,12 @@ class MaskTypeTest(unittest.TestCase): default_setcolor = pygame.Color("white") default_unsetcolor = pygame.Color("black") - directions = [ - [(s, 0) for s in range(-SIDE, SIDE + 1)], # left to right - [(0, s) for s in range(-SIDE, SIDE + 1)], # top to bottom - [(s, s) for s in range(-SIDE, SIDE + 1)], # topleft to bottomright diag - [(-s, s) for s in range(-SIDE, SIDE + 1)], # topright to bottomleft diag - ] + directions = ( + ((s, 0) for s in range(-SIDE, SIDE + 1)), # left to right + ((0, s) for s in range(-SIDE, SIDE + 1)), # top to bottom + ((s, s) for s in range(-SIDE, SIDE + 1)), # topleft to bottomright diag + ((-s, s) for s in range(-SIDE, SIDE + 1)), # topright to bottomleft diag + ) for fill in (True, False): mask = pygame.mask.Mask((SIDE, SIDE), fill=fill) @@ -4802,6 +4535,8 @@ class MaskTypeTest(unittest.TestCase): self, to_surface, surface_color, overlap_rect ) + @unittest.expectedFailure + @unittest.skipIf(IS_PYPY, "Segfaults on pypy") def test_to_surface__area_locations(self): """Ensures area rects can be different locations on/off the mask.""" SIDE = 7 @@ -4811,12 +4546,12 @@ class MaskTypeTest(unittest.TestCase): default_setcolor = pygame.Color("white") default_unsetcolor = pygame.Color("black") - directions = [ - [(s, 0) for s in range(-SIDE, SIDE + 1)], # left to right - [(0, s) for s in range(-SIDE, SIDE + 1)], # top to bottom - [(s, s) for s in range(-SIDE, SIDE + 1)], # topleft to bottomright diag - [(-s, s) for s in range(-SIDE, SIDE + 1)], # topright to bottomleft diag - ] + directions = ( + ((s, 0) for s in range(-SIDE, SIDE + 1)), # left to right + ((0, s) for s in range(-SIDE, SIDE + 1)), # top to bottom + ((s, s) for s in range(-SIDE, SIDE + 1)), # topleft to bottomright diag + ((-s, s) for s in range(-SIDE, SIDE + 1)), # topright to bottomleft diag + ) for fill in (True, False): mask = pygame.mask.Mask((SIDE, SIDE), fill=fill) @@ -4838,6 +4573,7 @@ class MaskTypeTest(unittest.TestCase): self, to_surface, surface_color, overlap_rect ) + @unittest.expectedFailure def test_to_surface__dest_and_area_locations(self): """Ensures dest/area values can be different locations on/off the surface/mask. @@ -4851,16 +4587,16 @@ class MaskTypeTest(unittest.TestCase): default_setcolor = pygame.Color("white") default_unsetcolor = pygame.Color("black") - dest_directions = [ - [(s, 0) for s in range(-SIDE, SIDE + 1)], # left to right - [(0, s) for s in range(-SIDE, SIDE + 1)], # top to bottom - [(s, s) for s in range(-SIDE, SIDE + 1)], # topleft to bottomright diag - [(-s, s) for s in range(-SIDE, SIDE + 1)], # topright to bottomleft diag - ] + dest_directions = ( + ((s, 0) for s in range(-SIDE, SIDE + 1)), # left to right + ((0, s) for s in range(-SIDE, SIDE + 1)), # top to bottom + ((s, s) for s in range(-SIDE, SIDE + 1)), # topleft to bottomright diag + ((-s, s) for s in range(-SIDE, SIDE + 1)), # topright to bottomleft diag + ) # Using only the topleft to bottomright diagonal to test the area (to # reduce the number of loop iterations). - area_positions = dest_directions[2] + area_positions = list(dest_directions[2]) for fill in (True, False): mask = pygame.mask.Mask((SIDE, SIDE), fill=fill) @@ -4891,6 +4627,7 @@ class MaskTypeTest(unittest.TestCase): self, to_surface, surface_color, dest_overlap_rect ) + @unittest.expectedFailure def test_to_surface__area_sizes(self): """Ensures area rects can be different sizes.""" SIDE = 7 @@ -5350,6 +5087,8 @@ class MaskTypeTest(unittest.TestCase): self, to_surface, surface_color, mask_rect ) + @unittest.expectedFailure + @unittest.skipIf(IS_PYPY, "Segfaults on pypy") def test_to_surface__area_on_mask(self): """Ensures area values on the mask work correctly when using the defaults for setcolor and unsetcolor. @@ -5382,6 +5121,7 @@ class MaskTypeTest(unittest.TestCase): self, to_surface, surface_color, overlap_rect ) + @unittest.expectedFailure def test_to_surface__area_on_mask_with_setsurface_unsetsurface(self): """Ensures area values on the mask work correctly when using setsurface and unsetsurface. @@ -5438,6 +5178,8 @@ class MaskTypeTest(unittest.TestCase): self, to_surface, surface_color, overlap_rect ) + @unittest.expectedFailure + @unittest.skipIf(IS_PYPY, "Segfaults on pypy") def test_to_surface__area_off_mask(self): """Ensures area values off the mask work correctly when using the defaults for setcolor and unsetcolor. @@ -5473,6 +5215,8 @@ class MaskTypeTest(unittest.TestCase): self, to_surface, surface_color, overlap_rect ) + @unittest.expectedFailure + @unittest.skipIf(IS_PYPY, "Segfaults on pypy") def test_to_surface__area_off_mask_with_setsurface_unsetsurface(self): """Ensures area values off the mask work correctly when using setsurface and unsetsurface. @@ -5529,7 +5273,7 @@ class MaskTypeTest(unittest.TestCase): def test_to_surface__surface_with_zero_size(self): """Ensures zero sized surfaces are handled correctly.""" - expected_ref_count = (2, 3) + expected_ref_count = 3 size = (0, 0) surface = pygame.Surface(size) mask = pygame.mask.Mask((3, 4), fill=True) @@ -5538,12 +5282,12 @@ class MaskTypeTest(unittest.TestCase): self.assertIs(to_surface, surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertEqual(to_surface.get_size(), size) def test_to_surface__setsurface_with_zero_size(self): """Ensures zero sized setsurfaces are handled correctly.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 expected_color = pygame.Color("white") # Default setcolor. @@ -5555,7 +5299,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), mask_size) @@ -5563,7 +5307,7 @@ class MaskTypeTest(unittest.TestCase): def test_to_surface__unsetsurface_with_zero_size(self): """Ensures zero sized unsetsurfaces are handled correctly.""" - expected_ref_count = (1, 2) + expected_ref_count = 2 expected_flag = SRCALPHA expected_depth = 32 expected_color = pygame.Color("black") # Default unsetcolor. @@ -5575,7 +5319,7 @@ class MaskTypeTest(unittest.TestCase): self.assertIsInstance(to_surface, pygame.Surface) if not IS_PYPY: - self.assertIn(sys.getrefcount(to_surface), expected_ref_count) + self.assertEqual(sys.getrefcount(to_surface), expected_ref_count) self.assertTrue(to_surface.get_flags() & expected_flag) self.assertEqual(to_surface.get_bitsize(), expected_depth) self.assertEqual(to_surface.get_size(), mask_size) @@ -6329,7 +6073,7 @@ class MaskModuleTest(unittest.TestCase): This test checks the masks created by the from_surface function using 16 and 32 bit surfaces. Each alpha value (0-255) is tested against - several threshold values. + several different threshold values. Note: On 16 bit surface the requested alpha value can differ from what is actually set. This test uses the value read from the surface. """ @@ -6348,7 +6092,7 @@ class MaskModuleTest(unittest.TestCase): if depth < 32: # On surfaces with depths < 32 the requested alpha can be - # different from what gets set. Use the value read from the + # different than what gets set. Use the value read from the # surface. alpha = surface.get_at((0, 0))[3] @@ -6443,7 +6187,7 @@ class MaskModuleTest(unittest.TestCase): # special handling. for threshold in range(threshold_count): # On surfaces with depths < 32 the requested alpha can be different - # from what gets set. Use the value read from the surface. + # than what gets set. Use the value read from the surface. alpha = surface.get_at((threshold, 0))[3] if alpha not in alpha_thresholds: @@ -6512,7 +6256,7 @@ class MaskModuleTest(unittest.TestCase): for colorkey in colorkeys: surface.set_colorkey(colorkey) # With some depths (i.e. 8 and 16) the actual colorkey can be - # different from what was requested via the set. + # different than what was requested via the set. surface.fill(surface.get_colorkey()) mask = pygame.mask.from_surface(surface) @@ -6590,19 +6334,21 @@ class MaskModuleTest(unittest.TestCase): def test_from_threshold(self): """Does mask.from_threshold() work correctly?""" - bpp = [16, 24, 32] + a = [16, 24, 32] - for i in bpp: + for i in a: surf = pygame.surface.Surface((70, 70), 0, i) surf.fill((100, 50, 200), (20, 20, 20, 20)) mask = pygame.mask.from_threshold( surf, (100, 50, 200, 255), (10, 10, 10, 255) ) + rects = mask.get_bounding_rects() + self.assertEqual(mask.count(), 400) self.assertEqual(mask.get_bounding_rects(), [pygame.Rect((20, 20, 20, 20))]) - for i in bpp: + for i in a: surf = pygame.surface.Surface((70, 70), 0, i) surf2 = pygame.surface.Surface((70, 70), 0, i) surf.fill((100, 100, 100)) @@ -6619,10 +6365,6 @@ class MaskModuleTest(unittest.TestCase): self.assertEqual(mask.count(), 100) self.assertEqual(mask.get_bounding_rects(), [pygame.Rect((40, 40, 10, 10))]) - for color in [(20, 20, 20), 10, "green", pygame.Color("blue")]: - surf = pygame.surface.Surface((10, 10)) - pygame.mask.from_threshold(surf, color, color) - def test_zero_size_from_surface(self): """Ensures from_surface can create masks from zero sized surfaces.""" for size in ((100, 0), (0, 100), (0, 0)): diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/math_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/math_test.py index 45b7728..3cedf23 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/math_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/math_test.py @@ -6,17 +6,32 @@ from collections.abc import Collection, Sequence import pygame.math from pygame.math import Vector2, Vector3 -try: - import numpy -except ModuleNotFoundError: - numpy = None - IS_PYPY = "PyPy" == platform.python_implementation() class MathModuleTest(unittest.TestCase): """Math module tests.""" + def test_lerp(self): + result = pygame.math.lerp(10, 100, 0.5) # 55.0 + self.assertAlmostEqual(result, 55.0) + + result = pygame.math.lerp(10, 100, 0.0) # 10 + self.assertAlmostEqual(result, 10.0) + + result = pygame.math.lerp(10, 100, 1.0) # 100 + self.assertAlmostEqual(result, 100.0) + + # Not enough args + self.assertRaises(TypeError, pygame.math.lerp, 1) + + # Wrong arg type + self.assertRaises(TypeError, pygame.math.lerp, "str", "str", "str") + + # Percent outside range [0, 1] + self.assertRaises(ValueError, pygame.math.lerp, 10, 100, 1.1) + self.assertRaises(ValueError, pygame.math.lerp, 10, 100, -0.5) + def test_clamp(self): """Test clamp function.""" @@ -57,154 +72,9 @@ class MathModuleTest(unittest.TestCase): # Error tests # Not enough args self.assertRaises(TypeError, pygame.math.clamp, 10) - # Non-numeric args + # Non numeric args self.assertRaises(TypeError, pygame.math.clamp, "hello", "py", "thon") - def test_lerp(self): - a = 0.0 - b = 10.0 - self.assertEqual(pygame.math.lerp(a, b, 0.5), 5.0) - - a = 0.0 - b = 10.0 - self.assertEqual(pygame.math.lerp(a, b, 0.1), 1.0) - - a = -10.0 - b = 10.0 - self.assertEqual(pygame.math.lerp(a, b, 0.5), 0.0) - - a = -10.0 - b = 10.0 - self.assertEqual(pygame.math.lerp(a, b, 1.5), 10.0) - - a = -10.0 - b = 10.0 - self.assertEqual(pygame.math.lerp(a, b, 1.5, False), 20.0) - - with self.assertRaises(TypeError): - a = Vector2(0, 0) - b = Vector2(10.0, 10.0) - pygame.math.lerp(a, b, 0.5) - - with self.assertRaises(TypeError): - a = 1 - b = 2 - pygame.math.lerp(a, b, Vector2(0, 0)) - - def test_invlerp(self): - a = 0.0 - b = 10.0 - self.assertEqual(pygame.math.invlerp(a, b, 5.0), 0.5) - - a = 0.0 - b = 10.0 - self.assertEqual(pygame.math.invlerp(a, b, 0.1), 0.01) - - a = -10.0 - b = 10.0 - self.assertEqual(pygame.math.invlerp(a, b, 0.5), 0.525) - - a = -10.0 - b = 10.0 - self.assertEqual(pygame.math.invlerp(a, b, 1.5), 0.575) - - a = 0.0 - b = 100.0 - self.assertEqual(pygame.math.invlerp(a, b, 0.25), 0.0025) - - with self.assertRaises(TypeError): - a = Vector2(0, 0) - b = Vector2(10.0, 10.0) - pygame.math.invlerp(a, b, 0.5) - - with self.assertRaises(TypeError): - a = 1 - b = 2 - pygame.math.invlerp(a, b, Vector2(0, 0)) - - with self.assertRaises(ValueError): - a = 5 - b = 5 - pygame.math.invlerp(a, b, 5) - - with self.assertRaises(TypeError): - a = 12**300 - b = 11**30 - pygame.math.invlerp(a, b, 1) - - def test_remap(self): - a = 0.0 - b = 10.0 - c = 0.0 - d = 100.0 - self.assertEqual(pygame.math.remap(a, b, c, d, 1.0), 10.0) - - a = 0.0 - b = 10.0 - c = 0.0 - d = 100.0 - self.assertEqual(pygame.math.remap(a, b, c, d, -1.0), -10.0) - - a = -10.0 - b = 10.0 - c = -20.0 - d = 20.0 - self.assertEqual(pygame.math.remap(a, b, c, d, 0.0), 0.0) - - a = -10.0 - b = 10.0 - c = 10.0 - d = 110.0 - self.assertEqual(pygame.math.remap(a, b, c, d, -8.0), 20.0) - - with self.assertRaises(TypeError): - a = Vector2(0, 0) - b = "fish" - c = "durk" - d = Vector2(100, 100) - pygame.math.remap(a, b, c, d, 10) - - with self.assertRaises(TypeError): - a = 1 - b = 2 - c = 10 - d = 20 - pygame.math.remap(a, b, c, d, Vector2(0, 0)) - - with self.assertRaises(ValueError): - a = 5 - b = 5 - c = 0 - d = 100 - pygame.math.remap(a, b, c, d, 10) - - with self.assertRaises(TypeError): - a = 12**300 - b = 11**30 - c = 20 - d = 30 - pygame.math.remap(a, b, c, d, 100 * 50) - - with self.assertRaises(TypeError): - a = 12j - b = 11j - c = 10j - d = 9j - pygame.math.remap(a, b, c, d, 50j) - - def test_smoothstep(self): - a = 0.0 - b = 10.0 - self.assertEqual(pygame.math.smoothstep(a, b, 0.5), 5.0) - - a = 0.0 - b = 10.0 - self.assertEqual(pygame.math.smoothstep(a, b, 0.1), 0.28) - - a = -10.0 - b = 10.0 - self.assertEqual(pygame.math.smoothstep(a, b, 0.5), 0.0) - class Vector2TypeTest(unittest.TestCase): def setUp(self): @@ -260,48 +130,6 @@ class Vector2TypeTest(unittest.TestCase): self.assertEqual(v.x, 1.2) self.assertEqual(v.y, 3.4) - def testConstructionNumericSequence(self): - class NumericSequence: - # PyFloat_AsDouble will use this to convert to a float - # so this is testing the implementation a bit - def __float__(self): - raise TypeError("Cannot convert to float") - - def __getitem__(self, index): - return [1, 0][index] - - def __len__(self): - return 2 - - v = Vector2(NumericSequence()) - self.assertEqual(v.x, 1.0) - self.assertEqual(v.y, 0.0) - - def testConstructionNumericNonFloat(self): - class NumericNonFloat: - # PyFloat_AsDouble will use this to convert to a float - # so this is testing the implementation a bit - def __float__(self): - raise TypeError("Cannot convert to float") - - with self.assertRaises(TypeError): - Vector2(NumericNonFloat()) - - with self.assertRaises(TypeError): - Vector2(NumericNonFloat(), NumericNonFloat()) - - with self.assertRaises(TypeError): - Vector2(1.0, NumericNonFloat()) - - @unittest.skipIf(numpy is None, "numpy not available") - def testConstructionNumpyArray(self): - assert numpy is not None - - arr = numpy.array([1.2, 3.4]) - v = Vector2(arr) - self.assertEqual(v.x, 1.2) - self.assertEqual(v.y, 3.4) - def testAttributeAccess(self): tmp = self.v1.x self.assertEqual(tmp, self.v1.x) @@ -702,8 +530,8 @@ class Vector2TypeTest(unittest.TestCase): def testRepr(self): v = Vector2(1.2, 3.4) - self.assertEqual(repr(v), "Vector2(1.2, 3.4)") - self.assertEqual(v, Vector2(repr(v))) + self.assertEqual(v.__repr__(), "") + self.assertEqual(v, Vector2(v.__repr__())) def testIter(self): it = self.v1.__iter__() @@ -742,7 +570,7 @@ class Vector2TypeTest(unittest.TestCase): v2 = v1.rotate(0) self.assertEqual(v1.x, v2.x) self.assertEqual(v1.y, v2.y) - # pygame-ce issue 229 + # issue 214 self.assertEqual(Vector2(0, 1).rotate(359.99999999), Vector2(0, 1)) def test_rotate_rad(self): @@ -1140,31 +968,15 @@ class Vector2TypeTest(unittest.TestCase): self.assertEqual(v1.lerp(v2, 0.5), (5, 5)) self.assertRaises(ValueError, lambda: v1.lerp(v2, 2.5)) - v1 = Vector2(0, 0) - v2 = Vector2(10, 10) - self.assertEqual(v1.lerp(v2, 0.1), (1, 1)) - v1 = Vector2(-10, -5) v2 = Vector2(10, 10) self.assertEqual(v1.lerp(v2, 0.5), (0, 2.5)) - def test_smoothstep(self): - v1 = Vector2(0, 0) - v2 = Vector2(10, 10) - self.assertEqual(v1.smoothstep(v2, 0.5), (5, 5)) - - v1 = Vector2(0, 0) - v2 = Vector2(10, 10) - self.assertEqual(v1.smoothstep(v2, 0.1), (0.28, 0.28)) - - v1 = Vector2(-10, -5) - v2 = Vector2(10, 10) - self.assertEqual(v1.smoothstep(v2, 0.5), (0, 2.5)) - def test_polar(self): v = Vector2() v.from_polar(self.v1.as_polar()) self.assertEqual(self.v1, v) + self.assertEqual(self.v1, Vector2.from_polar(self.v1.as_polar())) self.assertEqual(self.e1.as_polar(), (1, 0)) self.assertEqual(self.e2.as_polar(), (1, 90)) self.assertEqual((2 * self.e2).as_polar(), (2, 90)) @@ -1174,22 +986,33 @@ class Vector2TypeTest(unittest.TestCase): self.assertRaises(TypeError, lambda: v.from_polar((1, 2, 3))) self.assertRaises(TypeError, lambda: v.from_polar((1,))) self.assertRaises(TypeError, lambda: v.from_polar(1, 2)) + self.assertRaises(TypeError, lambda: Vector2.from_polar((None, None))) + self.assertRaises(TypeError, lambda: Vector2.from_polar("ab")) + self.assertRaises(TypeError, lambda: Vector2.from_polar((None, 1))) + self.assertRaises(TypeError, lambda: Vector2.from_polar((1, 2, 3))) + self.assertRaises(TypeError, lambda: Vector2.from_polar((1,))) + self.assertRaises(TypeError, lambda: Vector2.from_polar(1, 2)) v.from_polar((0.5, 90)) self.assertEqual(v, 0.5 * self.e2) + self.assertEqual(Vector2.from_polar((0.5, 90)), 0.5 * self.e2) + self.assertEqual(Vector2.from_polar((0.5, 90)), v) v.from_polar((1, 0)) self.assertEqual(v, self.e1) + self.assertEqual(Vector2.from_polar((1, 0)), self.e1) + self.assertEqual(Vector2.from_polar((1, 0)), v) def test_subclass_operation(self): class Vector(pygame.math.Vector2): pass - vec = Vector() - vec_a = Vector(2, 0) vec_b = Vector(0, 1) - vec_a + vec_b + result_add = vec_a + vec_b + self.assertEqual(result_add, Vector(2, 1)) + vec_a *= 2 + self.assertEqual(vec_a, Vector(4, 0)) def test_project_v2_onto_x_axis(self): """Project onto x-axis, e.g. get the component pointing in the x-axis direction.""" @@ -1319,11 +1142,6 @@ class Vector2TypeTest(unittest.TestCase): self.assertEqual(v1, v2) self.assertEqual(v1, Vector2(1, 2)) - v2 = Vector2() - self.assertEqual(v2.clamp_magnitude(1), Vector2()) - v2.clamp_magnitude_ip(2) - self.assertEqual(v2.magnitude(), 0) - def test_clamp_mag_v2_edge_cases(self): v1 = Vector2(1, 2) v2 = v1.clamp_magnitude(6, 6) @@ -1357,10 +1175,10 @@ class Vector2TypeTest(unittest.TestCase): self.assertRaises(ValueError, v1.clamp_magnitude, *invalid_args) self.assertRaises(ValueError, v1.clamp_magnitude_ip, *invalid_args) - # 0 vector with a min_length > 0 + # 0 vector v2 = Vector2() - self.assertRaises(ValueError, v2.clamp_magnitude, 1, 2) - self.assertRaises(ValueError, v2.clamp_magnitude_ip, 2, 3) + self.assertRaises(ValueError, v2.clamp_magnitude, 3) + self.assertRaises(ValueError, v2.clamp_magnitude_ip, 4) def test_subclassing_v2(self): """Check if Vector2 is subclassable""" @@ -1394,120 +1212,6 @@ class Vector2TypeTest(unittest.TestCase): self.assertEqual(type(other / 3), TestVector) self.assertEqual(type(other.elementwise() ** 3), TestVector) - def test_del_x(self): - """Verify that the correct error message gets spit out when trying to delete x""" - with self.assertRaises(TypeError) as ctx: - del Vector2().x - - exception = ctx.exception - self.assertEqual(str(exception), "Cannot delete the x attribute") - - def test_del_y(self): - """Verify that the correct error message gets spit out when trying to delete y""" - with self.assertRaises(TypeError) as ctx: - del Vector2().y - - exception = ctx.exception - self.assertEqual(str(exception), "Cannot delete the y attribute") - - def test_angle_rad_property(self): - v0 = Vector2(1, 0) - self.assertEqual(v0.angle_rad, 0.0) - - v1 = Vector2(0, 1) - self.assertEqual(v1.angle_rad, math.pi / 2) - - v2 = Vector2(-1, 0) - self.assertEqual(v2.angle_rad, math.pi) - - v3 = Vector2(0, -1) - self.assertEqual(v3.angle_rad, -math.pi / 2) - - v4 = Vector2(1, 1) - self.assertEqual(v4.angle_rad, math.pi / 4) - - v5 = Vector2(-1, 1) - self.assertEqual(v5.angle_rad, 3 * math.pi / 4) - - v6 = Vector2(-1, -1) - self.assertEqual(v6.angle_rad, -3 * math.pi / 4) - - v7 = Vector2(1, -1) - self.assertEqual(v7.angle_rad, -math.pi / 4) - - v8 = Vector2(float('inf'), float('inf')) - self.assertEqual(v8.angle_rad, math.pi / 4) - - v9 = Vector2(float('-inf'), float('inf')) - self.assertEqual(v9.angle_rad, 3 * math.pi / 4) - - v10 = Vector2(float('-inf'), float('-inf')) - self.assertEqual(v10.angle_rad, -3 * math.pi / 4) - - v11 = Vector2(float('inf'), float('-inf')) - self.assertEqual(v11.angle_rad, -math.pi / 4) - - v12 = Vector2(0, 0) - self.assertEqual(v12.angle_rad, 0.0) - - v13 = Vector2(float('nan'), 1) - self.assertTrue(math.isnan(v13.angle_rad)) - - v14 = Vector2(1, float('nan')) - self.assertTrue(math.isnan(v14.angle_rad)) - - v15 = Vector2(float('nan'), float('nan')) - self.assertTrue(math.isnan(v15.angle_rad)) - - def test_angle_property(self): - v0 = pygame.math.Vector2(1, 0) - self.assertEqual(v0.angle, 0.0) - - v1 = pygame.math.Vector2(0, 1) - self.assertEqual(v1.angle, 90.0) - - v2 = pygame.math.Vector2(-1, 0) - self.assertEqual(v2.angle, 180.0) - - v3 = pygame.math.Vector2(0, -1) - self.assertEqual(v3.angle, -90.0) - - v4 = pygame.math.Vector2(1, 1) - self.assertEqual(v4.angle, 45.0) - - v5 = pygame.math.Vector2(-1, 1) - self.assertEqual(v5.angle, 135.0) - - v6 = pygame.math.Vector2(-1, -1) - self.assertEqual(v6.angle, -135.0) - - v7 = pygame.math.Vector2(1, -1) - self.assertEqual(v7.angle, -45.0) - - v8 = pygame.math.Vector2(float('inf'), float('inf')) - self.assertEqual(v8.angle, 45.0) - - v9 = pygame.math.Vector2(float('-inf'), float('inf')) - self.assertEqual(v9.angle, 135.0) - - v10 = pygame.math.Vector2(float('-inf'), float('-inf')) - self.assertEqual(v10.angle, -135.0) - - v11 = pygame.math.Vector2(float('inf'), float('-inf')) - self.assertEqual(v11.angle, -45.0) - - v12 = pygame.math.Vector2(0, 0) - self.assertEqual(v12.angle, 0.0) - - v13 = pygame.math.Vector2(float('nan'), 1) - self.assertTrue(math.isnan(v13.angle)) - - v14 = pygame.math.Vector2(1, float('nan')) - self.assertTrue(math.isnan(v14.angle)) - - v15 = pygame.math.Vector2(float('nan'), float('nan')) - self.assertTrue(math.isnan(v15.angle)) - class Vector3TypeTest(unittest.TestCase): def setUp(self): @@ -1576,53 +1280,6 @@ class Vector3TypeTest(unittest.TestCase): self.assertRaises(ValueError, Vector3, 1, 2) self.assertRaises(ValueError, Vector3, x=1, y=2) - def testConstructionNumericSequence(self): - class NumericSequence: - # PyFloat_AsDouble will use this to convert to a float - # so this is testing the implementation a bit - def __float__(self): - raise TypeError("Cannot convert to float") - - def __getitem__(self, index): - return [1, 0, 5][index] - - def __len__(self): - return 3 - - v = Vector3(NumericSequence()) - self.assertEqual(v.x, 1.0) - self.assertEqual(v.y, 0.0) - self.assertEqual(v.z, 5.0) - - def testConstructionNumericNonFloat(self): - class NumericNonFloat: - # PyFloat_AsDouble will use this to convert to a float - # so this is testing the implementation a bit - def __float__(self): - raise TypeError("Cannot convert to float") - - with self.assertRaises(TypeError): - Vector3(NumericNonFloat()) - - with self.assertRaises(TypeError): - Vector3(NumericNonFloat(), NumericNonFloat(), NumericNonFloat()) - - with self.assertRaises(TypeError): - Vector3(1.0, NumericNonFloat(), 5.0) - - with self.assertRaises(TypeError): - Vector3(1.0, 0.0, NumericNonFloat()) - - @unittest.skipIf(numpy is None, "numpy not available") - def testConstructionNumpyArray(self): - assert numpy is not None - - arr = numpy.array([1.2, 3.4, 5.6], dtype=float) - v = Vector3(arr) - self.assertEqual(v.x, 1.2) - self.assertEqual(v.y, 3.4) - self.assertEqual(v.z, 5.6) - def testAttributeAccess(self): tmp = self.v1.x self.assertEqual(tmp, self.v1.x) @@ -1871,8 +1528,8 @@ class Vector3TypeTest(unittest.TestCase): def testRepr(self): v = Vector3(1.2, 3.4, -9.6) - self.assertEqual(repr(v), "Vector3(1.2, 3.4, -9.6)") - self.assertEqual(v, Vector3(repr(v))) + self.assertEqual(v.__repr__(), "") + self.assertEqual(v, Vector3(v.__repr__())) def testIter(self): it = self.v1.__iter__() @@ -2039,7 +1696,7 @@ class Vector3TypeTest(unittest.TestCase): self.assertEqual(v1.x, v2.x) self.assertEqual(v1.y, v2.y) self.assertEqual(v1.z, v2.z) - # pygame-ce issue 229 + # issue 214 self.assertEqual( Vector3(0, 1, 0).rotate(359.9999999, Vector3(0, 0, 1)), Vector3(0, 1, 0) ) @@ -2180,23 +1837,6 @@ class Vector3TypeTest(unittest.TestCase): vec.rotate_y_rad_ip(math.pi / 2) self.assertEqual(vec, (0, 0, -1)) - def test_rotate_y_ip_rad(self): - import warnings - - vec = Vector3(1, 0, 0) - with warnings.catch_warnings(record=True) as w: - warnings.simplefilter("always", DeprecationWarning) - - # This previously (and incorrectly) rotated around the X axis - vec.rotate_y_ip_rad(math.pi / 2) - - self.assertEqual(len(w), 1) - self.assertTrue(issubclass(w[-1].category, DeprecationWarning)) - self.assertIn("vector3_rotate_y_rad_ip", str(w[-1].message)) - - # Verify it now correctly rotates around the Y axis - self.assertEqual(vec, (0, 0, -1)) - def test_rotate_z(self): v1 = Vector3(1, 0, 0) v2 = v1.rotate_z(90) @@ -2246,23 +1886,6 @@ class Vector3TypeTest(unittest.TestCase): vec.rotate_z_rad_ip(math.pi / 2) self.assertEqual(vec, (0, 1, 0)) - def test_rotate_z_ip_rad(self): - import warnings - - vec = Vector3(1, 0, 0) - with warnings.catch_warnings(record=True) as w: - warnings.simplefilter("always", DeprecationWarning) - - # This previously (and incorrectly) rotated around the X axis - vec.rotate_z_ip_rad(math.pi / 2) - - self.assertEqual(len(w), 1) - self.assertTrue(issubclass(w[-1].category, DeprecationWarning)) - self.assertIn("vector3_rotate_z_rad_ip", str(w[-1].message)) - - # Verify it now correctly rotates around the Z axis - self.assertEqual(vec, (0, 1, 0)) - def test_normalize(self): v = self.v1.normalize() # length is 1 @@ -2927,31 +2550,15 @@ class Vector3TypeTest(unittest.TestCase): self.assertEqual(v1.lerp(v2, 0.5), (5, 5, 5)) self.assertRaises(ValueError, lambda: v1.lerp(v2, 2.5)) - v1 = Vector3(0, 0, 0) - v2 = Vector3(10, 10, 10) - self.assertEqual(v1.lerp(v2, 0.1), (1, 1, 1)) - v1 = Vector3(-10, -5, -20) v2 = Vector3(10, 10, -20) self.assertEqual(v1.lerp(v2, 0.5), (0, 2.5, -20)) - def test_smoothstep(self): - v1 = Vector3(0, 0, 0) - v2 = Vector3(10, 10, 10) - self.assertEqual(v1.smoothstep(v2, 0.5), (5, 5, 5)) - - v1 = Vector3(0, 0, 0) - v2 = Vector3(10, 10, 10) - self.assertEqual(v1.smoothstep(v2, 0.1), (0.28, 0.28, 0.28)) - - v1 = Vector3(-10, -5, -20) - v2 = Vector3(10, 10, -20) - self.assertEqual(v1.smoothstep(v2, 0.5), (0, 2.5, -20)) - def test_spherical(self): v = Vector3() v.from_spherical(self.v1.as_spherical()) self.assertEqual(self.v1, v) + self.assertEqual(self.v1, Vector3.from_spherical(self.v1.as_spherical())) self.assertEqual(self.e1.as_spherical(), (1, 90, 0)) self.assertEqual(self.e2.as_spherical(), (1, 90, 90)) self.assertEqual(self.e3.as_spherical(), (1, 0, 0)) @@ -2962,8 +2569,16 @@ class Vector3TypeTest(unittest.TestCase): self.assertRaises(TypeError, lambda: v.from_spherical((1, 2, 3, 4))) self.assertRaises(TypeError, lambda: v.from_spherical((1, 2))) self.assertRaises(TypeError, lambda: v.from_spherical(1, 2, 3)) + self.assertRaises(TypeError, lambda: Vector3.from_spherical((None, None, None))) + self.assertRaises(TypeError, lambda: Vector3.from_spherical("abc")) + self.assertRaises(TypeError, lambda: Vector3.from_spherical((None, 1, 2))) + self.assertRaises(TypeError, lambda: Vector3.from_spherical((1, 2, 3, 4))) + self.assertRaises(TypeError, lambda: Vector3.from_spherical((1, 2))) + self.assertRaises(TypeError, lambda: Vector3.from_spherical(1, 2, 3)) v.from_spherical((0.5, 90, 90)) self.assertEqual(v, 0.5 * self.e2) + self.assertEqual(Vector3.from_spherical((0.5, 90, 90)), 0.5 * self.e2) + self.assertEqual(Vector3.from_spherical((0.5, 90, 90)), v) def test_inplace_operators(self): v = Vector3(1, 1, 1) @@ -3174,11 +2789,6 @@ class Vector3TypeTest(unittest.TestCase): self.assertEqual(v1, v2) self.assertEqual(v1, Vector3(1, 2, 3)) - v2 = Vector3() - self.assertEqual(v2.clamp_magnitude(1), Vector3()) - v2.clamp_magnitude_ip(2) - self.assertEqual(v2.magnitude(), 0) - def test_clamp_mag_v3_edge_cases(self): v1 = Vector3(1, 2, 1) v2 = v1.clamp_magnitude(6, 6) @@ -3214,8 +2824,8 @@ class Vector3TypeTest(unittest.TestCase): # 0 vector v2 = Vector3() - self.assertRaises(ValueError, v2.clamp_magnitude, 1, 2) - self.assertRaises(ValueError, v2.clamp_magnitude_ip, 2, 3) + self.assertRaises(ValueError, v2.clamp_magnitude, 3) + self.assertRaises(ValueError, v2.clamp_magnitude_ip, 4) def test_subclassing_v3(self): """Check if Vector3 is subclassable""" @@ -3314,30 +2924,6 @@ class Vector3TypeTest(unittest.TestCase): self.assertRaises(TypeError, origin.move_towards, "c", 3) self.assertRaises(TypeError, origin.move_towards_ip, "d", 3) - def test_del_x(self): - """Verify that the correct error message gets spit out when trying to delete x""" - with self.assertRaises(TypeError) as ctx: - del Vector3().x - - exception = ctx.exception - self.assertEqual(str(exception), "Cannot delete the x attribute") - - def test_del_y(self): - """Verify that the correct error message gets spit out when trying to delete y""" - with self.assertRaises(TypeError) as ctx: - del Vector3().y - - exception = ctx.exception - self.assertEqual(str(exception), "Cannot delete the y attribute") - - def test_del_z(self): - """Verify that the correct error message gets spit out when trying to delete z""" - with self.assertRaises(TypeError) as ctx: - del Vector3().z - - exception = ctx.exception - self.assertEqual(str(exception), "Cannot delete the z attribute") - if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/midi_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/midi_test.py index 2bf4e89..f4189a2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/midi_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/midi_test.py @@ -1,5 +1,6 @@ import unittest + import pygame @@ -209,7 +210,7 @@ class MidiOutputTest(unittest.TestCase): out.pitch_bend(-10001, 1) self.assertEqual( str(cm.exception), - "Pitch bend value must be between -8192 and +8191, not -10001.", + "Pitch bend value must be between " "-8192 and +8191, not -10001.", ) with self.assertRaises(ValueError) as cm: out.pitch_bend(10665, 2) @@ -438,7 +439,7 @@ class MidiModuleNonInteractiveTest(unittest.TestCase): def test_conversions(self): """of frequencies to midi note numbers and ansi note names.""" - from pygame.midi import frequency_to_midi, midi_to_ansi_note, midi_to_frequency + from pygame.midi import frequency_to_midi, midi_to_frequency, midi_to_ansi_note self.assertEqual(frequency_to_midi(27.5), 21) self.assertEqual(frequency_to_midi(36.7), 26) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/mixer_music_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/mixer_music_test.py index a36f3fc..8d32030 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/mixer_music_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/mixer_music_test.py @@ -1,12 +1,11 @@ import os -import platform import sys -import time +import platform import unittest -from tempfile import TemporaryDirectory +import time -import pygame from pygame.tests.test_utils import example_path +import pygame class MixerMusicModuleTest(unittest.TestCase): @@ -27,47 +26,20 @@ class MixerMusicModuleTest(unittest.TestCase): def test_load_mp3(self): "|tags:music|" - self.music_load("house_lo.mp3") + self.music_load("mp3") def test_load_ogg(self): "|tags:music|" - self.music_load("house_lo.ogg") + self.music_load("ogg") def test_load_wav(self): "|tags:music|" - self.music_load("house_lo.wav") + self.music_load("wav") - def test_load_flac(self): - "|tags:music|" - self.music_load("house_lo.flac") - - # system installed SDL_mixer may not support wavpack - @unittest.skipIf( - pygame.mixer.get_sdl_mixer_version() < (2, 8, 0) - or "PG_DEPS_FROM_SYSTEM" in os.environ, - "WavPack support added in SDL_mixer 2.8.0", - ) - def test_load_wv(self): - "|tags:music|" - self.music_load("house_lo.wv") - - def test_load_opus(self): - "|tags:music|" - self.music_load("house_lo.opus") - - def test_load_midi(self): - "|tags:music|" - if pygame.mixer.get_soundfont() is not None: - self.music_load("MIDI_sample.mid") - - def test_load_xm(self): - "|tags:music|" - self.music_load("surfonasinewave.xm") - - def music_load(self, filename): + def music_load(self, format): data_fname = example_path("data") - path = os.path.join(data_fname, filename) + path = os.path.join(data_fname, f"house_lo.{format}") if os.sep == "\\": path = path.replace("\\", "\\\\") umusfn = str(path) @@ -78,28 +50,10 @@ class MixerMusicModuleTest(unittest.TestCase): def test_load_object(self): """test loading music from file-like objects.""" - filenames = [ - "house_lo.ogg", - "house_lo.wav", - "house_lo.flac", - "house_lo.opus", - "surfonasinewave.xm", - ] - if pygame.mixer.get_sdl_mixer_version() >= (2, 6, 0): - filenames.append("house_lo.mp3") - - if ( - pygame.mixer.get_sdl_mixer_version() >= (2, 8, 0) - and "PG_DEPS_FROM_SYSTEM" not in os.environ - ): - filenames.append("house_lo.wv") - - if pygame.mixer.get_soundfont() is not None: - filenames.append("MIDI_sample.mid") - + formats = ["ogg", "wav"] data_fname = example_path("data") - for file in filenames: - path = os.path.join(data_fname, file) + for f in formats: + path = os.path.join(data_fname, f"house_lo.{f}") if os.sep == "\\": path = path.replace("\\", "\\\\") bmusfn = path.encode() @@ -109,59 +63,46 @@ class MixerMusicModuleTest(unittest.TestCase): def test_object_namehint(self): """test loading & queuing music from file-like objects with namehint argument.""" - filenames = [ - "house_lo.ogg", - "house_lo.wav", - "house_lo.flac", - "house_lo.opus", - "surfonasinewave.xm", - ] - if pygame.mixer.get_sdl_mixer_version() >= (2, 6, 0): - filenames.append("house_lo.mp3") - - if ( - pygame.mixer.get_sdl_mixer_version() >= (2, 8, 0) - and "PG_DEPS_FROM_SYSTEM" not in os.environ - ): - filenames.append("house_lo.wv") - - if pygame.mixer.get_soundfont() is not None: - filenames.append("MIDI_sample.mid") - + formats = ["wav", "ogg"] data_fname = example_path("data") - for file in filenames: - path = os.path.join(data_fname, file) + for f in formats: + path = os.path.join(data_fname, f"house_lo.{f}") if os.sep == "\\": path = path.replace("\\", "\\\\") bmusfn = path.encode() - *_, format = file.split(".") - # these two "with open" blocks need to be separate, which is kinda weird with open(bmusfn, "rb") as musf: - pygame.mixer.music.load(musf, format) + pygame.mixer.music.load(musf, f) with open(bmusfn, "rb") as musf: - pygame.mixer.music.queue(musf, format) + pygame.mixer.music.queue(musf, f) with open(bmusfn, "rb") as musf: - pygame.mixer.music.load(musf, namehint=format) + pygame.mixer.music.load(musf, namehint=f) with open(bmusfn, "rb") as musf: - pygame.mixer.music.queue(musf, namehint=format) + pygame.mixer.music.queue(musf, namehint=f) def test_load_unicode(self): """test non-ASCII unicode path""" import shutil ep = example_path("data") - - with TemporaryDirectory() as tmpdir: - temp_file = os.path.join(tmpdir, "你好.wav") - org_file = os.path.join(ep, "house_lo.wav") - shutil.copy(org_file, temp_file) + temp_file = os.path.join(ep, "你好.wav") + org_file = os.path.join(ep, "house_lo.wav") + try: + with open(temp_file, "w") as f: + pass + os.remove(temp_file) + except OSError: + raise unittest.SkipTest("the path cannot be opened") + shutil.copy(org_file, temp_file) + try: pygame.mixer.music.load(temp_file) pygame.mixer.music.load(org_file) # unload + finally: + os.remove(temp_file) def test_unload(self): import shutil @@ -202,53 +143,6 @@ class MixerMusicModuleTest(unittest.TestCase): filename = example_path(os.path.join("data", "house_lo.wav")) pygame.mixer.music.queue(filename) - def test_queue_flac(self): - """Ensures queue() accepts flac files. - - |tags:music| - """ - filename = example_path(os.path.join("data", "house_lo.flac")) - pygame.mixer.music.queue(filename) - - # system installed SDL_mixer may not support wavpack - @unittest.skipIf( - pygame.mixer.get_sdl_mixer_version() < (2, 8, 0) - or "PG_DEPS_FROM_SYSTEM" in os.environ, - "WavPack support added in SDL_mixer 2.8.0", - ) - def test_queue_wv(self): - """Ensures queue() accepts wv files. - - |tags:music| - """ - filename = example_path(os.path.join("data", "house_lo.wv")) - pygame.mixer.music.queue(filename) - - def test_queue_opus(self): - """Ensures queue() accepts opus files. - - |tags:music| - """ - filename = example_path(os.path.join("data", "house_lo.opus")) - pygame.mixer.music.queue(filename) - - def test_queue_midi(self): - """Ensures queue() accepts midi files. - - |tags:music| - """ - if pygame.mixer.get_soundfont() is not None: - filename = example_path(os.path.join("data", "MIDI_sample.mid")) - pygame.mixer.music.queue(filename) - - def test_queue_xm(self): - """Ensures queue() accepts xm files (tracker music files). - - |tags:music| - """ - filename = example_path(os.path.join("data", "surfonasinewave.xm")) - pygame.mixer.music.queue(filename) - def test_queue__multiple_calls(self): """Ensures queue() can be called multiple times.""" ogg_file = example_path(os.path.join("data", "house_lo.ogg")) @@ -280,7 +174,7 @@ class MixerMusicModuleTest(unittest.TestCase): def test_queue__invalid_filename(self): """Ensures queue() correctly handles invalid filenames.""" - with self.assertRaises(FileNotFoundError): + with self.assertRaises(pygame.error): pygame.mixer.music.queue("") def test_music_pause__unpause(self): @@ -301,48 +195,46 @@ class MixerMusicModuleTest(unittest.TestCase): pygame.mixer.music.unpause() after_unpause = pygame.mixer.music.get_pos() - self.assertAlmostEqual(before_unpause, after_unpause, delta=2) + self.assertEqual(before_unpause, after_unpause) - def test_music_get_metadata(self): - file_dir = example_path("data") - path = os.path.join(file_dir, "metadata.mp3") - pygame.mixer.music.load(path) - - if pygame.mixer.get_sdl_mixer_version() >= (2, 6, 0): - file_metadata = { - "title": "Small Tone", - "album": "Tones", - "artist": "Audacity Generator", - "copyright": "2023 Nobody", - } - else: - file_metadata = { - "title": "", - "album": "", - "artist": "", - "copyright": "", - } - - retrieved_metadata = pygame.mixer.music.get_metadata() - self.assertDictEqual(file_metadata, retrieved_metadata) - pygame.mixer.music.unload() - - retrieved_metadata = pygame.mixer.music.get_metadata(path) - self.assertDictEqual(file_metadata, retrieved_metadata) - - def todo_test_stop(self): + def test_stop(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.stop: # Stops the music playback if it is currently playing. + filename = example_path(os.path.join("data", "house_lo.mp3")) + pygame.mixer.music.load(filename) + pygame.mixer.music.play() - self.fail() + pygame.mixer.music.stop() + self.assertEqual(pygame.mixer.music.get_busy(), False) - def todo_test_rewind(self): + def test_rewind(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.rewind: # Resets playback of the current music to the beginning. + filename = example_path(os.path.join("data", "house_lo.mp3")) + pygame.mixer.music.load(filename) + pygame.mixer.music.play() - self.fail() + # The music be played for some time + time.sleep(3) + # Then it is rewinded + pygame.mixer.music.rewind() + # Since the sound is 7s long, if it is busy after 6s it means it has been restarted + time.sleep(6.9) + self.assertTrue(pygame.mixer.music.get_busy()) + pygame.mixer.music.stop() + + # Testing that if the music is paused, rewind works but keep the music paused + pygame.mixer.music.play() + time.sleep(2) + pygame.mixer.music.pause() + pygame.mixer.music.rewind() + self.assertFalse(pygame.mixer.music.get_busy()) + time.sleep(1) + pygame.mixer.music.unpause() + time.sleep(6.9) + self.assertTrue(pygame.mixer.music.get_busy()) def todo_test_get_pos(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.get_pos: @@ -355,15 +247,14 @@ class MixerMusicModuleTest(unittest.TestCase): self.fail() - def todo_test_fadeout(self): - # __doc__ (as of 2008-08-02) for pygame.mixer_music.fadeout: + # def test_fadeout(self): + # filename = example_path(os.path.join("data", "house_lo.mp3")) + # pygame.mixer.music.load(filename) + # pygame.mixer.music.play() - # This will stop the music playback after it has been faded out over - # the specified time (measured in milliseconds). - # - # Note, that this function blocks until the music has faded out. - - self.fail() + # pygame.mixer.music.fadeout(50) + # time.sleep(0.3) + # self.assertEqual(pygame.mixer.music.get_busy(), False) @unittest.skipIf( os.environ.get("SDL_AUDIODRIVER") == "disk", @@ -392,7 +283,7 @@ class MixerMusicModuleTest(unittest.TestCase): self.assertEqual(time_to_finish, 1) running = False - def todo_test_play(self): + def test_play(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.play: # This will play the loaded music stream. If the music is already @@ -409,10 +300,15 @@ class MixerMusicModuleTest(unittest.TestCase): # MOD music it is the pattern order number. Passing a startpos will # raise a NotImplementedError if it cannot set the start position # + filename = example_path(os.path.join("data", "house_lo.mp3")) + pygame.mixer.music.load(filename) + pygame.mixer.music.play() - self.fail() + self.assertTrue(pygame.mixer.music.get_busy()) - def todo_test_load(self): + pygame.mixer.music.stop() + + def test_load(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.load: # This will load a music file and prepare it for playback. If a music @@ -423,39 +319,44 @@ class MixerMusicModuleTest(unittest.TestCase): # like the other pygame loading functions. # - self.fail() + filename = example_path(os.path.join("data", "house_lo.mp3")) + pygame.mixer.music.load(filename) + self.assertFalse(pygame.mixer.music.get_busy()) + pygame.mixer.music.play() + self.assertTrue(pygame.mixer.music.get_busy()) - def todo_test_get_volume(self): + filename = example_path(os.path.join("data", "house_lo.wav")) + pygame.mixer.music.load(filename) + self.assertFalse(pygame.mixer.music.get_busy()) + + def test_get_volume(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.get_volume: # Returns the current volume for the mixer. The value will be between # 0.0 and 1.0. # + filename = example_path(os.path.join("data", "house_lo.mp3")) + pygame.mixer.music.load(filename) + pygame.mixer.music.play() - self.fail() + vol = pygame.mixer.music.get_volume() + self.assertGreaterEqual(vol, 0) + self.assertLessEqual(vol, 1) - def todo_test_set_endevent(self): - # __doc__ (as of 2008-08-02) for pygame.mixer_music.set_endevent: + pygame.mixer.music.stop() - # This causes Pygame to signal (by means of the event queue) when the - # music is done playing. The argument determines the type of event - # that will be queued. - # - # The event will be queued every time the music finishes, not just the - # first time. To stop the event from being queued, call this method - # with no argument. - # - - self.fail() - - def todo_test_pause(self): + def test_pause(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.pause: # Temporarily stop playback of the music stream. It can be resumed # with the pygame.mixer.music.unpause() function. # - - self.fail() + self.music_load("ogg") + self.assertFalse(pygame.mixer.music.get_busy()) + pygame.mixer.music.play() + self.assertTrue(pygame.mixer.music.get_busy()) + pygame.mixer.music.pause() + self.assertFalse(pygame.mixer.music.get_busy()) def test_get_busy(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.get_busy: @@ -464,38 +365,50 @@ class MixerMusicModuleTest(unittest.TestCase): # music is idle this returns False. # - self.music_load("house_lo.ogg") + self.music_load("ogg") self.assertFalse(pygame.mixer.music.get_busy()) pygame.mixer.music.play() self.assertTrue(pygame.mixer.music.get_busy()) pygame.mixer.music.pause() self.assertFalse(pygame.mixer.music.get_busy()) - def todo_test_get_endevent(self): - # __doc__ (as of 2008-08-02) for pygame.mixer_music.get_endevent: - - # Returns the event type to be sent every time the music finishes - # playback. If there is no endevent the function returns - # pygame.NOEVENT. - # - - self.fail() - - def todo_test_unpause(self): + def test_unpause(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.unpause: # This will resume the playback of a music stream after it has been paused. - self.fail() + filename = example_path(os.path.join("data", "house_lo.mp3")) + pygame.mixer.music.load(filename) + pygame.mixer.music.play() + self.assertTrue(pygame.mixer.music.get_busy()) + time.sleep(0.1) + pygame.mixer.music.pause() + self.assertFalse(pygame.mixer.music.get_busy()) + before = pygame.mixer.music.get_pos() + pygame.mixer.music.unpause() + after = pygame.mixer.music.get_pos() + self.assertTrue(pygame.mixer.music.get_busy()) + # It could rarely be that it is +/- 1 different + # But mostly, after should equal before. + self.assertTrue(before - 1 <= after <= before + 1) - def todo_test_set_volume(self): + pygame.mixer.music.stop() + + def test_set_volume(self): # __doc__ (as of 2008-08-02) for pygame.mixer_music.set_volume: # Set the volume of the music playback. The value argument is between # 0.0 and 1.0. When new music is loaded the volume is reset. # + filename = example_path(os.path.join("data", "house_lo.mp3")) + pygame.mixer.music.load(filename) + pygame.mixer.music.play() - self.fail() + pygame.mixer.music.set_volume(0.5) + vol = pygame.mixer.music.get_volume() + self.assertEqual(vol, 0.5) + + pygame.mixer.music.stop() def todo_test_set_pos(self): # __doc__ (as of 2010-24-05) for pygame.mixer_music.set_pos: @@ -510,9 +423,9 @@ class MixerMusicModuleTest(unittest.TestCase): self.fail() def test_init(self): - """pygame-ce issue #622. unload music whenever mixer.quit() is called""" - import shutil + """issue #955. unload music whenever mixer.quit() is called""" import tempfile + import shutil testfile = example_path(os.path.join("data", "house_lo.wav")) tempcopy = os.path.join(tempfile.gettempdir(), "tempfile.wav") @@ -527,5 +440,54 @@ class MixerMusicModuleTest(unittest.TestCase): os.remove(tempcopy) +# class MixerMusicEndEventTest(unittest.TestCase): +# def setUp(self): +# pygame.display.init() +# pygame.display.set_mode((40, 40)) +# if pygame.mixer.get_init() is None: +# pygame.mixer.init() + +# def tearDown(self): +# pygame.display.quit() +# pygame.mixer.quit() + +# def test_get_endevent(self): +# # __doc__ (as of 2008-08-02) for pygame.mixer_music.get_endevent: + +# # Returns the event type to be sent every time the music finishes +# # playback. If there is no endevent the function returns +# # pygame.NOEVENT. +# # +# filename = example_path(os.path.join("data", "car_door.wav")) +# pygame.mixer.music.load(filename) +# pygame.mixer.music.play() +# no_event = pygame.mixer_music.get_endevent() +# self.assertEqual(pygame.NOEVENT, no_event) + +# event_type = pygame.USEREVENT +# pygame.mixer_music.set_endevent(event_type) +# end_event = pygame.mixer_music.get_endevent() +# self.assertEqual(event_type, end_event) + +# def test_set_endevent(self): +# # __doc__ (as of 2008-08-02) for pygame.mixer_music.set_endevent: + +# # This causes Pygame to signal (by means of the event queue) when the +# # music is done playing. The argument determines the type of event +# # that will be queued. +# # +# # The event will be queued every time the music finishes, not just the +# # first time. To stop the event from being queued, call this method +# # with no argument. +# # +# filename = example_path(os.path.join("data", "house_lo.wav")) +# pygame.mixer.music.load(filename) +# pygame.mixer.music.play() +# event_type = pygame.USEREVENT +# pygame.mixer_music.set_endevent(event_type) +# end_event = pygame.mixer_music.get_endevent() +# self.assertEqual(event_type, end_event) + + if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/mixer_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/mixer_test.py index e7e4a81..0b11c5a 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/mixer_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/mixer_test.py @@ -1,15 +1,15 @@ -import copy +import sys import os +import unittest import pathlib import platform -import sys import time -import unittest -from tempfile import TemporaryDirectory +from array import array + +from pygame.tests.test_utils import example_path import pygame from pygame import mixer -from pygame.tests.test_utils import example_path, prompt, question IS_PYPY = "PyPy" == platform.python_implementation() @@ -49,48 +49,6 @@ class MixerModuleTest(unittest.TestCase): mixer.quit() mixer.pre_init(0, 0, 0, 0) - def test_get_driver(self): - mixer.init() - drivers = [ - pygame.NULL_VIDEODRIVER, - "pipewire", - "pulseaudio", - "alsa", - "jack", - "sndio", - "netbsd", - "dsp", - "qsa", - "audio", - "arts", - "esd", - "nacl", - "nas", - "wasapi", - "directsound", - "winmm", - "paud", - "haiku", - "coreaudio", - "disk", - "fusionsound", - "AAudio", - "openslES", - "android", - "ps2", - "psp", - "vita", - "n3ds", - "emscripten", - "DART", - ] - driver = mixer.get_driver() - self.assertIn(driver, drivers) - - mixer.quit() - with self.assertRaises(pygame.error): - mixer.get_driver() - def test_init__keyword_args(self): # note: this test used to loop over all CONFIGS, but it's very slow.. mixer.init(**CONFIG) @@ -130,19 +88,24 @@ class MixerModuleTest(unittest.TestCase): mixer.init(0, 0, 0) self.assertEqual(mixer.get_init(), (44100, 8, 1)) - def test_get_init__returns_exact_values_used_for_init(self): - # TODO: size 32 fails in this test (maybe SDL_mixer bug) + # def test_get_init__returns_exact_values_used_for_init(self): + # # TODO: size 32 fails in this test (maybe SDL_mixer bug) - for init_conf in CONFIGS: - frequency, size, channels = init_conf.values() - if (frequency, size) == (22050, 16): - continue - mixer.init(frequency, size, channels, allowedchanges=0) + # # TODO: 2) When you start the mixer, you request the settings. + # # But it can be that a sound system doesn’t support what you request… + # # and it gives you back something close to what you request but not equal. + # # So, you can’t test for equality. + # # See allowedchanges - mixer_conf = mixer.get_init() + # for init_conf in CONFIGS: + # frequency, size, channels = init_conf.values() + # if (frequency, size) == (22050, 16): + # continue + # mixer.init(frequency, size, channels) - self.assertEqual(tuple(init_conf.values()), mixer_conf) - mixer.quit() + # mixer_conf = mixer.get_init() + # self.assertEqual(tuple(init_conf.values()), mixer_conf) + # mixer.quit() def test_get_init__returns_None_if_mixer_not_initialized(self): self.assertIsNone(mixer.get_init()) @@ -159,30 +122,6 @@ class MixerModuleTest(unittest.TestCase): mixer.set_num_channels(i) self.assertEqual(mixer.get_num_channels(), i) - def test_set_soundfont(self): - """Ensure soundfonts can be set, cleared, and retrieved""" - mixer.init() - - # test that initially, get_soundfont returns only real files - if (initial_sf := mixer.get_soundfont()) is not None: - for i in initial_sf.split(";"): - os.path.exists(i) - - mixer.set_soundfont() - self.assertEqual(mixer.get_soundfont(), None) - - mixer.set_soundfont(None) - self.assertEqual(mixer.get_soundfont(), None) - - mixer.set_soundfont("test1.sf2;test2.sf2") - self.assertEqual(mixer.get_soundfont(), "test1.sf2;test2.sf2") - - mixer.set_soundfont("") - self.assertEqual(mixer.get_soundfont(), None) - - self.assertRaises(TypeError, mixer.set_soundfont, 0) - self.assertRaises(TypeError, mixer.set_soundfont, ["one", "two"]) - def test_quit(self): """get_num_channels() Should throw pygame.error if uninitialized after mixer.quit()""" @@ -190,11 +129,8 @@ class MixerModuleTest(unittest.TestCase): mixer.quit() self.assertRaises(pygame.error, mixer.get_num_channels) - # TODO: FIXME: pypy (on linux) fails here sometimes. - @unittest.skipIf( - sys.maxsize <= 2**32, - "randomly fails on comparing bytes", - ) + # TODO: FIXME: appveyor and pypy (on linux) fails here sometimes. + @unittest.skipIf(sys.platform.startswith("win"), "See github issue 892.") @unittest.skipIf(IS_PYPY, "random errors here with pypy") def test_sound_args(self): def get_bytes(snd): @@ -279,12 +215,20 @@ class MixerModuleTest(unittest.TestCase): import shutil ep = example_path("data") - with TemporaryDirectory() as tmpdir: - temp_file = os.path.join(tmpdir, "你好.wav") - org_file = os.path.join(ep, "house_lo.wav") - shutil.copy(org_file, temp_file) + temp_file = os.path.join(ep, "你好.wav") + org_file = os.path.join(ep, "house_lo.wav") + shutil.copy(org_file, temp_file) + try: + with open(temp_file, "rb") as f: + pass + except OSError: + raise unittest.SkipTest("the path cannot be opened") + + try: sound = mixer.Sound(temp_file) del sound + finally: + os.remove(temp_file) @unittest.skipIf( os.environ.get("SDL_AUDIODRIVER") == "disk", @@ -293,15 +237,15 @@ class MixerModuleTest(unittest.TestCase): def test_array_keyword(self): try: from numpy import ( - arange, array, - int8, - int16, - int32, - uint8, - uint16, - uint32, + arange, zeros, + int8, + uint8, + int16, + uint16, + int32, + uint32, ) except ImportError: self.skipTest("requires numpy") @@ -362,7 +306,7 @@ class MixerModuleTest(unittest.TestCase): mixer.quit() def _test_array_argument(self, format, a, test_pass): - from numpy import all as all_, array + from numpy import array, all as all_ try: snd = mixer.Sound(array=a) @@ -399,11 +343,13 @@ class MixerModuleTest(unittest.TestCase): self.assertEqual(d["strides"], (2,)) self.assertEqual(d["data"], (snd._samples_address, False)) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") @unittest.skipIf(IS_PYPY, "pypy no likey") def test_newbuf__one_channel(self): mixer.init(22050, -16, 1) self._NEWBUF_export_check() + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") @unittest.skipIf(IS_PYPY, "pypy no likey") def test_newbuf__twho_channel(self): mixer.init(22050, -16, 2) @@ -521,18 +467,19 @@ class MixerModuleTest(unittest.TestCase): else: self.assertRaises(BufferError, Importer, snd, buftools.PyBUF_F_CONTIGUOUS) - def todo_test_fadeout(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.fadeout: + def test_fadeout(self): + """Ensure pygame.mixer.fadeout() stops playback after fading out the sound.""" + if mixer.get_init() is None: + mixer.init() + sound = pygame.mixer.Sound(example_path("data/house_lo.wav")) + channel = pygame.mixer.find_channel() + channel.play(sound) + fadeout_time = 200 # milliseconds + channel.fadeout(fadeout_time) + pygame.time.wait(fadeout_time + 30) - # pygame.mixer.fadeout(time): return None - # fade out the volume on all sounds before stopping - # - # This will fade out the volume on all active channels over the time - # argument in milliseconds. After the sound is muted the playback will - # stop. - # - - self.fail() + # Ensure the channel is no longer busy + self.assertFalse(channel.get_busy()) def test_find_channel(self): # __doc__ (as of 2008-08-02) for pygame.mixer.find_channel: @@ -544,7 +491,9 @@ class MixerModuleTest(unittest.TestCase): filename = example_path(os.path.join("data", "house_lo.wav")) sound = mixer.Sound(file=filename) - if (num_channels := mixer.get_num_channels()) > 0: + num_channels = mixer.get_num_channels() + + if num_channels > 0: found_channel = mixer.find_channel() self.assertIsNotNone(found_channel) @@ -572,33 +521,28 @@ class MixerModuleTest(unittest.TestCase): found_channel = mixer.find_channel() self.assertIsNotNone(found_channel) - def todo_test_get_busy(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.get_busy: + @unittest.expectedFailure + def test_pause(self): + """Ensure pygame.mixer.pause() temporarily stops playback of all sound channels.""" + if mixer.get_init() is None: + mixer.init() + sound = mixer.Sound(example_path("data/house_lo.wav")) + channel = mixer.find_channel() + channel.play(sound) - # pygame.mixer.get_busy(): return bool - # test if any sound is being mixed - # - # Returns True if the mixer is busy mixing any channels. If the mixer - # is idle then this return False. - # + mixer.pause() - self.fail() + # TODO: this currently fails? + # Ensure the channel is paused + self.assertFalse(channel.get_busy()) - def todo_test_pause(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.pause: + mixer.unpause() - # pygame.mixer.pause(): return None - # temporarily stop playback of all sound channels - # - # This will temporarily stop all playback on the active mixer - # channels. The playback can later be resumed with - # pygame.mixer.unpause() - # - - self.fail() + # Ensure the channel is no longer paused + self.assertTrue(channel.get_busy()) def test_set_reserved(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.set_reserved: + """Ensure pygame.mixer.set_reserved() reserves the given number of channels.""" # pygame.mixer.set_reserved(count): return count mixer.init() @@ -623,25 +567,16 @@ class MixerModuleTest(unittest.TestCase): # should still be default self.assertEqual(result, int(default_num_channels / 2)) - def todo_test_stop(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.stop: - - # pygame.mixer.stop(): return None - # stop playback of all sound channels - # - # This will stop all playback of all active mixer channels. - - self.fail() - - def todo_test_unpause(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.unpause: - - # pygame.mixer.unpause(): return None - # resume paused playback of sound channels - # - # This will resume all active sound channels after they have been paused. - - self.fail() + def test_stop(self): + """Stops playback of all active sound channels.""" + if mixer.get_init() is None: + mixer.init() + sound = pygame.mixer.Sound(example_path("data/house_lo.wav")) + channel = pygame.mixer.Channel(0) + channel.play(sound) + pygame.mixer.stop() + for i in range(pygame.mixer.get_num_channels()): + self.assertFalse(pygame.mixer.Channel(i).get_busy()) def test_get_sdl_mixer_version(self): """Ensures get_sdl_mixer_version works correctly with no args.""" @@ -700,9 +635,9 @@ class MixerModuleTest(unittest.TestCase): def test_get_sdl_mixer_version__linked_equals_compiled(self): """Ensures get_sdl_mixer_version's linked/compiled versions are equal.""" linked_version = pygame.mixer.get_sdl_mixer_version(linked=True) - compiled_version = pygame.mixer.get_sdl_mixer_version(linked=False) + complied_version = pygame.mixer.get_sdl_mixer_version(linked=False) - self.assertTupleEqual(linked_version, compiled_version) + self.assertTupleEqual(linked_version, complied_version) ############################## CHANNEL CLASS TESTS ############################# @@ -724,10 +659,6 @@ class ChannelTypeTest(unittest.TestCase): if mixer.get_init() is None: mixer.init() - def test_channel_alias(self): - """Check if pygame.Channel is present and the correct type.""" - self.assertIs(pygame.Channel, pygame.mixer.Channel) - def test_channel(self): """Ensure Channel() creation works.""" channel = mixer.Channel(0) @@ -752,17 +683,19 @@ class ChannelTypeTest(unittest.TestCase): with self.assertRaisesRegex(pygame.error, "mixer not initialized"): mixer.Channel(0) - def todo_test_fadeout(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.fadeout: + def test_fadeout(self): + """Ensure Channel.fadeout() stops playback after fading out.""" + channel = mixer.Channel(0) + sound = mixer.Sound(example_path("data/house_lo.wav")) + channel.play(sound) - # Channel.fadeout(time): return None - # stop playback after fading channel out - # - # Stop playback of a channel after fading out the sound over the given - # time argument in milliseconds. - # + fadeout_time = 1000 + channel.fadeout(fadeout_time) - self.fail() + # Wait for the fadeout to complete. + pygame.time.wait(fadeout_time + 100) + + self.assertFalse(channel.get_busy()) def test_get_busy(self): """Ensure an idle channel's busy state is correct.""" @@ -773,9 +706,13 @@ class ChannelTypeTest(unittest.TestCase): self.assertEqual(busy, expected_busy) - def todo_test_get_busy__active(self): + def test_get_busy__active(self): """Ensure an active channel's busy state is correct.""" - self.fail() + channel = mixer.Channel(0) + sound = mixer.Sound(example_path("data/house_lo.wav")) + channel.play(sound) + + self.assertTrue(channel.get_busy()) def todo_test_get_endevent(self): # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.get_endevent: @@ -790,30 +727,46 @@ class ChannelTypeTest(unittest.TestCase): self.fail() - def todo_test_get_queue(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.get_queue: + def test_get_queue(self): + """Ensure Channel.get_queue() returns any queued Sound.""" + channel = mixer.Channel(0) + frequency, format, channels = mixer.get_init() + sound_length_in_ms = 200 + sound_length_in_ms_2 = 400 + bytes_per_ms = int((frequency / 1000) * channels * (abs(format) // 8)) + sound1 = mixer.Sound(b"\x00" * int(sound_length_in_ms * bytes_per_ms)) + sound2 = mixer.Sound(b"\x00" * (int(sound_length_in_ms_2 * bytes_per_ms))) - # Channel.get_queue(): return Sound - # return any Sound that is queued - # - # If a Sound is already queued on this channel it will be returned. - # Once the queued sound begins playback it will no longer be on the - # queue. - # + channel.play(sound1) + channel.queue(sound2) - self.fail() + # Ensure the second queued sound is returned. + self.assertEqual(channel.get_queue().get_length(), sound2.get_length()) - def todo_test_get_sound(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.get_sound: + pygame.time.wait(sound_length_in_ms + 100) + self.assertIsNone(channel.get_queue()) - # Channel.get_sound(): return Sound - # get the currently playing Sound - # - # Return the actual Sound object currently playing on this channel. If - # the channel is idle None is returned. - # + # the second sound is now playing + self.assertEqual(channel.get_sound().get_length(), sound2.get_length()) + pygame.time.wait((sound_length_in_ms_2) + 100) - self.fail() + # Now there is nothing on the queue. + self.assertIsNone(channel.get_queue()) + + def test_get_sound(self): + """Ensure Channel.get_sound() returns the currently playing Sound.""" + channel = mixer.Channel(0) + sound = mixer.Sound(example_path("data/house_lo.wav")) + channel.play(sound) + + # Ensure the correct Sound object is returned. + got_sound = channel.get_sound() + self.assertEqual(got_sound, sound) + + # Stop the sound and ensure None is returned. + channel.stop() + got_sound = channel.get_sound() + self.assertIsNone(got_sound) def test_get_volume(self): """Ensure a channel's volume can be retrieved.""" @@ -824,117 +777,97 @@ class ChannelTypeTest(unittest.TestCase): self.assertAlmostEqual(volume, expected_volume) - def todo_test_get_volume__while_playing(self): - """Ensure a channel's volume can be retrieved while playing.""" - self.fail() + def test_pause_unpause(self): + """ + Test if the Channel can be paused and unpaused. + """ + if mixer.get_init() is None: + mixer.init() + sound = pygame.mixer.Sound(example_path("data/house_lo.wav")) + channel = sound.play() + channel.pause() + self.assertTrue( + channel.get_busy(), msg="Channel should be paused but it's not." + ) + channel.unpause() + self.assertTrue( + channel.get_busy(), msg="Channel should be unpaused but it's not." + ) + sound.stop() - def todo_test_pause(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.pause: + def test_pause_unpause__before_init(self): + """ + Ensure exception for Channel.pause() with non-init mixer. + """ + sound = mixer.Sound(example_path("data/house_lo.wav")) + channel = sound.play() + mixer.quit() - # Channel.pause(): return None - # temporarily stop playback of a channel - # - # Temporarily stop the playback of sound on a channel. It can be - # resumed at a later time with Channel.unpause() - # + with self.assertRaisesRegex(pygame.error, "mixer not initialized"): + channel.pause() - self.fail() + with self.assertRaisesRegex(pygame.error, "mixer not initialized"): + channel.unpause() - def todo_test_play(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.play: + def test_queue(self): + """ + Ensure the Channel.queue() works correctly + """ + if os.environ.get("PYGAME_MSYS2") == "1": + self.skipTest("Skip test on MSYS2") - # Channel.play(Sound, loops=0, maxtime=0, fade_ms=0): return None - # play a Sound on a specific Channel - # - # This will begin playback of a Sound on a specific Channel. If the - # Channel is currently playing any other Sound it will be stopped. - # - # The loops argument has the same meaning as in Sound.play(): it is - # the number of times to repeat the sound after the first time. If it - # is 3, the sound will be played 4 times (the first time, then three - # more). If loops is -1 then the playback will repeat indefinitely. - # - # As in Sound.play(), the maxtime argument can be used to stop - # playback of the Sound after a given number of milliseconds. - # - # As in Sound.play(), the fade_ms argument can be used fade in the sound. + # Setup + channel = mixer.Channel(0) + frequency, format, channels = mixer.get_init() + sound_length_in_ms = 200 + sound_length_in_ms_2 = 400 + sound_length_in_ms_3 = 300 + bytes_per_ms = int((frequency / 1000) * channels * (abs(format) // 8)) + sound1 = mixer.Sound(b"\x00" * int(sound_length_in_ms * bytes_per_ms)) + sound2 = mixer.Sound(b"\x00" * (int(sound_length_in_ms_2 * bytes_per_ms))) + sound3 = mixer.Sound(b"\x00" * (int(sound_length_in_ms_3 * bytes_per_ms))) - self.fail() + # Test that the sound is played when the first one stop and the queue is cleared + channel.play(sound1) + channel.queue(sound2) + pygame.time.wait(sound_length_in_ms + 100) + self.assertTrue(channel.get_busy()) + self.assertEqual(channel.get_sound(), sound2) + self.assertIsNone(channel.get_queue()) - def todo_test_queue(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.queue: + pygame.time.wait(sound_length_in_ms_2 + 100) - # Channel.queue(Sound): return None - # queue a Sound object to follow the current - # - # When a Sound is queued on a Channel, it will begin playing - # immediately after the current Sound is finished. Each channel can - # only have a single Sound queued at a time. The queued Sound will - # only play if the current playback finished automatically. It is - # cleared on any other call to Channel.stop() or Channel.play(). - # - # If there is no sound actively playing on the Channel then the Sound - # will begin playing immediately. - # + # Test when no sound playing + channel.queue(sound1) + self.assertTrue(channel.get_busy()) + self.assertEqual(channel.get_sound(), sound1) - self.fail() + pygame.time.wait(sound_length_in_ms + 100) - def todo_test_set_endevent(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.set_endevent: + # Test that the queue is discarded if Channel.play() is used + channel.play(sound1) + channel.queue(sound2) + channel.play(sound3) + self.assertIsNone(channel.get_queue()) - # Channel.set_endevent(): return None - # Channel.set_endevent(type): return None - # have the channel send an event when playback stops - # - # When an endevent is set for a channel, it will send an event to the - # pygame queue every time a sound finishes playing on that channel - # (not just the first time). Use pygame.event.get() to retrieve the - # endevent once it's sent. - # - # Note that if you called Sound.play(n) or Channel.play(sound,n), the - # end event is sent only once: after the sound has been played "n+1" - # times (see the documentation of Sound.play). - # - # If Channel.stop() or Channel.play() is called while the sound was - # still playing, the event will be posted immediately. - # - # The type argument will be the event id sent to the queue. This can - # be any valid event type, but a good choice would be a value between - # pygame.locals.USEREVENT and pygame.locals.NUMEVENTS. If no type - # argument is given then the Channel will stop sending endevents. - # + pygame.time.wait(sound_length_in_ms_3 + 100) + self.assertFalse(channel.get_busy()) - self.fail() + # Test that the queue is discarded if Channel.stop() is used + channel.play(sound1) + channel.queue(sound2) + channel.stop() + self.assertIsNone(channel.get_queue()) + self.assertFalse(channel.get_busy()) - def todo_test_set_volume(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.set_volume: + # Test that when there is already a queue(), the ancient queue get discarded + channel.play(sound1) + channel.queue(sound2) + channel.queue(sound3) + self.assertEqual(channel.get_sound(), sound1) + self.assertEqual(channel.get_queue(), sound3) - # Channel.set_volume(value): return None - # Channel.set_volume(left, right): return None - # set the volume of a playing channel - # - # Set the volume (loudness) of a playing sound. When a channel starts - # to play its volume value is reset. This only affects the current - # sound. The value argument is between 0.0 and 1.0. - # - # If one argument is passed, it will be the volume of both speakers. - # If two arguments are passed and the mixer is in stereo mode, the - # first argument will be the volume of the left speaker and the second - # will be the volume of the right speaker. (If the second argument is - # None, the first argument will be the volume of both speakers.) - # - # If the channel is playing a Sound on which set_volume() has also - # been called, both calls are taken into account. For example: - # - # sound = pygame.mixer.Sound("s.wav") - # channel = s.play() # Sound plays at full volume by default - # sound.set_volume(0.9) # Now plays at 90% of full volume. - # sound.set_volume(0.6) # Now plays at 60% (previous value replaced). - # channel.set_volume(0.5) # Now plays at 30% (0.6 * 0.5). - - self.fail() - - def todo_test_stop(self): + def test_stop(self): # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.stop: # Channel.stop(): return None @@ -944,82 +877,173 @@ class ChannelTypeTest(unittest.TestCase): # channel becomes available for new Sounds to play on it. # - self.fail() + channel = mixer.Channel(0) + sound = mixer.Sound(example_path("data/house_lo.wav")) - def todo_test_unpause(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Channel.unpause: - - # Channel.unpause(): return None - # resume pause playback of a channel - # - # Resume the playback on a paused channel. - - self.fail() - - def test_set_source_location(self): - ch = mixer.Channel(0) - ch.set_source_location(-3.14, 6.25) - self.assertRaises(ValueError, lambda: ch.set_source_location(0, -1)) - self.assertRaises(ValueError, lambda: ch.set_source_location(0, 256.0)) - self.assertRaises(TypeError, lambda: ch.set_source_location("", 6.25)) - - def test_id_getter(self): - ch1 = mixer.Channel(1) - ch2 = mixer.Channel(2) - - self.assertEqual(ch1.id, 1) - self.assertEqual(ch2.id, 2) - - def test_subclass(self): - class MyChannel(mixer.Channel): - pass + # simple check + channel.play(sound) + channel.stop() + self.assertFalse(channel.get_busy()) + # check that queued sounds also stop + channel.queue(sound) + channel.stop() + self.assertFalse(channel.get_busy()) + # check that new sounds can be played + channel.play(sound) + self.assertTrue(channel.get_busy()) -class ChannelInteractiveTest(unittest.TestCase): - __tags__ = ["interactive"] +class ChannelSetVolumeTest(unittest.TestCase): + def setUp(self): + mixer.init() + self.channel = pygame.mixer.Channel(0) + self.sound = pygame.mixer.Sound(example_path("data/boom.wav")) def tearDown(self): mixer.quit() - mixer.pre_init(0, 0, 0, 0) + def test_set_volume_with_one_argument(self): + self.channel.play(self.sound) + self.channel.set_volume(0.5) + self.assertEqual(self.channel.get_volume(), 0.5) + + @unittest.expectedFailure + def test_set_volume_with_two_arguments(self): + # TODO: why doesn't this work? Seems to ignore stereo setting. + # https://www.pygame.org/docs/ref/mixer.html#pygame.mixer.Channel.set_volume + self.channel.play(self.sound) + self.channel.set_volume(0.3, 0.7) + self.assertEqual(self.channel.get_volume(), (0.3, 0.7)) + + +class ChannelEndEventTest(unittest.TestCase): def setUp(self): - mixer.init() - filename = example_path(os.path.join("data", "house_lo.mp3")) - self.snd = mixer.Sound(filename) + pygame.display.init() + pygame.display.set_mode((40, 40)) + if mixer.get_init() is None: + mixer.init() - def test_set_source_location(self): - prompt("Please wear earphones before the test for set_source_location() starts") - ch = self.snd.play() - angle = 0 - distance = 100 - while ch.get_busy(): - ch.set_source_location(angle, distance) - angle += 1 - angle %= 360 - time.sleep(0.01) - ans = question("You heard the sound was running around you. Is that correct?") - self.assertTrue(ans) + def tearDown(self): + pygame.display.quit() + mixer.quit() - ch = self.snd.play() - angle = 0 - distance = 0 - direction = 0 - while ch.get_busy(): - ch.set_source_location(angle, distance) - if distance == 0 or distance == 255: - direction = 1 - direction - distance += 1 if direction else -1 - time.sleep(0.01) + def test_get_endevent(self): + """Ensure Channel.get_endevent() returns the correct event type.""" + channel = mixer.Channel(0) + sound = mixer.Sound(example_path("data/house_lo.wav")) + channel.play(sound) - ans = question( - "You heard the distance of the sound was changing. Is that correct?" - ) - self.assertTrue(ans) + # Set the end event for the channel. + END_EVENT = pygame.USEREVENT + 1 + channel.set_endevent(END_EVENT) + got_end_event = channel.get_endevent() + self.assertEqual(got_end_event, END_EVENT) + + # Wait for the sound to finish playing. + channel.stop() + while channel.get_busy(): + pygame.time.wait(10) + + # Check that the end event was sent. + events = pygame.event.get(got_end_event) + self.assertTrue(len(events) > 0) ############################### SOUND CLASS TESTS ############################## +class TestSoundPlay(unittest.TestCase): + def setUp(self): + mixer.init() + self.filename = example_path(os.path.join("data", "house_lo.wav")) + self.sound = mixer.Sound(file=self.filename) + + def tearDown(self): + mixer.quit() + + def test_play_once(self): + """Test playing a sound once.""" + channel = self.sound.play() + self.assertIsInstance(channel, pygame.mixer.Channel) + self.assertTrue(channel.get_busy()) + + def test_play_multiple_times(self): + """Test playing a sound multiple times.""" + + # create a sound 100ms long + frequency, format, channels = mixer.get_init() + sound_length_in_ms = 100 + bytes_per_ms = int((frequency / 1000) * channels * (abs(format) // 8)) + sound = mixer.Sound(b"\x00" * int(sound_length_in_ms * bytes_per_ms)) + + self.assertAlmostEqual( + sound.get_length(), sound_length_in_ms / 1000.0, places=2 + ) + + num_loops = 5 + channel = sound.play(loops=num_loops) + self.assertIsInstance(channel, pygame.mixer.Channel) + + # the sound should be playing + pygame.time.wait((sound_length_in_ms * num_loops) - 100) + self.assertTrue(channel.get_busy()) + + # the sound should not be playing anymore + pygame.time.wait(sound_length_in_ms + 200) + self.assertFalse(channel.get_busy()) + + def test_play_indefinitely(self): + """Test playing a sound indefinitely.""" + frequency, format, channels = mixer.get_init() + sound_length_in_ms = 100 + bytes_per_ms = int((frequency / 1000) * channels * (abs(format) // 8)) + sound = mixer.Sound(b"\x00" * int(sound_length_in_ms * bytes_per_ms)) + + channel = sound.play(loops=-1) + self.assertIsInstance(channel, pygame.mixer.Channel) + + # we can't wait forever... so we wait 2 loops + for _ in range(2): + self.assertTrue(channel.get_busy()) + pygame.time.wait(sound_length_in_ms) + + def test_play_with_maxtime(self): + """Test playing a sound with maxtime.""" + channel = self.sound.play(maxtime=200) + self.assertIsInstance(channel, pygame.mixer.Channel) + self.assertTrue(channel.get_busy()) + pygame.time.wait(200 + 50) + self.assertFalse(channel.get_busy()) + + def test_play_with_fade_ms(self): + """Test playing a sound with fade_ms.""" + channel = self.sound.play(fade_ms=500) + self.assertIsInstance(channel, pygame.mixer.Channel) + self.assertTrue(channel.get_busy()) + pygame.time.wait(250) + + self.assertGreater(channel.get_volume(), 0.3) + self.assertLess(channel.get_volume(), 0.80) + + pygame.time.wait(300) + self.assertEqual(channel.get_volume(), 1.0) + + def test_play_with_invalid_loops(self): + """Test playing a sound with invalid loops.""" + with self.assertRaises(TypeError): + self.sound.play(loops="invalid") + + def test_play_with_invalid_maxtime(self): + """Test playing a sound with invalid maxtime.""" + with self.assertRaises(TypeError): + self.sound.play(maxtime="invalid") + + def test_play_with_invalid_fade_ms(self): + """Test playing a sound with invalid fade_ms.""" + with self.assertRaises(TypeError): + self.sound.play(fade_ms="invalid") + + class SoundTypeTest(unittest.TestCase): @classmethod def tearDownClass(cls): @@ -1069,17 +1093,15 @@ class SoundTypeTest(unittest.TestCase): self.assertIsInstance(sound1, mixer.Sound) self.assertIsInstance(sound2, mixer.Sound) - self.assertRaises( - FileNotFoundError, mixer.Sound, pathlib.Path("/aWH8ryIyWt5BL7xf327e") - ) # this path should not exist on any system really - def todo_test_sound__from_buffer(self): """Ensure Sound() creation with a buffer works.""" self.fail() - def todo_test_sound__from_array(self): + def test_sound__from_array(self): """Ensure Sound() creation with an array works.""" - self.fail() + array1 = array('u', example_path(os.path.join("data", "house_lo.wav"))) + sound1 = mixer.Sound(array1) + self.assertIsInstance(sound1, mixer.Sound) def test_sound__without_arg(self): """Ensure exception raised for Sound() creation with no argument.""" @@ -1098,7 +1120,7 @@ class SoundTypeTest(unittest.TestCase): def test_samples_address(self): """Test the _samples_address getter.""" try: - from ctypes import c_void_p, py_object, pythonapi + from ctypes import pythonapi, c_void_p, py_object Bytes_FromString = pythonapi.PyBytes_FromString @@ -1115,19 +1137,6 @@ class SoundTypeTest(unittest.TestCase): with self.assertRaisesRegex(pygame.error, "mixer not initialized"): snd._samples_address - def todo_test_fadeout(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Sound.fadeout: - - # Sound.fadeout(time): return None - # stop sound playback after fading out - # - # This will stop playback of the sound after fading it out over the - # time argument in milliseconds. The Sound will fade and stop on all - # actively playing channels. - # - - self.fail() - def test_get_length(self): """Tests if get_length returns a correct length.""" try: @@ -1187,38 +1196,21 @@ class SoundTypeTest(unittest.TestCase): with self.assertRaisesRegex(pygame.error, "mixer not initialized"): sound.get_volume() - def todo_test_get_volume__while_playing(self): + def test_get_volume__while_playing(self): """Ensure a sound's volume can be retrieved while playing.""" - self.fail() + try: + expected_volume = 1.0 # default + filename = example_path(os.path.join("data", "house_lo.wav")) + sound = mixer.Sound(file=filename) + sound.play(-1) - def todo_test_play(self): - # __doc__ (as of 2008-08-02) for pygame.mixer.Sound.play: + volume = sound.get_volume() - # Sound.play(loops=0, maxtime=0, fade_ms=0): return Channel - # begin sound playback - # - # Begin playback of the Sound (i.e., on the computer's speakers) on an - # available Channel. This will forcibly select a Channel, so playback - # may cut off a currently playing sound if necessary. - # - # The loops argument controls how many times the sample will be - # repeated after being played the first time. A value of 5 means that - # the sound will be played once, then repeated five times, and so is - # played a total of six times. The default value (zero) means the - # Sound is not repeated, and so is only played once. If loops is set - # to -1 the Sound will loop indefinitely (though you can still call - # stop() to stop it). - # - # The maxtime argument can be used to stop playback after a given - # number of milliseconds. - # - # The fade_ms argument will make the sound start playing at 0 volume - # and fade up to full volume over the time given. The sample may end - # before the fade-in is complete. - # - # This returns the Channel object for the channel that was selected. - - self.fail() + self.assertAlmostEqual(volume, expected_volume) + finally: + pygame.mixer.quit() + with self.assertRaisesRegex(pygame.error, "mixer not initialized"): + sound.get_volume() def test_set_volume(self): """Ensure a sound's volume can be set.""" @@ -1253,9 +1245,39 @@ class SoundTypeTest(unittest.TestCase): with self.assertRaisesRegex(pygame.error, "mixer not initialized"): sound.set_volume(1) - def todo_test_set_volume__while_playing(self): + def test_set_volume__while_playing(self): """Ensure a sound's volume can be set while playing.""" - self.fail() + try: + float_delta = 1.0 / 128 # SDL volume range is 0 to 128 + filename = example_path(os.path.join("data", "house_lo.wav")) + sound = mixer.Sound(file=filename) + current_volume = sound.get_volume() + + # (volume_set_value : expected_volume) + volumes = ( + (-1, current_volume), # value < 0 won't change volume + (0, 0.0), + (0.01, 0.01), + (0.1, 0.1), + (0.5, 0.5), + (0.9, 0.9), + (0.99, 0.99), + (1, 1.0), + (1.1, 1.0), + (2.0, 1.0), + ) + + sound.play(loops=-1) + for volume_set_value, expected_volume in volumes: + sound.set_volume(volume_set_value) + + self.assertAlmostEqual( + sound.get_volume(), expected_volume, delta=float_delta + ) + finally: + pygame.mixer.quit() + with self.assertRaisesRegex(pygame.error, "mixer not initialized"): + sound.set_volume(1) def test_stop(self): """Ensure stop can be called while not playing a sound.""" @@ -1272,9 +1294,21 @@ class SoundTypeTest(unittest.TestCase): with self.assertRaisesRegex(pygame.error, "mixer not initialized"): sound.stop() - def todo_test_stop__while_playing(self): + def test_stop__while_playing(self): """Ensure stop stops a playing sound.""" - self.fail() + try: + expected_channels = 0 + filename = example_path(os.path.join("data", "house_lo.wav")) + sound = mixer.Sound(file=filename) + + sound.play(-1) + sound.stop() + + self.assertEqual(sound.get_num_channels(), expected_channels) + finally: + pygame.mixer.quit() + with self.assertRaisesRegex(pygame.error, "mixer not initialized"): + sound.stop() def test_get_raw(self): """Ensure get_raw returns the correct bytestring.""" @@ -1304,17 +1338,6 @@ class SoundTypeTest(unittest.TestCase): except Exception: self.fail("This should not raise an exception.") - channel = mixer.Channel(0) - try: - channel.play(correct) - except Exception: - self.fail("This should not raise an exception.") - - self.assertIsInstance(channel.get_sound(), CorrectSublass) - self.assertIs(channel.get_sound(), correct) - - channel.stop() - def test_incorrect_subclassing(self): class IncorrectSuclass(mixer.Sound): def __init__(self): @@ -1324,113 +1347,130 @@ class SoundTypeTest(unittest.TestCase): self.assertRaises(RuntimeError, incorrect.get_volume) - def test_snd_copy(self): - class SubSound(mixer.Sound): - def __init__(self, *args, **kwargs): - super().__init__(*args, **kwargs) - mixer.init() +class TestSoundFadeout(unittest.TestCase): + def setUp(self): + if mixer.get_init() is None: + pygame.mixer.init() - filenames = [ - "house_lo.ogg", - "house_lo.wav", - "house_lo.flac", - "house_lo.opus", - "surfonasinewave.xm", - ] - old_volumes = [0.1, 0.2, 0.5, 0.7, 1.0] - new_volumes = [0.2, 0.3, 0.7, 1.0, 0.1] - if pygame.mixer.get_sdl_mixer_version() >= (2, 6, 0): - filenames.append("house_lo.mp3") - old_volumes.append(0.9) - new_volumes.append(0.5) + def tearDown(self): + pygame.mixer.quit() - for f, old_vol, new_vol in zip(filenames, old_volumes, new_volumes): - filename = example_path(os.path.join("data", f)) - try: - sound = mixer.Sound(file=filename) - sound.set_volume(old_vol) - except pygame.error: - continue - sound_copy = sound.copy() - self.assertEqual(sound.get_length(), sound_copy.get_length()) - self.assertEqual(sound.get_num_channels(), sound_copy.get_num_channels()) - self.assertEqual(sound.get_volume(), sound_copy.get_volume()) - self.assertEqual(sound.get_raw(), sound_copy.get_raw()) + def test_fadeout_with_valid_time(self): + """Tests if fadeout stops sound playback after fading it out over the time argument in milliseconds.""" + filename = example_path(os.path.join("data", "punch.wav")) + sound = mixer.Sound(file=filename) + channel = sound.play() + channel.fadeout(1000) + pygame.time.wait(2000) + self.assertFalse(channel.get_busy()) - sound.set_volume(new_vol) - self.assertNotEqual(sound.get_volume(), sound_copy.get_volume()) + # TODO: this fails. + # def test_fadeout_with_zero_time(self): + # """Tests if fadeout stops sound playback immediately when time argument is zero.""" + # filename = example_path(os.path.join("data", "punch.wav")) + # sound = mixer.Sound(file=filename) + # channel = sound.play() + # channel.fadeout(0) + # self.assertFalse(channel.get_busy()) - del sound + # TODO: this fails. + # def test_fadeout_with_negative_time(self): + # """Tests if fadeout stops sound playback immediately when time argument is negative.""" + # filename = example_path(os.path.join("data", "punch.wav")) + # sound = mixer.Sound(file=filename) + # channel = sound.play() + # channel.fadeout(-1000) + # self.assertFalse(channel.get_busy()) - # Test on the copy for playable sounds - channel = sound_copy.play() - if channel is None: - continue - self.assertTrue(channel.get_busy()) - sound_copy.stop() - self.assertFalse(channel.get_busy()) - sound_copy.play() - self.assertEqual(sound_copy.get_num_channels(), 1) + # TODO: What should happen here? + # def test_fadeout_with_large_time(self): + # """Tests if fadeout stops sound playback after fading it out over the time argument in milliseconds, even if time is larger than the sound length.""" + # filename = example_path(os.path.join("data", "punch.wav")) + # sound = mixer.Sound(file=filename) + # channel = sound.play() + # channel.fadeout(...?) + # pygame.time.wait(...?) + # self.assertFalse(channel.get_busy()) - # Test __copy__ - for f, old_vol, new_vol in zip(filenames, old_volumes, new_volumes): - filename = example_path(os.path.join("data", f)) - try: - sound = mixer.Sound(file=filename) - sound.set_volume(old_vol) - except pygame.error: - continue - sound_copy = copy.copy(sound) - self.assertEqual(sound.get_length(), sound_copy.get_length()) - self.assertEqual(sound.get_num_channels(), sound_copy.get_num_channels()) - self.assertEqual(sound.get_volume(), sound_copy.get_volume()) - self.assertEqual(sound.get_raw(), sound_copy.get_raw()) - sound.set_volume(new_vol) - self.assertNotEqual(sound.get_volume(), sound_copy.get_volume()) +class TestGetBusy(unittest.TestCase): + """Test pygame.mixer.get_busy. - del sound + |tags:slow| + """ - # Test on the copy for playable sounds - channel = sound_copy.play() - if channel is None: - continue - self.assertTrue(channel.get_busy()) - sound_copy.stop() - self.assertFalse(channel.get_busy()) - sound_copy.play() - self.assertEqual(sound_copy.get_num_channels(), 1) + def setUp(self): + pygame.mixer.init() - # Test copying a subclass of Sound - for f, old_vol, new_vol in zip(filenames, old_volumes, new_volumes): - filename = example_path(os.path.join("data", f)) - try: - sound = SubSound(file=filename) - sound.set_volume(old_vol) - except pygame.error: - continue - sound_copy = sound.copy() - self.assertIsInstance(sound_copy, SubSound) - self.assertEqual(sound.get_length(), sound_copy.get_length()) - self.assertEqual(sound.get_num_channels(), sound_copy.get_num_channels()) - self.assertEqual(sound.get_volume(), sound_copy.get_volume()) - self.assertEqual(sound.get_raw(), sound_copy.get_raw()) + def tearDown(self): + pygame.mixer.quit() - sound.set_volume(new_vol) - self.assertNotEqual(sound.get_volume(), sound_copy.get_volume()) + def test_no_sound_playing(self): + """ + Test that get_busy returns False when no sound is playing. + """ + self.assertFalse(pygame.mixer.get_busy()) - del sound + def test_one_sound_playing(self): + """ + Test that get_busy returns True when one sound is playing. + """ + sound = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound.play() + time.sleep(0.2) + self.assertTrue(pygame.mixer.get_busy()) + sound.stop() - # Test on the copy for playable sounds - channel = sound_copy.play() - if channel is None: - continue - self.assertTrue(channel.get_busy()) - sound_copy.stop() - self.assertFalse(channel.get_busy()) - sound_copy.play() - self.assertEqual(sound_copy.get_num_channels(), 1) + def test_multiple_sounds_playing(self): + """ + Test that get_busy returns True when multiple sounds are playing. + """ + sound1 = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound2 = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound1.play() + sound2.play() + time.sleep(0.2) + self.assertTrue(pygame.mixer.get_busy()) + sound1.stop() + sound2.stop() + + def test_all_sounds_stopped(self): + """ + Test that get_busy returns False when all sounds are stopped. + """ + sound1 = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound2 = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound1.play() + sound2.play() + time.sleep(0.2) + sound1.stop() + sound2.stop() + time.sleep(0.2) + self.assertFalse(pygame.mixer.get_busy()) + + def test_all_sounds_stopped_with_fadeout(self): + """ + Test that get_busy returns False when all sounds are stopped with + fadeout. + """ + sound1 = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound2 = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound1.play() + sound2.play() + time.sleep(0.2) + sound1.fadeout(100) + sound2.fadeout(100) + time.sleep(0.3) + self.assertFalse(pygame.mixer.get_busy()) + + def test_sound_fading_out(self): + """Tests that get_busy() returns True when a sound is fading out""" + sound = pygame.mixer.Sound(example_path("data/house_lo.wav")) + sound.play(fade_ms=1000) + time.sleep(1.1) + self.assertTrue(pygame.mixer.get_busy()) + sound.stop() ##################################### MAIN ##################################### diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/mouse_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/mouse_test.py index 6a5f2d3..53eac3a 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/mouse_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/mouse_test.py @@ -1,10 +1,10 @@ +import unittest import os import platform -import unittest import warnings - import pygame + DARWIN = "Darwin" in platform.platform() @@ -27,10 +27,10 @@ class MouseModuleInteractiveTest(MouseTests): Requires tester to move the mouse to be on the window. """ pygame.display.set_mode((500, 500)) - pygame.event.get() # Pump event queue to make window get focus on macOS. + pygame.event.get() # Pump event queue to make window get focus on macos. if not pygame.mouse.get_focused(): - # The window needs to be focused for the mouse.set_pos to work on macOS. + # The window needs to be focused for the mouse.set_pos to work on macos. return clock = pygame.time.Clock() @@ -56,7 +56,7 @@ class MouseModuleInteractiveTest(MouseTests): class MouseModuleTest(MouseTests): @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER", "") == pygame.NULL_VIDEODRIVER, + os.environ.get("SDL_VIDEODRIVER", "") == "dummy", "Cursors not supported on headless test machines", ) def test_get_cursor(self): @@ -96,7 +96,7 @@ class MouseModuleTest(MouseTests): pygame.mouse.get_cursor() @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER", "") == pygame.NULL_VIDEODRIVER, + os.environ.get("SDL_VIDEODRIVER", "") == "dummy", "mouse.set_system_cursor only available in SDL2", ) def test_set_system_cursor(self): @@ -138,7 +138,7 @@ class MouseModuleTest(MouseTests): ) @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER", "") == pygame.NULL_VIDEODRIVER, + os.environ.get("SDL_VIDEODRIVER", "") == "dummy", "Cursors not supported on headless test machines", ) def test_set_cursor(self): @@ -285,36 +285,9 @@ class MouseModuleTest(MouseTests): for value in buttons_pressed: self.assertIsInstance(value, bool) - desktop_pressed1 = pygame.mouse.get_pressed(desktop=True) - desktop_pressed2 = pygame.mouse.get_pressed(5, desktop=True) - desktop_pressed3 = pygame.mouse.get_pressed(3, True) - self.assertEqual(len(desktop_pressed1), 3) - self.assertEqual(len(desktop_pressed2), 5) - self.assertEqual(len(desktop_pressed3), 3) - for desktop_pressed in [desktop_pressed1, desktop_pressed2, desktop_pressed3]: - self.assertIsInstance(desktop_pressed, tuple) - for value in desktop_pressed: - self.assertIsInstance(value, bool) - with self.assertRaises(ValueError): pygame.mouse.get_pressed(4) - def test_get_just_pressed(self): - mouse_buttons = pygame.mouse.get_just_pressed() - self.assertIsInstance(mouse_buttons, tuple) - self.assertEqual(len(mouse_buttons), 5) - for value in mouse_buttons: - self.assertIsInstance(value, bool) - self.assertEqual(value, False) - - def test_get_just_released(self): - mouse_buttons = pygame.mouse.get_just_released() - self.assertIsInstance(mouse_buttons, tuple) - self.assertEqual(len(mouse_buttons), 5) - for value in mouse_buttons: - self.assertIsInstance(value, bool) - self.assertEqual(value, False) - def test_get_pos(self): """Ensures get_pos returns the correct types.""" expected_length = 2 @@ -326,16 +299,6 @@ class MouseModuleTest(MouseTests): for value in pos: self.assertIsInstance(value, int) - desktop_pos1 = pygame.mouse.get_pos(True) - desktop_pos2 = pygame.mouse.get_pos(desktop=True) - self.assertEqual(desktop_pos1, desktop_pos2) - - for desktop_pos in [desktop_pos1, desktop_pos2]: - self.assertIsInstance(desktop_pos, tuple) - self.assertEqual(len(desktop_pos), expected_length) - for value in desktop_pos: - self.assertIsInstance(value, int) - def test_set_pos__invalid_pos(self): """Ensures set_pos handles invalid positions correctly.""" for invalid_pos in ((1,), [1, 2, 3], 1, "1", (1, "1"), []): @@ -378,41 +341,6 @@ class MouseModuleTest(MouseTests): with self.assertRaises(TypeError): prev_visible = pygame.mouse.set_visible(invalid_value) - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER", "") == pygame.NULL_VIDEODRIVER, - "mouse.set_relative_mode requires non-null video driver", - ) - def test_set_relative_mode(self): - """Tests that set_relative_mode hides the cursor.""" - for val in (True, False): - if pygame.version.SDL >= (3, 0, 0): - with self.assertRaises(pygame.error): - pygame.mouse.set_relative_mode(val) - else: - with self.assertWarns(DeprecationWarning): - pygame.mouse.set_relative_mode(val) - - pygame.display.set_mode((100, 100)) - pygame.mouse.set_visible(True) - pygame.mouse.set_relative_mode(True) # sets the mouse invisible - visible = pygame.mouse.get_visible() - self.assertEqual(visible, False) - pygame.mouse.set_relative_mode(False) # sets the mouse visible - visible = pygame.mouse.get_visible() - self.assertEqual(visible, True) - - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER", "") == pygame.NULL_VIDEODRIVER, - "mouse.set_relative_mode requires non-null video driver", - ) - def test_get_relative_mode(self): - """Tests that get_relative_mode correctly reports the relative mode""" - pygame.display.set_mode((100, 100)) - pygame.mouse.set_relative_mode(True) - self.assertEqual(pygame.mouse.get_relative_mode(), True) - pygame.mouse.set_relative_mode(False) - self.assertEqual(pygame.mouse.get_relative_mode(), False) - ################################################################################ diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/pixelarray_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/pixelarray_test.py index 62db285..7b1cf42 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/pixelarray_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/pixelarray_test.py @@ -15,6 +15,7 @@ except NameError: import pygame + IS_PYPY = "PyPy" == platform.python_implementation() @@ -307,7 +308,7 @@ class PixelArrayTypeTest(unittest.TestCase, TestMixin): self.assertFalse(sf.get_locked()) def test_as_class(self): - # Check general new-style class features. + # Check general new-style class freatures. sf = pygame.Surface((2, 3), 0, 32) ar = pygame.PixelArray(sf) self.assertRaises(AttributeError, getattr, ar, "nonnative") @@ -669,7 +670,7 @@ class PixelArrayTypeTest(unittest.TestCase, TestMixin): self.assertEqual(refcnts_after, refcnts_before) def test_subscript(self): - # By default, we do not need to work with any special __***__ + # By default we do not need to work with any special __***__ # methods as map subscripts are the first looked up by the # object system. for bpp in (8, 16, 24, 32): @@ -1019,6 +1020,7 @@ class PixelArrayTypeTest(unittest.TestCase, TestMixin): self.assertEqual(iterations, 5) def test_replace(self): + # print("replace start") for bpp in (8, 16, 24, 32): sf = pygame.Surface((10, 10), 0, bpp) sf.fill((255, 0, 0)) @@ -1039,8 +1041,10 @@ class PixelArrayTypeTest(unittest.TestCase, TestMixin): self.assertEqual(ar[3][6], oval) self.assertEqual(ar[8][9], oval) self.assertEqual(ar[9][9], oval) + # print("replace end") def test_extract(self): + # print("extract start") for bpp in (8, 16, 24, 32): sf = pygame.Surface((10, 10), 0, bpp) sf.fill((0, 0, 255)) @@ -1066,6 +1070,7 @@ class PixelArrayTypeTest(unittest.TestCase, TestMixin): self.assertEqual(newar[3][6], white) self.assertEqual(newar[8][9], black) self.assertEqual(newar[9][9], black) + # print("extract end") def test_2dslice_assignment(self): w = 2 * 5 * 8 @@ -1229,7 +1234,7 @@ class PixelArrayTypeTest(unittest.TestCase, TestMixin): def test_transpose(self): # PixelArray.transpose(): swap axis on a 2D array, add a length - # 1 x-axis to a 1D array. + # 1 x axis to a 1D array. sf = pygame.Surface((3, 7), 0, 32) ar = pygame.PixelArray(sf) w, h = ar.shape @@ -1304,113 +1309,6 @@ class PixelArrayTypeTest(unittest.TestCase, TestMixin): pixel = sf.get_at_mapped((0, 0)) self.assertEqual(repr(ar), type(ar).__name__ + "([\n [42, 42, 42]]\n)") - def test_zero_size_surface(self): - """Should not be able to create PixelArray on a surface with a width or height of 0 - Regression test for pygame-ce issue 2275 (https://github.com/pygame-community/pygame-ce/issues/2275) - """ - weird_surface = pygame.Surface((5, 0)) - self.assertRaises(ValueError, lambda: pygame.PixelArray(weird_surface)) - - weird_surface = pygame.Surface((0, 5)) - self.assertRaises(ValueError, lambda: pygame.PixelArray(weird_surface)) - - def test_assign_seq_to_single(self): - """ - Regression test for https://github.com/pygame-community/pygame-ce/issues/2740 - This usage should ValueError and not segfault (as list is to be interpreted as - pixel sequence, and not color) - """ - test = pygame.PixelArray(pygame.Surface([800, 800])) - with self.assertRaises(ValueError): - test[400][400] = [255, 255, 0] - - with self.assertRaises(ValueError): - test[400, 400] = [255, 255, 0] - - def test_set_pixel_24bit_formats(self): - """Pixel assignment must write the correct channels on both RGB24 and BGR24. - - On little-endian systems, RGB24 has Rmask=0xFF (R at byte 0) while the - default pygame.Surface(..., 24) produces BGR24 (Rmask=0xFF0000, R at - byte 2). The old _array_assign_index code assumed the mapped color was - always 0x00RRGGBB, which silently worked for BGR24 but swapped R and B - for RGB24. - """ - color = (200, 100, 50) - masks_and_names = [ - ((0xFF, 0xFF00, 0xFF0000, 0), "RGB24"), - ((0xFF0000, 0xFF00, 0xFF, 0), "BGR24"), - ] - for masks, name in masks_and_names: - with self.subTest(format=name): - sf = pygame.Surface((4, 4), depth=24, masks=masks) - sf.fill((0, 0, 0)) - ar = pygame.PixelArray(sf) - ar[1][2] = color - del ar - self.assertEqual(sf.get_at((1, 2))[:3], color) - - def test_set_slice_24bit_formats(self): - """Slice assignment with a single color must write correctly on RGB24 and BGR24.""" - color = (200, 100, 50) - masks_and_names = [ - ((0xFF, 0xFF00, 0xFF0000, 0), "RGB24"), - ((0xFF0000, 0xFF00, 0xFF, 0), "BGR24"), - ] - for masks, name in masks_and_names: - with self.subTest(format=name): - sf = pygame.Surface((4, 4), depth=24, masks=masks) - sf.fill((0, 0, 0)) - ar = pygame.PixelArray(sf) - ar[0:2] = color - del ar - self.assertEqual(sf.get_at((0, 0))[:3], color) - self.assertEqual(sf.get_at((1, 3))[:3], color) - self.assertEqual(sf.get_at((2, 0))[:3], (0, 0, 0)) - - def test_set_sequence_24bit_formats(self): - """Slice assignment with a color list must write correctly on RGB24 and BGR24.""" - color_a = (200, 100, 50) - color_b = (10, 20, 30) - masks_and_names = [ - ((0xFF, 0xFF00, 0xFF0000, 0), "RGB24"), - ((0xFF0000, 0xFF00, 0xFF, 0), "BGR24"), - ] - for masks, name in masks_and_names: - with self.subTest(format=name): - sf = pygame.Surface((4, 4), depth=24, masks=masks) - sf.fill((0, 0, 0)) - ar = pygame.PixelArray(sf) - ar[0:2] = [color_a, color_b] - del ar - self.assertEqual(sf.get_at((0, 0))[:3], color_a) - self.assertEqual(sf.get_at((1, 0))[:3], color_b) - - def test_replace_24bit_formats(self): - """PixelArray.replace must match and write the correct channels on RGB24 and BGR24.""" - old_color = (200, 100, 50) - new_color = (10, 20, 30) - masks_and_names = [ - ((0xFF, 0xFF00, 0xFF0000, 0), "RGB24"), - ((0xFF0000, 0xFF00, 0xFF, 0), "BGR24"), - ] - for masks, name in masks_and_names: - with self.subTest(format=name): - sf = pygame.Surface((4, 4), depth=24, masks=masks) - sf.fill(old_color) - ar = pygame.PixelArray(sf) - ar.replace(old_color, new_color) - del ar - self.assertEqual(sf.get_at((0, 0))[:3], new_color) - self.assertEqual(sf.get_at((3, 3))[:3], new_color) - - # distance-based variant - sf.fill(old_color) - ar = pygame.PixelArray(sf) - ar.replace(old_color, new_color, distance=0.1) - del ar - self.assertEqual(sf.get_at((0, 0))[:3], new_color) - @unittest.skipIf(IS_PYPY, "pypy having issues") class PixelArrayArrayInterfaceTest(unittest.TestCase, TestMixin): @@ -1542,9 +1440,11 @@ class PixelArrayArrayInterfaceTest(unittest.TestCase, TestMixin): self.assert_surfaces_equal(sf3, sf2) +@unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") @unittest.skipIf(IS_PYPY, "pypy having issues") class PixelArrayNewBufferTest(unittest.TestCase, TestMixin): - from pygame.tests.test_utils import buftools + if pygame.HAVE_NEWBUF: + from pygame.tests.test_utils import buftools bitsize_to_format = {8: "B", 16: "=H", 24: "3x", 32: "=I"} diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/pixelcopy_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/pixelcopy_test.py index 534a80e..46051cd 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/pixelcopy_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/pixelcopy_test.py @@ -7,7 +7,7 @@ except NameError: pass import pygame from pygame.locals import * -from pygame.pixelcopy import array_to_surface, make_surface, map_array, surface_to_array +from pygame.pixelcopy import surface_to_array, map_array, array_to_surface, make_surface IS_PYPY = "PyPy" == platform.python_implementation() @@ -377,7 +377,7 @@ class PixelCopyTestWithArrayNumpy(unittest.TestCase): def test_surface_to_array_2d(self): try: - from numpy import dtype, empty + from numpy import empty, dtype except ImportError: return @@ -458,7 +458,7 @@ class PixelCopyTestWithArrayNumpy(unittest.TestCase): def test_surface_to_array_3d(self): try: - from numpy import dtype, empty + from numpy import empty, dtype except ImportError: return @@ -534,7 +534,7 @@ class PixelCopyTestWithArrayNumpy(unittest.TestCase): def test_map_array(self): try: - from numpy import all as np_all, array, int32, uint8, zeros + from numpy import array, zeros, uint8, int32, all as alltrue except ImportError: return @@ -545,7 +545,7 @@ class PixelCopyTestWithArrayNumpy(unittest.TestCase): target = zeros((5, 7), int32) map_array(target, color, surf) - self.assertTrue(np_all(target == surf.map_rgb(color))) + self.assertTrue(alltrue(target == surf.map_rgb(color))) # array column stripes stripe = array([[2, 5, 7], [11, 19, 23], [37, 53, 101]], uint8) @@ -553,7 +553,7 @@ class PixelCopyTestWithArrayNumpy(unittest.TestCase): map_array(target, stripe, surf) target_stripe = array([surf.map_rgb(c) for c in stripe], int32) - self.assertTrue(np_all(target == target_stripe)) + self.assertTrue(alltrue(target == target_stripe)) # array row stripes stripe = array( @@ -563,7 +563,7 @@ class PixelCopyTestWithArrayNumpy(unittest.TestCase): map_array(target, stripe, surf) target_stripe = array([[surf.map_rgb(c)] for c in stripe[:, 0]], int32) - self.assertTrue(np_all(target == target_stripe)) + self.assertTrue(alltrue(target == target_stripe)) # mismatched shape w = 4 @@ -593,41 +593,43 @@ class PixelCopyTestWithArrayNumpy(unittest.TestCase): del numpy +@unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") @unittest.skipIf(IS_PYPY, "pypy having illegal instruction on mac") class PixelCopyTestWithArrayNewBuf(unittest.TestCase): - from pygame.tests.test_utils import buftools + if pygame.HAVE_NEWBUF: + from pygame.tests.test_utils import buftools - class Array2D(buftools.Exporter): - def __init__(self, initializer): - from ctypes import POINTER, c_uint32, cast + class Array2D(buftools.Exporter): + def __init__(self, initializer): + from ctypes import cast, POINTER, c_uint32 - Array2D = PixelCopyTestWithArrayNewBuf.Array2D - super().__init__((3, 5), format="=I", strides=(20, 4)) - self.content = cast(self.buf, POINTER(c_uint32)) - for i, v in enumerate(initializer): - self.content[i] = v + Array2D = PixelCopyTestWithArrayNewBuf.Array2D + super().__init__((3, 5), format="=I", strides=(20, 4)) + self.content = cast(self.buf, POINTER(c_uint32)) + for i, v in enumerate(initializer): + self.content[i] = v - def __getitem__(self, key): - byte_index = key[0] * 5 + key[1] - if not (0 <= byte_index < 15): - raise IndexError("%s is out of range", key) - return self.content[byte_index] + def __getitem__(self, key): + byte_index = key[0] * 5 + key[1] + if not (0 <= byte_index < 15): + raise IndexError("%s is out of range", key) + return self.content[byte_index] - class Array3D(buftools.Exporter): - def __init__(self, initializer): - from ctypes import POINTER, c_uint8, cast + class Array3D(buftools.Exporter): + def __init__(self, initializer): + from ctypes import cast, POINTER, c_uint8 - Array3D = PixelCopyTestWithArrayNewBuf.Array3D - super().__init__((3, 5, 3), format="B", strides=(20, 4, 1)) - self.content = cast(self.buf, POINTER(c_uint8)) - for i, v in enumerate(initializer): - self.content[i] = v + Array3D = PixelCopyTestWithArrayNewBuf.Array3D + super().__init__((3, 5, 3), format="B", strides=(20, 4, 1)) + self.content = cast(self.buf, POINTER(c_uint8)) + for i, v in enumerate(initializer): + self.content[i] = v - def __getitem__(self, key): - byte_index = key[0] * 20 + key[1] * 4 + key[2] - if not (0 <= byte_index < 60): - raise IndexError("%s is out of range", key) - return self.content[byte_index] + def __getitem__(self, key): + byte_index = key[0] * 20 + key[1] * 4 + key[2] + if not (0 <= byte_index < 60): + raise IndexError("%s is out of range", key) + return self.content[byte_index] surface = pygame.Surface((3, 5), 0, 32) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/rect_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/rect_test.py index d531235..71a7521 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/rect_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/rect_test.py @@ -1,18 +1,24 @@ import math import unittest from collections.abc import Collection, Sequence +import platform +import random -from pygame import FRect, Rect as IRect, Vector2 +from pygame import Rect, Vector2 from pygame.tests import test_utils -Rect = IRect +IS_PYPY = "PyPy" == platform.python_implementation() + +# todo can they be different on different platforms? +_int_min = -2147483647 - 1 # min value of int in C +_int_max = 2147483647 # max value of int in C + + +def _random_int(): + return random.randint(_int_min, _int_max) class RectTypeTest(unittest.TestCase): - def setUp(self): - global Rect - Rect = IRect - def _assertCountEqual(self, *args, **kwargs): self.assertCountEqual(*args, **kwargs) @@ -52,54 +58,6 @@ class RectTypeTest(unittest.TestCase): self.assertEqual((r.left, r.centery), r.midleft) self.assertEqual((r.right, r.centery), r.midright) - def testAttributes(self): - """Checks that all the attributes are initialized correctly.""" - r = Rect(1, 2, 3, 4) - - self.assertEqual(1, r.left) - self.assertEqual(2, r.top) - self.assertEqual(4, r.right) - self.assertEqual(6, r.bottom) - - self.assertEqual(1, r.x) - self.assertEqual(2, r.y) - - self.assertEqual(3, r.w) - self.assertEqual(4, r.h) - - self.assertEqual((1, 2), r.topleft) - self.assertEqual((4, 2), r.topright) - self.assertEqual((1, 6), r.bottomleft) - self.assertEqual((4, 6), r.bottomright) - - self.assertEqual((3, 4), r.size) - self.assertEqual(3, r.width) - self.assertEqual(4, r.height) - - if isinstance(r, FRect): - self.assertEqual(2.5, r.centerx) - self.assertEqual(4, r.centery) - self.assertEqual((2.5, 4), r.center) - - self.assertEqual((2.5, 2), r.midtop) - self.assertEqual((2.5, 6), r.midbottom) - self.assertEqual((1, 4), r.midleft) - self.assertEqual((4, 4), r.midright) - - elif isinstance(r, Rect): - self.assertEqual(2, r.centerx) - self.assertEqual(4, r.centery) - self.assertEqual((2, 4), r.center) - - self.assertEqual((2, 2), r.midtop) - self.assertEqual((2, 6), r.midbottom) - self.assertEqual((1, 4), r.midleft) - self.assertEqual((4, 4), r.midright) - - def testRepr(self): - rect = Rect(12, 34, 56, 78) - self.assertEqual(repr(rect), "Rect(12, 34, 56, 78)") - def test_rect_iter(self): rect = Rect(50, 100, 150, 200) @@ -556,35 +514,6 @@ class RectTypeTest(unittest.TestCase): with self.assertRaises(AttributeError): del r.center - def test_relcenter(self): - """Changing the relcenter attribute changes the rect's size and - does not move the rect. - """ - r = Rect(1, 2, 75, 45) - new_relcenter = (697, 345) - old_topleft = (r.left, r.top) - expected_size = (697 * 2, 345 * 2) - - r.relcenter = new_relcenter - self.assertEqual(new_relcenter, r.relcenter) - self.assertEqual(old_topleft, r.topleft) - self.assertEqual(expected_size, r.size) - - def test_relcenter__invalid_value(self): - """Ensures the relcenter attribute handles invalid values correctly.""" - r = Rect(0, 0, 1, 1) - - for value in (None, [], "1", 1, (1,), [1, 2, 3]): - with self.assertRaises(TypeError): - r.relcenter = value - - def test_relcenter__del(self): - """Ensures the relcenter attribute can't be deleted.""" - r = Rect(0, 0, 1, 1) - - with self.assertRaises(AttributeError): - del r.relcenter - def test_midleft(self): """Changing the midleft attribute moves the rect and does not change the rect's size @@ -808,7 +737,6 @@ class RectTypeTest(unittest.TestCase): self.assertTrue(2 in Rect(0, 0, 1, 2), "r does not contain 2") self.assertFalse(3 in Rect(0, 0, 1, 2), "r contains 3") - self.assertRaises(TypeError, lambda: 1.0 in Rect(0, 0, 1, 2)) self.assertRaises(TypeError, lambda: "string" in Rect(0, 0, 1, 2)) self.assertRaises(TypeError, lambda: 4 + 3j in Rect(0, 0, 1, 2)) @@ -846,74 +774,64 @@ class RectTypeTest(unittest.TestCase): ) def test_inflate__larger(self): - """Ensures inflating a rect keeps its center the same - and grows dimensions by correct values.""" + """The inflate method inflates around the center of the rectangle""" r = Rect(2, 4, 6, 8) r2 = r.inflate(4, 6) - self.assertEqual(r2.center, (5, 8)) - self.assertEqual(r2.left, 0) - self.assertEqual(r2.top, 1) - self.assertEqual(r2.right, 10) - self.assertEqual(r2.bottom, 15) - self.assertEqual(r2.width, 10) - self.assertEqual(r2.height, 14) + self.assertEqual(r.center, r2.center) + self.assertEqual(r.left - 2, r2.left) + self.assertEqual(r.top - 3, r2.top) + self.assertEqual(r.right + 2, r2.right) + self.assertEqual(r.bottom + 3, r2.bottom) + self.assertEqual(r.width + 4, r2.width) + self.assertEqual(r.height + 6, r2.height) def test_inflate__smaller(self): - """Ensures deflating a rect keeps its center the same - and shrinks dimensions by correct values.""" + """The inflate method inflates around the center of the rectangle""" r = Rect(2, 4, 6, 8) r2 = r.inflate(-4, -6) - expected_new_relcenter = r.w // 2 - 2, r.h // 2 - 3 - self.assertEqual(expected_new_relcenter, r2.relcenter) - self.assertEqual((5, 8), r2.center) - self.assertEqual(4, r2.left) - self.assertEqual(7, r2.top) - self.assertEqual(6, r2.right) - self.assertEqual(9, r2.bottom) - self.assertEqual(2, r2.width) - self.assertEqual(2, r2.height) + self.assertEqual(r.center, r2.center) + self.assertEqual(r.left + 2, r2.left) + self.assertEqual(r.top + 3, r2.top) + self.assertEqual(r.right - 2, r2.right) + self.assertEqual(r.bottom - 3, r2.bottom) + self.assertEqual(r.width - 4, r2.width) + self.assertEqual(r.height - 6, r2.height) def test_inflate_ip__larger(self): - """Ensures inflating a rect in place keeps its center the same - and grows dimensions by correct values.""" - r = Rect(2, 4, 6, 8) - r2 = Rect(r) - r2.inflate_ip(4, 6) - - self.assertEqual(r2.center, (5, 8)) - self.assertEqual(r2.left, 0) - self.assertEqual(r2.top, 1) - self.assertEqual(r2.right, 10) - self.assertEqual(r2.bottom, 15) - self.assertEqual(r2.width, 10) - self.assertEqual(r2.height, 14) - - def test_inflate_ip__smaller(self): - """Ensures deflating a rect in place keeps its center the same - and shrinks dimensions by correct values.""" + """The inflate_ip method inflates around the center of the rectangle""" r = Rect(2, 4, 6, 8) r2 = Rect(r) r2.inflate_ip(-4, -6) - expected_new_relcenter = r.w // 2 - 2, r.h // 2 - 3 - self.assertEqual(expected_new_relcenter, r2.relcenter) - self.assertEqual(r2.center, (5, 8)) - self.assertEqual(r2.left, 4) - self.assertEqual(r2.top, 7) - self.assertEqual(r2.right, 6) - self.assertEqual(r2.bottom, 9) - self.assertEqual(r2.width, 2) - self.assertEqual(r2.height, 2) + self.assertEqual(r.center, r2.center) + self.assertEqual(r.left + 2, r2.left) + self.assertEqual(r.top + 3, r2.top) + self.assertEqual(r.right - 2, r2.right) + self.assertEqual(r.bottom - 3, r2.bottom) + self.assertEqual(r.width - 4, r2.width) + self.assertEqual(r.height - 6, r2.height) + + def test_inflate_ip__smaller(self): + """The inflate method inflates around the center of the rectangle""" + r = Rect(2, 4, 6, 8) + r2 = Rect(r) + r2.inflate_ip(-4, -6) + + self.assertEqual(r.center, r2.center) + self.assertEqual(r.left + 2, r2.left) + self.assertEqual(r.top + 3, r2.top) + self.assertEqual(r.right - 2, r2.right) + self.assertEqual(r.bottom - 3, r2.bottom) + self.assertEqual(r.width - 4, r2.width) + self.assertEqual(r.height - 6, r2.height) def test_scale_by__larger_single_argument(self): """The scale method scales around the center of the rectangle""" r = Rect(2, 4, 6, 8) r2 = r.scale_by(2) - expected_new_relcenter = r.size - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left - 3, r2.left) self.assertEqual(r.top - 4, r2.top) @@ -927,9 +845,7 @@ class RectTypeTest(unittest.TestCase): keyword arguments 'x' and 'y'""" r = Rect(2, 4, 6, 8) r2 = r.scale_by(x=2) - expected_new_relcenter = r.size - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left - 3, r2.left) self.assertEqual(r.top - 4, r2.top) @@ -942,9 +858,7 @@ class RectTypeTest(unittest.TestCase): """The scale method scales around the center of the rectangle""" r = Rect(2, 4, 8, 8) r2 = r.scale_by(0.5) - expected_new_relcenter = r.w // 4, r.h // 4 - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left + 2, r2.left) self.assertEqual(r.top + 2, r2.top) @@ -960,9 +874,6 @@ class RectTypeTest(unittest.TestCase): # act r2 = r.scale_by(2, 4) # assert - expected_new_relcenter = r.w, r.h * 2 - - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left - 3, r2.left) self.assertEqual(r.centery - r.h * 4 / 2, r2.top) @@ -980,12 +891,7 @@ class RectTypeTest(unittest.TestCase): r = Rect(2, 4, 6, 8) # act r2 = r.scale_by(scale_by=(2, 4)) - r3 = r.scale_by((2, 4)) - self.assertEqual(r2, r3) # assert - expected_new_relcenter = r.w, r.h * 2 - - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left - 3, r2.left) self.assertEqual(r.centery - r.h * 4 / 2, r2.top) @@ -1004,9 +910,6 @@ class RectTypeTest(unittest.TestCase): # act r2 = r.scale_by(x=2, y=4) # assert - expected_new_relcenter = r.w, r.h * 2 - - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left - 3, r2.left) self.assertEqual(r.centery - r.h * 4 / 2, r2.top) @@ -1022,9 +925,6 @@ class RectTypeTest(unittest.TestCase): # act r2 = r.scale_by(0.5, 0.25) # assert - expected_new_relcenter = r.w // 4, r.h // 8 - - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left + 2, r2.left) self.assertEqual(r.centery - r.h / 4 / 2, r2.top) @@ -1042,43 +942,28 @@ class RectTypeTest(unittest.TestCase): r.scale_by(0.00001) rx1 = r.scale_by(10, 1) - expected_new_relcenter = r.w * 5, r.h // 2 - - self.assertEqual(expected_new_relcenter, rx1.relcenter) self.assertEqual(r.centerx - r.w * 10 / 2, rx1.x) self.assertEqual(r.y, rx1.y) self.assertEqual(r.w * 10, rx1.w) self.assertEqual(r.h, rx1.h) rx2 = r.scale_by(-10, 1) - expected_new_relcenter = r.w * 5, r.h // 2 - - self.assertEqual(expected_new_relcenter, rx2.relcenter) self.assertEqual(rx1.x, rx2.x) self.assertEqual(rx1.y, rx2.y) self.assertEqual(rx1.w, rx2.w) self.assertEqual(rx1.h, rx2.h) ry1 = r.scale_by(1, 10) - expected_new_relcenter = r.w // 2, r.h * 5 - - self.assertEqual(expected_new_relcenter, ry1.relcenter) self.assertEqual(r.x, ry1.x) self.assertEqual(r.centery - r.h * 10 / 2, ry1.y) self.assertEqual(r.w, ry1.w) self.assertEqual(r.h * 10, ry1.h) ry2 = r.scale_by(1, -10) - expected_new_relcenter = r.w // 2, r.h * 5 - - self.assertEqual(expected_new_relcenter, ry2.relcenter) self.assertEqual(ry1.x, ry2.x) self.assertEqual(ry1.y, ry2.y) self.assertEqual(ry1.w, ry2.w) self.assertEqual(ry1.h, ry2.h) r1 = r.scale_by(10) - expected_new_relcenter = r.w * 5, r.h * 5 - - self.assertEqual(expected_new_relcenter, r1.relcenter) self.assertEqual(r.centerx - r.w * 10 / 2, r1.x) self.assertEqual(r.centery - r.h * 10 / 2, r1.y) self.assertEqual(r.w * 10, r1.w) @@ -1120,7 +1005,7 @@ class RectTypeTest(unittest.TestCase): self.assertEqual(r.w, actual.w) self.assertEqual(r.h, actual.h) - def test_scale_by_negative_identity_single_argument(self): + def test_scale_by_negative_identity_single_argment(self): """The scale method scales around the center of the rectangle""" # arrange r = Rect(2, 4, 6, 8) @@ -1137,9 +1022,7 @@ class RectTypeTest(unittest.TestCase): r = Rect(2, 4, 6, 8) r2 = Rect(r) r2.scale_by_ip(2) - expected_new_relcenter = r.w, r.h - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left - 3, r2.left) self.assertEqual(r.top - 4, r2.top) @@ -1153,9 +1036,7 @@ class RectTypeTest(unittest.TestCase): r = Rect(2, 4, 8, 8) r2 = Rect(r) r2.scale_by_ip(0.5) - expected_new_relcenter = r.w // 4, r.h // 4 - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left + 2, r2.left) self.assertEqual(r.top + 2, r2.top) @@ -1179,9 +1060,6 @@ class RectTypeTest(unittest.TestCase): r2.scale_by_ip(x=2, y=4) # assert - expected_new_relcenter = r.w, r.h * 2 - - self.assertEqual(expected_new_relcenter, r2.relcenter) self.assertEqual(r.center, r2.center) self.assertEqual(r.left - 3, r2.left) self.assertEqual(r.centery - r.h * 4 / 2, r2.top) @@ -1233,10 +1111,6 @@ class RectTypeTest(unittest.TestCase): self.assertEqual( r1, r1.clip(Rect(r1)), "r1 does not clip an identical rect to itself" ) - self.assertEqual(Rect(1, 2, 0, 0), r1.clip(Rect(3, 0, 2, 2))) - self.assertEqual(Rect(1, 2, 0, 0), r1.clip(Rect(3, 8, 2, 2))) - self.assertEqual(Rect(1, 2, 0, 0), r1.clip(Rect(-2, 8, 2, 2))) - self.assertEqual(Rect(1, 2, 0, 0), r1.clip(Rect(-2, 0, 2, 2))) def test_clipline(self): """Ensures clipline handles four int parameters. @@ -1277,6 +1151,30 @@ class RectTypeTest(unittest.TestCase): self.assertIsInstance(clipped_line, tuple) self.assertTupleEqual(clipped_line, expected_line) + def test_clipline__two_sequences_kwarg(self): + """Ensures clipline handles a sequence of two sequences using kwargs. + + Tests the clipline((x1, y1), (x2, y2)) format. + Tests the sequences as different types. + """ + rect = Rect((1, 2), (35, 40)) + pt1 = (5, 6) + pt2 = (11, 19) + + INNER_SEQUENCES = (list, tuple, Vector2) + expected_line = (pt1, pt2) + + for inner_seq1 in INNER_SEQUENCES: + endpt1 = inner_seq1(pt1) + + for inner_seq2 in INNER_SEQUENCES: + clipped_line = rect.clipline( + first_coordinate=endpt1, second_coordinate=inner_seq2(pt2) + ) + + self.assertIsInstance(clipped_line, tuple) + self.assertTupleEqual(clipped_line, expected_line) + def test_clipline__sequence_of_four_ints(self): """Ensures clipline handles a sequence of four ints. @@ -1293,6 +1191,22 @@ class RectTypeTest(unittest.TestCase): self.assertIsInstance(clipped_line, tuple) self.assertTupleEqual(clipped_line, expected_line) + def test_clipline__sequence_of_four_ints_kwargs(self): + """Ensures clipline handles a sequence of four ints using kwargs. + + Tests the clipline((x1, y1, x2, y2)) format. + Tests the sequence as different types. + """ + rect = Rect((1, 2), (35, 40)) + line = (5, 6, 11, 19) + expected_line = ((line[0], line[1]), (line[2], line[3])) + + for outer_seq in (list, tuple): + clipped_line = rect.clipline(rect_arg=outer_seq(line)) + + self.assertIsInstance(clipped_line, tuple) + self.assertTupleEqual(clipped_line, expected_line) + def test_clipline__sequence_of_two_sequences(self): """Ensures clipline handles a sequence of two sequences. @@ -1318,6 +1232,31 @@ class RectTypeTest(unittest.TestCase): self.assertIsInstance(clipped_line, tuple) self.assertTupleEqual(clipped_line, expected_line) + def test_clipline__sequence_of_two_sequences_kwargs(self): + """Ensures clipline handles a sequence of two sequences using kwargs. + + Tests the clipline(((x1, y1), (x2, y2))) format. + Tests the sequences as different types. + """ + rect = Rect((1, 2), (35, 40)) + pt1 = (5, 6) + pt2 = (11, 19) + + INNER_SEQUENCES = (list, tuple, Vector2) + expected_line = (pt1, pt2) + + for inner_seq1 in INNER_SEQUENCES: + endpt1 = inner_seq1(pt1) + + for inner_seq2 in INNER_SEQUENCES: + endpt2 = inner_seq2(pt2) + + for outer_seq in (list, tuple): + clipped_line = rect.clipline(x1=outer_seq((endpt1, endpt2))) + + self.assertIsInstance(clipped_line, tuple) + self.assertTupleEqual(clipped_line, expected_line) + def test_clipline__floats(self): """Ensures clipline handles float parameters.""" rect = Rect((1, 2), (35, 40)) @@ -1337,6 +1276,47 @@ class RectTypeTest(unittest.TestCase): self.assertIsInstance(clipped_line, tuple) self.assertTupleEqual(clipped_line, expected_line) + def test_clipline__floats_kwargs(self): + """Ensures clipline handles four float parameters. + + Tests the clipline(x1, y1, x2, y2) format. + """ + rect = Rect((1, 2), (35, 40)) + x1 = 5.9 + y1 = 6.9 + x2 = 11.9 + y2 = 19.9 + + # Floats are truncated. + expected_line = ( + (math.floor(x1), math.floor(y1)), + (math.floor(x2), math.floor(y2)), + ) + + clipped_line = rect.clipline(x1=x1, x2=y1, x3=x2, x4=y2) + + self.assertIsInstance(clipped_line, tuple) + self.assertTupleEqual(clipped_line, expected_line) + + def test_clipline__kwarg_exceptions(self): + """Ensure clipline handles incorrect keyword arguments""" + r = Rect(2, 4, 6, 8) + + with self.assertRaises(TypeError): + r.clipline(x1=0) + + with self.assertRaises(TypeError): + r.clipline(first_coordinate=(1, 3, 5, 4), second_coordinate=(1, 2)) + + with self.assertRaises(TypeError): + r.clipline(first_coordinate=(1, 3), second_coordinate=(2, 2), x1=1) + + with self.assertRaises(TypeError): + r.clipline(rect_arg=(1, 3, 5)) + + with self.assertRaises(TypeError): + r.clipline(rect_arg=(1, 3, 5, 4), second_coordinate=(2, 2)) + def test_clipline__no_overlap(self): """Ensures lines that do not overlap the rect are not clipped.""" rect = Rect((10, 25), (15, 20)) @@ -1437,7 +1417,7 @@ class RectTypeTest(unittest.TestCase): def test_clipline__endpoints_inside_and_outside(self): """Ensures lines that overlap the rect are clipped. - Testing lines with one endpoint outside the rect and the other + Testing lines with one endpoint outside the rect and the other is inside the rect. """ rect = Rect((0, 0), (21, 21)) @@ -1663,28 +1643,223 @@ class RectTypeTest(unittest.TestCase): expected_r2 = Rect(r.left + move_x, r.top + move_y, r.width, r.height) self.assertEqual(expected_r2, r2) - def test_move_to(self): - r = Rect(1, 2, 3, 4) - topleft = (10, 20) - center = (10, 20) + @unittest.skipIf( + IS_PYPY, "fails on pypy (but only for: bottom, right, centerx, centery)" + ) + def test_set_float_values(self): + zero = 0 + pos = 124 + neg = -432 + # (initial, increment, expected, other) + data_rows = [ + (zero, 0.1, zero, _random_int()), + (zero, 0.4, zero, _random_int()), + (zero, 0.5, zero + 1, _random_int()), + (zero, 1.1, zero + 1, _random_int()), + (zero, 1.5, zero + 2, _random_int()), # >0f + (zero, -0.1, zero, _random_int()), + (zero, -0.4, zero, _random_int()), + (zero, -0.5, zero - 1, _random_int()), + (zero, -0.6, zero - 1, _random_int()), + (zero, -1.6, zero - 2, _random_int()), # <0f + (zero, 1, zero + 1, _random_int()), + (zero, 4, zero + 4, _random_int()), # >0i + (zero, -1, zero - 1, _random_int()), + (zero, -4, zero - 4, _random_int()), # <0i + (pos, 0.1, pos, _random_int()), + (pos, 0.4, pos, _random_int()), + (pos, 0.5, pos + 1, _random_int()), + (pos, 1.1, pos + 1, _random_int()), + (pos, 1.5, pos + 2, _random_int()), # >0f + (pos, -0.1, pos, _random_int()), + (pos, -0.4, pos, _random_int()), + (pos, -0.5, pos, _random_int()), + (pos, -0.6, pos - 1, _random_int()), + (pos, -1.6, pos - 2, _random_int()), # <0f + (pos, 1, pos + 1, _random_int()), + (pos, 4, pos + 4, _random_int()), # >0i + (pos, -1, pos - 1, _random_int()), + (pos, -4, pos - 4, _random_int()), # <0i + (neg, 0.1, neg, _random_int()), + (neg, 0.4, neg, _random_int()), + (neg, 0.5, neg, _random_int()), + (neg, 1.1, neg + 1, _random_int()), + (neg, 1.5, neg + 1, _random_int()), # >0f + (neg, -0.1, neg, _random_int()), + (neg, -0.4, neg, _random_int()), + (neg, -0.5, neg - 1, _random_int()), + (neg, -0.6, neg - 1, _random_int()), + (neg, -1.6, neg - 2, _random_int()), # <0f + (neg, 1, neg + 1, _random_int()), + (neg, 4, neg + 4, _random_int()), # >0i + (neg, -1, neg - 1, _random_int()), + (neg, -4, neg - 4, _random_int()), # <0i + ] - r2 = r.move_to(topleft=topleft) - r3 = r.move_to(center=center) + single_value_attribute_names = [ + "x", + "y", + "w", + "h", + "width", + "height", + "top", + "left", + "bottom", + "right", + "centerx", + "centery", + ] - expected_r2 = Rect(r.x, r.y, r.width, r.height) - expected_r2.topleft = topleft + tuple_value_attribute_names = [ + "topleft", + "topright", + "bottomleft", + "bottomright", + "midtop", + "midleft", + "midbottom", + "midright", + "size", + "center", + ] - expected_r3 = Rect(r.x, r.y, r.width, r.height) - expected_r3.center = center + for row in data_rows: + initial, inc, expected, other = row + new_value = initial + inc + for attribute_name in single_value_attribute_names: + with self.subTest(row=row, name=f"r.{attribute_name}"): + actual = Rect( + _random_int(), _random_int(), _random_int(), _random_int() + ) + # act + setattr(actual, attribute_name, new_value) + # assert + self.assertEqual(expected, getattr(actual, attribute_name)) - self.assertEqual(expected_r2, r2) - self.assertEqual(expected_r3, r3) + for attribute_name in tuple_value_attribute_names: + with self.subTest(row=row, name=f"r.{attribute_name}[0]"): + actual = Rect( + _random_int(), _random_int(), _random_int(), _random_int() + ) + # act + setattr(actual, attribute_name, (new_value, other)) + # assert + self.assertEqual((expected, other), getattr(actual, attribute_name)) - self.assertIsInstance(r2, Rect) + with self.subTest(row=row, name=f"r.{attribute_name}[1]"): + actual = Rect( + _random_int(), _random_int(), _random_int(), _random_int() + ) + # act + setattr(actual, attribute_name, (other, new_value)) + # assert + self.assertEqual((other, expected), getattr(actual, attribute_name)) - self.assertRaises(TypeError, r.move_to, 1, 2, 3) - with self.assertRaises(TypeError): - r.move_to() + def test_set_out_of_range_number_raises_exception(self): + i = 0 + # (initial, expected) + data_rows = [ + (_int_max + 1, TypeError), + (_int_max + 0.00001, TypeError), + (_int_max, None), + (_int_max - 1, None), + (_int_max - 2, None), + (_int_max - 10, None), + (_int_max - 63, None), + (_int_max - 64, None), + (_int_max - 65, None), + (_int_min - 1, TypeError), + (_int_min - 0.00001, TypeError), + (_int_min, None), + (_int_min + 1, None), + (_int_min + 2, None), + (_int_min + 10, None), + (_int_min + 62, None), + (_int_min + 63, None), + (_int_min + 64, None), + (0, None), + (100000, None), + (-100000, None), + ] + + single_attribute_names = [ + "x", + "y", + "w", + "h", + "width", + "height", + "top", + "left", + "bottom", + "right", + "centerx", + "centery", + ] + + tuple_value_attribute_names = [ + "topleft", + "topright", + "bottomleft", + "bottomright", + "midtop", + "midleft", + "midbottom", + "midright", + "size", + "center", + ] + + for row in data_rows: + for attribute_name in single_attribute_names: + value, expected = row + with self.subTest(row=row, name=f"r.{attribute_name}"): + actual = Rect(0, 0, 0, 0) + if expected: + # act/ assert + self.assertRaises( + TypeError, setattr, actual, attribute_name, value + ) + else: + # act + setattr(actual, attribute_name, value) + # assert + self.assertEqual(value, getattr(actual, attribute_name)) + other = _random_int() + + for attribute_name in tuple_value_attribute_names: + value, expected = row + with self.subTest(row=row, name=f"r.{attribute_name}[0]"): + actual = Rect(0, 0, 0, 0) + # act/ assert + if expected: + # act/ assert + self.assertRaises( + TypeError, setattr, actual, attribute_name, (value, other) + ) + else: + # act + setattr(actual, attribute_name, (value, other)) + # assert + self.assertEqual( + (value, other), getattr(actual, attribute_name) + ) + with self.subTest(row=row, name=f"r.{attribute_name}[1]"): + actual = Rect(0, 0, 0, 0) + # act/ assert + if expected: + # act/ assert + self.assertRaises( + TypeError, setattr, actual, attribute_name, (other, value) + ) + else: + # act + setattr(actual, attribute_name, (other, value)) + # assert + self.assertEqual( + (other, value), getattr(actual, attribute_name) + ) def test_update_XYWidthHeight(self): """Test update with 4 int values(x, y, w, h)""" @@ -1761,6 +1936,14 @@ class RectTypeTest(unittest.TestCase): with self.assertRaises(TypeError): Rect(0, 0, 1, 1).unionall(invalid_rects) + def test_unionall__kwargs(self): + r1 = Rect(0, 0, 1, 1) + r2 = Rect(-2, -2, 1, 1) + r3 = Rect(2, 2, 1, 1) + + r4 = r1.unionall(rect=[r2, r3]) + self.assertEqual(Rect(-2, -2, 5, 5), r4) + def test_unionall_ip(self): r1 = Rect(0, 0, 1, 1) r2 = Rect(-2, -2, 1, 1) @@ -1772,6 +1955,17 @@ class RectTypeTest(unittest.TestCase): # Bug for an empty list. Would return a Rect instead of None. self.assertTrue(r1.unionall_ip([]) is None) + def test_unionall_ip__kwargs(self): + r1 = Rect(0, 0, 1, 1) + r2 = Rect(-2, -2, 1, 1) + r3 = Rect(2, 2, 1, 1) + + r1.unionall_ip(rects=[r2, r3]) + self.assertEqual(Rect(-2, -2, 5, 5), r1) + + # Bug for an empty list. Would return a Rect instead of None. + self.assertTrue(r1.unionall_ip([]) is None) + def test_colliderect(self): r1 = Rect(1, 2, 3, 4) self.assertTrue( @@ -2088,19 +2282,46 @@ class RectTypeTest(unittest.TestCase): with self.assertRaises(TypeError): collide_item = rect.collidedict(rect_values) - def test_collidedict__kwarg(self): - """Ensures the values keyword works with collidedict""" - rects = [Rect(i, i, i, i) for i in range(1, 5)] + def test_collidedict__invalid_use_values_format(self): + """Ensures collidedict correctly handles invalid use_values parameters.""" + rect = Rect(0, 0, 1, 1) + d = {} - rect_dict = {i: tuple(rect) for i, rect in enumerate(rects)} - rect_dict_inverted = {v: k for k, v in rect_dict.items()} + for invalid_param in (None, d, 1.1): + with self.assertRaises(TypeError): + collide_item = rect.collidedict(d, invalid_param) - try: - Rect(1, 2, 3, 4).collidedict(rect_dict, values=True) + def test_collidedict__kwargs(self): + """Ensures collidedict detects collisions via keyword arguments.""" + rect = Rect(1, 1, 10, 10) - Rect(1, 2, 3, 4).collidedict(rect_dict_inverted, values=False) - except TypeError as e: - self.fail(f"collidedict raised a TypeError with traceback:\n{e}") + collide_item1 = ("collide 1", rect.copy()) + collide_item2 = ("collide 2", Rect(5, 5, 10, 10)) + no_collide_item1 = ("no collide 1", Rect(60, 60, 10, 10)) + no_collide_item2 = ("no collide 2", Rect(70, 70, 10, 10)) + + # Dict to check collisions with values. + rect_values = dict( + (collide_item1, collide_item2, no_collide_item1, no_collide_item2) + ) + value_collide_items = (collide_item1, collide_item2) + + # Dict to check collisions with keys. + rect_keys = {tuple(v): k for k, v in rect_values.items()} + key_collide_items = tuple((tuple(v), k) for k, v in value_collide_items) + + for use_values in (True, False): + if use_values: + expected_items = value_collide_items + d = rect_values + else: + expected_items = key_collide_items + d = rect_keys + + collide_item = rect.collidedict(rect_dict=d, values=use_values) + + # The detected collision could be any of the possible items. + self.assertIn(collide_item, expected_items) def test_collidedictall(self): """Ensures collidedictall detects collisions.""" @@ -2358,19 +2579,47 @@ class RectTypeTest(unittest.TestCase): with self.assertRaises(TypeError): collide_items = rect.collidedictall(rect_values) - def test_collidedictall__kwarg(self): - """Ensures the values keyword works with collidedictall""" - rects = [Rect(i, i, i, i) for i in range(1, 5)] + def test_collidedictall__invalid_use_values_format(self): + """Ensures collidedictall correctly handles invalid use_values + parameters. + """ + rect = Rect(0, 0, 1, 1) + d = {} - rect_dict = {i: tuple(rect) for i, rect in enumerate(rects)} - rect_dict_inverted = {v: k for k, v in rect_dict.items()} + for invalid_param in (None, d, 1.1): + with self.assertRaises(TypeError): + collide_items = rect.collidedictall(d, invalid_param) - try: - Rect(1, 2, 3, 4).collidedictall(rect_dict, values=True) + def test_collidedictall__kwargs(self): + """Ensures collidedictall detects collisions via keyword arguments.""" + rect = Rect(1, 1, 10, 10) - Rect(1, 2, 3, 4).collidedictall(rect_dict_inverted, values=False) - except TypeError as e: - self.fail(f"collidedictall raised a TypeError with traceback:\n{e}") + collide_item1 = ("collide 1", rect.copy()) + collide_item2 = ("collide 2", Rect(5, 5, 10, 10)) + no_collide_item1 = ("no collide 1", Rect(60, 60, 20, 20)) + no_collide_item2 = ("no collide 2", Rect(70, 70, 20, 20)) + + # Dict to check collisions with values. + rect_values = dict( + (collide_item1, collide_item2, no_collide_item1, no_collide_item2) + ) + value_collide_items = [collide_item1, collide_item2] + + # Dict to check collisions with keys. + rect_keys = {tuple(v): k for k, v in rect_values.items()} + key_collide_items = [(tuple(v), k) for k, v in value_collide_items] + + for use_values in (True, False): + if use_values: + expected_items = value_collide_items + d = rect_values + else: + expected_items = key_collide_items + d = rect_keys + + collide_items = rect.collidedictall(rect_dict=d, values=use_values) + + self._assertCountEqual(collide_items, expected_items) def test_collidelist(self): # __doc__ (as of 2008-08-02) for pygame.rect.Rect.collidelist: @@ -2385,12 +2634,27 @@ class RectTypeTest(unittest.TestCase): r = Rect(1, 1, 10, 10) l = [Rect(50, 50, 1, 1), Rect(5, 5, 10, 10), Rect(15, 15, 1, 1)] - self.assertEqual(r.collidelist(l), 1) # list - self.assertEqual(r.collidelist(tuple(l)), 1) # tuple + self.assertEqual(r.collidelist(l), 1) f = [Rect(50, 50, 1, 1), (100, 100, 4, 4)] - self.assertEqual(r.collidelist(f), -1) # list - self.assertEqual(r.collidelist(tuple(f)), -1) # tuple + self.assertEqual(r.collidelist(f), -1) + + def test_collidelist__kwargs(self): + # Rect.collidelist(list): return index + # test if one rectangle in a list intersects + # + # Test whether the rectangle collides with any in a sequence of + # rectangles using keyword arguments. The index of the first collision + # found is returned. If no collisions are found an index + # of -1 is returned. + + r = Rect(1, 1, 10, 10) + l = [Rect(50, 50, 1, 1), Rect(5, 5, 10, 10), Rect(15, 15, 1, 1)] + + self.assertEqual(r.collidelist(l), 1) + + f = [Rect(50, 50, 1, 1), (100, 100, 4, 4)] + self.assertEqual(r.collidelist(rects=f), -1) def test_collidelistall(self): # __doc__ (as of 2008-08-02) for pygame.rect.Rect.collidelistall: @@ -2410,12 +2674,10 @@ class RectTypeTest(unittest.TestCase): Rect(15, 15, 1, 1), Rect(2, 2, 1, 1), ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [Rect(50, 50, 1, 1), Rect(20, 20, 5, 5)] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) def test_collidelistall_returns_empty_list(self): r = Rect(1, 1, 10, 10) @@ -2426,8 +2688,7 @@ class RectTypeTest(unittest.TestCase): Rect(15, 15, 1, 1), Rect(-20, 2, 1, 1), ] - self.assertEqual(r.collidelistall(l), []) # list - self.assertEqual(r.collidelistall(tuple(l)), []) # tuple + self.assertEqual(r.collidelistall(l), []) def test_collidelistall_list_of_tuples(self): r = Rect(1, 1, 10, 10) @@ -2438,12 +2699,10 @@ class RectTypeTest(unittest.TestCase): (15, 15, 1, 1), (2, 2, 1, 1), ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [(50, 50, 1, 1), (20, 20, 5, 5)] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) def test_collidelistall_list_of_two_tuples(self): r = Rect(1, 1, 10, 10) @@ -2454,12 +2713,10 @@ class RectTypeTest(unittest.TestCase): ((15, 15), (1, 1)), ((2, 2), (1, 1)), ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [((50, 50), (1, 1)), ((20, 20), (5, 5))] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) def test_collidelistall_list_of_lists(self): r = Rect(1, 1, 10, 10) @@ -2470,12 +2727,10 @@ class RectTypeTest(unittest.TestCase): [15, 15, 1, 1], [2, 2, 1, 1], ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [[50, 50, 1, 1], [20, 20, 5, 5]] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) class _ObjectWithRectAttribute: def __init__(self, r): @@ -2511,15 +2766,13 @@ class RectTypeTest(unittest.TestCase): self._ObjectWithRectAttribute(Rect(15, 15, 1, 1)), self._ObjectWithRectAttribute(Rect(2, 2, 1, 1)), ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [ self._ObjectWithRectAttribute(Rect(50, 50, 1, 1)), self._ObjectWithRectAttribute(Rect(20, 20, 5, 5)), ] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) def test_collidelistall_list_of_object_with_callable_rect_attribute(self): r = Rect(1, 1, 10, 10) @@ -2530,15 +2783,13 @@ class RectTypeTest(unittest.TestCase): self._ObjectWithCallableRectAttribute(Rect(15, 15, 1, 1)), self._ObjectWithCallableRectAttribute(Rect(2, 2, 1, 1)), ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [ self._ObjectWithCallableRectAttribute(Rect(50, 50, 1, 1)), self._ObjectWithCallableRectAttribute(Rect(20, 20, 5, 5)), ] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) def test_collidelistall_list_of_object_with_callable_rect_returning_object_with_rect_attribute( self, @@ -2559,15 +2810,13 @@ class RectTypeTest(unittest.TestCase): self._ObjectWithRectAttribute(Rect(2, 2, 1, 1)) ), ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [ self._ObjectWithCallableRectAttribute(Rect(50, 50, 1, 1)), self._ObjectWithCallableRectAttribute(Rect(20, 20, 5, 5)), ] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) def test_collidelistall_list_of_object_with_rect_property(self): r = Rect(1, 1, 10, 10) @@ -2578,15 +2827,34 @@ class RectTypeTest(unittest.TestCase): self._ObjectWithRectProperty(Rect(15, 15, 1, 1)), self._ObjectWithRectProperty(Rect(2, 2, 1, 1)), ] - self.assertEqual(r.collidelistall(l), [0, 1, 3]) # list - self.assertEqual(r.collidelistall(tuple(l)), [0, 1, 3]) # tuple + self.assertEqual(r.collidelistall(l), [0, 1, 3]) f = [ self._ObjectWithRectProperty(Rect(50, 50, 1, 1)), self._ObjectWithRectProperty(Rect(20, 20, 5, 5)), ] - self.assertFalse(r.collidelistall(f)) # list - self.assertFalse(r.collidelistall(tuple(f))) # tuple + self.assertFalse(r.collidelistall(f)) + + def test_collidelistall__kwargs(self): + # Rect.collidelistall(list): return indices + # test if all rectangles in a list intersect using keyword arguments. + # + # Returns a list of all the indices that contain rectangles that + # collide with the Rect. If no intersecting rectangles are found, an + # empty list is returned. + + r = Rect(1, 1, 10, 10) + + l = [ + Rect(1, 1, 10, 10), + Rect(5, 5, 10, 10), + Rect(15, 15, 1, 1), + Rect(2, 2, 1, 1), + ] + self.assertEqual(r.collidelistall(l), [0, 1, 3]) + + f = [Rect(50, 50, 1, 1), Rect(20, 20, 5, 5)] + self.assertFalse(r.collidelistall(rects=f)) def test_collideobjects_call_variants(self): # arrange @@ -2971,514 +3239,6 @@ class RectTypeTest(unittest.TestCase): self.assertTrue(isinstance(r, Collection)) self.assertFalse(isinstance(r, Sequence)) - def test_construction_no_args(self): - r = Rect() - self.assertEqual(r.x, 0) - self.assertEqual(r.y, 0) - self.assertEqual(r.w, 0) - self.assertEqual(r.h, 0) - - -class FRectTypeTest(RectTypeTest): - def setUp(self): - global Rect - Rect = FRect - - def test_convert_rect_frect(self): - r = IRect(1, 2, 3, 4) - fr = FRect(1.1, 2.2, 3.3, 4.4) - - self.assertEqual(IRect(fr), IRect(1, 2, 3, 4)) - self.assertEqual(FRect(r), FRect(1.0, 2.0, 3.0, 4.0)) - - def test_clipline__floats(self): - """This test is not for FRect""" - pass # Unused - - def testRepr(self): - rect = Rect(12.3456789, 34, 56, 78) - self.assertEqual( - repr(rect), "FRect(12.345679, 34.000000, 56.000000, 78.000000)" - ) - - # test that a large rect repr doesn't error - self.assertIsInstance(repr(Rect(-2e38, -2e38, -2e38, -2e38)), str) - - def test_clipline__equal_endpoints_no_overlap(self): - """Ensures clipline handles lines with both endpoints the same. - - Testing lines that do not overlap the rect. - """ - expected_line = () - rect = FRect((10, 25), (15, 20)) - - # Test points outside rect. - for pt in test_utils.rect_perimeter_pts(IRect((0, 0), (35, 70))): - clipped_line = rect.clipline((pt, pt)) - - self.assertTupleEqual(clipped_line, expected_line) - - def test_clipline__equal_endpoints_with_overlap(self): - """Ensures clipline handles lines with both endpoints the same. - - Testing lines that overlap the rect. - """ - rect = FRect((10, 25), (15, 20)) - - # Test all the points in and on a rect. - pts = ( - (x, y) - for x in range(int(rect.left), int(rect.right)) - for y in range(int(rect.top), int(rect.bottom)) - ) - - for pt in pts: - expected_line = (pt, pt) - - clipped_line = rect.clipline((pt, pt)) - - self.assertTupleEqual(clipped_line, expected_line) - - def test_clipline__endpoints_inside_and_outside(self): - """Ensures lines that overlap the rect are clipped. - - Testing lines with one endpoint outside the rect and the other - inside the rect. - """ - rect = Rect((0, 0), (21, 21)) - # Use a bigger rect to help create test lines. - big_rect = rect.inflate(2, 2) - - # Create a dict of lines and expected results. - line_dict = { - (big_rect.midleft, rect.center): (rect.midleft, rect.center), - (big_rect.midtop, rect.center): (rect.midtop, rect.center), - (big_rect.midright, rect.center): ( - (rect.midright[0] - 1, rect.midright[1]), - rect.center, - ), - (big_rect.midbottom, rect.center): ( - (rect.midbottom[0], rect.midbottom[1] - 1), - rect.center, - ), - } - for line, expected_line in line_dict.items(): - clipped_line = rect.clipline(line) - - self.assertTupleEqual(clipped_line, expected_line) - - # Swap endpoints to test for symmetry. - expected_line = (expected_line[1], expected_line[0]) - - clipped_line = rect.clipline((line[1], line[0])) - - self.assertTupleEqual(clipped_line, expected_line) - - def test_contains(self): - r = FRect(1, 2, 3, 4) - - self.assertTrue( - r.contains(FRect(2, 3, 1, 1)), "r does not contain Rect(2, 3, 1, 1)" - ) - self.assertTrue(FRect(2, 3, 1, 1) in r, "r does not contain Rect(2, 3, 1, 1) 2") - self.assertTrue( - r.contains(FRect(r)), "r does not contain the same rect as itself" - ) - self.assertTrue(r in FRect(r), "r does not contain the same rect as itself") - self.assertTrue( - r.contains(FRect(2, 3, 0, 0)), - "r does not contain an empty rect within its bounds", - ) - self.assertTrue( - FRect(2, 3, 0, 0) in r, - "r does not contain an empty rect within its bounds", - ) - self.assertFalse(r.contains(FRect(0, 0, 1, 2)), "r contains Rect(0, 0, 1, 2)") - self.assertFalse(r.contains(FRect(4, 6, 1, 1)), "r contains Rect(4, 6, 1, 1)") - self.assertFalse(r.contains(FRect(4, 6, 0, 0)), "r contains Rect(4, 6, 0, 0)") - self.assertFalse(FRect(0, 0, 1, 2) in r, "r contains Rect(0, 0, 1, 2)") - self.assertFalse(FRect(4, 6, 1, 1) in r, "r contains Rect(4, 6, 1, 1)") - self.assertFalse(FRect(4, 6, 0, 0) in r, "r contains Rect(4, 6, 0, 0)") - - # TO BE IMPLEMENTED - - # self.assertTrue(2 in FRect(0, 0, 1, 2), "r does not contain 2") - # self.assertFalse(3 in FRect(0, 0, 1, 2), "r contains 3") - - self.assertRaises(TypeError, lambda: 1 in FRect(0, 0, 1, 2)) - self.assertRaises(TypeError, lambda: "string" in FRect(0, 0, 1, 2)) - self.assertRaises(TypeError, lambda: 4 + 3j in FRect(0, 0, 1, 2)) - - def testCalculatedAttributes(self): - r = FRect(1.0, 2.0, 3.0, 4.0) - - self.assertEqual(r.left + r.width, r.right) - self.assertEqual(r.top + r.height, r.bottom) - self.assertEqual((r.width, r.height), r.size) - self.assertEqual((r.left, r.top), r.topleft) - self.assertEqual((r.right, r.top), r.topright) - self.assertEqual((r.left, r.bottom), r.bottomleft) - self.assertEqual((r.right, r.bottom), r.bottomright) - - midx = r.left + r.width / 2 - midy = r.top + r.height / 2 - expected_new_relcenter = r.w / 2, r.h / 2 - - self.assertEqual(expected_new_relcenter, r.relcenter) - self.assertEqual(midx, r.centerx) - self.assertEqual(midy, r.centery) - self.assertEqual((r.centerx, r.centery), r.center) - self.assertEqual((r.centerx, r.top), r.midtop) - self.assertEqual((r.centerx, r.bottom), r.midbottom) - self.assertEqual((r.left, r.centery), r.midleft) - self.assertEqual((r.right, r.centery), r.midright) - - def assertAlmostEqual5(self, first, second): - """ - TinyUtility for 'almost almost' equal without having to specify - places argument a bunch of times. - """ - self.assertAlmostEqual(first, second, places=5) - - def assertSeqAlmostEqual5(self, first, second): - """ - Same as above but for sequences - """ - self.assertEqual(len(first), len(second)) - for i, j in zip(first, second): - self.assertAlmostEqual5(i, j) - - def test_scale_by__larger_single_argument(self): - """The scale method scales around the center of the rectangle""" - r = FRect(2.1, 4, 6, 8.9) - r2 = r.scale_by(2.3) - expected_new_relcenter = r.w * 1.15, r.h * 1.15 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - # ((w * scaling) - w) / 2 -> 3.9 - self.assertAlmostEqual5(r.left - 3.9, r2.left) - self.assertAlmostEqual5(r.top - 5.785, r2.top) - self.assertAlmostEqual5(r.right + 3.9, r2.right) - self.assertAlmostEqual5(r.bottom + 5.785, r2.bottom) - self.assertAlmostEqual5(r.width * 2.3, r2.width) - self.assertAlmostEqual5(r.height * 2.3, r2.height) - - def test_scale_by__larger_single_argument_kwarg(self): - """The scale method scales around the center of the rectangle using - keyword arguments 'x' and 'y'""" - r = FRect(2.1, 4, 6, 8.9) - r2 = r.scale_by(x=2.3) - expected_new_relcenter = r.w * 1.15, r.h * 1.15 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - # ((w * scaling) - w) / 2 -> 3.9 - self.assertAlmostEqual5(r.left - 3.9, r2.left) - self.assertAlmostEqual5(r.top - 5.785, r2.top) - self.assertAlmostEqual5(r.right + 3.9, r2.right) - self.assertAlmostEqual5(r.bottom + 5.785, r2.bottom) - self.assertAlmostEqual5(r.width * 2.3, r2.width) - self.assertAlmostEqual5(r.height * 2.3, r2.height) - - def test_scale_by__smaller_single_argument(self): - """The scale method scales around the center of the rectangle""" - r = FRect(2.1, 4, 6, 8.9) - r2 = r.scale_by(0.5) - expected_new_relcenter = r.w * 0.25, r.h * 0.25 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - self.assertAlmostEqual5(r.left + 1.5, r2.left) - self.assertAlmostEqual5(r.top + 2.225, r2.top) - self.assertAlmostEqual5(r.right - 1.5, r2.right) - self.assertAlmostEqual5(r.bottom - 2.225, r2.bottom) - self.assertAlmostEqual5(r.width - 3, r2.width) - self.assertAlmostEqual5(r.height - 4.45, r2.height) - - def test_scale_by__larger(self): - """The scale method scales around the center of the rectangle""" - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - r2 = r.scale_by(2, 4) - # assert - expected_new_relcenter = r.w, r.h * 2 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - self.assertAlmostEqual5(r.left - 3, r2.left) - self.assertAlmostEqual5(r.centery - r.h * 4 / 2, r2.top) - self.assertAlmostEqual5(r.right + 3, r2.right) - self.assertAlmostEqual5(r.centery + r.h * 4 / 2, r2.bottom) - self.assertAlmostEqual5(r.width * 2, r2.width) - self.assertAlmostEqual5(r.height * 4, r2.height) - - def test_scale_by__larger_kwargs_scale_by(self): - """ - The scale method scales around the center of the rectangle - Uses 'scale_by' kwarg. - """ - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - r2 = r.scale_by(scale_by=(2, 4)) - r3 = r.scale_by((2, 4)) - self.assertEqual(r2, r3) - # assert - expected_new_relcenter = r.w, r.h * 2 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - self.assertAlmostEqual5(r.left - 3, r2.left) - self.assertAlmostEqual5(r.centery - r.h * 4 / 2, r2.top) - self.assertAlmostEqual5(r.right + 3, r2.right) - self.assertAlmostEqual5(r.centery + r.h * 4 / 2, r2.bottom) - self.assertAlmostEqual5(r.width * 2, r2.width) - self.assertAlmostEqual5(r.height * 4, r2.height) - - def test_scale_by__larger_kwargs(self): - """ - The scale method scales around the center of the rectangle - Uses 'x' and 'y' kwargs. - """ - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - r2 = r.scale_by(x=2, y=4) - # assert - expected_new_relcenter = r.w, r.h * 2 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - self.assertAlmostEqual5(r.left - 3, r2.left) - self.assertAlmostEqual5(r.centery - r.h * 4 / 2, r2.top) - self.assertAlmostEqual5(r.right + 3, r2.right) - self.assertAlmostEqual5(r.centery + r.h * 4 / 2, r2.bottom) - self.assertAlmostEqual5(r.width * 2, r2.width) - self.assertAlmostEqual5(r.height * 4, r2.height) - - def test_scale_by__smaller(self): - """The scale method scales around the center of the rectangle""" - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - r2 = r.scale_by(0.5, 0.25) - # assert - expected_new_relcenter = r.w * 0.25, r.h * 0.125 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - self.assertAlmostEqual5(r.left + 1.5, r2.left) - self.assertAlmostEqual5(r.centery - r.h / 4 / 2, r2.top) - self.assertAlmostEqual5(r.right - 1.5, r2.right) - self.assertAlmostEqual5(r.centery + r.h / 4 / 2, r2.bottom) - self.assertAlmostEqual5(r.width - 3, r2.width) - self.assertAlmostEqual5(r.height / 4, r2.height) - - def test_scale_by__subzero(self): - """The scale method scales around the center of the rectangle""" - r = FRect(2.1, 4, 6, 8.9) - r.scale_by(0) - r.scale_by(-1) - r.scale_by(-0.000001) - r.scale_by(0.00001) - - rx1 = r.scale_by(10, 1) - expected_new_relcenter = r.w * 5, r.h * 0.5 - - self.assertSeqAlmostEqual5(expected_new_relcenter, rx1.relcenter) - self.assertAlmostEqual5(r.centerx - r.w * 10 / 2, rx1.x) - self.assertAlmostEqual5(r.y, rx1.y) - self.assertAlmostEqual5(r.w * 10, rx1.w) - self.assertAlmostEqual5(r.h, rx1.h) - - rx2 = r.scale_by(-10, 1) - expected_new_relcenter = r.w * 5, r.h * 0.5 - - self.assertSeqAlmostEqual5(expected_new_relcenter, rx2.relcenter) - self.assertAlmostEqual5(rx1.x, rx2.x) - self.assertAlmostEqual5(rx1.y, rx2.y) - self.assertAlmostEqual5(rx1.w, rx2.w) - self.assertAlmostEqual5(rx1.h, rx2.h) - - ry1 = r.scale_by(1, 10) - expected_new_relcenter = r.w * 0.5, r.h * 5 - - self.assertSeqAlmostEqual5(expected_new_relcenter, ry1.relcenter) - self.assertAlmostEqual5(r.x, ry1.x) - self.assertAlmostEqual5(r.centery - r.h * 10 / 2, ry1.y) - self.assertAlmostEqual5(r.w, ry1.w) - self.assertAlmostEqual5(r.h * 10, ry1.h) - - ry2 = r.scale_by(1, -10) - expected_new_relcenter = r.w * 0.5, r.h * 5 - - self.assertSeqAlmostEqual5(expected_new_relcenter, ry2.relcenter) - self.assertAlmostEqual5(ry1.x, ry2.x) - self.assertAlmostEqual5(ry1.y, ry2.y) - self.assertAlmostEqual5(ry1.w, ry2.w) - self.assertAlmostEqual5(ry1.h, ry2.h) - - r1 = r.scale_by(10) - expected_new_relcenter = r.w * 5, r.h * 5 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r1.relcenter) - self.assertAlmostEqual5(r.centerx - r.w * 10 / 2, r1.x) - self.assertAlmostEqual5(r.centery - r.h * 10 / 2, r1.y) - self.assertAlmostEqual5(r.w * 10, r1.w) - self.assertAlmostEqual5(r.h * 10, r1.h) - - def test_scale_by_identity(self): - """The scale method scales around the center of the rectangle""" - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - actual = r.scale_by(1, 1) - # assert - self.assertEqual(r.x, actual.x) - self.assertEqual(r.y, actual.y) - self.assertEqual(r.w, actual.w) - self.assertEqual(r.h, actual.h) - - def test_scale_by_negative_identity(self): - """The scale method scales around the center of the rectangle""" - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - actual = r.scale_by(-1, -1) - # assert - self.assertEqual(r.x, actual.x) - self.assertEqual(r.y, actual.y) - self.assertEqual(r.w, actual.w) - self.assertEqual(r.h, actual.h) - - def test_scale_by_identity_single_argument(self): - """The scale method scales around the center of the rectangle""" - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - actual = r.scale_by(1) - # assert - self.assertEqual(r.x, actual.x) - self.assertEqual(r.y, actual.y) - self.assertEqual(r.w, actual.w) - self.assertEqual(r.h, actual.h) - - def test_scale_by_negative_identity_single_argument(self): - """The scale method scales around the center of the rectangle""" - # arrange - r = FRect(2.1, 4, 6, 8.9) - # act - actual = r.scale_by(-1) - # assert - self.assertEqual(r.x, actual.x) - self.assertEqual(r.y, actual.y) - self.assertEqual(r.w, actual.w) - self.assertEqual(r.h, actual.h) - - def test_scale_by_ip__larger(self): - """The scale method scales around the center of the rectangle""" - r = FRect(2.1, 4, 6, 8.9) - r2 = FRect(r) - r2.scale_by_ip(2.3) - expected_new_relcenter = r.w * 1.15, r.h * 1.15 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - # ((w * scaling) - w) / 2 -> 3.9 - self.assertAlmostEqual5(r.left - 3.9, r2.left) - self.assertAlmostEqual5(r.top - 5.785, r2.top) - self.assertAlmostEqual5(r.right + 3.9, r2.right) - self.assertAlmostEqual5(r.bottom + 5.785, r2.bottom) - self.assertAlmostEqual5(r.width * 2.3, r2.width) - self.assertAlmostEqual5(r.height * 2.3, r2.height) - - def test_scale_by_ip__smaller(self): - """The scale method scales around the center of the rectangle""" - r = FRect(2.1, 4, 6, 8.9) - r2 = FRect(r) - r2.scale_by_ip(0.5) - expected_new_relcenter = r.w * 0.25, r.h * 0.25 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertSeqAlmostEqual5(r.center, r2.center) - self.assertAlmostEqual5(r.left + 1.5, r2.left) - self.assertAlmostEqual5(r.top + 2.225, r2.top) - self.assertAlmostEqual5(r.right - 1.5, r2.right) - self.assertAlmostEqual5(r.bottom - 2.225, r2.bottom) - self.assertAlmostEqual5(r.width - 3, r2.width) - self.assertAlmostEqual5(r.height - 4.45, r2.height) - - def test_scale_by_ip__subzero(self): - """The scale method scales around the center of the rectangle""" - r = FRect(2.1, 4, 6, 8.9) - r.scale_by_ip(0) - r.scale_by_ip(-1) - r.scale_by_ip(-0.000001) - r.scale_by_ip(0.00001) - - def test_scale_by_ip__kwargs(self): - """The scale method scales around the center of the rectangle""" - r = FRect(2.1, 4, 6, 8.9) - r2 = FRect(r) - r2.scale_by_ip(x=2, y=4) - - # assert - expected_new_relcenter = r.w, r.h * 2.0 - - self.assertSeqAlmostEqual5(expected_new_relcenter, r2.relcenter) - self.assertEqual(r.center, r2.center) - self.assertAlmostEqual5(r.left - 3, r2.left) - self.assertAlmostEqual5(r.centery - r.h * 4 / 2, r2.top) - self.assertAlmostEqual5(r.right + 3, r2.right) - self.assertAlmostEqual5(r.centery + r.h * 4 / 2, r2.bottom) - self.assertAlmostEqual5(r.width * 2, r2.width) - self.assertAlmostEqual5(r.height * 4, r2.height) - - def test_scale_by_ip__kwarg_exceptions(self): - """The scale method scales around the center of the rectangle using - keyword argument 'scale_by'. Tests for incorrect keyword args""" - r = FRect(2.1, 4, 6, 8.9) - - with self.assertRaises(TypeError): - r.scale_by_ip(scale_by=2) - - with self.assertRaises(TypeError): - r.scale_by_ip(scale_by=(1, 2), y=1) - - def test_frect_subscript(self): - r = FRect(1.2, 2.4, 3.6, 4.8) - self.assertAlmostEqual5(r[0], 1.2) - self.assertAlmostEqual5(r[1], 2.4) - self.assertAlmostEqual5(r[2], 3.6) - self.assertAlmostEqual5(r[3], 4.8) - self.assertEqual(r[-1], r[3]) - self.assertEqual(r[-2], r[2]) - self.assertEqual(r[-3], r[1]) - self.assertEqual(r[-4], r[0]) - self.assertRaises(IndexError, r.__getitem__, 5) - self.assertRaises(IndexError, r.__getitem__, -5) - self.assertSeqAlmostEqual5(r[0:2], [1.2, 2.4]) - self.assertSeqAlmostEqual5(r[0:4], [1.2, 2.4, 3.6, 4.8]) - self.assertSeqAlmostEqual5(r[0:-1], [1.2, 2.4, 3.6]) - self.assertSeqAlmostEqual5(r[:], [1.2, 2.4, 3.6, 4.8]) - self.assertSeqAlmostEqual5(r[...], [1.2, 2.4, 3.6, 4.8]) - self.assertEqual(r[0:4], r) - self.assertEqual(r[:], r) - self.assertEqual(r[...], r) - self.assertSeqAlmostEqual5(r[0:4:2], [1.2, 3.6]) - self.assertSeqAlmostEqual5(r[0:4:3], [1.2, 4.8]) - self.assertSeqAlmostEqual5(r[3::-1], [4.8, 3.6, 2.4, 1.2]) - self.assertRaises(TypeError, r.__getitem__, None) - - def test_construction_no_args(self): - r = FRect() - self.assertEqual(r.x, 0.0) - self.assertEqual(r.y, 0.0) - self.assertEqual(r.w, 0.0) - self.assertEqual(r.h, 0.0) - class SubclassTest(unittest.TestCase): class MyRect(Rect): @@ -3500,13 +3260,6 @@ class SubclassTest(unittest.TestCase): self.assertTrue(isinstance(mr2, self.MyRect)) self.assertRaises(AttributeError, getattr, mr2, "an_attribute") - def test_move_to(self): - mr1 = self.MyRect(1, 2, 10, 20) - self.assertTrue(mr1.an_attribute) - mr2 = mr1.move_to(topleft=(10, 10)) - self.assertTrue(isinstance(mr2, self.MyRect)) - self.assertRaises(AttributeError, getattr, mr2, "an_attribute") - def test_inflate(self): mr1 = self.MyRect(1, 2, 10, 20) self.assertTrue(mr1.an_attribute) @@ -3554,13 +3307,6 @@ class SubclassTest(unittest.TestCase): self.assertTrue(isinstance(mr1, Collection)) self.assertFalse(isinstance(mr1, Sequence)) - def test_construction_no_args(self): - mr = self.MyRect() - self.assertEqual(mr.x, 0) - self.assertEqual(mr.y, 0) - self.assertEqual(mr.w, 0) - self.assertEqual(mr.h, 0) - if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/render_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/render_test.py deleted file mode 100644 index cfa2772..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/render_test.py +++ /dev/null @@ -1,490 +0,0 @@ -import gc -import unittest -import weakref - -import pygame -import pygame._render as _render - - -class DrawableObject: - def __init__(self): - self.drawn = False - self.area = None - self.dest = None - - def draw(self, area, dest): - self.drawn = True - self.area = area - self.dest = dest - - -class RendererTest(unittest.TestCase): - def setUp(self): - self.window = pygame.Window(size=(100, 100)) - self.renderer = _render.Renderer(self.window) - - init_draw_color = self.renderer.draw_color - self.renderer.draw_color = "BLACK" - self.renderer.clear() - self.renderer.draw_color = init_draw_color - - def test_to_surface(self): - self.renderer.draw_color = "YELLOW" - self.renderer.draw_point((10, 10)) # assumes Renderer.draw_point works - surf1 = self.renderer.to_surface() - self.assertEqual(surf1.get_at((10, 10)), pygame.Color(255, 255, 0, 255)) - self.assertEqual(surf1.size, (100, 100)) - - surf2 = pygame.Surface((150, 150)) - self.renderer.to_surface(surf2) - self.assertEqual(surf2.get_at((10, 10)), pygame.Color(255, 255, 0, 255)) - - surf3 = self.renderer.to_surface(area=pygame.Rect(5, 5, 20, 20)) - self.assertEqual(surf3.get_at((5, 5)), pygame.Color(255, 255, 0, 255)) - self.assertEqual(surf3.size, (20, 20)) - - surf4 = pygame.Surface((150, 150)) - self.renderer.to_surface(surf4, pygame.Rect(7, 7, 40, 40)) - self.assertEqual(surf4.get_at((3, 3)), pygame.Color(255, 255, 0, 255)) - - small_surf = pygame.Surface((50, 50)) - with self.assertRaises(ValueError): - self.renderer.to_surface(small_surf) - - def test_blit(self): - surface = pygame.Surface((10, 10)) - surface.fill((80, 120, 160, 200)) - texture = _render.Texture.from_surface(self.renderer, surface) - image = _render.Image(texture) - drawable_object = DrawableObject() - dest = pygame.Rect(10, 10, 20, 20) - area = pygame.Rect(0, 0, 15, 15) - - self.renderer.blit(texture, dest, area) - result = self.renderer.to_surface() - self.assertEqual(pygame.Color(0, 0, 0, 255), result.get_at((9, 20))) - for x in range(10, 30): - self.assertEqual(pygame.Color(80, 120, 160, 255), result.get_at((x, 20))) - self.assertEqual(pygame.Color(0, 0, 0, 255), result.get_at((30, 20))) - self.renderer.clear() - - self.renderer.blit(image, dest, area) # TODO Assert after Image implementation - - self.renderer.blit(drawable_object, dest, area) - self.assertEqual(drawable_object.drawn, True) - self.assertEqual(drawable_object.area, area) - self.assertEqual(drawable_object.dest, dest) - - def test_clear(self): - self.renderer.draw_color = "YELLOW" - self.renderer.clear() - surf = self.renderer.to_surface() - for x in range(surf.width): - for y in range(surf.height): - self.assertEqual(surf.get_at((x, y)), pygame.Color(255, 255, 0, 255)) - - def test_draw_point(self): - self.renderer.draw_color = "YELLOW" - self.renderer.draw_point((10, 10)) - surf = self.renderer.to_surface() - for x in range(-1, 2): - for y in range(-1, 2): - if x or y: - self.assertEqual( - surf.get_at((10 + x, 10 + y)), pygame.Color(0, 0, 0, 255) - ) - else: - self.assertEqual( - surf.get_at((10, 10)), pygame.Color(255, 255, 0, 255) - ) - - def test_draw_line(self): - self.renderer.draw_color = "YELLOW" - self.renderer.draw_line((10, 10), (40, 40)) - surf = self.renderer.to_surface() - test_points = ((10, 10), (20, 20), (30, 30), (40, 40)) - for point in test_points: - self.assertEqual(surf.get_at(point), pygame.Color(255, 255, 0, 255)) - - def test_draw_triangle(self): - self.renderer.draw_color = "YELLOW" - self.renderer.draw_triangle((10, 10), (10, 40), (40, 10)) - surf = self.renderer.to_surface() - test_points = ( - (10, 10), - (20, 10), - (30, 10), - (40, 10), - (10, 20), - (30, 20), - (10, 30), - (20, 30), - (10, 40), - ) - for point in test_points: - self.assertEqual(surf.get_at(point), pygame.Color(255, 255, 0, 255)) - - def test_draw_rect(self): - self.renderer.draw_color = "YELLOW" - self.renderer.draw_rect(pygame.Rect(10, 10, 11, 11)) - surf = self.renderer.to_surface() - test_points = ((10, 15), (15, 10), (20, 15), (15, 20)) - for point in test_points: - self.assertEqual(surf.get_at(point), pygame.Color(255, 255, 0, 255)) - - def test_draw_quad(self): - self.renderer.draw_color = "YELLOW" - self.renderer.draw_quad((10, 40), (40, 10), (70, 40), (40, 70)) - surf = self.renderer.to_surface() - test_points = ((30, 20), (50, 20), (30, 60), (50, 60)) - for point in test_points: - self.assertEqual(surf.get_at(point), pygame.Color(255, 255, 0, 255)) - - def test_fill_triangle(self): - self.renderer.draw_color = "YELLOW" - self.renderer.fill_triangle((10, 10), (10, 40), (40, 10)) - surf = self.renderer.to_surface() - for x in range(10, 29): - self.assertEqual(surf.get_at((x, 20)), pygame.Color(255, 255, 0, 255)) - for x in range(10, 19): - self.assertEqual(surf.get_at((x, 30)), pygame.Color(255, 255, 0, 255)) - - def test_fill_rect(self): - self.renderer.draw_color = "YELLOW" - self.renderer.fill_rect(pygame.Rect(10, 10, 11, 11)) - surf = self.renderer.to_surface() - for x in range(10, 21): - for y in range(10, 21): - self.assertEqual(surf.get_at((x, y)), pygame.Color(255, 255, 0, 255)) - - def test_fill_quad(self): - self.renderer.draw_color = "GREEN" - self.renderer.draw_quad((10, 40), (40, 10), (70, 40), (40, 70)) - self.renderer.draw_color = "YELLOW" - self.renderer.fill_quad((10, 40), (40, 10), (70, 40), (40, 70)) - surf = self.renderer.to_surface() - for x in range(30, 50): - self.assertEqual(surf.get_at((x, 20)), pygame.Color(255, 255, 0, 255)) - self.assertEqual(surf.get_at((x, 59)), pygame.Color(255, 255, 0, 255)) - - def test_viewport(self): - self.assertEqual(self.renderer.get_viewport(), pygame.Rect(0, 0, 100, 100)) - self.renderer.set_viewport(pygame.Rect(20, 20, 60, 60)) - self.assertEqual(self.renderer.get_viewport(), pygame.Rect(20, 20, 60, 60)) - self.renderer.set_viewport(None) - self.assertEqual(self.renderer.get_viewport(), pygame.Rect(0, 0, 100, 100)) - - def test_logical_size(self): - self.assertEqual(self.renderer.logical_size, (0, 0)) - self.renderer.logical_size = (10, 10) - self.assertEqual(self.renderer.logical_size, (10, 10)) - - def test_logical_window_mapping(self): - self.renderer.logical_size = (10, 10) - self.assertEqual(self.renderer.coordinates_to_window((10, 10)), (100, 100)) - self.assertEqual(self.renderer.coordinates_from_window((100, 100)), (10, 10)) - with self.assertRaises(TypeError): - self.renderer.coordinates_to_window(42, 42) - with self.assertRaises(TypeError): - self.renderer.coordinates_from_window(42, 42) - - def test_scale(self): - self.assertEqual(self.renderer.scale, (1.0, 1.0)) - self.renderer.scale = (0.5, 2) - self.assertEqual(self.renderer.scale, (0.5, 2.0)) - - def test_target(self): - self.assertEqual(self.renderer.target, None) - texture = _render.Texture(self.renderer, (10, 10), target=True) - self.renderer.target = texture - self.assertEqual(id(self.renderer.target), id(texture)) - self.renderer.target = None - self.assertEqual(self.renderer.target, None) - - @unittest.skip("Unable to create that blend_mode on all devices") - def test_compose_custom_blend_mode(self): - color_mode, alpha_mode = ( - ( - pygame.BLENDFACTOR_SRC_COLOR, - pygame.BLENDFACTOR_ONE_MINUS_DST_COLOR, - pygame.BLENDOPERATION_MAXIMUM, - ), - ( - pygame.BLENDFACTOR_ONE_MINUS_SRC_ALPHA, - pygame.BLENDFACTOR_DST_ALPHA, - pygame.BLENDOPERATION_MINIMUM, - ), - ) - custom_blend_mode = self.renderer.compose_custom_blend_mode( - color_mode, alpha_mode - ) - self.assertEqual(custom_blend_mode, 157550645) - self.renderer.draw_blend_mode = custom_blend_mode - self.assertEqual(self.renderer.draw_blend_mode, custom_blend_mode) - - def test_draw_blend_mode(self): - self.assertEqual(self.renderer.draw_blend_mode, pygame.BLENDMODE_NONE) - self.renderer.draw_blend_mode = pygame.BLENDMODE_MUL - self.assertEqual(self.renderer.draw_blend_mode, pygame.BLENDMODE_MUL) - unsupported_blend_mode = pygame.BLENDMODE_MUL + 1 - with self.assertRaises(Exception): - self.renderer.draw_blend_mode = unsupported_blend_mode - - def test_draw_color(self): - self.assertEqual(self.renderer.draw_color, pygame.Color(0, 0, 0, 0)) - self.renderer.draw_color = "YELLOW" - self.assertEqual(self.renderer.draw_color, pygame.Color(255, 255, 0, 255)) - - -class TextureTest(unittest.TestCase): - def setUp(self): - self.window = pygame.Window(size=(100, 100)) - self.renderer = _render.Renderer(self.window) - self.renderer.clear() - self.texture = _render.Texture(self.renderer, (80, 60)) - - def create_texture_from_surface(self): - surface = pygame.Surface((100, 100)) - surface.fill(pygame.Color(80, 120, 160, 128)) - return _render.Texture.from_surface(self.renderer, surface) - - def test_init(self): - _render.Texture(self.renderer, (100, 100)) - _render.Texture(self.renderer, (100, 100), depth=32) - with self.assertRaises(ValueError): - _render.Texture(self.renderer, (100, 100), depth=33) - _render.Texture(self.renderer, (100, 100), depth=32, static=True) - _render.Texture(self.renderer, (100, 100), depth=32, streaming=True) - _render.Texture(self.renderer, (100, 100), depth=32, target=True) - with self.assertRaises(ValueError): - _render.Texture( - self.renderer, (100, 100), depth=32, static=True, target=True - ) - with self.assertRaises(ValueError): - _render.Texture( - self.renderer, (100, 100), depth=32, target=True, streaming=True - ) - with self.assertRaises(ValueError): - _render.Texture( - self.renderer, (100, 100), depth=32, static=True, streaming=True - ) - - def test_alpha(self): - self.assertEqual(255, self.texture.alpha) - self.texture.alpha = 128 - self.assertEqual(128, self.texture.alpha) - - def test_blend_mode(self): - self.assertEqual(pygame.BLENDMODE_NONE, self.texture.blend_mode) - self.texture.blend_mode = pygame.BLENDMODE_BLEND - self.assertEqual(pygame.BLENDMODE_BLEND, self.texture.blend_mode) - - def test_color(self): - self.assertEqual(pygame.Color(255, 255, 255, 255), self.texture.color) - self.texture.color = pygame.Color(100, 110, 120, 130) - self.assertEqual(pygame.Color(100, 110, 120, 255), self.texture.color) - - def test_width(self): - self.assertEqual(80, self.texture.width) - with self.assertRaises(AttributeError): - self.texture.width = 100 - - def test_height(self): - self.assertEqual(60, self.texture.height) - with self.assertRaises(AttributeError): - self.texture.height = 100 - - def test_renderer(self): - self.assertEqual(self.renderer, self.texture.renderer) - window2 = pygame.Window(size=(128, 128)) - renderer2 = _render.Renderer(window2) - with self.assertRaises(AttributeError): - self.texture.renderer = renderer2 - - def test_get_rect(self): - self.assertEqual(pygame.Rect(0, 0, 80, 60), self.texture.get_rect()) - self.assertEqual( - pygame.Rect(10, 20, 80, 60), self.texture.get_rect(center=(50, 50)) - ) - - def test_from_surface(self): - surf_size = (50, 40) - surface = pygame.Surface(surf_size) - texture2 = _render.Texture.from_surface(self.renderer, surface) - self.assertEqual(surf_size, (texture2.width, texture2.height)) - - def test_draw_triangle(self): - texture2 = self.create_texture_from_surface() - texture2.draw_triangle( - (50, 10), - (10, 90), - (90, 90), - (0.5, 0.5), - (0.8, 0.2), - (1, 1), - (100, 100, 100, 100), - (80, 60, 40, 20), - (150, 170, 190, 210), - ) - result = self.renderer.to_surface() - expected = [ - (0, 0, 0), - (0, 0, 0), - (0, 0, 0), - (0, 0, 0), - (0, 0, 0), - (28, 38, 45), - (29, 39, 46), - (29, 39, 47), - (29, 40, 48), - (29, 41, 49), - (30, 41, 50), - (30, 42, 52), - (30, 43, 53), - (31, 43, 54), - (31, 44, 55), - (31, 44, 56), - (31, 45, 57), - (32, 46, 59), - (32, 46, 60), - (32, 47, 61), - (32, 48, 62), - (33, 48, 63), - (33, 49, 65), - (33, 50, 66), - (34, 50, 67), - (34, 51, 68), - (34, 52, 69), - (34, 52, 70), - (35, 53, 72), - (35, 54, 73), - (35, 54, 74), - (35, 55, 75), - (36, 55, 76), - (36, 56, 78), - (36, 57, 79), - (37, 57, 80), - (37, 58, 81), - (37, 59, 82), - (37, 59, 83), - (38, 60, 85), - (38, 61, 86), - (38, 61, 87), - (39, 62, 88), - (39, 63, 89), - (39, 63, 90), - (0, 0, 0), - (0, 0, 0), - (0, 0, 0), - (0, 0, 0), - (0, 0, 0), - ] - start = 25 - for x in range(start, start + len(expected)): - value = result.get_at((x, 50)) - for color_index in range(3): - expected_value = expected[x - start][color_index] - self.assertTrue( - expected_value - 1 <= value[color_index] <= expected_value + 1 - ) - - def test_draw_quad(self): - texture2 = self.create_texture_from_surface() - texture2.draw_quad( - (10, 10), - (90, 10), - (90, 90), - (10, 90), - (0.5, 0.5), - (0.8, 0.2), - (0.2, 0.8), - (0.9, 0.9), - (100, 100, 100, 100), - (80, 60, 40, 20), - (150, 170, 190, 210), - (128, 128, 128, 128), - ) - result = self.renderer.to_surface() - expected = [ - (37, 58, 79), - (37, 58, 80), - (37, 58, 80), - (37, 58, 81), - (37, 59, 81), - (38, 59, 82), - (38, 59, 82), - (38, 59, 83), - (38, 60, 83), - (38, 60, 84), - (38, 60, 84), - (38, 60, 84), - (38, 61, 85), - (38, 61, 85), - (38, 61, 86), - (38, 61, 86), - (39, 62, 87), - (39, 62, 87), - (39, 62, 88), - (39, 62, 88), - (39, 62, 89), - (39, 63, 89), - (39, 63, 90), - (39, 63, 90), - (39, 63, 91), - (39, 64, 91), - (39, 63, 91), - (39, 63, 90), - (39, 63, 90), - (39, 63, 89), - (39, 63, 89), - (39, 62, 88), - (39, 62, 88), - (39, 62, 88), - (39, 62, 87), - (38, 61, 87), - (38, 61, 86), - (38, 61, 86), - (38, 61, 85), - (38, 60, 85), - (38, 60, 84), - (38, 60, 84), - (38, 60, 83), - (38, 59, 83), - (38, 59, 82), - (38, 59, 82), - (38, 59, 81), - (38, 59, 81), - (37, 58, 80), - (37, 58, 80), - ] - start = 25 - for x in range(start, start + len(expected)): - value = result.get_at((x, 50)) - for color_index in range(3): - expected_value = expected[x - start][color_index] - self.assertTrue( - expected_value - 1 <= value[color_index] <= expected_value + 1 - ) - - def test_draw(self): - texture2 = self.create_texture_from_surface() - texture2.draw(pygame.Rect(10, 20, 40, 40), pygame.Rect(50, 30, 35, 20), 45) - result = self.renderer.to_surface() - for x in range(64, 82): - self.assertEqual(pygame.Color(80, 120, 160, 255), result.get_at((x, 50))) - - def test_garbage_collection(self): - reference = weakref.ref(self.texture) - self.assertTrue(reference() is self.texture) - del self.texture - gc.collect() - self.assertIsNone(reference()) - - def test_update(self): - surface = pygame.Surface((100, 100)) - surface.fill(pygame.Color(80, 120, 160, 128)) - self.texture.update(surface, pygame.Rect(10, 10, 80, 80)) - self.texture.draw() - result = self.renderer.to_surface() - for x in range(25, 75): - self.assertEqual(pygame.Color(80, 120, 160, 255), result.get_at((x, 50))) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/rwobject_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/rwobject_test.py index fc7c887..31723ae 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/rwobject_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/rwobject_test.py @@ -1,14 +1,12 @@ import pathlib -import platform -import sys import unittest -from pygame import encode_file_path, encode_string - -IS_PYPY = "PyPy" == platform.python_implementation() +from pygame import encode_string, encode_file_path class RWopsEncodeStringTest(unittest.TestCase): + global getrefcount + def test_obj_None(self): encoded_string = encode_string(None) @@ -21,13 +19,13 @@ class RWopsEncodeStringTest(unittest.TestCase): self.assertIsInstance(encoded_string, bytes) def test_obj_bytes(self): - b = b"encyclop\xe6dia" + b = b"encyclop\xE6dia" encoded_string = encode_string(b, "ascii", "strict") self.assertIs(encoded_string, b) def test_encode_unicode(self): - u = "\u00dee Olde Komp\u00fcter Shoppe" + u = "\u00DEe Olde Komp\u00FCter Shoppe" b = u.encode("utf-8") self.assertEqual(encode_string(u, "utf-8"), b) @@ -35,7 +33,7 @@ class RWopsEncodeStringTest(unittest.TestCase): self.assertRaises(SyntaxError, encode_string) def test_errors(self): - u = "abc\u0109defg\u011dh\u0125ij\u0135klmnoprs\u015dtu\u016dvz" + u = "abc\u0109defg\u011Dh\u0125ij\u0135klmnoprs\u015Dtu\u016Dvz" b = u.encode("ascii", "ignore") self.assertEqual(encode_string(u, "ascii", "ignore"), b) @@ -46,7 +44,7 @@ class RWopsEncodeStringTest(unittest.TestCase): self.assertIsNone(encoded_string) def test_check_defaults(self): - u = "a\u01f7b" + u = "a\u01F7b" b = u.encode("unicode_escape", "backslashreplace") encoded_string = encode_string(u) @@ -70,19 +68,26 @@ class RWopsEncodeStringTest(unittest.TestCase): self.assertIs(encoded_string, b) self.assertEqual(encoded_decode_string, b) - @unittest.skipIf(IS_PYPY, "getrefcount not available on pypy") - def test_refcount(self): - bpath = b" This is a string that is not cached."[1:] - upath = bpath.decode("ascii") - before = sys.getrefcount(bpath) - bpath = encode_string(bpath) - self.assertEqual(sys.getrefcount(bpath), 2) - bpath = encode_string(upath) - self.assertIn(sys.getrefcount(bpath), (before, before - 1)) + try: + from sys import getrefcount as _g + + getrefcount = _g # This nonsense is for Python 3.x + except ImportError: + pass + else: + + def test_refcount(self): + bpath = b" This is a string that is not cached."[1:] + upath = bpath.decode("ascii") + before = getrefcount(bpath) + bpath = encode_string(bpath) + self.assertEqual(getrefcount(bpath), before) + bpath = encode_string(upath) + self.assertEqual(getrefcount(bpath), before) def test_smp(self): - utf_8 = b"a\xf0\x93\x82\xa7b" - u = "a\U000130a7b" + utf_8 = b"a\xF0\x93\x82\xA7b" + u = "a\U000130A7b" b = encode_string(u, "utf-8", "strict", AssertionError) self.assertEqual(b, utf_8) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/scrap_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/scrap_test.py index 92f7dbf..6b7f6fa 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/scrap_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/scrap_test.py @@ -1,14 +1,13 @@ import os -import platform import sys + +if os.environ.get("SDL_VIDEODRIVER") == "dummy": + __tags__ = ("ignore", "subprocess_ignore") import unittest +from pygame.tests.test_utils import trunk_relative_path import pygame from pygame import scrap -from pygame.tests.test_utils import trunk_relative_path - -if os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER: - __tags__ = ("ignore", "subprocess_ignore") class ScrapModuleTest(unittest.TestCase): @@ -52,10 +51,6 @@ class ScrapModuleTest(unittest.TestCase): """Ensures get works as expected.""" self.fail() - @unittest.skipIf( - platform.system() != "Windows", - "scrap features are broken on non windows platforms", - ) def test_get__owned_empty_type(self): """Ensures get works when there is no data of the requested type in the clipboard and the clipboard is owned by the pygame application. @@ -100,22 +95,15 @@ class ScrapModuleTest(unittest.TestCase): self.assertEqual(scrap.get(pygame.SCRAP_TEXT), b"Another String") - @unittest.skipIf( - platform.system() != "Windows", - "scrap features are broken on non windows platforms", - ) + @unittest.skipIf("pygame.image" not in sys.modules, "requires pygame.image module") def test_put__bmp_image(self): """Ensures put can place a BMP image into the clipboard.""" sf = pygame.image.load(trunk_relative_path("examples/data/asprite.bmp")) - expected_bytes = pygame.image.tobytes(sf, "RGBA") - scrap.put(pygame.SCRAP_BMP, expected_bytes) + expected_string = pygame.image.tostring(sf, "RGBA") + scrap.put(pygame.SCRAP_BMP, expected_string) - self.assertEqual(scrap.get(pygame.SCRAP_BMP), expected_bytes) + self.assertEqual(scrap.get(pygame.SCRAP_BMP), expected_string) - @unittest.skipIf( - platform.system() != "Windows", - "scrap features are broken on non windows platforms", - ) def test_put(self): """Ensures put can place data into the clipboard when using a user defined type identifier. @@ -127,19 +115,6 @@ class ScrapModuleTest(unittest.TestCase): self.assertEqual(r, b"buf") - def test_new_put(self): - """Ensures that text can be placed into the clipboard""" - text = "Welcome to scrap!" - scrap.put_text(text) - self.assertTrue(scrap.has_text()) - self.assertEqual(scrap.get_text(), text) - - def test_has_text_when_empty(self): - """Ensures that has_text returns False when clipboard is empty""" - scrap.put_text("") - self.assertFalse(scrap.has_text()) - self.assertEqual(scrap.get_text(), "") - class ScrapModuleClipboardNotOwnedTest(unittest.TestCase): """Test the scrap module's functionality when the pygame application is @@ -217,5 +192,110 @@ class ScrapModuleClipboardNotOwnedTest(unittest.TestCase): self.assertTrue(lost) +class X11InteractiveTest(unittest.TestCase): + __tags__ = ["ignore", "subprocess_ignore"] + try: + pygame.display.init() + except Exception: + pass + else: + if pygame.display.get_driver() == "x11": + __tags__ = ["interactive"] + pygame.display.quit() + + def test_issue_208(self): + """PATCH: pygame.scrap on X11, fix copying into PRIMARY selection + + Copying into theX11 PRIMARY selection (mouse copy/paste) would not + work due to a confusion between content type and clipboard type. + + """ + + from pygame import display, event, freetype + from pygame.locals import SCRAP_SELECTION, SCRAP_TEXT + from pygame.locals import KEYDOWN, K_y, QUIT + + success = False + freetype.init() + font = freetype.Font(None, 24) + display.init() + display.set_caption("Interactive X11 Paste Test") + screen = display.set_mode((600, 200)) + screen.fill(pygame.Color("white")) + text = "Scrap put() succeeded." + msg = ( + "Some text has been placed into the X11 clipboard." + " Please click the center mouse button in an open" + " text window to retrieve it." + '\n\nDid you get "{}"? (y/n)' + ).format(text) + word_wrap(screen, msg, font, 6) + display.flip() + event.pump() + scrap.init() + scrap.set_mode(SCRAP_SELECTION) + scrap.put(SCRAP_TEXT, text.encode("UTF-8")) + while True: + e = event.wait() + if e.type == QUIT: + break + if e.type == KEYDOWN: + success = e.key == K_y + break + pygame.display.quit() + self.assertTrue(success) + + +def word_wrap(surf, text, font, margin=0, color=(0, 0, 0)): + font.origin = True + surf_width, surf_height = surf.get_size() + width = surf_width - 2 * margin + height = surf_height - 2 * margin + line_spacing = int(1.25 * font.get_sized_height()) + x, y = margin, margin + line_spacing + space = font.get_rect(" ") + for word in iwords(text): + if word == "\n": + x, y = margin, y + line_spacing + else: + bounds = font.get_rect(word) + if x + bounds.width + bounds.x >= width: + x, y = margin, y + line_spacing + if x + bounds.width + bounds.x >= width: + raise ValueError("word too wide for the surface") + if y + bounds.height - bounds.y >= height: + raise ValueError("text to long for the surface") + font.render_to(surf, (x, y), None, color) + x += bounds.width + space.width + return x, y + + +def iwords(text): + # r"\n|[^ ]+" + # + head = 0 + tail = head + end = len(text) + while head < end: + if text[head] == " ": + head += 1 + tail = head + 1 + elif text[head] == "\n": + head += 1 + yield "\n" + tail = head + 1 + elif tail == end: + yield text[head:] + head = end + elif text[tail] == "\n": + yield text[head:tail] + head = tail + elif text[tail] == " ": + yield text[head:tail] + head = tail + else: + tail += 1 + + if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_tags.py b/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_tags.py index 5e24b93..68fa7a5 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_tags.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_tags.py @@ -3,6 +3,7 @@ __tags__ = ["array"] exclude = False try: + import pygame.mixer import numpy except ImportError: exclude = True diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_test.py index 639224f..57eb71c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/sndarray_test.py @@ -1,8 +1,9 @@ import unittest +from numpy import int8, int16, uint8, uint16, float32, array, all as alltrue + import pygame import pygame.sndarray -from numpy import all as np_all, array, float32, int8, int16, uint8, uint16 class SndarrayTest(unittest.TestCase): @@ -27,7 +28,7 @@ class SndarrayTest(unittest.TestCase): arr = pygame.sndarray.array(snd) self._assert_compatible(arr, size) self.assertTrue( - np_all(arr == srcarr), + alltrue(arr == srcarr), "size: %i\n%s\n%s" % (size, arr, test_data), ) finally: @@ -40,7 +41,7 @@ class SndarrayTest(unittest.TestCase): 16, 2, [[0, 0xFFFF], [0xFFFF, 0], [0x00FF, 0xFF00], [0x0F0F, 0xF0F0]] ) check_array(-8, 1, [0, -0x80, 0x7F, 0x64]) - check_array(-8, 2, [[0, -0x80], [-0x64, 0x64], [0x25, -0x50], [0x7F, 0]]) + check_array(-8, 2, [[0, -0x80], [-0x64, 0x64], [0x25, -0x50], [-1, 0]]) check_array(-16, 1, [0, 0x7FFF, -0x7FFF, -1]) check_array(-16, 2, [[0, -0x7FFF], [-0x7FFF, 0], [0x7FFF, 0], [0, 0x7FFF]]) @@ -70,20 +71,20 @@ class SndarrayTest(unittest.TestCase): snd = pygame.sndarray.make_sound(srcarr) arr = pygame.sndarray.samples(snd) self.assertTrue( - np_all(arr == srcarr), + alltrue(arr == srcarr), "size: %i\n%s\n%s" % (size, arr, test_data), ) finally: pygame.mixer.quit() check_sound(8, 1, [0, 0x0F, 0xF0, 0xFF]) - check_sound(8, 2, [[0, 0x80], [0x2D, 0x41], [0x64, 0xA1], [0xFF, 0x40]]) + check_sound(8, 2, [[0, 0x80], [0x2D, 0x41], [0x64, 0xA1], [125, 0x40]]) check_sound(16, 1, [0, 0x00FF, 0xFF00, 0xFFFF]) check_sound( 16, 2, [[0, 0xFFFF], [0xFFFF, 0], [0x00FF, 0xFF00], [0x0F0F, 0xF0F0]] ) check_sound(-8, 1, [0, -0x80, 0x7F, 0x64]) - check_sound(-8, 2, [[0, -0x80], [-0x64, 0x64], [0x25, -0x50], [0x7F, 0]]) + check_sound(-8, 2, [[0, -0x80], [-0x64, 0x64], [0x25, -0x50], [-1, 0]]) check_sound(-16, 1, [0, 0x7FFF, -0x7FFF, -1]) check_sound(-16, 2, [[0, -0x7FFF], [-0x7FFF, 0], [0x7FFF, 0], [0, 0x7FFF]]) check_sound(32, 2, [[0.0, -1.0], [-1.0, 0], [1.0, 0], [0, 1.0]]) @@ -109,7 +110,7 @@ class SndarrayTest(unittest.TestCase): samples[...] = test_data arr = pygame.sndarray.array(snd) self.assertTrue( - np_all(samples == arr), + alltrue(samples == arr), "size: %i\n%s\n%s" % (size, arr, test_data), ) finally: @@ -122,7 +123,7 @@ class SndarrayTest(unittest.TestCase): 16, 2, [[0, 0xFFFF], [0xFFFF, 0], [0x00FF, 0xFF00], [0x0F0F, 0xF0F0]] ) check_sample(-8, 1, [0, -0x80, 0x7F, 0x64]) - check_sample(-8, 2, [[0, -0x80], [-0x64, 0x64], [0x25, -0x50], [0x7F, 0]]) + check_sample(-8, 2, [[0, -0x80], [-0x64, 0x64], [0x25, -0x50], [-1, 0]]) check_sample(-16, 1, [0, 0x7FFF, -0x7FFF, -1]) check_sample(-16, 2, [[0, -0x7FFF], [-0x7FFF, 0], [0x7FFF, 0], [0, 0x7FFF]]) check_sample(32, 2, [[0.0, -1.0], [-1.0, 0], [1.0, 0], [0, 1.0]]) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/sprite_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/sprite_test.py index fd06cd4..531263c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/sprite_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/sprite_test.py @@ -1,25 +1,17 @@ #################################### IMPORTS ################################### -import types -import typing import unittest import pygame from pygame import sprite + ################################# MODULE LEVEL ################################# class SpriteModuleTest(unittest.TestCase): - def test_deprecation__sprite_submodule(self): - # Test that using the old cython sprite module raises - # a deprecation warning. - with self.assertWarns(DeprecationWarning): - import pygame._sprite - - pygame.init() - test_group = pygame.sprite.Group() + pass ######################### SPRITECOLLIDE FUNCTIONS TEST ######################### @@ -527,7 +519,7 @@ class AbstractGroupTypeTest(unittest.TestCase): self.bg = pygame.Surface((20, 20)) self.scr = pygame.Surface((20, 20)) - self.scr.fill(pygame.Color("gray")) + self.scr.fill(pygame.Color("grey")) def test_has(self): "See if AbstractGroup.has() works as expected." @@ -661,16 +653,6 @@ class AbstractGroupTypeTest(unittest.TestCase): self.assertEqual(test_sprite.sink, [1, 2, 3]) self.assertEqual(test_sprite.sink_kwargs, {"foo": 4, "bar": 5}) - def test_type_subscript(self): - try: - group_generic_alias = sprite.Group[sprite.Sprite] - except TypeError as e: - self.fail(e) - - self.assertIsInstance(group_generic_alias, types.GenericAlias) - self.assertIs(typing.get_origin(group_generic_alias), sprite.Group) - self.assertEqual(typing.get_args(group_generic_alias), (sprite.Sprite,)) - ################################################################################ @@ -1129,7 +1111,7 @@ class LayeredDirtyTypeTest__DirtySprite(LayeredGroupBase, unittest.TestCase): # use_source_rect - allows non-dirty sprites to be tested # with (True) and without (False) a source_rect # - # This test was written to reproduce the behavior seen in pygame-ce issue # 605. + # This test was written to reproduce the behavior seen in issue #898. # A non-dirty sprite (using source_rect) was being redrawn incorrectly # after a dirty sprite intersected with it. # @@ -1225,7 +1207,7 @@ class LayeredDirtyTypeTest__DirtySprite(LayeredGroupBase, unittest.TestCase): """Ensure non-dirty sprites using source_rects are correctly redrawn when dirty sprites intersect with them. - Related to pygame-ce issue #605. + Related to issue #898. """ self._nondirty_intersections_redrawn(True) @@ -1261,6 +1243,7 @@ class SpriteBase: self.assertFalse(g in self.sprite.groups()) def test_update(self): + # What does this and the next test actually test? class test_sprite(pygame.sprite.Sprite): sink = [] @@ -1351,6 +1334,7 @@ class SpriteTypeTest(SpriteBase, unittest.TestCase): sprite.Group, sprite.LayeredUpdates, sprite.RenderUpdates, + sprite.OrderedUpdates, ] @@ -1361,20 +1345,42 @@ class DirtySpriteTypeTest(SpriteBase, unittest.TestCase): sprite.Group, sprite.LayeredUpdates, sprite.RenderUpdates, + sprite.OrderedUpdates, sprite.LayeredDirty, ] +class WeakSpriteTypeTest(SpriteTypeTest): + Sprite = sprite.WeakSprite + + def test_weak_group_ref(self): + """ + We create a list of groups, add them to the sprite. + When we then delete the groups, the sprite should be "dead" + """ + import gc + + groups = [Group() for Group in self.Groups] + self.sprite.add(groups) + del groups + gc.collect() + self.assertFalse(self.sprite.alive()) + + +class DirtyWeakSpriteTypeTest(DirtySpriteTypeTest, WeakSpriteTypeTest): + Sprite = sprite.WeakDirtySprite + + ############################## BUG TESTS ####################################### class SingleGroupBugsTest(unittest.TestCase): def test_memoryleak_bug(self): - # For memory leak bug posted to mailing list by Tobias Steinrücken on 16/11/10. + # For memoryleak bug posted to mailing list by Tobias Steinrücken on 16/11/10. # Fixed in revision 2953. - import gc import weakref + import gc class MySprite(sprite.Sprite): def __init__(self, *args, **kwargs): diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/surface_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/surface_test.py index 10136b9..b1147d2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/surface_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/surface_test.py @@ -1,25 +1,23 @@ import os import unittest - from pygame.tests import test_utils from pygame.tests.test_utils import ( - SurfaceSubclass, example_path, + SurfaceSubclass, ) try: from pygame.tests.test_utils.arrinter import * except (ImportError, NameError): pass -import ctypes -import gc -import itertools -import platform -import weakref - import pygame -from pygame.bufferproxy import BufferProxy from pygame.locals import * +from pygame.bufferproxy import BufferProxy + +import platform +import gc +import weakref +import ctypes IS_PYPY = "PyPy" == platform.python_implementation() @@ -46,7 +44,7 @@ class SurfaceTypeTest(unittest.TestCase): surf = pygame.Surface((20, 20)) self.assertEqual(surf.get_at((0, 0)), (0, 0, 0, 255)) - # See https://github.com/pygame-community/pygame-ce/issues/796 + # See https://github.com/pygame/pygame/issues/1395 pygame.display.set_mode((500, 500)) surf = pygame.Surface((20, 20)) self.assertEqual(surf.get_at((0, 0)), (0, 0, 0, 255)) @@ -65,31 +63,7 @@ class SurfaceTypeTest(unittest.TestCase): def test_print(self): surf = pygame.Surface((70, 70), 0, 32) - self.assertEqual(repr(surf), "") - - surf_global = pygame.Surface((70, 70), pygame.SRCALPHA, 32) - self.assertEqual(repr(surf_global), "") - - surf_colorkey = pygame.Surface((70, 70), 0, 32) - surf_colorkey.set_colorkey("purple") - self.assertEqual( - repr(surf_colorkey), "" - ) - - surf_colorkey_global = pygame.Surface((70, 70), 32) - surf_colorkey_global.set_colorkey("orange") - surf_colorkey_global.set_alpha(200) - self.assertEqual( - repr(surf_colorkey_global), - "", - ) - - surf_16_global = pygame.Surface((70, 70), 0, 16) - surf_16_global.set_alpha(200) - self.assertEqual(repr(surf_16_global), "") - - surf_8 = pygame.Surface((70, 70), 0, 8) - self.assertEqual(repr(surf_8), "") + self.assertEqual(repr(surf), "") def test_keyword_arguments(self): surf = pygame.Surface((70, 70), flags=SRCALPHA, depth=32) @@ -115,11 +89,6 @@ class SurfaceTypeTest(unittest.TestCase): self.assertIsInstance(r, pygame.Color) self.assertEqual(r, (10, 10, 10, 255)) - s.set_at(pygame.Vector2(0, 0), (10, 10, 10, 255)) - r = s.get_at(pygame.Vector2(0, 0)) - self.assertIsInstance(r, pygame.Color) - self.assertEqual(r, (10, 10, 10, 255)) - # try setting a color with a single integer. s.fill((0, 0, 0, 255)) s.set_at((10, 1), 0x0000FF) @@ -234,7 +203,7 @@ class SurfaceTypeTest(unittest.TestCase): self.assertEqual(bound_rect.width, 31) self.assertEqual(bound_rect.height, 31) - # pygame-ce issue #195 + # Issue #180 pygame.display.init() try: surf = pygame.Surface((4, 1), 0, 8) @@ -257,22 +226,6 @@ class SurfaceTypeTest(unittest.TestCase): self.assertEqual(s1rect.size, s2rect.size) self.assertEqual(s2.get_at((10, 10)), color) - def test_deepcopy(self): - """Ensure a surface can be copied.""" - color = (25, 25, 25, 25) - s1 = pygame.Surface((32, 32), pygame.SRCALPHA, 32) - s1.fill(color) - - import copy - - s2 = copy.deepcopy(s1) - - s1rect = s1.get_rect() - s2rect = s2.get_rect() - - self.assertEqual(s1rect.size, s2rect.size) - self.assertEqual(s2.get_at((10, 10)), color) - def test_fill(self): """Ensure a surface can be filled.""" color = (25, 25, 25, 25) @@ -300,21 +253,7 @@ class SurfaceTypeTest(unittest.TestCase): self.assertEqual( blit_surf.mustlock(), (blit_surf.get_flags() & pygame.RLEACCEL) != 0 ) - if pygame.version.SDL < (2, 32, 50): - # This bit fails on SDL2-compat and SDL3 - # https://github.com/libsdl-org/sdl2-compat/issues/575 - self.assertTrue(blit_surf.get_flags() & pygame.RLEACCEL) - - def test_fill_raise_exceptions(self): - surf = pygame.Surface((5, 5)) - invalid_rect_style_obj = 0 - self.assertRaises(ValueError, surf.fill, "black", rect=invalid_rect_style_obj) - self.assertRaises( - pygame.error, surf.fill, "black", special_flags=pygame.BLEND_PREMULTIPLIED - ) - self.assertRaises( - pygame.error, surf.fill, "black", special_flags=pygame.BLEND_ALPHA_SDL2 - ) + self.assertTrue(blit_surf.get_flags() & pygame.RLEACCEL) def test_mustlock_rle(self): """Test RLEACCEL flag with mustlock()""" @@ -379,11 +318,6 @@ class SurfaceTypeTest(unittest.TestCase): self.assertTrue(s1.get_flags() & pygame.RLEACCELOK) self.assertTrue(not s2.get_flags() & pygame.RLEACCELOK) - @unittest.skipIf( - (2, 32, 50) <= pygame.version.SDL <= (2, 32, 56) - or (3, 0, 0) <= pygame.version.SDL <= (3, 2, 22), - "This test was briefly broken on SDL3 (and sdl2-compat) but got fixed.", - ) def test_solarwolf_rle_usage(self): """Test for error/crash when calling set_colorkey() followed by convert twice in succession. Code originally taken @@ -412,11 +346,6 @@ class SurfaceTypeTest(unittest.TestCase): finally: pygame.display.quit() - @unittest.skipIf( - (2, 32, 50) <= pygame.version.SDL <= (2, 32, 56) - or (3, 0, 0) <= pygame.version.SDL <= (3, 2, 22), - "This test was briefly broken on SDL3 (and sdl2-compat) but got fixed.", - ) def test_solarwolf_rle_usage_2(self): """Test for RLE status after setting alpha""" @@ -489,7 +418,7 @@ class SurfaceTypeTest(unittest.TestCase): c = s1.get_at((0, 0)) self.assertEqual(c, color) - # make subsurface in the middle to test it doesn't overwrite. + # make subsurface in the middle to test it doesn't over write. s2 = s1.subsurface((5, 5, 5, 5)) r2 = s2.fill(color2, (-3, -3, 5, 5)) c2 = s1.get_at((4, 4)) @@ -497,7 +426,7 @@ class SurfaceTypeTest(unittest.TestCase): # rect returns the area we actually fill. r3 = s2.fill(color2, (-30, -30, 5, 5)) - # since we are using negative coords, it should be a zero sized rect. + # since we are using negative coords, it should be an zero sized rect. self.assertEqual(tuple(r3), (0, 0, 0, 0)) def test_fill_keyword_args(self): @@ -568,8 +497,8 @@ class SurfaceTypeTest(unittest.TestCase): self.assertEqual(s1.get_flags(), pygame.SRCALPHA) @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires a non-null SDL_VIDEODRIVER", + os.environ.get("SDL_VIDEODRIVER") == "dummy", + 'requires a non-"dummy" SDL_VIDEODRIVER', ) def test_get_flags__display_surf(self): pygame.display.init() @@ -597,7 +526,7 @@ class SurfaceTypeTest(unittest.TestCase): # OPENGL screen_surf = pygame.display.set_mode((600, 400), flags=0) - # it can have an OPENGL flag by default on macOS? + # it can have an OPENGL flag by default on Macos? if not (screen_surf.get_flags() & pygame.OPENGL): self.assertFalse(screen_surf.get_flags() & pygame.OPENGL) @@ -635,47 +564,8 @@ class SurfaceTypeTest(unittest.TestCase): size = (16, 16) surf = pygame.Surface(size) rect = surf.get_rect() - rect_kwargs = surf.get_rect(topleft=(1.0, 1.0), center=(100, 100)) - self.assertEqual(rect.topleft, (0.0, 0.0)) self.assertEqual(rect.size, size) - self.assertIsInstance(rect, pygame.Rect) - self.assertEqual(rect_kwargs.center, (100, 100)) - self.assertNotEqual(rect_kwargs.topleft, (1.0, 1.0)) - self.assertRaises(TypeError, surf.get_rect, 5) - self.assertRaises(TypeError, surf.get_rect, 5.0) - self.assertRaises(TypeError, surf.get_rect, "potato") - self.assertRaises(TypeError, surf.get_rect, center=5) - self.assertRaises(TypeError, surf.get_rect, center=(5,)) - self.assertRaises(TypeError, surf.get_rect, center="5") - if ( - not IS_PYPY - ): # PyPy doesn't raise an AttributeError, so for PyPy we can just skip it. - with self.assertRaises(AttributeError): - surf.get_rect(centre=(100, 100)) - - ######################################################################## - - def test_get_frect(self): - """Ensure a surface's frect can be retrieved.""" - size = (16.0, 16.0) - surf = pygame.Surface(size) - frect = surf.get_frect() - frect_kwargs = surf.get_frect(topleft=(1.0, 1.0), center=(100, 100)) - - self.assertEqual(frect.topleft, (0.0, 0.0)) - self.assertEqual(frect.size, size) - self.assertIsInstance(frect, pygame.FRect) - self.assertEqual(frect_kwargs.center, (100, 100)) - self.assertNotEqual(frect_kwargs.topleft, (1.0, 1.0)) - self.assertRaises(TypeError, surf.get_frect, 5) - self.assertRaises(TypeError, surf.get_frect, center=5) - self.assertRaises(TypeError, surf.get_frect, center="5") - if ( - not IS_PYPY - ): # PyPy doesn't raise an AttributeError, so for PyPy we can just skip it. - with self.assertRaises(AttributeError): - surf.get_frect(centre=(100, 100)) ######################################################################## @@ -688,18 +578,6 @@ class SurfaceTypeTest(unittest.TestCase): self.assertEqual(s.get_height(), h) self.assertEqual(s.get_size(), (w, h)) - def test_attributes(self): - """Test width, height, and size attributes of surface""" - s = pygame.Surface((100, 50)) - self.assertEqual(s.width, 100) - self.assertEqual(s.height, 50) - self.assertEqual(s.size, (100, 50)) - - attrs = ["width", "height", "size"] - for attr in attrs: - with self.assertRaises(AttributeError): - setattr(s, attr, 200) - def test_get_view(self): """Ensure a buffer view of the surface's pixels can be retrieved.""" # Check that BufferProxys are returned when array depth is supported, @@ -982,11 +860,11 @@ class TestSurfaceBlit(unittest.TestCase): # draw one image onto another # # Draws a source Surface onto this Surface. The draw can be positioned - # with the dest argument. Dest can be a pair of coordinates + # with the dest argument. Dest can either be pair of coordinates # representing the upper left corner of the source. A Rect can also be # passed as the destination and the topleft corner of the rectangle # will be used as the position for the blit. The size of the - # destination rectangle does not affect the blit. + # destination rectangle does not effect the blit. # # An optional area rectangle can be passed as well. This represents a # smaller portion of the source Surface to draw. @@ -1012,8 +890,8 @@ class TestSurfaceBlit(unittest.TestCase): self.dst_surface = pygame.Surface((64, 64), 32) self.dst_surface.fill(pygame.Color(0, 0, 0)) - def test_blit_overflow_point(self): - """Full coverage w/ overflow, specified with Point""" + def test_blit_overflow_coord(self): + """Full coverage w/ overflow, specified with Coordinate""" result = self.dst_surface.blit(self.src_surface, (0, 0)) self.assertIsInstance(result, pygame.Rect) self.assertEqual(result.size, (64, 64)) @@ -1182,108 +1060,58 @@ class TestSurfaceBlit(unittest.TestCase): source.set_at((0, 0), test_color) target.blit(source, (0, 0)) - def test_blit__SCALPHA32_TO_OPAQUE32(self): - # Apparently these types of blits need to write 0 to the destination's - # alpha channel (it's not really an alpha channel but it's treated like one) - # See https://github.com/pygame-community/pygame-ce/pull/2067 - - alphas = [0, 10, 50, 122, 240, 255] - - combinations = list(itertools.combinations_with_replacement(alphas, 2)) - width = len(combinations) - - # masks explicitly specified so direct pixel access of bytes below is - # guaranteed to be stable - surf1 = pygame.Surface((width, 1), depth=32, masks=(0xFF0000, 0xFF00, 0xFF, 0)) - surf2 = pygame.Surface( - (width, 1), - pygame.SRCALPHA, - depth=32, - masks=(0xFF0000, 0xFF00, 0xFF, 0xFF000000), - ) - - for i in range(width): - alpha1, alpha2 = combinations[i] - surf1.set_at((i, 0), (0, 0, 0, alpha1)) - surf2.set_at((i, 0), (0, 0, 0, alpha2)) - - surf1.blit(surf2, (0, 0)) - - # Why use get_buffer? - # get_at for RGBX surfaces seems to always think A=255, regardless - # of bytes in surface, which makes sense. - surf1_bytes = surf1.get_buffer().raw - for i in range(width): - # +3 gets the "alpha channel" in this pixel format - assert surf1_bytes[i * 4 + 3] == 0 - - def test_blit_default_dest(self): - surf1 = pygame.Surface((20, 20)) - surf1.fill("black") - surf2 = pygame.Surface((10, 10)) - surf2.fill("red") - surf1.blit(surf2) - self.assertEqual(surf1.get_at((0, 0)), pygame.Color("red")) - self.assertEqual(surf1.get_at((10, 10)), pygame.Color("black")) - class GeneralSurfaceTests(unittest.TestCase): @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires a non-null SDL_VIDEODRIVER", + os.environ.get("SDL_VIDEODRIVER") == "dummy", + 'requires a non-"dummy" SDL_VIDEODRIVER', ) def test_image_convert_bug_131(self): - # bug #146: Unable to Surface.convert(32) some 1-bit images. - # https://github.com/pygame-community/pygame-ce/issues/146 + # bug #131: Unable to Surface.convert(32) some 1-bit images. + # https://github.com/pygame/pygame/issues/131 pygame.display.init() try: + pygame.display.set_mode((640, 480)) + im = pygame.image.load(example_path(os.path.join("data", "city.png"))) im2 = pygame.image.load(example_path(os.path.join("data", "brick.png"))) - # Only validate the first two entries; stbimage backend gives a 256 - # length palette while libpng doesn't. - self.assertEqual( - im.get_palette()[:2], ((0, 0, 0, 255), (255, 255, 255, 255)) - ) - self.assertEqual(im2.get_palette()[:2], ((0, 0, 0, 255), (0, 0, 0, 255))) + self.assertEqual(im.get_palette(), ((0, 0, 0, 255), (255, 255, 255, 255))) + self.assertEqual(im2.get_palette(), ((0, 0, 0, 255), (0, 0, 0, 255))) - self.assertEqual( - repr(im.convert(32)), "" - ) - self.assertEqual( - repr(im2.convert(32)), "" - ) + self.assertEqual(repr(im.convert(32)), "") + self.assertEqual(repr(im2.convert(32)), "") # Ensure a palette format to palette format works. im3 = im.convert(8) - self.assertEqual(repr(im3), "") + self.assertEqual(repr(im3), "") self.assertEqual(im3.get_palette(), im.get_palette()) finally: pygame.display.quit() + @unittest.skipIf( + os.environ.get("SDL_VIDEODRIVER") == "dummy", + 'requires a non-"dummy" SDL_VIDEODRIVER', + ) def test_convert_init(self): """Ensure initialization exceptions are raised for surf.convert().""" pygame.display.quit() surf = pygame.Surface((1, 1)) - filename = example_path(os.path.join("data", "alien3.png")) # 8bit PNG - surf8bit = pygame.image.load(filename) - self.assertRaisesRegex(pygame.error, "display is not initialized", surf.convert) + self.assertRaisesRegex(pygame.error, "display initialized", surf.convert) pygame.display.init() try: - if os.environ.get("SDL_VIDEODRIVER") != pygame.NULL_VIDEODRIVER: - try: - surf.convert(32) - surf.convert(pygame.Surface((1, 1))) - except pygame.error: - self.fail("convert() should not raise an exception here.") + try: + surf.convert(32) + surf.convert(pygame.Surface((1, 1))) + except pygame.error: + self.fail("convert() should not raise an exception here.") - self.assertRaisesRegex(pygame.error, "No convert format", surf.convert) - self.assertRaisesRegex(pygame.error, "No convert format", surf8bit.convert) + self.assertRaisesRegex(pygame.error, "No video mode", surf.convert) pygame.display.set_mode((640, 480)) try: @@ -1293,6 +1121,10 @@ class GeneralSurfaceTests(unittest.TestCase): finally: pygame.display.quit() + @unittest.skipIf( + os.environ.get("SDL_VIDEODRIVER") == "dummy", + 'requires a non-"dummy" SDL_VIDEODRIVER', + ) def test_convert_alpha_init(self): """Ensure initialization exceptions are raised for surf.convert_alpha().""" @@ -1303,9 +1135,7 @@ class GeneralSurfaceTests(unittest.TestCase): pygame.display.init() try: - self.assertRaisesRegex( - pygame.error, "No convert format", surf.convert_alpha - ) + self.assertRaisesRegex(pygame.error, "No video mode", surf.convert_alpha) pygame.display.set_mode((640, 480)) try: @@ -1330,20 +1160,6 @@ class GeneralSurfaceTests(unittest.TestCase): finally: pygame.display.quit() - def test_convert_palettize(self): - pygame.display.init() - try: - surf = pygame.Surface((150, 250)) - surf.fill((255, 50, 0)) - surf = surf.convert(8) - surf2 = pygame.Surface((150, 250), depth=8) - surf2.fill((255, 50, 0)) - - self.assertEqual(surf.get_at((50, 50)), surf2.get_at((50, 50))) - - finally: - pygame.display.quit() - def test_src_alpha_issue_1289(self): """blit should be white.""" surf1 = pygame.Surface((1, 1), pygame.SRCALPHA, 32) @@ -1802,31 +1618,33 @@ class GeneralSurfaceTests(unittest.TestCase): self.assertEqual(no_surf_alpha_col, surf_alpha_col) def todo_test_convert(self): - # __doc__ (as of 2008-08-02) for pygame.surface.Surface.convert: - - # Surface.convert(Surface): return Surface - # Surface.convert(depth, flags=0): return Surface - # Surface.convert(masks, flags=0): return Surface - # Surface.convert(): return Surface - # change the pixel format of an image - # - # Creates a new copy of the Surface with the pixel format changed. The - # new pixel format can be determined from another existing Surface. - # Otherwise, depth, flags, and masks arguments can be used, similar to - # the pygame.Surface() call. - # - # If no arguments are passed the new Surface will have the same pixel - # format as the display Surface. This is always the fastest format for - # blitting. It is a good idea to convert all Surfaces before they are - # blitted many times. - # - # The converted Surface will have no pixel alphas. They will be - # stripped if the original had them. See Surface.convert_alpha() for - # preserving or creating per-pixel alphas. - # - self.fail() + # Below should not use a display Surface, but create one and check it is converted + # to the depth of the display surface. + + # def test_convert(self): + # """Ensure to creates a new copy of the Surface with the pixel format changed""" + # width = 23 + # height = 17 + # size = (width, height) + # flags = 0 + # depth = 32 + # pygame.display.init() + + # try: + # convert_surface = pygame.display.set_mode(size) + # surface = pygame.surface.Surface.convert(convert_surface) + # self.assertIsNot(surface, convert_surface) + # self.assertNotEqual(surface.get_size(), size) + + # depth_surface = pygame.display.set_mode(size, flags, depth) + # surface2 = pygame.surface.Surface.convert(depth_surface) + # self.assertIsNot(surface2, depth_surface) + # self.assertEqual(surface2.get_size(), size) + # finally: + # pygame.display.quit() + def test_convert__pixel_format_as_surface_subclass(self): """Ensure convert accepts a Surface subclass argument.""" expected_size = (23, 17) @@ -1845,16 +1663,6 @@ class GeneralSurfaceTests(unittest.TestCase): finally: pygame.display.quit() - def test_convert_alpha_argument_deprecation(self): - pygame.display.init() - pygame.display.set_mode((640, 480)) - - surf = pygame.Surface((64, 64)) - surf_2 = pygame.Surface((64, 64)) - - with self.assertWarns(DeprecationWarning): - surf_2.convert_alpha(surf) - def test_convert_alpha(self): """Ensure the surface returned by surf.convert_alpha has alpha values added""" @@ -1862,6 +1670,9 @@ class GeneralSurfaceTests(unittest.TestCase): try: pygame.display.set_mode((640, 480)) + s1 = pygame.Surface((100, 100), 0, 32) + s1_alpha = pygame.Surface.convert_alpha(s1) + s2 = pygame.Surface((100, 100), 0, 32) s2_alpha = s2.convert_alpha() @@ -1880,6 +1691,7 @@ class GeneralSurfaceTests(unittest.TestCase): s7 = pygame.Surface((100, 100), 0, 24) s7_alpha = s7.convert_alpha() + self.assertEqual(s1_alpha.get_alpha(), 255) self.assertEqual(s2_alpha.get_alpha(), 255) self.assertEqual(s3_alpha.get_alpha(), 255) self.assertEqual(s4_alpha.get_alpha(), 255) @@ -1887,6 +1699,7 @@ class GeneralSurfaceTests(unittest.TestCase): self.assertEqual(s6_alpha.get_alpha(), 255) self.assertEqual(s7_alpha.get_alpha(), 255) + self.assertEqual(s1_alpha.get_bitsize(), 32) self.assertEqual(s2_alpha.get_bitsize(), 32) self.assertEqual(s3_alpha.get_bitsize(), 32) self.assertEqual(s4_alpha.get_bitsize(), 32) @@ -1906,13 +1719,17 @@ class GeneralSurfaceTests(unittest.TestCase): """Ensure convert_alpha accepts a Surface subclass argument.""" expected_size = (23, 17) convert_surface = SurfaceSubclass(expected_size, SRCALPHA, 32) + depth_surface = SurfaceSubclass((31, 57), SRCALPHA, 32) pygame.display.init() try: pygame.display.set_mode((60, 60)) - surface = convert_surface.convert_alpha() + # This is accepted as an argument, but its values are ignored. + # See issue #599. + surface = convert_surface.convert_alpha(depth_surface) + self.assertIsNot(surface, depth_surface) self.assertIsNot(surface, convert_surface) self.assertIsInstance(surface, pygame.Surface) self.assertIsInstance(surface, SurfaceSubclass) @@ -1925,7 +1742,7 @@ class GeneralSurfaceTests(unittest.TestCase): try: parent = pygame.Surface((64, 64), SRCALPHA, 32) - # Stack a bunch of subsurfaces + # Stack bunch of subsurfaces sub_level_1 = parent.subsurface((2, 2), (34, 37)) sub_level_2 = sub_level_1.subsurface((0, 0), (30, 29)) sub_level_3 = sub_level_2.subsurface((3, 7), (20, 21)) @@ -1957,7 +1774,7 @@ class GeneralSurfaceTests(unittest.TestCase): try: parent = pygame.Surface((32, 32), SRCALPHA, 32) - # Stack a bunch of subsurfaces + # Stack bunch of subsurfaces sub_level_1 = parent.subsurface((1, 1), (15, 15)) sub_level_2 = sub_level_1.subsurface((1, 1), (12, 12)) sub_level_3 = sub_level_2.subsurface((1, 1), (9, 9)) @@ -2002,15 +1819,10 @@ class GeneralSurfaceTests(unittest.TestCase): surf.set_at((1, 1), c11) c = surf.get_at((0, 0)) self.assertIsInstance(c, pygame.Color) - c = surf.get_at(pygame.Vector2(0, 0)) - self.assertIsInstance(c, pygame.Color) self.assertEqual(c, c00) self.assertEqual(surf.get_at((0, 1)), c01) self.assertEqual(surf.get_at((1, 0)), c10) self.assertEqual(surf.get_at((1, 1)), c11) - self.assertEqual(surf.get_at(pygame.Vector2(0, 1)), c01) - self.assertEqual(surf.get_at(pygame.Vector2(1, 0)), c10) - self.assertEqual(surf.get_at(pygame.Vector2(1, 1)), c11) for p in [(-1, 0), (0, -1), (2, 0), (0, 2)]: self.assertRaises(IndexError, surf.get_at, p) @@ -2025,12 +1837,6 @@ class GeneralSurfaceTests(unittest.TestCase): surf.map_rgb(color), "%i != %i, bitsize: %i" % (pixel, surf.map_rgb(color), bitsize), ) - pixel = surf.get_at_mapped(pygame.Vector2(0, 0)) - self.assertEqual( - pixel, - surf.map_rgb(color), - "%i != %i, bitsize: %i" % (pixel, surf.map_rgb(color), bitsize), - ) def test_get_bitsize(self): pygame.display.init() @@ -2521,7 +2327,7 @@ class GeneralSurfaceTests(unittest.TestCase): def test_palette_colorkey(self): """test bug discovered by robertpfeiffer - https://github.com/pygame-community/pygame-ce/issues/541 + https://github.com/pygame/pygame/issues/721 """ surf = pygame.image.load(example_path(os.path.join("data", "alien2.png"))) key = surf.get_colorkey() @@ -2604,7 +2410,7 @@ class GeneralSurfaceTests(unittest.TestCase): # # Returns a new Surface that shares its pixels with its new parent. # The new Surface is considered a child of the original. Modifications - # to either Surface pixels will affect each other. Surface information + # to either Surface pixels will effect each other. Surface information # like clipping area and color keys are unique to each Surface. # # The new Surface will inherit the palette, color key, and alpha @@ -2632,7 +2438,7 @@ class GeneralSurfaceTests(unittest.TestCase): self.assertEqual(s.get_masks(), surf.get_masks()) self.assertEqual(s.get_losses(), surf.get_losses()) - # Issue https://github.com/pygame-community/pygame-ce/issues/17 + # Issue https://github.com/pygame/pygame/issues/2 surf = pygame.Surface.__new__(pygame.Surface) self.assertRaises(pygame.error, surf.subsurface, (0, 0, 0, 0)) @@ -2679,7 +2485,7 @@ class GeneralSurfaceTests(unittest.TestCase): # Confirm it is a Color instance self.assertIsInstance(unmapped_c, pygame.Color) - # Remaining, non-palette, cases. + # Remaining, non-pallete, cases. c = (128, 64, 12, 255) formats = [(0, 16), (0, 24), (0, 32), (SRCALPHA, 16), (SRCALPHA, 32)] for flags, bitsize in formats: @@ -2697,35 +2503,74 @@ class GeneralSurfaceTests(unittest.TestCase): self.assertIsInstance(unmapped_c, pygame.Color) def test_scroll(self): - # Check segfaults for any direction or bits or mode - for bits in [8, 16, 24, 32]: - for flag in [0, pygame.SCROLL_ERASE, pygame.SCROLL_REPEAT]: - for dx in range(-1, 1): - for dy in range(-1, 1): - surface = pygame.Surface((20, 20), 0, bits) - surface.scroll(dx * 2, dy * 2, flag) - # Check non repeating mode working - surface = pygame.Surface((20, 20)) - surface.fill("green") - surface.scroll(10, 0) - self.assertEqual(surface.get_at((0, 0)), pygame.Color("green")) - # Check non repeating, erasing mode working - surface = pygame.Surface((20, 20)) - surface.fill("green") - surface.scroll(2, 2, pygame.SCROLL_ERASE) - self.assertEqual(surface.get_at((0, 0)), pygame.Color("black")) - # Check repeating mode working - surface = pygame.Surface((20, 20)) - surface.fill("green") - pygame.draw.rect(surface, "red", (0, 0, 10, 20)) - surface.scroll(4, 0, pygame.SCROLL_REPEAT) - self.assertEqual(surface.get_at((0, 0)), pygame.Color("green")) - # kwargs - surface.scroll(dx=1, dy=1, scroll_flag=0) + scrolls = [ + (8, 2, 3), + (16, 2, 3), + (24, 2, 3), + (32, 2, 3), + (32, -1, -3), + (32, 0, 0), + (32, 11, 0), + (32, 0, 11), + (32, -11, 0), + (32, 0, -11), + (32, -11, 2), + (32, 2, -11), + ] + for bitsize, dx, dy in scrolls: + surf = pygame.Surface((10, 10), 0, bitsize) + surf.fill((255, 0, 0)) + surf.fill((0, 255, 0), (2, 2, 2, 2)) + comp = surf.copy() + comp.blit(surf, (dx, dy)) + surf.scroll(dx, dy) + w, h = surf.get_size() + for x in range(w): + for y in range(h): + with self.subTest(x=x, y=y): + self.assertEqual( + surf.get_at((x, y)), + comp.get_at((x, y)), + "%s != %s, bpp:, %i, x: %i, y: %i" + % ( + surf.get_at((x, y)), + comp.get_at((x, y)), + bitsize, + dx, + dy, + ), + ) + # Confirm clip rect containment + surf = pygame.Surface((20, 13), 0, 32) + surf.fill((255, 0, 0)) + surf.fill((0, 255, 0), (7, 1, 6, 6)) + comp = surf.copy() + clip = Rect(3, 1, 8, 14) + surf.set_clip(clip) + comp.set_clip(clip) + comp.blit(surf, (clip.x + 2, clip.y + 3), surf.get_clip()) + surf.scroll(2, 3) + w, h = surf.get_size() + for x in range(w): + for y in range(h): + self.assertEqual(surf.get_at((x, y)), comp.get_at((x, y))) + # Confirm keyword arguments and per-pixel alpha + spot_color = (0, 255, 0, 128) + surf = pygame.Surface((4, 4), pygame.SRCALPHA, 32) + surf.fill((255, 0, 0, 255)) + surf.set_at((1, 1), spot_color) + surf.scroll(dx=1) + self.assertEqual(surf.get_at((2, 1)), spot_color) + surf.scroll(dy=1) + self.assertEqual(surf.get_at((2, 2)), spot_color) + surf.scroll(dy=1, dx=1) + self.assertEqual(surf.get_at((3, 3)), spot_color) + surf.scroll(dx=-3, dy=-3) + self.assertEqual(surf.get_at((0, 0)), spot_color) class SurfaceSubtypeTest(unittest.TestCase): - """pygame-ce issue #295: Methods that return a new Surface preserve subclasses""" + """Issue #280: Methods that return a new Surface preserve subclasses""" def setUp(self): pygame.display.init() @@ -2782,9 +2627,9 @@ class SurfaceSubtypeTest(unittest.TestCase): """ pygame.display.set_mode((40, 40)) expected_size = (32, 32) - + s = pygame.Surface(expected_size, SRCALPHA, 16) ms1 = SurfaceSubclass(expected_size, SRCALPHA, 32) - ms2 = ms1.convert_alpha() + ms2 = ms1.convert_alpha(s) self.assertIsNot(ms1, ms2) self.assertIsInstance(ms1, pygame.Surface) @@ -2817,7 +2662,7 @@ class SurfaceSubtypeTest(unittest.TestCase): class SurfaceGetBufferTest(unittest.TestCase): - # These tests require ctypes. They are disabled if ctypes + # These tests requires ctypes. They are disabled if ctypes # is not installed. try: ArrayInterface @@ -2997,6 +2842,7 @@ class SurfaceGetBufferTest(unittest.TestCase): s = pygame.Surface((4, 2), 0, 32) self._check_interface_rgba(s, plane) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_newbuf_PyBUF_flags_bytes(self): from pygame.tests.test_utils import buftools @@ -3056,6 +2902,7 @@ class SurfaceGetBufferTest(unittest.TestCase): self.assertEqual(b.ndim, 1) self.assertEqual(b.strides, (1,)) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_newbuf_PyBUF_flags_0D(self): # This is the same handler as used by get_buffer(), so just # confirm that it succeeds for one case. @@ -3075,6 +2922,7 @@ class SurfaceGetBufferTest(unittest.TestCase): self.assertFalse(b.readonly) self.assertEqual(b.buf, s._pixels_address) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_newbuf_PyBUF_flags_1D(self): from pygame.tests.test_utils import buftools @@ -3113,13 +2961,14 @@ class SurfaceGetBufferTest(unittest.TestCase): self.assertTrue(b.format is None) self.assertEqual(b.strides, (s.get_bytesize(),)) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_newbuf_PyBUF_flags_2D(self): from pygame.tests.test_utils import buftools Importer = buftools.Importer s = pygame.Surface((10, 6), 0, 32) a = s.get_view("2") - # Non-dimensional requests, no PyDEF_ND, are handled by the + # Non dimensional requests, no PyDEF_ND, are handled by the # 1D surface buffer code, so only need to confirm a success. b = Importer(a, buftools.PyBUF_SIMPLE) self.assertEqual(b.ndim, 0) @@ -3183,6 +3032,7 @@ class SurfaceGetBufferTest(unittest.TestCase): self.assertRaises(BufferError, Importer, a, buftools.PyBUF_F_CONTIGUOUS) self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ANY_CONTIGUOUS) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_newbuf_PyBUF_flags_3D(self): from pygame.tests.test_utils import buftools @@ -3233,6 +3083,7 @@ class SurfaceGetBufferTest(unittest.TestCase): self.assertRaises(BufferError, Importer, a, buftools.PyBUF_F_CONTIGUOUS) self.assertRaises(BufferError, Importer, a, buftools.PyBUF_ANY_CONTIGUOUS) + @unittest.skipIf(not pygame.HAVE_NEWBUF, "newbuf not implemented") def test_newbuf_PyBUF_flags_rgba(self): # All color plane views are handled by the same routine, # so only one plane need be checked. @@ -3588,7 +3439,7 @@ class SurfaceBlendTest(unittest.TestCase): return (expected_col, actual_col) - # # Color Tests + # # Colour Tests self.assertEqual( *test_premul_surf(pygame.Color(40, 20, 0, 51), pygame.Color(40, 20, 0, 51)) ) @@ -3809,39 +3660,6 @@ class SurfaceBlendTest(unittest.TestCase): ) ) - def test_blit_blend_premultiplied_pixelformats(self): - # first create two BGRA pixel format surfaces using - # tobytes & frombytes - argb_surf_a = pygame.Surface((64, 64), flags=pygame.SRCALPHA) - byte_surf_a = pygame.image.tobytes(argb_surf_a, "ARGB") - bgra_surf_a = pygame.image.frombytes(byte_surf_a, (64, 64), "ARGB") - - argb_surf_b = pygame.Surface((64, 64), flags=pygame.SRCALPHA) - byte_surf_b = pygame.image.tobytes(argb_surf_b, "ARGB") - bgra_surf_b = pygame.image.frombytes(byte_surf_b, (64, 64), "ARGB") - - argb_surf_a.fill((64, 0, 0, 128)) - self.assertEqual(argb_surf_a.get_at((0, 0)), pygame.Color(64, 0, 0, 128)) - - # 128 green, 128 blue at 50% alpha, premultiplied - argb_surf_b.fill((0, 64, 64, 128)) - self.assertEqual(argb_surf_b.get_at((0, 0)), pygame.Color(0, 64, 64, 128)) - - argb_surf_a.blit(argb_surf_b, (0, 0), special_flags=pygame.BLEND_PREMULTIPLIED) - - self.assertEqual(argb_surf_a.get_at((0, 0)), pygame.Color(32, 64, 64, 192)) - - bgra_surf_a.fill((64, 0, 0, 128)) # 128 red at 50% alpha - self.assertEqual(bgra_surf_a.get_at((0, 0)), pygame.Color(64, 0, 0, 128)) - - # 128 green, 128 blue at 50% alpha, premultiplied - bgra_surf_b.fill((0, 64, 64, 128)) - self.assertEqual(bgra_surf_b.get_at((0, 0)), pygame.Color(0, 64, 64, 128)) - - bgra_surf_a.blit(bgra_surf_b, (0, 0), special_flags=pygame.BLEND_PREMULTIPLIED) - - self.assertEqual(bgra_surf_a.get_at((0, 0)), pygame.Color(32, 64, 64, 192)) - def test_blit_blend_big_rect(self): """test that an oversized rect works ok.""" color = (1, 2, 3, 255) @@ -3958,26 +3776,11 @@ class SurfaceBlendTest(unittest.TestCase): s1_alpha = s1.premul_alpha() self.assertEqual(s1_alpha.get_at((50, 50)), pygame.Color(100, 100, 100, 100)) - # 16-bit color has less precision + # 16 bit colour has less precision s2 = pygame.Surface((100, 100), pygame.SRCALPHA, 16) - s2.fill( - pygame.Color( - int(15 / 15 * 255), - int(15 / 15 * 255), - int(15 / 15 * 255), - int(10 / 15 * 255), - ) - ) + s2.fill(pygame.Color(255, 255, 255, 170)) s2_alpha = s2.premul_alpha() - self.assertEqual( - s2_alpha.get_at((50, 50)), - pygame.Color( - int(10 / 15 * 255), - int(10 / 15 * 255), - int(10 / 15 * 255), - int(10 / 15 * 255), - ), - ) + self.assertEqual(s2_alpha.get_at((50, 50)), pygame.Color(170, 170, 170, 170)) # invalid surface - we need alpha to pre-multiply invalid_surf = pygame.Surface((100, 100), 0, 32) @@ -4017,106 +3820,11 @@ class SurfaceBlendTest(unittest.TestCase): ), ) - def create_surface_from_byte_width(byte_width): - surf_height = 5 - byte_data = bytes(byte_width * surf_height) # 50 bytes - surf_width = byte_width // 4 # width = 2 - - dest = pygame.image.frombuffer( - byte_data, (surf_width, surf_height), "RGBA", pitch=byte_width - ) - dest.fill((120, 50, 70, 200)) - return dest - - test_surf = create_surface_from_byte_width(10) - test_surf = test_surf.premul_alpha() - - for y in range(0, test_surf.get_height()): - for x in range(0, test_surf.get_width()): - self.assertEqual( - test_surf.get_at((x, y)), pygame.Color(94, 39, 55, 200) - ) - - def test_surface_premul_alpha_ip(self): - """Ensure that .premul_alpha_ip() works correctly""" - - # basic functionality at valid bit depths - 32, 16 & 8 - s1 = pygame.Surface((100, 100), pygame.SRCALPHA, 32) - s1.fill(pygame.Color(255, 255, 255, 100)) - s1.premul_alpha_ip() - s1_alpha = s1 - self.assertEqual(s1_alpha.get_at((50, 50)), pygame.Color(100, 100, 100, 100)) - - # 16-bit color has less precision - s2 = pygame.Surface((100, 100), pygame.SRCALPHA, 16) - s2.fill( - pygame.Color( - int(15 / 15 * 255), - int(15 / 15 * 255), - int(15 / 15 * 255), - int(10 / 15 * 255), - ) - ) - s2.premul_alpha_ip() - s2_alpha = s2 - self.assertEqual( - s2_alpha.get_at((50, 50)), - pygame.Color( - int(10 / 15 * 255), - int(10 / 15 * 255), - int(10 / 15 * 255), - int(10 / 15 * 255), - ), - ) - - # invalid surface - we need alpha to pre-multiply - invalid_surf = pygame.Surface((100, 100), 0, 32) - invalid_surf.fill(pygame.Color(255, 255, 255, 100)) - with self.assertRaises(ValueError): - invalid_surf.premul_alpha_ip() - - # churn a bunch of values - test_colors = [ - (200, 30, 74), - (76, 83, 24), - (184, 21, 6), - (74, 4, 74), - (76, 83, 24), - (184, 21, 234), - (160, 30, 74), - (96, 147, 204), - (198, 201, 60), - (132, 89, 74), - (245, 9, 224), - (184, 112, 6), - ] - - for r, g, b in test_colors: - for a in range(255): - with self.subTest(r=r, g=g, b=b, a=a): - surf = pygame.Surface((10, 10), pygame.SRCALPHA, 32) - surf.fill(pygame.Color(r, g, b, a)) - surf.premul_alpha_ip() - self.assertEqual( - surf.get_at((5, 5)), - Color( - ((r + 1) * a) >> 8, - ((g + 1) * a) >> 8, - ((b + 1) * a) >> 8, - a, - ), - ) - - for size in [(0, 0), (1, 0), (0, 1), (10, 10)]: - surf = pygame.Surface(size, pygame.SRCALPHA, 32) - surf.fill((32, 44, 4, 123)) - self.assertIs(surf, surf.premul_alpha_ip()) - class SurfaceSelfBlitTest(unittest.TestCase): """Blit to self tests. - This test case is in response to https://github.com/pygame-community/pygame-ce/issues/34 + This test case is in response to https://github.com/pygame/pygame/issues/19 """ def setUp(self): @@ -4193,11 +3901,11 @@ class SurfaceSelfBlitTest(unittest.TestCase): surf.blit(surf, (d_x, d_y), (s_x, s_y, 50, 50)) self.assertEqual(surf.get_at(test_posn), rectc_right) - # https://github.com/pygame-community/pygame-ce/issues/374, final comment by illume + # https://github.com/pygame/pygame/issues/370#issuecomment-364625291 @unittest.skipIf("ppc64le" in platform.uname(), "known ppc64le issue") def test_colorkey(self): # Check a workaround for an SDL 1.2.13 surface self-blit problem - # https://github.com/pygame-community/pygame-ce/issues/34 + # https://github.com/pygame/pygame/issues/19 pygame.display.set_mode((100, 50)) # Needed for 8bit surface bitsizes = [8, 16, 24, 32] for bitsize in bitsizes: @@ -4216,11 +3924,11 @@ class SurfaceSelfBlitTest(unittest.TestCase): comp.blit(tmp, (0, 0)) self._assert_same(surf, comp) - # https://github.com/pygame-community/pygame-ce/issues/374 final comment by illume + # https://github.com/pygame/pygame/issues/370#issuecomment-364625291 @unittest.skipIf("ppc64le" in platform.uname(), "known ppc64le issue") def test_blanket_alpha(self): # Check a workaround for an SDL 1.2.13 surface self-blit problem - # https://github.com/pygame-community/pygame-ce/issues/34 + # https://github.com/pygame/pygame/issues/19 pygame.display.set_mode((100, 50)) # Needed for 8bit surface bitsizes = [8, 16, 24, 32] for bitsize in bitsizes: @@ -4299,7 +4007,7 @@ class SurfaceSelfBlitTest(unittest.TestCase): self.assertRaises(pygame.error, do_blit, surf, sub) def test_copy_alpha(self): - """pygame-ce issue 487: alpha of surface copy with SRCALPHA is set to 0.""" + """issue 581: alpha of surface copy with SRCALPHA is set to 0.""" surf = pygame.Surface((16, 16), pygame.SRCALPHA, 32) self.assertEqual(surf.get_alpha(), 255) surf2 = surf.copy() @@ -4351,38 +4059,6 @@ class SurfaceFillTest(unittest.TestCase): for y in range(5, 480, 10): self.assertEqual(screen.get_at((10, y)), screen.get_at((330, 480 - y))) - def test_fill_negative_rectpos(self): - """Regression test for https://github.com/pygame-community/pygame-ce/issues/2938""" - screen = pygame.display.set_mode((640, 480)) - other_surface = screen.copy() - - negative_x_rect = pygame.Rect(-10, 10, 20, 20) - negative_x_rect_drawn = pygame.Rect(0, 10, 10, 20) - negative_y_rect = pygame.Rect(100, -10, 20, 20) - negative_y_rect_drawn = pygame.Rect(100, 0, 20, 10) - negative_both = pygame.Rect(-10, -10, 20, 20) - negative_both_drawn = pygame.Rect(0, 0, 10, 10) - - red_rect_1 = screen.fill("red", negative_x_rect) - blue_rect_1 = screen.fill("blue", negative_y_rect) - green_rect_1 = screen.fill("green", negative_both) - - red_rect_2 = other_surface.fill("red", negative_x_rect_drawn) - blue_rect_2 = other_surface.fill("blue", negative_y_rect_drawn) - green_rect_2 = other_surface.fill("green", negative_both_drawn) - - self.assertEqual(red_rect_1, red_rect_2) - self.assertEqual(blue_rect_1, blue_rect_2) - self.assertEqual(green_rect_1, green_rect_2) - - # verify both have the same pixels - width, height = screen.get_size() - for row in range(height): - for col in range(width): - self.assertEqual( - screen.get_at((col, row)), other_surface.get_at((col, row)) - ) - if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_tags.py b/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_tags.py index 5e24b93..baa535c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_tags.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_tags.py @@ -6,6 +6,11 @@ try: import numpy except ImportError: exclude = True +else: + try: + import pygame.pixelcopy + except ImportError: + exclude = True if exclude: __tags__.extend(("ignore", "subprocess_ignore")) diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_test.py index f51a411..ee74290 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/surfarray_test.py @@ -1,23 +1,25 @@ -import platform import unittest +import platform -import pygame -import pygame.surfarray from numpy import ( - __version__ as np_version, - all as np_all, - arange, - float32, - float64, - rint, uint8, uint16, uint32, uint64, zeros, + float32, + float64, + all as alltrue, + rint, + arange, ) + +import pygame from pygame.locals import * +import pygame.surfarray + + IS_PYPY = "PyPy" == platform.python_implementation() @@ -111,10 +113,10 @@ class SurfarrayModuleTest(unittest.TestCase): def _fill_array2d(self, arr, surf): palette = self.test_palette - arr[:5, :6] = surf.map_rgb(palette[1]) - arr[5:, :6] = surf.map_rgb(palette[2]) - arr[:5, 6:] = surf.map_rgb(palette[3]) - arr[5:, 6:] = surf.map_rgb(palette[4]) + arr[:5, :6] = surf.map_rgb(palette[1]) & 0xFFFFFFFF + arr[5:, :6] = surf.map_rgb(palette[2]) & 0xFFFFFFFF + arr[:5, 6:] = surf.map_rgb(palette[3]) & 0xFFFFFFFF + arr[5:, 6:] = surf.map_rgb(palette[4]) & 0xFFFFFFFF def _fill_array3d(self, arr): palette = self.test_palette @@ -233,7 +235,7 @@ class SurfarrayModuleTest(unittest.TestCase): ), ) else: - self.assertTrue(np_all(arr == 255)) + self.assertTrue(alltrue(arr == 255)) # No per-pixel alpha when blanket alpha is None. for surf in targets: @@ -241,7 +243,7 @@ class SurfarrayModuleTest(unittest.TestCase): surf.set_alpha(None) arr = pygame.surfarray.array_alpha(surf) self.assertTrue( - np_all(arr == 255), + alltrue(arr == 255), "All alpha values should be 255 when" " surf.set_alpha(None) has been set." " bitsize: %i, flags: %i" % (surf.get_bitsize(), surf.get_flags()), @@ -255,12 +257,12 @@ class SurfarrayModuleTest(unittest.TestCase): arr = pygame.surfarray.array_alpha(surf) if surf.get_masks()[3]: self.assertFalse( - np_all(arr == 255), + alltrue(arr == 255), "bitsize: %i, flags: %i" % (surf.get_bitsize(), surf.get_flags()), ) else: self.assertTrue( - np_all(arr == 255), + alltrue(arr == 255), "bitsize: %i, flags: %i" % (surf.get_bitsize(), surf.get_flags()), ) surf.set_alpha(blanket_alpha) @@ -288,7 +290,7 @@ class SurfarrayModuleTest(unittest.TestCase): p = [surf.unmap_rgb(surf.map_rgb(c)) for c in p] surf.set_colorkey(None) arr = pygame.surfarray.array_colorkey(surf) - self.assertTrue(np_all(arr == 255)) + self.assertTrue(alltrue(arr == 255)) for i in range(1, len(palette)): surf.set_colorkey(p[i]) @@ -469,34 +471,39 @@ class SurfarrayModuleTest(unittest.TestCase): arr.shape = (1, 1, 1, 4) self.assertRaises(ValueError, do_blit, surf, arr) - # pygame-ce issue #96: round from float to int - surf = pygame.Surface((10, 10), pygame.SRCALPHA, 32) - w, h = surf.get_size() - length = w * h - for dtype in [float32, float64]: - surf.fill((255, 255, 255, 0)) - farr = arange(0, length, dtype=dtype) - farr.shape = w, h - pygame.surfarray.blit_array(surf, farr) - for x in range(w): - for y in range(h): - self.assertEqual(surf.get_at_mapped((x, y)), int(rint(farr[x, y]))) + # Issue #81: round from float to int + try: + rint + except NameError: + pass + else: + surf = pygame.Surface((10, 10), pygame.SRCALPHA, 32) + w, h = surf.get_size() + length = w * h + for dtype in [float32, float64]: + surf.fill((255, 255, 255, 0)) + farr = arange(0, length, dtype=dtype) + farr.shape = w, h + pygame.surfarray.blit_array(surf, farr) + for x in range(w): + for y in range(h): + self.assertEqual( + surf.get_at_mapped((x, y)), int(rint(farr[x, y])) + ) # this test should be removed soon, when the function is deleted def test_get_arraytype(self): - with self.assertWarns(DeprecationWarning): - array_type = pygame.surfarray.get_arraytype() + array_type = pygame.surfarray.get_arraytype() - self.assertEqual(array_type, "numpy", f"unknown array type {array_type}") + self.assertEqual(array_type, "numpy", f"unknown array type {array_type}") # this test should be removed soon, when the function is deleted def test_get_arraytypes(self): - with self.assertWarns(DeprecationWarning): - arraytypes = pygame.surfarray.get_arraytypes() - self.assertIn("numpy", arraytypes) + arraytypes = pygame.surfarray.get_arraytypes() + self.assertIn("numpy", arraytypes) - for atype in arraytypes: - self.assertEqual(atype, "numpy", f"unknown array type {atype}") + for atype in arraytypes: + self.assertEqual(atype, "numpy", f"unknown array type {atype}") def test_make_surface(self): # How does one properly test this with 2d arrays. It makes no sense @@ -513,17 +520,24 @@ class SurfarrayModuleTest(unittest.TestCase): surf = pygame.surfarray.make_surface(self._make_src_array3d(dtype)) self._assert_surface(surf) - # pygame-ce issue #96: round from float to int - w = 9 - h = 11 - length = w * h - for dtype in [float32, float64]: - farr = arange(0, length, dtype=dtype) - farr.shape = w, h - surf = pygame.surfarray.make_surface(farr) - for x in range(w): - for y in range(h): - self.assertEqual(surf.get_at_mapped((x, y)), int(rint(farr[x, y]))) + # Issue #81: round from float to int + try: + rint + except NameError: + pass + else: + w = 9 + h = 11 + length = w * h + for dtype in [float32, float64]: + farr = arange(0, length, dtype=dtype) + farr.shape = w, h + surf = pygame.surfarray.make_surface(farr) + for x in range(w): + for y in range(h): + self.assertEqual( + surf.get_at_mapped((x, y)), int(rint(farr[x, y])) + ) def test_map_array(self): arr3d = self._make_src_array3d(uint8) @@ -560,11 +574,6 @@ class SurfarrayModuleTest(unittest.TestCase): self._make_array2d(uint8), ) - @unittest.skipIf( - int(np_version.split(".")[0]) >= 2, - "This test fails due to a change in numpy 2.0.0, and a 'proper fix' " - "requires an API/behaviour change", - ) def test_pixels2d(self): sources = [ self._make_surface(8), @@ -710,23 +719,24 @@ class SurfarrayModuleTest(unittest.TestCase): def do_use_arraytype(atype): pygame.surfarray.use_arraytype(atype) - with self.assertWarns(DeprecationWarning): - pygame.surfarray.use_arraytype("numpy") - self.assertEqual(pygame.surfarray.get_arraytype(), "numpy") - self.assertRaises(ValueError, do_use_arraytype, "not an option") + pygame.surfarray.use_arraytype("numpy") + self.assertEqual(pygame.surfarray.get_arraytype(), "numpy") + self.assertRaises(ValueError, do_use_arraytype, "not an option") def test_surf_lock(self): sf = pygame.Surface((5, 5), 0, 32) + for atype in pygame.surfarray.get_arraytypes(): + pygame.surfarray.use_arraytype(atype) - ar = pygame.surfarray.pixels2d(sf) - self.assertTrue(sf.get_locked()) + ar = pygame.surfarray.pixels2d(sf) + self.assertTrue(sf.get_locked()) - sf.unlock() - self.assertTrue(sf.get_locked()) + sf.unlock() + self.assertTrue(sf.get_locked()) - del ar - self.assertFalse(sf.get_locked()) - self.assertEqual(sf.get_locks(), ()) + del ar + self.assertFalse(sf.get_locked()) + self.assertEqual(sf.get_locks(), ()) if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/surflock_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/surflock_test.py index c56bffe..19f354b 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/surflock_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/surflock_test.py @@ -1,6 +1,6 @@ -import platform -import sys import unittest +import sys +import platform import pygame diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/sysfont_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/sysfont_test.py index eaa3ce2..0ae380a 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/sysfont_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/sysfont_test.py @@ -1,5 +1,5 @@ -import platform import unittest +import platform class SysfontModuleTest(unittest.TestCase): @@ -29,31 +29,6 @@ class SysfontModuleTest(unittest.TestCase): arial = pygame.font.SysFont("Arial", 40) self.assertTrue(isinstance(arial, pygame.font.Font)) - pygame.font.SysFont(None, 40) - - @unittest.skipIf("Windows" not in platform.platform(), "Just for windows") - def test_sysfont_settings(self): - import pygame.font - - pygame.font.init() - - # The idea of this test is that we know we can expect Arial bold, Arial italic - # Arial, and Arial italic bold to load different fonts on Windows. If that - # isn't happening it may indicate a problem like - # https://github.com/pygame-community/pygame-ce/issues/2677 - - arial = pygame.font.SysFont("Arial", 40) - arial_bold = pygame.font.SysFont("Arial", 40, bold=True) - arial_italic = pygame.font.SysFont("Arial", 40, italic=True) - arial_bold_italic = pygame.font.SysFont("Arial", 40, bold=True, italic=True) - - self.assertNotEqual(arial.style_name, arial_bold.style_name) - self.assertNotEqual(arial.style_name, arial_italic.style_name) - self.assertNotEqual(arial.style_name, arial_bold_italic.style_name) - self.assertNotEqual(arial_bold.style_name, arial_italic.style_name) - self.assertNotEqual(arial_italic.style_name, arial_bold_italic.style_name) - self.assertNotEqual(arial_bold.style_name, arial_bold_italic.style_name) - @unittest.skipIf( ("Darwin" in platform.platform() or "Windows" in platform.platform()), "Not unix we skip.", @@ -69,25 +44,6 @@ class SysfontModuleTest(unittest.TestCase): self.assertTrue(len(pygame.sysfont.get_fonts()) > 10) - def test_sysfont_warnings(self): - import pygame.font - - pygame.font.init() - - with self.assertWarns(UserWarning): - pygame.font.SysFont("non-existent font", 40) - - with self.assertWarns(UserWarning): - pygame.font.SysFont(bytes("non-existent font", "utf-8"), 40) - - with self.assertWarns(UserWarning): - pygame.font.SysFont(("non-existent font", "non-existent font2"), 40) - - with self.assertWarns(UserWarning): - pygame.font.SysFont( - (bytes("non-existent font", "utf-8"), "non-existent font2"), 40 - ) - ############################################################################### diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/system_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/system_test.py deleted file mode 100644 index e03921c..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/system_test.py +++ /dev/null @@ -1,123 +0,0 @@ -import os -import unittest - -import pygame - - -class SystemModuleTest(unittest.TestCase): - def test_get_cpu_instruction_sets(self): - instruction_sets = pygame.system.get_cpu_instruction_sets() - - for name in instruction_sets: - self.assertIsInstance(name, str) - self.assertIsInstance(instruction_sets[name], bool) - - def test_get_total_ram(self): - ram = pygame.system.get_total_ram() - - self.assertIsInstance(ram, int) - - def test_get_pref_path(self): - get_pref_path = pygame.system.get_pref_path - - """ test the argument validation """ - # wrong arg count - self.assertRaises(TypeError, get_pref_path, "one arg") - # wrong arg types - self.assertRaises(TypeError, get_pref_path, 0, 1) - # wrong kwargs - self.assertRaises(TypeError, get_pref_path, norg="test", napp="app") - # not enough info - self.assertRaises(TypeError, get_pref_path, "testorg", org="testorg") - - org = "pygame test organization" - app = "the best app" - - # gets the path, creates the folder - path = get_pref_path(org, app) - try: # try removing the folder, it should work fine - os.rmdir(path) - except FileNotFoundError: # if the folder isn't found - raise FileNotFoundError("pygame.system.get_pref_path folder not created") - except OSError: # if the dir isn't empty (shouldn't happen) - raise OSError("pygame.system.get_pref_path folder already occupied") - - # gets the path, creates the folder, uses kwargs - path = get_pref_path(org=org, app=app) - try: # try removing the folder, it should work fine - os.rmdir(path) - except FileNotFoundError: # if the folder isn't found - raise FileNotFoundError("pygame.system.get_pref_path folder not created") - except OSError: # if the dir isn't empty (shouldn't happen) - raise OSError("pygame.system.get_pref_path folder already occupied") - - def test_get_pref_locales(self): - locales = pygame.system.get_pref_locales() - - # check type of return first - self.assertIsInstance(locales, list) - for lc in locales: - self.assertIsInstance(lc, dict) - lang = lc["language"] - self.assertIsInstance(lang, str) - - # length of language code should be greater than 1 - self.assertTrue(len(lang) > 1) - - country = lc["country"] - if country is not None: - # country field is optional, but when defined it should be a - # string - self.assertIsInstance(country, str) - - # length of country code should be greater than 1 - self.assertTrue(len(country) > 1) - - # passing args should raise error - for arg in (None, 1, "hello"): - self.assertRaises(TypeError, pygame.system.get_pref_locales, arg) - - def test_get_power_state(self): - power_state = pygame.system.get_power_state() - self.assertIsInstance(power_state, (type(None), pygame.system.PowerState)) - - expected_types = { - "battery_seconds": (type(None), int), - "battery_percent": (type(None), int), - "on_battery": bool, - "no_battery": bool, - "charging": bool, - "charged": bool, - "plugged_in": bool, - "has_battery": bool, - } - - if power_state is not None: - for attr_name in expected_types: - self.assertTrue(hasattr(power_state, attr_name)) - self.assertIsInstance( - getattr(power_state, attr_name), expected_types[attr_name] - ) - - self.assertTrue(power_state.plugged_in == (not power_state.on_battery)) - self.assertTrue( - power_state.has_battery - == (power_state.on_battery or not power_state.no_battery) - ) - - # There should be only one `True` - self.assertEqual( - sum( - [ - power_state.on_battery, - power_state.no_battery, - power_state.charged, - power_state.charging, - ] - ), - 1, - ) - - -if __name__ == "__main__": - unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/__init__.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/__init__.py index 2cbb913..a4994f2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/__init__.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/__init__.py @@ -1,8 +1,10 @@ import os +import pygame import sys import tempfile +import time -import pygame +is_pygame_pkg = __name__.startswith("pygame.tests.") ############################################################################### @@ -21,8 +23,11 @@ def geterror(): ############################################################################### this_dir = os.path.dirname(os.path.abspath(__file__)) -this_dir_parent = os.path.split(this_dir)[0] -trunk_dir = os.path.split(this_dir_parent)[0] +trunk_dir = os.path.split(os.path.split(this_dir)[0])[0] +if is_pygame_pkg: + test_module = "tests" +else: + test_module = "test" def trunk_relative_path(relative): @@ -30,7 +35,7 @@ def trunk_relative_path(relative): def fixture_path(path): - return os.path.join(this_dir_parent, "fixtures", path) + return trunk_relative_path(os.path.join(test_module, "fixtures", path)) def example_path(path): @@ -70,6 +75,22 @@ def rgba_between(value, minimum=0, maximum=255): return value +def combinations(seqs): + """ + + Recipe 496807 from ActiveState Python CookBook + + Non recursive technique for getting all possible combinations of a sequence + of sequences. + + """ + + r = [[]] + for x in seqs: + r = [i + [y] for y in x for i in r] + return r + + def gradient(width, height): """ diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/arrinter.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/arrinter.py index b39b789..626913c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/arrinter.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/arrinter.py @@ -1,7 +1,7 @@ -import ctypes import sys -import unittest +import ctypes from ctypes import * +import unittest __all__ = [ "PAI_CONTIGUOUS", diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/async_sub.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/async_sub.py index 5f34c72..560d377 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/async_sub.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/async_sub.py @@ -7,14 +7,14 @@ Modification of http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/440554 #################################### IMPORTS ################################### -import errno import os import platform import subprocess -import sys -import tempfile +import errno import time +import sys import unittest +import tempfile def geterror(): @@ -86,15 +86,15 @@ if platform.system() == "Windows": return "", c_avail.value, c_message.value except ImportError: - from win32api import TerminateProcess from win32file import ReadFile, WriteFile from win32pipe import PeekNamedPipe + from win32api import TerminateProcess import msvcrt else: - import fcntl + from signal import SIGINT, SIGTERM, SIGKILL import select - from signal import SIGINT, SIGKILL, SIGTERM + import fcntl ################################### CONSTANTS ################################## diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/buftools.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/buftools.py index d9f5342..de1f316 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/buftools.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/buftools.py @@ -3,14 +3,14 @@ Export the Exporter and Importer classes. Class Exporter has configurable shape and strides. Exporter objects -provide a convenient target for unit tests on Pygame objects and functions that -import a new buffer interface. +provide a convenient target for unit tests on Pygame objects and functions +that import a new buffer interface. Class Importer imports a buffer interface with the given PyBUF_* flags. It returns NULL Py_buffer fields as None. The shape, strides, and suboffsets arrays are returned as tuples of ints. All Py_buffer field properties are read-only. This class is useful in comparing exported buffer interfaces -with the actual request. The similar Python builtin memoryview currently +with the actual request. The simular Python builtin memoryview currently does not support configurable PyBUF_* flags. This module contains its own unit tests. When Pygame is installed, these tests @@ -20,33 +20,37 @@ python -m pygame.tests.test_utils.array """ -import ctypes -import operator -import unittest -from functools import reduce - import pygame + +if not pygame.HAVE_NEWBUF: + emsg = "This Pygame build does not support the new buffer protocol" + raise ImportError(emsg) import pygame.newbuffer from pygame.newbuffer import ( - PyBUF_ANY_CONTIGUOUS, - PyBUF_C_CONTIGUOUS, - PyBUF_CONTIG, - PyBUF_CONTIG_RO, - PyBUF_F_CONTIGUOUS, - PyBUF_FORMAT, - PyBUF_FULL, - PyBUF_FULL_RO, - PyBUF_INDIRECT, - PyBUF_ND, - PyBUF_RECORDS, - PyBUF_RECORDS_RO, PyBUF_SIMPLE, + PyBUF_FORMAT, + PyBUF_ND, + PyBUF_WRITABLE, + PyBUF_STRIDES, + PyBUF_C_CONTIGUOUS, + PyBUF_F_CONTIGUOUS, + PyBUF_ANY_CONTIGUOUS, + PyBUF_INDIRECT, PyBUF_STRIDED, PyBUF_STRIDED_RO, - PyBUF_STRIDES, - PyBUF_WRITABLE, + PyBUF_RECORDS, + PyBUF_RECORDS_RO, + PyBUF_FULL, + PyBUF_FULL_RO, + PyBUF_CONTIG, + PyBUF_CONTIG_RO, ) +import unittest +import ctypes +import operator +from functools import reduce + __all__ = ["Exporter", "Importer"] try: @@ -321,7 +325,7 @@ class Importer: return self._view.internal def _to_ssize_tuple(self, addr): - from ctypes import POINTER, c_ssize_t, cast + from ctypes import cast, POINTER, c_ssize_t if addr is None: return None diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/png.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/png.py index d6c2ebc..5d055ea 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/png.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/png.py @@ -44,7 +44,7 @@ # 2006-06-17 Nicko: Reworked into a class, faster interlacing. # 2006-06-17 Johann: Very simple prototype PNG decoder. # 2006-06-17 Nicko: Test suite with various image generators. -# 2006-06-17 Nicko: Alpha-channel, gray-scale, 16-bit/plane support. +# 2006-06-17 Nicko: Alpha-channel, grey-scale, 16-bit/plane support. # 2006-06-15 Johann: Scanline iterator interface for large input files. # 2006-06-09 Johann: Very simple prototype PNG encoder. @@ -61,8 +61,8 @@ Pure Python PNG Reader/Writer This Python module implements support for PNG images (see PNG specification at http://www.w3.org/TR/2003/REC-PNG-20031110/ ). It reads and writes PNG files with all allowable bit depths (1/2/4/8/16/24/32/48/64 -bits per pixel) and color combinations: grayscale (1/2/4/8/16 bit); RGB, -RGBA, LA (grayscale with alpha) with 8/16 bits per channel; color mapped +bits per pixel) and colour combinations: greyscale (1/2/4/8/16 bit); RGB, +RGBA, LA (greyscale with alpha) with 8/16 bits per channel; colour mapped images (1/2/4/8 bit). Adam7 interlacing is supported for reading and writing. A number of optional chunks can be specified (when writing) and understood (when reading): ``tRNS``, ``bKGD``, ``gAMA``. @@ -81,15 +81,15 @@ A note on spelling and terminology ---------------------------------- Generally British English spelling is used in the documentation. So -that's "grayscale" and "color". This not only matches the author's +that's "greyscale" and "colour". This not only matches the author's native language, it's also used by the PNG specification. -The major color models supported by PNG (and hence by PyPNG) are: -grayscale, RGB, grayscale--alpha, RGB--alpha. These are sometimes +The major colour models supported by PNG (and hence by PyPNG) are: +greyscale, RGB, greyscale--alpha, RGB--alpha. These are sometimes referred to using the abbreviations: L, RGB, LA, RGBA. In this case each letter abbreviates a single channel: *L* is for Luminance or Luma or -Lightness which is the channel used in grayscale images; *R*, *G*, *B* stand -for Red, Green, Blue, the components of a color image; *A* stands for +Lightness which is the channel used in greyscale images; *R*, *G*, *B* stand +for Red, Green, Blue, the components of a colour image; *A* stands for Alpha, the opacity channel (used for transparency effects, but higher values are more opaque, so it makes sense to call it opacity). @@ -125,7 +125,7 @@ Flat row flat pixel:: [R,G,B, R,G,B, R,G,B, R,G,B, R,G,B, R,G,B] -The entire image is one single giant sequence of color values. +The entire image is one single giant sequence of colour values. Generally an array will be used (to save space), not a list. Boxed row boxed pixel:: @@ -138,7 +138,7 @@ tuple. A serious memory burn in Python. In all cases the top row comes first, and for each row the pixels are ordered from left-to-right. Within a pixel the values appear in the -order, R-G-B-A (or L-A for grayscale--alpha). +order, R-G-B-A (or L-A for greyscale--alpha). There is a fourth format, mentioned because it is used internally, is close to what lies inside a PNG file itself, and has some support @@ -167,8 +167,8 @@ import math import operator import struct import sys -import warnings import zlib +import warnings from array import array from functools import reduce @@ -220,7 +220,7 @@ except: def interleave_planes(ipixels, apixels, ipsize, apsize): """ - Interleave (color) planes, e.g. RGB + A = RGBA. + Interleave (colour) planes, e.g. RGB + A = RGBA. Return an array of pixels consisting of the `ipsize` elements of data from each pixel in `ipixels` followed by the `apsize` elements of data @@ -307,7 +307,7 @@ class Writer: width=None, height=None, size=None, - grayscale=False, + greyscale=False, alpha=False, bitdepth=8, palette=None, @@ -331,18 +331,18 @@ class Writer: Image size in pixels, as two separate arguments. size Image size (w,h) in pixels, as single argument. - grayscale - Input data is grayscale, not RGB. + greyscale + Input data is greyscale, not RGB. alpha Input data has alpha channel (RGBA or LA). bitdepth Bit depth: from 1 to 16. palette - Create a palette for a color mapped image (color type 3). + Create a palette for a colour mapped image (colour type 3). transparent - Specify a transparent color (create a ``tRNS`` chunk). + Specify a transparent colour (create a ``tRNS`` chunk). background - Specify a default background color (create a ``bKGD`` chunk). + Specify a default background colour (create a ``bKGD`` chunk). gamma Specify a gamma value (create a ``gAMA`` chunk). compression @@ -357,8 +357,8 @@ class Writer: argument. If `size` is used it should be a pair (*width*, *height*). - `grayscale` and `alpha` are booleans that specify whether - an image is grayscale (or color), and whether it has an + `greyscale` and `alpha` are booleans that specify whether + an image is greyscale (or colour), and whether it has an alpha channel (or not). `bitdepth` specifies the bit depth of the source pixel values. @@ -371,27 +371,27 @@ class Writer: precision of the source image. In this case the supplied pixel values will be rescaled to fit the range of the selected bit depth. - The details of which bit depth / color model combinations the + The details of which bit depth / colour model combinations the PNG file format supports directly, are somewhat arcane (refer to the PNG specification for full details). Briefly: - "small" bit depths (1,2,4) are only allowed with grayscale and - color mapped images; color mapped images cannot have bit depth + "small" bit depths (1,2,4) are only allowed with greyscale and + colour mapped images; colour mapped images cannot have bit depth 16. - For color mapped images (in other words, when the `palette` + For colour mapped images (in other words, when the `palette` argument is specified) the `bitdepth` argument must match one of the valid PNG bit depths: 1, 2, 4, or 8. (It is valid to have a PNG image with a palette and an ``sBIT`` chunk, but the meaning is slightly different; it would be awkward to press the `bitdepth` argument into service for this.) - The `palette` option, when specified, causes a color mapped image - to be created: the PNG color type is set to 3; grayscale + The `palette` option, when specified, causes a colour mapped image + to be created: the PNG colour type is set to 3; greyscale must not be set; alpha must not be set; transparent must - not be set; the bit depth must be 1,2,4, or 8. When a color + not be set; the bit depth must be 1,2,4, or 8. When a colour mapped image is created, the pixel values are palette indexes and the `bitdepth` argument specifies the size of these indexes - (not the size of the color values in the palette). + (not the size of the colour values in the palette). The palette argument value should be a sequence of 3- or 4-tuples. 3-tuples specify RGB palette entries; 4-tuples @@ -406,7 +406,7 @@ class Writer: If specified, the `transparent` and `background` parameters must be a tuple with three integer values for red, green, blue, or - a simple integer (or singleton tuple) for a grayscale image. + a simple integer (or singleton tuple) for a greyscale image. If specified, the `gamma` parameter must be a positive number (generally, a float). A ``gAMA`` chunk will be created. Note that @@ -440,7 +440,7 @@ class Writer: """ # At the moment the `planes` argument is ignored; - # its purpose is to act as a placeholder argument so that + # its purpose is to act as a dummy so that # ``Writer(x, y, **info)`` works, where `info` is a dictionary # returned by Reader.read and friends. # Ditto for `colormap`. @@ -455,22 +455,22 @@ class Writer: return False def check_color(c, which): - """Checks that a color argument for transparent or - background options is the right form. Also, "corrects" bare + """Checks that a colour argument for transparent or + background options is the right form. Also "corrects" bare integers to 1-tuples. """ if c is None: return c - if grayscale: + if greyscale: try: l = len(c) except TypeError: c = (c,) if len(c) != 1: - raise ValueError(f"{which} for grayscale must be 1-tuple") + raise ValueError(f"{which} for greyscale must be 1-tuple") if not isinteger(c[0]): - raise ValueError(f"{which} color for grayscale must be integer") + raise ValueError(f"{which} colour for greyscale must be integer") else: if not ( len(c) == 3 @@ -478,7 +478,7 @@ class Writer: and isinteger(c[1]) and isinteger(c[2]) ): - raise ValueError(f"{which} color must be a triple of integers") + raise ValueError(f"{which} colour must be a triple of integers") return c if size: @@ -506,7 +506,7 @@ class Writer: raise ValueError("width and height cannot exceed 2**32-1") if alpha and transparent is not None: - raise ValueError("transparent color not allowed with alpha channel") + raise ValueError("transparent colour not allowed with alpha channel") if bytes_per_sample is not None: warnings.warn( @@ -529,18 +529,18 @@ class Writer: raise ValueError("transparent and palette not compatible") if alpha: raise ValueError("alpha and palette not compatible") - if grayscale: - raise ValueError("grayscale and palette not compatible") + if greyscale: + raise ValueError("greyscale and palette not compatible") else: # No palette, check for sBIT chunk generation. - if alpha or not grayscale: + if alpha or not greyscale: if bitdepth not in (8, 16): targetbitdepth = (8, 16)[bitdepth > 8] self.rescale = (bitdepth, targetbitdepth) bitdepth = targetbitdepth del targetbitdepth else: - assert grayscale + assert greyscale assert not alpha if bitdepth not in (1, 2, 4, 8, 16): if bitdepth > 8: @@ -554,15 +554,15 @@ class Writer: bitdepth = targetbitdepth del targetbitdepth - if bitdepth < 8 and (alpha or not grayscale and not palette): - raise ValueError("bitdepth < 8 only permitted with grayscale or palette") + if bitdepth < 8 and (alpha or not greyscale and not palette): + raise ValueError("bitdepth < 8 only permitted with greyscale or palette") if bitdepth > 8 and palette: raise ValueError("bit depth must be 8 or less for images with palette") transparent = check_color(transparent, "transparent") background = check_color(background, "background") - # It's important that the true boolean values (grayscale, alpha, + # It's important that the true boolean values (greyscale, alpha, # colormap, interlace) are converted to bool because Iverson's # convention is relied upon later on. self.width = width @@ -570,7 +570,7 @@ class Writer: self.transparent = transparent self.background = background self.gamma = gamma - self.grayscale = bool(grayscale) + self.greyscale = bool(greyscale) self.alpha = bool(alpha) self.colormap = bool(palette) self.bitdepth = int(bitdepth) @@ -579,10 +579,10 @@ class Writer: self.interlace = bool(interlace) self.palette = check_palette(palette) - self.color_type = 4 * self.alpha + 2 * (not grayscale) + 1 * self.colormap + self.color_type = 4 * self.alpha + 2 * (not greyscale) + 1 * self.colormap assert self.color_type in (0, 2, 3, 4, 6) - self.color_planes = (3, 1)[self.grayscale or self.colormap] + self.color_planes = (3, 1)[self.greyscale or self.colormap] self.planes = self.color_planes + self.alpha # :todo: fix for bitdepth < 8 self.psize = (self.bitdepth / 8) * self.planes @@ -701,14 +701,14 @@ class Writer: # http://www.w3.org/TR/PNG/#11tRNS if self.transparent is not None: - if self.grayscale: + if self.greyscale: write_chunk(outfile, "tRNS", struct.pack("!1H", *self.transparent)) else: write_chunk(outfile, "tRNS", struct.pack("!3H", *self.transparent)) # http://www.w3.org/TR/PNG/#11bKGD if self.background is not None: - if self.grayscale: + if self.greyscale: write_chunk(outfile, "bKGD", struct.pack("!1H", *self.background)) else: write_chunk(outfile, "bKGD", struct.pack("!3H", *self.background)) @@ -757,7 +757,7 @@ class Writer: oldextend((int(round(factor * x)) for x in sl)) # Build the first row, testing mostly to see if we need to - # change the extend function to cope with NumPy integer types + # changed the extend function to cope with NumPy integer types # (they cause our ordinary definition of extend to fail, so we # wrap it). See # http://code.google.com/p/pypng/issues/detail?id=44 @@ -799,7 +799,7 @@ class Writer: # print(len(data), len(compressed), file= >> sys.stderr) write_chunk(outfile, "IDAT", compressed) # Because of our very witty definition of ``extend``, - # above, we must re-use the same ``data`` object. Hence, + # above, we must reuse the same ``data`` object. Hence # we use ``del`` to empty this one, rather than create a # fresh one (which would be my natural FP instinct). del data[:] @@ -832,7 +832,7 @@ class Writer: which should be in boxed row packed format. Each row should be a sequence of packed bytes. - Technically, this method does work for interlaced images, but it + Technically, this method does work for interlaced images but it is best avoided. For interlaced images, the rows should be presented in the order that they appear in the file. @@ -1057,9 +1057,9 @@ def filter_scanline(type, line, fo, prev=None): ai += 1 if not prev: - # We're on the first line. Some of the filters can be reduced + # We're on the first line. Some of the filters can be reduced # to simpler cases which makes handling the line "off the top" - # of the image simpler. "up" becomes "none"; "paeth" becomes + # of the image simpler. "up" becomes "none"; "paeth" becomes # "left" (non-trivial, but true). "average" needs to be handled # specially. if type == 2: # "up" @@ -1089,31 +1089,31 @@ def from_array(a, mode=None, info={}): .. note : The use of the term *3-dimensional* is for marketing purposes - only. It doesn't actually work. Please bear with us. Meanwhile, + only. It doesn't actually work. Please bear with us. Meanwhile enjoy the complimentary snacks (on request) and please use a 2-dimensional array. Unless they are specified using the *info* parameter, the PNG's height and width are taken from the array size. For a 3 dimensional array the first axis is the height; the second axis is the width; - and the third axis is the channel number. Thus, an RGB image that is + and the third axis is the channel number. Thus an RGB image that is 16 pixels high and 8 wide will use an array that is 16x8x3. For 2 dimensional arrays the first axis is the height, but the second axis is ``width*channels``, so an RGB image that is 16 pixels high and 8 wide will use a 2-dimensional array that is 16x24 (each row will be 8*3==24 sample values). - *mode* is a string that specifies the image color format in a + *mode* is a string that specifies the image colour format in a PIL-style mode. It can be: ``'L'`` - grayscale (1 channel) + greyscale (1 channel) ``'LA'`` - grayscale with alpha (2 channel) + greyscale with alpha (2 channel) ``'RGB'`` - color image (3 channel) + colour image (3 channel) ``'RGBA'`` - color image with alpha (4 channel) + colour image with alpha (4 channel) The mode string can also specify the bit depth (overriding how this function normally derives the bit depth, see below). Appending @@ -1160,7 +1160,7 @@ def from_array(a, mode=None, info={}): Generally anything specified in the *info* dictionary will override any implicit choices that this function would otherwise make, but must match any explicit ones. - For example, if the *info* dictionary has a ``grayscale`` key then + For example, if the *info* dictionary has a ``greyscale`` key then this must be true when mode is ``'L'`` or ``'LA'`` and false when mode is ``'RGB'`` or ``'RGBA'``. """ @@ -1212,11 +1212,11 @@ def from_array(a, mode=None, info={}): except: raise Error("len(a) does not work, supply info['height'] instead.") info["height"] = l - # Color format. - if "grayscale" in info: - if bool(info["grayscale"]) != ("L" in mode): - raise Error("info['grayscale'] should match mode.") - info["grayscale"] = "L" in mode + # Colour format. + if "greyscale" in info: + if bool(info["greyscale"]) != ("L" in mode): + raise Error("info['greyscale'] should match mode.") + info["greyscale"] = "L" in mode if "alpha" in info: if bool(info["alpha"]) != ("A" in mode): raise Error("info['alpha'] should match mode.") @@ -1271,7 +1271,7 @@ def from_array(a, mode=None, info={}): bitdepth = 8 * dtype.itemsize info["bitdepth"] = bitdepth - for thing in "width height bitdepth grayscale alpha".split(): + for thing in "width height bitdepth greyscale alpha".split(): assert thing in info return Image(a, info) @@ -1491,12 +1491,12 @@ class Reader: ) # Filter unit. The stride from one pixel to the corresponding - # byte from the previous scanline. Normally this is the pixel + # byte from the previous previous. Normally this is the pixel # size in bytes, but when this is smaller than 1, the previous # byte is used instead. fu = max(1, self.psize) - # For the first line of a pass, synthesize a fake previous + # For the first line of a pass, synthesize a dummy previous # line. An alternative approach would be to observe that on the # first line 'up' is the same as 'null', 'paeth' is the same # as 'sub', with only 'average' requiring any special case. @@ -1773,16 +1773,16 @@ class Reader: if self.bitdepth not in (1, 2, 4, 8, 16): raise Error("invalid bit depth %d" % self.bitdepth) if self.color_type not in (0, 2, 3, 4, 6): - raise Error("invalid color type %d" % self.color_type) + raise Error("invalid colour type %d" % self.color_type) # Check indexed (palettized) images have 8 or fewer bits - # per pixel; check only indexed or grayscale images have + # per pixel; check only indexed or greyscale images have # fewer than 8 bits per pixel. if (self.color_type & 1 and self.bitdepth > 8) or ( self.bitdepth < 8 and self.color_type not in (0, 3) ): raise FormatError( "Illegal combination of bit depth (%d)" - " and color type (%d)." + " and colour type (%d)." " See http://www.w3.org/TR/2003/REC-PNG-20031110/#table111 ." % (self.bitdepth, self.color_type) ) @@ -1804,13 +1804,13 @@ class Reader: # Derived values # http://www.w3.org/TR/PNG/#6Colour-values colormap = bool(self.color_type & 1) - grayscale = not (self.color_type & 2) + greyscale = not (self.color_type & 2) alpha = bool(self.color_type & 4) - color_planes = (3, 1)[grayscale or colormap] + color_planes = (3, 1)[greyscale or colormap] planes = color_planes + alpha self.colormap = colormap - self.grayscale = grayscale + self.greyscale = greyscale self.alpha = alpha self.color_planes = color_planes self.planes = planes @@ -1861,7 +1861,7 @@ class Reader: else: if self.alpha: raise FormatError( - "tRNS chunk is not valid with color type %d." % self.color_type + "tRNS chunk is not valid with colour type %d." % self.color_type ) try: self.transparent = struct.unpack("!%dH" % self.color_planes, data) @@ -1942,7 +1942,7 @@ class Reader: else: pixels = self.iterboxed(self.iterstraight(raw)) meta = {} - for attr in "grayscale alpha planes bitdepth interlace".split(): + for attr in "greyscale alpha planes bitdepth interlace".split(): meta[attr] = getattr(self, attr) meta["size"] = (self.width, self.height) for attr in "gamma transparent background".split(): @@ -1975,7 +1975,7 @@ class Reader: chunks should have already been processed (for example, by calling the :meth:`preamble` method). All the tuples are the same size: 3-tuples if there is no ``tRNS`` chunk, 4-tuples when - there is a ``tRNS`` chunk. Assumes that the image is color type + there is a ``tRNS`` chunk. Assumes that the image is colour type 3 and therefore a ``PLTE`` chunk is required. If the `alpha` argument is ``'force'`` then an alpha channel is @@ -1983,7 +1983,7 @@ class Reader: """ if not self.plte: - raise FormatError("Required PLTE chunk is missing in color type 3 image.") + raise FormatError("Required PLTE chunk is missing in colour type 3 image.") plte = group(array("B", self.plte), 3) if self.trns or alpha == "force": trns = array("B", self.trns or "") @@ -1995,11 +1995,11 @@ class Reader: """Returns the image data as a direct representation of an ``x * y * planes`` array. This method is intended to remove the need for callers to deal with palettes and transparency - themselves. Images with a palette (color type 3) + themselves. Images with a palette (colour type 3) are converted to RGB or RGBA; images with transparency (a ``tRNS`` chunk) are converted to LA or RGBA as appropriate. When returned in this format the pixel values represent the - color value directly without needing to refer to palettes or + colour value directly without needing to refer to palettes or transparency information. Like the :meth:`read` method this method returns a 4-tuple: @@ -2018,7 +2018,7 @@ class Reader: The *meta* dictionary that is returned reflects the `direct` format and not the original source image. For example, an RGB source image with a ``tRNS`` chunk to represent a transparent - color, will have ``planes=3`` and ``alpha=False`` for the + colour, will have ``planes=3`` and ``alpha=False`` for the source image, but the *meta* dictionary returned by this method will have ``planes=4`` and ``alpha=True`` because an alpha channel is synthesized and added. @@ -2163,8 +2163,8 @@ class Reader: return self._as_rescale(self.asRGBA, 8) def asRGB(self): - """Return image as RGB pixels. RGB color images are passed - through unchanged; grayscales are expanded into RGB + """Return image as RGB pixels. RGB colour images are passed + through unchanged; greyscales are expanded into RGB triplets (there is a small speed overhead for doing this). An alpha channel in the source image will raise an @@ -2173,15 +2173,15 @@ class Reader: The return values are as for the :meth:`read` method except that the *metadata* reflect the returned pixels, not the source image. In particular, for this method - ``metadata['grayscale']`` will be ``False``. + ``metadata['greyscale']`` will be ``False``. """ width, height, pixels, meta = self.asDirect() if meta["alpha"]: raise Error("will not convert image with alpha channel to RGB") - if not meta["grayscale"]: + if not meta["greyscale"]: return width, height, pixels, meta - meta["grayscale"] = False + meta["greyscale"] = False typecode = "BH"[meta["bitdepth"] > 8] def iterrgb(): @@ -2194,17 +2194,17 @@ class Reader: return width, height, iterrgb(), meta def asRGBA(self): - """Return image as RGBA pixels. Grayscales are expanded into + """Return image as RGBA pixels. Greyscales are expanded into RGB triplets; an alpha channel is synthesized if necessary. The return values are as for the :meth:`read` method except that the *metadata* reflect the returned pixels, not the source image. In particular, for this method - ``metadata['grayscale']`` will be ``False``, and + ``metadata['greyscale']`` will be ``False``, and ``metadata['alpha']`` will be ``True``. """ width, height, pixels, meta = self.asDirect() - if meta["alpha"] and not meta["grayscale"]: + if meta["alpha"] and not meta["greyscale"]: return width, height, pixels, meta typecode = "BH"[meta["bitdepth"] > 8] maxval = 2 ** meta["bitdepth"] - 1 @@ -2212,7 +2212,7 @@ class Reader: def newarray(): return array(typecode, [0]) * 4 * width - if meta["alpha"] and meta["grayscale"]: + if meta["alpha"] and meta["greyscale"]: # LA to RGBA def convert(): for row in pixels: @@ -2225,7 +2225,7 @@ class Reader: a[3::4] = row[1::2] yield a - elif meta["grayscale"]: + elif meta["greyscale"]: # L to RGBA def convert(): for row in pixels: @@ -2236,7 +2236,7 @@ class Reader: yield a else: - assert not meta["alpha"] and not meta["grayscale"] + assert not meta["alpha"] and not meta["greyscale"] # RGB to RGBA def convert(): @@ -2248,7 +2248,7 @@ class Reader: yield a meta["alpha"] = True - meta["grayscale"] = False + meta["greyscale"] = False return width, height, convert(), meta @@ -2364,7 +2364,7 @@ class Test(unittest.TestCase): mask = (1 << n) - 1 # Use small chunk_limit so that multiple chunk writing is # tested. Making it a test for Issue 20. - w = Writer(15, 17, grayscale=True, bitdepth=n, chunk_limit=99) + w = Writer(15, 17, greyscale=True, bitdepth=n, chunk_limit=99) f = BytesIO() w.write_array(f, array("B", map(mask.__and__, range(1, 256)))) r = Reader(bytes=f.getvalue()) @@ -2383,7 +2383,7 @@ class Test(unittest.TestCase): def testL2(self): "Also tests asRGB8." - w = Writer(1, 4, grayscale=True, bitdepth=2) + w = Writer(1, 4, greyscale=True, bitdepth=2) f = BytesIO() w.write_array(f, array("B", range(4))) r = Reader(bytes=f.getvalue()) @@ -2409,7 +2409,7 @@ class Test(unittest.TestCase): self.assertEqual(list(pixels), map(list, [a, b, b, c])) def testPtrns(self): - "Test color type 3 and tRNS chunk (and 4-bit palette)." + "Test colour type 3 and tRNS chunk (and 4-bit palette)." a = (50, 99, 50, 50) b = (200, 120, 120, 80) c = (255, 255, 255) @@ -2430,8 +2430,8 @@ class Test(unittest.TestCase): self.assertEqual(map(list, pixels), map(list, flat)) def testRGBtoRGBA(self): - "asRGBA8() on color type 2 source." - # Test for pygame-ce issue 41 + "asRGBA8() on colour type 2 source." "" + # Test for Issue 26 r = Reader(bytes=_pngsuite["basn2c08"]) x, y, pixels, meta = r.asRGBA8() # Test the pixels at row 9 columns 0 and 1. @@ -2439,20 +2439,20 @@ class Test(unittest.TestCase): self.assertEqual(row9[0:8], [0xFF, 0xDF, 0xFF, 0xFF, 0xFF, 0xDE, 0xFF, 0xFF]) def testLtoRGBA(self): - "asRGBA() on gray source." - # Test for pygame-ce issue 75 + "asRGBA() on grey source." "" + # Test for Issue 60 r = Reader(bytes=_pngsuite["basi0g08"]) x, y, pixels, meta = r.asRGBA() row9 = list(list(pixels)[9]) self.assertEqual(row9[0:8], [222, 222, 222, 255, 221, 221, 221, 255]) def testCtrns(self): - "Test color type 2 and tRNS chunk." - # Test for pygame-ce issue 40 + "Test colour type 2 and tRNS chunk." + # Test for Issue 25 r = Reader(bytes=_pngsuite["tbrn2c08"]) x, y, pixels, meta = r.asRGBA8() # I just happen to know that the first pixel is transparent. - # In particular, it should be #7f7f7f00 + # In particular it should be #7f7f7f00 row0 = list(pixels)[0] self.assertEqual(tuple(row0[0:4]), (0x7F, 0x7F, 0x7F, 0x00)) @@ -2486,7 +2486,7 @@ class Test(unittest.TestCase): # we have written is to read it back again. for name, bytes in _pngsuite.items(): - # Only certain color types supported for this test. + # Only certain colour types supported for this test. if name[3:5] not in ["n0", "n2", "n4", "n6"]: continue it = Reader(bytes=bytes) @@ -2497,7 +2497,7 @@ class Test(unittest.TestCase): x=x, y=y, bitdepth=it.bitdepth, - grayscale=it.grayscale, + greyscale=it.greyscale, alpha=it.alpha, transparent=it.transparent, interlace=False, @@ -2511,7 +2511,7 @@ class Test(unittest.TestCase): x=x, y=y, bitdepth=it.bitdepth, - grayscale=it.grayscale, + greyscale=it.greyscale, alpha=it.alpha, transparent=it.transparent, interlace=True, @@ -2534,7 +2534,7 @@ class Test(unittest.TestCase): testWithIO(s, o, do) r = Reader(bytes=o.getvalue()) x, y, pixels, meta = r.read() - self.assertTrue(r.grayscale) + self.assertTrue(r.greyscale) self.assertEqual(r.bitdepth, 2) def testPAMin(self): @@ -2561,19 +2561,19 @@ class Test(unittest.TestCase): r = Reader(bytes=o.getvalue()) x, y, pixels, meta = r.read() self.assertTrue(r.alpha) - self.assertTrue(not r.grayscale) + self.assertTrue(not r.greyscale) self.assertEqual(list(itertools.chain(*pixels)), flat) def testLA4(self): """Create an LA image with bitdepth 4.""" bytes = topngbytes( - "la4.png", [[5, 12]], 1, 1, grayscale=True, alpha=True, bitdepth=4 + "la4.png", [[5, 12]], 1, 1, greyscale=True, alpha=True, bitdepth=4 ) sbit = Reader(bytes=bytes).chunk("sBIT")[1] self.assertEqual(sbit, strtobytes("\x04\x04")) def testPNMsbit(self): - """Test that PNM files can generate an sBIT chunk.""" + """Test that PNM files can generates sBIT chunk.""" def do(): return _main(["testPNMsbit"]) @@ -2591,7 +2591,7 @@ class Test(unittest.TestCase): self.assertEqual(sbit, strtobytes("\x01\x01\x01")) def testLtrns0(self): - """Create grayscale image with tRNS chunk.""" + """Create greyscale image with tRNS chunk.""" return self.helperLtrns(0) def testLtrns1(self): @@ -2602,12 +2602,12 @@ class Test(unittest.TestCase): """Helper used by :meth:`testLtrns*`.""" pixels = zip([0x00, 0x38, 0x4C, 0x54, 0x5C, 0x40, 0x38, 0x00]) o = BytesIO() - w = Writer(8, 8, grayscale=True, bitdepth=1, transparent=transparent) + w = Writer(8, 8, greyscale=True, bitdepth=1, transparent=transparent) w.write_packed(o, pixels) r = Reader(bytes=o.getvalue()) x, y, pixels, meta = r.asDirect() self.assertTrue(meta["alpha"]) - self.assertTrue(meta["grayscale"]) + self.assertTrue(meta["greyscale"]) self.assertEqual(meta["bitdepth"], 1) def testWinfo(self): @@ -2621,9 +2621,9 @@ class Test(unittest.TestCase): def testPackedIter(self): """Test iterator for row when using write_packed. - Indicative for pygame-ce issue 62. + Indicative for Issue 47. """ - w = Writer(16, 2, grayscale=True, alpha=False, bitdepth=1) + w = Writer(16, 2, greyscale=True, alpha=False, bitdepth=1) o = BytesIO() w.write_packed( o, [itertools.chain([0x0A], [0xAA]), itertools.chain([0x0F], [0xFF])] @@ -2763,7 +2763,7 @@ class Test(unittest.TestCase): rows = [map(numpy.uint16, range(0, 0x10000, 0x5555))] b = topngbytes( - "numpyuint16.png", rows, 4, 1, grayscale=True, alpha=False, bitdepth=16 + "numpyuint16.png", rows, 4, 1, greyscale=True, alpha=False, bitdepth=16 ) def testNumpyuint8(self): @@ -2777,7 +2777,7 @@ class Test(unittest.TestCase): rows = [map(numpy.uint8, range(0, 0x100, 0x55))] b = topngbytes( - "numpyuint8.png", rows, 4, 1, grayscale=True, alpha=False, bitdepth=8 + "numpyuint8.png", rows, 4, 1, greyscale=True, alpha=False, bitdepth=8 ) def testNumpybool(self): @@ -2791,7 +2791,7 @@ class Test(unittest.TestCase): rows = [map(numpy.bool, [0, 1])] b = topngbytes( - "numpybool.png", rows, 2, 1, grayscale=True, alpha=False, bitdepth=1 + "numpybool.png", rows, 2, 1, greyscale=True, alpha=False, bitdepth=1 ) def testNumpyarray(self): @@ -2812,8 +2812,8 @@ class Test(unittest.TestCase): def _dehex(s): """Liberally convert from hex string to binary string.""" - import binascii import re + import binascii # Remove all non-hexadecimal digits s = re.sub(r"[^a-fA-F\d]", "", s) @@ -3539,7 +3539,7 @@ def test_suite(options, args): assert w == h # LAn for n < 8 is a special case for which we need to rescale # the data. - if meta["grayscale"] and meta["alpha"] and meta["bitdepth"] < 8: + if meta["greyscale"] and meta["alpha"] and meta["bitdepth"] < 8: factor = 255 // (2 ** meta["bitdepth"] - 1) def rescale(data): @@ -3556,7 +3556,7 @@ def test_suite(options, args): if options.test_size: size = options.test_size options.bitdepth = options.test_depth - options.grayscale = bool(options.test_black) + options.greyscale = bool(options.test_black) kwargs = {} if options.test_red: @@ -3567,10 +3567,10 @@ def test_suite(options, args): kwargs["blue"] = options.test_blue if options.test_alpha: kwargs["alpha"] = options.test_alpha - if options.grayscale: + if options.greyscale: if options.test_red or options.test_green or options.test_blue: raise ValueError( - "cannot specify colors (R, G, B) when grayscale image (black channel, K) is specified" + "cannot specify colours (R, G, B) when greyscale image (black channel, K) is specified" ) kwargs["red"] = options.test_black kwargs["green"] = None @@ -3580,7 +3580,7 @@ def test_suite(options, args): pixels = test_rgba(size, options.bitdepth, **kwargs) else: size, pixels, meta = pngsuite_image(args[0]) - for k in ["bitdepth", "alpha", "grayscale"]: + for k in ["bitdepth", "alpha", "greyscale"]: setattr(options, k, meta[k]) writer = Writer( @@ -3590,7 +3590,7 @@ def test_suite(options, args): transparent=options.transparent, background=options.background, gamma=options.gamma, - grayscale=options.grayscale, + greyscale=options.greyscale, alpha=options.alpha, compression=options.compression, interlace=options.interlace, @@ -3764,8 +3764,8 @@ def write_pnm(file, width, height, pixels, meta): def color_triple(color): """ - Convert a command line color value to a RGB triple of integers. - FIXME: Somewhere we need support for grayscale backgrounds etc. + Convert a command line colour value to a RGB triple of integers. + FIXME: Somewhere we need support for greyscale backgrounds etc. """ if color.startswith("#") and len(color) == 4: return (int(color[1], 16), int(color[2], 16), int(color[3], 16)) @@ -3781,8 +3781,8 @@ def _main(argv): """ # Parse command line arguments - import re from optparse import OptionParser + import re version = "%prog " + re.sub(r"( ?\$|URL: |Rev:)", "", __version__) parser = OptionParser(version=version) @@ -3807,7 +3807,7 @@ def _main(argv): action="store", type="string", metavar="color", - help="mark the specified color (#RRGGBB) as transparent", + help="mark the specified colour (#RRGGBB) as transparent", ) parser.add_option( "-b", @@ -3815,7 +3815,7 @@ def _main(argv): action="store", type="string", metavar="color", - help="save the specified background color", + help="save the specified background colour", ) parser.add_option( "-a", @@ -3893,7 +3893,7 @@ def _main(argv): action="store", type="string", metavar="pattern", - help="test pattern for grayscale image", + help="test pattern for greyscale image", ) parser.add_option( "-d", @@ -3953,12 +3953,12 @@ def _main(argv): infile, ("P5", "P6", "P7") ) # When it comes to the variety of input formats, we do something - # rather rude. Observe that L, LA, RGB, RGBA are the 4 color + # rather rude. Observe that L, LA, RGB, RGBA are the 4 colour # types supported by PNG and that they correspond to 1, 2, 3, 4 # channels respectively. So we use the number of channels in # the source image to determine which one we have. We do not # care about TUPLTYPE. - grayscale = depth <= 2 + greyscale = depth <= 2 pamalpha = depth in (2, 4) supported = (2**x - 1 for x in range(1, 17)) try: @@ -3971,7 +3971,7 @@ def _main(argv): writer = Writer( width, height, - grayscale=grayscale, + greyscale=greyscale, bitdepth=bitdepth, interlace=options.interlace, transparent=options.transparent, diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/run_tests.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/run_tests.py index 64db0ec..69c1abb 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/run_tests.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/run_tests.py @@ -9,32 +9,32 @@ test_runner_mod = test_pkg_name + ".test_utils.test_runner" if is_pygame_pkg: from pygame.tests.test_utils import import_submodule from pygame.tests.test_utils.test_runner import ( - TEST_RESULTS_START, - combine_results, - get_test_results, prepare_test_env, run_test, + combine_results, + get_test_results, + TEST_RESULTS_START, ) else: from test.test_utils import import_submodule from test.test_utils.test_runner import ( - TEST_RESULTS_START, - combine_results, - get_test_results, prepare_test_env, run_test, + combine_results, + get_test_results, + TEST_RESULTS_START, ) +import pygame +import pygame.threads + import os -import random import re import shutil import tempfile import time -from concurrent.futures import ThreadPoolExecutor +import random from pprint import pformat -import pygame - was_run = False @@ -74,7 +74,7 @@ def run(*args, **kwds): A tuple of total number of tests run, dictionary of error information. The dictionary is empty if no errors were recorded. - By default, individual test modules are run in separate subprocesses. This + By default individual test modules are run in separate subprocesses. This recreates normal Pygame usage where pygame.init() and pygame.quit() are called only once per program execution, and avoids unfortunate interactions between test modules. Also, a time limit is placed on test @@ -89,10 +89,10 @@ def run(*args, **kwds): Individual test modules may have a corresponding *_tags.py module, defining a __tags__ attribute, a list of tag strings used to selectively - omit modules from a run. By default, only the 'interactive', 'ignore', and + omit modules from a run. By default only the 'interactive', 'ignore', and 'subprocess_ignore' tags are ignored. 'interactive' is for modules that - take user input, like controller_test.py. 'ignore' and 'subprocess_ignore' for - disabling modules for foreground and subprocess modes respectively. + take user input, like cdrom_test.py. 'ignore' and 'subprocess_ignore' for + for disabling modules for foreground and subprocess modes respectively. These are for disabling tests on optional modules or for experimental modules with known problems. These modules can be run from the console as a Python program. @@ -233,7 +233,7 @@ def run(*args, **kwds): from test.test_utils.async_sub import proc_in_time_or_kill pass_on_args = ["--exclude", ",".join(option_exclude)] + [ - f"--{field}" + "--" + field for field in ("randomize", "incomplete", "unbuffered", "verbosity") if kwds.get(field) ] @@ -251,34 +251,41 @@ def run(*args, **kwds): ), ) - with ThreadPoolExecutor(max_workers=option_multi_thread) as executor: - t = time.time() + if option_multi_thread > 1: - for module, cmd, (return_code, raw_return) in executor.map( - sub_test, test_modules - ): - test_file = f"{os.path.join(test_subdir, module)}.py" - cmd, test_env, working_dir = cmd - - test_results = get_test_results(raw_return) - if test_results: - results.update(test_results) - else: - results[module] = {} - - results[module].update( - { - "return_code": return_code, - "raw_return": raw_return, - "cmd": cmd, - "test_file": test_file, - "test_env": test_env, - "working_dir": working_dir, - "module": module, - } + def tmap(f, args): + return pygame.threads.tmap( + f, args, stop_on_error=False, num_workers=option_multi_thread ) - t = time.time() - t + else: + tmap = map + + t = time.time() + + for module, cmd, (return_code, raw_return) in tmap(sub_test, test_modules): + test_file = f"{os.path.join(test_subdir, module)}.py" + cmd, test_env, working_dir = cmd + + test_results = get_test_results(raw_return) + if test_results: + results.update(test_results) + else: + results[module] = {} + + results[module].update( + { + "return_code": return_code, + "raw_return": raw_return, + "cmd": cmd, + "test_file": test_file, + "test_env": test_env, + "working_dir": working_dir, + "module": module, + } + ) + + t = time.time() - t ########################################################################### # Output Results diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_machinery.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_machinery.py index 068e52d..0531cc2 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_machinery.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_machinery.py @@ -44,7 +44,7 @@ class PygameTestLoader(unittest.TestLoader): TAGS_RE = re.compile(r"\|[tT]ags:(-?[ a-zA-Z,0-9_\n]+)\|", re.M) -class TheTestTags: +class TestTags: def __init__(self): self.memoized = {} self.parent_modules = {} @@ -86,4 +86,4 @@ class TheTestTags: return self.memoized[key] -get_tags = TheTestTags() +get_tags = TestTags() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_runner.py b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_runner.py index 3bf7f91..a19d7b0 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_runner.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/test_utils/test_runner.py @@ -1,5 +1,5 @@ -import os import sys +import os if __name__ == "__main__": pkg_dir = os.path.split(os.path.split(os.path.abspath(__file__))[0])[0] @@ -30,9 +30,9 @@ def prepare_test_env(): main_dir, test_subdir, fake_test_subdir = prepare_test_env() ################################################################################ -# Set the command line options. +# Set the command line options # -# Options are shared with run_tests.py so make sure not to conflict +# options are shared with run_tests.py so make sure not to conflict # in time more will be added here TAG_PAT = r"-?[a-zA-Z0-9_]+" @@ -56,7 +56,7 @@ opt_parser.add_option( "-s", "--usesubprocess", action="store_true", - help="run everything in a single process (default: use no subprocesses)", + help="run everything in a single process " " (default: use no subprocesses)", ) opt_parser.add_option( @@ -240,7 +240,8 @@ TEST_RESULTS_RE = re.compile(_test_re_str, re.DOTALL | re.M) def get_test_results(raw_return): - if test_results := TEST_RESULTS_RE.search(raw_return): + test_results = TEST_RESULTS_RE.search(raw_return) + if test_results: try: return eval(test_results.group(1)) except: @@ -284,17 +285,10 @@ def run_test( print(output.read()) output.seek(0) - # change in way skipped tested counted in Python 3.12.1 only (so far) - # This was changed and then reverted in 3.12.2 - # https://github.com/python/cpython/pull/114994 - tests_run_and_skipped = results.testsRun - if sys.version_info.minor == 12 and sys.version_info.micro == 1: - tests_run_and_skipped += len(results.skipped) - results = { module: { "output": output.getvalue(), - "num_tests": tests_run_and_skipped, + "num_tests": results.testsRun, "num_errors": len(results.errors), "num_failures": len(results.failures), } diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/time_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/time_test.py index 4d21299..95e04f0 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/time_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/time_test.py @@ -1,7 +1,8 @@ -import time +import os +import platform import unittest - import pygame +import time Clock = pygame.time.Clock @@ -9,10 +10,6 @@ Clock = pygame.time.Clock class ClockTypeTest(unittest.TestCase): __tags__ = ["timing"] - def test_clock_alias(self): - """Check if pygame.Clock is present and the correct type.""" - self.assertIs(pygame.Clock, pygame.time.Clock) - def test_construction(self): """Ensure a Clock object can be created""" c = Clock() @@ -68,6 +65,10 @@ class ClockTypeTest(unittest.TestCase): c2 = c.get_time() self.assertAlmostEqual(c1, c2, delta=delta) + @unittest.skipIf(platform.machine() == "s390x", "Fails on s390x") + @unittest.skipIf( + os.environ.get("CI", None), "CI can have variable time slices, slow." + ) def test_get_time(self): # Testing parameters delay = 0.1 # seconds @@ -98,6 +99,10 @@ class ClockTypeTest(unittest.TestCase): ) #'time' module elapsed time converted to milliseconds self.assertAlmostEqual(d0, c1, delta=delta) + @unittest.skipIf(platform.machine() == "s390x", "Fails on s390x") + @unittest.skipIf( + os.environ.get("CI", None), "CI can have variable time slices, slow." + ) def test_tick(self): """Tests time.Clock.tick()""" """ @@ -108,7 +113,8 @@ class ClockTypeTest(unittest.TestCase): """ # Adjust this value to increase the acceptable sleep jitter - epsilon = 1.5 + epsilon = 5 # 1.5 + # Adjust this value to increase the acceptable locked frame-rate jitter epsilon2 = 0.3 # adjust this value to increase the acceptable frame-rate margin @@ -244,121 +250,10 @@ class ClockTypeTest(unittest.TestCase): class TimeModuleTest(unittest.TestCase): __tags__ = ["timing"] - def test_multiple_timers(self): - """ - Test for multiple timers running together, test repeat and dict - posting, test per event timing too - """ - pygame.init() - # other timers in background should not affect current timer - # test different kinds of timers simultaneously. Test repeat, early - # stop with repeat, and stopping timers running on infinite loops. - # test dict and no dict posting - events_tests_dict = { - # each value here is like - # (delay time(ms), event dict, set repeat, early repeat stop) - pygame.event.custom_type(): (20, {}, 3, None), - pygame.event.custom_type(): (13, {1: 2, 3: 1}, 1, None), - pygame.event.custom_type(): (30, {"attr1": 10}, 5, 5), - pygame.event.custom_type(): (15, {"foo": "bar", "spam": "eggs"}, 10, 8), - pygame.event.custom_type(): (16, {}, None, 4), - pygame.event.custom_type(): (12, {"test": 42.26}, None, 6), - pygame.event.custom_type(): (10, {"foo": "spam", "bar": "eggs"}, None, 8), - } - - times = {k: 0.0 for k in events_tests_dict} - counts = {k: 0 for k in events_tests_dict} - - # post events, note start times - for event, (delay, attrs, repeat, _) in events_tests_dict.items(): - if repeat is None: - pygame.time.set_timer(pygame.event.Event(event, attrs), delay) - else: - pygame.time.set_timer(pygame.event.Event(event, attrs), delay, repeat) - times[event] = time.perf_counter() - - # run for 500ms - loop_start = time.perf_counter() - while time.perf_counter() < loop_start + 0.5: - for event in pygame.event.get(): - if event.type in events_tests_dict: - now_time = time.perf_counter() - set_time, set_dict, repeat, stop = events_tests_dict[event.type] - # measure time for each event, should almost match expected time - self.assertAlmostEqual( - (now_time - times[event.type]) * 1000, set_time, delta=4 - ) - - # the dict attribute should be the same reference, if it exists - self.assertIs(event.dict, set_dict) - - times[event.type] = now_time - counts[event.type] += 1 - if counts[event.type] == stop: - # stop event - pygame.time.set_timer(event.type, 0) - - # assert extra events are not created - if stop is None: - if counts[event.type] > repeat: - self.fail("got more events than expected with repeat") - else: - if counts[event.type] > stop: - self.fail("got more events, timer stop did not work") - - # assert events don't come in after the stipulated time - time.sleep(0.5) - for event in pygame.event.get(): - self.assertNotIn(event.type, events_tests_dict) - - for event_type, (_, _, repeat, stop) in events_tests_dict.items(): - # recheck that the counts exactly match, and we don't have lesser - # events than expected - if stop is not None: - self.assertEqual(stop, counts[event_type]) - else: - self.assertEqual(repeat, counts[event_type]) - - pygame.quit() - - def test_timer_wrong_args(self): - for out_of_range_val in (-1, -10, pygame.NUMEVENTS, pygame.NUMEVENTS + 1): - self.assertRaises(ValueError, pygame.time.set_timer, out_of_range_val, 10) - self.assertRaises( - ValueError, pygame.time.set_timer, event=out_of_range_val, millis=10 - ) - - for incorrect_type in ("string", 4 + 3j, [1, 2, 3], {"a": "b"}): - self.assertRaises(TypeError, pygame.time.set_timer, incorrect_type, 15) - self.assertRaises( - TypeError, pygame.time.set_timer, event=incorrect_type, millis=15 - ) - - def test_timer_common_reference(self): - pygame.init() - pygame.event.get() # empty queue - for event in ( - pygame.event.Event(pygame.event.custom_type(), attr=(1, 2, 3, 4)), - pygame.event.Event(pygame.event.custom_type(), dict={"test": "yes"}), - pygame.event.Event(pygame.event.custom_type()), - pygame.event.custom_type(), - ): - pygame.time.set_timer(event, 1, loops=2) - time.sleep(0.005) - events = pygame.event.get(pump=False) - self.assertEqual(len(events), 2) - - if isinstance(event, int): - for ev in events: - self.assertEqual(ev.type, event) - self.assertEqual(ev.dict, {}) - self.assertIsNot(events[0].dict, events[1].dict) - else: - for ev in events: - self.assertEqual(ev.type, event.type) - self.assertIs(ev.dict, event.dict) - pygame.quit() - + @unittest.skipIf(platform.machine() == "s390x", "Fails on s390x") + @unittest.skipIf( + os.environ.get("CI", None), "CI can have variable time slices, slow." + ) def test_delay(self): """Tests time.delay() function.""" millis = 50 # millisecond to wait on each iteration @@ -390,6 +285,10 @@ class TimeModuleTest(unittest.TestCase): # Assert almost equality of the ticking time and time difference self.assertAlmostEqual(ticks_diff, time_diff, delta=delta) + @unittest.skipIf(platform.machine() == "s390x", "Fails on s390x") + @unittest.skipIf( + os.environ.get("CI", None), "CI can have variable time slices, slow." + ) def test_set_timer(self): """Tests time.set_timer()""" """ @@ -477,7 +376,7 @@ class TimeModuleTest(unittest.TestCase): self._type_error_checks(pygame.time.wait) def _wait_delay_check(self, func_to_check, millis, iterations, delta): - """ + """ " call func_to_check(millis) "iterations" times and check each time if function "waited" for given millisecond (+- delta). At the end, take average time for each call (whole_duration/iterations), which should diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/touch_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/touch_test.py index 3b16c3d..259a2c7 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/touch_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/touch_test.py @@ -1,38 +1,36 @@ -import os import unittest - +import os import pygame from pygame._sdl2 import touch from pygame.tests.test_utils import question +has_touchdevice = touch.get_num_devices() > 0 + + class TouchTest(unittest.TestCase): @classmethod def setUpClass(cls): - os.environ["SDL_MOUSE_TOUCH_EVENTS"] = "0" - pygame.init() + pygame.display.init() @classmethod def tearDownClass(cls): - pygame.quit() + pygame.display.quit() def test_num_devices(self): touch.get_num_devices() + @unittest.skipIf(not has_touchdevice, "no touch devices found") def test_get_device(self): - if touch.get_num_devices() > 0: - touch.get_device(0) + touch.get_device(0) def test_get_device__invalid(self): self.assertRaises(pygame.error, touch.get_device, -1234) self.assertRaises(TypeError, touch.get_device, "test") + @unittest.skipIf(not has_touchdevice, "no touch devices found") def test_num_fingers(self): - if touch.get_num_devices() > 0: - if touch.get_device(0) >= 0: - # mice acting as touch devices have negative device IDs - # they also do not work with get_num_fingers() - touch.get_num_fingers(touch.get_device(0)) + touch.get_num_fingers(touch.get_device(0)) def test_num_fingers__invalid(self): self.assertRaises(TypeError, touch.get_num_fingers, "test") @@ -42,31 +40,22 @@ class TouchTest(unittest.TestCase): class TouchInteractiveTest(unittest.TestCase): __tags__ = ["interactive"] - @classmethod - def setUpClass(cls): - # if we don't have a touch device, enable the mouse to act as a - # touch device for the interactive tests. - os.environ["SDL_MOUSE_TOUCH_EVENTS"] = "0" - pygame.init() - if touch.get_num_devices() == 0: - pygame.quit() - os.environ["SDL_MOUSE_TOUCH_EVENTS"] = "1" - pygame.init() - - @classmethod - def tearDownClass(cls): - pygame.quit() - + @unittest.skipIf(not has_touchdevice, "no touch devices found") def test_get_finger(self): """ask for touch input and check the dict""" + pygame.display.init() + pygame.font.init() + os.environ["SDL_VIDEO_WINDOW_POS"] = "50,50" - screen = pygame.display.set_mode((1000, 600)) + screen = pygame.display.set_mode((800, 600)) screen.fill((255, 255, 255)) font = pygame.font.Font(None, 32) instructions_str_1 = "Please place some fingers on your touch device" - instructions_str_2 = "Close the window when finished, and answer the question" + instructions_str_2 = ( + "Close the window when finished, " "and answer the question" + ) inst_1_render = font.render(instructions_str_1, True, pygame.Color("#000000")) inst_2_render = font.render(instructions_str_2, True, pygame.Color("#000000")) @@ -80,10 +69,7 @@ class TouchInteractiveTest(unittest.TestCase): num_devices = pygame._sdl2.touch.get_num_devices() if num_devices > 0: first_device = pygame._sdl2.touch.get_device(0) - if first_device >= 0: - num_fingers = pygame._sdl2.touch.get_num_fingers(first_device) - else: - num_fingers = 1 + num_fingers = pygame._sdl2.touch.get_num_fingers(first_device) if num_fingers > 0: for finger_index in range(0, num_fingers): data = pygame._sdl2.touch.get_finger(first_device, finger_index) @@ -104,6 +90,8 @@ class TouchInteractiveTest(unittest.TestCase): response = question("Does the finger data seem correct?") self.assertTrue(response) + pygame.display.quit() + if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/transform_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/transform_test.py index 72e8c2c..b7c64e9 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/transform_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/transform_test.py @@ -1,25 +1,13 @@ -import itertools +import unittest import os import platform -import unittest + +from pygame.tests import test_utils +from pygame.tests.test_utils import example_path import pygame import pygame.transform from pygame.locals import * -from pygame.tests import test_utils -from pygame.tests.test_utils import example_path - - -def surfaces_have_same_pixels(surf1, surf2): - if surf1.get_size() != surf2.get_size(): - return False - - for row in range(surf1.get_height()): - for col in range(surf1.get_width()): - if surf1.get_at((col, row)) != surf2.get_at((col, row)): - return False - - return True def show_image(s, images=[]): @@ -60,7 +48,7 @@ def threshold( diff_color=(0, 0, 0), change_return=True, ): - """given the color it makes return_surf only have areas with the given color.""" + """given the color it makes return_surf only have areas with the given colour.""" width, height = surf.get_width(), surf.get_height() @@ -93,84 +81,6 @@ def threshold( return similar -def rgb_to_hsl(rgb): - r, g, b = rgb - r, g, b = r / 255.0, g / 255.0, b / 255.0 - max_color = max(r, g, b) - min_color = min(r, g, b) - l = (max_color + min_color) / 2 - if max_color == min_color: - s = h = 0 - else: - if l < 0.5: - s = (max_color - min_color) / (max_color + min_color) - else: - s = (max_color - min_color) / (2.0 - max_color - min_color) - if r == max_color: - h = (g - b) / (max_color - min_color) - elif g == max_color: - h = 2.0 + (b - r) / (max_color - min_color) - else: - h = 4.0 + (r - g) / (max_color - min_color) - h /= 6.0 - h %= 1 - return h, s, l - - -def hsl_to_rgb(hsl): - h, s, l = hsl - if s == 0: - r = g = b = l - else: - - def hue_to_rgb(p, q, t): - if t < 0: - t += 1 - if t > 1: - t -= 1 - if t < 1 / 6: - return p + (q - p) * 6 * t - if t < 1 / 2: - return q - if t < 2 / 3: - return p + (q - p) * (2 / 3 - t) * 6 - return p - - q = l * (1 + s) if l < 0.5 else l + s - l * s - p = 2 * l - q - r = hue_to_rgb(p, q, h + 1 / 3) - g = hue_to_rgb(p, q, h) - b = hue_to_rgb(p, q, h - 1 / 3) - - return int(r * 255), int(g * 255), int(b * 255) - - -def modify_hsl(h, s, l, dh, ds, dl): - if dh: - h += dh - if h > 1: - h -= 1 - elif h < 0: - h += 1 - if ds: - s *= 1 + ds - if s > 1: - s = 1 - elif s < 0: - s = 0 - if dl: - if dl > 0: - l = l * (1 - dl) + dl - else: - l = l * (1 + dl) - if l > 1: - l = 1 - elif l < 0: - l = 0 - - return h, s, l - - class TransformModuleTest(unittest.TestCase): def test_scale__alpha(self): """see if set_alpha information is kept.""" @@ -186,48 +96,10 @@ class TransformModuleTest(unittest.TestCase): self.assertEqual(s.get_alpha(), s3.get_alpha()) self.assertEqual(s.get_alpha(), s2.get_alpha()) - def test_scale__palette(self): - """see if palette information from source is kept. - - Test for newsurf_fromsurf regression reported in - https://github.com/pygame-community/pygame-ce/issues/3463""" - - s = pygame.Surface((32, 32), depth=8) - s.fill("red", [0, 0, 32, 16]) - s.fill("purple", [0, 16, 32, 16]) - self.assertTrue(len(s.get_palette()) > 0) - - s2 = pygame.transform.scale(s, (64, 64)) - self.assertEqual(s.get_palette()[0], s2.get_palette()[0]) - self.assertEqual(s.get_at_mapped((0, 0)), s2.get_at_mapped((0, 0))) - self.assertEqual(s.get_at_mapped((0, 17)), s2.get_at_mapped((0, 35))) - - # Also test with a custom palette to make sure the output doesn't just - # have a default palette. - s = pygame.Surface((32, 32), depth=8) - s.set_palette( - [ - pygame.Color("red"), - pygame.Color("purple"), - pygame.Color("gold"), - pygame.Color("blue"), - pygame.Color("lightgreen"), - ] - ) - s.fill("red", [0, 0, 32, 16]) - s.fill("purple", [0, 16, 32, 16]) - self.assertTrue(len(s.get_palette()) > 0) - - s2 = pygame.transform.scale(s, (64, 64)) - self.assertEqual(s.get_palette()[0], s2.get_palette()[0]) - self.assertEqual(s.get_palette(), s2.get_palette()) - self.assertEqual(s.get_at_mapped((0, 0)), s2.get_at_mapped((0, 0))) - self.assertEqual(s.get_at_mapped((0, 17)), s2.get_at_mapped((0, 35))) - def test_scale__destination(self): """see if the destination surface can be passed in to use.""" - s = pygame.Surface((32, 32), depth=32) + s = pygame.Surface((32, 32)) s2 = pygame.transform.scale(s, (64, 64)) s3 = s2.copy() @@ -248,18 +120,6 @@ class TransformModuleTest(unittest.TestCase): # the wrong size surface is past in. Should raise an error. self.assertRaises(ValueError, pygame.transform.smoothscale, s, (33, 64), s3) - alpha_surf = pygame.Surface((64, 64), pygame.SRCALPHA) - pygame.transform.scale(alpha_surf, (32, 32), s) - - alpha_surf_weird = pygame.Surface( - (64, 64), pygame.SRCALPHA, 32, (0xFF000000, 0xFF0000, 0xFF00, 0xFF) - ) - assert alpha_surf_weird.get_shifts() != alpha_surf.get_shifts() - - self.assertRaises( - ValueError, pygame.transform.scale, alpha_surf_weird, (32, 32), s - ) - def test_scale__vector2(self): s = pygame.Surface((32, 32)) s2 = pygame.transform.scale(s, pygame.Vector2(64, 64)) @@ -302,24 +162,10 @@ class TransformModuleTest(unittest.TestCase): s = pygame.Surface((32, 32)) s.fill((255, 0, 0)) - gray_red = pygame.transform.grayscale(s) - self.assertEqual(pygame.transform.average_color(gray_red)[0], 76) - self.assertEqual(pygame.transform.average_color(gray_red)[1], 76) - self.assertEqual(pygame.transform.average_color(gray_red)[2], 76) - - green_surf = pygame.Surface((32, 32)) - green_surf.fill((0, 255, 0)) - gray_green = pygame.transform.grayscale(green_surf) - self.assertEqual(pygame.transform.average_color(gray_green)[0], 150) - self.assertEqual(pygame.transform.average_color(gray_green)[1], 150) - self.assertEqual(pygame.transform.average_color(gray_green)[2], 150) - - blue_surf = pygame.Surface((32, 32)) - blue_surf.fill((0, 0, 255)) - blue_green = pygame.transform.grayscale(blue_surf) - self.assertEqual(pygame.transform.average_color(blue_green)[0], 29) - self.assertEqual(pygame.transform.average_color(blue_green)[1], 29) - self.assertEqual(pygame.transform.average_color(blue_green)[2], 29) + s2 = pygame.transform.grayscale(s) + self.assertEqual(pygame.transform.average_color(s2)[0], 76) + self.assertEqual(pygame.transform.average_color(s2)[1], 76) + self.assertEqual(pygame.transform.average_color(s2)[2], 76) dest = pygame.Surface((32, 32), depth=32) pygame.transform.grayscale(s, dest) @@ -330,16 +176,16 @@ class TransformModuleTest(unittest.TestCase): dest = pygame.Surface((32, 32), depth=32) s.fill((34, 12, 65)) pygame.transform.grayscale(s, dest) - self.assertEqual(pygame.transform.average_color(dest)[0], 27) - self.assertEqual(pygame.transform.average_color(dest)[1], 27) - self.assertEqual(pygame.transform.average_color(dest)[2], 27) + self.assertEqual(pygame.transform.average_color(dest)[0], 24) + self.assertEqual(pygame.transform.average_color(dest)[1], 24) + self.assertEqual(pygame.transform.average_color(dest)[2], 24) dest = pygame.Surface((32, 32), depth=32) s.fill((123, 123, 123)) pygame.transform.grayscale(s, dest) - self.assertIn(pygame.transform.average_color(dest)[0], [124, 122]) - self.assertIn(pygame.transform.average_color(dest)[1], [124, 122]) - self.assertIn(pygame.transform.average_color(dest)[2], [124, 122]) + self.assertIn(pygame.transform.average_color(dest)[0], [123, 122]) + self.assertIn(pygame.transform.average_color(dest)[1], [123, 122]) + self.assertIn(pygame.transform.average_color(dest)[2], [123, 122]) s = pygame.Surface((32, 32), depth=24) s.fill((255, 0, 0)) @@ -357,261 +203,6 @@ class TransformModuleTest(unittest.TestCase): self.assertEqual(pygame.transform.average_color(dest)[1], 76) self.assertEqual(pygame.transform.average_color(dest)[2], 72) - super_surf = pygame.Surface((64, 64), depth=32) - super_surf.fill((255, 255, 255)) - super_surf.fill((255, 0, 0), pygame.Rect(0, 0, 32, 32)) - sub_surf = super_surf.subsurface(pygame.Rect(0, 0, 32, 32)) - - gray_sub_surf = pygame.transform.grayscale(sub_surf) - self.assertEqual(pygame.transform.average_color(gray_sub_surf)[0], 76) - self.assertEqual(pygame.transform.average_color(gray_sub_surf)[0], 76) - self.assertEqual(pygame.transform.average_color(gray_sub_surf)[0], 76) - - def test_hsl_args(self): - """Ensures transform.hsl() correctly handles incorrect arguments""" - s = pygame.Surface((32, 32)) - invalid_surf_args = [ - None, - 1, - 0, - 1.0, - 0.0, - "1", - [], - {}, - set(), - True, - False, - ] - invalid_hsl_args = [ - None, - "1", - [], - {}, - set(), - ] - invalid_sl_argsv = [ - -2, - -2.0, - 2, - 2.0, - ] - - for arg in invalid_surf_args: - with self.assertRaises(TypeError): - pygame.transform.hsl(arg, 0) - with self.assertRaises(TypeError): - pygame.transform.hsl(s, 0, 0, 0, arg) - for arg in invalid_hsl_args: - with self.assertRaises(TypeError): - pygame.transform.hsl(s, arg) - with self.assertRaises(TypeError): - pygame.transform.hsl(s, 0, arg) - with self.assertRaises(TypeError): - pygame.transform.hsl(s, 0, 0, arg) - for arg in invalid_sl_argsv: - with self.assertRaises(ValueError): - pygame.transform.hsl(s, 0, arg) - with self.assertRaises(ValueError): - pygame.transform.hsl(s, 0, 0, arg) - - # different sized surfaces - s2 = pygame.Surface((31, 32)) - with self.assertRaises(ValueError): - pygame.transform.hsl(s, 0, dest_surface=s2) - - # different depths - s2 = pygame.Surface((32, 32), depth=16) - s3 = pygame.Surface((32, 32), depth=24) - - with self.assertRaises(ValueError): - pygame.transform.hsl(s, 0, dest_surface=s2) - with self.assertRaises(ValueError): - pygame.transform.hsl(s, 0, dest_surface=s3) - - def test_hsl_return_value(self): - """Ensures transform.hsl() returns a Surface""" - sources = [pygame.Surface((32, 32), depth=d) for d in [16, 24, 32]] - destinations = [pygame.Surface((32, 32), depth=d) for d in [16, 24, 32]] - - hsl = pygame.transform.hsl - - for src, dst in zip(sources, destinations): - # test that the return value is a surface - self.assertIsInstance(hsl(src, 1), pygame.Surface) - self.assertIsInstance(hsl(src, 1, 0.2), pygame.Surface) - self.assertIsInstance(hsl(src, 1, 0.2, 0.2), pygame.Surface) - - # test that the return value is a surface when a destination surface is given - self.assertIsInstance(hsl(src, 1, dest_surface=dst), pygame.Surface) - self.assertIsInstance(hsl(src, 1, 0.2, dest_surface=dst), pygame.Surface) - self.assertIsInstance( - hsl(src, 1, 0.2, 0.2, dest_surface=dst), pygame.Surface - ) - - # test that the destination surface is returned - self.assertIs(hsl(src, 1, dest_surface=dst), dst) - self.assertIs(hsl(src, 1, 0.2, dest_surface=dst), dst) - self.assertIs(hsl(src, 1, 0.2, 0.12, dest_surface=dst), dst) - - # test that the returned surface isn't the source surface - self.assertIsNot(hsl(src, 1), src) - self.assertIsNot(hsl(src, 1, 0.2), src) - self.assertIsNot(hsl(src, 1, 0.2, 0.2), src) - - def test_hsl(self): - """Ensures the hsl() function works correctly, meaning it correctly - modifies the hue, saturation, and lightness of a surface.""" - surf = pygame.Surface((1, 1)) - dest = pygame.Surface((1, 1)) - colors = [ - (0, 0, 0), - (255, 255, 255), - (255, 0, 0), - (0, 255, 0), - (0, 0, 255), - (127, 127, 127), - (11, 23, 34), - (1, 0, 1), - ] - - for color in colors: - for h in range(0, 360, 10): - for s in range(0, 100, 10): - for l in range(0, 100, 10): - surf.fill(color) - ns = s / 100.0 - nl = l / 100.0 - - hsl_surf = pygame.transform.hsl(surf, h, ns, nl) - pygame.transform.hsl(surf, h, ns, nl, dest_surface=dest) - - nh = h / 360.0 - modified_hsl = modify_hsl(*rgb_to_hsl(color), nh, ns, nl) - expected_rgb = hsl_to_rgb(modified_hsl) - - # without destination - actual_rgb = hsl_surf.get_at((0, 0)).rgb - for v1, v2 in zip(expected_rgb, actual_rgb): - self.assertAlmostEqual(v1, v2, delta=1) - - # with destination - actual_rgb = dest.get_at((0, 0)).rgb - for v1, v2 in zip(expected_rgb, actual_rgb): - self.assertAlmostEqual(v1, v2, delta=1) - - surf = pygame.Surface((1, 1), flags=pygame.SRCALPHA) - dest = pygame.Surface((1, 1), flags=pygame.SRCALPHA) - - alpha_colors = [ - (0, 0, 0, 0), - (255, 255, 255, 255), - (255, 0, 0, 255), - (0, 255, 0, 255), - (0, 0, 255, 255), - (127, 127, 127, 127), - (11, 23, 34, 255), - (1, 0, 1, 255), - ] - - for color in alpha_colors: - c_a = color[3] - for h in range(0, 360, 10): - for s in range(0, 100, 10): - for l in range(0, 100, 10): - surf.fill(color) - ns = s / 100.0 - nl = l / 100.0 - - hsl_surf = pygame.transform.hsl(surf, h, ns, nl) - pygame.transform.hsl(surf, h, ns, nl, dest_surface=dest) - - nh = h / 360.0 - modified_hsl = modify_hsl(*rgb_to_hsl(color[:3]), nh, ns, nl) - expected_rgb = hsl_to_rgb(modified_hsl) - - # without destination - actual_color = hsl_surf.get_at((0, 0)) - actual_rgb = actual_color.rgb - for v1, v2 in zip(expected_rgb, actual_rgb): - self.assertAlmostEqual(v1, v2, delta=1) - self.assertEqual(c_a, actual_color.a) - - # with destination - actual_color = dest.get_at((0, 0)) - actual_rgb = actual_color.rgb - for v1, v2 in zip(expected_rgb, actual_rgb): - self.assertAlmostEqual(v1, v2, delta=1) - self.assertEqual(c_a, actual_color.a) - - def test_solid_overlay(self): - test_surface = pygame.Surface((20, 20), pygame.SRCALPHA) - test_surface.fill((0, 0, 0, 0)) - pygame.draw.rect(test_surface, (0, 0, 0), (10, 10, 10, 10)) - - surface = pygame.Surface((20, 20), pygame.SRCALPHA) - surface.fill((0, 0, 0, 0)) - pygame.draw.rect(surface, (255, 0, 0), (10, 10, 10, 10)) - - surface = pygame.transform.solid_overlay(surface, (0, 0, 0)) - - for x in range(20): - for y in range(20): - self.assertEqual(surface.get_at((x, y)), test_surface.get_at((x, y))) - - pygame.transform.solid_overlay(surface, (0, 0, 0), surface) - - for x in range(20): - for y in range(20): - self.assertEqual(surface.get_at((x, y)), test_surface.get_at((x, y))) - - test_surface.fill((0, 0, 0, 0)) - pygame.draw.polygon(test_surface, (200, 100, 50), [(0, 0), (4, 4), (4, 2)]) - - surface.fill((0, 0, 0, 0)) - pygame.draw.polygon(surface, (255, 0, 0), [(0, 0), (4, 4), (4, 2)]) - surface = pygame.transform.solid_overlay(surface, (200, 100, 50)) - - for x in range(20): - for y in range(20): - self.assertEqual(surface.get_at((x, y)), test_surface.get_at((x, y))) - - def test_solid_overlay_zero_surfaces(self): - # zero surfaces here means surfaces for which one or both of width and height have a value of 0 - - for size, flags, depth, keep_alpha in itertools.product( - [(0, 0), (0, 1), (0, 42), (1, 0), (42, 0)], # surface size - [pygame.SRCALPHA, 0], # surface flags - [32, 16, None], # surface depth - [True, False], # keep alpha - ): - with self.subTest( - size=size, flags=flags, depth=depth, keep_alpha=keep_alpha - ): - if depth is None: - surface = pygame.Surface(size, flags=flags) - else: - surface = pygame.Surface(size, flags=flags, depth=depth) - - self.assertEqual( - pygame.transform.solid_overlay( - surface, - "white", - keep_alpha=keep_alpha, - ).size, - size, - ) - - def test_grayscale_simd_assumptions(self): - # The grayscale SIMD algorithm relies on the destination surface pitch - # being exactly width * 4 (4 bytes per pixel), for maximum speed. - # This test is here to make sure that assumption is always true. - widths = [1, 5, 6, 23, 54, 233] - for width in widths: - self.assertEqual( - pygame.Surface((width, 1), depth=32).get_pitch(), width * 4 - ) - def test_threshold__honors_third_surface(self): # __doc__ for threshold as of Tue 07/15/2008 @@ -981,35 +572,6 @@ class TransformModuleTest(unittest.TestCase): self.assertEqual(result.get_at((0, 0)), diff_color) - def test_threshold_set_color_24bit(self): - """set_color channels must round-trip correctly on both RGB24 and BGR24 surfaces. - - On little-endian systems, SDL_PIXELFORMAT_RGB24 has Rmask=0xFF (R at byte 0) - and SDL_PIXELFORMAT_BGR24 has Rmask=0xFF0000 (R at byte 2). The old - _set_at_pixels code assumed the_color was always packed 0x00RRGGBB, which - happened to be correct for BGR24 but swapped R and B for RGB24. - """ - masks_and_names = [ - ((0xFF, 0xFF00, 0xFF0000, 0), "RGB24"), - ((0xFF0000, 0xFF00, 0xFF, 0), "BGR24"), - ] - set_color = (255, 0, 0) - for masks, name in masks_and_names: - with self.subTest(format=name): - surf = pygame.Surface((4, 4), depth=24, masks=masks) - surf.fill((0, 0, 0)) - result = pygame.Surface((4, 4), depth=24, masks=masks) - pygame.transform.threshold( - dest_surface=result, - surface=surf, - search_color=(0, 0, 0), - threshold=(1, 1, 1), - set_color=set_color, - set_behavior=1, - inverse_set=True, - ) - self.assertEqual(result.get_at((0, 0))[:3], set_color) - def test_threshold__uneven_colors(self): (w, h) = size = (16, 16) @@ -1252,13 +814,6 @@ class TransformModuleTest(unittest.TestCase): self.assertEqual(dest_surface.get_size(), expected_size) self.assertEqual(dest_surface.get_flags(), expected_flags) - def test_threshold_all_color_types(self): - s1 = pygame.Surface((32, 32), SRCALPHA, 32) - s2 = pygame.Surface((32, 32), SRCALPHA, 32) - - for color in [(0, 255, 0), (255, 0, 0, 0), 0, "blue", pygame.Color("#FFFFFF")]: - pygame.transform.threshold(s1, s2, color, color, color) - def test_laplacian(self): """ """ @@ -1325,39 +880,6 @@ class TransformModuleTest(unittest.TestCase): finally: pygame.display.quit() - def test_laplacian__cross_format(self): - # Regression: laplacian used to map the filtered RGB with the source - # format and write the bytes directly into the destination, which - # swapped channels when the surfaces had the same bytes-per-pixel - # (so the size check passed) but different channel layouts. - SIZE = 32 - # RGBA layout for the source (R at the low byte). - s1 = pygame.Surface( - (SIZE, SIZE), - 0, - 32, - masks=(0xFF, 0xFF00, 0xFF0000, 0xFF000000), - ) - s1.fill((10, 10, 70)) - pygame.draw.line(s1, (255, 0, 0), (3, 10), (20, 20)) - pygame.draw.line(s1, (255, 0, 0), (0, 31), (31, 31)) - - # BGRA layout for the destination — different channel order. - s2 = pygame.Surface( - (SIZE, SIZE), - 0, - 32, - masks=(0xFF0000, 0xFF00, 0xFF, 0xFF000000), - ) - pygame.transform.laplacian(s1, s2) - - # Compare RGB only; the alpha channel is also laplacian-filtered - # and isn't relevant to the channel-order bug under test. - self.assertEqual(s2.get_at((0, 0))[:3], (0, 0, 0)) - self.assertEqual(s2.get_at((3, 10))[:3], (255, 0, 0)) - self.assertEqual(s2.get_at((0, 31))[:3], (255, 0, 0)) - self.assertEqual(s2.get_at((31, 31))[:3], (255, 0, 0)) - def test_average_surfaces(self): """ """ @@ -1588,39 +1110,6 @@ class TransformModuleTest(unittest.TestCase): for pt, color in gradient: self.assertTrue(s.get_at(pt) == color) - def test_rotate_after_convert_regression(self): - # Tests a regression found from https://github.com/pygame-community/pygame-ce/pull/3314 - # Reported in https://github.com/pygame-community/pygame-ce/issues/3463 - - pygame.display.set_mode((1, 1)) - - output1 = pygame.transform.rotate( - pygame.image.load( - os.path.join( - os.path.abspath(os.path.dirname(__file__)), - "../examples/data/alien1.png", - ) - ).convert_alpha(), - 180, - ) - output2 = pygame.transform.rotate( - pygame.image.load( - os.path.join( - os.path.abspath(os.path.dirname(__file__)), - "../examples/data/alien1.png", - ) - ), - 180, - ).convert_alpha() - - for x in range(50): - for y in range(50): - color1 = pygame.Color(output1.get_at((x, y))) - color2 = pygame.Color(output2.get_at((x, y))) - self.assertEqual(color1, color2) - - pygame.quit() - def test_scale2x(self): # __doc__ (as of 2008-06-25) for pygame.transform.scale2x: @@ -1639,10 +1128,6 @@ class TransformModuleTest(unittest.TestCase): self.assertEqual(s2.get_rect().size, (64, 64)) def test_scale2xraw(self): - # Even though transform.scale no longer has a special - # case for 2x upscaling, this test validates that the behavior - # is preserved. - w, h = 32, 32 s = pygame.Surface((w, h), pygame.SRCALPHA, 32) s.fill((0, 0, 0)) @@ -1659,7 +1144,7 @@ class TransformModuleTest(unittest.TestCase): def test_get_smoothscale_backend(self): filter_type = pygame.transform.get_smoothscale_backend() - self.assertTrue(filter_type in ["GENERIC", "MMX", "SSE", "SSE2", "NEON"]) + self.assertTrue(filter_type in ["GENERIC", "MMX", "SSE"]) # It would be nice to test if a non-generic type corresponds to an x86 # processor. But there is no simple test for this. platform.machine() # returns process version specific information, like 'i686'. @@ -1691,9 +1176,8 @@ class TransformModuleTest(unittest.TestCase): pygame.transform.set_smoothscale_backend(1) self.assertRaises(TypeError, change) - # Unsupported type, if possible. - if original_type == "GENERIC": + if original_type != "SSE": def change(): pygame.transform.set_smoothscale_backend("SSE") @@ -1703,14 +1187,6 @@ class TransformModuleTest(unittest.TestCase): filter_type = pygame.transform.get_smoothscale_backend() self.assertEqual(filter_type, original_type) - try: - with self.assertWarns(DeprecationWarning): - pygame.transform.set_smoothscale_backend("MMX") - with self.assertWarns(DeprecationWarning): - pygame.transform.set_smoothscale_backend("SSE") - except ValueError: - pass # Backends not supported on this CPU, also valid - def test_chop(self): original_surface = pygame.Surface((20, 20)) pygame.draw.rect(original_surface, (255, 0, 0), (0, 0, 10, 10)) @@ -1795,105 +1271,6 @@ class TransformModuleTest(unittest.TestCase): self.assertEqual(s1.get_rect(), pygame.Rect(0, 0, 0, 0)) self.assertEqual(s2.get_rect(), pygame.Rect(0, 0, 0, 0)) - def test_rotozoom_keeps_colorkey(self): - image = pygame.Surface((64, 64)) - image.set_colorkey("black") - pygame.draw.circle(image, "red", (32, 32), 32, width=0) - - no_rot = pygame.transform.rotozoom(image, 0, 1.1) - self.assertEqual(image.get_colorkey(), no_rot.get_colorkey()) - - with_rot = pygame.transform.rotozoom(image, 5, 1.1) - self.assertEqual(image.get_colorkey(), with_rot.get_colorkey()) - - def test_invert(self): - surface = pygame.Surface((10, 10), depth=32) - - surface.fill((255, 0, 0)) - surface = pygame.transform.invert(surface) - self.assertEqual(surface.get_at((4, 4)), (0, 255, 255, 255)) - - surface.fill((200, 0, 45)) - surface = pygame.transform.invert(surface) - self.assertEqual(surface.get_at((4, 4)), (55, 255, 210, 255)) - - surface.fill((38, 201, 12)) - surface = pygame.transform.invert(surface) - self.assertEqual(surface.get_at((4, 4)), (217, 54, 243, 255)) - - surface.fill((39, 210, 30)) - surface = pygame.transform.invert(surface) - self.assertEqual(surface.get_at((4, 4)), (216, 45, 225, 255)) - - surface.fill((255, 0, 0)) - pygame.transform.invert(surface, surface) - self.assertEqual(surface.get_at((4, 4)), (0, 255, 255, 255)) - - surface.fill((200, 0, 45)) - pygame.transform.invert(surface, surface) - self.assertEqual(surface.get_at((4, 4)), (55, 255, 210, 255)) - - surface.fill((38, 201, 12)) - pygame.transform.invert(surface, surface) - self.assertEqual(surface.get_at((4, 4)), (217, 54, 243, 255)) - - surface.fill((39, 210, 30)) - pygame.transform.invert(surface, surface) - self.assertEqual(surface.get_at((4, 4)), (216, 45, 225, 255)) - - self.assertRaises( - ValueError, pygame.transform.invert, surface, pygame.Surface((100, 100)) - ) - self.assertRaises( - ValueError, pygame.transform.invert, surface, pygame.Surface((5, 5)) - ) - self.assertRaises( - ValueError, - pygame.transform.invert, - surface, - pygame.Surface((10, 10), depth=24), - ) - self.assertRaises( - ValueError, - pygame.transform.invert, - surface, - pygame.Surface((10, 10), depth=16), - ) - self.assertRaises( - ValueError, - pygame.transform.invert, - surface, - pygame.Surface((10, 10), depth=8), - ) - - def test_invert__palette(self): - """see if palette information from source is kept. - - Test for newsurf_fromsurf regression reported in - https://github.com/pygame-community/pygame-ce/issues/3463""" - - s = pygame.Surface((32, 32), depth=8) - s.set_palette([pygame.Color("orange") for _ in range(256)]) - s.set_palette( - [ - pygame.Color("red"), - pygame.Color("purple"), - pygame.Color("gold"), - pygame.Color("blue"), - pygame.Color("lightgreen"), - ] - ) - s.fill("red", [0, 0, 32, 16]) - s.fill("blue", [0, 16, 32, 16]) - self.assertTrue(len(s.get_palette()) > 0) - - s2 = pygame.transform.invert(s) - self.assertEqual(s.get_palette()[0], s2.get_palette()[0]) - self.assertEqual(s.get_palette(), s2.get_palette()) - - self.assertEqual(s2.get_at((0, 0)), pygame.Color("lightgreen")) - self.assertEqual(s2.get_at((0, 17)), pygame.Color("gold")) - def test_smoothscale(self): """Tests the stated boundaries, sizing, and color blending of smoothscale function""" # __doc__ (as of 2008-08-02) for pygame.transform.smoothscale: @@ -1960,42 +1337,6 @@ class TransformModuleTest(unittest.TestCase): ) self.assertEqual(smaller_surface.get_size(), (k, 1)) - def test_pixelate(self): - """Test pygame.transform.pixelate""" - # test that pixelating the original with a pixel_size of 1 yields the original back - data_fname = example_path("data") - path = os.path.join(data_fname, "alien3.png") - image = pygame.image.load(path) # Get an indexed surface. - - no_change = pygame.transform.pixelate(image, 1) - - self.assertTrue(surfaces_have_same_pixels(image, no_change)) - - # test that pixelating a square image with a pixel_size equal to the side length - # yields a surface of a single color, which is the average of the surf - square = pygame.transform.scale(image, (50, 50)) - square_pixelated = pygame.transform.pixelate(square, 50) - square_resized = pygame.transform.scale( - pygame.transform.scale(square, (1, 1)), square.get_size() - ) - - self.assertTrue(surfaces_have_same_pixels(square_pixelated, square_resized)) - - # test a variety of arguments raise an exception - for arg in (0, -1): - with self.assertRaises(ValueError, msg=f"Running with pixel_size = {arg}"): - pygame.transform.pixelate(image, arg) - - for arg in (-1_000_000_000_000_000_000, 1_000_000_000_000_000_000): - with self.assertRaises( - OverflowError, msg=f"Running with pixel_size = {arg}" - ): - pygame.transform.pixelate(image, arg) - - for arg in ("one", 1.0, None): - with self.assertRaises(TypeError, msg=f"Running with pixel_size = {arg}"): - pygame.transform.pixelate(image, arg) - class TransformDisplayModuleTest(unittest.TestCase): def setUp(self): @@ -2005,146 +1346,9 @@ class TransformDisplayModuleTest(unittest.TestCase): def tearDown(self): pygame.display.quit() - def test_blur_indexed_surface(self): - data_fname = example_path("data") - path = os.path.join(data_fname, "alien3.png") - sf = pygame.image.load(path) # Get an indexed surface. - - self.assertRaises(ValueError, lambda: pygame.transform.box_blur(sf, 10)) - self.assertRaises(ValueError, lambda: pygame.transform.gaussian_blur(sf, 10)) - - def test_blur_in_place(self): - # When source and destination surfaces are the same, - # A ValueError should be raised. - - data_fname = example_path("data") - path = os.path.join(data_fname, "peppers3.tif") - sf = pygame.image.load(path) - sub1 = sf.subsurface((0, 0, 128, 128)) - sub2 = sf.subsurface((20, 20, 128, 128)) - - self.assertRaises( - ValueError, lambda: pygame.transform.box_blur(sf, 10, dest_surface=sf) - ) - self.assertRaises( - ValueError, lambda: pygame.transform.box_blur(sub1, 10, dest_surface=sub2) - ) - self.assertRaises( - ValueError, lambda: pygame.transform.gaussian_blur(sf, 10, dest_surface=sf) - ) - self.assertRaises( - ValueError, - lambda: pygame.transform.gaussian_blur(sub1, 10, dest_surface=sub2), - ) - - def test_box_blur(self): - data1 = { - (1, 29): (67, 58, 26, 255), - (47, 66): (132, 124, 60, 255), - (84, 103): (139, 87, 51, 255), - (131, 140): (159, 133, 74, 255), - (158, 177): (161, 164, 81, 255), - (195, 214): (168, 137, 71, 255), - (232, 251): (130, 122, 67, 255), - (269, 280): (122, 159, 96, 255), - (306, 325): (113, 156, 84, 255), - (353, 362): (114, 152, 74, 255), - (380, 399): (107, 123, 58, 255), - (417, 436): (123, 90, 53, 255), - (458, 473): (146, 68, 52, 255), - (491, 510): (65, 36, 29, 255), - } - data2 = { - (1, 29): (67, 58, 26, 255), - (47, 66): (132, 124, 60, 255), - (84, 103): (139, 87, 51, 255), - (131, 140): (159, 133, 74, 255), - (158, 177): (161, 164, 81, 255), - (195, 214): (168, 137, 71, 255), - (232, 251): (130, 122, 67, 255), - (269, 280): (122, 159, 96, 255), - (306, 325): (113, 156, 84, 255), - (353, 362): (114, 152, 74, 255), - (380, 399): (107, 123, 58, 255), - (417, 436): (123, 90, 53, 255), - (458, 473): (146, 68, 52, 255), - (491, 510): (65, 36, 29, 255), - } - - data_fname = example_path("data") - path = os.path.join(data_fname, "peppers3.tif") - sf = pygame.image.load(path).convert() - - sf_b1 = pygame.transform.box_blur(sf, 50) - for pos in data1: - self.assertTrue(sf_b1.get_at(pos) == data1[pos]) - - sf_b2 = pygame.transform.box_blur(sf, 50, repeat_edge_pixels=False) - for pos in data2: - self.assertTrue(sf_b2.get_at(pos) == data2[pos]) - - def test_gaussian_blur(self): - data1 = { - (10, 49): (74, 67, 32, 255), - (47, 66): (112, 93, 47, 255), - (84, 103): (141, 104, 57, 255), - (121, 140): (153, 118, 64, 255), - (148, 177): (161, 140, 73, 255), - (195, 214): (162, 137, 72, 255), - (232, 21): (124, 50, 35, 255), - (269, 288): (123, 146, 83, 255), - (306, 325): (118, 154, 85, 255), - (343, 362): (114, 141, 73, 255), - (384, 379): (114, 116, 61, 255), - (417, 436): (121, 78, 47, 255), - (454, 473): (107, 54, 39, 255), - (491, 510): (57, 28, 22, 255), - } - data2 = { - (10, 49): (74, 67, 32, 255), - (47, 66): (112, 93, 47, 255), - (84, 103): (141, 104, 57, 255), - (121, 140): (153, 118, 64, 255), - (148, 177): (161, 140, 73, 255), - (195, 214): (162, 137, 72, 255), - (232, 21): (124, 50, 35, 255), - (269, 288): (123, 146, 83, 255), - (306, 325): (118, 154, 85, 255), - (343, 362): (114, 141, 73, 255), - (384, 379): (114, 116, 61, 255), - (417, 436): (121, 78, 47, 255), - (454, 473): (107, 54, 39, 255), - (491, 510): (57, 28, 22, 255), - } - - data_fname = example_path("data") - path = os.path.join(data_fname, "peppers3.tif") - sf = pygame.image.load(path).convert() - - sf_b1 = pygame.transform.gaussian_blur(sf, 50) - for pos in data1: - self.assertTrue(sf_b1.get_at(pos) == data1[pos]) - - sf_b2 = pygame.transform.gaussian_blur(sf, 50, repeat_edge_pixels=False) - for pos in data2: - self.assertTrue(sf_b2.get_at(pos) == data2[pos]) - - def test_blur_zero_size_surface(self): - surface = pygame.Surface((0, 0)) - self.assertEqual(pygame.transform.box_blur(surface, 3).get_size(), (0, 0)) - self.assertEqual(pygame.transform.gaussian_blur(surface, 3).get_size(), (0, 0)) - - surface = pygame.Surface((20, 0)) - self.assertEqual(pygame.transform.box_blur(surface, 3).get_size(), (20, 0)) - self.assertEqual(pygame.transform.gaussian_blur(surface, 3).get_size(), (20, 0)) - - surface = pygame.Surface((0, 20)) - self.assertEqual(pygame.transform.box_blur(surface, 3).get_size(), (0, 20)) - self.assertEqual(pygame.transform.gaussian_blur(surface, 3).get_size(), (0, 20)) - def test_flip(self): """honors the set_color key on the returned surface from flip.""" - image_loaded = pygame.image.load(example_path("data/chimp.webp")) + image_loaded = pygame.image.load(example_path("data/chimp.png")) image = pygame.Surface(image_loaded.get_size(), 0, 32) image.blit(image_loaded, (0, 0)) @@ -2188,7 +1392,7 @@ class TransformDisplayModuleTest(unittest.TestCase): def test_flip_alpha(self): """returns a surface with the same properties as the input.""" - image_loaded = pygame.image.load(example_path("data/chimp.webp")) + image_loaded = pygame.image.load(example_path("data/chimp.png")) image_alpha = pygame.Surface(image_loaded.get_size(), pygame.SRCALPHA, 32) image_alpha.blit(image_loaded, (0, 0)) @@ -2211,22 +1415,6 @@ class TransformDisplayModuleTest(unittest.TestCase): self.assertEqual(surf.get_at((0, 0)), surf2.get_at((0, 0))) self.assertEqual(surf2.get_at((0, 0)), (255, 0, 0, 255)) - def test_unwanted_rle_not_added(self): - surf = pygame.Surface((16, 16)) - surf.fill((255, 0, 0)) - surf.set_colorkey((0, 0, 0)) - surf.set_alpha(64) - - # scale it to the same size (size doesn't matter here) - scaled_surf = pygame.transform.scale(surf, (16, 16)) - pygame.Surface((100, 100)).blit(scaled_surf, (0, 0)) - - self.assertEqual( - surf.get_flags() & pygame.RLEACCEL, - scaled_surf.get_flags() & pygame.RLEACCEL, - ) - self.assertEqual(scaled_surf.get_at((8, 8)), (255, 0, 0, 255)) - if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/typing_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/typing_test.py deleted file mode 100644 index 46fd4d2..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/typing_test.py +++ /dev/null @@ -1,26 +0,0 @@ -import unittest - -# A basic unit test to test that pygame.typing can import in python code, and -# the documented attributes are accessible. -# More rigorous testing needs mypy and is therefore implemented in the stubs -# directory. -TYPING_PUBLIC_ATTRS = [ - "RectLike", - "SequenceLike", - "FileLike", - "ColorLike", - "Point", - "IntPoint", -] - - -class TypingTest(unittest.TestCase): - def test_typing_has_attrs(self): - import pygame.typing - - for i in TYPING_PUBLIC_ATTRS: - self.assertTrue(hasattr(pygame.typing, i)) - - -if __name__ == "__main__": - unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/version_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/version_test.py index d03f68d..ba0bb3d 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/version_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/version_test.py @@ -1,29 +1,47 @@ import os import unittest -from importlib.metadata import version -import pygame pg_header = os.path.join("src_c", "include", "_pygame.h") class VersionTest(unittest.TestCase): - def test_vernum_obj(self): - major, minor, patch = map(int, pygame.version.ver.split(".")[:3]) - self.assertEqual(pygame.version.vernum.major, major) - self.assertEqual(pygame.version.vernum[0], major) - self.assertEqual(pygame.version.vernum.minor, minor) - self.assertEqual(pygame.version.vernum[1], minor) - self.assertEqual(pygame.version.vernum.patch, patch) - self.assertEqual(pygame.version.vernum[2], patch) + @unittest.skipIf( + not os.path.isfile(pg_header), "Skipping because we cannot find _pygame.h" + ) + def test_pg_version_consistency(self): + from pygame import version + + pgh_major = -1 + pgh_minor = -1 + pgh_patch = -1 + import re + + major_exp_search = re.compile(r"define\s+PG_MAJOR_VERSION\s+([0-9]+)").search + minor_exp_search = re.compile(r"define\s+PG_MINOR_VERSION\s+([0-9]+)").search + patch_exp_search = re.compile(r"define\s+PG_PATCH_VERSION\s+([0-9]+)").search + with open(pg_header) as f: + for line in f: + if pgh_major == -1: + m = major_exp_search(line) + if m: + pgh_major = int(m.group(1)) + if pgh_minor == -1: + m = minor_exp_search(line) + if m: + pgh_minor = int(m.group(1)) + if pgh_patch == -1: + m = patch_exp_search(line) + if m: + pgh_patch = int(m.group(1)) + self.assertEqual(pgh_major, version.vernum[0]) + self.assertEqual(pgh_minor, version.vernum[1]) + self.assertEqual(pgh_patch, version.vernum[2]) def test_sdl_version(self): - self.assertEqual(len(pygame.version.SDL), 3) - self.assertEqual(tuple(pygame.version.SDL), pygame.get_sdl_version()) + from pygame import version - def test_installed_version_and_dunder(self): - self.assertEqual(pygame.__version__, pygame.version.ver) - self.assertEqual(pygame.__version__, version("pygame-ce")) + self.assertEqual(len(version.SDL), 3) if __name__ == "__main__": diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/video_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/video_test.py index 30ee471..55ef414 100644 --- a/.venv/lib/python3.14/site-packages/pygame/tests/video_test.py +++ b/.venv/lib/python3.14/site-packages/pygame/tests/video_test.py @@ -1,11 +1,8 @@ -import platform -import sys import unittest - +import sys import pygame -from pygame._sdl2 import video -IS_PYPY = "PyPy" == platform.python_implementation() +from pygame._sdl2 import video class VideoModuleTest(unittest.TestCase): @@ -24,30 +21,6 @@ class VideoModuleTest(unittest.TestCase): renderer.set_viewport(rect) self.assertEqual(renderer.get_viewport(), (0, 0, 1920, 1080)) - def test_logical_window_mapping(self): - window = video.Window(title=self.default_caption, size=(100, 100)) - renderer = video.Renderer(window=window) - renderer.logical_size = (10, 10) - - self.assertEqual(renderer.coordinates_to_window((10, 10)), (100, 100)) - self.assertEqual(renderer.coordinates_from_window((100, 100)), (10, 10)) - with self.assertRaises(TypeError): - renderer.coordinates_to_window(42, 42) - with self.assertRaises(TypeError): - renderer.coordinates_from_window(42, 42) - - @unittest.skipIf(IS_PYPY, "PyPy doesn't have sys.getrefcount") - def test_renderer_to_surface_refcount(self): - """Make sure to_surface doesn't leak memory due to reference counting.""" - window = video.Window(title=self.default_caption, size=(800, 600)) - renderer = video.Renderer(window=window) - surface = pygame.Surface(window.size) - - # directly getting a refcount returns the actual refcount - # as opposed to using an intermediate variable where it's 1 more than expected - self.assertEqual(sys.getrefcount(renderer.to_surface()), 1) - self.assertEqual(sys.getrefcount(renderer.to_surface(surface=surface)), 2) - if __name__ == "__main__": unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/tests/window_test.py b/.venv/lib/python3.14/site-packages/pygame/tests/window_test.py deleted file mode 100644 index 42f8e94..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/tests/window_test.py +++ /dev/null @@ -1,461 +0,0 @@ -import os -import platform -import unittest - -import pygame -from pygame import Window -from pygame.version import SDL - -pygame.init() - - -IS_PYPY = "PyPy" == platform.python_implementation() - -pygame.display.init() -is_wayland = pygame.display.get_driver() == "wayland" -pygame.display.quit() - - -class WindowTypeTest(unittest.TestCase): - DEFAULT_TITLE = "pygame window" - - def setUp(self): - self.win = Window() - - # Used to check the presence and set-ability of boolean attributes without - # testing the results of the actions, since the results are not propagated - # by the NULL videodriver on CI for some things. - def bool_attr_test(self, attr): - setattr(self.win, attr, True) - setattr(self.win, attr, False) - setattr(self.win, attr, "a truthy string") - setattr(self.win, attr, "") - setattr(self.win, attr, 17) - self.assertIsInstance(getattr(self.win, attr), bool) - - def test_grab_mouse_keyboard(self): - self.bool_attr_test("grab_mouse") - self.bool_attr_test("grab_keyboard") - - self.win.grab_mouse = True - self.assertTrue(self.win.grab_mouse) - self.win.grab_mouse = False - self.assertFalse(self.win.grab_mouse) - - self.win.grab_keyboard = True - self.assertTrue(self.win.grab_keyboard) - self.win.grab_keyboard = False - self.assertFalse(self.win.grab_keyboard) - - def test_mouse_keyboard_grabbed(self): - self.assertIsInstance(getattr(self.win, "mouse_grabbed"), bool) - self.assertIsInstance(getattr(self.win, "keyboard_grabbed"), bool) - self.assertRaises( - AttributeError, lambda: setattr(self.win, "mouse_grabbed", False) - ) - self.assertRaises( - AttributeError, lambda: setattr(self.win, "keyboard_grabbed", False) - ) - - def test_title(self): - self.assertEqual(self.win.title, self.DEFAULT_TITLE) - - title = "Hello_World你好世界こにじわ" - self.win.title = title - self.assertEqual(self.win.title, title) - - def test_resizable(self): - self.bool_attr_test("resizable") - - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires the SDL_VIDEODRIVER to be a non-null value", - ) - def test_resizable_set(self): - self.win.resizable = True - self.assertTrue(self.win.resizable) - self.win.resizable = False - self.assertFalse(self.win.resizable) - - def test_borderless(self): - self.bool_attr_test("borderless") - - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires the SDL_VIDEODRIVER to be a non-null value", - ) - def test_borderless_set(self): - self.win.borderless = True - self.assertTrue(self.win.borderless) - self.win.borderless = False - self.assertFalse(self.win.borderless) - - def test_always_on_top(self): - self.bool_attr_test("always_on_top") - - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires the SDL_VIDEODRIVER to be a non-null value", - ) - @unittest.skipIf(is_wayland, "not supported on wayland") - def test_always_on_top_set(self): - self.win.always_on_top = True - self.assertTrue(self.win.always_on_top) - self.win.always_on_top = False - self.assertFalse(self.win.always_on_top) - - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires SDL_VIDEODRIVER to be a non-null value", - ) - def test_mouse_rect(self): - self.win.mouse_rect = None - self.assertIsNone(self.win.mouse_rect) - - TEST_MOUSE_RECT = (10, 10, 123, 456) - self.win.mouse_rect = TEST_MOUSE_RECT - self.assertIsInstance(self.win.mouse_rect, pygame.Rect) - self.assertTupleEqual(tuple(self.win.mouse_rect), TEST_MOUSE_RECT) - - self.assertRaises( - TypeError, lambda: setattr(self.win, "mouse_rect", "Incorrect type") - ) - - # clean the status - self.win.mouse_rect = None - - def test_size(self): - self.win.size = (1280, 720) - self.assertTupleEqual(self.win.size, (1280, 720)) - - self.assertRaises(ValueError, lambda: setattr(self.win, "size", (-1, 10))) - self.assertRaises(ValueError, lambda: setattr(self.win, "size", (1, -10))) - self.assertRaises(ValueError, lambda: setattr(self.win, "size", (-1, -10))) - self.assertRaises(ValueError, lambda: setattr(self.win, "size", (0, 0))) - - # test set size when init - # On Windows, if SDL <= 2.0.22, this test fails - # This bug have been fixed in SDL 2.24.0 - if SDL > (2, 0, 22): - win = Window(size=(12, 34)) - self.assertTupleEqual((12, 34), win.size) - win.destroy() - - self.assertRaises(ValueError, lambda: Window(size=(-1, 0))) - - self.win.size = (640, 480) - - @unittest.skipIf(is_wayland, "not supported on wayland") - def test_position(self): - new_pos = (self.win.position[0] + 20, self.win.position[1] + 10) - self.win.position = new_pos - self.assertTupleEqual(self.win.position, new_pos) - - self.win.position = pygame.WINDOWPOS_CENTERED - - # raise TypeError if input is some random number instead of flag - self.assertRaises(TypeError, lambda: setattr(self.win, "position", 123)) - - # test set position when init - win = Window(position=new_pos) - self.assertTupleEqual(new_pos, win.position) - win.destroy() - - self.assertRaises(TypeError, lambda: Window(position=123)) - - def test_maximum_size(self): - # Use a new window to prevent being influenced by other tests - self.win = Window() - - self.win.maximum_size = (50, 50) - self.assertTupleEqual(self.win.maximum_size, (50, 50)) - - # size should be limited to the maximum_size - self.assertTupleEqual(self.win.size, (50, 50)) - - self.win.size = (640, 480) - # size should not larger than maximum_size - self.assertTupleEqual(self.win.size, (50, 50)) - - if SDL.major >= 3: - # This part should pass in SDL3 - self.win.maximum_size = (0, 0) # remove the size limit - self.win.size = (640, 480) - self.assertTupleEqual(self.win.size, (640, 480)) - - self.assertRaises( - ValueError, lambda: setattr(self.win, "maximum_size", (-1, -1)) - ) - self.assertRaises( - TypeError, lambda: setattr(self.win, "maximum_size", "placeholder_str") - ) - - def test_minimum_size(self): - # Use a new window to prevent being influenced by other tests - self.win = Window() - - self.win.minimum_size = (700, 700) - self.assertTupleEqual(self.win.minimum_size, (700, 700)) - - # size should be limited to the minimum_size - self.assertTupleEqual(self.win.size, (700, 700)) - - self.win.size = (640, 480) - # size should not small than minimum_size - self.assertTupleEqual(self.win.size, (700, 700)) - - if SDL.major >= 3: - # This part should pass in SDL3 - self.win.minimum_size = (0, 0) # remove the size limit - self.win.size = (640, 480) - self.assertTupleEqual(self.win.size, (640, 480)) - - self.assertRaises( - ValueError, lambda: setattr(self.win, "minimum_size", (-1, -1)) - ) - self.assertRaises( - TypeError, lambda: setattr(self.win, "minimum_size", "null_str") - ) - - def test_min_size_interact_with_max_size(self): - # Use a new window to prevent being influenced by other tests - self.win = Window() - - self.win.maximum_size = (100, 100) - # min size should not larger than max size - self.assertRaises( - ValueError, lambda: setattr(self.win, "minimum_size", (200, 200)) - ) - - self.win.minimum_size = (90, 90) - # max size should not smaller than min size - self.assertRaises( - ValueError, lambda: setattr(self.win, "maximum_size", (50, 50)) - ) - - # minimum size should be able to equal to maximum size - self.win.minimum_size = (60, 60) - self.win.maximum_size = (60, 60) - self.assertTupleEqual(self.win.maximum_size, (60, 60)) - self.assertTupleEqual(self.win.minimum_size, (60, 60)) - - def test_opacity(self): - # Setting is not supported at all with SDL_VIDEODRIVER = pygame.NULL_VIDEODRIVER, - # all we can test here is that the attribute exists and is a - # float - self.assertIsInstance(self.win.opacity, float) - - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "requires the SDL_VIDEODRIVER to be a non-null value", - ) - @unittest.skipIf(is_wayland, "not supported on wayland") - def test_opacity_set(self): - self.win.opacity = 0.5 - self.assertEqual(self.win.opacity, 0.5) - self.win.opacity = 0 - self.assertEqual(self.win.opacity, 0) - self.win.opacity = 1 - self.assertEqual(self.win.opacity, 1) - self.win.opacity = -0.1 - self.assertEqual(self.win.opacity, 0) - self.win.opacity = 1.1 - self.assertEqual(self.win.opacity, 1) - - self.assertRaises(TypeError, lambda: setattr(self.win, "opacity", "null str")) - - def test_init_flags(self): - # test no opengl by default - win = Window() - self.assertFalse(win.opengl) - win.destroy() - - # test borderless - win = Window(borderless=True) - self.assertTrue(win.borderless) - win.destroy() - - # test always_on_top - win = Window(always_on_top=True) - self.assertTrue(win.always_on_top) - win.destroy() - - # test resizable - win = Window(resizable=True) - self.assertTrue(win.resizable) - win.destroy() - - # test utility - win = Window(utility=True) - self.assertTrue(win.utility) - win.destroy() - - # should raise a TypeError if keyword is random - self.assertRaises(TypeError, lambda: Window(aaa=True)) - self.assertRaises(TypeError, lambda: Window(aaa=False)) - - def test_set_icon(self): - self.assertRaises(TypeError, lambda: self.win.set_icon(1234)) - - test_icon = pygame.Surface((32, 32)) - test_icon.fill((255, 0, 0)) - - return_value = self.win.set_icon(test_icon) - self.assertIsNone(return_value) - - def test_window_object_repr(self): - win = Window("awa") - self.assertEqual(repr(win), f"") - - win.destroy() - self.assertEqual(repr(win), "") - - pygame.display.set_mode((640, 480)) - win = Window.from_display_module() - self.assertEqual(repr(win), "") - - pygame.display.quit() - pygame.init() - - def test_from_display_module(self): - surf = pygame.display.set_mode((640, 480)) - - win1 = Window.from_display_module() - win2 = Window.from_display_module() - - self.assertIs(win1, win2) - self.assertIs(win1.get_surface(), surf) - - pygame.display.quit() - pygame.init() - - @unittest.skipIf(IS_PYPY, "for some reason this test is flaky on pypy") - def test_window_surface(self): - win = Window(size=(640, 480)) - surf = win.get_surface() - - self.assertIsInstance(surf, pygame.Surface) - - # test auto resize - self.assertTupleEqual(win.size, surf.get_size()) - win.size = (100, 100) - self.assertTupleEqual(win.size, surf.get_size()) - win.size = (1280, 720) - self.assertTupleEqual(win.size, surf.get_size()) - - # window surface should be invalid after the window is destroyed - win.destroy() - self.assertRaises(pygame.error, lambda: surf.fill((0, 0, 0))) - - @unittest.skipIf(IS_PYPY, "for some reason this test is flaky on pypy") - def test_window_surface_with_display_module(self): - # get_surface() should raise an error if the set_mode() is not called. - pygame.display.set_mode((640, 480)) - win1 = Window.from_display_module() - pygame.display.quit() - pygame.init() - self.assertRaises(pygame.error, lambda: win1.get_surface()) - - # the surface returned by get_surface() should be - # the surface returned by set_mode() - surf1 = pygame.display.set_mode((640, 480)) - win2 = Window.from_display_module() - surf2 = win2.get_surface() - self.assertIs(surf1, surf2) - - def test_window_flip(self): - win = Window(size=(640, 480)) - surf = win.get_surface() - surf.fill((255, 0, 0)) - - self.assertRaises(TypeError, lambda: win.flip("an argument")) - self.assertIs(win.flip(), None) - win.destroy() - - # creates a new window with no surface associated - win = Window(size=(640, 480)) - self.assertRaisesRegex( - pygame.error, - "the Window has no surface associated with it, did you forget to call Window.get_surface()", - win.flip, - ) - win.destroy() - - @unittest.skipIf( - os.environ.get("SDL_VIDEODRIVER") == pygame.NULL_VIDEODRIVER, - "OpenGL requires a non-null SDL_VIDEODRIVER", - ) - def test_window_opengl(self): - win1 = Window(opengl=True) - self.assertTrue(win1.opengl) - win1.flip() - win1.destroy() - - win2 = Window(opengl=False) - self.assertFalse(win2.opengl) - win2.get_surface() - win2.flip() - win2.destroy() - - pygame.display.set_mode((640, 480), pygame.OPENGL) - win = Window.from_display_module() - self.assertTrue(win.opengl) - pygame.display.quit() - pygame.init() - - @unittest.skipIf(IS_PYPY, "for some reason this test is flaky on pypy") - def test_window_subclassable(self): - class WindowSubclass(Window): - def __init__(self, title="Different title", size=(640, 480), **flags): - super().__init__(title, size, pygame.WINDOWPOS_CENTERED, **flags) - self.attribute = 10 - - window = WindowSubclass() - self.assertTrue(issubclass(WindowSubclass, Window)) - self.assertIsInstance(window, WindowSubclass) - self.assertEqual(window.title, "Different title") - self.assertEqual(window.attribute, 10) - window.destroy() - - pygame.display.set_mode((200, 200)) - window = WindowSubclass.from_display_module() - self.assertIsInstance(window, WindowSubclass) - self.assertEqual(window.size, (200, 200)) - - def test_window_flash(self): - window = pygame.Window() - - with self.assertRaises(TypeError): - window.flash("string") - window.flash(2.2) - window.flash([0]) - - with self.assertRaises(ValueError): - window.flash(-1) - window.flash(3) - - for operation in [ - pygame.FLASH_CANCEL, - pygame.FLASH_BRIEFLY, - pygame.FLASH_UNTIL_FOCUSED, - ]: - try: - result = window.flash(operation) - self.assertIsNone(result) - except pygame.error: - pass - - def test_window_focused(self): - window = pygame.Window() - self.assertIsInstance(window.focused, bool) - - def test_handle(self): - window = pygame.Window() - self.assertIsInstance(window.handle, int) - - def tearDown(self): - self.win.destroy() - - -if __name__ == "__main__": - unittest.main() diff --git a/.venv/lib/python3.14/site-packages/pygame/time.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/time.cpython-314-x86_64-linux-gnu.so index 5fb8d13..eca50ef 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/time.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/time.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/time.pyi b/.venv/lib/python3.14/site-packages/pygame/time.pyi index fd6a181..6183def 100644 --- a/.venv/lib/python3.14/site-packages/pygame/time.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/time.pyi @@ -1,144 +1,15 @@ -"""Pygame module for monitoring time. - -Provides utilities for monitoring time, delaying time, and maintaining a -constant frame rate. -Times in pygame-ce are represented in milliseconds (1/1000 of a second). -""" - -from typing import final +from typing import Union, final from pygame.event import Event -def get_ticks() -> int: - """Get the time in milliseconds. - - Return the number of milliseconds since ``pygame.init()`` was called. Before - pygame is initialized this will always be 0. - """ - -def wait(milliseconds: int, /) -> int: - """Pause the program for an amount of time. - - Will pause for a given number of milliseconds. This function sleeps the - process to share the processor with other programs. A program that waits for - even a few milliseconds will consume very little processor time. It is - slightly less accurate than the ``pygame.time.delay()`` function. - - This returns the actual number of milliseconds used. - """ - -def delay(milliseconds: int, /) -> int: - """Pause the program for an amount of time. - - Will pause for a given number of milliseconds. This function will use the - processor (rather than sleeping) in order to make the delay more accurate - than ``pygame.time.wait()``. - - This returns the actual number of milliseconds used. - """ - -def set_timer(event: int | Event, millis: int, loops: int = 0) -> None: - """Repeatedly create an event on the event queue. - - Set an event to appear on the event queue every given number of milliseconds. - The first event will not appear until the amount of time has passed. - - The ``event`` parameter can be a ``pygame.event.Event`` object or an integer - type that denotes an event. - - ``loops`` is an integer that denotes the number of events posted. If 0 (default) - then the events will keep getting posted, unless explicitly stopped. - - To disable the timer for such an event, call the function again with the same - event argument with ``millis`` argument set to 0. - - It is also worth mentioning that a particular event type can only be put on a - timer once. In other words, there cannot be two timers for the same event type. - Setting an event timer for a particular event discards the old one for that - event type. - - When this function is called with an ``Event`` object, the event(s) received - on the event queue will be a shallow copy; the dict attribute of the event - object passed as an argument and the dict attributes of the event objects - received on timer will be references to the same dict object in memory. - Modifications on one dict can affect another, use deepcopy operations on the - dict object if you don't want this behaviour. - However, calling this function with an integer event type would place event objects - on the queue that don't have a common dict reference. - - This function is not supported on web (WASM/Emscripten) builds. - - .. versionaddedold:: 2.0.0.dev3 once argument added. - .. versionchangedold:: 2.0.1 event argument supports ``pygame.event.Event`` object - .. versionaddedold:: 2.0.1 added loops argument to replace once argument - """ +def get_ticks() -> int: ... +def wait(milliseconds: int) -> int: ... +def delay(milliseconds: int) -> int: ... +def set_timer(event: Union[int, Event], millis: int, loops: int = 0) -> None: ... @final class Clock: - """Create an object to help track time. - - Creates a new Clock object that can be used to track an amount of time. The - clock also provides several functions to help control a game's framerate. - - .. versionchanged:: 2.1.4 This class is also available through the ``pygame.Clock`` - alias. - """ - - def __new__(cls) -> Clock: ... - def tick(self, framerate: float = 0, /) -> int: - """Update the clock. - - This method should be called once per frame. It will compute how many - milliseconds have passed since the previous call. - - If you pass the optional framerate argument the function will delay to - keep the game running slower than the given ticks per second. This can be - used to help limit the runtime speed of a game. By calling - ``Clock.tick(40)`` once per frame, the program will never run at more - than 40 frames per second. Passing 0 (the default) places no limit on - the framerate. - - Note that this function uses ``SDL_Delay``, which is not accurate on - every platform, but does not use much CPU. Use tick_busy_loop if you want - an accurate timer, and don't mind chewing CPU. - """ - - def tick_busy_loop(self, framerate: float = 0, /) -> int: - """Update the clock. - - This method should be called once per frame. It will compute how many - milliseconds have passed since the previous call. - - If you pass the optional framerate argument the function will delay to - keep the game running slower than the given ticks per second. This can be - used to help limit the runtime speed of a game. By calling - ``Clock.tick_busy_loop(40)`` once per frame, the program will never run at - more than 40 frames per second. Passing 0 (the default) places no limit on - the framerate. - - Note that this function uses :func:`pygame.time.delay`, which uses lots - of CPU in a busy loop to make sure that timing is more accurate. - - .. versionaddedold:: 1.8 - """ - - def get_time(self) -> int: - """Time used in the previous tick. - - The number of milliseconds that passed between the previous two calls to - ``Clock.tick()``. - """ - - def get_rawtime(self) -> int: - """Actual time used in the previous tick. - - Similar to ``Clock.get_time()``, but does not include any time used - while ``Clock.tick()`` was delaying to limit the framerate. - """ - - def get_fps(self) -> float: - """Compute the clock framerate. - - Compute your game's framerate (in frames per second). It is computed by - averaging the last ten calls to ``Clock.tick()``. Returns 0.0 if fewer - than ten ticks have been made. - """ + def tick(self, framerate: float = 0) -> int: ... + def tick_busy_loop(self, framerate: float = 0) -> int: ... + def get_time(self) -> int: ... + def get_rawtime(self) -> int: ... + def get_fps(self) -> float: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/transform.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/transform.cpython-314-x86_64-linux-gnu.so index 3f5977b..88a3fa8 100755 Binary files a/.venv/lib/python3.14/site-packages/pygame/transform.cpython-314-x86_64-linux-gnu.so and b/.venv/lib/python3.14/site-packages/pygame/transform.cpython-314-x86_64-linux-gnu.so differ diff --git a/.venv/lib/python3.14/site-packages/pygame/transform.pyi b/.venv/lib/python3.14/site-packages/pygame/transform.pyi index 24dd1a1..92fd10c 100644 --- a/.venv/lib/python3.14/site-packages/pygame/transform.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/transform.pyi @@ -1,489 +1,58 @@ -"""Pygame module to transform surfaces. - -A Surface transform is an operation that moves or resizes the pixels. All these -functions take a Surface to operate on and return a new Surface with the -results. - -Some of the transforms are considered destructive. These means every time they -are performed they lose pixel data. Common examples of this are resizing and -rotating. For this reason, it is better to re-transform the original surface -than to keep transforming an image multiple times. (For example, suppose you -are animating a bouncing spring which expands and contracts. If you applied the -size changes incrementally to the previous images, you would lose detail. -Instead, always begin with the original image and scale to the desired size.) - -.. versionchangedold:: 2.0.2 transform functions now support keyword arguments. -""" - -from typing import Literal +from typing import Literal, Optional, Sequence, Union +from pygame.color import Color from pygame.surface import Surface -from pygame.typing import ColorLike, Point, RectLike, SequenceLike -def flip(surface: Surface, flip_x: bool, flip_y: bool) -> Surface: - """Flip vertically and horizontally. - - This can flip a Surface either vertically, horizontally, or both. - The arguments ``flip_x`` and ``flip_y`` are booleans that control whether - to flip each axis. Flipping a Surface is non-destructive and returns a new - Surface with the same dimensions. - """ +from ._common import ColorValue, Coordinate, RectValue +def flip( + surface: Surface, + flip_x: bool | Literal[0] | Literal[1], + flip_y: bool | Literal[0] | Literal[1], +) -> Surface: ... def scale( surface: Surface, - size: Point, - dest_surface: Surface | None = None, -) -> Surface: - """Resize to new resolution. - - Resizes the Surface to a new size, given as (width, height). - This is a fast scale operation that does not sample the results. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must be the same as the size (width, height) passed - in, and the same depth and format as the source Surface. - - .. versionchanged:: 2.2.1 internal scaling algorithm was replaced with a nearly - equivalent one that is 40% faster. Scale results will be very slightly - different. - """ - + size: Coordinate, + dest_surface: Optional[Surface] = None, +) -> Surface: ... def scale_by( surface: Surface, - factor: float | SequenceLike[float], - dest_surface: Surface | None = None, -) -> Surface: - """Resize to new resolution, using scalar(s). - - Same as :func:`scale()`, but scales by some factor, rather than taking - the new size explicitly. For example, :code:`transform.scale_by(surf, 3)` - will triple the size of the surface in both dimensions. Optionally, the - scale factor can be a sequence of two numbers, controlling x and y scaling - separately. For example, :code:`transform.scale_by(surf, (2, 1))` doubles - the image width but keeps the height the same. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the scaled dimensions - (width * factor, height * factor) and same depth and format as the source Surface. - - .. versionadded:: 2.1.3 - """ - -def rotate(surface: Surface, angle: float) -> Surface: - """Rotate an image. - - Unfiltered counterclockwise rotation. The angle argument represents degrees - and can be any floating point value. Negative angle amounts will rotate - clockwise. - - Unless rotating by 90 degree increments, the image will be padded larger to - hold the new size. If the image has pixel alphas, the padded area will be - transparent. Otherwise pygame will pick a color that matches the Surface - colorkey or the topleft pixel value. - """ - -def rotozoom(surface: Surface, angle: float, scale: float) -> Surface: - """Filtered scale and rotation. - - This is a combined scale and rotation transform. The resulting Surface will - be a filtered 32-bit Surface. The scale argument is a floating point value - that will be multiplied by the current resolution. The angle argument is a - floating point value that represents the counterclockwise degrees to rotate. - A negative rotation angle will rotate clockwise. - """ - -def scale2x(surface: Surface, dest_surface: Surface | None = None) -> Surface: - """Specialized image doubler. - - This will return a new image that is double the size of the original. It - uses the AdvanceMAME Scale2X algorithm which does a 'jaggie-less' scale of - bitmap graphics. - - This really only has an effect on simple images with solid colors. On - photographic and antialiased images it will look like a regular unfiltered - scale. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have double the dimensions - (width * 2, height * 2) and same depth and format as the source Surface. - """ - + factor: Union[float, Sequence[float]], + dest_surface: Optional[Surface] = None, +) -> Surface: ... +def rotate(surface: Surface, angle: float) -> Surface: ... +def rotozoom(surface: Surface, angle: float, scale: float) -> Surface: ... +def scale2x(surface: Surface, dest_surface: Optional[Surface] = None) -> Surface: ... +def grayscale(surface: Surface, dest_surface: Optional[Surface] = None) -> Surface: ... def smoothscale( surface: Surface, - size: Point, - dest_surface: Surface | None = None, -) -> Surface: - """Scale a surface to an arbitrary size smoothly. - - Uses one of two different algorithms for scaling each dimension of the input - surface as required. For shrinkage, the output pixels are area averages of - the colors they cover. The size is a 2 number sequence for (width, height). - This function only works for 24-bit or 32-bit surfaces. A ``ValueError`` will - be thrown if the input surface bit depth is less than 24. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must be the same as the size (width, height) passed - in, and the same depth and format as the source Surface. - - .. versionaddedold:: 1.8 - - .. versionchanged:: 2.4.0 now uses SSE2/NEON SIMD for acceleration on x86 - and ARM machines, a performance improvement over previous MMX/SSE only - supported on x86. - """ - + size: Coordinate, + dest_surface: Optional[Surface] = None, +) -> Surface: ... def smoothscale_by( surface: Surface, - factor: float | SequenceLike[float], - dest_surface: Surface | None = None, -) -> Surface: - """Resize to new resolution, using scalar(s). - - Same as :func:`smoothscale()`, but scales by some factor, rather than - taking the new size explicitly. For example, - :code:`transform.smoothscale_by(surf, 3)` will triple the size of the - surface in both dimensions. Optionally, the scale factor can be a sequence - of two numbers, controlling x and y scaling separately. For example, - :code:`transform.smoothscale_by(surf, (2, 1))` doubles the image width but - keeps the height the same. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the scaled dimensions - (width * factor, height * factor) and same depth and format as the source Surface. - - .. versionadded:: 2.1.3 - """ - -def get_smoothscale_backend() -> Literal["GENERIC", "SSE2", "NEON"]: - """Return smoothscale filter version in use: 'GENERIC', 'MMX', 'SSE', 'SSE2', or 'NEON'. - - Shows whether or not smoothscale is using SIMD acceleration. - If no acceleration is available then "GENERIC" is returned. The level of - acceleration possible is automatically determined at runtime. - - This function is provided for pygame testing and debugging. - - .. versionchanged:: 2.4.0 Added SSE2 and NEON backends, MMX and SSE are deprecated. - """ - -def set_smoothscale_backend(backend: Literal["GENERIC", "SSE2", "NEON"]) -> None: - """Set smoothscale filter version to one of: 'GENERIC', 'MMX', 'SSE', 'SSE2', or 'NEON'. - - Sets smoothscale acceleration. Takes a string argument. A value of 'GENERIC' - turns off acceleration. A value error is raised if type is not - recognized or not supported by the current processor. - - This function is provided for pygame testing and debugging. If smoothscale - causes an invalid instruction error then it is a pygame/SDL bug that should - be reported. Use this function as a temporary fix only. - - .. versionchanged:: 2.4.0 Added SSE2 and NEON backends, MMX and SSE are deprecated. - """ - -def chop(surface: Surface, rect: RectLike) -> Surface: - """Gets a copy of an image with an interior area removed. - - Extracts a portion of an image. All vertical and horizontal pixels - surrounding the given rectangle area are removed. The corner areas (diagonal - to the rect) are then brought together. (The original image is not altered - by this operation.) - - ``NOTE``: If you want a "crop" that returns the part of an image within a - rect, you can blit with a rect to a new surface or copy a subsurface. - """ - -def laplacian(surface: Surface, dest_surface: Surface | None = None) -> Surface: - """Find edges in a surface. - - Finds the edges in a surface using the laplacian algorithm. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the same dimensions (width, height) and - depth as the source Surface. - - .. versionaddedold:: 1.8 - """ - -def box_blur( - surface: Surface, - radius: int, - repeat_edge_pixels: bool = True, - dest_surface: Surface | None = None, -) -> Surface: - """Blur a surface using box blur. - - Returns the blurred surface using box blur algorithm. - - This function does not work for indexed surfaces. - An exception will be thrown if the input is an indexed surface. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the same dimensions (width, height) and - depth and format as the source Surface. - - .. versionadded:: 2.2.0 - - .. versionchanged:: 2.3.0 - Passing the calling surface as destination surface raises a ``ValueError`` - - .. versionchanged:: 2.5.0 - A surface with either width or height equal to 0 won't raise a ``ValueError`` - """ - -def gaussian_blur( - surface: Surface, - radius: int, - repeat_edge_pixels: bool = True, - dest_surface: Surface | None = None, -) -> Surface: - """Blur a surface using gaussian blur. - - Returns the blurred surface using gaussian blur algorithm. - Slower than `box_blur()`. - - This function does not work for indexed surfaces. - An exception will be thrown if the input is an indexed surface. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the same dimensions (width, height) and - depth and format as the source Surface. - - .. versionadded:: 2.2.0 - - .. versionchanged:: 2.3.0 - Passing the calling surface as destination surface raises a ``ValueError`` - - .. versionchanged:: 2.3.1 - Now the standard deviation of the Gaussian kernel is equal to the radius. - Blur results will be slightly different. - - .. versionchanged:: 2.5.0 - A surface with either width or height equal to 0 won't raise a ``ValueError`` - """ - + factor: Union[float, Sequence[float]], + dest_surface: Optional[Surface] = None, +) -> Surface: ... +def get_smoothscale_backend() -> str: ... +def set_smoothscale_backend(backend: str) -> None: ... +def chop(surface: Surface, rect: RectValue) -> Surface: ... +def laplacian(surface: Surface, dest_surface: Optional[Surface] = None) -> Surface: ... def average_surfaces( - surfaces: SequenceLike[Surface], - dest_surface: Surface | None = None, - palette_colors: bool | int = 1, -) -> Surface: - """Find the average surface from many surfaces. - - Takes a sequence of surfaces and returns a surface with average colors from - each of the surfaces. - - palette_colors - if true we average the colors in palette, otherwise we - average the pixel values. This is useful if the surface is actually - grayscale colors, and not palette colors. - - Note, this function currently does not handle palette using surfaces - correctly. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the same dimensions (width, height) and - depth as the first passed source Surface. - - .. versionaddedold:: 1.8 - .. versionaddedold:: 1.9 ``palette_colors`` argument - """ - + surfaces: Sequence[Surface], + dest_surface: Optional[Surface] = None, + palette_colors: Union[bool, int] = 1, +) -> Surface: ... def average_color( - surface: Surface, rect: RectLike | None = None, consider_alpha: bool = False -) -> tuple[int, int, int, int]: - """Finds the average color of a surface. - - Finds the average color of a Surface or a region of a surface specified by a - Rect, and returns it as a tuple of integers red, green, blue, and alpha. - If consider_alpha is set to True, then alpha is taken into account - (removing the black artifacts). - - .. versionaddedold:: 2.1.2 ``consider_alpha`` argument - """ - -def invert(surface: Surface, dest_surface: Surface | None = None) -> Surface: - """Inverts the RGB elements of a surface. - - Inverts each RGB pixel contained within the Surface, does not affect alpha channel. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the same dimensions (width, height) and - depth as the source Surface. - - .. versionadded:: 2.2.0 - """ - -def grayscale(surface: Surface, dest_surface: Surface | None = None) -> Surface: - """Grayscale a surface. - - Returns a grayscaled version of the original surface using the luminosity formula which weights red, green and blue according to their wavelengths. - - An optional destination surface can be passed which is faster than creating a new - Surface. This destination surface must have the same dimensions (width, height) and - depth as the source Surface. - - .. versionadded:: 2.1.4 - - .. versionchanged:: 2.4.0 Adjusted formula slightly to support performance - optimisation. It may return very slightly different pixels than before, - but should run seven to eleven times faster on most systems. - """ - -def solid_overlay( - surface: Surface, - color: ColorLike, - dest_surface: Surface | None = None, - keep_alpha: bool = False, -) -> Surface: - """Replaces non transparent pixels with the provided color. - - Returns a new version of the original surface with all non transparent pixels set to the color provided. - - An optional destination surface can be passed which is faster than creating a new - Surface. - This destination surface must have the same dimensions (width, height) and - depth as the source Surface. - - :param pygame.Surface surface: The target surface. - - :param color: Color which all non transparent within the target surface must be set to. - :type color: :data:`pygame.typing.ColorLike` - - :param dest_surface: Optional destination surface to which the changes will be applied. - :type dest_surface: pygame.Surface or None - - :param bool keep_alpha: Optional parameter that controls whether to keep the surface alpha when replacing with the color. - - .. versionadded:: 2.5.2 - """ - + surface: Surface, rect: Optional[RectValue] = None, consider_alpha: bool = False +) -> Color: ... def threshold( - dest_surface: Surface | None, + dest_surface: Optional[Surface], surface: Surface, - search_color: ColorLike | None, - threshold: ColorLike = (0, 0, 0, 0), - set_color: ColorLike | None = (0, 0, 0, 0), + search_color: Optional[ColorValue], + threshold: ColorValue = (0, 0, 0, 0), + set_color: Optional[ColorValue] = (0, 0, 0, 0), set_behavior: int = 1, - search_surf: Surface | None = None, + search_surf: Optional[Surface] = None, inverse_set: bool = False, -) -> int: - """Finds which, and how many pixels in a surface are within a threshold of a 'search_color' or a 'search_surf'. - - This versatile function can be used for find colors in a 'surf' close to a 'search_color' - or close to colors in a separate 'search_surf'. - - It can also be used to transfer pixels into a 'dest_surf' that match or don't match. - - By default it sets pixels in the 'dest_surf' where all of the pixels NOT within the - threshold are changed to set_color. If inverse_set is optionally set to True, - the pixels that ARE within the threshold are changed to set_color. - - If the optional 'search_surf' surface is given, it is used to threshold against - rather than the specified 'set_color'. That is, it will find each pixel in the - 'surf' that is within the 'threshold' of the pixel at the same coordinates - of the 'search_surf'. - - :param dest_surf: Surface we are changing. See 'set_behavior'. - Should be None if counting (set_behavior is 0). - :type dest_surf: pygame.Surface or None - - :param pygame.Surface surf: Surface we are looking at. - - :param search_color: Color we are searching for. - :type color: :data:`pygame.typing.ColorLike` - - :param threshold: Within this distance from search_color (or search_surf). - You can use a threshold of (r,g,b,a) where the r,g,b can have different - thresholds. So you could use an r threshold of 40 and a blue threshold of 2 - if you like. - :type color: :data:`pygame.typing.ColorLike` - - :param set_color: Color we set in dest_surf. - :type color: :data:`pygame.typing.ColorLike` or ``None`` - - :param int set_behavior: - - set_behavior=1 (default). Pixels in dest_surface will be changed to 'set_color'. - - set_behavior=0 we do not change 'dest_surf', just count. Make dest_surf=None. - - set_behavior=2 pixels set in 'dest_surf' will be from 'surf'. - - :param search_surf: - - search_surf=None (default). Search against 'search_color' instead. - - search_surf=Surface. Look at the color in 'search_surf' rather than using 'search_color'. - :type search_surf: pygame.Surface or None - - :param bool inverse_set: - - False, default. Pixels outside of threshold are changed. - - True, Pixels within threshold are changed. - - :rtype: int - :returns: The number of pixels that are within the 'threshold' in 'surf' - compared to either 'search_color' or `search_surf`. - - .. versionaddedold:: 1.8 - .. versionchangedold:: 1.9.4 - Fixed a lot of bugs and added keyword arguments. Test your code. - .. versionchanged:: 2.5.8 - Fixed ``set_color`` writing the wrong channels on 24-bit destination - surfaces whose byte layout did not match the platform default. - """ - -def hsl( - surface: Surface, - hue: float = 0, - saturation: float = 0, - lightness: float = 0, - dest_surface: Surface | None = None, -) -> Surface: - """Change the hue, saturation, and lightness of a surface. - - This function allows you to modify the hue, saturation, and lightness of a given surface. - - :param pygame.Surface surface: The surface to transform. - - :param float hue: The amount to change the hue. Positive values rotate the hue clockwise, - while negative values rotate it counterclockwise. Value range: -360 to 360. - - :param float saturation: The amount to change the saturation. Positive values increase saturation, - while negative values decrease it. Value range: -1 to 1. - - :param float lightness: The amount to change the lightness. Positive values increase lightness, - while negative values decrease it. Value range: -1 to 1. - - :param pygame.Surface dest_surface: An optional destination surface to store the transformed image. - If provided, it should have the same dimensions and depth as the source surface. - - :returns: A new surface with the hue, saturation, and lightness transformed. - - :Examples: - - Apply a hue rotation of 30 degrees, increase saturation by 20%, and decrease lightness by 10% to a surface: - - .. code-block:: python - - new_surf = hsl(original_surf, 30, 0.2, -0.1) - - .. versionadded:: 2.5.0 - """ - -def pixelate( - surface: Surface, - pixel_size: int, - dest_surface: Surface | None = None, -) -> Surface: - """Returns a pixelated version of the original surface. - - ``pixel_size`` is an integer describing how large you want the pixels in the final pixelated image to be. - An optional destination surface can be passed which is faster than creating a new Surface. This destination - surface must have the same dimensions (width, height) and same depth and format as the source Surface. - - :param pygame.Surface surface: the surface to pixelate. - - :param int pixel_size: how large the pixels in the pixelated image should be. - - :param pygame.Surface dest_surface: An optional destination surface to store the pixelated image. - If provided, it should have the same dimensions and depth as the source surface. - - :returns: A new surface that's been pixelated. - - .. versionadded:: 2.5.6 - .. note:: - ``pixel_size`` must be >= 1. A ``ValueError`` is raised otherwise. - """ +) -> int: ... diff --git a/.venv/lib/python3.14/site-packages/pygame/typing.py b/.venv/lib/python3.14/site-packages/pygame/typing.py deleted file mode 100644 index eaa8e5c..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/typing.py +++ /dev/null @@ -1,75 +0,0 @@ -"""Set of common pygame type aliases for proper typehint annotations""" - -# NOTE: `src_py/typing.py` and `buildconfig/stubs/pygame/typing.pyi` must be duplicates. -# Use the command `python buildconfig/stubs/gen_stubs.py` to copy typing.py to typing.pyi - -__all__ = [ - "RectLike", - "SequenceLike", - "FileLike", - "ColorLike", - "Point", - "IntPoint", -] - -from abc import abstractmethod -from collections.abc import Callable -from os import PathLike as _PathProtocol -from typing import IO, Protocol, TypeAlias, TypeVar - -from pygame.color import Color -from pygame.rect import FRect, Rect - -# For functions that take a file name -_PathLike: TypeAlias = str | bytes | _PathProtocol[str] | _PathProtocol[bytes] -# Most pygame functions that take a file argument should be able to handle a FileLike type -FileLike: TypeAlias = _PathLike | IO[bytes] | IO[str] - -_T_co = TypeVar("_T_co", covariant=True) - - -class SequenceLike(Protocol[_T_co]): - """ - Variant of the standard `Sequence` ABC that only requires `__getitem__` and `__len__`. - """ - - @abstractmethod - def __getitem__(self, index: int, /) -> _T_co: ... - @abstractmethod - def __len__(self) -> int: ... - - -# Modify typehints when it is possible to annotate sizes - -# Pygame handles float without errors in most cases where a point is expected, -# usually rounding to int. Also, 'int | float == float' -Point: TypeAlias = SequenceLike[float] -# This is used where ints are strictly required -IntPoint: TypeAlias = SequenceLike[int] - -ColorLike: TypeAlias = Color | SequenceLike[int] | str | int - - -class _HasRectAttribute(Protocol): - # An object that has a rect attribute that is either a rect, or a function - # that returns a rect conforms to the rect protocol - @property - def rect(self) -> "RectLike | Callable[[], RectLike]": ... - - -RectLike: TypeAlias = ( - Rect | FRect | SequenceLike[float] | SequenceLike[Point] | _HasRectAttribute -) - - -# cleanup namespace -del ( - abstractmethod, - Color, - Rect, - FRect, - IO, - Callable, - TypeVar, - Protocol, -) diff --git a/.venv/lib/python3.14/site-packages/pygame/typing.pyi b/.venv/lib/python3.14/site-packages/pygame/typing.pyi deleted file mode 100644 index eaa8e5c..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/typing.pyi +++ /dev/null @@ -1,75 +0,0 @@ -"""Set of common pygame type aliases for proper typehint annotations""" - -# NOTE: `src_py/typing.py` and `buildconfig/stubs/pygame/typing.pyi` must be duplicates. -# Use the command `python buildconfig/stubs/gen_stubs.py` to copy typing.py to typing.pyi - -__all__ = [ - "RectLike", - "SequenceLike", - "FileLike", - "ColorLike", - "Point", - "IntPoint", -] - -from abc import abstractmethod -from collections.abc import Callable -from os import PathLike as _PathProtocol -from typing import IO, Protocol, TypeAlias, TypeVar - -from pygame.color import Color -from pygame.rect import FRect, Rect - -# For functions that take a file name -_PathLike: TypeAlias = str | bytes | _PathProtocol[str] | _PathProtocol[bytes] -# Most pygame functions that take a file argument should be able to handle a FileLike type -FileLike: TypeAlias = _PathLike | IO[bytes] | IO[str] - -_T_co = TypeVar("_T_co", covariant=True) - - -class SequenceLike(Protocol[_T_co]): - """ - Variant of the standard `Sequence` ABC that only requires `__getitem__` and `__len__`. - """ - - @abstractmethod - def __getitem__(self, index: int, /) -> _T_co: ... - @abstractmethod - def __len__(self) -> int: ... - - -# Modify typehints when it is possible to annotate sizes - -# Pygame handles float without errors in most cases where a point is expected, -# usually rounding to int. Also, 'int | float == float' -Point: TypeAlias = SequenceLike[float] -# This is used where ints are strictly required -IntPoint: TypeAlias = SequenceLike[int] - -ColorLike: TypeAlias = Color | SequenceLike[int] | str | int - - -class _HasRectAttribute(Protocol): - # An object that has a rect attribute that is either a rect, or a function - # that returns a rect conforms to the rect protocol - @property - def rect(self) -> "RectLike | Callable[[], RectLike]": ... - - -RectLike: TypeAlias = ( - Rect | FRect | SequenceLike[float] | SequenceLike[Point] | _HasRectAttribute -) - - -# cleanup namespace -del ( - abstractmethod, - Color, - Rect, - FRect, - IO, - Callable, - TypeVar, - Protocol, -) diff --git a/.venv/lib/python3.14/site-packages/pygame/version.py b/.venv/lib/python3.14/site-packages/pygame/version.py index 1511dee..7f489da 100644 --- a/.venv/lib/python3.14/site-packages/pygame/version.py +++ b/.venv/lib/python3.14/site-packages/pygame/version.py @@ -26,15 +26,16 @@ pygame version without importing the main pygame module. The python version information should always compare greater than any previous releases. (hmm, until we get to versions > 10) """ +from pygame.base import get_sdl_version -from pygame.base import __version__, get_sdl_version - +############### +# This file is generated with version.py.in +## class SoftwareVersion(tuple): """ A class for storing data about software versions. """ - __slots__ = () fields = "major", "minor", "patch" @@ -52,24 +53,20 @@ class SoftwareVersion(tuple): minor = property(lambda self: self[1]) patch = property(lambda self: self[2]) - class PygameVersion(SoftwareVersion): """ Pygame Version class. """ - class SDLVersion(SoftwareVersion): """ SDL Version class. """ - _sdl_tuple = get_sdl_version() SDL = SDLVersion(_sdl_tuple[0], _sdl_tuple[1], _sdl_tuple[2]) - -ver = __version__ # pylint: disable=invalid-name -vernum = PygameVersion(*map(int, ver.split(".")[:3])) +ver = "2.6.1" # pylint: disable=invalid-name +vernum = PygameVersion(2, 6, 1) rev = "" # pylint: disable=invalid-name __all__ = ["SDL", "ver", "vernum", "rev"] diff --git a/.venv/lib/python3.14/site-packages/pygame/version.pyi b/.venv/lib/python3.14/site-packages/pygame/version.pyi index b7cf8b9..69a3b6f 100644 --- a/.venv/lib/python3.14/site-packages/pygame/version.pyi +++ b/.venv/lib/python3.14/site-packages/pygame/version.pyi @@ -1,6 +1,8 @@ -from typing import Literal +from typing import Tuple -class SoftwareVersion(tuple[int, int, int]): +from ._common import Literal + +class SoftwareVersion(Tuple[int, int, int]): def __new__(cls, major: int, minor: int, patch: int) -> SoftwareVersion: ... def __repr__(self) -> str: ... def __str__(self) -> str: ... @@ -10,7 +12,7 @@ class SoftwareVersion(tuple[int, int, int]): def minor(self) -> int: ... @property def patch(self) -> int: ... - fields: tuple[Literal["major"], Literal["minor"], Literal["patch"]] + fields: Tuple[Literal["major"], Literal["minor"], Literal["patch"]] class PygameVersion(SoftwareVersion): ... class SDLVersion(SoftwareVersion): ... @@ -19,6 +21,3 @@ SDL: SDLVersion ver: str vernum: PygameVersion rev: str - -# keep in sync with version.py -__all__ = ["SDL", "ver", "vernum", "rev"] diff --git a/.venv/lib/python3.14/site-packages/pygame/window.cpython-314-x86_64-linux-gnu.so b/.venv/lib/python3.14/site-packages/pygame/window.cpython-314-x86_64-linux-gnu.so deleted file mode 100755 index 6a99a7e..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame/window.cpython-314-x86_64-linux-gnu.so and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame/window.pyi b/.venv/lib/python3.14/site-packages/pygame/window.pyi deleted file mode 100644 index 0230b92..0000000 --- a/.venv/lib/python3.14/site-packages/pygame/window.pyi +++ /dev/null @@ -1,511 +0,0 @@ -from pygame.locals import WINDOWPOS_UNDEFINED -from pygame.rect import Rect -from pygame.surface import Surface -from pygame.typing import Point, RectLike -from typing_extensions import deprecated # added in 3.13 - -def get_grabbed_window() -> Window | None: ... - -class Window: - """Pygame object that represents a window. - - The Window class (formerly known as _sdl2.video.Window), is a newly - published feature of pygame-ce 2.5.2. This class allows for programs - to drive multiple windows on-screen at once, something not possible with - the :func:`pygame.display.set_mode` API. Not everything possible with - :mod:`pygame.display` is possible yet in the Window API, but the new - window class will continue to be developed, and we're excited to share - the new functionality this class offers. - - :param str title: The title of the window. - :param (int, int) size: The size of the window, in screen coordinates. - :param (int, int) or int position: A tuple specifying the window position, or - ``WINDOWPOS_CENTERED``, or ``WINDOWPOS_UNDEFINED``. - :param bool fullscreen: Create a fullscreen window using the window size as - the resolution (videomode change). - :param bool fullscreen_desktop: Create a fullscreen window using the current - desktop resolution. - :param bool opengl: Create a window with support for an OpenGL context. - :param bool vulkan: Create a window with support for a Vulkan instance. - :param bool hidden: Create a hidden window. - :param bool borderless: Create a window without borders. - :param bool resizable: Create a resizable window. - :param bool minimized: Create a mimized window. - :param bool maximized: Create a maximized window. - :param bool mouse_grabbed: Create a window with grabbed mouse input. - :param bool keyboard_grabbed: Create a window with grabbed keyboard input. - :param bool input_focus: Create a window with input focus. - :param bool mouse_focus: Create a window with mouse focus. - :param bool allow_high_dpi: Create a window in high-DPI mode if supported. - :param bool mouse_capture: Create a window that has the mouse captured - (unrelated to INPUT_GRABBED). - :param bool always_on_top: Create a window that is always presented above - others. - :param bool utility: Create a window that doesn't appear in the task bar. - - Event behavior if one Window is created: When the close button is pressed, - the ``QUIT`` event will be sent to the event queue. - - .. code-block:: python - - import pygame - - window = pygame.Window() - - while True: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - pygame.quit() - raise SystemExit - - Event behavior if multiple windows are created: When the close button is - pressed, a ``WINDOWCLOSE`` event is sent. You need to explicitly destroy - the window. Note that the event ``QUIT`` will only be sent if all - windows have been destroyed. - - .. code-block:: python - - import pygame - - window1 = pygame.Window(position=(0,100)) - window2 = pygame.Window(position=(700,100)) - - while True: - for event in pygame.event.get(): - if event.type == pygame.WINDOWCLOSE: - id = event.window.id - print(f"WINDOWCLOSE event sent to Window #{id}.") - event.window.destroy() - - if event.type == pygame.QUIT: - print(f"Last window is destroyed. QUIT event was sent.") - pygame.quit() - raise SystemExit - - .. versionadded:: 2.4.0 - .. versionchanged:: 2.5.0 when ``opengl`` is ``True``, the ``Window`` has an OpenGL context created by pygame - .. versionchanged:: 2.5.1 Window is now a base class, allowing subclassing - """ - - def __init__( - self, - title: str = "pygame window", - size: Point = (640, 480), - position: int | Point = WINDOWPOS_UNDEFINED, - *, - fullscreen: bool = ..., - fullscreen_desktop: bool = ..., - opengl: bool = ..., - vulkan: bool = ..., - hidden: bool = ..., - borderless: bool = ..., - resizable: bool = ..., - minimized: bool = ..., - maximized: bool = ..., - mouse_grabbed: bool = ..., - keyboard_grabbed: bool = ..., - input_focus: bool = ..., - mouse_focus: bool = ..., - allow_high_dpi: bool = ..., - mouse_capture: bool = ..., - always_on_top: bool = ..., - utility: bool = ..., - ) -> None: ... - - grab_mouse: bool - """Get or set the window's mouse grab mode. - - When this attribute is set to ``True``, the window will try to confine the mouse - cursor to itself. - - Note this only set the "mode" of grab. The mouse may be confined to another window - depending on the window focus. To get if the mouse is currently restricted to this - window, please use :attr:`mouse_grabbed`. - - .. seealso:: :attr:`mouse_grabbed` - - .. versionadded:: 2.4.0 - """ - - grab_keyboard: bool - """Get or set the window's keyboard grab mode. - - When this attribute is set to ``True``, the window will try to capture system - keyboard shortcuts like ``Alt+Tab`` or the ``Meta/Super`` key. - - This attribute only set the "mode" of grab. The keyboard may be captured by - another window depending on the window focus. To get if keyboard is currently - captured by this window, please use :attr:`keyboard_grabbed`. - - Note that not all system keyboard shortcuts can be captured by applications - (one example is ``Ctrl+Alt+Del`` on Windows). - - When keyboard grab is enabled, pygame will continue to handle ``Alt+Tab`` when - the window is full-screen to ensure the user is not trapped in your application. - If you have a custom keyboard shortcut to exit fullscreen mode, you may suppress - this behavior with an environment variable, e.g. - ``os.environ["SDL_ALLOW_ALT_TAB_WHILE_GRABBED"] = "0"``. - - This attribute requires SDL 2.0.16+. - - .. seealso:: :attr:`keyboard_grabbed` - - .. versionadded:: 2.4.0 - """ - - @property - def mouse_grabbed(self) -> bool: - """Get if the mouse cursor is confined to the window (**read-only**). - - Get if the mouse cursor is currently grabbed and confined to the window. - - Roughly equivalent to this expression: - - :: - - win.grab_mouse and (win is get_grabbed_window()) - - .. seealso:: :attr:`grab_mouse` - - .. versionadded:: 2.4.0 - """ - - @property - def keyboard_grabbed(self) -> bool: - """Get if the keyboard shortcuts are captured by the window (**read-only**). - - Get if the keyboard shortcuts are currently grabbed and captured by the window. - - Roughly equivalent to this expression: - - :: - - win.grab_keyboard and (win is get_grabbed_window()) - - This attribute requires SDL 2.0.16+. - - .. seealso:: :attr:`grab_keyboard` - - .. versionadded:: 2.4.0 - """ - - @property - def focused(self) -> bool: - """Get if the window is focused (**read-only**). - - Get if the window is currently focused. The same result can be achieved using - the ``WINDOWFOCUSGAINED`` and ``WINDOWFOCUSLOST`` events. - - Use :meth:`focus` to focus and raise the window. - - .. versionadded:: 2.5.2 - """ - title: str - """Get or set the window title. - - An empty string means that no title is set. - """ - - resizable: bool - """Get or set whether the window is resizable.""" - - borderless: bool - """Gets or sets whether the window is borderless. - - .. note:: You can't change the border state of a fullscreen window. - """ - - always_on_top: bool - """Get or set whether the window is always on top. - - Setting the always-on-top mode requires SDL 2.0.16+. - - .. note:: Setting this property is not supported on some video drivers (like wayland) - and a :exc:`pygame.error` exception may be raised in such cases. - - .. versionadded:: 2.3.1 - """ - - @property - def id(self) -> int: - """Get the unique window ID (**read-only**).""" - - @property - def mouse_rect(self) -> Rect | None: - """Get or set the mouse confinement rectangle of the window. - - Setting this attribute to a rect-like object confines the - cursor to the specified area of this window. - - This attribute can be None, meaning that there is no mouse rect. - - Note that this does NOT grab the cursor, it only defines the area a - cursor is restricted to when the window has mouse focus. - - .. versionadded:: 2.4.0 - """ - - @mouse_rect.setter - def mouse_rect(self, value: RectLike | None) -> None: ... - @property - def size(self) -> tuple[int, int]: - """Get or set the window size in pixels.""" - - @size.setter - def size(self, value: Point) -> None: ... - @property - def minimum_size(self) -> tuple[int, int]: - """Get or set the minimum size of the window's client area. - - Initial value in most cases is ``(0, 0)``. If :func:`from_display_module` - was used to create the window and :func:`pygame.display.set_mode` was - called with the ``SCALED`` flag, the initial value is the size used in - that call. - - Raises a ``ValueError`` if negative values are provided or - if the width or height provided are greater than set - maximum width or height respectively. Unless maximum size - is ``(0, 0)`` (initial value). - - .. seealso:: :attr:`maximum_size`. - - .. versionadded:: 2.4.0 - """ - - @minimum_size.setter - def minimum_size(self, value: Point) -> None: ... - @property - def maximum_size(self) -> tuple[int, int]: - """Get or set the maximum size of the window's client area. - - Initial value is ``(0, 0)``. - - Raises a ``ValueError`` if negative values are provided or - if the width or height provided are less than set minimum - width or height respectively. - - .. seealso:: :attr:`minimum_size`. - - .. versionadded:: 2.4.0 - """ - - @maximum_size.setter - def maximum_size(self, value: Point) -> None: ... - @property - def position(self) -> tuple[int, int]: - """Get or set the window position in screen coordinates. - - The position may be a tuple of (x, y) coordinates or ``WINDOWPOS_CENTERED`` or - ``WINDOWPOS_UNDEFINED``. The origin is the topleft of the main display. - - .. note:: Setting this property is not supported on some video drivers (like wayland) - and a :exc:`pygame.error` exception may be raised in such cases. - """ - - @position.setter - def position(self, value: int | Point) -> None: ... - opacity: float - """Get or set the window opacity, between 0.0 (fully transparent) and 1.0 (fully opaque). - - .. note:: Setting this property is not supported on some video drivers (like wayland) - and a :exc:`pygame.error` exception may be raised in such cases. - """ - - @property - def opengl(self) -> bool: - """Get if the window supports OpenGL. - - ``True`` if the ``Window`` has an OpenGL context associated with it, ``False`` otherwise - - .. versionadded:: 2.5.0 - """ - - @property - def handle(self) -> int: - """Get the window handle provided by the window manager if supported otherwise 0 - - Returns the window handle provided by the window manager as an integer. If the operating - system is not supported or the window manager hides the handle the sentinel ``0`` is returned. - - The handle is generally available with Windows, X11 (Linux), Cocoa (MacOS), UIKit (iOS), - Android and Vivante while unavailable under Wayland and everything else. - - .. versionadded:: 2.5.8 - """ - - @property - def utility(self) -> bool: - """Get if the window is an utility window (**read-only**). - - ``True`` if the window doesn't appear in the task bar, ``False`` otherwise. - This only works for X11 and Windows, for other platforms, creating ``Window(utility=True)`` won't change anything. - - .. versionadded:: 2.5.3 - """ - - @classmethod - @deprecated( - "since 2.4.0. Use either the display module or the Window class with get_surface and flip. Try not to mix display and Window" - ) - def from_display_module(cls) -> Window: - """Create a Window object using window data from display module. - - **DON'T USE THIS!** If you want to draw to a surface and use the window - API, use :func:`Window.get_surface` and :func:`Window.flip`. - - Create a Window object that uses the same window data from the :mod:`pygame.display` module, created upon calling - :func:`pygame.display.set_mode`. - - .. deprecated:: 2.4.0 - """ - - def get_surface(self) -> Surface: - """Get the window surface. - - Returns a "display surface" for this Window. The surface returned is - analogous to the surface returned by :func:`pygame.display.set_mode`. - - This method allows software rendering (classic pygame rendering) on top - of the Window API. This method should not be called when using hardware - rendering (coming soon). - - Similarly to the "display surface" returned by :mod:`pygame.display`, - this surface will change size with the Window, and will become invalid - after the Window's destruction. - - .. seealso:: :func:`flip` - - .. versionadded:: 2.4.0 - """ - - def flip(self) -> None: - """Update the display surface to the window. - - Update pixel data from memory to be displayed in the window. This is the Window - class equivalent of :func:`pygame.display.flip`. - - With ``get_surface()`` this method allows software rendering (classic pygame rendering) flipping pixel data - from an associated surface in memory to be displayed in the window. Alternatively, when this window has an - associated OpenGL context, this method will instead perform a GL buffer swap to the window. - - Here is a runnable example of using ``get_surface`` and ``flip``: - - .. code-block:: python - - import pygame - - win = pygame.Window() - surf = win.get_surface() # get the window surface - - while True: - for event in pygame.event.get(): - if event.type == pygame.QUIT: - pygame.quit() - raise SystemExit - - # draw something on the surface - surf.fill("red") - - win.flip() # update the surface to the window - - - .. versionadded:: 2.4.0 - """ - - def set_windowed(self) -> None: - """Enable windowed mode (exit fullscreen). - - .. seealso:: :func:`set_fullscreen` - """ - - def set_fullscreen(self, desktop: bool = False) -> None: - """Enter fullscreen. - - :param bool desktop: If ``True``, use the current desktop resolution. - If ``False``, change the fullscreen resolution to the window size. - - .. seealso:: :meth:`set_windowed`. - """ - - def destroy(self) -> None: - """Destroy the window. - - Destroys the internal window data of this Window object. This method is - called automatically when this Window object is garbage collected, so - there usually aren't any reasons to call it manually. - - Other methods that try to manipulate that window data will raise an error. - """ - - def hide(self) -> None: - """Hide the window.""" - - def show(self) -> None: - """Show the window.""" - - def focus(self, input_only: bool = False) -> None: - """Set the window to be focused. - - Raises the window above other windows and sets the input focus. - - :param input_only: if ``True``, the window will be given input focus - but may be completely obscured by other windows. - Only supported on X11. This has been deprecated and - may be removed in a future version. - - .. deprecated:: 2.5.3 ``input_only`` argument - """ - - def restore(self) -> None: - """Restore the size and position of a minimized or maximized window.""" - - def maximize(self) -> None: - """Maximize the window.""" - - def minimize(self) -> None: - """Minimize the window.""" - - def set_icon(self, icon: Surface, /) -> None: - """Set the window icon. - - :param Surface surface: A Surface to use as the icon. - """ - - def set_modal_for(self, parent: Window, /) -> None: - """Set the window as a modal for a parent window. - - :param Window parent: The parent window. - - .. note:: This function is only supported on X11. - """ - - def flash(self, operation: int, /) -> None: - """Flash a window to demand attention from the user. - - :param int operation: The flash operation. - - Supported flash operations are: - * ``pygame.FLASH_CANCEL``: Cancel the current flash state if present - * ``pygame.FLASH_BRIEFLY``: Flash for a short amount of time to get attention - * ``pygame.FLASH_UNTIL_FOCUSED``: Keep flashing until the window is focused - - Window flashing requires SDL 2.0.16+. A :mod:`pygame.error` exception will be raised - otherwise. - - .. note:: This function is only supported on Windows, X11, Wayland and Cocoa (MacOS). - A :mod:`pygame.error` exception will be raised if it's not supported therefore it's - advised to wrap it in a try block. - - .. code-block:: python - - import pygame - window = pygame.Window() - - try: - window.flash(pygame.FLASH_BRIEFLY) - except pygame.error: - print("Window flashing not supported") - - .. versionadded:: 2.5.2 - """ - relative_mouse: bool diff --git a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/INSTALLER b/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/INSTALLER deleted file mode 100644 index a1b589e..0000000 --- a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/INSTALLER +++ /dev/null @@ -1 +0,0 @@ -pip diff --git a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/METADATA b/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/METADATA deleted file mode 100644 index bccc494..0000000 --- a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/METADATA +++ /dev/null @@ -1,244 +0,0 @@ -Metadata-Version: 2.1 -Name: pygame-ce -Version: 2.5.8 -Summary: Python Game Development -Author: A community project -License: LGPL v2.1 -Classifier: Development Status :: 5 - Production/Stable -Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL) -Classifier: Programming Language :: Assembly -Classifier: Programming Language :: C -Classifier: Programming Language :: Cython -Classifier: Programming Language :: Python -Classifier: Programming Language :: Python :: 3 -Classifier: Programming Language :: Python :: 3.10 -Classifier: Programming Language :: Python :: 3.11 -Classifier: Programming Language :: Python :: 3.12 -Classifier: Programming Language :: Python :: 3.13 -Classifier: Programming Language :: Python :: 3.14 -Classifier: Programming Language :: Python :: 3.15 -Classifier: Programming Language :: Python :: Implementation :: CPython -Classifier: Programming Language :: Python :: Implementation :: PyPy -Classifier: Topic :: Games/Entertainment -Classifier: Topic :: Multimedia :: Sound/Audio -Classifier: Topic :: Multimedia :: Sound/Audio :: MIDI -Classifier: Topic :: Multimedia :: Sound/Audio :: Players -Classifier: Topic :: Multimedia :: Graphics -Classifier: Topic :: Multimedia :: Graphics :: Capture :: Digital Camera -Classifier: Topic :: Multimedia :: Graphics :: Capture :: Screen Capture -Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion -Classifier: Topic :: Multimedia :: Graphics :: Viewers -Classifier: Topic :: Software Development :: Libraries :: pygame -Classifier: Operating System :: Microsoft :: Windows -Classifier: Operating System :: POSIX -Classifier: Operating System :: Unix -Classifier: Operating System :: MacOS -Classifier: Typing :: Typed -Project-URL: homepage, https://pyga.me -Project-URL: Bug Reports, https://github.com/pygame-community/pygame-ce/issues -Project-URL: Documentation, https://pyga.me/docs -Project-URL: Release Notes, https://github.com/pygame-community/pygame-ce/releases -Project-URL: Source, https://github.com/pygame-community/pygame-ce -Requires-Python: >=3.10 -Description-Content-Type: text/x-rst - -.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg - :width: 800 - :alt: pygame - :target: https://pyga.me/ - - -|DocsStatus| -|PyPiVersion| |PyPiLicense| -|Python3| |GithubCommits| |BlackFormatBadge| -|DiscordBadge| - -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - -Pygame_ is a free and open-source cross-platform library -for the development of multimedia applications like video games using Python. -It uses the `Simple DirectMedia Layer library`_ and several other -popular libraries to abstract the most common functions, making writing -these programs a more intuitive task. - -This distribution is called **'pygame - Community Edition'** ('pygame-ce' for short). - -It is a fork of the upstream pygame project by its former core developers, -and was created after impossible challenges prevented them from continuing development upstream. -The new distribution aims to offer more frequent releases, continuous bugfixes and enhancements, -and a more democratic governance model. - -New contributors are welcome! - - -Installation ------------- - -To install pygame-ce, first make sure you have Python (and pip) installed and available on your PATH. -Then, run the following command in your terminal or command prompt: - -:: - - pip install pygame-ce - -Note that on some platforms you may need to use ``pip3`` instead of ``pip``. - -Linux Note: "Breaking System Packages" Error -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -On some Linux distributions (like Ubuntu or Debian), installing Python packages with ``pip`` can trigger a message like the following: - -:: - - error: externally-managed-environment - This environment is externally managed when system packages are installed. - -This means your system Python is managed by the OS, and using ``pip3`` globally might interfere with system packages. - -Recommended Solutions -^^^^^^^^^^^^^^^^^^^^^ - -1. Use ``venv`` (Virtual Environment): - - You can create a virtual environment and install pygame-ce within it. - This way you still use system Python but create a separate environment for installed packages so that they do not conflict with or break system ones. - - .. code-block:: bash - - python3 -m venv venv # create a venv named 'venv' - source venv/bin/activate # activate venv - pip install pygame-ce # install packages in venv - -2. Use ``pyenv`` (User-level Python management): - - `pyenv `_ lets you install and manage your own Python versions at the user level without touching the system one. - As a plus, you can install and use multiple Python versions side by side. - -3. Use ``uv`` (Fast Modern Package Installer): - - `uv `_ is a modern, fast Python package and environment manager that can serve as a replacement for both ``venv`` and ``pyenv``. - -Help ----- - -If you are just getting started with pygame, you should be able to -get started fairly quickly. Pygame comes with many tutorials and -introductions. There is also full reference documentation for the -entire library. Browse the documentation on the `docs page`_. You -can also browse the documentation locally by running -``python -m pygame.docs`` in your terminal. If the docs aren't found -locally, it'll launch the online website instead. - -The online documentation stays up to date with the development version -of pygame on github. This may be a bit newer than the version of pygame -you are using. To upgrade to the latest full release, run -``pip install pygame-ce --upgrade`` in your terminal. - -Best of all, the examples directory has many playable small programs -which can get you started playing with the code right away. - - -Building From Source --------------------- - -If you want to use features that are currently in development, -or you want to contribute to pygame-ce, you will need to build pygame-ce -locally from its source code, rather than pip installing it. - -Installing from source is fairly automated. The most work will -involve compiling and installing all the pygame dependencies. Once -that is done, run the ``setup.py`` script which will attempt to -auto-configure, build, and install pygame. - -Much more information about installing and compiling is available -on the `Compilation wiki page`_. - - -Dependencies ------------- - -Pygame is obviously strongly dependent on SDL and Python. It also -links to and embeds several other smaller libraries. The font -module relies on SDL_ttf, which is dependent on freetype. The mixer -(and mixer.music) modules depend on SDL_mixer. The image module -depends on SDL_image. Transform.rotozoom has an embedded version -of SDL_rotozoom, and gfxdraw has an embedded version of SDL_gfx. -Dependency versions: - - -+----------+------------------------+ -| CPython | >= 3.10 (Or use PyPy3) | -+----------+------------------------+ -| SDL | >= 2.0.20 | -+----------+------------------------+ -| SDL_mixer| >= 2.0.4 | -+----------+------------------------+ -| SDL_image| >= 2.0.5 | -+----------+------------------------+ -| SDL_ttf | >= 2.0.18 | -+----------+------------------------+ - -How to Contribute ------------------ -First of all, thank you for considering contributing to pygame-ce! It's people like you that make pygame-ce a great library. Please follow these steps to get started: - -1. Read the `Contribution Guidelines`_ and the `Many Ways to Contribute`_ wiki pages. -2. Read the documentation on `Opening A Pull Request`_ and `Opening a Great Pull Request`_. -3. Read how to `label and link reported issues`_. -4. Check the `issue tracker`_ for open issues that interest you or open a new issue to start a discussion about your idea. - -There are many more resources throughout the `wiki pages`_ that can help you get started. - -If you have any questions, please feel free to ask in the `Pygame Community Discord Server`_ or open an issue. - -License -------- -**License Identifier:** LGPL-2.1-or-later - -This library is distributed under `GNU LGPL version 2.1`_, which can -be found in the file ``docs/LGPL.txt``. We reserve the right to place -future versions of this library under a different license. - -This basically means you can use pygame in any project you want, -but if you make any changes or additions to pygame itself, those -must be released with a compatible license (preferably submitted -back to the pygame-ce project). Closed source and commercial games are fine. - -The programs in the ``examples`` subdirectory are in the public domain. - -See docs/licenses for licenses of dependencies. - - -.. |PyPiVersion| image:: https://img.shields.io/pypi/v/pygame-ce.svg?v=1 - :target: https://pypi.python.org/pypi/pygame-ce - -.. |PyPiLicense| image:: https://img.shields.io/pypi/l/pygame-ce.svg?v=1 - :target: https://pypi.python.org/pypi/pygame-ce - -.. |Python3| image:: https://img.shields.io/badge/python-3-blue.svg?v=1 - -.. |GithubCommits| image:: https://img.shields.io/github/commits-since/pygame-community/pygame-ce/2.5.7.svg - :target: https://github.com/pygame-community/pygame-ce/compare/2.5.7...main - -.. |DocsStatus| image:: https://img.shields.io/website?down_message=offline&label=docs&up_message=online&url=https%3A%2F%2Fpyga.me%2Fdocs%2F - :target: https://pyga.me/docs/ - -.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg - :target: https://github.com/psf/black - -.. |DiscordBadge| image:: https://discord.com/api/guilds/772505616680878080/widget.png - :target: https://pyga.me/discord - -.. _Pygame: https://pyga.me -.. _Simple DirectMedia Layer library: https://www.libsdl.org -.. _Compilation wiki page: https://github.com/pygame-community/pygame-ce/wiki#compiling -.. _docs page: https://pyga.me/docs -.. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html -.. _Contribution Guidelines: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines -.. _Many Ways to Contribute: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute -.. _Opening A Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request -.. _Opening a Great Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request -.. _issue tracker: https://github.com/pygame-community/pygame-ce/issues -.. _label and link reported issues: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues -.. _Pygame Community Discord Server: https://pyga.me/discord -.. _wiki pages: https://github.com/pygame-community/pygame-ce/wiki diff --git a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/RECORD b/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/RECORD deleted file mode 100644 index 8f27e62..0000000 --- a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/RECORD +++ /dev/null @@ -1,671 +0,0 @@ -pygame/__briefcase/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pygame/__briefcase/__pycache__/__init__.cpython-314.pyc,, -pygame/__briefcase/__pycache__/pygame_ce.cpython-314.pyc,, -pygame/__briefcase/pygame_ce.py,sha256=Aj_hU3M_FaghL0TPw95-2LpMZZm0ualIkh-E5xFxRcM,3034 -pygame/__init__.py,sha256=OPvb83rIt0yl4xLY2-LeqQzpiHYxWc5A6mKrZGWRVoM,13370 -pygame/__init__.pyi,sha256=ZZvPFtRCqv9-lovEvTvld4zXmfNp5H0EpO0ETZY1yk0,22416 -pygame/__pycache__/__init__.cpython-314.pyc,, -pygame/__pycache__/_camera_opencv.cpython-314.pyc,, -pygame/__pycache__/_data_classes.cpython-314.pyc,, -pygame/__pycache__/_debug.cpython-314.pyc,, -pygame/__pycache__/_sprite.cpython-314.pyc,, -pygame/__pycache__/camera.cpython-314.pyc,, -pygame/__pycache__/colordict.cpython-314.pyc,, -pygame/__pycache__/cursors.cpython-314.pyc,, -pygame/__pycache__/freetype.cpython-314.pyc,, -pygame/__pycache__/ftfont.cpython-314.pyc,, -pygame/__pycache__/locals.cpython-314.pyc,, -pygame/__pycache__/macosx.cpython-314.pyc,, -pygame/__pycache__/midi.cpython-314.pyc,, -pygame/__pycache__/pkgdata.cpython-314.pyc,, -pygame/__pycache__/sndarray.cpython-314.pyc,, -pygame/__pycache__/sprite.cpython-314.pyc,, -pygame/__pycache__/surfarray.cpython-314.pyc,, -pygame/__pycache__/sysfont.cpython-314.pyc,, -pygame/__pycache__/typing.cpython-314.pyc,, -pygame/__pycache__/version.cpython-314.pyc,, -pygame/__pyinstaller/__init__.py,sha256=-c4Zo8nQGKAm8wc_LDscxMtK7zr_YhZwRnC9CMruUBE,72 -pygame/__pyinstaller/__pycache__/__init__.cpython-314.pyc,, -pygame/__pyinstaller/__pycache__/hook-pygame.cpython-314.pyc,, -pygame/__pyinstaller/hook-pygame.py,sha256=_G00WSKq7W7ZTT121NFa4pLn29AtOeRu6YN_bw57PPw,1369 -pygame/_camera.cpython-314-x86_64-linux-gnu.so,sha256=4pjvDZD6fHM54MiWKg0JmuTB5ajW2AojN3ZxetrzDDw,128377 -pygame/_camera_opencv.py,sha256=Fo-Rrk_AhACQCEjFF3mSBvz9P5rRzj119vn9XnICbXw,4488 -pygame/_data_classes.py,sha256=-Prqqtdq9R6hbKA88T-rwktVaNGH-IXi1t3jbAL5i20,264 -pygame/_debug.py,sha256=lHpF_yglH0v0aqKLviG_3Yh4pjYZgSkMCbazc85yYig,6015 -pygame/_debug.pyi,sha256=OHrTpM068BuoOL6D4GjN3nH5kETa2ZnZjuk1Ep7n0kY,298 -pygame/_freetype.cpython-314-x86_64-linux-gnu.so,sha256=wlUOyAk8M75CuiTikD1--RGn4XEdXSQunAOderiLAi8,137953 -pygame/_render.cpython-314-x86_64-linux-gnu.so,sha256=7JeQ9-R4tpjsuizhplgFO720Hq1kjAP6SF0CF_mr_Zo,63609 -pygame/_render.pyi,sha256=kPgwdU3-6uFCzJAkqknjwyFGok1HqqoPFwdLC9xPHSc,4933 -pygame/_sdl2/__init__.py,sha256=7S5YglTgpJc2AXS_3ccWLfrWU-jZ5SSybG6Xaxfutbs,321 -pygame/_sdl2/__init__.pyi,sha256=fWR2P9epfYw8F_xyyMBoUxDZwJTIroizEnkN_eLf2rw,98 -pygame/_sdl2/__pycache__/__init__.cpython-314.pyc,, -pygame/_sdl2/__pycache__/window.cpython-314.pyc,, -pygame/_sdl2/audio.cpython-314-x86_64-linux-gnu.so,sha256=AC-Fowd3hLbkrdCrmPHfiuOAcU_jJCOAridPiI9Hz60,254265 -pygame/_sdl2/audio.pyi,sha256=P3fzE76JgnzX_eYxwlrvEd3CsX-bwSal5YsbX9Tezlc,1351 -pygame/_sdl2/controller.cpython-314-x86_64-linux-gnu.so,sha256=YVTl6upU0lJcUEIIyCNO9TmsqjFA0g3O4vrta1ZdV0w,38577 -pygame/_sdl2/controller.pyi,sha256=MKnsQYXaiZtaHbGVFNLDXKZXVEaQLwmOO1rF_IrVEtY,1167 -pygame/_sdl2/controller_old.cpython-314-x86_64-linux-gnu.so,sha256=3Zuxbf1P4KpAh1Qdah-sVPQvsxQW2UA2nSbOUXAhwds,155673 -pygame/_sdl2/controller_old.pyi,sha256=ZLGonNqJJIPkMo_Mhx7o8_uDzvxhFUxecLOlsbWZpT0,1155 -pygame/_sdl2/mixer.cpython-314-x86_64-linux-gnu.so,sha256=JVeOb5eouq5zEiJhAuxO-3_2wj7DnAVSqsdbB6YPDpM,233649 -pygame/_sdl2/sdl2.cpython-314-x86_64-linux-gnu.so,sha256=A-OrbFLM4_FqLd2l73zw_yRtmdzrL4GlUTlJlNlXVGw,76617 -pygame/_sdl2/sdl2.pyi,sha256=uWN_iQPcnjA5qf9fdO0GjTQeFkFtkIvnHCnG4a9SAdU,306 -pygame/_sdl2/touch.cpython-314-x86_64-linux-gnu.so,sha256=KEcKaziaiseK2JDYsKi-AmoJtDxgbBRHZWO1zgNnnCY,25649 -pygame/_sdl2/touch.pyi,sha256=7UsXrlq1tkNJuAGqgnixMN4Rmzh4Atc6HGYFEALLwwI,314 -pygame/_sdl2/video.cpython-314-x86_64-linux-gnu.so,sha256=rKFwOon-abjeupNxJAni4z_I72HR2ySS5hJAro6FVAM,308273 -pygame/_sdl2/video.pyi,sha256=8bYk35nC-ZCug-NIr3o18vAifAIndovxHtvfzK7pwOo,4924 -pygame/_sdl2/window.py,sha256=oyNQfICCyQm8cxUsp5A5XNcArRZtriQJWQ0V_ddNCmo,61 -pygame/_sdl2/window.pyi,sha256=h_ulB6rQfEz5s5TP0WrRGkxSUZ4jwnHSBUUKQX3bsBo,48 -pygame/_sprite.py,sha256=_na6ECqeHcvuFt-Px02em0GvwXvNGSoRjWe0OMn-lQs,539 -pygame/base.cpython-314-x86_64-linux-gnu.so,sha256=MHoMMKW8sDsjo-uwjBPAYRq9cIKriiQY1kCFZuG8RqM,63529 -pygame/base.pyi,sha256=oCSyxHq4mC9de6pkn8jpePrYyTsJBuOC_jF8aGjbMCY,633 -pygame/bufferproxy.cpython-314-x86_64-linux-gnu.so,sha256=ds9ro-_gwKf8-bjY0RvRkCWL14uDWuzyO16JAy8Vu3g,28656 -pygame/bufferproxy.pyi,sha256=u7Q3NCx37rBsHnLQmWl0ft1egXc_qZttsb-NBNPaSSo,864 -pygame/camera.py,sha256=RdKv28bcOPdqgWUSwEEcpStqq8n__Sbf0-v_BoNn8yY,4702 -pygame/camera.pyi,sha256=28VLg4dPvIwoJqI-Aq5oJ_GXJpsQzci1xHrWDqFl72Y,1709 -pygame/color.cpython-314-x86_64-linux-gnu.so,sha256=7ge9I8TWJj_1cjB04FD3YXS9BO-1WOJDmOROaw38vm0,71473 -pygame/color.pyi,sha256=ADKpPUIe_Th9Vam45ud7DsjdK6-UJcEpzOUHZUk_hP8,17188 -pygame/colordict.py,sha256=t7bUlHVLlwVZRAi1988AxrwlrKPgMe4Hyk7M8Y9n8jo,25768 -pygame/constants.cpython-314-x86_64-linux-gnu.so,sha256=euieTBgtxoQoYXxRoNXkn82cJyDMjojKU1rq-MIknhQ,77904 -pygame/constants.pyi,sha256=00s5vluzSaCWU9glTxN9cZfP5p0BVqaOu0YEsaZ9Fh4,22644 -pygame/cursors.py,sha256=KBR4XF4Xygvd2-YJpyJwxKEkBAxvjNql-grVefIuMoo,23977 -pygame/cursors.pyi,sha256=zFDs4L8Ckq8AZ23Pyrq_UChI6-Xrh6peE-R17f78KEs,2015 -pygame/display.cpython-314-x86_64-linux-gnu.so,sha256=VASJD4lXtW3bTvdJ5TiswaC-oPW92jYdAnFIOxkpOtI,85505 -pygame/display.pyi,sha256=E81tviRR5SE_fSD3G3gPC0goJrPNFriIMmPo5_QUHZ0,35558 -pygame/docs/__init__.py,sha256=n5XuSUErbHYDBYfGkQ4mfqHjfXaBB13OLPwjsHCx0Nk,220 -pygame/docs/__main__.py,sha256=nj0DjQUST-_G4iy3DNPlXwX1Dl8rfbcqyK4cpsNIEzM,317 -pygame/docs/__pycache__/__init__.cpython-314.pyc,, -pygame/docs/__pycache__/__main__.cpython-314.pyc,, -pygame/docs/__pycache__/serve.cpython-314.pyc,, -pygame/docs/__pycache__/static.cpython-314.pyc,, -pygame/docs/generated/LGPL.txt,sha256=oZDcnIBDdV2Q-LCnX6ZrnkLUr0yYC_XdxjPwEk2zzuc,26430 -pygame/docs/generated/_images/angle_to.png,sha256=vP3M5zZVFf-ooagw-hRTlnhBLbGQvX9gxO7nX_gBgbc,25349 -pygame/docs/generated/_images/camera_average.jpg,sha256=dkXZ7NdHmM69rbcYCpu0vKtqmHF3qh9nPUgZX3wlWDc,20881 -pygame/docs/generated/_images/camera_background.jpg,sha256=exoGN5fT9IKQyMJK_3VrEjfKTvr5yMeoSLCQplD0hes,7493 -pygame/docs/generated/_images/camera_green.jpg,sha256=NpIuT5qRzN5I7TFLva8m_kCAo1cwOuR5R5-Du9kaEo0,10219 -pygame/docs/generated/_images/camera_hsv.jpg,sha256=tfL0KJyxSk5A_KjVZR7MdV-qegBhej5HlXXw2CnoZR8,36673 -pygame/docs/generated/_images/camera_mask.jpg,sha256=0u0yMCldZMvSW1vyO2KK32D-fVYuYpXlNzmWwbdZ__s,18779 -pygame/docs/generated/_images/camera_rgb.jpg,sha256=GN_1jI8mnDJm1bRbjNBmpJETDSAKcVAS9BxmycYMMv0,32488 -pygame/docs/generated/_images/camera_thresh.jpg,sha256=WBYm8M-TxnuKCYEBvmu68iO_r9EYucnENZ5Ew8i6tqk,4346 -pygame/docs/generated/_images/camera_thresholded.jpg,sha256=OMh-3zXV2a-aahnMQlE7ihvxwXy1UADb15c3LzIWgh0,23678 -pygame/docs/generated/_images/camera_yuv.jpg,sha256=Gp0omp1py-_j6Qpv95VIo6EmDO2u5VY83fPWA2Rd6Bk,20105 -pygame/docs/generated/_images/chimpshot.webp,sha256=1s6ZeReI4T8hHFd4HtEkSFOLxBcublcCrsZu5RDbHCw,28298 -pygame/docs/generated/_images/draw_module_example.png,sha256=jdmdloG1tva_F2X9_WIfpHpJtRrqutc00_m95lnJzqQ,13444 -pygame/docs/generated/_images/intro_ball.webp,sha256=2B5maR2SgH3h8OZroB-025e8M_PZxsHwiNE5ppXAANs,3588 -pygame/docs/generated/_images/intro_blade.jpg,sha256=Aj59Tt9z1mdJeDK89HbWaQ7DVTDKbzoUDT-vNcJnYQo,2631 -pygame/docs/generated/_images/intro_freedom.jpg,sha256=RL-jChKVMdqoS7BN5NGV7hjlxSgU4qaKrj4ZXH2zsI8,7050 -pygame/docs/generated/_images/joystick_calls.png,sha256=oNAQgfZ8GM5_Z17hoNVrLf1tYeRnths60ZrlhJduWhs,30004 -pygame/docs/generated/_images/premultiplied_alpha_composition.webp,sha256=o8U-jOYwv811fnv0VEXV4QGEH0AVoDqnPTDwImNOOek,4524 -pygame/docs/generated/_images/project.png,sha256=jtmjR19Lx-P2qs5UHXfiCtikakm1VrUCr_HddDsSKgA,14532 -pygame/docs/generated/_images/project_clamp.png,sha256=dZfokMC3Mof8rBpLkZQ_1EZE47igYkDtjYcJ8wa2HUs,30877 -pygame/docs/generated/_images/pygame_ce_lofi.webp,sha256=DdmJxME0iv_pXWrYX4bJyH0GpXIhdai_myTuguHo8Jk,126562 -pygame/docs/generated/_images/pygame_ce_logo.webp,sha256=G47x64rqnHKoOvnI1yR_sUvvCP92-FYlA9EgK1FsIQg,127910 -pygame/docs/generated/_images/pygame_ce_powered.webp,sha256=_buV7bLrH8EGeEB7H8hvyljVt0FY0jvoy_xmdLt6VxA,150210 -pygame/docs/generated/_images/pygame_ce_powered_lowres.webp,sha256=owu1Wk0Cxr18a5tUI9tVqfim_MPPpdglHX5vOvkBIlA,8758 -pygame/docs/generated/_images/pygame_ce_tiny.webp,sha256=oAswXMCqsFyOh4FDOw6NQWziTRlZppjTAqmJR4OyEW4,17814 -pygame/docs/generated/_images/straight_alpha_composition.webp,sha256=D2bQc_sX_UXlm4KzqEQlMEuBCKjOiTCkIDNqzMX9Vp0,4270 -pygame/docs/generated/_images/surfarray_allblack.webp,sha256=x5wq5OK18R3IM6VeYZBC6sr7aUqRRdBeNv7Jj1jYDd4,42 -pygame/docs/generated/_images/surfarray_flipped.webp,sha256=hjKbAzPuCawMGRxpBD2b71NalQuRkQeamAZWYoEqLwM,38804 -pygame/docs/generated/_images/surfarray_redimg.webp,sha256=RySyeImCLc80V72vUYMgDi6Tpm3QFnBUrICA1QkeE-4,15926 -pygame/docs/generated/_images/surfarray_rgbarray.webp,sha256=6-eoDhpleP0ZcdKEJuWDb9L9RQN0ow30UK4blZjG1Bk,38938 -pygame/docs/generated/_images/surfarray_scaledown.webp,sha256=OEm23uUJEeAMRhdSLba79mr21XxeQeuPtJ6rbso4YEo,12840 -pygame/docs/generated/_images/surfarray_scaleup.webp,sha256=tQC7Mi3QfbIenO_pXcwH-dHobj4oLlRg5x5FLdob-AI,47414 -pygame/docs/generated/_images/surfarray_soften.webp,sha256=9UkpTgqxJ939sTkAwpFHVr-ofs3_4GfWIOptx1DegQI,34530 -pygame/docs/generated/_images/surfarray_striped.webp,sha256=7P7J--QTWbZnN8WfTIuIk97d7gXZIVlsOS_CnJKslNg,52 -pygame/docs/generated/_images/surfarray_xfade.webp,sha256=MtpJv-VFQvGNGdQ0sliBu4uVXGb4ba547YI-Tns9wPw,30274 -pygame/docs/generated/_images/tom_basic.webp,sha256=BIbsF3ZWZywLDqPT4UNkASVl6HIPL8sLk_c7u0vBy5A,4522 -pygame/docs/generated/_images/tom_event-flowchart.webp,sha256=H58Hdu7rTiEtticBHbBMqD2QZx9mcTnfGhtF19tITWg,2670 -pygame/docs/generated/_images/tom_formulae.webp,sha256=E8aIzF9UQCTaDwDp3h4qaam7RslS2i9WVOU1oUTd4rs,2626 -pygame/docs/generated/_images/tom_radians.webp,sha256=-iE1SybFsI8mtdNEUbiDjTdiBFb2vc31So0uH1pQJ30,9758 -pygame/docs/generated/_sources/c_api.rst.txt,sha256=6z7nXyyBIQiYy-8sotqSnrYyQOKoInaClh1b2ONBE1w,515 -pygame/docs/generated/_sources/filepaths.rst.txt,sha256=sou-1N5amW1JXHqwKUU0BqYQmm2c5qDjjFKVIKIppfo,899 -pygame/docs/generated/_sources/index.rst.txt,sha256=zkMtU-azly1InaNuceysCV20lPdIlvh3aHPVLXP5Xx4,7802 -pygame/docs/generated/_sources/logos.rst.txt,sha256=SFVHHZcyUJqcOtJiDE6P8GJ142gDR3JRI3KpnfT4BvE,1705 -pygame/docs/generated/_sources/ref/bufferproxy.rst.txt,sha256=fsB7MZq-Kk0T-HKE5NQbdx5FUlSTFULhHtV6PHlBb0g,4725 -pygame/docs/generated/_sources/ref/camera.rst.txt,sha256=4RdX5zhJpiGcmh7k05JWQajsAYnfBuxiJdEXCPmkl8k,9471 -pygame/docs/generated/_sources/ref/color.rst.txt,sha256=bsBYJHM_mnWqe1mAA7cjok-DywuekMpcYNjXcSn1yT4,129 -pygame/docs/generated/_sources/ref/color_list.rst.txt,sha256=m64K4LyBI5gkJyY9gt-gYf9RFfd8-xOE4GXMZJABpUo,96366 -pygame/docs/generated/_sources/ref/cursors.rst.txt,sha256=yxNNRlgu8ONuk-NhgVobVPySANvfgoNhPBcDvwEJar8,261 -pygame/docs/generated/_sources/ref/display.rst.txt,sha256=YMKW5TgEHRHqPpVvgL0GAlPQKYsn02CIvMhk7gxw0_g,116 -pygame/docs/generated/_sources/ref/draw.rst.txt,sha256=MxMzgNUvOtsF2X7zg1TrssjLJLQWh9f8O3ykDwRjHgQ,279 -pygame/docs/generated/_sources/ref/event.rst.txt,sha256=_Hb4Mzy7QTi5yM_UJ3iGidcvKSpXSCEq9BPnCGfHvXU,20244 -pygame/docs/generated/_sources/ref/examples.rst.txt,sha256=T4EW_ceXPCvz43xOxLXz4z6ajIg7lBghXw30uwNVJLc,14107 -pygame/docs/generated/_sources/ref/font.rst.txt,sha256=2svQEvSGTBMK99abLgdaZOIXXC43MnISFHOKfDGicgw,13362 -pygame/docs/generated/_sources/ref/freetype.rst.txt,sha256=evLBCQg2PFSulfy-nAbo5K0kiuFOXODrIAY7DUU930g,32238 -pygame/docs/generated/_sources/ref/geometry.rst.txt,sha256=5LCZp9DHS123_nuH6pqFcrlxmQAj_SV0FShcltQLojo,24631 -pygame/docs/generated/_sources/ref/gfxdraw.rst.txt,sha256=9QAiU61JVtyz8y3yk8lqraL_ekON0UHph4tUHVwBQuw,21868 -pygame/docs/generated/_sources/ref/image.rst.txt,sha256=MH93_4en378I3FiDiyxrqI9ZOrgHneWSvfCWWE1hPY8,110 -pygame/docs/generated/_sources/ref/joystick.rst.txt,sha256=TTjcCIx1pesTbFGkQZZayJ_Pm_JrgRsoUVdTo8nyh5w,21238 -pygame/docs/generated/_sources/ref/key.rst.txt,sha256=PFku2KiBnb5jowd61wHihm4utnPYbuh3WjB2z9pe10k,141 -pygame/docs/generated/_sources/ref/locals.rst.txt,sha256=CRFr5doSNsRPw08SVBE3b9n31sISPNf7vOH_kPPsxmQ,1025 -pygame/docs/generated/_sources/ref/mask.rst.txt,sha256=3lXIaVelBICXzxVb3Q5GG32a9Aq2NeDzNE3SeZrrkX0,137 -pygame/docs/generated/_sources/ref/math.rst.txt,sha256=yvTiYB2XP-pnrOd7P53zK6BtlkDtdRcodcxyuYZCnHM,37833 -pygame/docs/generated/_sources/ref/midi.rst.txt,sha256=8W9BL1OpNJu504XBXik3nSy75UXdnVvUclyqAZlXihw,14379 -pygame/docs/generated/_sources/ref/mixer.rst.txt,sha256=QY7EfKe8GXRTLuuysN1eZPPqJWHbyf3LLMXV3RlCmLQ,28336 -pygame/docs/generated/_sources/ref/mouse.rst.txt,sha256=1MJrqlBZN1zmASs57Lrx2m57Z7sMaPOUgUtyxQg0UqA,110 -pygame/docs/generated/_sources/ref/music.rst.txt,sha256=sAQmwxXHj7znJMWAo06fttjJKw1ScbWD4kHRLwm6w7I,11604 -pygame/docs/generated/_sources/ref/pixelarray.rst.txt,sha256=s2KWu54JXuSIKXZH4jkYpxPcSKkBFrwrCZNgY_CJaNI,10581 -pygame/docs/generated/_sources/ref/pixelcopy.rst.txt,sha256=9OgKTV6SF41HvijhkO_G65aHSoADtbYGUTfUd4ODkHo,122 -pygame/docs/generated/_sources/ref/pygame.rst.txt,sha256=obkMWxtKvH-zF8dBHUjXySBhjG5VJNJI8Pgghd2RjMM,17008 -pygame/docs/generated/_sources/ref/rect.rst.txt,sha256=5p5eyJumGaDyo7nx5omD0UfjelDJJp_OSP88YbAH_AI,22914 -pygame/docs/generated/_sources/ref/scrap.rst.txt,sha256=JQGPADJdm6IufVu9_RNMmW_Yy8jpXQaBPG1Bs4ZLZNk,7061 -pygame/docs/generated/_sources/ref/sdl2_controller.rst.txt,sha256=16ZXAjanx-3CLlbTtkPHLkOAXEyk5keViQCMCKKd-tc,9889 -pygame/docs/generated/_sources/ref/sdl2_video.rst.txt,sha256=BnSZkcEkNsJ7yhVHe-MgVnwfurGjYOqYjMboHKW0eOk,20560 -pygame/docs/generated/_sources/ref/sndarray.rst.txt,sha256=mCzTydgb-BxQEa4tNmJk5tETLAN999peCeKsMRWYYPA,119 -pygame/docs/generated/_sources/ref/special_flags_list.rst.txt,sha256=fJGRjUmzUaGENhYwJcFmBFSiRx8OIaugZosn_oEz57I,4479 -pygame/docs/generated/_sources/ref/sprite.rst.txt,sha256=XptEbR1uwlPV5K94GvFn_tDGl2WJGSO90aL9LirzOvg,29343 -pygame/docs/generated/_sources/ref/surface.rst.txt,sha256=MZoUrFN-ANb1GAZ0jBe-VAMePusLXKgS5BIy4euiVxU,173 -pygame/docs/generated/_sources/ref/surfarray.rst.txt,sha256=4Ds_NXnCuZM7avhGGpLgfzREAjqkxRW8XdWrG6UH2jg,12871 -pygame/docs/generated/_sources/ref/system.rst.txt,sha256=Bg59Xz_YhbVCE0ytvLbnfwbFG7xNalWfQd1HtDbjQxA,114 -pygame/docs/generated/_sources/ref/tests.rst.txt,sha256=xl7X3TRp9Vk4RxwBWo2HFrbXOMm0dD-xgGCQYXpipCI,4551 -pygame/docs/generated/_sources/ref/time.rst.txt,sha256=oxh0QCXZNJaRoOLKYcTdi2iGvqAIOCDVDzEg8OvuicY,107 -pygame/docs/generated/_sources/ref/touch.rst.txt,sha256=1HKU1l4F4KKHl4rgYkPXTS3Do5H_zjz5KdabtVW19XE,2013 -pygame/docs/generated/_sources/ref/transform.rst.txt,sha256=yBudE8McsyoqnfOvC6UJwYVLgxpXe3EhoWgDa3nXc8c,122 -pygame/docs/generated/_sources/ref/typing.rst.txt,sha256=pYwlPIeojtdmwGNacqcr4t8GgrzhpZjimy1-KVNrsfM,2444 -pygame/docs/generated/_sources/ref/window.rst.txt,sha256=IQiHphHQ_mklhmTUOsizaaWGiz4vOqcpB11-Khh_9i4,140 -pygame/docs/generated/_static/basic.css,sha256=BkoQYJdx1xV46TXJfBWjKxsUyrtfK5e7nP5xlp-jGSs,14815 -pygame/docs/generated/_static/dark-theme-icon.svg,sha256=duTqQGFHZ6JnvsiB3NRSvXOLbA3w9RFs0FXIrTHBEoI,404 -pygame/docs/generated/_static/doctools.js,sha256=KZLAnfkYJqjTPjtItkXud-RXrc98cS13aoFOHixEi0M,4322 -pygame/docs/generated/_static/documentation_options.js,sha256=6eYNiwWIeZ_Twp6G73My69wtadBSl0frf8ls56hqRT4,328 -pygame/docs/generated/_static/file.png,sha256=XEvJoWrr84xLlQ9ZuOUByjZJUyjLnrYiIYvOkGSjXj4,286 -pygame/docs/generated/_static/graphviz.css,sha256=YC7YX1CeO2rpNf7o4PRu1xc0If1iCbq4HhslDkm_cb0,147 -pygame/docs/generated/_static/language_data.js,sha256=O8MRVjt_xegPyrL4Ypd0vzy2swICAA3zbf-OaVqQI7c,4598 -pygame/docs/generated/_static/legacy_logos.zip,sha256=69C68jO62qau7eQx3z6U9pLnDhAMXK72RZ4PatlSMdY,51315 -pygame/docs/generated/_static/light-theme-icon.svg,sha256=2FlPZuyjXIxuGFFnNawK5ze59I3-Vdyekechgc4HHC8,1209 -pygame/docs/generated/_static/minus.png,sha256=R-f8UNs2mfHKQc6aL_ogLADF0dUYDFX2K6hZsb1swAg,90 -pygame/docs/generated/_static/plus.png,sha256=VBFRmblqEwy6AhR8R8DetD3Mm58ItRYruoZCs0mArGM,90 -pygame/docs/generated/_static/pygame.css,sha256=7ABrjs9lSi6f-r5GN5ozYctH6_xhB9pYPIqQQyrRQLs,17483 -pygame/docs/generated/_static/pygame.ico,sha256=YeIWletq938Rg_G11m_1iGL_zw9T_U1QXZhjnbHjJSU,1078 -pygame/docs/generated/_static/pygame_ce_lofi.svg,sha256=RO6tv0XgEunJuvJ0XQ8TMH4a96y9nnuwmdqofR4dEYU,80964 -pygame/docs/generated/_static/pygame_ce_lofi.webp,sha256=DdmJxME0iv_pXWrYX4bJyH0GpXIhdai_myTuguHo8Jk,126562 -pygame/docs/generated/_static/pygame_ce_logo.svg,sha256=dy6qnxI1nhVV1OdQGnTSELI3Q2YsnltFe7Hs5Z5K6Ok,80934 -pygame/docs/generated/_static/pygame_ce_logo.webp,sha256=G47x64rqnHKoOvnI1yR_sUvvCP92-FYlA9EgK1FsIQg,127910 -pygame/docs/generated/_static/pygame_ce_powered.svg,sha256=ORAVC8vhGctNcRkAygRs9-5JUoiQvDlFTMSuEKsaGp8,124849 -pygame/docs/generated/_static/pygame_ce_powered.webp,sha256=_buV7bLrH8EGeEB7H8hvyljVt0FY0jvoy_xmdLt6VxA,150210 -pygame/docs/generated/_static/pygame_ce_powered_lowres.webp,sha256=owu1Wk0Cxr18a5tUI9tVqfim_MPPpdglHX5vOvkBIlA,8758 -pygame/docs/generated/_static/pygame_ce_tiny.webp,sha256=oAswXMCqsFyOh4FDOw6NQWziTRlZppjTAqmJR4OyEW4,17814 -pygame/docs/generated/_static/pygments.css,sha256=PyZnnWxiXstnw0F60Dr6ZqP_hqUgGjT5oH-yZv4c5_0,4908 -pygame/docs/generated/_static/reset.css,sha256=wqvSs8L_cB2K6bR903cOJkEtfJi0LpNQFl3nC_kZQr4,1083 -pygame/docs/generated/_static/script.js,sha256=F84oyCWNb6RbBq5HHNSPzhobUvG9_gcV1YEm2_YbBaE,1119 -pygame/docs/generated/_static/searchbar-icon.svg,sha256=CdZph778iy-bekCOT_rKaiZiZuTxKTTmdw9PuviUdDM,582 -pygame/docs/generated/_static/searchtools.js,sha256=KmtlzymhgycT1QjEcdZDJTErubVnK4HtVZX6aDM6ZbU,21463 -pygame/docs/generated/_static/sphinx_highlight.js,sha256=CWIx6ch9-A7DJz2pxbcbyBUDIGcmoHpN1N5Ewlb_hZw,5123 -pygame/docs/generated/_static/tooltip.css,sha256=UkuHG9X2M7DaTSMJX3-mW-4LV8wBtFxfG5k_pr7xrc4,798 -pygame/docs/generated/_static/upstream_logos.zip,sha256=OZnjzhll_CJSkXYGFBSSgWTFcC5TT2cJ79YVlMsSG1Q,322360 -pygame/docs/generated/c_api.html,sha256=AwvN0cRR9WQyUWIO_v7NyOmpPk3hLKaly_q32W_RBHs,8152 -pygame/docs/generated/c_api/base.html,sha256=MuACGv5thWCTMUn41ZtauWmw5j5hyurfiWqNVYHE9Fo,34566 -pygame/docs/generated/c_api/bufferproxy.html,sha256=ivRt6SnG2M0So43VEHkCbUEerRdh6zlSCk-ysWZDOvA,12445 -pygame/docs/generated/c_api/color.html,sha256=YigjVu19BPqXcJRFMC8ITjfgTn9f0JPSMa_YRZDyiLs,14070 -pygame/docs/generated/c_api/display.html,sha256=_UebROlobhuPLAnJ-MynHVyBUFegAwohJGhQtnfswuM,11347 -pygame/docs/generated/c_api/event.html,sha256=tn6Ldh3ga9bdApHc-s9oY-8RHkC8dOr34ozH5l-3XGc,15441 -pygame/docs/generated/c_api/freetype.html,sha256=m2jN7quNgsZt00ouNqwzOJ14S0Tf8EAtO5g-9pDqwvA,11801 -pygame/docs/generated/c_api/joystick.html,sha256=KYNSqS2dyDptlQWlW1oX7XxZ_W3ydFUhUNjynQbeMLU,8922 -pygame/docs/generated/c_api/mixer.html,sha256=BDwXGTPL8E_2tKcUBGNKBq4e6QXREQ9xV_CfAKXDrmw,15733 -pygame/docs/generated/c_api/rect.html,sha256=jDpug4nK_kNWyxeSGkoqY-W9J-XfiBZYGNCtjoSsBBo,20021 -pygame/docs/generated/c_api/rwobject.html,sha256=4NkE8TR_dfrEnP-m9SlCP5oU7zjzMOgErN9xkMn7GyM,14818 -pygame/docs/generated/c_api/slots.html,sha256=d54yP32nBLxBM4kKqaOi5BaoqKFjcUJTWerujQ466ek,7286 -pygame/docs/generated/c_api/surface.html,sha256=SezYH7DuQmv13mWRQd7o_265xcuTcwA0Gmqny2u07Og,14141 -pygame/docs/generated/c_api/surflock.html,sha256=CZ6luVABZa5qKPlejNLTYWAJQw5kBE01vonENxHAtzY,12528 -pygame/docs/generated/c_api/version.html,sha256=e2LXQpXgh70VOTO8JtIVMp0ApNdjYOB5vWOiWgOudNc,8664 -pygame/docs/generated/c_api/window.html,sha256=cK2parVAgxuolzg1zpcUeGhCRSQ5PU5cRSe-IGG4UiE,8711 -pygame/docs/generated/filepaths.html,sha256=HPqLy47cV84GwrL3jbRA9OGJJZ-LoqckzkYoLbIu3Z0,6971 -pygame/docs/generated/genindex.html,sha256=Bz9Kegq5jgbBuMA_6UlNAIO4eqbFaQQ_OitAvZUsVwg,135233 -pygame/docs/generated/index.html,sha256=Bhu18Xjt8n2gMyefVrPjPnp67BkXZ_XBF8WC22E8SP0,28632 -pygame/docs/generated/logos.html,sha256=oFa47LcnRioa7IsDWpd-w8Fr8u9ss5cwkXdtGCrw1Ic,8556 -pygame/docs/generated/py-modindex.html,sha256=_3plOCU3NalWs0AdS9DGSi4C-OOe0oMycmVZKeqGcdY,11606 -pygame/docs/generated/ref/bufferproxy.html,sha256=of6ZWQ3DbI362mupTiocPlaMreKnHzv3wU6BshpU3nQ,17962 -pygame/docs/generated/ref/camera.html,sha256=-PZmG38JepCeGY-BoaROKB_PQDyvdbdlk4Ho4NwJBBU,27204 -pygame/docs/generated/ref/color.html,sha256=F8EOxxoQ18JIGZWmvt3QWpIdR_zxIxqcUQpDUzw2TUA,54168 -pygame/docs/generated/ref/color_list.html,sha256=ldtzD5hfoZvEYkJsEfO0Sd9gBRruWstS0a8Io3pUum0,174825 -pygame/docs/generated/ref/cursors.html,sha256=ofexfULy4HIBlC9qg6kPNm7497VgO8QRvoC-sUv3Msw,38191 -pygame/docs/generated/ref/display.html,sha256=QnxjJ5rf5YibHsjIHg_X5XcbzeuUwNfG4VjxrYnTMZI,90665 -pygame/docs/generated/ref/draw.html,sha256=Brs176HGYLdpFFhvKCpBqV_29ZdiXg7qU-0W7R67p54,89396 -pygame/docs/generated/ref/event.html,sha256=IaFIZmLJvWRvYouvxIUhRXyFnyUB_f4VmNotK3V2t-w,68210 -pygame/docs/generated/ref/examples.html,sha256=8MphNqzkzVz6W2PhRw7yc0wB9Dc-1nnICv7JZLhFYTc,48269 -pygame/docs/generated/ref/font.html,sha256=8BVjZSrY_xdSDrdP5z_aE7fp5Ng5gLDaXzC0xsiEc3A,65509 -pygame/docs/generated/ref/freetype.html,sha256=_FdootKaxIEBq22vKrqKXRcSXbXkw_FuyJr_xwh7ees,101949 -pygame/docs/generated/ref/geometry.html,sha256=CVUXWM1ARGKkjELSUHaYHtNi423FlOoTrx4Y80r0i4I,70650 -pygame/docs/generated/ref/gfxdraw.html,sha256=PTiVTob1PYPFXYRAa2V-kS35-xdmCiSAMuXoHsUUSdM,81250 -pygame/docs/generated/ref/image.html,sha256=YJ24s6Y2J3kxahq2T8xenwztoYXCWvFHogCz44BTpqI,45085 -pygame/docs/generated/ref/joystick.html,sha256=iY-B3b43uhD3NB8eK8yQrXFuNgAFTprVpvYO3uvAGKo,96365 -pygame/docs/generated/ref/key.html,sha256=v1E35kH7C9VAIMEXBJ1C8uo1xGTQNn_JjhE04AAUlmc,49690 -pygame/docs/generated/ref/locals.html,sha256=WRxgFJ-NV7J2CthYcdBZDNNKmwV44ifFiRi7XZL-0jg,9085 -pygame/docs/generated/ref/mask.html,sha256=Dp42bzOTWfphgsL3r9D4JPLSMxd0z4CXsG2aIOpDCik,81416 -pygame/docs/generated/ref/math.html,sha256=FKaEtjKEkLgTrkCocKKaxOZ9Zainl5zNoiOzYEJqVbE,142634 -pygame/docs/generated/ref/midi.html,sha256=fLZKFYMtqgQ0ghCy3tRbp_ICq8fZVp8n9ozudjD8YdE,52425 -pygame/docs/generated/ref/mixer.html,sha256=4wxXlwCvzpS-hJ0BHEzctFiszRK2dlsFOuYIJPCjfSc,80491 -pygame/docs/generated/ref/mouse.html,sha256=jYVGQPqtUNDbzkX7yHXYIYRLqZcC_kowpj2mMI_EPOI,39206 -pygame/docs/generated/ref/music.html,sha256=2udFXdyIFRdNnAweo4XGOQkJvNZyU0EVYAnWBL4pLac,39606 -pygame/docs/generated/ref/pixelarray.html,sha256=Ox_blZWC9GrEZ0x8iaA3ENA75hmhI1gGw1ffzpcoBY4,31954 -pygame/docs/generated/ref/pixelcopy.html,sha256=nBFlt1f4PoT4K2FIHp3sQmwdTK1dTAHVTWDwN8ARdLc,15319 -pygame/docs/generated/ref/pygame.html,sha256=TczHSQyQ03QkZEEgSSLpXeyNwZQjoVaQyKIHFU4ZAuE,56146 -pygame/docs/generated/ref/rect.html,sha256=H7VU7Kg8PkVrjJS4hnXXSJaHpOiMjlGEOBflO1EEua8,78093 -pygame/docs/generated/ref/scrap.html,sha256=3QcGHCQy0jtyN0J5vbNkhMsOJLNaAa48CceqODcFjek,35336 -pygame/docs/generated/ref/sdl2_controller.html,sha256=8mL9gTsocS4CQuljnJWN1qEjn9P7X8RlD_PUmxqP0ZA,37990 -pygame/docs/generated/ref/sdl2_video.html,sha256=JKE-S-D3HxXGeJsSkYg9gj6yrQnHNpfkeS1qqMGTcvw,81368 -pygame/docs/generated/ref/sndarray.html,sha256=d5gr8uVjB7v96hk0OAZf7JPulDLlsEBG-pxEjblcXrU,15080 -pygame/docs/generated/ref/special_flags_list.html,sha256=vVj8EUVfXH3FwqGEQn-LJwcN2amc86wpOWLc9qc5UpI,15975 -pygame/docs/generated/ref/sprite.html,sha256=AmHdqDZuUSn_KgXdl3FwCmKXbwYcB7TOzzyERHWguuU,90324 -pygame/docs/generated/ref/surface.html,sha256=yUNSfeUf1qVjhdhOcSJ5S8gg5_Atdi2NaB0WuRhJqqE,107866 -pygame/docs/generated/ref/surfarray.html,sha256=qZSLvjL1y9N3BshBO42V1ik96NkytG96M3WTbkXXCXA,39316 -pygame/docs/generated/ref/system.html,sha256=nt4wOazlX6OV7A0yMgpqrKwEV4sZOon1M0uAiNAzVwA,21837 -pygame/docs/generated/ref/tests.html,sha256=NifOeTQe1uF2WYZZ2vqoMEVJs2_AwN_i6xMsc9iNZDc,18692 -pygame/docs/generated/ref/time.html,sha256=P0tku3lvoUiIXo9u-oBlnv7T_Mt0StriWTMeB0mEOig,20781 -pygame/docs/generated/ref/touch.html,sha256=RpPZKprBEo5n-J0UXMEOs-D6_IIZ1AFaj4FeajOgQxA,13436 -pygame/docs/generated/ref/transform.html,sha256=glO1lfuUbipGabJeoEG-2IsI39cTwZu9AtSbho4st14,50305 -pygame/docs/generated/ref/typing.html,sha256=0dt4B9vkGaehWJr1cQqN9Yvh5f2-UJbGhjhlwbdOms0,15178 -pygame/docs/generated/ref/window.html,sha256=NPiYZnOuz74kJXkVzo7FU4xb8en_voe7ERliMPMTTHs,68696 -pygame/docs/generated/search.html,sha256=obl4DGuD9n6l6QhhnRYTEjN_QjVUrO0VQTAtYtSDTKI,3335 -pygame/docs/generated/searchindex.js,sha256=0t-kP5afIUelnJUb-IE0kqOAx5fTKaxAOMQJW4HyKyM,337587 -pygame/docs/generated/tutorials/chimp.py.html,sha256=t5wBNZKOTT7NW0Sc6gZbnzvUsPEjOzSFlgkL-mjQtkY,36305 -pygame/docs/generated/tutorials/en/chimp-explanation.html,sha256=xje-thCh_VA7MCFdhh8IWxCh64XtcvC1DeAvj5_ZvVg,55933 -pygame/docs/generated/tutorials/en/display-modes.html,sha256=lihk2Ex86ZdrwO5EnW26cpEIv-3Dp09xz_roT9sUBJk,22937 -pygame/docs/generated/tutorials/en/import-init.html,sha256=-7sScqG0Q8erCtJ6OPWbF5ADG2jPYha2mStwxCbn5QM,10536 -pygame/docs/generated/tutorials/en/intro-to-camera.html,sha256=Wf_pDrAeBEjVqL5eubBD0QdU9YZ_MvXY9gF9EDkorT8,39168 -pygame/docs/generated/tutorials/en/intro-to-pygame.html,sha256=0XrfPX8bebA-SlANi-gzQ1G37kNuOTubcFVnJpDsKpY,30353 -pygame/docs/generated/tutorials/en/intro-to-sprites.html,sha256=KjqD4oc2Jroe_rHfLYdXJ_rSUE97dX2NuOdOAv1fsas,41235 -pygame/docs/generated/tutorials/en/intro-to-surfarray.html,sha256=kDDl-LS9ncXOyMMw5IrbptRZX2uprnEsdMiIkXc3BM0,51604 -pygame/docs/generated/tutorials/en/make-games.html,sha256=soRhtyomfVOSenySHCQ2OhH1_4mOGxATtsOZFf4S2nY,15513 -pygame/docs/generated/tutorials/en/move-it.html,sha256=I09CneWR46JNHGr3wPla7Qo8nqjVf7-gQc3b3xCVqs4,66832 -pygame/docs/generated/tutorials/en/newbie-guide.html,sha256=UiAPCn8KiScxwez6_xLxYX6pBWBlsvbv8isfvw712B8,47299 -pygame/docs/generated/tutorials/en/premultiplied-alpha.html,sha256=j0FbbUMsTTmWzZojEQvozQGgzhx822yTLwRWhLhowWw,36812 -pygame/docs/generated/tutorials/en/tom-games2.html,sha256=eR8Hk4HVKhBPTyxI5RxH9L23XJMH9txSXt8ecNvtjbU,18434 -pygame/docs/generated/tutorials/en/tom-games3.html,sha256=_XBp6x7-HcCeCvEXvIIun_py6HsG7H74v4kLU-bwFCc,16242 -pygame/docs/generated/tutorials/en/tom-games4.html,sha256=pC_L_f9s_mljpyiyjiuG5hhUaNkL5lE-IOExD_yOC98,19999 -pygame/docs/generated/tutorials/en/tom-games5.html,sha256=4p_Al3-aUQAk4y8EIzri4RLIReeNZQRfNQw7Z5Wmo-w,22275 -pygame/docs/generated/tutorials/en/tom-games6.html,sha256=hIaSz7Maqw6ZY1_zuHFGNvmyd0p96BqVaQyC_Q2PTYc,54154 -pygame/docs/generated/tutorials/es/ChimpanceLineaporLinea.html,sha256=4SjnBU4RPRXdMVRq84Cqy_RMKSkyYiY6q6fLxTLMSFo,62037 -pygame/docs/serve.py,sha256=81gE026IReqJClB9zKvu7HL4PBqZwMDaqmWJlS0MLx8,1834 -pygame/docs/static.py,sha256=p2lIP_0UdUHfMoHGnBQf2p0DHY09QUv9ORGJ2h3vLrw,569 -pygame/draw.cpython-314-x86_64-linux-gnu.so,sha256=JRoohqr5nTk7phdFIhbA6DXutRsS1VQV4altgCr4wKA,107801 -pygame/draw.pyi,sha256=PXZZKzbjjkpsvJp8YhCEa2rvpXfAZ9BQirTgXabdKnQ,25277 -pygame/event.cpython-314-x86_64-linux-gnu.so,sha256=MSIqmJKHqVYkMZhBVuGw4kQeikVwChabR2AhHiy9cMA,79929 -pygame/event.pyi,sha256=LcIb5dn_8r1_Jtk6MArtZ93wzwmtwxWav1curiySOPw,1842 -pygame/examples/README.rst,sha256=rUPokDKZXj0jyIDsXxrvWI5Mhy4ArewnGSsP-3Y89h4,4456 -pygame/examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pygame/examples/__pycache__/__init__.cpython-314.pyc,, -pygame/examples/__pycache__/aacircle.cpython-314.pyc,, -pygame/examples/__pycache__/aliens.cpython-314.pyc,, -pygame/examples/__pycache__/arraydemo.cpython-314.pyc,, -pygame/examples/__pycache__/audiocapture.cpython-314.pyc,, -pygame/examples/__pycache__/blend_fill.cpython-314.pyc,, -pygame/examples/__pycache__/blit_blends.cpython-314.pyc,, -pygame/examples/__pycache__/camera.cpython-314.pyc,, -pygame/examples/__pycache__/chimp.cpython-314.pyc,, -pygame/examples/__pycache__/cursors.cpython-314.pyc,, -pygame/examples/__pycache__/dropevent.cpython-314.pyc,, -pygame/examples/__pycache__/eventlist.cpython-314.pyc,, -pygame/examples/__pycache__/font_viewer.cpython-314.pyc,, -pygame/examples/__pycache__/fonty.cpython-314.pyc,, -pygame/examples/__pycache__/freetype_misc.cpython-314.pyc,, -pygame/examples/__pycache__/glcube.cpython-314.pyc,, -pygame/examples/__pycache__/go_over_there.cpython-314.pyc,, -pygame/examples/__pycache__/headless_no_windows_needed.cpython-314.pyc,, -pygame/examples/__pycache__/joystick.cpython-314.pyc,, -pygame/examples/__pycache__/liquid.cpython-314.pyc,, -pygame/examples/__pycache__/mask.cpython-314.pyc,, -pygame/examples/__pycache__/midi.cpython-314.pyc,, -pygame/examples/__pycache__/moveit.cpython-314.pyc,, -pygame/examples/__pycache__/multiplayer_joystick.cpython-314.pyc,, -pygame/examples/__pycache__/music_drop_fade.cpython-314.pyc,, -pygame/examples/__pycache__/ninepatch.cpython-314.pyc,, -pygame/examples/__pycache__/pixelarray.cpython-314.pyc,, -pygame/examples/__pycache__/playmus.cpython-314.pyc,, -pygame/examples/__pycache__/prevent_display_stretching.cpython-314.pyc,, -pygame/examples/__pycache__/resizing_new.cpython-314.pyc,, -pygame/examples/__pycache__/retro_scaling.cpython-314.pyc,, -pygame/examples/__pycache__/scaletest.cpython-314.pyc,, -pygame/examples/__pycache__/scrap_clipboard.cpython-314.pyc,, -pygame/examples/__pycache__/scroll.cpython-314.pyc,, -pygame/examples/__pycache__/setmodescale.cpython-314.pyc,, -pygame/examples/__pycache__/sound.cpython-314.pyc,, -pygame/examples/__pycache__/sound_array_demos.cpython-314.pyc,, -pygame/examples/__pycache__/sprite_texture.cpython-314.pyc,, -pygame/examples/__pycache__/stars.cpython-314.pyc,, -pygame/examples/__pycache__/testsprite.cpython-314.pyc,, -pygame/examples/__pycache__/textinput.cpython-314.pyc,, -pygame/examples/__pycache__/vgrade.cpython-314.pyc,, -pygame/examples/__pycache__/video.cpython-314.pyc,, -pygame/examples/__pycache__/window_opengl.cpython-314.pyc,, -pygame/examples/aacircle.py,sha256=sw1kuUbMkWoqGgAqrbxYqgARjPRnU-KlApMTMItdFQ8,1044 -pygame/examples/aliens.py,sha256=rZ4VqzzxhFDfS701Ffbwdd2L_OOziK3QcJTrxryevts,12334 -pygame/examples/arraydemo.py,sha256=-18xekxXnO-MP4JSs62dkT2X-d9KigjpCuErbflwYUE,3298 -pygame/examples/audiocapture.py,sha256=jiottnEQUl9_88cb5_CSNlzbMg__sPzRdQxztj6U0bI,1733 -pygame/examples/blend_fill.py,sha256=aYCP7W8jpRysNRGGKnoeUfvF1d-0uK4u-Dny3C4z_y0,3420 -pygame/examples/blit_blends.py,sha256=DzL-1xJgLmFf6BFjbIW1VH8739ConV2CFNh4tXEybSA,6601 -pygame/examples/camera.py,sha256=zFk-r2TfpsF4k5yM-_cB8Pb0jXkuXpP9_7bDmS3O11w,3988 -pygame/examples/chimp.py,sha256=EFQw6O8Hn9OpRGnuGhAqhP1zUgDDAlnlThBlX28cII0,5906 -pygame/examples/cursors.py,sha256=O8CY6LmzkLwxJ0D8_RT_b5LIC_kHwhNGDt3qirKr2ns,8040 -pygame/examples/data/BGR.png,sha256=DvOrlW5BJdat94nNV8XEETBLRrSWRV7byQsMPsA69uw,244 -pygame/examples/data/MIDI_sample.mid,sha256=Wdg0DNvima84VfgdLfGt7Gz5-WmNZuz5j5_AngwKrTY,8444 -pygame/examples/data/alien1.gif,sha256=8Wveo1zpLVaFCtYITm_SoYqjy8L-TDuaZOcNa8Osqsw,3826 -pygame/examples/data/alien1.jpg,sha256=HOjXjmW4Ofsu_en9WNrkuIp_DCwupXcFB0Yt_cqV9rA,3103 -pygame/examples/data/alien1.png,sha256=femzLssV7oGvT3S2tyviyq7qO32QfhBDtMOR3ENBCLs,3522 -pygame/examples/data/alien2.gif,sha256=0MPpVYzvjAECy0pd7YRFKCEzzIYDKEJt70rbjlLbTZM,3834 -pygame/examples/data/alien2.png,sha256=FKGYDI2FBBR1Z56BLn357PNfh3-M38gAJpSQL8BpKYY,3526 -pygame/examples/data/alien3.gif,sha256=bFCRGZOQPaadCKIc-tlqoUjHdsi5IzR0E-2SjpPEvmA,3829 -pygame/examples/data/alien3.png,sha256=a51Tb9E4IvoICGzQChHq51RKVQJLf1GOCEeqA5yYfnk,3518 -pygame/examples/data/animated_sample.gif,sha256=D_Bkujbk9JP2obPZ0pyO7htxnjn8Z2jFphKVNIacOAs,40316 -pygame/examples/data/arraydemo.webp,sha256=CP_QuMAjyDIhwRlm9g-nacVekCsJwO4c3KTHEx1RLzs,39180 -pygame/examples/data/asprite.bmp,sha256=97XMpKq9lLpMuv8UveCf8UJEAxheBhPUjHfMRQBkUx4,578 -pygame/examples/data/attributions.txt,sha256=xY8hVtJGqFSsAzEDJunWKbQCdC1pwHaiGYEhrzYPd5w,203 -pygame/examples/data/background.gif,sha256=-3kZwt99MFUBbBo-kHvPZXVlFrSB34XVNQWWxfHb970,9133 -pygame/examples/data/black.ppm,sha256=Yu8BwDOeFwOnVYjdWTMo7Tl1xcx2a7J38zZP-JllcMQ,6203 -pygame/examples/data/blue.gif,sha256=hqbgDzCeUz0NHjAQHYURIxSOpRbpHf6QeFch8ux_dAE,84 -pygame/examples/data/bomb.gif,sha256=TZ60QP1S2QBN6QPNSqBwS5VyebZA93iu8ZMUXzEg2QA,1170 -pygame/examples/data/boom.wav,sha256=kfoWs0VVDGHv0JSa46nXZBGyw70-jpfPq_B31qNA_F8,12562 -pygame/examples/data/brick.png,sha256=K_mshK0aL81nzOjAorTXyPps6n9mvofLeOWFXFpVjYA,170 -pygame/examples/data/car_door.wav,sha256=TwYWVqme5NqVVID1N4es92RSKEdTYkxbNx6dNamK-_4,3910 -pygame/examples/data/chimp.webp,sha256=1a5Na4kM66h9q9LQEVGqc2cPpb8Ek-UFXIGT-GnqMeM,622 -pygame/examples/data/city.png,sha256=c0Nu2o7x7QmvGMDmDCaPnhvJ8tPNuguKKpI_Z-NfQ40,143 -pygame/examples/data/crimson.pnm,sha256=o9ziiY4ox_cCmEo07w08SQckCQTRttxtLgKBE0VmZY8,3124 -pygame/examples/data/cursor.webp,sha256=k1-P6VFjKDv4tFPX7xiZej6LkfHYTvX2D0r-fgzgCT0,960 -pygame/examples/data/explosion1.gif,sha256=WYcdwbZqmYdaaaPYFiR5vka0Anp4F4nnNlpSSx_1xug,6513 -pygame/examples/data/fist.webp,sha256=ZgnATxlbdM7gjS73avZ0JoHr0X15BhESxCRRAzyT9pQ,48246 -pygame/examples/data/frame.webp,sha256=dqKn-UsayMk39sCPKduM0xTMPtj16JIxVPeC2nrctBM,124 -pygame/examples/data/green.pcx,sha256=si9WT7dyn3nsXoh34UBW0yOCKWbC-Rz0fKkc_7TDRbY,320 -pygame/examples/data/grey.pgm,sha256=uWTtnBH-Fv605OtEJzS9fG5ns9XaeUHq2YeAC_cdkKU,4155 -pygame/examples/data/house_lo.flac,sha256=_uYgiQBesdMl1vAcF533q--LPcyrFZ-IxfEYlsV_3lM,57482 -pygame/examples/data/house_lo.mp3,sha256=R0nZUXymMp_XLPU8S1yvsiVeWT6MKLt5Rjp-WSnVrLQ,116320 -pygame/examples/data/house_lo.ogg,sha256=64FiQ1Zjq-cOj6Bmya_v3ZjEWmBaGZlTl19udKaz6sU,31334 -pygame/examples/data/house_lo.opus,sha256=zmv6V0QRUWU4M8aV5afQNBzcS7hZPuBkai0xoQsAGYo,62583 -pygame/examples/data/house_lo.wav,sha256=B1BwfFaPIsSxaash-igVI_YE9SQd1BCXRTnSAKsNunY,78464 -pygame/examples/data/house_lo.wv,sha256=d5zBT3X-N-oHa-nVZ4Wp9I3gFwRCCc0wOU5Pa-JO1gc,48216 -pygame/examples/data/laplacian.png,sha256=uWI8dPstqMEPVuFPGtm-guu48T2-L3kn99rWA3ZhZ-Q,253 -pygame/examples/data/liquid.webp,sha256=QyE1e5ZqCu_Gd-wUTC3M9VNR4qzf-yyPqSvOnMe-ldw,1810 -pygame/examples/data/magenta.lbm,sha256=ajm4uXtzU63TFsBf6_NtjA8bzU0IecR7ma_KbxoEE5E,190 -pygame/examples/data/metadata.mp3,sha256=kSjik7US5CUKHjto4DgGtX9XWCHT8jba_a_Aw1RaPX4,1359 -pygame/examples/data/midikeys.webp,sha256=DnUChDaoTwFv3wlRQtNDxquSa6n4iW6ikhNAi1gwtE0,9520 -pygame/examples/data/peppers3.tif,sha256=EJoCwJo1WueRmFhRZn29EgDWDcSFxHjzJLQyhCCeimk,786568 -pygame/examples/data/player1.gif,sha256=3ZTVWGxnedKqtf3R-X1omPC0Y8jUSPGgHBAzeGhnV4c,3470 -pygame/examples/data/punch.wav,sha256=A0F1xT8aIZ6aNI_5McMqLygb1EfmdIzPi4kWkU4EwQc,4176 -pygame/examples/data/purple.qoi,sha256=sRSNJIUY1U5BcFN74wJbkjYKYpaLCLeEtP7RP_P7KYs,43 -pygame/examples/data/purple.xpm,sha256=3r6_3v6tob2qy-1hrQ3ujYHpuFb9UQ7LuNsHWq9mj5A,1249 -pygame/examples/data/red.jpg,sha256=mgaTBGP_k55FcqJIL7eV4jYll80zaZHPHfFtXAOLnF8,1251 -pygame/examples/data/sans.ttf,sha256=nrZ6FRet4dwlvA7xOReYCP2QwyGebk0iVJaSFbtpOhM,133088 -pygame/examples/data/scarlet.webp,sha256=iLN1RrY8LCSUnDrwYvWC99v_pLGy0iN8winH7VAyVL0,82 -pygame/examples/data/secosmic_lo.wav,sha256=-EIFkzj7k5qEqG04n7mnUGUp1SsyCJ4n08TzPT600DY,18700 -pygame/examples/data/shot.gif,sha256=bF2eY629zQzvDu83AKpveSFhJq5G4QpOE98A0tvbPFI,129 -pygame/examples/data/static.webp,sha256=Ejf8Dnhzf7Rbl-bNGXQwDbxPdZ8CdPtJ70CjNljGMNQ,580 -pygame/examples/data/surfonasinewave.xm,sha256=CSyhLNtuJvzTIvBs9RImMLAysMUY9_Ucz7ijMmXmp-o,427614 -pygame/examples/data/teal.svg,sha256=nkksR3fo0NPwC9sVXQPrPR_QrvqRiUB1vC4I-K83dho,313 -pygame/examples/data/tomato.xcf,sha256=XWhrOYxCvzlP9Ccg3RNRO7tpQ7u9IKwcLtgYUGSaatg,693 -pygame/examples/data/turquoise.tif,sha256=4OkIy6CDPMv77tRR_wA9ZHA6qZzG3pjZ-1m1mNB7bcI,1186 -pygame/examples/data/whiff.wav,sha256=FMWM3XnYtce6mHFXQCYPgzT-xu-Q4DJybZfpPjG8cpE,5850 -pygame/examples/data/white.pbm,sha256=zSRUIqNXPH14wmG4JSFhZI5GZBwf_u0qrvpC-7BcWlg,183 -pygame/examples/data/yellow.tga,sha256=EhxUG3SMO6bbHxr4yFggnKrsC1mYZVq-L6znAsR3z8I,3116 -pygame/examples/dropevent.py,sha256=FDiNT-tjFgRQOnDhePMcsT33DM5iahhu4koPUCGvWfQ,2443 -pygame/examples/eventlist.py,sha256=t4UCjDYe0H2nEa-SullKNCb2AQVFyHznXz5SkuKq9KE,5459 -pygame/examples/font_viewer.py,sha256=YC-UDYi_arN0zONqpPirBs5hrlKNLeVIPsx41ihRrIA,9996 -pygame/examples/fonty.py,sha256=iq8u5vW9-xLP-_I02M9U1LFWphRRkiaHsketYKybx94,2157 -pygame/examples/freetype_misc.py,sha256=QhnyjXVJM549tLVSaqY2HBSfF9xRxfYlLWPOwIzhaxU,3733 -pygame/examples/glcube.py,sha256=EkILudvfsGvUpxpjGDmeM9pE6lD3KfrY81SzPBTqj6U,17416 -pygame/examples/go_over_there.py,sha256=0lDsAmYUZQBrRkLEaOW-8iot7DDPfOgBSFUbI1PrQMM,2163 -pygame/examples/headless_no_windows_needed.py,sha256=J19bHV6Y6yHnf3W-20IDgr1hnggtnVIBCm4gLp-cUJU,1218 -pygame/examples/joystick.py,sha256=d9i3C_0O4asjFQ4CamBt8IYJK3sYz7HxTapIOcCgNj8,5233 -pygame/examples/liquid.py,sha256=swp1UBgbnuoum3X5ZvDvD5_5riVmreYFilKTwW2jfk0,2598 -pygame/examples/mask.py,sha256=tV_Jtu70Xt0OrUk-b1OgGqCf_gM9eellqz_3gDD7BCI,5786 -pygame/examples/midi.py,sha256=5t2LVHw7M2L3L9TNb-ZlWnKXbSPIPm7gVP_23nm9sEc,29609 -pygame/examples/moveit.py,sha256=LRxPIOBpnQ7eoBzU7v0f4rKkU9qjl2ksFH9tZn7-AjQ,3358 -pygame/examples/multiplayer_joystick.py,sha256=cb180BCepdJMyz0mX-yqOkWTKYJJQKDZOuf7gY05JAs,5419 -pygame/examples/music_drop_fade.py,sha256=E_Q2_WTtU4-5l9ZEGDjc17RYMB_f8S_ZWvUDfvLixDE,8480 -pygame/examples/ninepatch.py,sha256=GTifpXF_l3UcDVigbU846MD0ytpaQMEEukBh9kOjQJo,5766 -pygame/examples/pixelarray.py,sha256=K3bM8Ca9EYY1Rc5LuoZc_gFu-qDF9QhReLWRc3CGmgA,3582 -pygame/examples/playmus.py,sha256=CImJ2UCwqfMQ9xpTBgCTavL9EpDj3dPBIBqz0zcGKJs,3691 -pygame/examples/prevent_display_stretching.py,sha256=NZP3jDQrggtuqm2UKWl6EEPamUngFkvEpXUUufUOps8,2761 -pygame/examples/resizing_new.py,sha256=31uxExXbscJmz5eePSijsZRFaKm0UW9GsBmJzqApozA,1207 -pygame/examples/retro_scaling.py,sha256=dLmbrmZLiqEz_i3vwYrCELCBM_4gmLd0OoRS71y6V4Q,2165 -pygame/examples/scaletest.py,sha256=tRwYFQI5IzGWStUTpENvl2a9KY_qEydY3gXhB6fhS1E,4458 -pygame/examples/scrap_clipboard.py,sha256=9bUmxvmtFMb8Y3XFJsCe8OBq_FMAlGo9BWaj8mr2NHc,2099 -pygame/examples/scroll.py,sha256=CkYB0EsBE4LKtTgNxwQq-xUvlH6lfvUG5HS9M_eaH7A,6726 -pygame/examples/setmodescale.py,sha256=upH30nv3YD-ZJw7CVwDTKw3pOhFpSRsp82jBKQm-Wx8,2667 -pygame/examples/sound.py,sha256=PnFFkz3wzANUED0Csvl9460XFyo6M0ul_qYldUMrZyo,1183 -pygame/examples/sound_array_demos.py,sha256=XwdIb1iK7f-lkPEysOd2Tmdz0sHlW_isPpPYUeKjsZk,5894 -pygame/examples/sprite_texture.py,sha256=ESC_wqwIzKA19LqDj4R5pBtpC3C-FGmHgAivNQIeId0,2752 -pygame/examples/stars.py,sha256=-EQryNxVUyGk8xyEs8Oh1ZIl_IbEEu5BLL9w3hQwcbU,3469 -pygame/examples/testsprite.py,sha256=_VeGpUkKyiotEA2kpiXW3L0bOGeacGGiAdnyS82T1Lo,6344 -pygame/examples/textinput.py,sha256=xhvCl8iCdIScjTPQWaSiEOsOQq8bYgbR9rjOsLgvUZM,9558 -pygame/examples/vgrade.py,sha256=P8HYU4dLTZvmwCZE27BzYEZwSGeLabrhW-oh1gLTcQc,3391 -pygame/examples/video.py,sha256=ivyCs23qc25K3hzHPGl6KPI2_S2up1-TdlTbmIIfyBY,4904 -pygame/examples/window_opengl.py,sha256=VVxbdgUNJQhz1a7oDRmPWauGw0zzYK9EEo26ZRZ4mbk,1946 -pygame/font.cpython-314-x86_64-linux-gnu.so,sha256=hjRwffb1yB9yBwyKJgVDo95H8nECB6Q1Gqx9YhxsWcg,55465 -pygame/font.pyi,sha256=DvUr7Ovy7qfwkIhER2ELHHzqk8a2JObcGHN9yvKPLZI,11977 -pygame/freesansbold.ttf,sha256=v5JRJp8R5LNVgqmTdglt7uPQxJc6RZy9l7C-vAH0QK0,98600 -pygame/freetype.py,sha256=YQ3tYeH-_DLqKg3jyDMYJ5JNi3JBmd0uc-ETSYM2gJE,2225 -pygame/freetype.pyi,sha256=hd_EACV5E5pjY4BQYVDcp2Bxb3Y75a1AlZ47PzPBH40,6214 -pygame/ftfont.py,sha256=YVun0q9GBN1dW3rkis9WXZvmpdBkDRg6eglGsSInKL4,7141 -pygame/geometry.cpython-314-x86_64-linux-gnu.so,sha256=PZiYQ0bCbRE8PJPr9r4dZ_wpUYwwQgzbL71BI-xzKDc,57336 -pygame/geometry.pyi,sha256=7xIOl_J3LYJtEi5fw1MCZLD9fO_PIfD8_Lx8uPqrigI,6812 -pygame/gfxdraw.cpython-314-x86_64-linux-gnu.so,sha256=DEMvUlnuSpgJP6ve7CQh0UpFXvtDS4rFGzUa6Ev8D4A,103681 -pygame/gfxdraw.pyi,sha256=ODw7V-5sO_ZDQp7XoDEFfuqJvI_6X7I5gSdQI9aCZQY,2540 -pygame/image.cpython-314-x86_64-linux-gnu.so,sha256=Iqzt3TdfXnKDPdrWQfAMkZgTLqtk1g-gWeBLXN9GFBk,58921 -pygame/image.pyi,sha256=Ym03elqM5EmoKYYJI0ksgfOMqF6FfSnQL08RnrrnLls,16199 -pygame/imageext.cpython-314-x86_64-linux-gnu.so,sha256=Z5k9Sn3ln3eizBRsjhY6qWEzNOzfmBxZUx42wJz9Y6w,30025 -pygame/joystick.cpython-314-x86_64-linux-gnu.so,sha256=uYvC2di_abZSTPI-8uOJVV-y6ZT6WCFJorS_Qp_LDJk,42521 -pygame/joystick.pyi,sha256=tv5yP40AOuqcin7zKPIAd3rYop7h1rmD0s80PUqMgU8,1674 -pygame/key.cpython-314-x86_64-linux-gnu.so,sha256=BFV6wiEeCqxaScD9NOLstthjVVG5bUojg1kTWn1L3WU,38185 -pygame/key.pyi,sha256=aUpP55e6AF9yK-xVNSRov57AsuXRGXxrGoWakpUlGH8,17609 -pygame/locals.py,sha256=em_BPVUitRkONUlxaZ8qbJX-qkDgjL9nkj0GqlOrvGs,1221 -pygame/locals.pyi,sha256=UMMSYG60vwr0qA2W5EWve2klL8y-8iFK9vU-h7N5Qpc,22692 -pygame/macosx.py,sha256=OZj0AN8YorjTGo6f-Sz2M2bjjXikuKP5yUMKkk50aI0,329 -pygame/mask.cpython-314-x86_64-linux-gnu.so,sha256=4liHxc-K9WSZWpmjDAEKl1ZwloT8hxc7dljLP0P1a9I,83409 -pygame/mask.pyi,sha256=CSGM6Aduz4_eOFr-5Wk-Ybhnzy6nvVeLX1Erh8F6pxw,24776 -pygame/math.cpython-314-x86_64-linux-gnu.so,sha256=uKCyAoLgVgifEUSJzurI07OSJYn5SKeMngQsYmnlpRY,105960 -pygame/math.pyi,sha256=qHvgIrx8bDM-xLFZMTk6LSZUXVWcjzCxYjeBQiE4kPQ,17208 -pygame/midi.py,sha256=5N67bqbYFgXU_958bIOu6YpLMuAtvVVSiwTlsrLTva8,24340 -pygame/midi.pyi,sha256=0Xlb7ul2qyIhBzO2IQ50Ub7ogt824ScyVos_-XrjDSY,2166 -pygame/mixer.cpython-314-x86_64-linux-gnu.so,sha256=xVnuo4BPaFDsYpkCNty0SSTepQyT9rQoheS49BQtuPQ,72017 -pygame/mixer.pyi,sha256=H6QZJ5tANA-c6mjS8zmI_jGnYsuSLW3sEIjD3Gu0W5Q,3528 -pygame/mixer_music.cpython-314-x86_64-linux-gnu.so,sha256=0V4GNcaC2tB2beQA0wEz2f9z-CzMeNfQZVkqKkFI6Ts,38505 -pygame/mixer_music.pyi,sha256=gtUTh9XKd7xVN83nd4TpOj8KoTEM8jSLJYVFmxDloyQ,965 -pygame/mouse.cpython-314-x86_64-linux-gnu.so,sha256=EjmHiZ7nQwJaS-19Cal6IpKsAEzIfUFntbP-ygD-L6E,34305 -pygame/mouse.pyi,sha256=z2IGTGyK4nQaKfop7T1-47qRM4WKpMvneypp3pR3HOQ,11718 -pygame/newbuffer.cpython-314-x86_64-linux-gnu.so,sha256=61t2nT7j5iCD0QKPovP-QwW3liefihRfjwVXyjjJETI,29832 -pygame/pixelarray.cpython-314-x86_64-linux-gnu.so,sha256=ev2-uJU4Zb-UzOtfoRKcldJ5kYARiqDcCiYSvcEGWhM,67313 -pygame/pixelarray.pyi,sha256=jCcpvDaLFnM3BW9xI6XQP8uAY5wNi_-Nr_8Hv8iucA8,2395 -pygame/pixelcopy.cpython-314-x86_64-linux-gnu.so,sha256=wQBYvqn5FhmA2BO_bPCGNkUC57VWX5_Rp7QI5Yz_3Yk,46241 -pygame/pixelcopy.pyi,sha256=k6HHh-W6FpLk04Cdybo2oLONu4BlLB0FvLZCUChB_zQ,4394 -pygame/pkgdata.py,sha256=jd6ThLVWErXa9GzQq5ieGqYjffAVPjPjKOoPSFIJ4KE,2860 -pygame/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pygame/pygame_icon.bmp,sha256=Twnby8nv4HMhGka49n-47CPseDvwrSLZ0l1o9U2Bb5s,630 -pygame/pypm.cpython-314-x86_64-linux-gnu.so,sha256=3tYTZHgcclULUCGOnKUBeSlnEJueqhyRbTP8jkpKRlg,163585 -pygame/rect.cpython-314-x86_64-linux-gnu.so,sha256=q_ifz3oYPickPi1jWpJweF_Ox15Nt9ttlOZIpgS5Ge4,124641 -pygame/rect.pyi,sha256=mD2plrBDghtxOLCPoJ9jmvFrb5nGmVC6kX_It-vWvI0,10107 -pygame/rwobject.cpython-314-x86_64-linux-gnu.so,sha256=FokzD38quQ_A7XUey-9gPlx8xQ_kzduSWqMCyi6mTNQ,34353 -pygame/rwobject.pyi,sha256=Jrfh0v7ZPtWeAiP884G5ijO4VSDHpNHt5fkdxJvbT8E,518 -pygame/scrap.cpython-314-x86_64-linux-gnu.so,sha256=ZYCUNrfOGMtmTDBrHWd9_eBxnf3na63Re6ijWxLBHy0,29937 -pygame/scrap.pyi,sha256=-uTnpoc_A211Iy-jiAaKuizHFfQlRMafyArxz3iT7dA,2804 -pygame/sndarray.py,sha256=xo2Do51mdsJSdrrpGJDDUK_cFFvWgUuX-WqnbXUE7sc,4084 -pygame/sndarray.pyi,sha256=hDMs0_w_oEPAYNVn3kt56FXRS8WX-MbYGi4XXpEG_ok,3155 -pygame/sprite.py,sha256=4E_hwA94dJSi8JYXwAOSrjRO3hrL7VpekLluoM8MSY8,62133 -pygame/sprite.pyi,sha256=RkrJAPlcdQtmA2AO3xLEffXjTdmIfUIKpAA_TL4MR9I,7702 -pygame/surface.cpython-314-x86_64-linux-gnu.so,sha256=en2c6O4rJbm7h3sNJLeGbAdmj-T_7xBa72YocpTkkJ0,327617 -pygame/surface.pyi,sha256=8fkm63G2LfItDrmglWx9cczJ8_07uIt87PUD8lcF96w,44551 -pygame/surfarray.py,sha256=0TYy4pt3GOcH28YFoouOezdEz5WFb5JX5jiCSiuDYG4,14967 -pygame/surfarray.pyi,sha256=tFMXdGtgP_euYZzwL93JjmZZrdN4E2leaCpJPN6RLKA,1884 -pygame/surflock.cpython-314-x86_64-linux-gnu.so,sha256=DM8-nbArZ-QogoFz8K62lXD6AlLE57Fr3TPLW_VsRew,25521 -pygame/surflock.pyi,sha256=p6HFejTvHw2HxSUOD4vW9HolANRfvGHjADdRh63skKQ,122 -pygame/sysfont.py,sha256=tVMn6lVYp2WdhSeKUVpq3pdsxeK6ybyVt5TTu8KpRD4,17516 -pygame/system.cpython-314-x86_64-linux-gnu.so,sha256=zj1Nh1GHY4QE_TPl5JTbOgpSt6UiREPd_0wqTriKr1M,29945 -pygame/system.pyi,sha256=tAYhPrhcXAJ9QvEK12zSLhYDXtJqNLKBay_qRAWB0xI,7128 -pygame/tests/__init__.py,sha256=hY2TbJVE8SY6OnqG-Ueqqo5Vl_qRKGr3IX6axYk0kz8,1230 -pygame/tests/__main__.py,sha256=arPew_Vdao46IcWb_zrjUixhUmO7WtAQfi55YHyyD9c,3788 -pygame/tests/__pycache__/__init__.cpython-314.pyc,, -pygame/tests/__pycache__/__main__.cpython-314.pyc,, -pygame/tests/__pycache__/base_test.cpython-314.pyc,, -pygame/tests/__pycache__/blit_test.cpython-314.pyc,, -pygame/tests/__pycache__/bufferproxy_test.cpython-314.pyc,, -pygame/tests/__pycache__/camera_test.cpython-314.pyc,, -pygame/tests/__pycache__/color_test.cpython-314.pyc,, -pygame/tests/__pycache__/constants_test.cpython-314.pyc,, -pygame/tests/__pycache__/controller_test.cpython-314.pyc,, -pygame/tests/__pycache__/ctest_test.cpython-314.pyc,, -pygame/tests/__pycache__/cursors_test.cpython-314.pyc,, -pygame/tests/__pycache__/debug_test.cpython-314.pyc,, -pygame/tests/__pycache__/display_test.cpython-314.pyc,, -pygame/tests/__pycache__/docs_test.cpython-314.pyc,, -pygame/tests/__pycache__/draw_test.cpython-314.pyc,, -pygame/tests/__pycache__/event_test.cpython-314.pyc,, -pygame/tests/__pycache__/font_test.cpython-314.pyc,, -pygame/tests/__pycache__/freetype_test.cpython-314.pyc,, -pygame/tests/__pycache__/ftfont_test.cpython-314.pyc,, -pygame/tests/__pycache__/geometry_test.cpython-314.pyc,, -pygame/tests/__pycache__/gfxdraw_test.cpython-314.pyc,, -pygame/tests/__pycache__/image__save_gl_surface_test.cpython-314.pyc,, -pygame/tests/__pycache__/image_test.cpython-314.pyc,, -pygame/tests/__pycache__/imageext_test.cpython-314.pyc,, -pygame/tests/__pycache__/joystick_test.cpython-314.pyc,, -pygame/tests/__pycache__/key_test.cpython-314.pyc,, -pygame/tests/__pycache__/locals_test.cpython-314.pyc,, -pygame/tests/__pycache__/mask_test.cpython-314.pyc,, -pygame/tests/__pycache__/math_test.cpython-314.pyc,, -pygame/tests/__pycache__/midi_test.cpython-314.pyc,, -pygame/tests/__pycache__/mixer_music_test.cpython-314.pyc,, -pygame/tests/__pycache__/mixer_test.cpython-314.pyc,, -pygame/tests/__pycache__/mouse_test.cpython-314.pyc,, -pygame/tests/__pycache__/pixelarray_test.cpython-314.pyc,, -pygame/tests/__pycache__/pixelcopy_test.cpython-314.pyc,, -pygame/tests/__pycache__/rect_test.cpython-314.pyc,, -pygame/tests/__pycache__/render_test.cpython-314.pyc,, -pygame/tests/__pycache__/rwobject_test.cpython-314.pyc,, -pygame/tests/__pycache__/scrap_test.cpython-314.pyc,, -pygame/tests/__pycache__/sndarray_tags.cpython-314.pyc,, -pygame/tests/__pycache__/sndarray_test.cpython-314.pyc,, -pygame/tests/__pycache__/sprite_test.cpython-314.pyc,, -pygame/tests/__pycache__/surface_test.cpython-314.pyc,, -pygame/tests/__pycache__/surfarray_tags.cpython-314.pyc,, -pygame/tests/__pycache__/surfarray_test.cpython-314.pyc,, -pygame/tests/__pycache__/surflock_test.cpython-314.pyc,, -pygame/tests/__pycache__/sysfont_test.cpython-314.pyc,, -pygame/tests/__pycache__/system_test.cpython-314.pyc,, -pygame/tests/__pycache__/time_test.cpython-314.pyc,, -pygame/tests/__pycache__/touch_test.cpython-314.pyc,, -pygame/tests/__pycache__/transform_test.cpython-314.pyc,, -pygame/tests/__pycache__/typing_test.cpython-314.pyc,, -pygame/tests/__pycache__/version_test.cpython-314.pyc,, -pygame/tests/__pycache__/video_test.cpython-314.pyc,, -pygame/tests/__pycache__/window_test.cpython-314.pyc,, -pygame/tests/base_test.py,sha256=bR9Xo_eUUgpnb3eecTb_klQAshsFAIhAC0T7m6m241Q,22168 -pygame/tests/blit_test.py,sha256=WotlxfOd4qhaaOIrJmPUylYpqgoTmg5nmhQelCFh1cE,8340 -pygame/tests/bufferproxy_test.py,sha256=ZWseVGOskqueYfYf7LAmyCWTuhLTRmk3ojPvWYQ4An8,16376 -pygame/tests/camera_test.py,sha256=KdGG1pLTe8Eh2SHiEsH7DuLqwn-OsaLCHm4MGCKPAvg,70 -pygame/tests/color_test.py,sha256=JvDCDAfIlOdRgwsJD9lVnNKCmhcL14y5gY4KSB08lYY,58766 -pygame/tests/constants_test.py,sha256=uYVilNNjS6_QG_iiXGvHRZV02UQxwNBnkRSr19Rf1z0,9307 -pygame/tests/controller_test.py,sha256=rVQjerAbvnKFA_oUy4gKAlWg8l3jsN9qE_FZ9NdilDs,8425 -pygame/tests/ctest_test.py,sha256=Xv0Fwq-Rck-98rY_NTWXujcZM5PMXQs6wlGOMjEAOCc,356 -pygame/tests/cursors_test.py,sha256=eJRKwrvoVgBVyMga151SIVYAljNA0IPgCsyPbMVzzao,8323 -pygame/tests/debug_test.py,sha256=g0bjBSdHDWmik9piWxreEtSDHif4JUdw75pn0eakyDk,630 -pygame/tests/display_test.py,sha256=ZK7OYMa9c4HKqeGIMiBf3jBMhBGohy5bpjv2Y-vKQ2Y,41392 -pygame/tests/docs_test.py,sha256=erkdBzLbhZDxTaGm0QhL6YQ_7vEHXaRXf_UMfyZYQD4,1071 -pygame/tests/draw_test.py,sha256=fQA-XY6sqBJEm8EalDgPgkqvBRSO7tILmDEAMOoAfrs,272859 -pygame/tests/event_test.py,sha256=DxYFB20KUid3rPME835X-Vq1Ohi5tFKq2ftOQbHZApE,35239 -pygame/tests/fixtures/fonts/A_PyGameMono-8.png,sha256=QmhReADwKrzW5RWnG1KHEtZIqpVtwWzhXmydX1su10c,92 -pygame/tests/fixtures/fonts/PlayfairDisplaySemibold.ttf,sha256=4Q60pnYY-7dwBTVr7PBSz5r-w_kfUzhal8i85ISG7V4,236636 -pygame/tests/fixtures/fonts/PyGameMono-18-100dpi.bdf,sha256=nm3okxnfAFtADlp7s2AY43zS49NYg9jq7GVzG2lPhOQ,1947 -pygame/tests/fixtures/fonts/PyGameMono-18-75dpi.bdf,sha256=4kB0uYeEpa3W-ZAomFMpc0hD-h6FnOh2m5IPi6xzfds,1648 -pygame/tests/fixtures/fonts/PyGameMono-8.bdf,sha256=aK0KV-_osDPTPiA1BUCgZHOmufy6J9Vh5pf1IAi0_yg,1365 -pygame/tests/fixtures/fonts/PyGameMono.otf,sha256=_Af4LyMEgKKGa8jDlfik89axhLc3HoS8aG5JHWN5sZw,3128 -pygame/tests/fixtures/fonts/PyGameMono.sfd,sha256=fw2z6a9bTRrliq1_apjGEuxnmIoQdbCTcFF2YFW4ifg,6473 -pygame/tests/fixtures/fonts/test_fixed.otf,sha256=FWHmFsQUobgtbm370Y5XJv1lAokTreGR5fo4tuw3Who,58464 -pygame/tests/fixtures/fonts/test_sans.ttf,sha256=nrZ6FRet4dwlvA7xOReYCP2QwyGebk0iVJaSFbtpOhM,133088 -pygame/tests/fixtures/fonts/u13079_PyGameMono-8.png,sha256=x_D28PW8aKed8ZHBK6AISEZ9vlEV76Whi770ItTuFVU,89 -pygame/tests/fixtures/xbm_cursors/white_sizing.xbm,sha256=VLAS1A417T-Vg6GMsmicUCYpOhvGsrgJJYUvdFYYteY,366 -pygame/tests/fixtures/xbm_cursors/white_sizing_mask.xbm,sha256=CKQeiOtlFoJdAts83UmTEeVk-3pxgJ9Wu2QJaCjzAQM,391 -pygame/tests/font_test.py,sha256=EzWl57XKejKoGFCuKkhk3IoX6Kc3-c8jYJRfei1iJEo,42824 -pygame/tests/freetype_test.py,sha256=XdaC2lJ_9gwIJJ3bx5wcaAJnksE3Q4KY2MYSJrqpzSI,65478 -pygame/tests/ftfont_test.py,sha256=LGxyZ6mgJW0OHv1OAbL9GYQdas3ocsiEvs0LceSmWuU,411 -pygame/tests/geometry_test.py,sha256=_5_EkbsitqWDvgoLRkjCNaycYV6z1qSjZWwERF3ciCs,69422 -pygame/tests/gfxdraw_test.py,sha256=e2couFdRyUf2f5x4IyUZK8IB39RxHCVxHOLF-NkG0Vg,34107 -pygame/tests/image__save_gl_surface_test.py,sha256=D8IjVof_xi36mTWIV3mOR421VdUmTT3pjGKKKVSquxY,1211 -pygame/tests/image_test.py,sha256=QDHu3Aio1DO2lk4-1fVUkWqLlkGTvSuhz15UQVXOkxo,56163 -pygame/tests/imageext_test.py,sha256=0ERsvRavEBl22yAWWjwooNX5bbOVMzMDrEnB40rshBI,2681 -pygame/tests/joystick_test.py,sha256=4EcxDC8GrpsHxLnp_pRVGsbC6Lfi86R70z2AlwMQ6Yc,6248 -pygame/tests/key_test.py,sha256=0Fk3Ly5eCEknOoObvsotWvFnc-NMI2EA8B2MqhiulQk,9557 -pygame/tests/locals_test.py,sha256=2g4vCW-wJG0U_wA7VP1kieV-wSsvGInyGkLW6OjvJ4o,417 -pygame/tests/mask_test.py,sha256=dsRETDROv9Nec-Jt8b6d_fko9ySFf9UcecpeyYJ33P8,254856 -pygame/tests/math_test.py,sha256=nBY_83BRK_GWR2kQvVHu44WRX2R7NHQtTNIxURrxMzw,123102 -pygame/tests/midi_test.py,sha256=amx9t-U3_w7B2shjieU1SMtbgKByo9pv_NxIOUPjIDs,16901 -pygame/tests/mixer_music_test.py,sha256=J-nGC3p8s3bv3nSSJIHyENUeBoy8tJ7XUtUxgEsxHq8,17447 -pygame/tests/mixer_test.py,sha256=RvU_TdgZF4kuHPwQbNwmck7AvdRRkqIQidf4N3XmrVg,52752 -pygame/tests/mouse_test.py,sha256=z1kHL8JrPREC9fHMAjRl9-Pqs1E7RNQN4_ss6gkqoD8,16395 -pygame/tests/pixelarray_test.py,sha256=lbVoeOkOKduBpjPWdVg8n28zGXtsT0HvGfX635U_Wu0,67167 -pygame/tests/pixelcopy_test.py,sha256=OCXzRLUv2lWlcAhS_fnNdqVuhQNiTtprSSNsfyX_gB4,25337 -pygame/tests/rect_test.py,sha256=v6zQjZ-boqDQwOc_TBY_u3c30FPKOfdsUnjC21uY23k,129127 -pygame/tests/render_test.py,sha256=zbTw0oIR3Weo9FH954osIwSN2IBEfX2CSX7XksAGtcg,17854 -pygame/tests/rwobject_test.py,sha256=lSl6h6Jk1tqkO4tlA9Dk_h2bn0Ur3-CJ4bRzf-Cag6E,4273 -pygame/tests/scrap_test.py,sha256=J_z0zhCQliWdGAf0QFEUvKqz1x2u-Xk-2f8iOOQUwcc,6696 -pygame/tests/sndarray_tags.py,sha256=8QFcweiCrHljKDbLnx0dpvpWm5XAUabgrspZ-YstCHQ,166 -pygame/tests/sndarray_test.py,sha256=pqVdoLLP37t47mVUVFrEvJ2z8caI-LN8PJGODKCoL_I,6292 -pygame/tests/sprite_test.py,sha256=Cvfe76BJRgsPbQevyBrMwtJs8EsuHlERBBDXB8WHm2U,47267 -pygame/tests/surface_test.py,sha256=_XesfMtJb3A_16sHL0CrzuWTLjIXEWKdEcyZG6LniRs,178651 -pygame/tests/surfarray_tags.py,sha256=8QFcweiCrHljKDbLnx0dpvpWm5XAUabgrspZ-YstCHQ,166 -pygame/tests/surfarray_test.py,sha256=KtCEiv6phNjqXEG3nchte5erYhfM8NrIctYbZyQ58io,25685 -pygame/tests/surflock_test.py,sha256=Epuu_JPH9nOzePooxZYdglmeA3b2T-lz2nMLw7DzTBY,4728 -pygame/tests/sysfont_test.py,sha256=cm33_Yl5BMS7nRvXOs7yuAJRvAY-LKX7fcTbns46FsA,3307 -pygame/tests/system_test.py,sha256=fBHg5rDNqSA-sdoB0dAn7zURUm7BH_0H9IX8_bCWhWc,4399 -pygame/tests/test_utils/__init__.py,sha256=BZUcWIy-MPmZReKCpOWM1u0XF1Hr2lXcSnYLAvt4WPQ,4022 -pygame/tests/test_utils/__pycache__/__init__.cpython-314.pyc,, -pygame/tests/test_utils/__pycache__/arrinter.cpython-314.pyc,, -pygame/tests/test_utils/__pycache__/async_sub.cpython-314.pyc,, -pygame/tests/test_utils/__pycache__/buftools.cpython-314.pyc,, -pygame/tests/test_utils/__pycache__/png.cpython-314.pyc,, -pygame/tests/test_utils/__pycache__/run_tests.cpython-314.pyc,, -pygame/tests/test_utils/__pycache__/test_machinery.cpython-314.pyc,, -pygame/tests/test_utils/__pycache__/test_runner.cpython-314.pyc,, -pygame/tests/test_utils/arrinter.py,sha256=XVaXNUdP-fQN2zRec0LXWPnC4ap7R_Fqaq8b7ctWqMM,14698 -pygame/tests/test_utils/async_sub.py,sha256=JPDZDbHE-CJYPZVrvJ_0pkvhJsvkEjZbLYTYntjSh_k,9128 -pygame/tests/test_utils/buftools.py,sha256=GK28Rjagmmp2m-oabNLynB57R_f3Rczds-F_uLZBIqM,23513 -pygame/tests/test_utils/png.py,sha256=SJw6jkrEzkHlym6Qe8ZvJ4P_9GWyr9S6ol5Yi3ZkKpU,152327 -pygame/tests/test_utils/run_tests.py,sha256=GkPdVnO-r50hlA9hX7d1GNXKqXiDRWL-IuXyjjSUs2g,12019 -pygame/tests/test_utils/test_machinery.py,sha256=AOTtzNYdYPubSgv6Eb0r9OnwHaUTSsN7aZer9gnAODU,2435 -pygame/tests/test_utils/test_runner.py,sha256=Xuqyl2HEoBHhI91qkLQVEozBZjIxs0h_s0RezFZB_-8,9661 -pygame/tests/time_test.py,sha256=f62aXt1nu5-ykJ7wwRT8WD4npgw-Irmv1CrTsFUgh94,20647 -pygame/tests/touch_test.py,sha256=Hse-5t-udw5ECFzQU_PejptzOYq61meqoyxZ_z0FjIs,3707 -pygame/tests/transform_test.py,sha256=RgPqs0n05kGM6mVERsl91QdbllPRrCgE5ys7AHd3IP0,84120 -pygame/tests/typing_test.py,sha256=Z6n1IBQznNgp680HQMflzDzqZ2KQ2K0Y7IkxM8vsSP8,601 -pygame/tests/version_test.py,sha256=JncPol5l8CC4QdPrbtJRclus1yjqLPz9bdG-4kuXURQ,1036 -pygame/tests/video_test.py,sha256=QPshwufWylLw9sIy1IUpa-HTOVupwlWUcnmhU_rXCbE,1998 -pygame/tests/window_test.py,sha256=mEMr5AT0a_g47_G2uGiflwjeTHfH1-n-O5xfKnXkOe4,15604 -pygame/time.cpython-314-x86_64-linux-gnu.so,sha256=pTZd_2QAM_2no7unczoub9l5GaU4jcAVqVSeGuOTr58,38281 -pygame/time.pyi,sha256=41SPAObS6A62y3ffOLqUKazWwK-xCr-w767Fun6B0Ko,5910 -pygame/transform.cpython-314-x86_64-linux-gnu.so,sha256=dteJcpUZ9NcqzzLs9zXwYjJMsUp3Q9u3rNAECuHxXWs,124921 -pygame/transform.pyi,sha256=l16Bec_B0gHg9ov7LyOEQTpM_uQRrPq-eR01EOKOOFU,19897 -pygame/typing.py,sha256=qoEDeG438KMkYRu8Ig2VqKUhs9yndKge8vzaat8MrwU,2049 -pygame/typing.pyi,sha256=qoEDeG438KMkYRu8Ig2VqKUhs9yndKge8vzaat8MrwU,2049 -pygame/version.py,sha256=XbR4bqKy73vnD5fvg8TefXGhQTs_5wuAle7jVp7XCLA,2436 -pygame/version.pyi,sha256=QMJzSYF9SIMVjfbRBYHA9o3LVNcYX0yLcLtOA5oCn_I,646 -pygame/window.cpython-314-x86_64-linux-gnu.so,sha256=YzKGNN5fhs2m2-FKTmLK_-OqrJ_DBzuM-zVlA17HOyY,63937 -pygame/window.pyi,sha256=N78hdSoSBaluu7D5DEc1q1Klhj7EXz_F5nWqu9PJnQM,18176 -pygame_ce-2.5.8.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 -pygame_ce-2.5.8.dist-info/METADATA,sha256=xMPB1zA-kTQUujQjsYURjdx_ELnc0BtAY1TgH2Jj5qg,11043 -pygame_ce-2.5.8.dist-info/RECORD,, -pygame_ce-2.5.8.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 -pygame_ce-2.5.8.dist-info/WHEEL,sha256=38O_rQEdxN7EGnH25SWAU5q8fuZGkF2ZUEaPjMVV3Rw,137 -pygame_ce-2.5.8.dist-info/entry_points.txt,sha256=3YD7smSOshRsKnt0vWH0tjMm1VXhWmVlCXJOMxdl1VQ,150 -pygame_ce.libs/libFLAC-e7027ec5.so.14.0.0,sha256=1R56gVvbmvyrQH3eQONyUEix2j3f21MYIQlBmx3B2nQ,443905 -pygame_ce.libs/libSDL2-2-50d19f93.0.so.0.3200.10,sha256=wGtE6pFnykD8SOZBphPrY7RXKbHssvyaDfoQcIYmn1Y,2220241 -pygame_ce.libs/libSDL2_image-2-d6906c81.0.so.0.800.12,sha256=3Us_OBde_oWu_UZ5a5z8l2V26mQfsLE-SLxDomwG2Vc,163089 -pygame_ce.libs/libSDL2_mixer-2-6719e6f6.0.so.0.800.2,sha256=1weVZRt7EotwVoeB4yTpfiRmLLmMOgMi03F8Aih3Y2A,238865 -pygame_ce.libs/libSDL2_ttf-2-e69aa315.0.so.0.2400.0,sha256=EbUZzNI5FJHvQeLXzt99jMqXLyj_QLTL9Rnw1ER2lqA,105521 -pygame_ce.libs/libasound-2b3a3662.so.2.0.0,sha256=SxoXcipu3L0-90C64UnztEQaJtj4uOUZyZfgh6Wy-kk,1199353 -pygame_ce.libs/libbrotlicommon-c828db13.so.1.2.0,sha256=0qwg-BNqLPDvsJzsBruTwtGLivPekrPwAb6dwnga6hQ,144001 -pygame_ce.libs/libbrotlidec-8e4a5025.so.1.2.0,sha256=xXuvNU-H2-o4zIT4D0xM9T8r1-AV3qdokQEXfW9t_Uc,66457 -pygame_ce.libs/libfluidsynth-2d6ca569.so.3.5.6,sha256=axO8ykJQW1vgdKBXBM_p80h06bmX8Zw80ov-IAA-kb4,1207105 -pygame_ce.libs/libfreetype-b83c5fb4.so.6.20.6,sha256=XBhjUQ6EjVUmisj_GKgEDC3onk8Ht0kqmu2JA1N4wZQ,898249 -pygame_ce.libs/libharfbuzz-672f7280.so.0.61430.0,sha256=il3XoDmZCbyAOVs4zsf3WQmLrRMOpEkDpLpCrMzqMQo,1699425 -pygame_ce.libs/libjpeg-a5e764f6.so.62.4.0,sha256=8QRiiW6-zyxrIJYlPb4wVTVxJ0QzTKJfNRjLy0j0AFE,800473 -pygame_ce.libs/libmpg123-8b3c3c9e.so.0.49.4,sha256=aRYvw_L52nN3GXt1zKoft2Z6oER241wqMoPN8lLTR5k,389705 -pygame_ce.libs/libogg-15db22d2.so.0.8.6,sha256=RNmgFNbgI6467JXppRHeUm1_H_3yt6dpOljGQNsZ3TA,47145 -pygame_ce.libs/libopus-ddd6afb9.so.0.11.1,sha256=H0BrPO9qjZIanNDeQaGGygarFtVqJhYUibdbtW4lsXQ,417001 -pygame_ce.libs/libopusfile-96d7a9c0.so.0.4.5,sha256=e0mL27wup4Yu47J8rtGxmJivMuaJs1gdRXvdyy1boGI,63193 -pygame_ce.libs/libpng16-fefdc88d.so.16.58.0,sha256=6NmYlzbfSdH11mxKzxNWqTQH8qMpvZ_dRTcGe_U3wG0,278001 -pygame_ce.libs/libportmidi-8a3ff27a.so.2.0.7,sha256=ORnwO1-3RS76DHMOB0nap_W-SzXU1IpzwlTyEsIXuy0,56049 -pygame_ce.libs/libsharpyuv-f86ac02c.so.0.1.2,sha256=jSfWoR_w5RhXcCWPKjRMzWJgHXGt-h1hamJTbHyDE-M,29833 -pygame_ce.libs/libsndfile-b31f7dcd.so.1.0.37,sha256=kbi0xkX7EzT00tmv_aGLoE1BTiPyJYctWg5RaR1UlbE,646945 -pygame_ce.libs/libtiff-9370c332.so.6.3.0,sha256=v4Ul1uBdy48ShbHI96137kJspWbWdh-usVS9rCr8J5Y,639881 -pygame_ce.libs/libvorbis-3d07e502.so.0.4.9,sha256=ubFqbBhVVAverR60SvAr6dFDnTUMkZysaF90Usg7xBE,248473 -pygame_ce.libs/libvorbisenc-263afe1b.so.2.0.12,sha256=YY6Ln51t-cIEroklnI9OZ1SQ0lTKUt6cBq6KNEU4yeM,709089 -pygame_ce.libs/libvorbisfile-07b6198b.so.3.3.8,sha256=09u8bGg9hxwZhmL0caIYJtK0gY5jCPqT8Y5JJsshrcw,54937 -pygame_ce.libs/libwavpack-59f0eb24.so.1.2.8,sha256=lpsZj2fZbAHr6wITSP-ByKumniwtDXjQDKCw5Satpm8,211849 -pygame_ce.libs/libwebp-0c3b7151.so.7.2.0,sha256=G-Bjq0SKZ5fF8ixhWyEWFNskhIqced3I2cz9rJoX6AU,419953 -pygame_ce.libs/libwebpdemux-cecf59a9.so.2.0.17,sha256=CIx9RSdl4Oo4WSMtYW8hhorm--oeqwBEHk53ivA9O_w,33649 -pygame_ce.libs/libxmp-35a4066c.so.4.7.2,sha256=ycxy9OD0QdRE1cgSQyPDqui1jddIdjX_Z3OCaq3ji1c,776241 diff --git a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/REQUESTED b/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/REQUESTED deleted file mode 100644 index e69de29..0000000 diff --git a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/WHEEL b/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/WHEEL deleted file mode 100644 index 43ea12f..0000000 --- a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/WHEEL +++ /dev/null @@ -1,6 +0,0 @@ -Wheel-Version: 1.0 -Generator: meson -Root-Is-Purelib: false -Tag: cp314-cp314-manylinux_2_17_x86_64 -Tag: cp314-cp314-manylinux2014_x86_64 - diff --git a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/entry_points.txt b/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/entry_points.txt deleted file mode 100644 index a00b9e9..0000000 --- a/.venv/lib/python3.14/site-packages/pygame_ce-2.5.8.dist-info/entry_points.txt +++ /dev/null @@ -1,6 +0,0 @@ -[pyinstaller40] -hook-dirs = pygame.__pyinstaller:get_hook_dirs - -[briefcase.bootstraps] -pygame_ce = pygame.__briefcase.pygame_ce:PygameCEGuiBootstrap - diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libFLAC-e7027ec5.so.14.0.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libFLAC-e7027ec5.so.14.0.0 deleted file mode 100755 index a1bbc8c..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libFLAC-e7027ec5.so.14.0.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2-2-50d19f93.0.so.0.3200.10 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2-2-50d19f93.0.so.0.3200.10 deleted file mode 100755 index 20a8362..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2-2-50d19f93.0.so.0.3200.10 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_image-2-d6906c81.0.so.0.800.12 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_image-2-d6906c81.0.so.0.800.12 deleted file mode 100755 index a42b1d7..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_image-2-d6906c81.0.so.0.800.12 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_mixer-2-6719e6f6.0.so.0.800.2 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_mixer-2-6719e6f6.0.so.0.800.2 deleted file mode 100755 index 9334022..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_mixer-2-6719e6f6.0.so.0.800.2 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_ttf-2-e69aa315.0.so.0.2400.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_ttf-2-e69aa315.0.so.0.2400.0 deleted file mode 100755 index 98f9d37..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libSDL2_ttf-2-e69aa315.0.so.0.2400.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libasound-2b3a3662.so.2.0.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libasound-2b3a3662.so.2.0.0 deleted file mode 100755 index 61c76d0..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libasound-2b3a3662.so.2.0.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libbrotlicommon-c828db13.so.1.2.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libbrotlicommon-c828db13.so.1.2.0 deleted file mode 100755 index d551b85..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libbrotlicommon-c828db13.so.1.2.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libbrotlidec-8e4a5025.so.1.2.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libbrotlidec-8e4a5025.so.1.2.0 deleted file mode 100755 index ad670ae..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libbrotlidec-8e4a5025.so.1.2.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libfluidsynth-2d6ca569.so.3.5.6 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libfluidsynth-2d6ca569.so.3.5.6 deleted file mode 100755 index c91a3d3..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libfluidsynth-2d6ca569.so.3.5.6 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libfreetype-b83c5fb4.so.6.20.6 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libfreetype-b83c5fb4.so.6.20.6 deleted file mode 100755 index e6e75b2..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libfreetype-b83c5fb4.so.6.20.6 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libharfbuzz-672f7280.so.0.61430.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libharfbuzz-672f7280.so.0.61430.0 deleted file mode 100755 index 70fc376..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libharfbuzz-672f7280.so.0.61430.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libjpeg-a5e764f6.so.62.4.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libjpeg-a5e764f6.so.62.4.0 deleted file mode 100755 index d0310de..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libjpeg-a5e764f6.so.62.4.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libmpg123-8b3c3c9e.so.0.49.4 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libmpg123-8b3c3c9e.so.0.49.4 deleted file mode 100755 index 8c604a2..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libmpg123-8b3c3c9e.so.0.49.4 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libogg-15db22d2.so.0.8.6 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libogg-15db22d2.so.0.8.6 deleted file mode 100755 index 710ce53..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libogg-15db22d2.so.0.8.6 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libopus-ddd6afb9.so.0.11.1 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libopus-ddd6afb9.so.0.11.1 deleted file mode 100755 index 1644cfe..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libopus-ddd6afb9.so.0.11.1 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libopusfile-96d7a9c0.so.0.4.5 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libopusfile-96d7a9c0.so.0.4.5 deleted file mode 100755 index 20dd630..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libopusfile-96d7a9c0.so.0.4.5 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libpng16-fefdc88d.so.16.58.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libpng16-fefdc88d.so.16.58.0 deleted file mode 100755 index 0348cdf..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libpng16-fefdc88d.so.16.58.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libportmidi-8a3ff27a.so.2.0.7 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libportmidi-8a3ff27a.so.2.0.7 deleted file mode 100755 index 28f16a7..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libportmidi-8a3ff27a.so.2.0.7 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libsharpyuv-f86ac02c.so.0.1.2 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libsharpyuv-f86ac02c.so.0.1.2 deleted file mode 100755 index 1aaff3e..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libsharpyuv-f86ac02c.so.0.1.2 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libsndfile-b31f7dcd.so.1.0.37 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libsndfile-b31f7dcd.so.1.0.37 deleted file mode 100755 index 3321109..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libsndfile-b31f7dcd.so.1.0.37 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libtiff-9370c332.so.6.3.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libtiff-9370c332.so.6.3.0 deleted file mode 100755 index 25ded20..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libtiff-9370c332.so.6.3.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbis-3d07e502.so.0.4.9 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbis-3d07e502.so.0.4.9 deleted file mode 100755 index c2d2766..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbis-3d07e502.so.0.4.9 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbisenc-263afe1b.so.2.0.12 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbisenc-263afe1b.so.2.0.12 deleted file mode 100755 index 3f910a1..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbisenc-263afe1b.so.2.0.12 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbisfile-07b6198b.so.3.3.8 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbisfile-07b6198b.so.3.3.8 deleted file mode 100755 index 2258b35..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libvorbisfile-07b6198b.so.3.3.8 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwavpack-59f0eb24.so.1.2.8 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwavpack-59f0eb24.so.1.2.8 deleted file mode 100755 index 9651fbd..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwavpack-59f0eb24.so.1.2.8 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwebp-0c3b7151.so.7.2.0 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwebp-0c3b7151.so.7.2.0 deleted file mode 100755 index a199651..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwebp-0c3b7151.so.7.2.0 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwebpdemux-cecf59a9.so.2.0.17 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwebpdemux-cecf59a9.so.2.0.17 deleted file mode 100755 index c05a510..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libwebpdemux-cecf59a9.so.2.0.17 and /dev/null differ diff --git a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libxmp-35a4066c.so.4.7.2 b/.venv/lib/python3.14/site-packages/pygame_ce.libs/libxmp-35a4066c.so.4.7.2 deleted file mode 100755 index 2426df3..0000000 Binary files a/.venv/lib/python3.14/site-packages/pygame_ce.libs/libxmp-35a4066c.so.4.7.2 and /dev/null differ diff --git a/aufgaben/einstellung/pr_aufgaben/hausaufgaben/beispiel.txt b/aufgaben/einstellung/hausaufgaben/beispiel.txt similarity index 100% rename from aufgaben/einstellung/pr_aufgaben/hausaufgaben/beispiel.txt rename to aufgaben/einstellung/hausaufgaben/beispiel.txt diff --git a/aufgaben/einstellung/pr_aufgaben/hausaufgaben/calorie_counting.py b/aufgaben/einstellung/hausaufgaben/calorie_counting.py similarity index 100% rename from aufgaben/einstellung/pr_aufgaben/hausaufgaben/calorie_counting.py rename to aufgaben/einstellung/hausaufgaben/calorie_counting.py diff --git a/aufgaben/einstellung/pr_aufgaben/hausaufgaben/game.py b/aufgaben/einstellung/hausaufgaben/game.py similarity index 100% rename from aufgaben/einstellung/pr_aufgaben/hausaufgaben/game.py rename to aufgaben/einstellung/hausaufgaben/game.py diff --git a/aufgaben/einstellung/pr_aufgaben/hausaufgaben/test_calorie.py b/aufgaben/einstellung/hausaufgaben/test_calorie.py similarity index 100% rename from aufgaben/einstellung/pr_aufgaben/hausaufgaben/test_calorie.py rename to aufgaben/einstellung/hausaufgaben/test_calorie.py diff --git a/aufgaben/einstellung/pr_aufgaben/hausaufgaben/test_undo_doodle.py b/aufgaben/einstellung/hausaufgaben/test_undo_doodle.py similarity index 100% rename from aufgaben/einstellung/pr_aufgaben/hausaufgaben/test_undo_doodle.py rename to aufgaben/einstellung/hausaufgaben/test_undo_doodle.py diff --git a/aufgaben/einstellung/pr_aufgaben/hausaufgaben/undo_doodle.py b/aufgaben/einstellung/hausaufgaben/undo_doodle.py similarity index 100% rename from aufgaben/einstellung/pr_aufgaben/hausaufgaben/undo_doodle.py rename to aufgaben/einstellung/hausaufgaben/undo_doodle.py